Struct WasmRunner 

pub struct WasmRunner<M: Model> { /* private fields */ }

Step-based program runner for WASM (no threads, no blocking).

Accepts an ftui Model and drives it through explicit step / render calls controlled by the JavaScript host.

Implementations

impl<M: Model> WasmRunner<M>

pub fn new(model: M, width: u16, height: u16) -> Self

Create a new runner with the given model and initial grid size.

The model is not initialized until init is called.

pub fn init(&mut self) -> StepResult

Initialize the model by calling Model::init().

Must be called exactly once before step / render. Returns the result of executing the init command.

pub fn push_event(&mut self, event: Event)

Buffer a single event for processing on the next step.

pub fn push_events(&mut self, events: impl IntoIterator<Item = Event>)

Buffer multiple events for processing on the next step.

pub fn step(&mut self, now: Duration) -> StepResult

Process all buffered events and fire a tick if due.

now is the monotonic timestamp from the host clock (e.g. performance.now() converted to Duration).

Returns a StepResult summarizing what happened.

pub fn step_event(&mut self, event: Event) -> StepResult

Process a single event immediately (without buffering).

pub fn render(&mut self) -> Option<RenderedFrame<'_>>

Render the current frame if dirty.

Returns Some(RenderedFrame) with the buffer and optional diff, or None if the view is clean (no events since last render).

pub fn force_render(&mut self) -> RenderedFrame<'_>

Render the current frame unconditionally.

pub fn resize(&mut self, width: u16, height: u16)

Resize the grid. Marks the view dirty and invalidates the diff baseline.

pub fn is_running(&self) -> bool

Whether the program is still running (no Cmd::Quit received).

pub fn is_dirty(&self) -> bool

Whether the view needs rendering.

pub fn is_initialized(&self) -> bool

Whether init() has been called.

pub fn size(&self) -> (u16, u16)

Current grid dimensions.

pub fn frame_idx(&self) -> u64

Sequential frame index (incremented on each render).

pub fn tick_rate(&self) -> Option<Duration>

Current tick rate, if set by the model.

pub fn pending_events(&self) -> usize

Number of buffered events awaiting processing.

pub fn model(&self) -> &M

Reference to the model.

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

Mutable reference to the model.

pub fn drain_logs(&mut self) -> Vec<String>

Drain and return accumulated log messages.

pub fn logs(&self) -> &[String]

Reference to accumulated log messages.

pub fn current_buffer(&self) -> &Buffer

Reference to the most recently rendered buffer.