Struct Filter 

pub struct Filter { /* private fields */ }

The state behind a searchable list: the items, the ranked view of them, and which row of that view is active. Shared by every picker — the palette, the combobox — so the mapping below is written and tested once.

Implementations

impl Filter

pub fn new(items: Vec<SharedString>) -> Self

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

pub fn filtered(&self) -> &[usize]

The ranked view: indices into Self::items, in display order.

pub fn active(&self) -> Option<usize>

The highlighted row’s position in the FILTERED view — what a renderer compares each row against.

pub fn refilter(&mut self, query: &str)

Re-rank against query, re-entering the list at the top: after narrowing, the best match should be one Enter away.

pub fn step(&mut self, delta: isize)

pub fn set_active(&mut self, position: usize)

Put the cursor on a position in the FILTERED view — what the mouse calls as it crosses a row, so a menu never shows a mouse cursor and a keyboard cursor at once.

pub fn active_item(&self) -> Option<usize>

The item confirming right now would pick — an index into Self::items, never into the filtered view. Confusing the two is the defining bug of a filtered list: it only appears once a query narrows the rows, and then every selection picks the wrong thing.