state library
Reactive state management, locator, and observables from AppForge.
Classes
-
AppBind<
T extends AppController> - Lifecycle-bound widget that automatically registers an AppController on mount, triggers AppController.onReady post-frame, and auto-disposes it when unmounted.
- AppBindings
- Interface for declaring modular dependencies.
-
AppBuilder<
T extends AppController> - A lightweight manual-update builder bound to an AppController.
-
AppBuilderState<
T extends AppController> - State backing AppBuilder.
- AppController
- Base controller class with deterministic lifecycle management.
- AppLocator
- Lightweight, memory-safe dependency injection container.
-
AppOverride<
T> - Typed dependency override entry for AppTestScope.
- AppService
- Base service class for long-lived, singleton background and core services.
- AppTestScope
- Scoped widget container that applies overrides on mount and automatically restores prior AppLocator state when disposed.
-
AppView<
T> - Base StatelessWidget with convenient access to a controller registered in AppLocator.
- BindingsBuilder
- Convenience builder for functional dependency registration.
- EvaluationContext
- Evaluation context stack for automatic reactive dependency tracking.
-
Rx<
T> - A reactive variable wrapper providing fine-grained, zero-dependency state updates.
- RxConsumer
- Internal interface for consumers that track reactive dependencies.
-
RxList<
E> - A reactive List that automatically notifies Watch and listeners when mutated.
-
RxMap<
K, V> - A reactive Map that automatically notifies Watch and listeners when mutated.
-
Rxn<
T> - A nullable reactive variable wrapper.
- RxNotifier
- Common interface for notifiers that report reactive changes.
-
RxSet<
E> - A reactive Set that automatically notifies Watch and listeners when mutated.
- RxSubscription
- Handle for cancelling an active Rx listener subscription.
-
UiFailure<
T> - The failure state containing error diagnostics and an optional error object.
-
UiIdle<
T> - The initial state before any action is executed.
-
UiLoading<
T> - The loading state while an asynchronous operation is in flight.
-
UiState<
T> - Represents a discrete, type-safe UI state machine.
-
UiSuccess<
T> - The success state containing the payload data.
- Watch
- A surgical, fine-grained reactive widget.
Extensions
-
AppIterableExtension
on Iterable<
E> - Common functional iterable extensions.
-
AppListExtension
on List<
E> - Common functional list extensions.
-
RxBoolExtension
on Rx<
bool> - Ergonomic extensions on boolean reactive variables.
- RxExtension on T
-
Extension enabling the
.obsreactive syntax on any Dart object or value. -
RxListExtension
on List<
E> -
Extension enabling
.obson List. -
RxMapExtension
on Map<
K, V> -
Extension enabling
.obson Map. -
RxSetExtension
on Set<
E> -
Extension enabling
.obson Set. -
RxStringExtension
on Rx<
String> - Ergonomic string forwarding extensions on reactive strings.
Functions
-
debounce<
T> (ValueListenable< T> listener, void callback(T val), {Duration time = const Duration(milliseconds: 800)}) → Worker -
Calls
callbackwhenlistenerchanges, debounced bytime. -
ever<
T> (ValueListenable< T> listener, void callback(T val)) → Worker -
Calls
callbackevery timelistenerchanges. -
everAll(
List< Listenable> listeners, void callback(dynamic val)) → Worker -
Calls
callbackevery time any of thelistenerschange. -
interval<
T> (ValueListenable< T> listener, void callback(T val), {Duration time = const Duration(milliseconds: 800)}) → Worker -
Calls
callbackat most once pertimeduration whenlistenerchanges. -
once<
T> (ValueListenable< T> listener, void callback(T val)) → Worker -
Calls
callbackonly the first timelistenerchanges, then auto-cancels.