Struct ThemeContext 

pub struct ThemeContext { /* private fields */ }

Runtime theme context shared across all windows.

This struct manages theme state including:

• The currently active theme
• All loaded themes from theme.dampen
• System preference detection
• User preference persistence

Examples

use dampen_core::{parse_theme_document, ThemeContext};

let xml = r#"<dampen><themes><theme name="light">...</theme></themes></dampen>"#;
let doc = parse_theme_document(xml).unwrap();
let ctx = ThemeContext::from_document(doc, Some("dark"));

assert_eq!(ctx.active().name, "dark");

Implementations

impl ThemeContext

pub fn from_document( document: ThemeDocument, system_preference: Option<&str>, ) -> Result<Self, ThemeError>

Create a ThemeContext from a parsed ThemeDocument.

The active theme is determined by:

1. User preference (if set)
2. Document’s default_theme (if set)
3. System preference (if follow_system is true)
4. “light” fallback

Arguments

• document - The parsed theme document
• system_preference - Optional detected system theme preference

Errors

Returns ThemeError if the document is invalid or has no themes.

pub fn active(&self) -> &Theme

Get the currently active theme.

Returns

Reference to the active Theme.

pub fn active_name(&self) -> &str

Get the name of the currently active theme.

pub fn set_theme(&mut self, name: &str) -> Result<(), ThemeError>

Switch to a different theme by name.

Arguments

• name - The name of the theme to switch to

Errors

Returns ThemeError::ThemeNotFound if the theme doesn’t exist.

pub fn update_system_preference(&mut self, preference: &str)

Update the system preference and potentially switch theme.

If the document is configured to follow system preference, this will switch to the system theme if it exists.

Arguments

• preference - The new system preference (“light” or “dark”)

pub fn set_follow_system(&mut self, follow: bool)

Set whether to follow system preference.

pub fn follow_system(&self) -> bool

Check if currently following system preference.

pub fn reload(&mut self, document: ThemeDocument)

Reload themes from a new document (for hot-reload).

Preserves the current active theme if it exists in the new document, otherwise falls back to the new document’s default.

Arguments

• document - The new parsed theme document

pub fn available_themes(&self) -> Vec<&str>

Get all available theme names.

pub fn has_theme(&self, name: &str) -> bool

Check if a theme with the given name exists.

Trait Implementations

impl Clone for ThemeContext

fn clone(&self) -> ThemeContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeContext

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

Formats the value using the given formatter.