Struct PickerState 

pub struct PickerState { /* private fields */ }

The internal state of the picker widget.

All sections are flattened into a single entries vec of headers and items. Navigation moves the cursor between nav stops — visible items plus the headers of collapsed sections — so a collapsed section can still be focused and re-expanded. When nothing is collapsed, the nav stops are exactly the items, matching a plain multi-select list.

Implementations

impl PickerState

pub fn new(sections: Vec<Section>) -> Self

Create a new picker state from the given sections.

pub fn is_empty(&self) -> bool

True if there are no focusable entries.

pub fn move_up(&mut self)

Move the cursor up to the previous nav stop.

pub fn move_down(&mut self)

Move the cursor down to the next nav stop.

pub fn toggle(&mut self)

Toggle the checked state of the item under the cursor.

In a radio section, checking an item first unchecks every other item in the section; toggling an already-checked item unchecks it when it’s the only selection (so empty is reachable), but keeps it checked when multiple items were selected (resolving a pre-existing conflict by confirming the toggled choice). A no-op when the cursor is on a header.

pub fn toggle_current_section(&mut self)

Toggle all items in the section that contains the cursor.

In a checkbox section: if any item is unchecked, checks all; otherwise unchecks all. In a radio section this is a no-op — a radio section can never have every item selected.

pub fn clear_current_section(&mut self)

Uncheck every item in the section that contains the cursor.

Bound to Backspace in radio sections to clear the current pick.

pub fn backspace(&mut self)

Backspace handler: clears the current section only when it is radio.

pub fn current_coordinates(&self) -> (usize, usize)

The (section_idx, item_idx) for the current cursor position.

When the cursor rests on a collapsed header, the item index is 0.

pub fn has_any_checked(&self) -> bool

True if at least one item is checked across all sections.

pub fn collapse_current(&mut self)

Collapse the section that contains the cursor and focus its header, so the section can be re-expanded from that position.

pub fn expand_current(&mut self)

Expand the section that contains the cursor and focus its first item (if any), restoring normal traversal through the section.

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

The title of the first radio section with more than one item checked, if any. Used to show a warning banner for a pre-existing conflicting state.

pub fn try_confirm(&mut self) -> Result<Vec<Vec<bool>>, String>

Validate radio constraints and, if satisfied, extract the results.

Returns Err naming the offending section when a radio section has more than one item checked.

pub fn into_results(&mut self) -> Vec<Vec<bool>>

Extract checked state grouped by section (matching original input order).

Collapsed sections are included — collapse only hides items from the UI, never from the results.

pub fn cursor(&self) -> usize

Current cursor index (for testing).

pub fn scroll_offset(&self) -> usize

Current scroll offset (for testing).

pub fn set_visible_height(&mut self, h: usize)

Set the visible height (normally set during render; exposed for testing).