waterui 0.4.0

A modern UI framework for Rust
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

//! Who gets to decide what a fenced code block looks like.
//!
//! A fence carries an info token the author wrote — `rust`, `mermaid`,
//! `puzzle` — and only one of those resolves to a `Language`. Before
//! `CodeConfig`, the other two were indistinguishable from a fence with no info
//! string at all, so nothing could claim them. These assertions are about the
//! token surviving far enough for a hook to dispatch on it, and about the
//! default rendering staying exactly what it was for every fence a hook
//! declines.
#![cfg(feature = "flow-markdown")]

use hydrolysis_m3::install as install_m3;
use waterui::ViewExt as _;
use waterui::env::use_env;
use waterui::metadata::Metadata;
use waterui::prelude::*;
use waterui::view::ViewConfiguration as _;
use waterui::widget::code::CodeConfig;
use waterui::widget::{RichText, flow_markdown};
use waterui_testing::UiBuilder;

/// One fence a `Language` answers to and one it does not.
const DOC: &str = "\
```rust
fn main() {}
```

```puzzle
this is not a programming language
```
";

/// The `Code` widget names its language in its header, which is the assertion
/// `FlowMarkdown`'s old parallel path could never have passed: it captioned
/// every block \"Code\" and put the language nowhere.
#[waterui::test(viewport = (700, 900), theme = install_m3)]
fn an_unclaimed_fence_names_its_language(ui: UiBuilder) {
    let mut app = ui.mount(|| RichText::from_markdown(DOC));

    app.query().label("Rust").assert_exists();
    app.query().label("Copy").assert_exists();
}

/// A hook sees the token as written and claims the one it recognises. The
/// `rust` fence in the same document goes through the same hook, is declined,
/// and comes back as the ordinary code block — `Hook::from` having removed the
/// hook from the environment it handed the closure, so `render()` does not
/// recurse.
#[waterui::test(viewport = (700, 900), theme = install_m3)]
fn a_hook_claims_only_the_token_it_recognises(ui: UiBuilder) {
    let mut app = ui.mount(|| {
        use_env(|mut env: Environment| {
            env.insert_hook::<CodeConfig, AnyView>(|_env, config| match config.info.as_deref() {
                Some("puzzle") => AnyView::new(text("solved").a11y_label("claimed")),
                _ => AnyView::new(config.render()),
            });
            Metadata::new(RichText::from_markdown(DOC), env)
        })
    });

    app.query().label("claimed").assert_exists();
    app.query().label("Rust").assert_exists();
}

/// A streamed document renders its fences through the same `Code` widget, so
/// the hook covers it too and the language reaches the accessibility tree.
#[waterui::test(viewport = (700, 900), theme = install_m3)]
fn a_fence_in_flow_markdown_names_its_language(ui: UiBuilder) {
    let mut app = ui.mount(|| flow_markdown(DOC));

    app.query().label("Rust").assert_exists();
}