drip_flutter 0.5.1-alpha

Flutter render layer for DRIP — direct RenderObject binding with zero widget rebuilds.

0.5.1-alpha - 2026-05-16

Added

• 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 and DripBuilder for list updates.

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.