tui-nuances 0.1.9

Shared theming for ratatui widget libraries: one Theme, 47 built-in palettes, semantic styles, contrast-aware color math and terminal color downgrade
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

//! Internal `macro_rules!` helpers: builder setters and named-theme constructors.
//!
//! * `color_setters!` – consuming setters `fn field(self, Color) -> Self`.
//! * `named_themes!` – generates `Theme::<name>()` constructors plus the
//!   `NAMED` lookup table from compact color specs.

/// Generate consuming setters for plain `Color` fields.
macro_rules! color_setters {
    ($($field:ident),* $(,)?) => {
        $(
            #[doc = concat!("Set the `", stringify!($field), "` color.")]
            #[must_use]
            pub fn $field(mut self, color: ::ratatui::style::Color) -> Self {
                self.$field = color;
                self
            }
        )*
    };
}

/// Generate named theme constructors from hex specs and a `NAMED` table.
///
/// Each entry: `fn_name, "display-name", "doc" => [bg, fg, muted, surface,
/// accent, secondary, success, warning, error, info], [p0 .. p7]`.
macro_rules! named_themes {
    ($(
        $fn_name:ident, $name:literal, $doc:literal =>
        [$bg:expr, $fg:expr, $muted:expr, $surface:expr, $accent:expr, $secondary:expr, $success:expr, $warning:expr, $error:expr, $info:expr],
        [$($p:expr),+ $(,)?]
    );+ $(;)?) => {
        impl Theme {
            $(
                #[doc = $doc]
                #[must_use]
                pub fn $fn_name() -> Self {
                    Self::from_spec(
                        $name,
                        $crate::theme::Spec {
                            bg: $bg, fg: $fg, muted: $muted, surface: $surface,
                            accent: $accent, secondary: $secondary, success: $success,
                            warning: $warning, error: $error, info: $info,
                            palette: &[$($p),+],
                        },
                    )
                }
            )+
        }

        /// Table of macro-generated themes, in cycling order.
        pub(crate) const NAMED: &[(&str, fn() -> Theme)] = &[
            $( ($name, Theme::$fn_name as fn() -> Theme) ),+
        ];
    };
}

#[cfg(test)]
mod tests {
    use ratatui::style::Color;

    #[derive(Default, Debug, PartialEq)]
    struct Probe {
        a: Color,
        b: Color,
    }

    impl Probe {
        color_setters!(a, b);
    }

    #[test]
    fn color_setter_assigns_field() {
        assert_eq!(Probe::default().a(Color::Red).a, Color::Red);
    }

    #[test]
    fn setters_chain() {
        let p = Probe::default().a(Color::Green).b(Color::Cyan);
        assert_eq!(
            p,
            Probe {
                a: Color::Green,
                b: Color::Cyan
            }
        );
    }
}