Added #

• Smart Home screenshots (smart_home_1.png, smart_home_2.png, smart_home_3.png)
• Signal/Slot blueprint diagram for README

Changed #

• Improved email validation example with proper regex in AnimatedFormSlot documentation
• Updated README diagram to use image instead of ASCII art

Changed #

• Simplified Signal/Slot connection diagram in README for better rendering

Added #

• Smart Home example screenshots in README
• Comprehensive documentation and comments to core files
• HTML section comments in README for better navigation

Changed #

• Improved code formatting across lib and test files

Fixed #

• Escaped angle brackets in doc comments to fix unintended_html_in_doc_comment warnings

Added #

Controller Signal Factory Extensions

New ergonomic syntax for creating signals inside controllers, eliminating boilerplate:

Option 1: Clean Factory Methods (NeuronControllerSignals)

class MyController extends NeuronController {
  late final count = signal(0);              // Signal<int>
  late final user = asyncSignal<User>();     // AsyncSignal<User>
  late final doubled = computed(() => count.val * 2);  // Computed<int>
}

Option 2: Ultra-Short Syntax (NeuronControllerShorthand)

class MyController extends NeuronController {
  late final count = $(0);                   // Signal<int>
  late final user = $async<User>();          // AsyncSignal<User>
  late final doubled = $computed(() => count.val * 2);
}

Sealed AsyncState Class

• New pure-Dart AsyncState<T> sealed class with AsyncLoading, AsyncData, and AsyncError subtypes
• Pattern matching support for exhaustive state handling:

user.state.when(
  loading: () => print('Loading...'),
  data: (user) => print('Got user: $user'),
  error: (e, st) => print('Error: $e'),
);

Auto-Tracking Computed Signals

• Computed<T> now automatically detects dependencies—no manual dependency list required
• Lazy evaluation: computed values only calculate when accessed
• Error handling: computation errors are captured and accessible via hasError, error, stackTrace
• Circular dependency detection with clear error messages

AsyncSignal Improvements

• New refresh() method to re-execute the last operation
• canRefresh getter to check if refresh is available
• Cleaner API using sealed AsyncState<T> internally

Unified MultiSlot Widget

• Consolidated MultiSlot2, MultiSlot3, MultiSlot4, MultiSlot5 into single MultiSlot class
• Factory constructors: MultiSlot.t2(), MultiSlot.t3(), MultiSlot.t4(), MultiSlot.t5(), MultiSlot.t6()
• Dynamic list support: MultiSlot.list() for any number of signals

Changed #

• Signal dependency tracking: Signal.value getter now registers with _DependencyTracker for Computed auto-tracking
• NeuronAtom lifecycle: Added @protected onActive() and onInactive() lifecycle hooks for subclass customization
• notifyListeners() optimization: Avoids list allocation when listeners aren't modified during notification

Fixed #

• Computed reactivity: Fixed issue where Computed signals weren't detecting changes to Signal dependencies
• Deprecation warning: Replaced Color.withOpacity() with Color.withValues() in example app

Documentation #

• Comprehensive README rewrite with extensive Signal/Slot examples
• Comparison table vs other state management solutions
• Real-world examples: E-commerce cart, authentication flow, form validation, debounced search
• Added detailed Widget Guide section

Changed #

• NeuronApp Routes: NeuronApp.routes now accepts List<NeuronRoute> instead of Map<String, WidgetBuilder> for cleaner, GetX-style routing syntax
• Unified Routing: Routes defined with NeuronRoute now work seamlessly in NeuronApp, including path parameters, transitions, guards, and middleware

Added #

• Middlewares in NeuronApp: New middlewares parameter to add navigation middleware directly to NeuronApp
• Full Transition Support: All 20+ NeuronPageTransition presets (fade, slide, scale, blur, etc.) now work with routes in NeuronApp
• Path Parameters: Dynamic route segments like /profile/:id are fully supported and automatically parsed

Example #

NeuronApp(
  routes: [
    NeuronRoute(
      name: 'home',
      path: '/',
      builder: (context, params) => const HomePage(),
    ),
    NeuronRoute(
      name: 'profile',
      path: '/profile/:id',
      builder: (context, params) => ProfilePage(id: params['id']),
      transition: NeuronPageTransition.slideUp,
    ),
  ],
  initialRoute: '/',
)

Fixed #

• README rendering: Fixed ASCII diagram that wasn't displaying correctly on pub.flutter-io.cn

Added #

• Numeric Signal Shortcuts: New extension methods for convenient numeric operations:
  • inc() / dec() - short aliases for increment/decrement
  • add(n) / sub(n) - add or subtract custom amounts
  • All work alongside existing increment(), decrement(), and emit() methods

Documentation #

• Improved Signal/Slot Philosophy: README now includes step-by-step guide showing how Signals in controllers connect to Slots in widgets with visual diagram
• Comprehensive AnimatedSlot docs: All 16 parameters documented with usage tips and best practices
• AnimatedFormSlot constructor docs: Added usage examples and best practices for form validation animations
• Fixed gallery images: Corrected image ordering in README gallery section

Documentation #

• Moved README images to example/assets to ensure correct rendering on pub.flutter-io.cn.

Maintenance #

• Updated dependencies and documentation.

Maintenance #

• General maintenance and package scoring updates.

Documentation #

• Added gallery images to README to showcase AnimatedSlot features.

Maintenance #

• Formatted code to comply with Dart formatter and improve pub.flutter-io.cn score.

Documentation #

• Added missing API documentation for AggregateMiddleware and AnimatedErrorMessage.

Changed #

• Changed AnimatedSlot default clipBehavior to false to prevent clipping of shadows and overflowing content by default.

Maintenance #

• Updated dependencies to latest versions (device_info_plus ^12.3.0, flutter_lints ^6.0.0).
• Added analysis_options.yaml and resolved all static analysis issues to improve pub.flutter-io.cn score.

Metadata #

• Added package topics to pubspec.yaml for better discovery on pub.flutter-io.cn.
• Added CODE_OF_CONDUCT.md.

Documentation #

• Added comprehensive "Widget Guide" to README.md covering Slot, AsyncSlot, MultiSlot, ConditionalSlot, and AnimatedSlot.

Added #

• Documentation: Comprehensive Dartdoc comments with usage examples for all public APIs.
• DevTools Auto-Registration: Signals bound to a controller with .bind(this) are now automatically registered with DevTools.
• Unified Debug Server: New WebSocket + HTTP debug server for better tooling integration.
• New Middleware:
  • RateLimitMiddleware - Limits emission frequency
  • ConditionalMiddleware - Conditional value emission
  • HistoryMiddleware - Track previous values
  • CoalesceMiddleware - Prevent null values
  • AggregateMiddleware - Combine multiple middlewares
• New Persistence Adapters:
  • BinaryPersistence - Custom binary serialization
  • EncryptedPersistence - Encrypted storage wrapper
  • VersionedPersistence - Versioned data with migration support
• DevTools Enhancements:
  • Event filtering by type and signal ID
  • Time range queries
  • Custom event recording
  • Checkpoint creation and restoration
  • Snapshot comparison
  • Activity statistics
• Performance:
  • Cached computed signals with TTL
  • Lazy signal initialization
  • Collection optimizations (reverse, shuffle, filter)

Fixed #

• CLI: Improved dependency injection in generated projects.
• Analysis: Resolved all linter warnings and improved code health.

Planned #

• More middleware types
• Additional persistence adapters
• Enhanced DevTools features
• Performance optimizations
• More comprehensive tests
• Create Dartdoc reference documentation

---

For more information, see the README.