muskitty_css/lib.rs
1//! MusKitty CSS (umbrella)
2//!
3//! Re-exports the tokenizer (`muskitty-css-tokenizer`) and parser
4//! (`muskitty-css-parser`) crates. Downstream crates can either depend
5//! on this umbrella for the full CSS Syntax stack, or on the individual
6//! sub-crates for finer-grained dependencies.
7//!
8//! # Architecture
9//!
10//! 1. **Tokenization** ([`tokenizer`]) — re-exported from
11//! `muskitty-css-tokenizer` (§4.3, fully implemented).
12//! 2. **Parsing** ([`parser`]) — re-exported from `muskitty-css-parser`
13//! (§5, fully implemented).
14//!
15//! # Top-level API
16//!
17//! - [`parse_stylesheet`] — full stylesheet parse (§5.4.3)
18//! - [`parse_rule`] — single rule parse (§5.4.6)
19//! - [`parse_declaration`] — single declaration parse (§5.4.7)
20//! - [`parse_component_value`] — single component value (§5.4.8)
21//! - [`parse_list_of_component_values`] — list of component values (§5.4.9)
22//! - [`parse_comma_separated_list_of_component_values`] — comma-separated list (§5.4.10)
23//! - [`tokenize`] — token stream only (§4.3)
24//!
25//! # References
26//!
27//! - CSS Syntax Module Level 3: <https://drafts.csswg.org/css-syntax-3/>
28//! - Spec source (Markdown): `D:\CSSWG\css-syntax-3\Overview.md`
29
30pub mod parser;
31pub mod tokenizer;
32
33// Re-export the top-level convenience functions from muskitty-css-parser.
34pub use muskitty_css_parser::{
35 parse_comma_separated_list_of_component_values, parse_component_value, parse_declaration,
36 parse_list_of_component_values, parse_rule, parse_stylesheet, tokenize,
37};
38
39// Re-export key parser types at the crate root (backward compat).
40pub use parser::{BlockKind, Function, SimpleBlock};