Struct EventHandler 

pub struct EventHandler { /* private fields */ }

Owns the app channel and the input source. Exposes a single next() await point for the loop.

Implementations

impl EventHandler

pub fn new(ctrl_h: CtrlHPolicy) -> Self

The app’s handler: crossterm reads the terminal. ctrl_h is the session’s resolved Ctrl-H rule, applied as events are decoded — no Default, because guessing that rule is exactly what this type must not do.

pub fn from_input(input: impl Stream<Item = AppEvent> + Send + 'static) -> Self

A handler over any input source — a futures::stream::iter of scripted events in tests, a replayed recording, anything that yields AppEvent. The stream is fused here, so an adapter need not be.

pub fn app_sender(&self) -> AppTx

Returns a cloned sender. Pass this to screens and components as &AppTx.

pub fn try_next(&mut self) -> Option<AppEvent>

Non-blocking peek of the app channel only. Input is never polled here: the loop coalesces queued app messages between blocking awaits, and a real input event must always get its own next() and its own draw.

Disconnected is structurally unreachable: self.tx is owned by this handler and live across the &mut self borrow, so at least one sender always exists while try_next runs.

pub async fn next(&mut self) -> AppEvent

Wait for the next event. App messages first (biased), then input. An exhausted input source yields Quit, every time it is asked.