neuron 1.1.13

Signal/Slot reactive state management for Flutter. Clean syntax, powerful features including middleware, persistence, time-travel debugging, and code generation support.

Changelog

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

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

1.0.0 - 2025-11-21

Added

• Initial release of Neuron state management framework
• Core reactive primitives: Signal<T>, AsyncSignal<T>, Computed<T>
• Specialized collection signals: ListSignal<E>, MapSignal<K,V>, SetSignal<E>
• Rate limiting signals: DebouncedSignal, ThrottledSignal, DistinctSignal
• Middleware system with built-in middlewares:
  • LoggingMiddleware - Log value changes
  • ValidationMiddleware - Validate before emit
  • ClampMiddleware - Clamp numeric values
  • TransformMiddleware - Transform values
  • SanitizationMiddleware - Sanitize strings
• Persistence adapters:
  • PersistentSignal - Auto-save/load
  • JsonPersistence - JSON serialization
  • SimplePersistence - String-based storage
  • MemoryPersistence - In-memory (testing)
• Effects and reactions:
  • SignalReaction - Side effects on changes
  • SignalTransaction - Batch updates
  • SignalAction - Async operations with state
• DevTools integration:
  • SignalDevTools - Time-travel debugging
  • Event tracking and history
  • State inspection and export
• Widget integration:
  • Slot<T> - Connect signals to UI
  • AsyncSlot<T> - Handle async states
  • NeuronApp - MaterialApp wrapper
• Service locator:
  • Neuron - Global controller registry
  • NeuronController - Base controller with lifecycle
  • Auto-disposal with .bind()
• Context-less navigation:
  • Neuron.to(), Neuron.off(), Neuron.back()
  • Neuron.toNamed(), Neuron.offNamed()
• Utility methods via SignalUtils
• Extension methods on signals
• Comprehensive example app
• Full documentation and README

Design Philosophy

• Signal/Slot terminology and concepts
• StatelessWidget-only approach (no StatefulWidget)
• Static init pattern for controllers
• Clean, predictable API
• Type-safe and compile-time checked

1.1.13 - 2025-12-07

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: '/',
)

1.1.12 - 2025-12-06

Fixed

• README rendering: Fixed ASCII diagram that wasn't displaying correctly on pub.dev

1.1.11 - 2025-12-06

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

1.1.10 - 2025-12-06

Documentation

• Moved README images to example/assets to ensure correct rendering on pub.dev.

1.1.9 - 2025-12-06

Maintenance

• Updated dependencies and documentation.

1.1.8 - 2025-12-06

Maintenance

• General maintenance and package scoring updates.

1.1.7 - 2025-12-06

Documentation

• Added gallery images to README to showcase AnimatedSlot features.

1.1.6 - 2025-12-06

Maintenance

• Formatted code to comply with Dart formatter and improve pub.dev score.

1.1.5 - 2025-12-05

Documentation

• Added missing API documentation for AggregateMiddleware and AnimatedErrorMessage.

1.1.4 - 2025-12-05

Changed

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

1.1.3 - 2025-12-05

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.dev score.

1.1.2 - 2025-12-05

Metadata

• Added package topics to pubspec.yaml for better discovery on pub.dev.
• Added CODE_OF_CONDUCT.md.

1.1.1 - 2025-12-05

Documentation

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

1.1.0 - 2025-12-05

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.