FeatureScope class

Groups multiple feature-level blocs for collective lifecycle management.

When a feature or user flow requires multiple blocs that should share the same lifecycle, create a FeatureScope and register blocs with it. When the feature completes, call end to dispose all managed blocs.

Example:

class CheckoutFlow {
  late final FeatureScope scope;

  Future<void> start() async {
    scope = await FeatureScope.create('checkout');
    BlocScope.register<CartBloc>(() => CartBloc(),
        lifecycle: BlocLifecycle.feature, scope: scope);
    BlocScope.register<PaymentBloc>(() => PaymentBloc(),
        lifecycle: BlocLifecycle.feature, scope: scope);
  }

  Future<void> complete() => scope.end();
}

Reactive Lifecycle with ScopeLifecycleBloc

When ScopeLifecycleBloc is registered, FeatureScope provides reactive lifecycle:

// Register ScopeLifecycleBloc first
BlocScope.register<ScopeLifecycleBloc>(() => ScopeLifecycleBloc(),
    lifecycle: BlocLifecycle.permanent);

// Create scope - automatically registers with ScopeLifecycleBloc
final scope = await FeatureScope.create('checkout');

// End triggers cleanup sequence:
// 1. ScopeLifecycleBloc publishes ScopeEndingNotification
// 2. Subscribers register cleanup futures
// 3. CleanupBarrier awaited with timeout
// 4. Blocs disposed
await scope.end();

Without ScopeLifecycleBloc, FeatureScope works but without reactive cleanup.