mmdflux 2.1.0

Render Mermaid diagrams as Unicode text, ASCII, SVG, and MMDS JSON.
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

//! Mermaid source-ingestion boundary.
//!
//! Owns Mermaid source detection, diagnostics, and parse entrypoints before
//! diagram modules compile Mermaid syntax into family IR.

pub mod ast;
pub mod class;
pub mod error;
pub mod flowchart;
pub mod sequence;
pub mod state;
pub(crate) mod theme_hint;

pub use ast::*;
pub use error::*;
pub use flowchart::{
    Flowchart, ParseOptions, parse_flowchart, parse_flowchart_with_options, strip_frontmatter,
};
pub(crate) use theme_hint::{extract_theme_hint, strip_theme_only_compat_syntax};

/// The type of Mermaid diagram detected from input.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum DiagramType {
    Flowchart,
    Class,
    Sequence,
    State,
}

/// Detect the Mermaid logical diagram type from the first significant keyword.
#[must_use]
pub fn detect_diagram_type(input: &str) -> Option<DiagramType> {
    let input = strip_frontmatter(input);
    let first_word = input
        .lines()
        .map(|line| line.trim())
        .find(|line| !line.is_empty() && !line.starts_with("%%"))
        .and_then(|line| line.split_whitespace().next())?;

    match first_word.to_ascii_lowercase().as_str() {
        "graph" | "flowchart" => Some(DiagramType::Flowchart),
        "classdiagram" => Some(DiagramType::Class),
        "sequencediagram" => Some(DiagramType::Sequence),
        "statediagram-v2" | "statediagram" => Some(DiagramType::State),
        _ => None,
    }
}

#[cfg(test)]
mod tests {
    use super::{DiagramType, detect_diagram_type};

    #[test]
    fn detects_mermaid_logical_types() {
        assert_eq!(
            detect_diagram_type("graph TD\nA-->B\n"),
            Some(DiagramType::Flowchart)
        );
        assert_eq!(
            detect_diagram_type("classDiagram\nclass User"),
            Some(DiagramType::Class)
        );
        assert_eq!(
            detect_diagram_type("sequenceDiagram\nparticipant A"),
            Some(DiagramType::Sequence)
        );
        assert_eq!(
            detect_diagram_type("stateDiagram-v2\n[*] --> Idle"),
            Some(DiagramType::State)
        );
        assert_eq!(
            detect_diagram_type("stateDiagram\n[*] --> Idle"),
            Some(DiagramType::State)
        );
    }
}