bloc_plus library

Classes

BlocBuilderWithBloc, S>: A BlocBuilderBase variant that also passes the resolved bloc instance to builder.
BlocConsumerWithBloc, S>: A BlocConsumer variant that passes the resolved bloc instance to both listener and builder.
BlocListenerWithBloc, S>: A BlocListenerBase variant that also passes the resolved bloc instance to the listener callback.
BlocSelectorWithBloc, S, T>: A selector widget that exposes both the resolved bloc instance and selected value to builder.
CancellationToken: Tracks cancellation for async work that may become stale.
EffectListener, S, E>: Listens to one-off effects emitted by blocs implementing EffectsSource.
EffectsSource<E>: Exposes a stream of one-off effects emitted outside the main bloc state.
ListenPolicy<S>: Encapsulates listener decisions for pairs of previous and current state.
RebuildPolicy<S>: Encapsulates rebuild decisions for pairs of previous and current state.
RestartableTask<T>: Runs async work where starting a new task cancels the previous result.

HasEffects<S, E>: Adds a broadcast effect stream to a bloc and closes it with the bloc.
SafeEmitMixin<S>: Adds guarded emit helpers that no-op after a bloc has been closed.

BlocContextExtension on BuildContext: Adds null-safe bloc lookup helpers to BuildContext.

always<S>() → RebuildPolicy<S>: Rebuilds for every state change.
alwaysListen<S>() → ListenPolicy<S>: Listens for every state change.
distinct<S>() → RebuildPolicy<S>: Rebuilds only when the full state value changes.
distinctListen<S>() → ListenPolicy<S>: Listens only when the full state value changes.
never<S>() → RebuildPolicy<S>: Never rebuilds for state changes.
neverListen<S>() → ListenPolicy<S>: Never listens for state changes.
onChange<S, T>(T selector(S state)) → RebuildPolicy<S>: Rebuilds only when the selected value changes.
onChangeListen<S, T>(T selector(S state)) → ListenPolicy<S>: Listens only when the selected value changes.

BlocSelectedCondition<T> = bool Function(T previous, T current): Signature for deciding whether a newly selected value should trigger a rebuild.
BlocSelectorBuilderWithBloc, S, T> = Widget Function(BuildContext context, B bloc, T selected): Signature for building a widget from a selected value and the resolved bloc.
BlocWidgetBuilderWithBloc, S> = Widget Function(BuildContext context, B bloc, S state): Signature for building a widget with both the resolved bloc and current state.
BlocWidgetListenerWithBloc, S> = void Function(BuildContext context, B bloc, S state): Signature for listening to state changes with access to the resolved bloc.