blooming 0.3.0
blooming: ^0.3.0 copied to clipboard
High-performance, glitch-free 2-phase LPDAG reactive state & effect framework for Dart.
0.3.0 #
- Algebraic Early-Exit Control Flow (
via.exit):- Replaced legacy
BloomGuardwith algebraic early-exit control flow viavia.exit({Object? emptyReason})andvia.exitIfInactive({Object? emptyReason}). - Migrated derived computations (
computed,switched,managed,Computation) and record tuple extensions (.allHaveData()+via.exit()) to the algebraic early-exit protocol. - Hardened turn-isolation and exception propagation so that
via.exit()thrown out-of-band or escaped outside evaluation closures immediately bubbles up as an unhandled_ViaShortCircuit.
- Replaced legacy
- Domain Separation (
BloomVia&EffectVia):- Decoupled reactive data evaluation from side-effect pipelines:
BloomViais used exclusively for state evaluation (computed,switched,managed), whileEffectViais used for side-effect dispatch (Effect.via,Effect.scoped.via).
- Decoupled reactive data evaluation from side-effect pipelines:
- Tether Binding Alignment:
- Standardized
.tether()contract across bothBloomVia.tetherandEffectVia.tetherto link child effect lifetimes to their parent reactive scope.
- Standardized
- Architectural 5-Tier Domain Structure:
- Restructured internal architecture into Graph (
src/graph/), Blooming (src/blooming/), Bloom (src/bloom/), Effect (src/effect/), and Reflector (src/reflector/).
- Restructured internal architecture into Graph (
- Ecosystem: Synchronized release with Blooming ecosystem v0.3.0.
0.2.5 #
- On-Demand Asynchronous Tracking & Turn Isolation:
- Enabled post-
awaitand post-yielddependency tracking viaBloomVia(forcomputed.future,computed.stream) andEffectVia(forEffect.via,Effect.scoped.via) through_ViaTrack(closed,sync,async) and_resultViaTrack. - Enforced strict turn isolation by rotating tracker instances (
BloomVia/EffectVia) on demand when a new epoch begins or the node deactivates while an asynchronous turn is in flight, preventing stale turns from mutating the active dependency graph. - Propagated post-
await/ post-yield_ViaShortCircuitexceptions in_DeLorean,_PragueVltava,_ViaEffectTerminal, and_HandledViaEffectTerminal. - Unified
BloomViainto a single concretefinal classand merged dependency-tracking dispatch to eliminate polymorphic call overhead on the synchronous hot path.
- Enabled post-
- Native
FutureOr<T>Support incomputed.future:- Accepted
FutureOr<T> Function(BloomVia via) computeincomputed.future, enabling 0ms synchronous instant resolution (Fast-Path) when returning synchronous values (e.g. cache hits) without microtask latency. - Refined
Futureinstance validation and dynamic subtype unwrapping, ensuring untyped or dynamic futures resolve safely through_FutureBloomBridge.
- Accepted
- API Refinement: Liquidated redundant
computed.asyncalias in favor of explicitcomputed.futureandcomputed.streamprimitives. - Ecosystem: Synchronized release with Blooming ecosystem v0.2.5.
0.2.4 #
- Lazy Factory Bridges: Introduced
FutureFactoryBloomExtensionandStreamFactoryBloomExtensionproviding.toBloom(),.toBloomTuple(), and.toBloomTriple().- Defers execution of
Future<T> Function()until0 -> 1subscriber activation and refetches on subsequent reactivations. - Safely manages single-subscription
Stream<T>instances (async*generators) across1 -> 0 -> 1cycles by spawning a fresh stream on each activation. - Implemented bulkhead isolation upon deactivation to prevent late-settling completions from contaminating subsequent states.
- Unified internal factory architecture into
_AsyncFactoryMixin.
- Defers execution of
- Fault Tolerance & Synchronous Resilience: Hardened synchronous throw protection on
future.thenandstream.listeninvocation, ensuring synchronous bridge initiation failures transition directly into error state without escaping as unhandled errors. - Documentation & Spec Auditing: Documented stream reactivation trade-offs in
_PragueVltavaand synchronized all architectural foundation documents with living documentation tests. - Ecosystem: Synchronized release with Blooming ecosystem v0.2.4.
0.2.3 #
- Documentation & Examples: Audited and aligned all architectural foundation documents, README, and API doc comments with the Truth Verification Protocol (TVP), converting all inline code snippets to 100% pure Dart.
- Ecosystem: Synchronized release with Blooming ecosystem v0.2.3.
0.2.2 #
- Ecosystem: Synchronized release with Blooming ecosystem v0.2.2.
0.2.1 #
- Effect Architecture: Promoted
sealed class Effectto the canonical entrypoint with standardized sub-factories (Effect(...),Effect.scoped(...),Effect.debounce(...),Effect.throttle(...)). Liquidated legacy top-leveleffectfunctor in favor of the unifiedEffectcontract. - Lifecycle & Temporal Pipeline: Standardized effect lifecycle naming (
EffectScope,onCleanup), hardened same-turn trailing cancellation, and strengthened dual-edge validation. - Ecosystem: Synchronized release with Blooming ecosystem v0.2.1.
0.2.0 #
Breaking Changes & Migration Guide #
- State Producer Instantiation Unification: Concrete constructors for state controllers (
BloomController,RawBloomController,BloomSignalController,BloomDraftController) are now encapsulated and private (._()). All state creation must use the unified hierarchicalbloomingfunctor family.- Migration Guide:
BloomController(init)→blooming(init)BloomController.late()→blooming.late<T>()BloomController.error(e)→blooming.error<T>(e)RawBloomController(init)→blooming.raw(init)RawBloomController.late()→blooming.raw.late<T>()BloomSignalController()→blooming.signal()BloomDraftController.list(init)/BloomListController(init)→blooming.list(init)BloomDraftController.map(init)/BloomMapController(init)→blooming.map(init)BloomDraftController.set(init)/BloomSetController(init)→blooming.set(init)
- Migration Guide:
- Coupler Independence:
BloomCouplerexplicitly retains its standalone public constructor (BloomCoupler(...)) as an explicit pipeline coupler and adapter rather than a state producer. - Collection Functor Privatization: Collection functor implementation classes for
blooming.list,blooming.map, andblooming.setare strictly internal and inaccessible from public API exports.
Improvements & Hardening #
- Exception Stringification: Hardened
BloomSnapshotExtractionExceptionformatting against double faults and cascading toString evaluation failures during diagnostic extraction. - Ecosystem: Synchronized release with Blooming ecosystem v0.2.0.
0.1.5 #
- Async Primitives: Introduced tuple async primitives (
Bloom.tuple,Bloom.tupleAsync,BloomAsyncTuple2,toBloomTuple(),toBloomTriple()) for ergonomic multi-signal coordination. - Stream Lifecycle: Isolated Stream bridge subscription activation strictly to data demand, and made
subscribe()fully idempotent to eliminate redundant subscriptions. - Exceptions: Separated
BloomEmptyExtractionExceptionandBloomErrorExtractionExceptionunderBloomSnapshotExtractionExceptionwith actionable causal diagnostics and guidance. - Ecosystem: Synchronized release with Blooming ecosystem v0.1.5.
0.1.4 #
- Ecosystem: Synchronized release with Blooming ecosystem v0.1.4.
0.1.3 #
- Ecosystem: Synchronized release with Blooming ecosystem v0.1.3.
0.1.2 #
- Ecosystem: Synchronized release with Blooming ecosystem v0.1.2.
- Assets & Branding: Aligned vector banner typography and grid guidelines.
0.1.1 #
- Assets & Branding: Updated official high-resolution pub.dev package logo and screenshot assets.
- Documentation: Added official vector branding assets and standardized logo representations.
0.1.0 #
- Initial release of
bloomingon pub.dev.