SetupHook<T> class abstract

Base class for all setup hooks.

Hooks provide a way to encapsulate reusable stateful logic in SetupWidget. Each hook has a lifecycle that mirrors the widget lifecycle.

Lifecycle Methods

• build: Called once to create the initial state (on first use)
• mount: Called after the hook is created and added to the widget
• unmount: Called when the hook is being removed (on dispose or hot reload mismatch)
• didUpdateWidget: Called when the widget is updated with new properties
• didChangeDependencies: Called when the widget's dependencies change
• activated: Called when the widget is reactivated (e.g., after being in a navigator stack)
• deactivated: Called when the widget is deactivated
• reassemble: Called during hot reload when the hook is reused

Hot Reload Behavior

During hot reload, hooks are matched by their runtime type and position:

• If the hook type at position N matches, the hook is reused and reassemble is called
• If there's a type mismatch, this and all subsequent hooks are unmounted
• New or replacement hooks have mount called

Example:

class TimerHook extends SetupHook<Timer> {
  @override
  Timer build() => Timer.periodic(Duration(seconds: 1), (_) {});

  @override
  void mount() {
    print('Timer started');
  }

  @override
  void unmount() {
    state.cancel();
    print('Timer cancelled');
  }

  @override
  void reassemble() {
    print('Hot reload - timer preserved');
  }
}