Struct Theme 

pub struct Theme {
    pub meta: Meta,
    pub ansi: Ansi,
    pub semantic: Semantic,
    pub ui: Ui,
    pub base24: Base24Slots,
}

A complete TCA theme definition.

All color fields contain resolved #rrggbb hex strings.

Fields

meta: Meta

Theme metadata.

ansi: Ansi

ANSI 16-color definitions derived from base24 slots.

semantic: Semantic

Semantic color roles derived from base24 slots.

ui: Ui

UI element colors derived from base24 slots.

base24: Base24Slots

Raw base24 color slots for direct interoperability.

Implementations

impl Theme

pub fn from_base24_slots(slots: Base24Slots) -> Self

Construct a Theme by deriving all fields from a set of base24 slots.

pub fn from_base24_str(src: &str) -> Result<Self>

Parse a base24 YAML string and construct a Theme.

Accepts the flat key: "value" YAML subset used by Base16/24 scheme files. Theme name is read from the scheme key (with name as a fallback).

pub fn from_raw_slots(slots: &HashMap<String, String>) -> Result<Self>

Build a Theme from a parsed [RawSlots] map (e.g. from parse_base24).

pub fn from_name(name: &str) -> Theme

Creates a Theme by name, searching in order:

1. User theme files (if fs feature enabled).
2. Built-in themes.
3. Built-in default (if not found).

The name is case-insensitive and accepts any common case format ("Nord Dark", "nord-dark", "NordDark" all work).

pub fn from_default_cfg() -> Theme

Creates a Theme from the user’s configured default.

Reads $XDG_CONFIG_HOME/tca/tca.toml if the fs feature is enabled. For a guaranteed no-I/O default, use BuiltinTheme::default().theme().

Fallback order:

1. User config default_theme (if fs feature enabled).
2. Built-in default.

pub fn from_default_dark_cfg() -> Theme

Creates a dark Theme from the user’s configured dark default.

Fallback order:

1. User config default_dark_theme (if fs feature enabled).
2. Built-in default dark theme.

pub fn from_default_light_cfg() -> Theme

Creates a light Theme from the user’s configured light default.

Fallback order:

1. User config default_light_theme (if fs feature enabled and theme is light).
2. Built-in default light theme.

pub fn name_slug(&self) -> String

Returns the kebab-case slug for the theme name.

e.g. "Tokyo Night" -> "tokyo-night"

pub fn to_filename(&self) -> String

Returns the canonical file name for the theme.

e.g. "Tokyo Night" -> "tokyo-night.yaml"

pub fn to_pathbuf(&self) -> Result<PathBuf>

Returns the canonical install path for the theme in the user themes directory.

pub fn to_base24_str(&self) -> String

Serialize this theme to a base24 YAML string.

The output is a flat key: "value" YAML file compatible with the Tinted Theming base24 format. Hex values are written as 6-character lowercase strings without a leading #.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Theme

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

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Returns the user’s configured default theme, falling back to the built-in default.

Reads $XDG_CONFIG_HOME/tca/tca.toml if the fs feature is enabled. For a guaranteed no-I/O default, use BuiltinTheme::default().theme().

impl Eq for Theme

impl Ord for Theme

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Theme

Two themes are equal if they have the same name slug, regardless of color values. This means "Nord Dark", "nord-dark", and "nordDark" are all considered equal.

fn eq(&self, other: &Self) -> 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 PartialOrd for Theme

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Theme

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

where __S: Serializer,

Serialize this value into the given Serde serializer.