surface 0.3.0+1

Shapeable, layered, intrinsincally animated container with convenient access to blurry ImageFilters, InkResponse, and HapticFeedback.

🌟 Surface

[0.3.0+1] - 25 APR 21

• Large animated doc gif uploaded accidentally. Removed.

[0.3.0] - 25 APR 21

• Divided package into several bite-size src files
• Reverted names of Spec classes to drop preceding 'Surface'
• CustomInk -> BouncyBall, forked as 🏓 package:ball, with LOTS of 🆕 features!
  • New const splashFactorys: 🏓 BouncyBall.splashFactory2, 3, & 4 with different bounce animations
  • 🔮 BouncyBall.marbleFactory which uses different Paint and one of the new curves
  • InteractiveInkFeatureFactory designer method, 🪀 BouncyBall.mold(Paint rubber)
• Blur.ry -> 💧 FX.blurry and becomes default for 🆕 FilterSpec.effect parameter
  • 🤹‍♂️ FX class linked to 🤹‍♂️ SurfaceFX typedef
  • 💧 FX.blurry is the default 🤹‍♂️ SurfaceFX Function that ignores the current 📚 SurfaceLayer layerForRender and opts to handle only the 📊 specRadius which comes from 🔬 FilterSpec according to 📚 layerForRender
    • Passes 📊 specRadius to 💧 FX.b (the true old Blur.ry)
• Core of 🌟 Surface cleaned up, with with is hopefully now zero changes to Widget tree depth by altering parameters like removing filters & disabling ink response and handling Clips differently
  • Still need to work on 🔰 SurfaceShape and Decoration lerping

[0.2.0] & [0.2.0+7] - 12 APR 21

• Migrated package to sound null safety.
• Cleaned up internal SurfaceFilterSpec code a bit while adding relevant constants
  • One DEFAULT_SPEC is used by a new 🌟 Surface
  • And several more that are const options for 👓 filteredLayers:
    • Set<SurfaceLayer> that resemble old enum SurfaceFilter
• 🔰 BiBeveledShape.build becomes 🔰 SurfaceShape.biBeveledRectangle for growth potential
• Removed fullPrint and scaleAxis.

[0.1.0] - 04 APR 21

• Added Surface.baseRadius.
  • 🔘 baseRadius may be specified separately from 🔘 radius, but is optional and will only impact the 📚 SurfaceLayer.BASE.
  • If not provided, uses 🔘 Surface.radius, which itself defaults to 🔘 Surface._RADIUS == 3.0.
• Added SurfaceFilterSpec.extendBaseFilter boolean which will apply the 📚 BASE blurry filter to the Surface.margin.

[0.0.5] - 02 APR 21

• Further modification to initialization parameters for Surface constructor.
• Filter strength and the SurfaceLayers on which they are enabled are now set and mapped with a bespoke SurfaceFilterSpec Object.
  • Enable blurry filters by passing the desired SurfaceLayers into SurfaceFilterSpec.filteredLayers as a Set.
  • Strength radii can be initialized formally or with a Map<SurfaceLayer, double> called SurfaceFilterSpec.radiusMap.
  • SurfaceFilter enum removed, as it redundantly represented the idea of SurfaceLayers in a Set

[0.0.4] - 01 APR 21

• Reduction in initialization parameters for Surface constructor. This is achieved:
  • in one instance by joining three similar values in a Map (filterRadius)
  • by introducing SurfacePeekSpec and SurfaceTapSpec classes to encapsulate other related parameters
• Renamed SurfaceLayer.BASE from BORDER.
  • Changed or removed any references to "border"
  • Now refer to "base inset" or peek.
    • Consider the old Surface.borderRatio is the new SurfacePeekSpec.peekRatio.
• Altered default Color handling.
  • InkResponse splashes and highlights now defer to Theme.
  • Without passing a Surface.color, deafult to ColorScheme.surface
  • Without passing a Surface.baseColor, deafult to ColorScheme.primaryVariant
• Organized documentation. Added iconography through emoji.

[0.0.3] - 23 FEB 21

• Improving layout and comments for pub.dev listing
• Touchup on example application

[0.0.2] - 22 FEB 21

• Prepared for pub.dev
  • Updated comments and documentation; fixed M⬇; ran dartdoc.
  • Cleaned and linked READMEs; added hyperlinks to Surface Example.
• Removed Color and Duration constants from goodies.
• Goodie scaleAxis simplified

[0.0.1] - 22 FEB 21

• Work in progress transfer from an Android application on which I am primarily focused.