Skip to main content

flutter_dot_loader 1.1.0 copy "flutter_dot_loader: ^1.1.0" to clipboard
flutter_dot_loader: ^1.1.0 copied to clipboard

Dot-matrix loading animations for Flutter: AI chat typing and thinking indicators, 60 LED patterns, scrolling marquee text and custom pixel frames. Zero deps.

1.1.0 #

  • build: the SDK floor drops from ^3.11.4 to ^3.8.0, so the package now resolves on Flutter 3.32 and later (it needed about Flutter 3.41 before). The Flutter constraint is corrected from >=1.17.0, which did not match the SDK floor, to >=3.32.0. A new CI job runs the analyzer and tests on Flutter 3.32.0.
  • fix: changing duration on a looping or bouncing MatrixLoader / DotLoader now takes effect immediately. Before, a running loop kept its original speed until playback or paused also changed.
  • fix: TriangleLoader now applies duration changes, and repaints when color, triangleSize or wireframe change while it shows a static frame (reduced motion).
  • feat: width and height on MatrixLoader, DotLoader, and TriangleLoader. size remains as the square shorthand and existing call sites render identically; each new parameter falls back to size when not set.
  • fix: auto dot spacing is now computed per axis, so grids with rows > columns (for example columns: 1, rows: 5, size: 64) no longer paint outside the widget's bounding box. Tap hit-testing shares the same geometry.
  • feat (behaviour change): DotLoader derives its box height from rows and dotSize when height is not given, so the default 3x1 indicator takes a text-height-friendly box instead of a 64x64 square. Pass height to restore an explicit box.
  • fix: MatrixShape.triangle no longer divides by zero on 1-row or 1-column grids (previously the mask produced NaN comparisons and rendered nothing).
  • feat: respectReducedMotion (default true) on MatrixLoader, DotLoader and TriangleLoader. When MediaQuery.disableAnimationsOf is true the ticker stops and one static frame is painted (the end frame for MatrixPlayback.once, which fires onComplete once). Reacts to runtime changes of the setting.
  • feat: customDotSize: double Function(int row, int col)? on MatrixLoader and DotLoader scales or hides individual dots (answers issue #1). Painting only; hit-testing and auto-spacing keep using dotSize.
  • feat: AI-state presets DotLoader.typing(), .thinking(), .searching() and .generating() with curated grids, patterns, durations and default semantics labels.
  • docs: the MatrixLoader reference table now covers color, playback, curve, paused, onComplete and onDotTapped. Two README samples were fixed: the JSON one used frames before declaring it, and the tap one printed a literal $row. example/README.md, which pub.dev shows on the Example tab, is now a real usage guide. Package topics were retuned for search (loading, animation, ai, chat, dot-matrix), and the internal PROJECT.md is excluded from the archive.
  • docs: CI badge, "Works great with" chat-bubble recipe, README alias count (16), hero GIFs referenced by absolute URL and excluded from the pub archive, pubspec boilerplate removed, dart format drift fixed (CI green again).
  • test: widget coverage for rows > columns, 1xN, Nx1, and 1-row triangle grids asserting painted bounds stay inside the widget.
  • ci: releases publish from GitHub by pushing a v<version> tag, and the live web demo now redeploys automatically on every change to main.

1.0.0 #

First stable release. The API surface (MatrixLoader, DotLoader, TriangleLoader, MatrixText, MatrixData) is considered stable and will follow semver from here on.

  • feat: semanticsLabel on MatrixLoader, DotLoader, and TriangleLoader — when set, the loader is wrapped in a Semantics node so screen readers (TalkBack / VoiceOver) announce it (e.g. 'Loading', 'Assistant is thinking'). Defaults to null (decorative, no semantics node), mirroring Flutter's own ProgressIndicator.semanticsLabel convention.
  • perf: all loaders now wrap their painting subtree in a RepaintBoundary, so the per-frame repaint stays confined to the loader instead of dirtying ancestor layers ~60 times a second.
  • docs: live web demo of the example app (gallery / playground / studio) now hosted on GitHub Pages and linked from the README.
  • feat: MatrixLoader.paused (forwarded as DotLoader.paused) — when true, the underlying AnimationController stops and the loader freezes in place while staying mounted. Toggling back to false resumes loop/bounce cycles seamlessly; once restarts from progress 0.0. The _runId stale-run guard also blocks any in-flight once onComplete from firing after a pause. Useful for chat "thinking" indicators between turns, branded loaders behind settled state, and CPU savings on off-screen loaders.
  • chore(package): published archive size dropped from 3 MB to 1 MB (-67%). Two changes:
    1. Deleted unreferenced duplicate 1.gif (472 KB) and 2.gif (1 MB) from the repo root — the canonical copies have always lived in assets/ and the README points there.
    2. Added a .pubignore to exclude internal maintenance files from the published bundle: CLAUDE.md, SPECS.md, tool/, doc/. None of these ship value to package consumers; they're roadmap, generator scripts, and the auto-generated font preview.
  • chore(pubspec): description rewritten (154 chars) to reflect every post-0.0.5 capability — scrolling marquee text, custom pixel frames, AI chat indicator — while staying in pub.dev's 60–180 sweet spot.
  • chore(pubspec): topics tightened from animation, loader, loading, widget, ui to loader, animation, dot-matrix, led, pixel-art. The dropped generics had high noise on pub.dev's topic-search; the new ones map directly to the package's niche.
  • docs: new doc/font_preview.md — auto-generated ASCII-art preview of every glyph in the 5×7 MatrixText font. Pure Dart generator under tool/generate_font_preview.dart; a drift test fails if the artifact stops matching matrix_text.dart, so every glyph change forces a visible diff in review.
  • chore: lib/src/matrix_text.dart no longer pulls in package:flutter_dot_loader/flutter_dot_loader.dart (it never used any Flutter or library types). The file is now pure Dart, which is what lets the new tool/ scripts import it without dragging in dart:ui.
  • feat: three new semantic aliases on MatrixPattern — sonarPing (alias for circular4, a pure outward radial pulse), pinwheel (alias for circular15, a 4-arm rotating sweep), and columnWave (alias for triangle8, a horizontal column scan). Total semantic aliases now 16; total enum values 77. README cheat sheet and AGENTS.md alias table reflect the additions.
  • feat: MatrixLoader.onComplete callback — fires once when MatrixPlayback.once finishes a play-through. Closes the loop on finite splash / loading animations so apps can navigate, transition, or hand off state when the animation ends. Has no effect for loop / bounce modes. Stale-run-guarded: if the widget is disposed or the playback mode changes before completion, the callback does not fire.
  • feat: MatrixData now has JSON helpers for shipping frames over Firebase Remote Config, Firestore, app config, or any other JSON channel. Four new methods: MatrixData.toJson(grid) / fromJson(map) for a single frame and MatrixData.framesToJson(frames) / framesFromJson(map) for an animation. Output is a Map<String, dynamic> (callers pass it through dart:convert's jsonEncode — the package itself stays zero-dep). The frames payload is versioned (MatrixData.jsonSchemaVersion), and framesFromJson also accepts the legacy comma-joined string for backwards compatibility.
  • feat: MatrixText font now covers all common UI punctuation and symbols — , ; : ' " - _ + = / \ * # @ $ % & | ^ ~ \ ( ) [ ] { } < >in addition to the previously supported. ! ?. Real-world strings like "Loading: 42%", "12/24", "Don't quit", "a@b.com"` now render fully.
  • feat: MatrixText.supportedCharacters getter exposes the font's coverage set so apps can validate user input before encoding.
  • docs: README + AGENTS reference the expanded charset.
  • test: add MatrixText group asserting full charset coverage, glyph shape invariants (7 rows × 5 cols of 0/1), fallback-to-space behavior, and lowercase normalization. Total test count: 18.

0.0.5 #

  • fix: replace portrait animated-GIF pubspec screenshots with static landscape PNGs (assets/screenshot_gallery.png, assets/screenshot_studio.png) so pub.dev's screenshot pipeline renders thumbnails correctly. The animated GIFs remain in the README and are unchanged.

0.0.4 #

  • fix: restore const constructors on MatrixLoader and DotLoader so the documented const usage in the README and tests actually compiles
  • fix: replace deprecated withOpacity with withValues(alpha:) (Flutter 3.27+)
  • chore: tighten analysis_options.yaml (strict-casts/inference, deprecation warnings, sorted directives & dependencies)
  • chore: add pub.dev topics: for discoverability (animation, loader, loading, widget, ui)
  • docs: add AGENTS.md with copy-paste recipes and a decision tree for AI coding agents
  • docs: README quick-start now leads with DotLoader(color: …) for the AI-chat use case
  • test: cover DotLoader defaults and the color shorthand; bump pattern-count assertion to 74

0.0.3 #

  • feat: added DotLoader simplified wrapper
  • feat: added semantic aliases to MatrixPattern
  • feat: added 'color' parameter to MatrixLoader for automatic color derivation

0.0.2 #

  • Studio Parity Update: Expanded MatrixLoader with dotanime studio parity features.
  • Marquee Text: Added MatrixText to automatically convert and scroll text strings into dot-matrix arrays (includes a built-in 5x7 font map).
  • Interactivity: Added onDotTapped(row, col) to allow using the dot matrix as an interactive keypad/synthesizer.
  • Playback Modes: Added MatrixPlayback enum (loop, bounce, once) for non-loading, finite animations.
  • Easing Curves: Added curve property to MatrixLoader to allow non-linear animation (e.g., easeInOut).
  • Compression Utilities: Added MatrixData for compressing/decompressing 2D arrays to lightweight strings (e.g. 101|010|101).
  • Example Upgrade: Added Text and Interactive tabs to the example app to showcase the new capabilities.

0.0.1 #

  • Initial release of flutter_dot_loader.
  • Includes MatrixLoader with customizable shapes (Square, Circular, Triangle).
  • Features 60 unique math-driven animation patterns spanning spirals, vortexes, pulses, and geometric shifts.
  • Supports Custom Frames (MatrixPattern.custom + customIntensity) for building frame-by-frame dot matrix animations (e.g. Tetris, scrolling text).
  • High-performance rendering engine built cleanly on CustomPainter.
  • Includes a fully-featured Example App: an interactive Playground (with real-time parameter tweaking and code generation) and a Dot Matrix Studio Editor for designing custom frames.
23
likes
140
points
255
downloads
screenshot

Documentation

API reference

Publisher

verified publisherdilacode.com

Weekly Downloads

Dot-matrix loading animations for Flutter: AI chat typing and thinking indicators, 60 LED patterns, scrolling marquee text and custom pixel frames. Zero deps.

Repository (GitHub)
View/report issues

Topics

#loading #animation #ai #chat #dot-matrix

License

MIT (license)

Dependencies

flutter

More

Packages that depend on flutter_dot_loader