merman-render 0.8.0-alpha.7

Headless layout + SVG renderer for Mermaid (parity-focused; upstream SVG goldens).
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

use std::fmt::Write as _;

use super::super::{SvgDiagramId, escape_xml_display, root_svg};

pub(super) struct ArchitectureA11y {
    pub(super) aria_labelledby: Option<String>,
    pub(super) aria_describedby: Option<String>,
    pub(super) nodes: String,
}

pub(super) fn architecture_a11y_nodes(
    diagram_id: SvgDiagramId<'_>,
    acc_title: Option<&str>,
    acc_descr: Option<&str>,
) -> ArchitectureA11y {
    let aria_labelledby = acc_title
        .map(str::trim)
        .filter(|t| !t.is_empty())
        .map(|_| format!("chart-title-{diagram_id}"));
    let aria_describedby = acc_descr
        .map(str::trim)
        .filter(|t| !t.is_empty())
        .map(|_| format!("chart-desc-{diagram_id}"));

    let mut nodes = String::new();
    if let Some(t) = acc_title.map(str::trim).filter(|t| !t.is_empty()) {
        let _ = write!(
            &mut nodes,
            r#"<title id="chart-title-{}">{}</title>"#,
            diagram_id,
            escape_xml_display(t)
        );
    }
    if let Some(d) = acc_descr.map(str::trim).filter(|t| !t.is_empty()) {
        let _ = write!(
            &mut nodes,
            r#"<desc id="chart-desc-{}">{}</desc>"#,
            diagram_id,
            escape_xml_display(d)
        );
    }

    ArchitectureA11y {
        aria_labelledby,
        aria_describedby,
        nodes,
    }
}

pub(super) fn begin_architecture_document(
    out: &mut String,
    root_viewport: &root_svg::RootViewportContext<'_>,
    diagram_id: SvgDiagramId<'_>,
    css: &str,
    a11y: &ArchitectureA11y,
    use_max_width: bool,
) -> crate::Result<root_svg::RootDocument> {
    let mut root_chrome = root_svg::RootChrome::new(diagram_id, "architecture");
    root_chrome.aria_labelledby = a11y.aria_labelledby.as_deref();
    root_chrome.aria_describedby = a11y.aria_describedby.as_deref();
    root_chrome.dom.trailing_newline = false;
    let document = root_viewport.begin_document(
        out,
        root_svg::DeferredRootSpec::mermaid_or_intrinsic(use_max_width),
        root_chrome,
    )?;

    out.push_str(a11y.nodes.as_str());
    let _ = write!(out, "<style>{}</style>", css);
    out.push_str("<g/><g class=\"architecture-edges\">");
    Ok(document)
}