Struct Picker 

pub struct Picker { /* private fields */ }

An open picker: the fleet’s narrowing machine plus escriba’s source.

Implementations

impl Picker

pub fn open(source: Source, items: Vec<PickerItem<Choice>>) -> Self

Open a picker over items.

pub const fn source(&self) -> Source

pub fn refresh_items(&mut self, items: Vec<PickerItem<Choice>>) -> bool

Replace the rows from a live producer, if it is safe to do so.

A scan posts results in batches while the operator is already looking at the picker, so the row set grows under them. FuzzyPicker::set_items preserves the query and the open state but resets the highlight to the top — so re-listing under someone who has scrolled down would move their selection on every batch, which is worse than showing them fewer rows.

The rule: refresh only while the highlight is still where it started. Once the operator navigates, they have chosen a row set to work with and keep it. Returns whether the refresh was taken, so a caller can tell the difference between “updated” and “deliberately left alone”.

pub fn is_at_top(&self) -> bool

Is the highlight still on the first visible row — i.e. has the operator not navigated yet?

An empty picker counts as “at the top”: there is nothing to have moved away from, and the first batch must be able to land.

pub fn query(&self) -> &str

pub fn visible_count(&self) -> usize

pub fn rows(&self) -> Vec<(String, bool)>

The rows to paint, as (label, selected).

Borrowed from the machine rather than copied, so a face cannot paint a stale view.

pub fn on_key(&mut self, key: &Key) -> Consumed

Feed a key. None for a key the picker has no meaning for — which is HELD rather than passed through, because a picker that let unknown keys reach the buffer would edit the file behind the overlay.

Trait Implementations

impl Debug for Picker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.