PageStateActions class

Actions for a page, addressed by the state name its NyPage listens on.

Build one from the page's path and keep it on the page class, so every call site reads the page it reaches:

class HomePage extends NyStatefulWidget<HomeController> {
  static RouteView path = ("/home", (_) => HomePage());
  static final actions = path.actions;

  HomePage({super.key}) : super(child: () => _HomePageState());
}

HomePage.actions.showToast("hello");
HomePage.actions.call("shake_the_logo", {"times": 3});

Every built-in method here is handled by NyBaseState.stateUpdated, so the same object drives a NyState widget when built from its state name: PageStateActions(Cart.state). A named action sent with call runs the handler registered under that name in the target's stateActions.

Typed actions

Subclass this and declare methods without a body. Each one is sent to the target as a typed action - the method's name as a Symbol, with the arguments it was called with - and the target registers its handler under that symbol:

class HomePageActions extends PageStateActions {
  HomePageActions(super.state);

  void shakeTheLogo({int times = 1}); // no body: sent by noSuchMethod
  void setStars(int stars);
}

class HomePage extends NyStatefulWidget<HomeController> {
  static RouteView path = ("/home", (_) => HomePage());
  static final actions = HomePageActions(path);
  ...
}

class _HomePageState extends NyPage<HomePage> {
  @override
  Map<Object, Function> get stateActions => {
    #shakeTheLogo: shakeTheLogo,
    #setStars: setStars,
  };

  void shakeTheLogo({int times = 1}) { ... }
  void setStars(int stars) { ... }
}

HomePage.actions.shakeTheLogo(times: 3);

Register the handlers with symbol literals (#shakeTheLogo), never with Symbol("shakeTheLogo"): under flutter build --obfuscate a literal is renamed together with the method it names, a symbol built from a string is not. A bodiless action returns void; its handler runs on the target once the event bus delivers it.