wave

Summary

• Fixes performance degradation for long-duration, high-amplitude wave configurations reported in #53.
• Reduces per-frame path work by sampling wave curves instead of adding one point per pixel.
• Reuses painter path and gradient shader state, and isolates WaveWidget repaint work.
• Avoids recreating animation controllers when runtime-only paint parameters such as amplitude change.

Benchmark

Issue #53 reproduction config, Flutter 3.7.12 via FVM, 1440x300 WaveWidget, 4 gradient layers, 1800 pumped frames:

About 50% lower frame pump time, roughly 2.0x faster in this benchmark.

• Improve WaveWidget paint performance for long-duration, high-amplitude wave configurations like GitHub issue #53.
• Add a manual benchmark for the issue #53 scenario and regression coverage for runtime amplitude updates.

Changes

• Prepare Dart 3 compatibility while keeping Flutter 3.7.12 support.
• Add CI coverage for Flutter 3.7.12 and the latest stable Flutter.
• Add public API dartdoc comments for the main library surface.
• Expand README usage guidance with a minimal example, parameter tables, and common errors.
• Add the Wave Generator screenshot to README.
• Refresh the example app into a responsive generator console with navbar performance metrics and a single Code dialog.
• Update the pub.dev publish workflow to avoid the Node 20 warning.

• Expand Dart SDK compatibility to allow Dart 3.
• Add CI coverage for both Flutter 3.7.12 and the latest stable Flutter.
• Avoid deprecated color opacity APIs on current Flutter.
• Add dartdoc coverage for the main public API.
• Replace the reusable publish workflow with Node 24 compatible publish steps.
• Expand README usage guidance with minimal examples, parameter tables, and common errors.
• Refresh the example app with a Material 3 generator, live performance metrics, and copyable code output.

Changes

• Add runtime validation for custom gradient and layer configuration.
• Add default rendering support for SingleConfig and RandomConfig.
• Improve animation lifecycle handling in WaveWidget.
• Refresh package metadata and demo links for the maintained repository.
• Add CI coverage on Flutter 3.7.12 and publish wave 0.2.3 to pub.dev.

Deployment

• The web demo now deploys through Cloudflare Workers Static Assets.

Validation

• flutter analyze
• flutter test
• flutter pub publish --dry-run
• pub.dev publish workflow completed successfully

• Add runtime validation for custom gradient and layer configuration.
• Add default rendering support for SingleConfig and RandomConfig.
• Improve animation lifecycle handling in WaveWidget.
• Add CI coverage for analyze and tests on Flutter 3.7.

Update banner.

Modify README and web version example, etc.

Migrate to null safety.

Add backgroundImage param.

Add options of setting blur and gradient.

• Widget for displaying a wave. Added options for custom waves and remove the image from WaveView.