scroll_texts_widget 0.1.3

Smooth horizontal marquee scrolling text ticker for Flutter. Supports streaming for long texts, cached rendering, and pause/progress controls.

Changelog

0.1.3

• Documentation and README refinements.

0.1.2

• Added comprehensive Cookbook & Common Recipes to documentation (Pause on Hover, Tappable Headlines, Soft Edge Fading, Platform-Adaptive Composition).
• Enhanced example application with a pinned/sticky live ticker preview and interactive recipe switches.
• Added architecture & performance comparison detailing Canvas rendering vs. standard ScrollView approaches.
• Modernized installation instructions with CLI command and latest-version placeholder.
• Added hit-testing support to CustomPainters for transparent composition with MouseRegion and GestureDetector.
• Improved playback controller responsiveness and state synchronization during paused jumps.

0.1.1

• Enhanced package discoverability and category indexing on pub.dev.
• Added official pub.dev topics (marquee, ticker, scrolling, text, animation).
• Refined package description to improve search relevance for marquee and ticker queries.

0.1.0

✨ Major Architecture & Performance Overhaul ✨

🚀 New Features & Enhancements

• Dual Render Modes (ScrollTextRenderMode):
  • cached: Pre-measures single TextPainter and uses GPU clipping with zero layout operations inside paint().
  • streaming: Implements a sliding window tokenizer and queue that measures and paints only the text chunks currently visible inside the viewport window, delivering $O(\text{viewport})$ constant memory overhead.
  • auto: Dynamically engages streaming for long texts and cached for short texts.
• ScrollTextsController:
  • Read real-time pixel offset, maxScrollExtent, normalized progress (0.0 to 1.0), currentTextIndex, isPaused, and effectiveRenderMode.
  • Programmatic controls: jumpTo(double offset), jumpToText(int index, {double offset}), pause(), resume(), and togglePause().
• Position Initialization & Event Callbacks:
  • Added initialScrollOffset and initialTextIndex.
  • Added initialDelay to configure startup pause before first scroll begins.
  • Added repeat to configure continuous playlist looping vs. single-pass playback.
  • Added onScrollChanged(double offset, int textIndex) and onTextCompleted(int textIndex) callbacks.

🔧 Bug Fixes & Stability

• Fixed LateInitializationError thrown when disposing widget with an empty texts list.
• Fixed unmounted async execution exception during pauseDuration by adding mounted guards.
• Fixed inter-text pause cycling to guarantee subsequent texts begin scrolling after pauseDuration.
• Fixed dynamic mid-scroll render mode switching across auto, cached, and streaming modes.
• Implemented didUpdateWidget for dynamic updates of texts, speed, text styles, and controllers.
• Eliminated full-widget setState() rebuilds on each ticker frame by repainting via ChangeNotifier listenables directly on CustomPaint.
• Added unbounded constraint fallback protection in LayoutBuilder.

---

0.0.1

🎉 Initial Release 🎉

• Initial release with ScrollTextsWidget marquee scrolling.