Struct CassTheme 

pub struct CassTheme {
    pub preset: ThemePreset,
    pub is_dark: bool,
    pub theme: Theme,
    pub styles: StyleSheet,
    pub profile: ColorProfile,
    pub color_cache: ColorCache,
    pub flags: ThemeFlags,
}

Central theme object consumed by every ftui widget in cass.

Wraps an ftui Theme, a StyleSheet with named styles, the detected ColorProfile, and runtime ThemeFlags. All rendering code should query styles through this struct rather than hard-coding colors.

Fields

preset: ThemePreset

Current preset (for cycling).

is_dark: bool

Whether dark mode is active.

theme: Theme

ftui Theme with semantic color slots.

styles: StyleSheet

Named style registry - the single source of truth for widget styles.

profile: ColorProfile

Detected terminal color capability.

color_cache: ColorCache

Color downgrade cache (speeds up repeated color conversions).

flags: ThemeFlags

Runtime feature flags from environment.

Implementations

impl CassTheme

pub fn from_preset(preset: ThemePreset) -> Self

Build a theme from a preset, detecting color profile and env flags.

pub fn with_options( preset: ThemePreset, profile: ColorProfile, flags: ThemeFlags, ) -> Self

Build a theme with explicit profile and flags (for testing / headless).

pub fn next_preset(&mut self)

Cycle to the next preset and rebuild.

pub fn prev_preset(&mut self)

Cycle to the previous preset and rebuild.

pub fn style(&self, name: &str) -> Style

Get an ftui Style by name from the stylesheet, falling back to Style::default() if not found.

pub fn compose(&self, names: &[&str]) -> Style

Compose multiple named styles left-to-right (later overrides earlier).

pub fn downgrade(&mut self, color: Color) -> Color

Downgrade an RGB color to the terminal’s color profile.

pub fn legacy_palette(&self) -> ThemePalette

Get the legacy ThemePalette for code that hasn’t migrated yet.

pub fn show_icons(&self) -> bool

Whether emoji icons should be shown.

pub fn show_gradient(&self) -> bool

Whether gradient simulation should be used.

pub fn show_animations(&self) -> bool

Whether animations should play.

pub fn a11y_mode(&self) -> bool

Whether accessibility mode is active (textual cues supplement color).

pub fn agent_icon(&self, agent: &str) -> &'static str

Get the agent icon glyph, respecting no_icons flag.

pub fn role_style(&self, role: &str) -> Style

Get a role-specific ftui Style for message rendering.

pub fn role_bg_style(&self, role: &str) -> Style

Get role background style.

pub fn agent_pane_style(&self, agent: &str) -> (Style, Style)

Get a pane style for a specific agent. Returns (bg_only, bg+fg) styles.

pub fn stripe_style(&self, row_idx: usize) -> Style

Get a zebra-stripe background style for a given row index.

Trait Implementations

impl Default for CassTheme

fn default() -> Self

Returns the “default value” for a type.