Struct WizardState 

pub struct WizardState {
    pub steps: &'static [WizardStep],
    pub input_count: usize,
    pub current: usize,
    pub values: Vec<String>,
    pub buffer: String,
    pub cursor: usize,
    pub array_states: HashMap<usize, ArrayState>,
    pub button_selected: usize,
}

All mutable wizard state.

Fields

steps: &'static [WizardStep]

The full step tree (static, defined by the caller).

input_count: usize

How many leading DFS-leaf steps are wizard-managed. When current >= input_count, the wizard is complete.

current: usize

DFS-leaf index of the currently active step.

values: Vec<String>

Confirmed string values for non-array leaf steps. Indexed by step leaf index; may be sparse if the user cycled backward.

buffer: String

Text buffer for the currently active Leaf/Optional input step.

cursor: usize

Byte-cursor within buffer.

array_states: HashMap<usize, ArrayState>

State for each Array step, keyed by its DFS-leaf index.

button_selected: usize

Which button is highlighted when the current step is a Buttons step.

Implementations

impl WizardState

pub fn new(steps: &'static [WizardStep], input_count: usize) -> Self

Create a fresh wizard. input_count ≤ total leaf count.

pub fn completed( steps: &'static [WizardStep], input_count: usize, values: Vec<String>, start_current: usize, ) -> Self

Build a pre-completed wizard (edit mode — values already known).

pub fn preload_array(&mut self, step_idx: usize, items: Vec<Vec<String>>)

Pre-populate an Array step with existing items (edit mode).

pub fn is_complete(&self) -> bool

True when all input_count steps have been confirmed.

pub fn set_current(&mut self, leaf_idx: usize)

Set the active leaf index directly (for externally-managed steps).

pub fn array_state(&self, leaf_idx: usize) -> Option<&ArrayState>

Borrow the state of an Array step by DFS-leaf index.

pub fn array_state_mut(&mut self, leaf_idx: usize) -> Option<&mut ArrayState>

Mutably borrow the state of an Array step by DFS-leaf index.

pub fn array_selected_item(&self, leaf_idx: usize) -> Option<usize>

Return the currently highlighted item index (0-based) for an Array step, or None if no item is focused (e.g. array is collapsed).

pub fn is_array_editing(&self) -> bool

True when the current step is an Array with an active editing session.

pub fn handle_key(&mut self, key: KeyEvent) -> WizardEvent

Handle a key event. Only meaningful when !is_complete().