Struct AppShell 

pub struct AppShell {
    pub config: ShellConfig,
    pub registry: ScreenRegistry,
    pub active_screen: Option<ScreenId>,
    pub keymap: Keymap,
    pub overlays: OverlayManager,
    pub palette: CommandPalette,
    pub status_line: StatusLine,
    pub should_quit: bool,
    /* private fields */
}

The main app shell that manages screens, chrome, and input dispatch.

Fields

config: ShellConfig

Shell configuration.

registry: ScreenRegistry

Screen registry.

active_screen: Option<ScreenId>

Currently active screen ID.

keymap: Keymap

Keymap for input resolution.

overlays: OverlayManager

Overlay manager.

palette: CommandPalette

Command palette.

status_line: StatusLine

Status line content.

should_quit: bool

Whether the app should quit.

Implementations

impl AppShell

pub fn new(config: ShellConfig) -> Self

Create a new app shell with the given config.

pub fn navigate_to(&mut self, id: &ScreenId)

Navigate to a screen by ID.

pub fn next_screen(&mut self)

Navigate to the next screen in tab order.

pub fn prev_screen(&mut self)

Navigate to the previous screen in tab order.

pub fn screen_context(&self, area: Rect) -> ScreenContext

Build the screen context for the current state.

pub fn handle_input(&mut self, event: &InputEvent) -> bool

Handle an input event. Returns true if the app should quit.

Returns the confirmed palette action ID if the user selected a command. Callers should check last_palette_action() after calling this.

pub fn last_palette_action(&self) -> Option<&str>

Get the last palette action confirmed by the user.

Returns Some(action_id) if the user selected an action from the command palette during the last handle_input() call.

pub fn render(&mut self, frame: &mut Frame<'_>)

Render the shell chrome and active screen.

Uses cached layout and tab state to avoid redundant allocations when the terminal dimensions and screen configuration haven’t changed.