Struct Program 

pub struct Program<M: Model, E: BackendEventSource<Error = Error>, W: Write + Send = Stdout> { /* private fields */ }

The program runtime that manages the update/view loop.

Implementations

impl<M: Model, E: BackendEventSource<Error = Error>, W: Write + Send> Program<M, E, W>

pub fn with_event_source( model: M, events: E, backend_features: BackendFeatures, writer: TerminalWriter<W>, config: ProgramConfig, ) -> Result<Self>

where M::Message: Send + 'static,

Create a program with an externally-constructed event source and writer.

This is the generic entry point for alternative backends (native tty, WASM, headless testing). The caller is responsible for terminal lifecycle (raw mode, cleanup) — the event source should handle that via its Drop impl or an external RAII guard.

impl<M: Model, E: BackendEventSource<Error = Error>, W: Write + Send> Program<M, E, W>

pub fn run(&mut self) -> Result<()>

Run the main event loop.

This is the main entry point. It handles:

1. Initialization (terminal setup, raw mode)
2. Event polling and message dispatch
3. Frame rendering
4. Shutdown (terminal cleanup)

pub fn last_widget_signals(&self) -> &[WidgetSignal]

Access widget scheduling signals captured on the last render.

pub fn model(&self) -> &M

Get a reference to the model.

pub fn model_mut(&mut self) -> &mut M

Get a mutable reference to the model.

pub fn is_running(&self) -> bool

Check if the program is running.

pub fn quit(&mut self)

Request a quit.

pub fn state_registry(&self) -> Option<&Arc<StateRegistry>>

Get a reference to the state registry, if configured.

pub fn has_persistence(&self) -> bool

Check if state persistence is enabled.

pub fn trigger_save(&mut self) -> StorageResult<bool>

Trigger a manual save of widget state.

Returns the result of the flush operation, or Ok(false) if persistence is not configured.

pub fn trigger_load(&mut self) -> StorageResult<usize>

Trigger a manual load of widget state.

Returns the number of entries loaded, or Ok(0) if persistence is not configured.

pub fn request_redraw(&mut self)

Mark the UI as needing redraw.

pub fn request_ui_height_remeasure(&mut self)

Request a re-measure of inline auto UI height on next render.

pub fn start_recording(&mut self, name: impl Into<String>)

Start recording events into a macro.

If already recording, the current recording is discarded and a new one starts. The current terminal size is captured as metadata.

pub fn stop_recording(&mut self) -> Option<InputMacro>

Stop recording and return the recorded macro, if any.

Returns None if not currently recording.

pub fn is_recording(&self) -> bool

Check if event recording is active.