Superpositions

Represent dialogs et sheets avec OverlayRequest? et render them through ScreenOverlayHost ou AnimatedScreenOverlayHost.

Next: Declarative Tabs Back ? Pages et Resolver

Single overlay slot

Model overlay as OverlayRequest? et clear it ? dismiss.

Dialog et sheet support

Use DialogRequest et BottomSheetRequest avec optional payload data.

Back order control

Dismiss overlay first, then pop pages, via back-scope widgets.

Overlay Host Pattern

Keep overlay dans state et build overlay UI through overlayBuilder.

Overlay State Rule

Animated Overlay Host

return AnimatedScreenOverlayHost(
  overlay: _overlay,
  onDismiss: _dismissOverlay,
  overlayBuilder: (context, req, dismiss) => switch (req) {
    DialogRequest(key: 'hello') => AlertDialog(
      title: const Text('Hello'),
      actions: [TextButton(onPressed: dismiss, child: const Text('Close'))],
    ),
    _ => null,
  },
  child: DeclarativePagesNavigator(
    pages: _pages,
    buildPage: _buildPage,
    onPopTop: _popTop,
    canPopTop: () => _overlay == null,
  ),
);

Important

When overlay is visible, block pop gestures avec canPopTop ? avoid back-swipe inconsistency on iOS.

Pages et Resolver

Declarative Tabs