ariel-rs 0.1.1

A faithful Rust port of Mermaid JS — headless SVG diagram rendering without a browser
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

pub(crate) mod constants;
pub mod parser;
pub mod renderer;
pub(crate) mod templates;

use crate::error::ParseError;
use crate::theme::Theme;

pub(crate) fn validate(diagram: &parser::SequenceDiagram) -> Vec<ParseError> {
    use parser::SeqItem;
    let mut errors = Vec::new();

    // Collect explicitly declared participant aliases
    let declared: std::collections::HashSet<String> = diagram
        .items
        .iter()
        .filter_map(|item| {
            if let SeqItem::Participant(p) = item {
                Some(p.alias.clone())
            } else {
                None
            }
        })
        .collect();

    // Only validate if there are explicit declarations
    if declared.is_empty() {
        return errors;
    }

    for item in &diagram.items {
        if let SeqItem::Message(msg) = item {
            if !declared.contains(&msg.from) {
                errors.push(ParseError::new(format!(
                    "Message sender '{}' is not a declared participant",
                    msg.from
                )));
            }
            if !declared.contains(&msg.to) {
                errors.push(ParseError::new(format!(
                    "Message receiver '{}' is not a declared participant",
                    msg.to
                )));
            }
        }
    }

    errors
}

/// Render a Mermaid sequence diagram to SVG with foreignObject HTML labels.
pub fn render_html(input: &str, theme: Theme) -> String {
    let mut result = parser::parse(input);
    result.errors.extend(validate(&result.diagram));
    renderer::render(&result.diagram, theme, true)
}