tui-lipan 0.1.0

Opinionated, component-based TUI framework for Rust - declarative components, reconciliation, layout engine, focus, overlays, and rich widgets on top of ratatui.
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

//! Small hand-written Mermaid subset parser used by markdown `DocumentView`.

mod class;
mod er;
mod flowchart;
mod gantt;
mod lex;
mod pie;
mod sequence;
mod state;

use super::diagram::ParsedDiagram;

/// Mermaid parse error.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct MermaidParseError {
    /// Human-readable message.
    pub message: String,
    /// One-based source line number when known.
    pub line: Option<usize>,
}

impl MermaidParseError {
    pub(crate) fn new(message: impl Into<String>, line: Option<usize>) -> Self {
        Self {
            message: message.into(),
            line,
        }
    }
}

/// Parse a supported Mermaid diagram.
pub fn parse(src: &str) -> Result<ParsedDiagram, MermaidParseError> {
    let (line_no, first) = lex::significant_lines(src)
        .into_iter()
        .next()
        .ok_or_else(|| MermaidParseError::new("empty Mermaid diagram", None))?;
    let keyword = first.split_whitespace().next().unwrap_or_default();
    match keyword {
        "flowchart" | "graph" => flowchart::parse(src),
        "sequenceDiagram" => sequence::parse(src),
        "classDiagram" => class::parse(src),
        "stateDiagram-v2" => state::parse(src),
        "erDiagram" => er::parse(src),
        "gantt" => gantt::parse(src),
        "pie" => pie::parse(src),
        other => Err(MermaidParseError::new(
            format!("unsupported Mermaid diagram type `{other}`"),
            Some(line_no),
        )),
    }
}

pub(crate) use lex::{parse_labelled_pair, significant_lines, strip_quotes};