FloatyActionRouter class final

A typed action dispatch system that replaces manual string-key matching.

Define an ActionKey as a static const on each action class, then register handlers by passing the key. The type parameter ensures the handler is invoked with the correct payload type.

Main app side:

final router = FloatyActionRouter();

router.on(
  NavigateAction.key,
  (action) => mapController.move(action.target, zoom),
);

// Dispatch an action to the overlay.
router.dispatch(PinAction(lat: 12.0, lng: -86.0));

Overlay side:

final router = FloatyActionRouter.overlay();

router.on(
  PinAction.key,
  (action) => setState(() => pin = action),
);

Actions coexist with raw shareData messages — they use a reserved _floaty_action prefix and do not interfere with existing data streams.

Offline queueing (overlay only):

When the main app is disconnected, dispatched actions are queued and automatically flushed upon reconnection. Control queue behavior with maxQueueSize and overflowStrategy.