Added #

• Redux.reset() method for proper singleton store cleanup and re-initialization
• Auto-memoization for only and when parameters in Store.build() (no manual memoization needed)
• Comprehensive test suite with 300+ tests covering edge cases, stress tests, and complex scenarios

Changed #

• Renamed Store.build() parameters: selector → only, shouldRebuild → when
• Inlined Dispatcher and GetState typedefs into ThunkAction (removed from public API)

Documentation #

• Added EffectsMiddleware.dispose() documentation for proper cleanup
• Updated README with new parameter names (only:, when:)

Documentation #

• Document both store.build() and store.select().build() patterns in README
• Added build method to API Reference section

Documentation #

• Removed benchmark comparison tables and performance metrics from README
• Retained Performance Tips section for developer guidance

Documentation #

• Added equals: deepEquals example to Quick Start section in README

Added #

• equals parameter in Store constructor for optional deep equality checking
• deepEquals<T> function for comparing collections (uses listEquals, mapEquals, setEquals)
• StateEquals<S> typedef for equality functions

Performance #

• Equality check runs O(n) once per dispatch (not per-subscriber)
• Default identical() remains for O(1) performance with immutable patterns

Usage #

// With deep equality (prevents rebuilds for same-content collections)
final store = Store<AppState>(
  initialState: AppState.initial(),
  reducer: appReducer,
  equals: deepEquals,  // Built-in deep equality
);

// Without (default - fastest for immutable patterns)
final store = Store<AppState>(
  initialState: AppState.initial(),
  reducer: appReducer,
);

Performance #

• 6x faster state updates with optimized Watchable integration
• Middleware chain now cached at construction time (no per-dispatch allocation)
• Benchmarks show ~10.6M ops/sec with 100 listeners (vs ~1.8M previously)

Changed #

• Updated to use watchable: ^6.0.0 for optimized performance
• watchableState getter now returns Watchable<S> instead of AbstractWatchable<S>

Added #

• Comprehensive dartdoc documentation for all public APIs
• Library-level documentation with usage examples
• Documentation for Store, DevTools, ReduxAction, Reducer, Selector, Middleware, StoreProvider, and Redux

Improved #

• Documentation coverage increased from 1.4% to 23%+ (exceeds pub.flutter-io.cn 20% requirement)

Added #

Core Redux Architecture

• ReduxAction - Base class for all actions with pattern matching support
• Reducer<S> - Type-safe state reducers with immutable updates
• Store<S> - Centralized state container with O(1) selector caching
• combineReducers - Utility to compose multiple reducers into one

Selectors with Memoization

• createSelector through createSelector5 - Reselect-style memoized selectors
• Automatic cache invalidation when input dependencies change
• O(1) selector lookup via internal caching

Middleware System

• Middleware<S> - Intercept and transform actions before reducers
• thunkMiddleware - Async action support with dispatch/getState access
• EffectsMiddleware - Stream-based side effects for complex async flows
• loggerMiddleware - Debug logging for actions and state changes

Time-Travel DevTools

• DevTools<S> - State history recording and navigation
• undo() / redo() - Step through state history
• jumpTo(index) - Jump to any point in history
• reset() - Return to initial state
• clear() - Clear history while keeping current state
• maxHistoryLength - Configurable history size limit

Provider System

• StoreProvider<S> - InheritedWidget for store access
• Redux singleton - Global store access pattern
• context.store<S>() - Extension for easy store access
• context.dispatch<S>() - Extension for dispatching actions

Flutter Integration

• .build() extension on AbstractWatchable for reactive UI
• O(1) rebuilds with .map().distinct() optimization
• Automatic subscription management

Technical Highlights #

• O(1) Selector Performance - Cached selectors prevent redundant computations
• Minimal Rebuilds - Only affected widgets rebuild on state change
• Type Safety - Full Dart type system support with generics
• Zero Boilerplate - Clean API inspired by modern Redux patterns
• Comprehensive Testing - 120+ tests covering all functionality

Dependencies #

• watchable: ^6.0.0 - High-performance reactive state primitives
• flutter SDK

Quality Assurance #

• 120+ comprehensive test cases
• 100% test success rate
• Zero analyzer warnings
• Full type safety validation