mastro 1.5.1

mastro: ^1.5.1 copied to clipboard

• Minor bug fixes and improvements.
• README overhaul with clearer structure and richer explanations.

Breaking changes #

• Boxes
  • dispose() → cleanup() — Replace any dispose() overrides with cleanup() (call super.cleanup() inside).
  • New Callbacks mechanism:
    Old: Callbacks({'action': ({data}) { ... }})
    New: Callbacks.on('action', (data) { ... }).on(...).on(...)
• Initialization
  • MastroInit.init() is no longer available — use Persistro.initialize() for persistence setup.

Added #

• Providers: new flags
  • autoCleanupWhenUnmountedFromWidgetTree
  • autoCleanupWhenAllViewsDetached
    Behavior unchanged — both control when cleanup() is called automatically.
• Late state support: .late() for uninitialized state on both Lightro and Mastro, with helpers: isInitialized, ensureInitialized(), when(...), resetToUninitialized().
• AsyncState: new AsyncState<T> class for predefined async states (initial, loading, data, error), with .lightro / .mastro wrappers for reactive binding in UI.
• MastroBox: new autoCleanupWhenAllViewsDetached, onViewAttached, and onViewDetached hooks.
• Awaitable sequential events: each queued execute() in EventRunningMode.sequential now returns a Future that completes when that specific queued item finishes (per-type FIFO preserved).
• Rebuild utilities: added RebuildBoundary helper to force subtree rebuilds via a UniqueKey.
• ClassProvider.onDispose: allows running custom cleanup logic when a provided class instance is disposed.
• StaticWidgetProvider: new provider type for supplying static widget instances in the tree without rebuilds.
• Docs: new README with feature-based structure, Lightro vs Mastro comparison, AsyncState, local vs scoped boxes, lifecycle hooks, and MastroScope guidance.

Changed #

• Local boxes in views: recommended pattern is to pass a new box through the MastroView super constructor (commonly via a small factory/closure), while scoped boxes are provided via BoxProvider / MultiBoxProvider.
• Validation & observers (Mastro): clarified usage; validators can gate assignments and run onValidationError.

Improvements #

• Performance improvements in event execution and builder notifications.
• Builders responsiveness
  • MastroBuilder and TagBuilder now perform immediate rebuilds when safe (idle / transient / mid-frame) and defer with post-frame coalescing only during build/layout/paint.
  • Internal defer tokens prevent stale callbacks, avoiding jank with fast gestures.
• TagBuilder hot-swap safety: re-attaches when box changes in didUpdateWidget.
• Logging: state changes are now logged for easier debugging and tracking.
• Error handling: improved error messages for validation failures and runtime exceptions.
• Persistro: improved initialization flow and persistence operations; now initialized explicitly via Persistro.initialize() and supports more reliable state restoration and storage.

• Minor fixes and improvements.

• Minor fixes and improvements.
• Updated documentation.

• Updated documentation.

• Updated documentation.

• Updated documentation.

• First stable release
• Minor fixes and improvements.
• Updated documentation.

• Minor fixes and improvements.

• Updated documentation.

• Minor fixes.

• Minor fixes.

• Minor fixes.

• Minor fixes.

• Minor fixes and improvements.

• Initial release.