zenith-core 0.0.7

Zenith core: KDL parser adapter, semantic AST, canonical formatter, tokens, validation, and diagnostics.
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

//! Style block and style definition types.

use std::collections::BTreeMap;

use crate::ast::span::Span;
use crate::ast::value::PropertyValue;

/// An unknown property child encountered inside a `style` block.
///
/// The name was not in the recognized set of visual style keys, so it cannot
/// be applied as a visual cascade.  It is preserved here so that the
/// validator can emit `style.unknown_property` warnings.
#[derive(Debug, Clone, PartialEq)]
pub struct UnknownStyleProp {
    /// The raw property value (first positional argument of the child node).
    pub raw: String,
}

/// A named style definition, holding a map of recognized visual properties.
#[derive(Debug, Clone, PartialEq)]
pub struct Style {
    /// Globally unique style ID.
    pub id: String,
    /// Recognized visual properties, keyed by their canonical hyphenated name.
    ///
    /// Canonical keys: `fill`, `stroke`, `stroke-width`, `stroke-alignment`,
    /// `font-family`, `font-size`, `font-weight`, `line-height`, `radius`,
    /// `padding`, `gap`.
    pub properties: BTreeMap<String, PropertyValue>,
    /// Unknown (unrecognized) child node names encountered in the style block.
    ///
    /// These are preserved so the validator can emit `style.unknown_property`
    /// warnings without re-parsing the source.
    pub unknown_props: BTreeMap<String, UnknownStyleProp>,
    /// Byte-range of this `style` node in the source (for diagnostics).
    pub source_span: Option<Span>,
}

/// The top-level `styles` block containing named style definitions.
#[derive(Debug, Clone, PartialEq, Default)]
pub struct StyleBlock {
    /// Ordered list of style definitions.
    pub styles: Vec<Style>,
    /// Byte-range of the `styles` block in the source (for diagnostics).
    pub source_span: Option<Span>,
}

/// Canonical hyphenated keys for recognized style visual properties.
///
/// Underscore variants are normalized to these forms by
/// [`canonicalize_style_key`] during parsing and transaction application.
pub const STYLE_RECOGNIZED_KEYS: &[&str] = &[
    "fill",
    "stroke",
    "stroke-width",
    "stroke-alignment",
    "font-family",
    "font-size",
    "font-weight",
    "line-height",
    "radius",
    "padding",
    "gap",
];

/// Map underscore-spelled style child names to their canonical hyphenated form.
///
/// Normalizes underscore variants (`stroke_width` → `stroke-width`, etc.) and
/// returns the canonical key if it is in [`STYLE_RECOGNIZED_KEYS`], or `None`
/// if the name is unrecognized after normalization.
pub fn canonicalize_style_key(name: &str) -> Option<&'static str> {
    // Normalize underscore to hyphen for comparison.
    let normalized: &str = match name {
        "stroke_width" => "stroke-width",
        "stroke_alignment" => "stroke-alignment",
        "font_family" => "font-family",
        "font_size" => "font-size",
        "font_weight" => "font-weight",
        "line_height" => "line-height",
        other => other,
    };
    STYLE_RECOGNIZED_KEYS
        .iter()
        .copied()
        .find(|&k| k == normalized)
}