Struct SettingItem 

pub struct SettingItem {

    pub path: String,
    pub name: String,
    pub description: Option<String>,
    pub control: SettingControl,
    pub default: Option<Value>,
    pub modified: bool,
    pub layer_source: ConfigLayer,
    pub read_only: bool,
    pub is_auto_managed: bool,
    pub nullable: bool,
    pub is_null: bool,
    pub section: Option<String>,
    pub is_section_start: bool,
    pub style: ItemBoxStyle,
    pub dual_list_sibling: Option<String>,
}

A renderable setting item

Fields

path: String

JSON pointer path

name: String

Display name

description: Option<String>

Description

control: SettingControl

The control for this setting

default: Option<Value>

Default value (for reset)

modified: bool

Whether this setting is defined in the current target layer. This is the new semantic: modified means “explicitly set in target layer”, not “differs from schema default”.

layer_source: ConfigLayer

Which layer this setting’s current value comes from. System means it’s using the schema default.

read_only: bool

Whether this field is read-only (cannot be edited)

is_auto_managed: bool

Whether this is an auto-managed map (no_add) that should never show as modified

nullable: bool

Whether this setting accepts null (can be “unset” to inherit)

is_null: bool

Whether this setting’s current value is null (inherited/unset)

section: Option<String>

Section/group within the category (from x-section)

is_section_start: bool

Whether this item is the first in its section (for rendering section headers)

style: ItemBoxStyle

Visual style (card border thickness, padding, etc.) for this item. Cached on the item so the ScrollItem::height(width) trait impl can compute the correct height without taking a style parameter; flipped in bulk by SettingsState::set_item_style when the user toggles UI mode.

dual_list_sibling: Option<String>

Path to sibling dual-list setting (for cross-exclusion refresh)

Implementations

impl SettingItem

pub fn layout_box(&self, width: u16, style: &ItemBoxStyle) -> ItemBox

Compute the visual layout of this item for a given outer width and style. width is the full width allocated to the item (including the card borders and the focus-indicator columns).

pub fn description_rows_for(&self, inner_width: u16) -> u16

Rows needed for the description when wrapped to inner_width columns.

The wrapping here is a byte-based approximation that overestimates slightly compared to the word-wrap used at render time; that’s fine — the renderer clips to the available rows, never to fewer than the number of wrapped lines it produces.

Trait Implementations

impl Clone for SettingItem

fn clone(&self) -> SettingItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettingItem

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

Formats the value using the given formatter.

impl ScrollItem for SettingItem

fn height(&self, width: u16) -> u16

Total height of this item in terminal rows when laid out at width columns.

fn focus_regions(&self, width: u16) -> Vec<FocusRegion>

Optional: sub-focus regions within this item. Used for items with internal navigation (e.g., TextList rows). Y offsets are absolute within the item (i.e. row 0 is the top of the area allocated to the item, including any chrome above the content).