snora-widgets 0.25.2

Optional prefab iced widgets for the Snora GUI framework — header, footer, sidebar, menu, icon.
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

//! Tests for chip style functions (RFC-032, M-4 contrast fix).
//!
//! Contrast requirement: selected chip text over composited background must
//! meet WCAG AA (≥4.5:1) for all statuses that are not `Disabled`.
//! `Disabled` is exempt per WCAG 2.1 §1.4.3 exception.

use super::*;
use snora_design::{Tokens, contrast};
use iced::widget::button::Status;

// ---------------------------------------------------------------------------
// Style function structural tests
// ---------------------------------------------------------------------------

#[test]
fn chip_style_selected_all_statuses_all_presets() {
    for t in all_presets() {
        for s in all_statuses() {
            let style = chip_style_selected(&t, s);
            assert!(style.background.is_some(), "selected {s:?}: background must be set");
        }
    }
}

#[test]
fn chip_style_unselected_all_statuses_all_presets() {
    for t in all_presets() {
        for s in all_statuses() {
            let style = chip_style_unselected(&t, s);
            assert!(style.background.is_some(), "unselected {s:?}: background must be set");
        }
    }
}

#[test]
fn selected_active_uses_accent_text_foreground() {
    // M-4: solid accent bg → accent_text foreground (not accent itself).
    for t in all_presets() {
        let style = chip_style_selected(&t, Status::Active);
        let expected = style::color::to_iced_color(t.palette.accent_text);
        assert_eq!(
            style.text_color, expected,
            "selected active must use accent_text for contrast"
        );
    }
}

// ---------------------------------------------------------------------------
// Contrast tests: selected chip (M-4)
// ---------------------------------------------------------------------------

/// Verifies that accent_text over the active (solid accent) background meets
/// WCAG AA (≥4.5:1) for all four built-in presets.
///
/// Verifies: M-4 (chip selected contrast fix).
#[test]
fn chip_selected_text_over_accent_background_meets_aa_all_presets() {
    const AA: f32 = 4.5;
    for (name, t) in named_presets() {
        let ratio = contrast::contrast_ratio(t.palette.accent_text, t.palette.accent);
        assert!(
            ratio >= AA,
            "{name}: accent_text/accent contrast {ratio:.2} < {AA} (WCAG AA)"
        );
    }
}

/// Verifies that the hovered/pressed backgrounds (darken(accent, amount))
/// still yield passing contrast against accent_text.
///
/// We composite darken(accent, 0.06) (hover) and darken(accent, 0.12) (pressed)
/// and check against accent_text. Because both background and foreground colors
/// are opaque, no alpha compositing is needed.
///
/// Verifies: M-4 (chip selected contrast — hover/pressed states).
#[test]
fn chip_selected_text_hover_pressed_meets_aa_all_presets() {
    const AA: f32 = 4.5;
    for (name, t) in named_presets() {
        let accent      = t.palette.accent;
        let accent_text = t.palette.accent_text;

        let hover_bg = snora_design::Color {
            r: (accent.r - 0.06).max(0.0),
            g: (accent.g - 0.06).max(0.0),
            b: (accent.b - 0.06).max(0.0),
            a: accent.a,
        };
        let pressed_bg = snora_design::Color {
            r: (accent.r - 0.12).max(0.0),
            g: (accent.g - 0.12).max(0.0),
            b: (accent.b - 0.12).max(0.0),
            a: accent.a,
        };

        let hover_ratio   = contrast::contrast_ratio(accent_text, hover_bg);
        let pressed_ratio = contrast::contrast_ratio(accent_text, pressed_bg);

        assert!(
            hover_ratio >= AA,
            "{name}: accent_text/hover_bg {hover_ratio:.2} < {AA} (WCAG AA)"
        );
        assert!(
            pressed_ratio >= AA,
            "{name}: accent_text/pressed_bg {pressed_ratio:.2} < {AA} (WCAG AA)"
        );
    }
}

// ---------------------------------------------------------------------------
// Private helper
// ---------------------------------------------------------------------------

#[test]
fn darken_clamps_to_zero() {
    let black = darken(iced::Color::BLACK, 1.0);
    assert!(black.r >= 0.0 && black.g >= 0.0 && black.b >= 0.0);
}

// ---------------------------------------------------------------------------
// Test helpers
// ---------------------------------------------------------------------------

fn all_presets() -> [Tokens; 4] {
    [
        Tokens::light(), Tokens::dark(),
        Tokens::high_contrast_light(), Tokens::high_contrast_dark(),
    ]
}

fn named_presets() -> [(&'static str, Tokens); 4] {
    [
        ("light", Tokens::light()),
        ("dark", Tokens::dark()),
        ("high_contrast_light", Tokens::high_contrast_light()),
        ("high_contrast_dark", Tokens::high_contrast_dark()),
    ]
}

fn all_statuses() -> [Status; 4] {
    [Status::Active, Status::Hovered, Status::Pressed, Status::Disabled]
}