• Packaging:
  • Removed a gitignored tracked file warning for dart pub publish --dry-run.

• Static analysis:
  • Switched shader uniform color components to .r/.g/.b and replaced deprecated color value usage.
  • Updated the example app/test to avoid deprecated SpoilerText.
  • Added file-level ignores where legacy config fields are intentionally exercised.
• Docs:
  • Refreshed README examples and configuration tables for current APIs.
  • Added missing dartdoc comments across the public API.
• CI:
  • Added flutter analyze for the package and example app.
  • Added dart pub publish --dry-run for publish validation.

• Testing & CI:
  • Added unit/widget tests and golden coverage.
  • Added GitHub Actions CI to run formatting, tests, goldens, and pana.
• Shader & Controller Stability:
  • Avoid calling animation controllers after disposal during fade completion.
  • Treat local particle shader paths as particle shaders for sprite binding.

• Selection & Rects:
  • Selection now spans multiple text widgets as a single range.
  • Line-based selection boxes replace per-character boxes.
  • Whitespace skipping uses word runs to avoid full-line fill on spaces.
  • Clearing textSelection recomputes full spoiler rects.

• Particle Shapes:
  • Added ParticlePathPreset for built-in/custom shapes.
  • Atlas sprites draw paths directly; shader samples a sprite when shapePath is provided.
• Density Semantics:
  • density now represents coverage percentage in the range 0..1 (0%..100%) and is clamped.
  • Shader and atlas paths use the same coverage math, including shape area factors for consistent particle counts.
• Rendering:
  • Atlas particles use modulated color blending to avoid sprite background artifacts.
  • Removed the hard particle count cap (responsibility is on the developer).

• New Features:

  • Added ShaderConfig to enable a variety of new spoiler effects through custom fragment shaders.
  • Included five new built-in shader effects:
    • ShaderConfig.bokehCover() – A soft, out-of-focus blur.
    • ShaderConfig.liquidMetal() – A flowing, metallic distortion.
    • ShaderConfig.glitchStripes() – A digital glitch with RGB-split stripes.
    • ShaderConfig.mosaicCensor() – A pixelated censorship block effect.
    • ShaderConfig.liquidSpectrum() – A vibrant, shifting spectrum distortion.

• Refactoring:

  • Deprecated direct particle and fade properties in SpoilerConfig.
  • Introduced ParticleConfig and FadeConfig to provide a more structured and extensible way to configure spoiler appearance and behavior. Legacy properties are now mapped to these new classes for backward compatibility.

• Matrix translate fix

• Bumped minimum Flutter version to 3.27.0.
• Added support for clipRSuperellipse and drawRSuperellipse in SpoilerCanvas (via dynamic dispatch for compatibility).

• Refactored SpoilerRenderObjectWidget to use onClipPath and onPaint callbacks, removing direct SpoilerController dependency.

• Added SpoilerTextFormField to keep native text field behaviors (cursor, context menu) while applying spoiler masks to selected ranges.
• Added SpoilerTextWrapper to wrap existing text widgets/subtrees with the spoiler effect.
• Unified path/signature helpers for selections; small gesture and clipping fixes.

• new onSpoilerVisibilityChanged method to listen visibility

• Support maxLines and isEllipsis for TextPainter

• SpoilerOverlay first blur render issue
• enableFadeAnimation false issue

Breaking Changes #

• Class Renames:

  • SpoilerConfiguration renamed to SpoilerConfig
  • WidgetSpoilerConfiguration renamed to WidgetSpoilerConfig
  • TextSpoilerConfiguration renamed to TextSpoilerConfig

• Parameter Renaming:

  • speedOfParticles renamed to particleSpeed
  • fadeAnimation renamed to enableFadeAnimation
  • enableGesture renamed to enableGestureReveal
  • style renamed to textStyle in TextSpoilerConfig
  • selection renamed to textSelection in TextSpoilerConfig

• New Features:

  • Added maskConfig to support advanced masking with Path, PathOperation, and offset.
  • Added textAlign to TextSpoilerConfig for custom text alignment control.

Breaking Changes #

• Class Renames:
  • SpoilerWidget renamed to SpoilerOverlay
  • SpoilerTextWidget renamed to SpoilerText
• Parameter Renaming:
  • configuration parameter changed to config
• Rendering Update:
  • Replaced RenderParagraph with TextPainter for better canvas performance

• A new SpoilerSpotsController class can schedule "wave" or "ripple" effects, causing particles to move outward from random origins within the spoiler bounds.
• Reusable buffers in drawRawAtlas reduce per-frame allocations, providing smoother animations.
• Reorganized Core. Clearer Names & Docs.

• chore: added tags
• small fixes

• perf: Refactored particle rendering to use drawRawAtlas, significantly improving performance for rendering large numbers of particles

• Gesture issue fixed
• start with already spoilered state in SpoilerTextWidget
• import refactor

• Added new SpoilerWidget widget to hide widgets below

• Added docs

• Position fix

• Added docs

• Initial release.