Struct ThemeFile 

pub struct ThemeFile {
    pub name: String,
    pub extends: Option<String>,
    pub editor: EditorColors,
    pub ui: UiColors,
    pub search: SearchColors,
    pub diagnostic: DiagnosticColors,
    pub syntax: SyntaxColors,
}

Serializable theme definition (matches JSON structure)

The five color sections (editor, ui, search, diagnostic, syntax) are all optional. Every leaf field within each section already has a #[serde(default = "…")] fallback, so a theme JSON only needs to specify the colors it cares about. This matches the minimal example shipped in docs/features/themes.md and unblocks user-authored themes that override just editor/syntax (issue #1281).

Inheritance: when a theme omits whole sections, the unset fields are resolved against a base theme rather than against the per-field hardcoded fallback. The base is chosen in this order:

1. Explicit extends field ("builtin://light", "dark", etc.).
2. If editor.bg is provided, the relative-luminance of that color picks builtin://light or builtin://dark automatically — so a user theme that sets a cream background gets light UI chrome without any extra configuration.
3. Otherwise, fall through to the per-field hardcoded defaults.

Only built-in themes are valid extends targets in this version. Chained inheritance across user themes is intentionally out of scope here.

Fields

name: String

Theme name

extends: Option<String>

Optional base theme to inherit from. Accepts "builtin://NAME" or a bare built-in name (e.g. "dark", "light", "high-contrast"). When set, every field this theme does not specify is taken from the base; explicit fields override the base. See ThemeFile for the full inheritance resolution order.

editor: EditorColors

Editor area colors

ui: UiColors

UI element colors (tabs, menus, status bar, etc.)

search: SearchColors

Search result highlighting colors

diagnostic: DiagnosticColors

LSP diagnostic colors (errors, warnings, etc.)

syntax: SyntaxColors

Syntax highlighting colors

Trait Implementations

impl Clone for ThemeFile

fn clone(&self) -> ThemeFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ThemeFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Theme> for ThemeFile

fn from(theme: Theme) -> Self

Converts to this type from the input type.

impl From<ThemeFile> for Theme

fn from(file: ThemeFile) -> Self

Converts to this type from the input type.

impl JsonSchema for ThemeFile

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ThemeFile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.