drip_flutter 0.7.1-alpha

Flutter reactive render binding for DripState, enabling zero-rebuild UI updates through direct RenderObject synchronization.

0.7.1-alpha — 2026-05-18

Changed

• Test-suite reliability improvements aligned with DRIP's two-pump reactive contract in widget tests.
• drip_test helper alignment for node lifecycle and async assertion coverage.
• Final release-readiness documentation and metadata verification.

---

0.7.0-alpha — 2026-05-17

API Freeze

The drip_flutter public API is now frozen. No new widgets, classes, or functions will be added without a documented proposal. No public symbol will be removed without a deprecation cycle of at least one minor version. This version is the last pre-1.0.0 version before the drip_flutter 1.0.0 stable release.

Frozen API Surface

• DripText — binds DripState<String> to text rendering.
• DripOpacity — binds DripState<double> to opacity.
• DripColor — binds DripState<Color> to background color.
• DripTransform — binds DripState<Matrix4> to transforms.
• DripImage — binds DripState<ImageProvider> to images.
• DripCustomBinding<T> — user-defined render binding base.
• DripFrame<T> — controlled structural update frame.
• DripFrameBuilder<T> — widget builder for frame-driven updates.
• DripBuilder<T> — rebuilds a subtree on source changes.
• DripSelect — rebuilds only when the selected slice changes.
• DripAsyncBuilder<T> — handles DripAsyncValue<T> states with slots.
• DripItemBuilder<T> — builds a single item from DripItems<T>.
• DripLifecycle<N> — creates and disposes a node-backed scope with the widget.
• DripScope.asWidget() — wraps an existing scope as a widget ancestor.
• DripSemantics<T> — bridges reactive values into the semantics tree.
• DripNode — optional feature-module convenience base class.
• DripAsyncNode — optional async helper mixin for DripNode.

Changed

• DripNode and DripAsyncNode documentation now explicitly presents them as optional convenience patterns, not required architectural components.
• DripSelect2, DripSelect3, and DripSelect4 are internalized behind the frozen DripSelect.two, DripSelect.three, and DripSelect.four entry points.
• DripFlutterBinding remains an internal integration bridge and is no longer exported from the public barrel.
• DripAsyncNodeMixin is replaced by the frozen DripAsyncNode mixin name.

Removed

• DripReadableX and its asString, map, and where convenience methods were removed from the public surface because they are not part of the frozen Flutter API.

0.6.0-alpha - 2026-05-17

BREAKING CHANGES

This release removes all APIs deprecated in 0.5.1-alpha. If your code uses any of the following, it will not compile after this upgrade. See MIGRATION.md for the replacement for each:

• DripNodeProvider — use DripLifecycle.
• context.node<N>() — use DripLifecycle and explicit dependency passing.
• DripRouteNode — use DripLifecycle with a route observer.
• DripList<T> — use DripItems<T> from drip_core.
• DripListView<T> — use DripItemBuilder from drip_flutter.

Changed

• drip_core dependency updated to ^1.0.0 (stable).

---

0.5.1-alpha - 2026-05-16

Added

• DripItemBuilder<T>: Reactive builder that binds to a specific element index of a DripItems collection, supporting standard rebuilding or high-performance zero-rebuild direct render binding mode.
• DripSemantics: Accessibility bridge for DripReadable<T>. Synchronizes reactive values to the semantics tree with debounced updates.
• DripLifecycle: High-level widget for managing DripNode or DripScope lifetimes without InheritedWidget. Enforces context-free injection.
• DripScope.asWidget(): Extension to easily bind a scope's disposal to a widget's lifecycle.

Deprecated

• DripNodeProvider, context.node(), DripRouteNode, DripList, and DripListView are now deprecated.
• Migration: Use DripLifecycle for node management, DripItems as the list-state model, and DripItemBuilder for list item rendering.

Changed

• DripBinding: Now integrates with DripTrace to provide diagnostic context on render property updates.

---

0.5.0-alpha - 2026-05-16

Fixed

Subscription Lifecycle — DripRenderParagraph (Risk 4 / CI-1.2)

• Root cause: unbindState() was the only teardown path and always set _source = null. When Flutter reuses the same RenderObject instance after unmounting a widget (same slot / same type), RenderObject.attach() fired on remount but _createBinding() returned early because _source was null — no new subscription was registered.
• Fix: Split teardown into two methods:
  • detachBinding() — removes the DripBinding subscription but preserves _source, so attach() can re-subscribe on remount. Called from didUnmountRenderObject.
  • unbindState() — full teardown (clears both _binding and _source). Called only when the source is replaced via bindState() or the RenderObject is permanently disposed.

Test Timing — flutter_test two-pump pattern

• Root cause: DripBatch schedules propagation via Future.microtask. In flutter_test's FakeAsync, microtasks drain after the frame's build phase. Calling write() → one pump() delivers the notification and calls setState, but the resulting dirty build is not picked up until the next frame.
• Fix (callback_identity_test.dart / scratch_test.dart): Changed all write-then-assert sequences to use two pumps after a reactive write:
  1. First pump: microtask drains → _onChanged fires → setState marks element dirty.
  2. Second pump: Flutter builds the dirty element → widget remounts → attach() → subscription re-registered → listener count correct.
• Also added await tester.pump() before pumpWidget() in the unmount step so the write(false) notification is committed before the tree is replaced.

Internal

• Diagnostic print instrumentation added to DripBuilder._onChanged, initState, and dispose to trace the Flutter element lifecycle — removed after root cause confirmed.
• All 113 drip_flutter tests pass. Zero dart analyze warnings.

---

0.4.0-alpha

Added

• DripBuilder<T> — general-purpose reactive builder widget. Accepts any DripReadable<T> (DripState, DripComputed, or DripAsync) and rebuilds its subtree when the value changes. Scoped setState — only the builder's own subtree rebuilds.
• DripSelect — multi-source reactive builder. Uses an internal DripComputed to combine multiple reactive sources. Rebuilds only when the combined output changes (version-clock and equality checked). Supports Dart 3 record types as combined value.
• DripAsyncBuilder<T> — async state widget with exhaustive sealed-class switching. Provides loading, data, and error builder callbacks. Both loading and error receive previousData for continuity patterns. Sensible defaults for unimplemented callbacks (debug warnings included).
• DripAsyncNode mixin — adds asyncState<T>(), asyncFromFuture(), and asyncFromStream() to DripNode subclasses. All async states are automatically scoped to the node's DripScope.

Dependencies

• drip_core constraint updated to ^0.2.0-alpha

---

0.3.0-alpha - 2026-05-15

Added — Node System

• DripNode — abstract feature module with an owned DripScope. Extend to create a named, scoped business-logic unit. All state, computed values, and effects are automatically disposed when the node is disposed.
• DripNode.register<T> / DripNode.resolve<T> — scoped dependency injection. Singleton by default; no global service locators.
• DripNode lifecycle: onInit, onDispose, onBackground, onForeground.
• DripNodeProvider<N> — StatefulWidget + InheritedWidget that creates a node on mount, forwards app-lifecycle events, and disposes it on unmount. Uses a Builder child to ensure the context passed to builder sits below the InheritedWidget so context.node<N>() resolves correctly.
• DripRouteNode — DripNode subclass with route-lifecycle hooks (onRouteEnter, onRouteLeave). Integrates with Flutter's RouteObserver.
• BuildContext.node<N>() / BuildContext.maybeNode<N>() — ergonomic node lookup extensions.

Added — List System

• DripList<T> — reactive list with item-level subscriber granularity. Updating index i notifies only the subscriber registered for index i.
• DripListView<T> — list widget that rebuilds only the tile at the changed index. Structural changes (add/remove) trigger a minimal list-level rebuild.

Fixed

• DripNodeProvider.of() now injects the actual runtime type name $N in the missing-provider error message (was $N as a literal string due to escaped interpolation).
• DripNodeProvider.builder context now correctly resolves its own InheritedWidget by wrapping the child in a Builder.

Architecture

• DripValue<T> interface introduced in drip_core — shared readable/subscribable contract implemented by both DripState<T> and DripComputed<T>. All Flutter render widgets now accept DripValue<T>, allowing computed values to be passed directly without casting.
• DripListener / ListenerSubscriber moved to drip_state_base.dart to be accessible package-wide without importing implementation files.
• DripNode is pure Dart — fully unit-testable without a Flutter widget tree.

Testing (drip_flutter)

• drip_node_test.dart — 20+ tests covering DripNode lifecycle, register/resolve, effects, and disposal.
• drip_node_provider_test.dart — 8 tests covering mount/unmount, lifecycle forwarding, Provider.of, context.node, error messages, and nested providers.
• drip_route_node_test.dart — route lifecycle integration tests.
• drip_list_test.dart — 10 tests covering add, removeAt, []=, insert, replaceAll, update, dispose.
• drip_list_view_test.dart — 8 tests including a 10,000-item single-tile-rebuild benchmark.

---

0.2.0-alpha - 2026-05-13

First release of drip_flutter — the Flutter direct render binding layer.

Added

• DripBinding<T> — live RenderObject subscriber. Applies state changes directly to render properties, bypassing the widget/element rebuild cycle.
• DripText — zero-rebuild text widget. Binds DripValue<String> to RenderParagraph.text via markNeedsLayout().
• DripOpacity — zero-rebuild opacity widget. Binds DripValue<double> (clamped [0.0, 1.0]) via markNeedsPaint().
• DripColor — zero-rebuild background color binding via markNeedsPaint().
• DripTransform — zero-rebuild Matrix4 transform binding via markNeedsPaint().
• DripImage — ImageProvider binding with async image resolution.
• DripCustomBinding<T> — abstract base class for custom RenderObject bindings.
• DripFrame<T> / DripFrameBuilder<T> — controlled rebuild boundary for deliberate structural updates.

Performance

• Verified: 1,000 simultaneous DripState writes → 0 widget build() calls.
• Demo app demo_grid: 1,000-cell live grid at 60 fps, zero rebuilds.

Architecture

• Invariant 2 enforced: zero setState() calls in binding code path.
• Invariant 7 enforced: all bindings deregistered in didUnmountRenderObject.