Struct Container 

pub struct Container { /* private fields */ }

Container - a component that contains other components rendered vertically. Supports per-child caching and overlay compositing.

Implementations

impl Container

pub fn new() -> Self

pub fn set_term_height(&mut self, height: usize)

Set terminal height (must be called before render for correct overlay positioning).

pub fn add_child(&mut self, component: Box<dyn Component>)

pub fn remove_child(&mut self, component: &dyn Component)

pub fn clear(&mut self)

pub fn children(&self) -> &[Box<dyn Component>]

pub fn children_mut(&mut self) -> &mut [Box<dyn Component>]

pub fn invalidate_all(&mut self)

Mark all children as needing re-render.

pub fn invalidate_child(&mut self, index: usize)

Mark a specific child as needing re-render by index.

pub fn len(&self) -> usize

Get the number of children.

pub fn pop_child(&mut self) -> Option<Box<dyn Component>>

Remove and return the last child, if any.

pub fn is_empty(&self) -> bool

Check if empty.

pub fn last_child(&self) -> Option<&dyn Component>

Peek at the last child, if any.

pub fn show_overlay( &mut self, component: Box<dyn Component>, options: OverlayOptions, ) -> u64

Show an overlay. Returns the overlay ID for later removal.

pub fn hide_overlay(&mut self, id: u64)

Hide an overlay by ID.

pub fn pop_overlay(&mut self)

Hide the topmost overlay.

pub fn has_overlays(&self) -> bool

Check if there are any visible overlays.

pub fn clear_overlays(&mut self)

Clear all overlays.

pub fn overlay_stack(&self) -> &[OverlayEntry]

Get the overlay stack (for focus management in TUI).

pub fn overlay_stack_mut(&mut self) -> &mut Vec<OverlayEntry>

Trait Implementations

impl Component for Container

fn render(&mut self, width: usize) -> Vec<String>

Render to lines for the given viewport width. Each returned string MUST NOT exceed width in visible width.

fn handle_input(&mut self, key: &KeyEvent) -> bool

Handle keyboard input. Return true if consumed.

fn invalidate(&mut self)

Mark this component as needing re-render. Called when internal state changes (output received, expanded toggled, etc.).

fn is_dirty(&self) -> bool

Check if this component needs re-render. Default: false — the Container’s per-child cache tracking determines whether to re-render. Override to return true for components whose state can change without explicit invalidation (e.g. ToolExecComponent receiving streaming output).

fn clear_dirty(&mut self)

Clear dirty flag after successful render.

fn render_padded(&mut self, width: usize) -> Vec<String>

Render and pad each line to exactly width visible columns. Default implementation calls render(width) and pads each line with trailing spaces if its visible width is less than width.

fn handle_paste(&mut self, _text: &str)

Handle a paste event (text from bracketed paste mode). Default no-op; override to process pasted content.

fn cache_key(&self, _width: usize) -> Option<RenderCacheKey>

Get the cache key for this component’s current state. Return None to disable caching (always re-render).

fn get_cached_render(&self) -> Option<&RenderCache>

Get cached render output, if available and valid.

fn set_cached_render(&mut self, _cache: RenderCache)

Store render output in cache.

fn is_focusable(&self) -> bool

Whether this component wants focus (for IME cursor positioning).

fn set_expanded(&mut self, _expanded: bool)

Toggle expanded/collapsed state. No-op by default. Override for components that support expand/collapse (tool results, messages, etc.).

fn set_hide_thinking(&mut self, _hide: bool)

Toggle thinking block visibility. No-op by default. Override for components that display thinking content (AssistantMessageComponent).

impl Default for Container

fn default() -> Self

Returns the “default value” for a type.