Struct Theme 

pub struct Theme {

    pub primary: AdaptiveColor,
    pub secondary: AdaptiveColor,
    pub accent: AdaptiveColor,
    pub background: AdaptiveColor,
    pub surface: AdaptiveColor,
    pub overlay: AdaptiveColor,
    pub text: AdaptiveColor,
    pub text_muted: AdaptiveColor,
    pub text_subtle: AdaptiveColor,
    pub success: AdaptiveColor,
    pub warning: AdaptiveColor,
    pub error: AdaptiveColor,
    pub info: AdaptiveColor,
    pub border: AdaptiveColor,
    pub border_focused: AdaptiveColor,
    pub selection_bg: AdaptiveColor,
    pub selection_fg: AdaptiveColor,
    pub scrollbar_track: AdaptiveColor,
    pub scrollbar_thumb: AdaptiveColor,
}

A theme with semantic color slots.

Themes provide consistent styling across an application by mapping semantic names (like “error” or “primary”) to actual colors.

Fields

primary: AdaptiveColor

Primary accent color (e.g., buttons, highlights).

secondary: AdaptiveColor

Secondary accent color.

accent: AdaptiveColor

Tertiary accent color.

background: AdaptiveColor

Main background color.

surface: AdaptiveColor

Surface color (cards, panels).

overlay: AdaptiveColor

Overlay color (dialogs, dropdowns).

text: AdaptiveColor

Primary text color.

text_muted: AdaptiveColor

Muted text color.

text_subtle: AdaptiveColor

Subtle text color (hints, placeholders).

success: AdaptiveColor

Success color (green).

warning: AdaptiveColor

Warning color (yellow/orange).

error: AdaptiveColor

Error color (red).

info: AdaptiveColor

Info color (blue).

border: AdaptiveColor

Default border color.

border_focused: AdaptiveColor

Focused element border.

selection_bg: AdaptiveColor

Selection background.

selection_fg: AdaptiveColor

Selection foreground.

scrollbar_track: AdaptiveColor

Scrollbar track color.

scrollbar_thumb: AdaptiveColor

Scrollbar thumb color.

Implementations

impl Theme

pub fn builder() -> ThemeBuilder

Create a new theme builder.

pub fn detect_dark_mode() -> bool

Detect whether dark mode should be used.

Detection heuristics:

1. Check COLORFGBG environment variable
2. Default to dark mode (most terminals are dark)

Note: OSC 11 background query would be more accurate but requires terminal interaction which isn’t always safe or fast.

pub fn resolve(&self, is_dark: bool) -> ResolvedTheme

Create a resolved copy of this theme for a specific mode.

This flattens all adaptive colors to fixed colors based on the mode.

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 “default value” for a type.

impl PartialEq for Theme

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

impl StructuralPartialEq for Theme