standout-render 7.1.0

Styled terminal rendering with templates, themes, and adaptive color support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

//! Style system for named styles, aliases, and YAML-based stylesheets.
//!
//! This module provides the complete styling infrastructure:
//!
//! ## Core Types
//!
//! - [`StyleValue`]: A style that can be either concrete or an alias
//! - [`Styles`]: A registry of named styles
//! - [`StyleValidationError`]: Errors from style validation
//!
//! ## YAML Stylesheet Parsing
//!
//! - [`parse_stylesheet`]: Parse YAML into theme variants
//! - [`ThemeVariants`]: Styles resolved for base/light/dark modes
//! - [`StylesheetRegistry`]: File-based theme management
//!
//! ## YAML Schema
//!
//! ```yaml
//! # Simple style with attributes
//! header:
//!   fg: cyan
//!   bold: true
//!
//! # Shorthand for single attribute
//! bold_text: bold
//! accent: cyan
//!
//! # Shorthand for multiple attributes
//! warning: "yellow italic"
//!
//! # Adaptive style with mode-specific overrides
//! panel:
//!   bg: gray
//!   light:
//!     bg: "#f5f5f5"
//!   dark:
//!     bg: "#1a1a1a"
//!
//! # Aliases
//! disabled: muted
//! ```
//!
//! ## Color Formats
//!
//! ```yaml
//! fg: red               # Named (16 ANSI colors)
//! fg: bright_yellow     # Bright variants
//! fg: 208               # 256-color palette
//! fg: "#ff6b35"         # RGB hex
//! fg: [255, 107, 53]    # RGB tuple
//! ```
//!
//! ## Example
//!
//! ```rust
//! use standout_render::style::{parse_stylesheet, ThemeVariants};
//! use standout_render::ColorMode;
//!
//! let yaml = r#"
//! header:
//!   fg: cyan
//!   bold: true
//! footer:
//!   dim: true
//!   light:
//!     fg: black
//!   dark:
//!     fg: white
//! "#;
//!
//! let variants = parse_stylesheet(yaml).unwrap();
//! let dark_styles = variants.resolve(Some(ColorMode::Dark));
//! ```

// Core style types
mod error;
mod registry;
mod value;

// Stylesheet parsing (YAML and CSS)
mod attributes;
mod color;
mod css_parser;
mod definition;
mod file_registry;
mod parser;

// Core exports
pub use error::{StyleValidationError, StylesheetError};
pub use registry::{Styles, DEFAULT_MISSING_STYLE_INDICATOR};
pub use value::StyleValue;

// Stylesheet parsing exports
pub use attributes::StyleAttributes;
pub use color::ColorDef;
pub use css_parser::parse_css;
pub use definition::StyleDefinition;
pub use file_registry::{StylesheetRegistry, STYLESHEET_EXTENSIONS};
pub use parser::{parse_stylesheet, ThemeVariants};