Struct ThemeRegistry 

pub struct ThemeRegistry { /* private fields */ }

A registry holding all loaded themes.

This is a pure data structure - no I/O operations. Use ThemeLoader to create and populate a registry.

Themes are keyed by their unique ThemeInfo::key (typically a repository URL or pack/name path). Lookups fall back to matching by display name for backward compatibility with configs that store just e.g. "dark".

Implementations

impl ThemeRegistry

pub fn get(&self, key_or_name: &str) -> Option<&Theme>

Look up a theme by its config value (key, scheme URI, relative path, or legacy bare name). See ThemeRegistry::resolve_key.

pub fn get_cloned(&self, key_or_name: &str) -> Option<Theme>

Get a cloned theme by key or name.

pub fn resolve_key(&self, value: &str) -> Option<String>

Resolve a config-value to the canonical registry key.

Accepted config forms (issue #1621):

Form	Example	Resolves to
builtin://NAME	builtin://dark	built-in theme by name
file://PATH (env-expanded)	file://${HOME}/.config/fresh/themes/x.json	exact user-theme key
http(s)://...	https://github.com/...#dark	URL-packaged theme
relative .json path	s-dark.json, packages/nord/dark.json	user theme under themes dir
bare name (legacy)	dark	exact key, else normalized-name match

$HOME, ${HOME}, ${XDG_CONFIG_HOME} and a leading ~ are expanded before path matching so shared dotfile configs work on any machine. Returns an owned String because some forms (e.g. a relative path) must be reconstructed as an absolute file:// key.

pub fn portable_form(&self, key: &str) -> Option<String>

Portable config form for the given theme, suitable for persisting to config.json and sharing across machines.

• Built-ins → "builtin://NAME"
• User theme under themes dir → relative path ("s-dark.json" or "nord/dark.json")
• User theme outside themes dir → "file://{abs}" (user can hand-edit to use ${HOME} / ${XDG_CONFIG_HOME} if they want)
• URL-packaged theme → repo-URL key kept as-is

pub fn list(&self) -> &[ThemeInfo]

List all available themes with metadata.

pub fn names(&self) -> Vec<String>

Get all theme display names.

pub fn contains(&self, key_or_name: &str) -> bool

Check if a theme exists (by key or name).

pub fn len(&self) -> usize

Number of themes in the registry.

pub fn is_empty(&self) -> bool

Check if registry is empty.

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

Convert all themes to a JSON map (key → serde_json::Value).

Keyed by the unique registry key. Each value is the theme data with added _key and _pack metadata fields so plugins can distinguish themes and show display names.

Trait Implementations

impl Clone for ThemeRegistry

fn clone(&self) -> ThemeRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThemeRegistry

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

Formats the value using the given formatter.