lini 1.0.0-alpha.0

Pretty diagrams, charts, and technical drawings 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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211

//! End-to-end tests for the public Options surface — exercised through the
//! library API (which is what the CLI calls). The one exception spawns the
//! binary to assert an argument the library has no surface for is rejected.

use lini::{Options, OutputFormat};
use std::process::{Command, Stdio};

#[test]
fn html_format_wraps_svg_in_html_doc() {
    let html = lini::compile_str_with(
        "|box| \"x\"\n",
        &Options {
            format: OutputFormat::Html,
            static_mode: true,
            ..Default::default()
        },
    )
    .expect("compile");
    assert!(html.starts_with("<!doctype html>"));
    assert!(html.contains("<svg "));
    assert!(html.contains("</body>"));
    assert!(html.ends_with("</html>\n"));
}

#[test]
fn baked_output_inlines_every_var_but_keeps_shape_rules() {
    let svg = lini::compile_str_with(
        "|box| \"x\" { fill: --accent }\n",
        &Options {
            static_mode: true,
            ..Default::default()
        },
    )
    .expect("compile");
    assert!(
        !svg.contains("var("),
        "baked output must inline every var: {}",
        svg
    );
    assert!(
        svg.contains(".lini-box"),
        "baked output keeps the structural rules: {}",
        svg
    );
}

#[test]
fn default_output_has_layered_vars_and_unlayered_rules() {
    let svg = lini::compile_str("|box| \"x\"\n").expect("compile");
    assert!(svg.contains("@layer lini.defaults"), "{}", svg);
    assert!(svg.contains(".lini .lini-box"), "{}", svg);
}

#[test]
fn no_defaults_flag_is_an_unknown_argument() {
    // The flag is gone; clap rejects it as unknown (exit 3) before it ever
    // tries to read the input, distinguishing it from an I/O failure (exit 2).
    let status = Command::new(env!("CARGO_BIN_EXE_lini"))
        .args(["--no-defaults", "/nonexistent.lini"])
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .status()
        .expect("spawn lini");
    assert_eq!(status.code(), Some(3));
}

#[test]
fn theme_overrides_visual_var_visible_in_baked_output() {
    let svg = lini::compile_str_with(
        "|box| \"x\" { fill: --accent }\n",
        &Options {
            theme_css: Some("--lini-accent: hotpink;".to_string()),
            static_mode: true,
            ..Default::default()
        },
    )
    .expect("compile");
    assert!(svg.contains("fill: hotpink"), "{}", svg);
}

#[test]
fn theme_cannot_set_a_layout_value() {
    // Layout values (gap, padding, radius, …) bake from the global block and the
    // `.lini-*` classes, not `--lini-*` vars (SPEC §11.2, the "dumb core"): a
    // `--lini-gap` theme is inert. Gap is set with `gap:` in the stylesheet.
    let src = "{\n  direction: row;\n}\n|box| { width: 40; height: 40; }\n|box| { width: 40; height: 40; }\n";
    let default = lini::compile_str(src).expect("default compile");
    let themed = lini::compile_str_with(
        src,
        &Options {
            theme_css: Some("--lini-gap: 60;".to_string()),
            ..Default::default()
        },
    )
    .expect("themed compile");
    assert_eq!(
        extract_viewbox_w(&default),
        extract_viewbox_w(&themed),
        "a --lini-gap theme must not change layout — gap is not a themeable var",
    );
}

#[test]
fn theme_visual_var_does_not_change_layout_baking() {
    let src = "{\n  direction: row;\n}\n|box| { width: 40; height: 40; }\n|box| { width: 40; height: 40; }\n";
    let default = lini::compile_str(src).expect("default compile");
    let themed = lini::compile_str_with(
        src,
        &Options {
            theme_css: Some("--lini-accent: red;".to_string()),
            ..Default::default()
        },
    )
    .expect("themed compile");
    assert_eq!(extract_viewbox_w(&default), extract_viewbox_w(&themed));
}

#[test]
fn check_with_succeeds_on_valid_input() {
    let opts = Options::default();
    assert!(lini::check_with("|box| \"x\"\n", &opts).is_ok());
}

#[test]
fn check_with_propagates_resolve_errors() {
    let opts = Options::default();
    let err = lini::check_with("|nosuch| \"x\"\n", &opts).expect_err("expected error");
    assert!(
        err.to_string().contains("unknown type 'nosuch'"),
        "got: {}",
        err
    );
}

fn extract_viewbox_w(svg: &str) -> f64 {
    let vb = svg
        .lines()
        .next()
        .unwrap()
        .split("viewBox=\"")
        .nth(1)
        .unwrap()
        .split('"')
        .next()
        .unwrap();
    vb.split_whitespace().nth(2).unwrap().parse().unwrap()
}

#[cfg(feature = "font")]
#[test]
fn static_output_outlines_text_to_glyph_uses() {
    // `--static` [SPEC 17/19]: text leaves become `<use>` references to
    // deduped glyph paths in `<defs>` — no `<text>` element survives, so the
    // file renders identically with no font installed.
    let svg = lini::compile_str_with(
        "|box| \"hi\"\n",
        &Options {
            static_mode: true,
            ..Default::default()
        },
    )
    .expect("compile");
    assert!(!svg.contains("<text"), "no live text under --static: {svg}");
    // lg0500: unweighted text renders at the medium default
    // (`--lini-font-weight: 500`), and the outlines follow.
    assert!(
        svg.contains("<use href=\"#lg0500-") && svg.contains("<path id=\"lg0500-"),
        "glyph defs + uses: {svg}"
    );
}

#[cfg(feature = "font")]
#[test]
fn embed_font_inlines_used_faces_under_scoped_names() {
    // `--embed-font` [SPEC 17]: a base64 @font-face per used face, under the
    // Lini-scoped family name, and the stack leads with that name so the
    // embedded bytes win over an installed copy.
    let svg = lini::compile_str_with(
        "|box| \"hi\"\n",
        &Options {
            embed_font: true,
            ..Default::default()
        },
    )
    .expect("compile");
    assert!(
        svg.contains("@font-face { font-family: \"Lini Sans Code\"; font-weight: 500;"),
        "{}",
        &svg[..800]
    );
    assert!(svg.contains("src: url(data:font/ttf;base64,"), "base64 src");
    assert!(
        svg.contains("--lini-font-family: \"Lini Sans Code\", \"Google Sans Code\","),
        "the stack leads with the scoped name"
    );
    // Text stays live `<text>` — embedding never outlines.
    assert!(svg.contains("<text"), "{svg}");
}

#[test]
fn bake_vars_flag_is_gone_without_alias() {
    // `--static` renames `--bake-vars` with no alias kept [SPEC 19] — clap
    // rejects the old spelling as unknown (exit 3).
    let status = Command::new(env!("CARGO_BIN_EXE_lini"))
        .args(["--bake-vars", "/nonexistent.lini"])
        .stdout(Stdio::null())
        .stderr(Stdio::null())
        .status()
        .expect("spawn lini");
    assert_eq!(status.code(), Some(3));
}