[hooshyar]

Quick wins from the 2026-10-10 package audit, revised after an independent review. The version stays 1.1.0 (still unpublished); the CHANGELOG 1.1.0 section is updated.

Fixes

• duration changes now apply to a running loop (MatrixLoader / DotLoader).
  • repeat() keeps the period it started with, so a new duration only took effect after playback or paused changed. The example's speed slider did nothing.
  • The loop now restarts, from its current value, when duration changes and playback is loop or bounce. once is untouched, so onComplete can't fire twice.
  • Regression test: test/duration_change_test.dart. It fails on the old code.
  • Known nuance: a bounce that is mid-reverse restarts going forward. There is no position jump, but the direction flips.
• TriangleLoader now applies duration changes. It also repaints when color, triangleSize or wireframe change; shouldRepaint compared only progress, so a static frame under reduced motion went stale.

Reach

• SDK floor: sdk ^3.11.4 → ^3.8.0, flutter >=1.17.0 → >=3.32.0. The package previously needed about Flutter 3.41 and now resolves on Flutter 3.32 and later.
  • Verified by a new CI job, sdk-floor: pub get, analyze lib and the full test suite pass on Flutter 3.32.0 / Dart 3.8.0 stable.
  • The job also prints its toolchain, and any pub get error, as annotations.
• No reformat needed. dart_style formats language 3.8 to 3.12 identically here; the only change gated at 3.10 needs trailing_commas: preserve. The format check passes.
• Why not 3.10. The first version of this PR used ^3.10.0 / Flutter 3.38.0. The floor job showed that Flutter 3.38.0 ships Dart 3.10.0-290.4.beta, a pre-release that ^3.10.0 excludes, so that floor did not actually resolve.
• pubspec description and topics. The topics are now loading, animation, ai, chat, dot-matrix.

Docs

• example/README.md was flutter-create boilerplate. pub.dev shows that file first on the Example tab, so it is now a recipe guide.
• README:
  • The JSON sample used frames before declaring it.
  • The tap sample printed a literal \$row.
  • The MatrixLoader table gains color, playback, curve, paused, onComplete and onDotTapped.
• .pubignore now excludes the internal PROJECT.md.
• CLAUDE.md states the new floor.

Not in this PR

• Theme-aware default colour for DotLoader.
• The repaint: painter refactor.
• TriangleLoader clipping.

Related: #1. customDotSize is already in 1.1.0; close #1 once 1.1.0 is published.

🤖 Generated with Claude Code

Added on 2026-10-12, before release

• publish.yml: pushing a v<version> tag now publishes to pub.dev through GitHub's OIDC token. GitHub Actions publishing is now enabled on pub.dev for this package, with tag pattern v{{version}}.
• deploy-web-demo.yml: rebuilds the live demo at https://hooshyar.github.io/flutter_dot_loader/ on every change to main. It was last deployed by hand for 1.0.0.

The example was built for the web and checked by hand. The gallery shows 60 loaders, and in the playground a duration change now slows the running loop.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FLp5T3rdw75F7RHF8w6GDL

---

Generated by Claude Code