Skip to main content

muskitty_cssom/
lib.rs

1//! MusKitty CSSOM — CSS Object Model 数据结构层。
2//!
3//! 将 css-parser 的语法层结构(`Stylesheet`/`Rule`/`AtRule`/
4//! `QualifiedRule`/`Declaration`,CSS Syntax §5.2)映射到 CSSOM
5//! 语义层结构(`CssStyleSheet`/`CssStyleRule`/`CssMediaRule`/
6//! `CssStyleDeclaration` 等,CSSOM §8)。
7//!
8//! # 设计
9//!
10//! **单向转换**:语法→语义是 one-way 的。转换后 CSSOM 树独立存在,
11//! 不反向引用 css-parser 的 `Stylesheet`,避免生命周期耦合。
12//!
13//! **枚举分发**:`CssRule` 用 Rust enum 而非 trait 对象,符合值语义,
14//! pattern matching 清晰,避免 `Rc<RefCell<>>` 所有权复杂度。
15//!
16//! # 规范依据
17//!
18//! - CSSOM: `d:\csswg\cssom-1\Overview.md`(§3 序列化、§8.1
19//!   CSSStyleSheet、§8.4 CSS Rules、§8.5 CSS Declarations、§8.6
20//!   CSS Declaration Blocks)
21//! - CSS Syntax: `d:\csswg\css-syntax-3\Overview.md`(§5.2 数据结构)
22//!
23//! # 快速上手
24//!
25//! ```
26//! use muskitty_cssom::{CssDeclaration, CssStyleDeclaration};
27//!
28//! let mut block = CssStyleDeclaration::new();
29//! block.push(CssDeclaration::new("color", Vec::new(), false));
30//! assert_eq!(block.len(), 1);
31//! ```
32
33pub mod convert;
34pub mod declaration;
35pub mod element_style;
36pub mod rule;
37pub mod serialize;
38pub mod stylesheet;
39
40pub use convert::{from_stylesheet, from_stylesheet_with_origin, parse_declaration_block};
41pub use declaration::{CssDeclaration, CssStyleDeclaration};
42pub use element_style::ElementStyle;
43pub use rule::{
44    CssContainerRule, CssCounterStyleRule, CssFontFaceRule, CssImportRule, CssKeyframeRule,
45    CssKeyframesRule, CssLayerBlockRule, CssLayerStatementRule, CssMediaRule, CssNamespaceRule,
46    CssPageRule, CssPropertyRule, CssRule, CssScopeRule, CssStyleRule, CssSupportsRule, OtherRule,
47};
48pub use serialize::{
49    serialize_component_value, serialize_component_values, serialize_identifier, serialize_string,
50    serialize_url, ToCss,
51};
52pub use stylesheet::{CssStyleSheet, Origin};
53
54// 从 css-parser re-export ComponentValue,方便下游使用。
55pub use muskitty_css::parser::ComponentValue;