air_state

Architecture Improvements

• Strong Type Retention in AirListener: Improved the generic type resolution mechanism when iterating over List<AirStateKey>. Controller resolution now utilizes dynamic dispatch directly on the AirStateKey<T> instance, guaranteeing the preservation of the explicit generic type T and ensuring strictly typed state initialization.

Improvements

• AirPulse Callable Shorthand: AirPulse<T> is now a callable class. Use AuthPulses.clearMessages(null) instead of AuthPulses.clearMessages.pulse(null). The explicit .pulse() method remains available for backward compatibility.

Improvements

• AirListener: Introduced the AirListener widget for handling one-off side effects (navigation, SnackBars) reactively without triggering UI rebuilds. This component promotes better separation of concerns and keeps the widget build methods pure.

Bug Fixes

• Fixed silent data loss in StatePersistence._serialize(): Custom model objects with toJson() or toMap() methods now serialize correctly. Previously, the existence check obj.toJson != null always threw NoSuchMethodError (swallowed by a catch), causing all custom models to fall back to .toString() — making restore impossible. Now calls toJson()/toMap() directly inside a try-catch.
• Fixed subscription leaks in AirState.dispose(): Simplified the disposal logic to a single try { (sub as dynamic).cancel() } catch (_) {} block. The previous implementation had unreachable branches and silently swallowed cancellation errors, leaving subscriptions alive after dispose.
• Removed unused dart:async import from air_state_base.dart.

• Visual Identity: Added the official Air Framework SVG logo.
• Documentation: Updated README with the new logo and visual assets.

• Security & Access Control:
  • Added canAccess method to AirDelegate to validate state access permissions.
  • Updated AirBuilder to check for access permissions before building.
  • Added sourceId tracking to AirDelegate.subscribe and AirState event listeners.
• API Improvements:
  • AirBuilder, AirBuilder2, and AirBuilder3 now accept callerModuleId for better dependency tracking.
  • Updated AirDelegate interface signature

• Updated examples and internal documentation links.

• Initial release of air_state.
• Core reactive state management (AirController, Air).
• Typed state keys support (AirStateKey).
• Widget builders (AirBuilder, AirView).
• Helper extensions for Tuples.