Struct ScenarioStateMachine 

pub struct ScenarioStateMachine<S: Copy + PartialEq> { /* private fields */ }

A generic multi-stage scenario progression.

Implementations

impl<S: Copy + PartialEq> ScenarioStateMachine<S>

pub fn new( stages: Vec<StageConfig<S>>, terminal_stages: Vec<S>, initial: S, started_at: i64, ) -> Self

pub fn status(&self) -> ScenarioStatus

pub fn current_stage(&self) -> S

pub fn history(&self) -> &[(S, i64)]

Every stage entered so far, oldest first, with the timestamp it was entered.

pub fn bars_in_stage(&self) -> u32

pub fn tick(&mut self)

Advances one bar without a stage change; expires the scenario if the current stage’s max_bars is exceeded. No-op once the machine is no longer Active.

pub fn advance(&mut self, next_stage: S, timestamp: i64) -> bool

Transitions to next_stage, resetting the per-stage bar counter. Returns false (no-op) if the machine is not currently Active. Marks the machine Completed if next_stage is one of the configured terminal stages.

pub fn invalidate(&mut self)

Explicitly invalidates the scenario (e.g. a structural break of its setup premise). No-op once no longer Active.