surface 0.4.3

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

🌟 Surface

[0.4.3] - 30 APR 21

• Beginning doc/readme cleanup for new Shapeing and naming schemes
• Investigating performance degradation.
• 🆕 props for 👆 TapSpec
  • ❓ useThemeSplashFactory
  • Custom splashFactory
    • Surface falls back to 🏓 BouncyBall
• Renamed 🔲 Peek.peekAlignment -> Peek.alignment & Peek.peekRatio -> Peek.ratio
• Renamed 🔬 Filter.baseRadius, et al. -> Filter.radiusBase, et al. & made all forms of radius input _private with public getters
• A radius, or Corner BorderRadius, may be specified in Shape as well as individual CornerSpec
  • CornerSpec.radius will win if available

[0.4.2] - 30 APR 21

• Fixing null checks, especially by lerps.

[0.4.1] - 29 APR 21

• Imports correction.

[0.4.0] - 29 APR 21

• Overhaul in progress. Developing...
• ✅ Newly added:
  • Manual (or pre-configured) custom Shapeing
    • Easy Shape scaling and differed Shape by 📚 SurfaceLayer
    • Customize Shape by configuring four Corners and radius
  • BorderSide support, by 📚 SurfaceLayer
  • 📋 copyWith methods
  • Renamed classes: FilterSpec -> Filter, PeekSpec -> Peek
  • & more
• 🔳 Todo:
  • Improve transitioning/animating/lerping
  • & more

[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 Filter 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 Filter.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 Filter Object.
  • Enable blurry filters by passing the desired SurfaceLayers into Filter.filteredLayers as a Set.
  • Strength radii can be initialized formally or with a Map<SurfaceLayer, double> called Filter.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 Peek and TapSpec 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 Peek.ratio.
• 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.