ContextAccessGate class final

A universal access gate widget that operates on an AccessContext instance, allowing both sync and async permission checks.

Displays child if the provided allow condition returns true, otherwise shows fallback or hides the widget.

Basic usage:

ContextAccessGate(
  context: MyAccessContext(),
  allow: (ctx) => ctx.hasRole('admin'),
  child: Text('Access granted'),
  fallback: Text('Access denied'),
)

With builder:

ContextAccessGate(
  context: MyAccessContext(),
  allow: (ctx) => ctx.isFeatureEnabled('dark_mode'),
  builder: (context, allowed) => Icon(
    allowed ? Icons.check : Icons.block,
  ),
)

With async conditions:

ContextAccessGate(
  context: MyAccessContext(),
  allow: (ctx) async => await ctx.hasPermission('edit'),
  loading: CircularProgressIndicator(),
  child: Text('Allowed'),
)

Optional callbacks:

• onAllow: Called when access is granted
• onDeny: Called when access is denied
• onError: Called on exception during evaluation

This gate is context-agnostic and ideal for non-UI driven access models (e.g., BLoC, Riverpod, pure DI).