aetna-core 0.3.4

Aetna — backend-agnostic UI library core
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

//! Alert — bordered callout surface with shadcn-style anatomy.
//!
//! The common shape is:
//!
//! ```ignore
//! use aetna_core::prelude::*;
//!
//! alert([
//!     alert_title("Heads up"),
//!     alert_description("This action changes project defaults."),
//! ])
//! ```
//!
//! Apply the existing status modifiers to the root for variants:
//! `.destructive()`, `.warning()`, `.info()`, `.success()`, or `.muted()`.

use std::panic::Location;

use crate::metrics::MetricsRole;
use crate::style::StyleProfile;
use crate::tokens;
use crate::tree::*;
use crate::widgets::text::text;

#[track_caller]
pub fn alert<I, E>(children: I) -> El
where
    I: IntoIterator<Item = E>,
    E: Into<El>,
{
    El::new(Kind::Custom("alert"))
        .at_loc(Location::caller())
        .style_profile(StyleProfile::Surface)
        .metrics_role(MetricsRole::Panel)
        .surface_role(SurfaceRole::Panel)
        .children(children)
        .axis(Axis::Column)
        .align(Align::Stretch)
        .width(Size::Fill(1.0))
        .height(Size::Hug)
        .fill(tokens::CARD)
        .stroke(tokens::BORDER)
        .default_radius(tokens::RADIUS_MD)
        .default_padding(Sides::all(tokens::SPACE_3))
        .default_gap(tokens::SPACE_1)
}

#[track_caller]
pub fn alert_title(title: impl Into<String>) -> El {
    text(title)
        .at_loc(Location::caller())
        .label()
        .font_weight(FontWeight::Semibold)
        .ellipsis()
        .width(Size::Fill(1.0))
}

#[track_caller]
pub fn alert_description(description: impl Into<String>) -> El {
    text(description)
        .at_loc(Location::caller())
        .muted()
        .wrap_text()
        .width(Size::Fill(1.0))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn alert_uses_panel_surface_and_density_role() {
        let a = alert([alert_title("Heads up"), alert_description("Details")]);

        assert_eq!(a.kind, Kind::Custom("alert"));
        assert_eq!(a.style_profile, StyleProfile::Surface);
        assert_eq!(a.metrics_role, Some(MetricsRole::Panel));
        assert_eq!(a.surface_role, SurfaceRole::Panel);
        assert_eq!(a.axis, Axis::Column);
        assert_eq!(a.width, Size::Fill(1.0));
        assert_eq!(a.fill, Some(tokens::CARD));
        assert_eq!(a.stroke, Some(tokens::BORDER));
        assert_eq!(a.children.len(), 2);
    }

    #[test]
    fn alert_anatomy_matches_text_roles() {
        let title = alert_title("Danger");
        let description = alert_description("This cannot be undone.");

        assert_eq!(title.text.as_deref(), Some("Danger"));
        assert_eq!(title.text_role, TextRole::Label);
        assert_eq!(title.font_weight, FontWeight::Semibold);
        assert_eq!(description.text_role, TextRole::Body);
        assert_eq!(description.text_color, Some(tokens::MUTED_FOREGROUND));
        assert_eq!(description.text_wrap, TextWrap::Wrap);
    }

    #[test]
    fn status_modifiers_tint_direct_alert_text() {
        let a = alert([alert_title("Invalid"), alert_description("Fix this")]).destructive();

        assert_eq!(a.fill, Some(tokens::DESTRUCTIVE.with_alpha(38)));
        assert_eq!(a.stroke, Some(tokens::DESTRUCTIVE.with_alpha(120)));
        assert_eq!(a.children[0].text_color, Some(tokens::DESTRUCTIVE));
        assert_eq!(a.children[1].text_color, Some(tokens::DESTRUCTIVE));
    }
}