lini 0.7.2

Pretty diagrams from plain text, with fine-grained control. Compiles to clean, themeable SVG.
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

//! Label / `along:` lowering helpers, used by the full desugar pass ([`super`]).
//! The id-as-label rule (a leaf box with no content shows its id) and a wire's
//! auto-distributed `along:` fractions are each a small, reusable transform
//! (SPEC §3, §14).

use crate::syntax::ast::{Child, Decl, Node, TextNode, Value, Wire};

/// The id-as-label text child for a leaf box (SPEC §3): a box that is neither an
/// `|icon|` (which consumes its text as a glyph name) nor a container (which holds
/// its children) shows its id. `None` when the node has no id or is icon/container;
/// the caller adds it only when the node has no other content.
pub(super) fn label_child_for(node: &Node, is_icon: bool, is_container: bool) -> Option<Child> {
    if is_icon || is_container {
        return None;
    }
    node.id.as_ref().map(|id| {
        Child::Text(TextNode {
            text: id.clone(),
            span: node.span,
        })
    })
}

/// Make a wire's auto-distributed labels explicit: prepend an `along:` list of even
/// fractions when labels are present and no `along:` was written (SPEC §14).
pub(super) fn auto_along(w: &Wire) -> Wire {
    let n = w.labels.len();
    let has_along = w.style.iter().any(|d| d.name == "along");
    if n == 0 || has_along {
        return w.clone();
    }
    let fractions: Vec<Value> = (0..n)
        .map(|i| {
            let f = (i as f64 + 1.0) / (n as f64 + 1.0);
            Value::Number((f * 100.0).round() / 100.0)
        })
        .collect();
    let mut style = w.style.clone();
    style.insert(
        0,
        Decl {
            name: "along".to_string(),
            groups: vec![fractions],
            span: w.span,
        },
    );
    Wire {
        chain: w.chain.clone(),
        op: w.op,
        classes: w.classes.clone(),
        style,
        style_span: w.style_span,
        labels: w.labels.clone(),
        span: w.span,
    }
}