Struct ThemeManager 

pub struct ThemeManager { /* private fields */ }

Implementations

impl ThemeManager

pub fn from_variants( variants: impl IntoIterator<Item = ThemeVariant>, selection: ThemeSelection, ) -> Result<Self, ThemeError>

Build families from independent variants and select one fixed variant. Families that only provide one color mode use their first variant as the fallback for the unavailable system appearance.

Errors

Returns ThemeError for duplicates, invalid variants, or an unknown initial selection.

pub fn new( families: impl IntoIterator<Item = ThemeFamily>, app: ThemePreference, ) -> Result<Self, ThemeError>

Create a manager with a validated app preference.

Errors

Returns ThemeError if the preference cannot resolve in the supplied family set.

pub fn register_family(&mut self, family: ThemeFamily) -> Result<(), ThemeError>

Add a validated theme family.

Errors

Returns ThemeError for invalid or duplicate families.

pub fn replace_variant( &mut self, variant: ThemeVariant, ) -> Result<(), ThemeError>

Replace one already-registered variant and advance the theme generation.

This is the host-facing path for live theme editors. Identity cannot be changed in place; callers create a new manager when families are added or removed.

Errors

Returns validation or unknown-selection errors.

pub fn set_app(&mut self, preference: ThemePreference) -> Result<(), ThemeError>

Change the application fallback preference.

Errors

Returns ThemeError when the selection cannot resolve.

pub fn set_window( &mut self, window: impl Into<String>, preference: ThemePreference, ) -> Result<(), ThemeError>

Set a per-window theme preference.

Errors

Returns ThemeError when the preference cannot resolve.

pub fn remove_window(&mut self, window: &str) -> bool

pub fn remove_scope(&mut self, scope: &ComponentInstancePath) -> bool

pub fn set_scope( &mut self, scope: ComponentInstancePath, preference: ThemePreference, ) -> Result<(), ThemeError>

Set a local theme preference for a component subtree.

Errors

Returns ThemeError when the preference cannot resolve.

pub const fn generation(&self) -> u64

pub fn app_preference(&self) -> &ThemePreference

pub fn resolve( &self, window: Option<&str>, component: Option<&ComponentInstancePath>, system: SystemAppearance, ) -> Result<ResolvedTheme<'_>, ThemeError>

Resolve the nearest active theme without changing scripts or UI state.

Errors

Returns ThemeError if an internally stored preference no longer resolves after malformed deserialization.

Trait Implementations

impl Clone for ThemeManager

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeManager

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

Formats the value using the given formatter.