uzor 1.2.0

Core UI engine — geometry, interaction, input state
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

//! Dropdown geometry parameters trait and default implementation.
//!
//! Style holds layout numbers only — no colours (those live in `DropdownTheme`).
//!
//! Default values ported from the mlc audit (`dropdown-deep.md` §6–§8).

// ---------------------------------------------------------------------------
// BackgroundFill
// ---------------------------------------------------------------------------

/// Selects how the dropdown panel background is filled.
///
/// Default is `Solid` — dropdowns are always opaque (no blur).
#[derive(Debug, Clone)]
pub enum BackgroundFill {
    /// Solid colour — uses `theme.bg()`.  Default for all dropdown kinds.
    Solid,

    /// Frosted-glass blur.  Included for completeness; dropdowns should use `Solid`.
    Glass {
        /// Blur kernel radius in pixels.
        blur_radius: f64,
    },

    /// Tiled texture fill.  Falls back to `Solid` until asset system is wired.
    Texture {
        /// Asset identifier used to resolve the texture.
        asset_id: &'static str,
    },
}

// ---------------------------------------------------------------------------
// DropdownStyle
// ---------------------------------------------------------------------------

/// Geometry parameters for the Dropdown composite.
///
/// All method defaults match mlc values from the deep audit.
pub trait DropdownStyle {
    // --- Panel geometry ---

    /// Frame corner radius.  Default: `4.0`.
    fn radius(&self) -> f64;

    /// Frame border width in pixels.  Default: `1.0`.
    fn border_width(&self) -> f64;

    /// Outer padding (all four sides inside panel).  Default: `4.0`.
    fn padding(&self) -> f64;

    // --- Item rows ---

    /// Height per Item / Submenu row.  Default: `32.0`.
    fn item_height(&self) -> f64;

    /// Height per Header row.  Default: `28.0`.
    fn header_height(&self) -> f64;

    /// Height per Separator row (visual center gets the 1 px line).  Default: `9.0`.
    fn separator_height(&self) -> f64;

    /// Horizontal text/icon padding inside each item row.  Default: `12.0`.
    fn item_padding_x(&self) -> f64;

    // --- Typography ---

    /// Item label font size in pixels.  Default: `13.0`.
    fn font_size(&self) -> f64;

    /// Subtitle / shortcut font size in pixels.  Default: `12.0`.
    fn font_size_subtitle(&self) -> f64;

    // --- Icons ---

    /// Icon bounding box (square).  Default: `24.0`.
    fn icon_size(&self) -> f64;

    /// Gap between icon and label text.  Default: `6.0`.
    fn icon_text_gap(&self) -> f64;

    // --- Shadow ---

    /// Shadow rect offset `(x, y)`.  Default: `(2.0, 4.0)`.
    fn shadow_offset(&self) -> (f64, f64);

    // --- Toggle switch geometry ---

    /// Toggle pill track width.  Default: `36.0`.
    fn toggle_track_w(&self) -> f64;

    /// Toggle pill track height.  Default: `18.0`.
    fn toggle_track_h(&self) -> f64;

    /// Toggle thumb diameter.  Default: `14.0`.
    fn toggle_thumb_d(&self) -> f64;

    // --- Accent bar ---

    /// Left-edge accent bar width in pixels.  Default: `2.0`.
    fn accent_bar_w(&self) -> f64;

    /// Top + bottom inset for accent bar.  Default: `4.0`.
    fn accent_bar_inset_y(&self) -> f64;

    // --- Item hover ---

    /// Corner radius of the item hover background fill.  Default: `2.0`.
    fn item_hover_radius(&self) -> f64;

    // --- Submenu panel ---

    /// Gap between parent panel right edge and sibling submenu left edge.  Default: `2.0`.
    fn submenu_gap(&self) -> f64;

    // --- Scroll clipping ---

    /// Maximum number of items before the panel clips and scroll activates.
    /// `0` = no clip (unlimited height).  Default: `0`.
    fn max_visible_items(&self) -> usize;

    // --- Panel width ---

    /// Minimum panel width in pixels.  Default: `180.0`.
    fn min_width(&self) -> f64;

    // --- Grid template extras ---

    /// Square cell side for Grid / Grouped templates.  Default: `32.0`.
    fn cell_size(&self) -> f64;

    /// Gap between cells.  Default: `2.0`.
    fn cell_gap(&self) -> f64;

    // --- Grouped template extras ---

    /// Width of the left row-label column in the Grouped template.  Default: `16.0`.
    fn row_label_width(&self) -> f64;

    /// Stroke-only checkbox square size for Grouped list section.  Default: `14.0`.
    fn checkbox_size(&self) -> f64;

    // --- Background ---

    /// Background fill strategy.  Default: `BackgroundFill::Solid`.
    fn background_fill(&self) -> BackgroundFill {
        BackgroundFill::Solid
    }
}

// ---------------------------------------------------------------------------
// DefaultDropdownStyle
// ---------------------------------------------------------------------------

/// Default style preset — matches mlc dropdown geometry from the deep audit.
#[derive(Default)]
pub struct DefaultDropdownStyle;

impl DropdownStyle for DefaultDropdownStyle {
    // Panel geometry
    fn radius(&self)       -> f64 { 4.0 }
    fn border_width(&self) -> f64 { 1.0 }
    fn padding(&self)      -> f64 { 4.0 }

    // Item rows
    fn item_height(&self)      -> f64 { 32.0 }
    fn header_height(&self)    -> f64 { 28.0 }
    fn separator_height(&self) -> f64 { 9.0  }
    fn item_padding_x(&self)   -> f64 { 12.0 }

    // Typography
    fn font_size(&self)          -> f64 { 13.0 }
    fn font_size_subtitle(&self) -> f64 { 12.0 }

    // Icons
    fn icon_size(&self)     -> f64 { 24.0 }
    fn icon_text_gap(&self) -> f64 { 6.0  }

    // Shadow
    fn shadow_offset(&self) -> (f64, f64) { (2.0, 4.0) }

    // Toggle
    fn toggle_track_w(&self) -> f64 { 36.0 }
    fn toggle_track_h(&self) -> f64 { 18.0 }
    fn toggle_thumb_d(&self) -> f64 { 14.0 }

    // Accent bar
    fn accent_bar_w(&self)       -> f64 { 2.0 }
    fn accent_bar_inset_y(&self) -> f64 { 4.0 }

    // Item hover
    fn item_hover_radius(&self) -> f64 { 2.0 }

    // Submenu
    fn submenu_gap(&self) -> f64 { 2.0 }

    // Scroll
    fn max_visible_items(&self) -> usize { 0 }

    // Panel width
    fn min_width(&self) -> f64 { 180.0 }

    // Grid extras
    fn cell_size(&self) -> f64 { 32.0 }
    fn cell_gap(&self)  -> f64 { 2.0  }

    // Grouped extras
    fn row_label_width(&self) -> f64 { 16.0 }
    fn checkbox_size(&self)   -> f64 { 14.0 }
}