SetupMixin<T extends StatefulWidget> mixin

A mixin that brings setup-based composition API to StatefulWidget.

This mixin allows you to use Jolt's reactive setup pattern with traditional StatefulWidget, providing a bridge between Flutter's standard widget system and Jolt's composition API.

Usage

class MyWidget extends StatefulWidget {
  final String title;
  final int initialCount;

  const MyWidget({super.key, required this.title, required this.initialCount});

  @override
  State<MyWidget> createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> with SetupMixin<MyWidget> {
  @override
  setup(context) {
    // Access widget properties via props getter
    final count = useSignal(props.initialCount);

    // Use any Jolt hooks
    useEffect(() {
      print('Title: ${props.title}');
    }, [props.title]);

    return () => Column(
      children: [
        Text(props.title),
        Text('Count: ${count.value}'),
        ElevatedButton(
          onPressed: () => count.value++,
          child: Text('Increment'),
        ),
      ],
    );
  }
}

Features

• Props Access: Use the props getter to access widget properties reactively
• Hooks Support: All Jolt hooks (useSignal, useComputed, useEffect, etc.)
• Lifecycle Integration: Automatically integrates with Flutter's State lifecycle
• Hot Reload: Full hot reload support with hook state preservation

Lifecycle

The mixin automatically handles:

• Setup function runs on first build (after initState, before first build)
• Props updates trigger JoltSetupContext.notifyUpdate
• Dependencies changes trigger JoltSetupContext.notifyDependenciesChanged
• Cleanup on dispose

When to Use

Use SetupMixin when:

• You need StatefulWidget features (like State.mounted)
• Integrating with existing StatefulWidget code
• You prefer State's lifecycle methods

Use SetupWidget when:

• Building new components from scratch
• You want the simplest API
• Element's lifecycle is sufficient