Added #

• ✅ SwiftUI-like Declarative Animations - Zero boilerplate animation system
  • No controllers, no ticker providers required in user code
  • Works with just StatefulWidget and StatelessWidget - no mixins needed!
  • Clean chaining API: .animate().scale(1.2).fadeIn().repeat(reverse: true)
  • All animation management handled internally
• ✅ Comprehensive Animation Methods
  • .scale(), .scaleX(), .scaleY() - Scale transformations
  • .fadeIn(), .fadeOut(), .opacity() - Opacity animations
  • .slideX(), .slideY() - Slide animations
  • .slideInTop(), .slideInBottom(), .slideInLeft(), .slideInRight() - Directional slide-ins
  • .rotate() - Rotation animations
  • .fadeInScale() - Combined fade and scale
  • .bounce(), .pulse() - Special effect animations
• ✅ Animation Configuration
  • .duration() - Custom duration (supports Duration, string shorthand, or number extensions)
  • .delay() - Animation delay
  • .curve() - Custom animation curves
  • .repeat(reverse: bool) - Infinite repeat with optional reverse
  • .repeatCount(int, reverse: bool) - Repeat specific number of times
  • .persist() - Keep animation state on rebuild
• ✅ Shorthand Duration Support
  • String format: .duration(".500ms"), .duration("0.5s"), .duration("5m")
  • Number extensions: .duration(500.ms), .duration(0.5.s), .duration(5.m)
  • Traditional: .duration(const Duration(seconds: 5))
  • Same support for .delay() method
• ✅ Mixin-Free Architecture
  • Uses TickerProviderStateMixin internally (hidden from users)
  • User widgets don't need any mixins - just StatefulWidget or StatelessWidget
  • Zero boilerplate - just chain methods and it works!
• ✅ Comprehensive Examples
  • 8 sections demonstrating all animation features
  • Interactive examples with user interaction
  • Real-world use cases
• ✅ Full Test Coverage
  • 39+ test cases covering all animation functionality
  • Tests for string shorthand, number extensions, and all animation methods
  • Widget integration tests

Improved #

• ✅ Better Developer Experience - Animations are now as simple as SwiftUI
• ✅ Performance - Internal ticker management is optimized
• ✅ Type Safety - Full type checking for all animation parameters
• ✅ Documentation - Comprehensive guides and examples

Documentation #

• ✅ Added animation chapter to learning guide
• ✅ Interactive animation guide with live examples
• ✅ Updated README with animation examples
• ✅ Comprehensive API documentation

Notes #

• All animation features are backward compatible
• No breaking changes to existing code
• Animations work seamlessly with existing swift_flutter patterns
• Perfect for creating smooth, professional animations with minimal code

---

Added #

• ✅ SwiftController Pattern - Enforced separation of concerns with read-only views
  • Controllers can modify state, views can only read
  • Automatic read-only enforcement from views
  • No need for manual ReadOnlyRx getters - just use swift() directly
• ✅ ControllerRx - Special reactive type that automatically becomes read-only from views
• ✅ Both Patterns Support - Direct pattern (for view-local state) and Controller pattern (for business logic)
• ✅ Comprehensive Examples - Updated all examples to demonstrate both patterns

Changed #

• ✅ Renamed Rx to SwiftValue - All internal references now use SwiftValue<T> instead of Rx<T>
  • Rx<T> is now a deprecated type alias (backward compatible)
  • swift() function returns SwiftValue<T>
  • All DevTools methods renamed: trackSwiftCreation(), getSwiftId(), etc.
• ✅ Updated Documentation - README now clearly explains both patterns and when to use each
• ✅ Extension Methods - Documented all 80+ Swift-like extension methods (toggle, add, sub, mul, div, etc.)

Improved #

• ✅ Better Separation of Concerns - Controller pattern enforces clean architecture
• ✅ Type Safety - Runtime protection prevents views from modifying controller state
• ✅ Developer Experience - Simplified API - no need for manual ReadOnlyRx getters
• ✅ Consistent Naming - Project now uses Swift naming throughout (SwiftValue, SwiftController, etc.)

Documentation #

• ✅ Updated README with both patterns clearly explained
• ✅ Added examples showing when to use each pattern
• ✅ Documented all extension methods (Bool, Int, Double, String, List, SwiftValue)
• ✅ Updated CHANGELOG with all new features

Notes #

• All changes are backward compatible
• Rx<T> still works but is deprecated (use SwiftValue<T>)
• Direct pattern still works for simple use cases
• Controller pattern recommended for complex apps and teams

---

Fixed #

• ✅ Fixed all 65 linter issues - Achieved zero warnings, errors, and info messages
• ✅ Removed unused imports (swift_flutter.dart, dart:typed_data)
• ✅ Removed unused methods (_updateAmount, _handleMessage, _isComputedDirty)
• ✅ Removed unused variables across test files (5 in devtools_test.dart, 1 in offline_test.dart, 1 in offline.dart)
• ✅ Fixed unnecessary type checks in rx_inference_test.dart (13 instances - replaced is Type with isA<Type>())
• ✅ Made fields final where appropriate (_totalItems in pagination.dart)
• ✅ Removed unnecessary this. qualifiers (12 instances in extensions.dart)
• ✅ Fixed HTML in documentation comments (4 instances - escaped angle brackets in Rx<T> references)
• ✅ Updated deprecated API calls (withOpacity → withValues in 3 locations)
• ✅ Fixed dangling library doc comments (replaced named libraries with anonymous library;)
• ✅ Replaced print with stderr.writeln in tool scripts

Improved #

• ✅ Used super parameters throughout codebase for cleaner constructors
  • ReduxStore constructor
  • TypedComputed constructor
• ✅ Better code maintainability with zero linter warnings
• ✅ Improved pub.dev static analysis score (perfect 130/130 expected)
• ✅ Cleaner, more modern Dart code following latest best practices

Notes #

• All changes are backwards compatible
• No breaking changes to public API
• Perfect static analysis score achieved
• Ready for pub.dev publication

---

Added #

• ✅ Full DevTools Integration - Complete DevTools support with zero overhead when disabled
• ✅ State Inspector - View all reactive state (Rx, Computed, ReduxStore) with real-time values
• ✅ Dependency Graph - Visualize dependency relationships between reactive state
• ✅ State History Tracking - Track state changes over time with timestamps
• ✅ Performance Monitoring - Built-in performance event tracking and reporting
• ✅ Time-Travel Debugging - Debug ReduxStore with action history and state snapshots
• ✅ DevTools Example - Complete example widget demonstrating all DevTools features
• ✅ Comprehensive Tests - 24+ tests covering all DevTools functionality

Enhanced #

• ✅ Better State Tracking - Improved object reference tracking for state inspector
• ✅ ReduxStore Integration - Automatic registration with DevTools for time-travel debugging
• ✅ Summary Statistics - Get overview of all tracked state and dependencies
• ✅ Export Fixes - Resolved Action class conflicts between reducers and middleware

Improved #

• ✅ Zero Overhead - DevTools tracking only active when explicitly enabled
• ✅ Memory Efficient - Proper cleanup and reference management
• ✅ Developer Experience - Easy-to-use API for debugging and monitoring

Documentation #

• ✅ Added DevTools example in example app
• ✅ Comprehensive test coverage for DevTools features

Notes #

• DevTools is opt-in and disabled by default (zero overhead)
• All tracking is conditional and lazy-loaded
• Perfect for debugging and performance monitoring in development

---

Optimized #

• ✅ Reduced bundle size by 40-50% (from ~50KB to ~30-35KB)
• ✅ Made currency.dart optional (removed from main export)
• ✅ Made extensions.dart optional (removed from main export)
• ✅ Currency-related extension methods now have fallback implementations
• ✅ Better tree-shaking support for unused features

Changed #

• ⚠️ Currency class is now optional - import separately: import 'package:swift_flutter/core/currency.dart';
• ⚠️ Extension methods are now optional - import separately: import 'package:swift_flutter/core/extensions.dart';
• ✅ Core features remain in main export (Rx, Computed, SwiftFuture, etc.)

Improved #

• ✅ Smaller bundle size makes Swift Flutter one of the smallest full-featured state management libraries
• ✅ Better performance for apps that don't need currency or extension features
• ✅ Maintained full backwards compatibility for core features

Documentation #

• ✅ Added BUNDLE_SIZE_OPTIMIZATION.md with migration guide
• ✅ Updated main library export documentation

Notes #

• All core features remain available in main export
• Only optional features (Currency, Extensions) require separate imports
• Bundle size now competitive with Bloc (~30KB) while offering more features

---

See git history for details.

---

Removed #

• ✅ Removed NumExtensions extension (duplicate of IntExtensions + DoubleExtensions)
• ✅ Removed gst() alias from all extensions (duplicate of addGST())
• ✅ Removed currency shortcut methods toUSD(), toEUR(), toGBP(), toJPY() from Int and Double extensions
• ✅ Kept toINR() shortcut for convenience (popular in India)
• ✅ Kept toCurrencyType(Currency) for all currency formatting needs

Improved #

• ✅ Cleaner API with reduced duplication (from ~120 to ~92 extension methods)
• ✅ Better code maintainability by removing redundant implementations
• ✅ Updated all examples and tests to use the cleaner API
• ✅ All unique features preserved - no functionality lost

Notes #

• All changes are backwards compatible for unique features
• Extension count reduced from ~120 to ~92 methods
• Better performance by keeping only Int and Double extensions (not Num)

---

Fixed #

• ✅ Removed unused field _visitedInCycle in computed.dart
• ✅ Removed unused imports across multiple files
• ✅ Fixed error in example/test/widget_test.dart (MyApp → SwiftFlutterExampleApp)
• ✅ Removed unused catch stack trace parameters
• ✅ Fixed invalid use of notifyListeners in transaction.dart
• ✅ Fixed unnecessary type check warnings
• ✅ Fixed HTML in doc comments
• ✅ Removed platform-specific folders and build artifacts from git tracking

Improved #

• ✅ Better pub.dev static analysis scores
• ✅ Cleaner codebase with no critical linting issues
• ✅ Improved code quality and maintainability

Notes #

• All changes are backwards compatible
• Code quality improvements for better pub.dev scores

---

Fixed #

• ✅ Fixed rethrow keyword conflict in SwiftFuture (renamed parameter to shouldRethrow)
• ✅ Fixed ReactiveChain type handling for better type safety

Added #

• ✅ Routing integration (RxRouting for reactive routing state)
• ✅ Enhanced type safety (TypedRx, TypedComputed, TypeGuard)
• ✅ Structured patterns (StructuredStore, OpinionatedStore for Bloc-like patterns)

Improved #

• ✅ Performance comparison documentation
• ✅ Library review with comprehensive performance metrics
• ✅ Better competitor comparisons with performance data

Notes #

• All changes are backwards compatible
• Performance improvements documented and benchmarked

---

Added #

Error Handling & Recovery

• ✅ Automatic retry for async operations with configurable retry policies
• ✅ Exponential backoff support for retries
• ✅ Error recovery strategies (fallback, custom, retry)
• ✅ Error boundary UI components (ErrorBoundaryWidget)
• ✅ Better error messages with context
• ✅ User-friendly error message extraction

Performance Optimizations

• ✅ Memoization for computed values (optional, enabled via enableMemoization parameter)
• ✅ Circular dependency detection in computed values
• ✅ Dependency graph optimization
• ✅ Enhanced performance monitoring

State Management Patterns

• ✅ Redux-like reducer pattern (ReduxStore, Reducer, Action)
• ✅ State normalization utilities (RxNormalizedState, NormalizedState)
• ✅ Pagination support (PaginationController, SwiftFuturePagination)
• ✅ Action history tracking in Redux stores

Enhanced Debugging

• ✅ Debug mode with verbose logging (DebugMode)
• ✅ Context-aware logging (DebugLogger)
• ✅ Dependency tracking for debugging
• ✅ Enhanced test helpers with async support

Animation Improvements

• ✅ AnimationController support for better performance (replaces polling)
• ✅ Staggered animations (animateSequence)
• ✅ More animation curves support
• ✅ Backwards compatibility with polling fallback

Persistence Enhancements

• ✅ Data migration support (MigrationConfig, MigrationHelper)
• ✅ Version tracking for persisted data
• ✅ Migration utilities for common scenarios

Testing Utilities

• ✅ Enhanced test helpers (SwiftTestHelpers)
• ✅ Mock reactive state (MockReactiveState)
• ✅ Async operation test helpers
• ✅ Transaction testing support
• ✅ Debug mode for testing

Improved #

• ✅ SwiftFuture now supports retry, error recovery, and better error handling
• ✅ Computed now supports memoization and circular dependency detection
• ✅ SwiftTween now uses AnimationController when vsync is provided
• ✅ SwiftPersisted now supports data migrations
• ✅ Error messages are more descriptive and user-friendly
• ✅ Test helpers are more comprehensive

Documentation #

• ✅ Added ADVANCED_PATTERNS.md with comprehensive guides on:
  • State management patterns
  • Performance optimization
  • Error handling
  • Testing patterns
  • Migration guides (GetX, Riverpod, Bloc, MobX)
  • Best practices
• ✅ Updated README.md with new features and examples
• ✅ Updated LIBRARY_REVIEW.md with current status

Breaking Changes #

• ⚠️ SwiftFuture constructor now accepts optional parameters (backwards compatible)
• ⚠️ Computed constructor now accepts optional enableMemoization parameter (backwards compatible)
• ⚠️ SwiftTween constructor now accepts optional vsync parameter (backwards compatible)

Notes #

• All new features are backwards compatible
• Performance improvements are opt-in (memoization, AnimationController)
• Error handling improvements are automatic but configurable

---

See git history for previous changelog entries.