Struct Tui 

pub struct Tui { /* private fields */ }

Main TUI handle that integrates with the event bus.

Implementations

impl Tui

pub fn new() -> Self

Creates a new TUI instance with shared state.

pub fn with_hat_map(self, hat_map: HashMap<String, (HatId, String)>) -> Self

Sets the hat map for dynamic topic-to-hat resolution.

This allows the TUI to display the correct hat for custom topics without hardcoding them in TuiState::update().

pub fn with_termination_signal(self, terminated_rx: Receiver<bool>) -> Self

Sets the termination signal receiver for graceful shutdown.

The TUI will exit when this receiver signals true.

pub fn with_interrupt_tx(self, interrupt_tx: Sender<bool>) -> Self

Sets the interrupt channel for Ctrl+C signaling.

In raw terminal mode, SIGINT is not generated by the OS when the user presses Ctrl+C. The TUI detects Ctrl+C via crossterm events and uses this channel to signal the main orchestration loop to terminate.

pub fn state(&self) -> Arc<Mutex<TuiState>>

Returns the shared state for external updates.

pub fn observer(&self) -> impl Fn(&Event) + Send + 'static

Returns an observer closure that updates TUI state from events.

pub async fn run(self) -> Result<()>

Runs the TUI application loop.

Panics

Panics if with_termination_signal() was not called before running.

Errors

Returns an error if the terminal cannot be initialized or if the application loop encounters an unrecoverable error.

Trait Implementations

impl Default for Tui

fn default() -> Self

Returns the “default value” for a type.