compose_state 0.2.1-dev.2

A Flutter state management package inspired by Jetpack Compose, offering reactive state, ViewModel scoping, API handling, and persistence.

Changelog

All notable changes to the compose_state package will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.1-dev.1 - 2025-11-04

Added

• Overhauled documentation for improved developer experience.
• New 'cookbook' section with practical recipes for common state management patterns.
• Added a complete 'todo_app' example to showcase library features in a real-world scenario.
• Transformed compose_state_documentation.html into a modern documentation portal.

Changed

• Refactored ApiState error handling to correctly integrate with StateErrorHandler.
• Updated older documentation files with redirection notices to the new cookbook.
• Renamed top-level examples directory to example to follow Pub layout conventions.

0.2.0-dev.1 - 2025-10-23

Added

• SignalState: Granular reactivity for fine-grained rebuilds (inspired by Flutter Signals).
• OfflinePersistableState: Queued saves for offline support using SharedPreferences.
• Storage<T> abstraction for modular persistence (e.g., SharedPreferencesStorage).
• StateDebugger<T> for logging state changes during development.
• Basic unit tests in test/ for core components (MutableState, HistoryState, ApiState, PersistableState, SignalState).

Changed

• ApiState: Added exponential backoff retry for robust async handling.
• HistoryState: Improved recursion-proofing with _inSetValue flag.
• PersistableState: Supports Storage<T> for cross-platform flexibility (e.g., in-memory for web).
• Updated docs with CodePen embeds for interactive examples.

Fixed

• Type mismatches with ObservableState setter enforcement.
• Linter warnings (unnecessary overrides, missing @override).

0.2.0 - 2025-10-12

Added

• SignalState: Granular reactivity for fine-grained rebuilds (inspired by Flutter Signals).
• OfflinePersistableState: Queued saves for offline support using SharedPreferences.
• Storage<T> abstraction for modular persistence (e.g., SharedPreferencesStorage).
• StateDebugger<T> for logging state changes during development.
• Basic unit tests in test/ for core components (MutableState, HistoryState, ApiState, PersistableState, SignalState).

Changed

• ApiState: Added exponential backoff retry for robust async handling.
• HistoryState: Improved recursion-proofing with _inSetValue flag.
• PersistableState: Supports Storage<T> for cross-platform flexibility (e.g., in-memory for web).
• Updated docs with CodePen embeds for interactive examples.

Fixed

• Type mismatches with ObservableState setter enforcement.
• Linter warnings (unnecessary overrides, missing @override).

0.1.0 - 2025-04-12

Added

• Initial release of compose_state, a lightweight state management solution for Flutter.
• Core components: MutableState, PersistableState, HistoryState, ApiState, DerivedState, StateBuilder, UiStateBuilder.
• ViewModelScope for MVVM architecture.
• Example apps in documentation: Simple Counter, Persistent Counter, Async Weather App with Open-Meteo, Todo App with Firebase.
• Comprehensive HTML documentation with code snippets, tutorials, and best practices.

Fixed

• N/A (initial release).