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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
//! MusKitty CSS Values — CSS Values Level 4 typed value parsing.
//!
//! 实现 CSS Values Level 4 的类型化值解析:数值(length/angle/time/
//! frequency/resolution/ratio/number/integer)、文本类型(keyword/ident/
//! string/url)、数学函数 AST(calc/min/max/clamp)、var() 语法解析。
//!
//! # 设计原则
//!
//! **解析与求值分离**:本 crate 只构建类型化 AST,不做数值计算和
//! var() 替换求值(留到 Cascade 阶段)。
//!
//! # 规范依据
//!
//! - CSS Values Level 4: `d:\csswg\css-values-4\Overview.md`
//! - CSS Variables Level 1: `d:\csswg\css-variables-1\Overview.md`
//!
//! # 快速上手
//!
//! ```
//! use muskitty_css_values::parse_length;
//!
//! let len = parse_length("10px").unwrap();
//! assert_eq!(len.value, 10.0);
//! ```
//!
//! 通过 grammar hook 解析任意类型化值:
//!
//! ```
//! use muskitty_css_values::{parse_value, grammar::ValueKind};
//!
//! let v = parse_value("45deg", ValueKind::Angle).unwrap();
//! println!("{:?}", v);
//! ```
// ── 顶层便捷函数 ────────────────────────────────────────────────────
/// 解析一个 `<length>` 值。
///
/// ```
/// use muskitty_css_values::parse_length;
/// let len = parse_length("10px").unwrap();
/// assert_eq!(len.value, 10.0);
/// ```
/// 解析一个 `<percentage>` 值。
///
/// ```
/// use muskitty_css_values::parse_percentage;
/// let p = parse_percentage("50%").unwrap();
/// assert_eq!(p.value, 50.0);
/// ```
/// 解析一个 `<number>` 值。
///
/// ```
/// use muskitty_css_values::parse_number;
/// let n = parse_number("3.14").unwrap();
/// assert!((n.value - 3.14).abs() < f64::EPSILON);
/// ```
/// 解析一个 `<integer>` 值。
///
/// ```
/// use muskitty_css_values::parse_integer;
/// let i = parse_integer("42").unwrap();
/// assert_eq!(i.value, 42);
/// ```
/// 解析一个 calc() 数学表达式(也接受 min/max/clamp)。
///
/// ```
/// use muskitty_css_values::parse_calc;
/// let expr = parse_calc("calc(10px + 5px)").unwrap();
/// ```
/// 解析一个 var() 引用(含 fallback)。
///
/// ```
/// use muskitty_css_values::parse_var;
/// let v = parse_var("var(--foo, 10px)").unwrap();
/// assert_eq!(v.name, "--foo");
/// ```
/// 通过 grammar hook(§5.4.1 `parse_a_grammar`)解析任意类型化值。
///
/// ```
/// use muskitty_css_values::{parse_value, grammar::ValueKind};
/// let v = parse_value("auto", ValueKind::Keyword).unwrap();
/// ```