Struct Theme 

pub struct Theme {
    pub name: String,
    pub is_dark: bool,
    pub source_url: Option<String>,
    pub background: Option<Color>,
    pub foreground: Option<Color>,
    pub styles: [Style; 73],
}

A complete syntax highlighting theme.

Fields

name: String

Theme name for display.

is_dark: bool

Whether this is a dark or light theme.

source_url: Option<String>

URL to the original theme source (for attribution).

background: Option<Color>

Background color for the code block.

foreground: Option<Color>

Foreground (default text) color.

styles: [Style; 73]

Styles for each highlight category, indexed by HIGHLIGHT_NAMES.

Implementations

impl Theme

pub const ANSI_RESET: &'static str = "\x1b[0m"

ANSI reset sequence.

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

Create an empty theme.

pub fn style(&self, index: usize) -> Option<&Style>

Get the style for a highlight index.

pub fn set_style(&mut self, index: usize, style: Style)

Set the style for a highlight index.

pub fn to_css(&self, selector_prefix: &str) -> String

Generate CSS for this theme.

Uses CSS nesting for compact output. The selector_prefix is prepended to scope the rules (e.g., [data-theme="mocha"]).

pub fn ansi_style(&self, index: usize) -> String

Generate ANSI escape sequence for a style.

pub fn ansi_style_with_base_bg(&self, index: usize) -> String

Generate ANSI escape sequence for a style, inheriting base foreground/background if not set.

When rendering with a base background color, we want individual styles to inherit that background unless they explicitly override it. Similarly, if a style doesn’t define a foreground, use the base foreground. This avoids the background disappearing when switching between styled and unstyled text, and ensures colors are complete.

pub fn ansi_base_style(&self) -> String

Generate ANSI escape sequence for the theme’s base foreground/background.

This uses background and foreground and does not include any per-highlight styling or text modifiers.

pub fn ansi_border_style(&self) -> String

Generate ANSI escape sequence for border characters (half-blocks).

Returns fg color only (no bg), slightly darker/lighter than theme background. The transparent half of the half-block char shows the terminal background.

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

Returns the “default value” for a type.