var fsm = new CyclopsStateMachine();

var gameplay = new CyclopsState
{
    Name = "Gameplay",
    OnEnter = () => Debug.Log("Game started!"),
    OnUpdate = () => { /* game logic */ }
};

var gameOver = new CyclopsState
{
    Name = "GameOver",
    OnEnter = () => Debug.Log("Game Over")
};

// Declare transition: gameplay → gameOver when player dies
gameplay.AddTransition(gameOver, () => player.IsDead);

fsm.PushState(gameplay);

// In your update loop:
void Update() => fsm.Update();

var hud = new CyclopsState { Name = "HUD" };
var pauseMenu = new CyclopsState { Name = "PauseMenu" };

// Escape pushes pause menu on top of HUD
hud.AddPushTransition(pauseMenu, () => Keyboard.current.escapeKey.wasPressedThisFrame);

// Escape pops pause menu, returning to HUD
pauseMenu.AddPopTransition(() => Keyboard.current.escapeKey.wasPressedThisFrame);

fsm.PushState(hud);

using Cyclops.States.BehaviorTree;

var ai = Bt.Selector("AI",
    Bt.Sequence("Attack",
        Bt.Condition("HasTarget", () => target != null),
        Bt.Action("Fire", () => weapon.Fire())
    ),
    Bt.Sequence("Search",
        Bt.Action("Scan", () =>
        {
            target = ScanForEnemy();
            return target != null ? BtResult.Success : BtResult.Failure;
        })
    ),
    Bt.Action("Patrol", () => patrol.Step())
);

fsm.PushState(ai);

// Predicate-based (checked each frame)
state.AddTransition(target, () => someCondition);

// Action-based (fires when action is invoked)
state.AddTransition(target, ref onPlayerDied);

Bt.Sequence(name, children...)   // Succeeds if ALL children succeed
Bt.Selector(name, children...)   // Succeeds if ANY child succeeds

Bt.Inverter(name, child)         // Success ↔ Failure
Bt.Succeeder(name, child)        // Always succeeds
Bt.Failer(name, child)           // Always fails
Bt.Repeat(name, count, child)    // Repeat N times (-1 = forever)
Bt.Retry(name, attempts, child)  // Retry on failure

Bt.Action(name, () => { })                 // One-shot, succeeds immediately
Bt.Action(name, () => BtResult.Running)    // Tick until non-Running
Bt.Condition(name, () => true)             // Success if true, else failure
Bt.WaitFrames(name, frames)                // Wait N frames, then succeed

var loading = new CyclopsState
{
    Name = "Loading",
    OnEnter = async () =>
    {
        await loading.WaitForSecondsAsync(2f);   // Auto-cancelled on exit
        await loading.NextFrameAsync();
        await loading.FromAsyncOperation(SceneManager.LoadSceneAsync("Game"));
        loading.Stop();
    }
};

// Bootstrap: wire the state graph once, then drive with async
var fsm = new CyclopsStateMachine();
var stateA = new CyclopsState();
var stateB = new CyclopsState();
stateA.AddTransition(stateB, () => someCondition);
fsm.PushState(stateA);

// Drive the loop — no MonoBehaviour needed
while (!fsm.IsIdle && !Application.exitCancellationToken.IsCancellationRequested)
{
    await Awaitable.NextFrameAsync(Application.exitCancellationToken);
    fsm.Update();
}