Struct Theme 

pub struct Theme { /* private fields */ }

A mapping from SemanticRole to ResolvedStyle.

Themes provide a reusable appearance layer: the consumer assigns semantic roles, and the theme determines what each role looks like. This keeps style definitions shared across consumers instead of duplicated.

Missing roles fall back to ResolvedStyle::default().

Implementations

impl Theme

pub fn new(name: impl Into<String>) -> Self

Create a theme with the given name and empty style map.

pub fn name(&self) -> &str

Theme name.

pub fn set_base_fonts(&mut self, families: Vec<String>)

Set the base (body) font families.

pub fn set_mono_fonts(&mut self, families: Vec<String>)

Set the monospace font families.

pub fn base_fonts(&self) -> &[String]

Base font families.

pub fn mono_fonts(&self) -> &[String]

Monospace font families.

pub fn set_style(&mut self, role: SemanticRole, style: ResolvedStyle)

Register a style for a semantic role.

pub fn style_for(&self, role: SemanticRole) -> ResolvedStyle

Get the style for a semantic role, falling back to ResolvedStyle::default().

pub fn has_style(&self, role: SemanticRole) -> bool

Check whether a style is registered for the given role.

pub fn len(&self) -> usize

Number of registered role styles.

pub fn is_empty(&self) -> bool

Whether no role styles are registered.

pub fn iter(&self) -> impl Iterator<Item = (&SemanticRole, &ResolvedStyle)>

Iterate all registered (role, style) pairs.

pub fn merge(&mut self, overlay: &Theme)

Merge another theme on top of this one.

Styles from overlay replace styles in self for the same role. Styles in self that are not in overlay are preserved. Font families from overlay replace those in self if non-empty.

pub fn academic() -> Self

Create the academic theme: serif-based document.

pub fn technical() -> Self

Create the technical theme: monospace-heavy document.

pub fn load(path: impl AsRef<Path>) -> Result<Self, ThemeLoadError>

Load a theme from a TOML file.

The loaded theme is merged on top of the default theme, so only overridden roles need to be specified.

pub fn from_toml(toml_str: &str) -> Result<Self, ThemeLoadError>

Parse a theme from a TOML string.

The parsed theme is merged on top of the default theme, so only overridden roles need to be specified.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Theme

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

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Create the default theme: clean sans-serif document (Noto Sans).