Struct RuntimeOptions 

pub struct RuntimeOptions {
    pub cursor_style: CursorStyle,
    pub cursor_blink: bool,
    pub scrollback_lines: u32,
    pub tab_width: u8,
    pub convert_eol: bool,
    pub screen_reader_mode: bool,
    pub bracketed_paste: bool,
    pub minimum_contrast_ratio_x100: u16,
    pub renderer: RendererType,
    pub theme: ThemePalette,
}

The complete, validated runtime option state.

Construct with RuntimeOptions::default (safe defaults) and mutate via RuntimeOptions::apply_patch. Direct field assignment is allowed for host-side initialisation but bypasses validation — prefer the patch API for any host-driven mutation.

Fields

cursor_style: CursorStyle

Cursor presentation style.

cursor_blink: bool

Whether the cursor blinks.

scrollback_lines: u32

Scrollback retention in lines (0 = no scrollback).

tab_width: u8

Tab stop width in columns (1..=16).

convert_eol: bool

Whether bare LF is treated as CRLF on output (convertEol).

screen_reader_mode: bool

Whether screen-reader assistive output mode is active.

bracketed_paste: bool

Whether bracketed paste is enabled.

minimum_contrast_ratio_x100: u16

Minimum enforced foreground/background contrast ratio, ×100 (100..=2100). 100 (1.0:1) disables enforcement.

renderer: RendererType

Active rendering backend.

theme: ThemePalette

Theme palette.

Implementations

impl RuntimeOptions

pub fn apply_patch( &mut self, patch: &RuntimeOptionPatch, caps: &OptionCapabilityProfile, correlation_id: &str, ) -> RuntimeOptionUpdate

Apply a (sparse) patch atomically against the given capability profile.

Returns a RuntimeOptionUpdate describing the outcome. On any validation or gating failure the update is rejected, every offending field’s error is reported, and self is left unchanged. On success the patch is committed atomically and the changed fields plus required renderer/engine synchronisation are reported.

correlation_id is recorded for structured-log triage only; it does not affect the decision.

pub fn validate( &self, caps: &OptionCapabilityProfile, ) -> Vec<RuntimeOptionError>

Validate this option state against a capability profile, returning every violation. An empty vector means fully valid and supported.

pub fn web_dataset(&self) -> [(&'static str, String); 3]

Stable, ordered CSS data-attribute pairs for the browser host. Mirrors the accessibility surface’s web_dataset() convention so generated DOM markup is byte-for-byte reproducible.

pub fn to_jsonl(&self, correlation_id: &str) -> String

Serialise the full option snapshot to a single deterministic JSON line.

Trait Implementations

impl Clone for RuntimeOptions

fn clone(&self) -> RuntimeOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RuntimeOptions

impl Debug for RuntimeOptions

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

Formats the value using the given formatter.

impl Default for RuntimeOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RuntimeOptions

impl PartialEq for RuntimeOptions

fn eq(&self, other: &RuntimeOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RuntimeOptions