Struct MapState 

pub struct MapState {
    pub entries: Vec<(String, Value)>,
    pub focused_entry: Option<usize>,
    pub new_key_text: String,
    pub cursor: usize,
    pub label: String,
    pub focus: FocusState,
    pub expanded: Vec<usize>,
    pub value_schema: Option<Box<SettingSchema>>,
    pub display_field: Option<String>,
    pub no_add: bool,
}

State for a map/dictionary control

Fields

entries: Vec<(String, Value)>

Map entries as (key, value) pairs where value is JSON

focused_entry: Option<usize>

Currently focused entry index (None = add-new field)

new_key_text: String

Text in the “add new” key field

cursor: usize

Cursor position in the new key field

label: String

Label for this map

focus: FocusState

Focus state

expanded: Vec<usize>

Expanded entry indices (for viewing/editing nested values)

value_schema: Option<Box<SettingSchema>>

Schema for value type (for creating new entries)

display_field: Option<String>

JSON pointer to field within value to display as preview (e.g., “/command”)

no_add: bool

Whether to disallow adding new entries (entries are auto-managed)

Implementations

impl MapState

pub fn handle_mouse( &mut self, event: MouseEvent, layout: &MapLayout, ) -> Option<MapEvent>

Handle a mouse event for this map control

Arguments

• event - The mouse event to handle
• layout - The control’s rendered layout for hit testing

Returns

• Some(MapEvent) if the event was consumed
• None if the event was not relevant

pub fn handle_key(&mut self, key: KeyEvent) -> Option<MapEvent>

Handle a keyboard event for this map control

Returns

• Some(MapEvent) if the event was consumed
• None if the event was not relevant

impl MapState

pub fn new(label: impl Into<String>) -> Self

Create a new map state

pub fn with_display_field(self, field: String) -> Self

Set the display field (JSON pointer to field within value to show as preview)

pub fn with_no_add(self, no_add: bool) -> Self

Set whether adding new entries is disallowed

pub fn get_display_value(&self, value: &Value) -> String

Get the display value for an entry (either from display_field or fallback to field count)

pub fn with_entries(self, value: &Value) -> Self

Set the entries from JSON value

pub fn with_value_schema(self, schema: SettingSchema) -> Self

Set the value schema for creating new entries

pub fn with_focus(self, focus: FocusState) -> Self

Set the focus state

pub fn is_enabled(&self) -> bool

Check if the control is enabled

pub fn add_entry(&mut self, key: String, value: Value)

Add a new entry with the given key and default value

pub fn add_entry_from_input(&mut self)

Add entry from the new_key_text field with default value

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

Remove an entry by index

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

Focus on an entry

pub fn focus_new_entry(&mut self)

Focus on the new entry field

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

Toggle expansion of an entry

pub fn is_expanded(&self, index: usize) -> bool

Check if an entry is expanded

pub fn insert(&mut self, c: char)

Insert a character in the new key field

pub fn backspace(&mut self)

Backspace in the new key field

pub fn move_left(&mut self)

Move cursor left

pub fn move_right(&mut self)

Move cursor right

pub fn focus_prev(&mut self) -> bool

Move focus to previous entry. Returns true if handled, false if should move to prev item.

pub fn focus_next(&mut self) -> bool

Move focus to next entry. Returns true if handled, false if should move to next item.

pub fn init_focus(&mut self, from_above: bool)

Initialize focus when entering the control. from_above: true = start at first entry, false = start at add-new field (or last entry if no_add)

pub fn len(&self) -> usize

Get the number of entries

pub fn is_empty(&self) -> bool

Check if the map is empty

pub fn to_value(&self) -> Value

Convert entries to JSON value

Trait Implementations

impl Clone for MapState

fn clone(&self) -> MapState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MapState

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

Formats the value using the given formatter.