CLShellPageActions class

Pubblica actions sul canale page dello shell (CLShellScope) per tutta la vita del widget: lo shell le ricolloca da sé (header su desktop/tablet, area contestuale sopra la bottom bar su mobile). Incapsula il lifecycle che le pagine altrimenti ricablano a mano — lookup dello scope, publish post-frame, gate sulla rotta corrente, clear in dispose — così una pagina passa da ~15 righe sparse (campo + didChangeDependencies + post-frame + dispose) a un solo widget nel tree:

return CLShellPageActions(
  actions: _shellActions(context, vm),
  child: _buildLayout(context, vm),
);

Trasparente al layout: ritorna child invariato (è solo un publisher). Le actions vengono ri-pubblicate a ogni rebuild del parent, quindi è corretto passare una lista ricostruita dal viewmodel.

gateOnCurrentRoute (default true): pubblica solo se il ModalRoute della pagina è quello corrente — evita che una lista, mentre una rotta figlia è in cima ma resta montata e ribuilda, sovrascriva le azioni della figlia. Mettere a false nelle rotte foglia con GoRouter nidificato, dove ModalRoute di questo context risolve il route del parent (ModalRoute.isCurrent sarebbe sempre false): lì il cleanup è comunque garantito dal dispose → clearPage.