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 section: Option<String>,
    pub is_section_start: bool,
    pub layout_width: u16,
}

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

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)

layout_width: u16

Layout width for description wrapping (set during render)

Implementations

impl SettingItem

pub fn item_height(&self) -> u16

Calculate the total height needed for this item (control + description + spacing + section header if applicable) Uses layout_width for description wrapping when available.

pub fn description_height(&self, width: u16) -> u16

Calculate description height wrapped to the given width. If width is 0 (not yet set), falls back to 1 line.

pub fn content_height(&self) -> u16

Calculate the content height (control + description, excluding spacing) Uses layout_width for description wrapping when available.

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) -> u16

Total height of this item in terminal rows

fn focus_regions(&self) -> Vec<FocusRegion>

Optional: sub-focus regions within this item Used for items with internal navigation (e.g., TextList rows)