Struct ThemeVariant 

pub struct ThemeVariant {

    pub defaults: ThemeDefaults,
    pub text_scale: TextScale,
    pub window: WindowTheme,
    pub button: ButtonTheme,
    pub input: InputTheme,
    pub checkbox: CheckboxTheme,
    pub menu: MenuTheme,
    pub tooltip: TooltipTheme,
    pub scrollbar: ScrollbarTheme,
    pub slider: SliderTheme,
    pub progress_bar: ProgressBarTheme,
    pub tab: TabTheme,
    pub sidebar: SidebarTheme,
    pub toolbar: ToolbarTheme,
    pub status_bar: StatusBarTheme,
    pub list: ListTheme,
    pub popover: PopoverTheme,
    pub splitter: SplitterTheme,
    pub separator: SeparatorTheme,
    pub switch: SwitchTheme,
    pub dialog: DialogTheme,
    pub spinner: SpinnerTheme,
    pub combo_box: ComboBoxTheme,
    pub segmented_control: SegmentedControlTheme,
    pub card: CardTheme,
    pub expander: ExpanderTheme,
    pub link: LinkTheme,
    pub icon_set: Option<String>,
    pub icon_theme: Option<String>,
}

A single light or dark theme variant containing all visual properties.

Composes defaults, per-widget structs, and optional text scale into one coherent set. Empty sub-structs are omitted from serialization to keep TOML files clean.

Examples

use native_theme::{ThemeVariant, Rgba};

let mut variant = ThemeVariant::default();
variant.defaults.accent = Some(Rgba::rgb(0, 120, 215));
variant.defaults.font.family = Some("Inter".into());
assert!(!variant.is_empty());

Fields

defaults: ThemeDefaults

Global defaults inherited by all widgets.

text_scale: TextScale

Per-role text scale overrides.

window: WindowTheme

Window chrome: background, title bar, radius, shadow.

button: ButtonTheme

Push button: colors, sizing, spacing, geometry.

input: InputTheme

Single-line and multi-line text input fields.

checkbox: CheckboxTheme

Checkbox and radio button indicator geometry.

menu: MenuTheme

Popup and context menu appearance.

tooltip: TooltipTheme

Tooltip popup appearance.

scrollbar: ScrollbarTheme

Scrollbar colors and geometry.

slider: SliderTheme

Slider control colors and geometry.

progress_bar: ProgressBarTheme

Progress bar colors and geometry.

tab: TabTheme

Tab bar colors and sizing.

sidebar: SidebarTheme

Sidebar panel background and foreground colors.

toolbar: ToolbarTheme

Toolbar sizing, spacing, and font.

status_bar: StatusBarTheme

Status bar font.

list: ListTheme

List and table colors and row geometry.

popover: PopoverTheme

Popover / dropdown panel appearance.

splitter: SplitterTheme

Splitter handle width.

separator: SeparatorTheme

Separator line color.

switch: SwitchTheme

Toggle switch track, thumb, and geometry.

dialog: DialogTheme

Dialog sizing, spacing, button order, and title font.

spinner: SpinnerTheme

Spinner / indeterminate progress indicator.

combo_box: ComboBoxTheme

ComboBox / dropdown trigger sizing.

segmented_control: SegmentedControlTheme

Segmented control sizing.

card: CardTheme

Card / container colors and geometry.

expander: ExpanderTheme

Expander / disclosure row geometry.

link: LinkTheme

Hyperlink colors and underline setting.

icon_set: Option<String>

Icon set / naming convention for this variant (e.g., “sf-symbols”, “freedesktop”). When None, resolved at runtime via system_icon_set().

icon_theme: Option<String>

Icon theme name for this variant (e.g., “breeze”, “Adwaita”, “material”). This is the visual icon theme, distinct from the naming convention in icon_set. When None, resolved at runtime via system_icon_theme().

Implementations

impl ThemeVariant

pub fn merge(&mut self, overlay: &ThemeVariant)

Merge an overlay into this value. Some fields in the overlay replace the corresponding fields in self; None fields are left unchanged. Nested structs are merged recursively.

pub fn is_empty(&self) -> bool

Returns true if all fields are at their default (None/empty) state.

impl ThemeVariant

pub fn resolve(&mut self)

Apply all ~90 inheritance rules in 4-phase order.

After calling resolve(), most Option fields that were None will be filled from defaults or related widget fields. Calling resolve() twice produces the same result (idempotent).

Phases

1. Defaults internal chains – accent derives selection, focus_ring_color; selection derives selection_inactive.
2. Safety nets – platform-divergent fields get a reasonable fallback.
3. Widget-from-defaults – colors, geometry, fonts, text scale entries all inherit from defaults.
4. Widget-to-widget – inactive title bar fields fall back to active.

pub fn into_resolved(self) -> Result<ResolvedThemeVariant, Error>

Resolve all inheritance rules and validate in one step.

This is the recommended way to convert a ThemeVariant into a ResolvedThemeVariant. It calls resolve() followed by validate(), ensuring no fields are left unresolved.

Errors

Returns crate::Error::Resolution if any fields remain None after resolution (e.g., when accent color is missing and cannot be derived).

Examples

use native_theme::ThemeSpec;

let theme = ThemeSpec::preset("dracula").unwrap();
let variant = theme.dark.unwrap();
let resolved = variant.into_resolved().unwrap();
// All fields are now guaranteed populated
let accent = resolved.defaults.accent;

pub fn validate(&self) -> Result<ResolvedThemeVariant, Error>

Convert this ThemeVariant into a ResolvedThemeVariant with all fields guaranteed.

Should be called after resolve(). Walks every field and collects missing (None) field paths. Returns Ok(ResolvedThemeVariant) if all fields are populated, or Err(Error::Resolution(...)) listing every missing field.

Errors

Returns crate::Error::Resolution containing a ThemeResolutionError with all missing field paths if any fields remain None.

Trait Implementations

impl Clone for ThemeVariant

fn clone(&self) -> ThemeVariant

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeVariant

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

Formats the value using the given formatter.

impl Default for ThemeVariant

fn default() -> ThemeVariant

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ThemeVariant

where ThemeVariant: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<ThemeVariant, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ThemeVariant

fn eq(&self, other: &ThemeVariant) -> 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 Serialize for ThemeVariant

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ThemeVariant