ConfettiController class

Drives a ConfettiWidget manually.

Use when you need to start, stop, or reset confetti from outside the widget tree — for example, from a button press handler.

final controller = ConfettiController();

// In your widget tree:
ConfettiWidget(controller: controller, autoPlay: false, preset: Preset.nova)

// Triggered by a button:
controller.play();

// Always dispose:
@override
void dispose() {
  controller.dispose();
  super.dispose();
}

ConfettiController extends ChangeNotifier. ConfettiWidget listens internally — you don't need to call addListener yourself.