Struct SurfaceSettings 

pub struct SurfaceSettings {

    pub locale: String,
    pub strings: IndexMap<String, String>,
    pub mode: ModeSetting,
    pub system_dark: bool,
    pub density: Density,
    pub contrast: ContrastSetting,
    pub system_high_contrast: bool,
    pub font_scale: f32,
    pub hover: bool,
    pub reduced_motion: bool,
    pub insets: Insets,
    pub today: Option<String>,
    pub hover_close_ms: u32,
    pub read_only: bool,
    pub form_factor: Option<FormFactor>,
}

What a host sets per surface (docs/round-1-contract.md §4–6).

Fields

locale: String

BCP 47; the week start and the text direction. Default en-US.

strings: IndexMap<String, String>

Built-in string overrides by id.

mode: ModeSetting

system_dark: bool

The platform prefers dark (mode: system).

density: Density

contrast: ContrastSetting

system_high_contrast: bool

The platform asks for more contrast (contrast: system).

font_scale: f32

Dynamic Type / font scale, applied to every resolved type size.

hover: bool

A hover-capable pointer (@media (hover: hover), hover popovers).

reduced_motion: bool

@media (prefers-reduced-motion: reduce); transitions become 0 ms.

insets: Insets

today: Option<String>

Today as yyyy-mm-dd (calendars open on it and mark it).

hover_close_ms: u32

How a hover overlay (Tooltip, openOn: hover Popover) closes when the pointer left its trigger and its content. 0 (default) = at once: the HOST delays forwarding the trigger’s un-hover (gpui’s grace). > 0 (natives: HOVER_CLOSE_MS) = the core holds it open and raises OutEvent::HoverTimer; the host calls Surface::hover_timeout when it fires.

read_only: bool

VAPP-200: the viewer may read, not write (an app at app access read): every writing control builds as disabled: true (crate::read_only, fixtures/read-only.json).

form_factor: Option<FormFactor>

VAPP-218: the HOST’s form factor, what @media (form-factor: …) matches (an editor preview’s phone frame, a phone). None (default) = derived from the surface width against the theme’s $breakpoint.md.

Trait Implementations

impl Clone for SurfaceSettings

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SurfaceSettings

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

Formats the value using the given formatter.

impl Default for SurfaceSettings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SurfaceSettings

where SurfaceSettings: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SurfaceSettings

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SurfaceSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SurfaceSettings