Struct SelectList 

pub struct SelectList {
    pub on_select: Option<Box<dyn FnMut(String)>>,
    pub on_cancel: Option<Box<dyn FnMut()>>,
    pub on_selection_change: Option<Box<dyn FnMut(&SelectItem)>>,
    /* private fields */
}

Scrollable list with optional fuzzy search and two-column layout.

Fields

on_select: Option<Box<dyn FnMut(String)>>

on_cancel: Option<Box<dyn FnMut()>>

on_selection_change: Option<Box<dyn FnMut(&SelectItem)>>

Implementations

impl SelectList

pub fn new( items: Vec<SelectItem>, max_visible: usize, theme: SelectListTheme, layout: Option<SelectListLayoutOptions>, ) -> Self

pub fn with_search(self) -> Self

Enable interactive search (fuzzy filtering as user types).

pub fn set_items(&mut self, items: Vec<SelectItem>)

Set items (re-applies search if active). Matches pi’s behavior.

pub fn set_on_select(&mut self, cb: Box<dyn FnMut(String)>)

pub fn set_on_cancel(&mut self, cb: Box<dyn FnMut()>)

pub fn items(&self) -> &[SelectItem]

pub fn selected_index(&self) -> usize

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

pub fn get_selected_item(&self) -> Option<&SelectItem>

pub fn set_filter(&mut self, filter: &str)

Filter by prefix (simpler than fuzzy for user-typed single char; pi-style).

impl SelectList

pub fn selected_item(&self) -> Option<&SelectItem>

Trait Implementations

impl Component for SelectList

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 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 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 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).