Struct ThemeCatalog 

pub struct ThemeCatalog { /* private fields */ }

Theme index with embedded built-ins and optional custom documents. In-memory operations never read environment variables or access the filesystem.

Implementations

impl ThemeCatalog

pub fn builtin() -> Result<ThemeCatalog, ThemeError>

Create a catalog from embedded themes, without accessing disk or environment.

pub fn load() -> Result<ThemeCatalog, ThemeError>

Load embedded themes, user themes, and the persisted native selection.

pub fn get(&self, id: &str) -> Option<&ThemeEntry>

pub fn iter(&self) -> impl Iterator<Item = (&str, &ThemeEntry)>

pub fn active_id(&self) -> &str

pub fn active_appearance(&self) -> Appearance

pub fn revision(&self) -> u64

Stable within a process and sensitive to theme documents, selection, appearance, additions, and removals. Web adapters use this revision to publish change events without exposing filesystem paths.

pub fn export_family(&self, family: &str) -> Option<ThemePackDocument>

Export every built-in and custom theme in a named family as one pack.

pub fn pack_conflicts(&self, pack: &ThemePackDocument) -> PackConflicts

Report custom and built-in ID collisions without changing the catalog.

pub fn import_pack( &mut self, pack: ThemePackDocument, policy: PackConflictPolicy, ) -> Result<PackImportReport, ThemeError>

Import a validated pack after resolving all ID collisions up front. Reject policy guarantees no writes occur if any ID conflicts.

pub fn import_pack_in_memory( &mut self, pack: ThemePackDocument, policy: PackConflictPolicy, ) -> Result<PackImportReport, ThemeError>

Import into memory. Validation and collision checks precede all mutations.

pub fn save(&mut self, document: ThemeDocument) -> Result<(), ThemeError>

Save a portable custom theme to the shared user theme folder.

pub fn insert_custom( &mut self, document: ThemeDocument, ) -> Result<(), ThemeError>

Insert or replace a custom theme without persisting it. Built-ins are protected.

pub fn select(&mut self, id: &str) -> Result<(), ThemeError>

pub fn set_active(&mut self, id: &str) -> Result<(), ThemeError>

Select a theme in memory without persisting it.

pub fn set_appearance( &mut self, appearance: Appearance, ) -> Result<(), ThemeError>

pub fn set_active_appearance(&mut self, appearance: Appearance)

Change appearance in memory without persisting it.

pub fn remove_custom(&mut self, id: &str) -> Result<bool, ThemeError>

pub fn remove_custom_entry(&mut self, id: &str) -> Result<bool, ThemeError>

Remove a custom entry in memory, falling back to the embedded default if active.

Trait Implementations

impl Clone for ThemeCatalog

fn clone(&self) -> ThemeCatalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeCatalog

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

Formats the value using the given formatter.