Struct ThemeState 

pub struct ThemeState { /* private fields */ }

Global theme state - accessed directly by widgets during render

Implementations

impl ThemeState

pub fn init(bundle: ThemeBundle, scheme: ColorScheme)

Initialize the global theme state (call once at app startup)

pub fn set_scheduler(&self, scheduler: &Arc<Mutex<AnimationScheduler>>)

Set the animation scheduler for theme transitions

This should be called by the app layer after the window is created to enable animated theme transitions.

pub fn init_default()

Initialize with platform-native theme and system color scheme

Detects the current OS and uses the appropriate native theme:

• macOS: Apple Human Interface Guidelines theme
• Windows: Fluent Design System 2 theme
• Linux: GNOME Adwaita theme

pub fn get() -> &'static ThemeState

Get the global theme state instance

pub fn try_get() -> Option<&'static ThemeState>

Try to get the global theme state (returns None if not initialized)

pub fn scheme(&self) -> ColorScheme

Get the current color scheme

pub fn set_scheme(&self, scheme: ColorScheme)

Set the color scheme (animates colors if scheduler is available)

pub fn tick(&self) -> bool

Update theme colors based on animation progress

This should be called during the render loop to update interpolated colors. Returns true if animation is still in progress and needs more frames.

pub fn is_animating(&self) -> bool

Check if a theme transition animation is in progress

pub fn toggle_scheme(&self)

Toggle between light and dark mode

pub fn color(&self, token: ColorToken) -> Color

Get a color token value (checks override first)

pub fn colors(&self) -> ColorTokens

Get all color tokens

pub fn set_color_override(&self, token: ColorToken, color: Color)

Set a color override (triggers repaint only)

pub fn remove_color_override(&self, token: ColorToken)

Remove a color override

pub fn to_css_variable_map(&self) -> HashMap<String, String>

Generate a CSS variable map from all color tokens.

Returns a HashMap<String, String> where keys are variable names (without -- prefix) and values are hex color strings. Variable names match the theme() CSS function token names.

Example

let vars = ThemeState::get().to_css_variable_map();
// vars["text-primary"] == "#1a1a2e"
// vars["surface"] == "#ffffff"

pub fn spacing_value(&self, token: SpacingToken) -> f32

Get a spacing token value (checks override first)

pub fn spacing(&self) -> SpacingTokens

Get all spacing tokens

pub fn set_spacing_override(&self, token: SpacingToken, value: f32)

Set a spacing override (triggers layout)

pub fn remove_spacing_override(&self, token: SpacingToken)

Remove a spacing override

pub fn typography(&self) -> TypographyTokens

Get all typography tokens

pub fn radius(&self, token: RadiusToken) -> f32

Get a radius token value (checks override first)

pub fn radii(&self) -> RadiusTokens

Get all radius tokens

pub fn set_radius_override(&self, token: RadiusToken, value: f32)

Set a radius override (triggers repaint - radii don’t affect layout)

pub fn shadows(&self) -> ShadowTokens

Get all shadow tokens

pub fn animations(&self) -> AnimationTokens

Get all animation tokens

pub fn needs_repaint(&self) -> bool

Check if theme changes require repaint

pub fn clear_repaint(&self)

Clear the repaint flag

pub fn needs_layout(&self) -> bool

Check if theme changes require layout

pub fn clear_layout(&self)

Clear the layout flag

pub fn clear_overrides(&self)

Clear all overrides