state_forge 0.1.8

Structured Flutter state management with typed stores, scoped rebuilds, effects, persistence, and test helpers.

Changelog

All notable changes to this project will be documented in this file.

0.1.8 - 2026-06-10

Changed

• Repositioned the example app as a movie watchlist demo instead of an e-commerce-style cart demo.
• Renamed the example cart feature to watchlist for clearer domain fit.
• Added clickable documentation links across README, guides, migration docs, benchmark notes, and DevTools notes.
• Added bloc as a pub topic for state-management discoverability.

0.1.7 - 2026-06-08

Added

• Added a bundled Flutter DevTools extension under extension/devtools.
• Added public DevTools source under state_forge_devtools.
• Added a local benchmark and stress-test suite under benchmark_suite.
• Added a table of contents to the main README.

Changed

• Updated package docs to describe feature-scoped adoption, scoped stores, one-time effects, and benchmark/devtools resources more precisely.
• Raised the state_forge_core dependency constraint to the published ^0.1.3 release.

0.1.6 - 2026-06-07

Changed

• Refined README positioning to use more precise, less adversarial comparison language.
• Moved selective rebuild guidance higher in the README and added a simple architecture diagram.
• Replaced unsupported performance wording with references to benchmark and test coverage.

0.1.5 - 2026-06-07

Fixed

• Added the Android internet permission to the example app main manifest.
• Converted example network failures into AsyncState.failure UI states instead of unhandled async exceptions.
• Encoded TVMaze request query parameters with structured Uri APIs.

0.1.4 - 2026-06-07

Fixed

• Removed internal planning notes from the repository and published package archive.

0.1.3 - 2026-06-07

Fixed

• Updated the MIT license copyright holder to Marcus Jacob.

0.1.2 - 2026-06-07

Fixed

• Corrected GitHub links in README badges and long-form package notes.
• Aligned package metadata examples with the published repository URL.

0.1.1 - 2026-06-07

Fixed

• Updated package metadata with reachable repository, issue tracker, and documentation links for pub.dev scoring.
• Shortened the package description for pub.dev display guidelines.

0.1.0 - 2026-04-20

Added

• Core Engine: High-performance state propagation using InheritedModel and SelectorAspect.
• Zero Codegen: Entirely removes the need for build_runner or freezed.
• AsyncState: Built-in universal sealed class for Idle, Loading, Success, and Failure states.
• Pattern Matching: Functional API for AsyncState with .when(), .maybeWhen(), .map(), and .maybeMap().
• Side Effects: First-class effect() system with ForgeEffectListener mixin for StatefulWidget.
• Power Mixins: UndoableStore (History) and PersistableStore (Persistence with hydrate()).
• Dev-Friendly API: Shorthand context.watch(), context.read(), and context.select() extensions.
• Lazy Loading: LazyStoreProvider for deferred store instantiation.
• Optimistic Updates: optimistic() helper for "success-first" UI transitions.
• Global Hooks: StateForge.onError and StateForge.debugMode.
• DevTools Integration: Initial hooks for Flutter DevTools extension.
• Example App: A movie discovery/watchlist app using the TVMaze API.
• Persistence Ergonomics: PersistableStore.persistOnChange() for opt-in automatic persistence with debounce support.
• Hydration Lifecycle: PersistableStore.hydrateOnCreate() to load persisted state before attaching automatic persistence.
• SharedPreferences Adapter: First-party state_forge_shared_preferences package for lightweight durable JSON state.