egui_macview/theme/
accessors.rs

1//! Metric, Typography, Motion, and Contrast Accessors on [`MacTheme`].
2
3use super::{MacBackgroundStyle, MacTheme};
4use crate::tokens::{
5    BoxViewMetrics, ButtonMetrics, CheckboxMetrics, CollectionViewMetrics, ColorWellMetrics,
6    ComboBoxMetrics, ContextMenuMetrics, DatePickerMetrics, DisclosureGroupMetrics,
7    FocusRingMetrics, FooterMetrics, HelpButtonMetrics, InlineActionButtonMetrics, LabelMetrics,
8    LayoutMetrics, LevelIndicatorMetrics, MacControlMetrics, MacMotionTokens, MacTypographyTokens,
9    MenuBarMetrics, NavigationMetrics, OutlineViewMetrics, PaletteMetrics, PathControlMetrics,
10    PlayerViewMetrics, PopUpButtonMetrics, PopoverMetrics, ProgressIndicatorMetrics,
11    RuleEditorMetrics, ScrollViewMetrics, SearchFieldMetrics, SegmentedMetrics, SliderMetrics,
12    SplitViewMetrics, StackViewMetrics, StepperMetrics, TabViewMetrics, TableViewMetrics,
13    TextFieldMetrics, ThumbnailCellMetrics, ToastMetrics, ToggleMetrics, TokenFieldMetrics,
14    ToolbarMetrics, TrimScrubberMetrics,
15};
16use egui::{Color32, FontId, Galley, TextFormat, Ui};
17use std::sync::Arc;
18
19impl MacTheme {
20    /// Resolves Apple HIG / SF Pro optical tracking (`extra_letter_spacing` in points)
21    /// for `size_pt` from `self.typography().tracking_table`, falling back to
22    /// [`crate::tokens::sf_pro_tracking`] for fractional or out-of-range font sizes.
23    pub fn tracking_for_font_size(&self, size_pt: f32) -> f32 {
24        let rounded = size_pt.round();
25        if (size_pt - rounded).abs() == 0.0 {
26            let key = format!("pt_{}", rounded as i32);
27            if let Some(entry) = self.typography().tracking_table.get(&key) {
28                return entry.tracking_pt;
29            }
30        }
31        crate::tokens::sf_pro_tracking(size_pt)
32    }
33
34    /// Constructs an [`egui::TextFormat`] populated with optical letter spacing (`extra_letter_spacing`)
35    /// from the Apple HIG tracking table for `font_id.size`.
36    pub fn tracked_text_format(&self, font_id: FontId, color: Color32) -> TextFormat {
37        TextFormat {
38            font_id: font_id.clone(),
39            color,
40            extra_letter_spacing: self.tracking_for_font_size(font_id.size),
41            ..Default::default()
42        }
43    }
44
45    /// Lays out a text [`Galley`] with Apple HIG optical tracking (`extra_letter_spacing`)
46    /// automatically applied from `self.typography().tracking_table`.
47    pub fn layout_tracked_galley(
48        &self,
49        ui: &Ui,
50        text: &str,
51        font_id: FontId,
52        color: Color32,
53        wrap_width: f32,
54    ) -> Arc<Galley> {
55        let mut job = egui::text::LayoutJob::single_section(
56            text.to_owned(),
57            self.tracked_text_format(font_id, color),
58        );
59        job.wrap.max_width = wrap_width;
60        ui.painter().layout_job(job)
61    }
62
63    /// Returns control metrics tokens.
64    pub fn control_metrics(&self) -> &MacControlMetrics { self.tokens.control_metrics() }
65    /// Returns button size and geometry tokens.
66    pub fn button(&self) -> &ButtonMetrics { &self.tokens.control_metrics().button }
67    /// Returns text field and input cell size/geometry tokens.
68    pub fn text_field(&self) -> &TextFieldMetrics { &self.tokens.control_metrics().text_field }
69    /// Returns segmented control geometry tokens.
70    pub fn segmented(&self) -> &SegmentedMetrics { &self.tokens.control_metrics().segmented }
71    /// Returns focus ring halo tokens.
72    pub fn focus_ring(&self) -> &FocusRingMetrics { &self.tokens.control_metrics().focus_ring }
73    /// Returns toolbar layout and hit-target tokens.
74    pub fn toolbar_metrics(&self) -> &ToolbarMetrics { self.tokens.toolbar_metrics() }
75    /// Returns popover and floating panel geometry tokens.
76    pub fn popover_metrics(&self) -> &PopoverMetrics { self.tokens.popover_metrics() }
77    /// Returns split view divider and pane geometry tokens.
78    pub fn split_view(&self) -> &SplitViewMetrics { self.tokens.split_view_metrics() }
79    /// Returns layout container metrics (`scroll_view`, `stack_view`).
80    pub fn layout_metrics(&self) -> &LayoutMetrics { self.tokens.layout_metrics() }
81    /// Returns scroll view overlay scrollbar geometry tokens.
82    pub fn scroll_view(&self) -> &ScrollViewMetrics { self.tokens.scroll_view_metrics() }
83    /// Returns stack view spacing, padding, and header tokens.
84    pub fn stack_view(&self) -> &StackViewMetrics { self.tokens.stack_view_metrics() }
85    /// Returns outline view row, indentation, and chevron tokens.
86    pub fn outline_view(&self) -> &OutlineViewMetrics { self.tokens.outline_view_metrics() }
87    /// Returns slider track, thumb, and tick tokens.
88    pub fn slider(&self) -> &SliderMetrics { self.tokens.slider_metrics() }
89    /// Returns thumbnail cell preview tokens.
90    pub fn thumbnail(&self) -> &ThumbnailCellMetrics { self.tokens.thumbnail_metrics() }
91    /// Returns pop-up button bezel and menu tokens.
92    pub fn popup_button(&self) -> &PopUpButtonMetrics { self.tokens.popup_button_metrics() }
93    /// Returns search field pill, icon, and clear button tokens.
94    pub fn search_field(&self) -> &SearchFieldMetrics { self.tokens.search_field_metrics() }
95    /// Returns numeric stepper control tokens.
96    pub fn stepper(&self) -> &StepperMetrics { self.tokens.stepper_metrics() }
97    /// Returns color well swatch and picker tokens.
98    pub fn color_well(&self) -> &ColorWellMetrics { self.tokens.color_well_metrics() }
99    /// Returns toggle switch (`NSSwitch`) tokens.
100    pub fn toggle(&self) -> &ToggleMetrics { self.tokens.toggle_metrics() }
101    /// Returns navigation and feedback metrics tokens.
102    pub fn navigation_metrics(&self) -> &NavigationMetrics { self.tokens.navigation_metrics() }
103    /// Returns menu bar and dropdown menu tokens.
104    pub fn menu_bar_metrics(&self) -> &MenuBarMetrics { self.tokens.menu_bar_metrics() }
105    /// Returns canvas footer bar tokens.
106    pub fn footer_metrics(&self) -> &FooterMetrics { self.tokens.footer_metrics() }
107    /// Returns Spotlight command palette tokens.
108    pub fn palette_metrics(&self) -> &PaletteMetrics { self.tokens.palette_metrics() }
109    /// Returns context menu popup tokens.
110    pub fn context_menu_metrics(&self) -> &ContextMenuMetrics { self.tokens.context_menu_metrics() }
111    /// Returns floating toast notification tokens.
112    pub fn toast_metrics(&self) -> &ToastMetrics { self.tokens.toast_metrics() }
113    /// Returns progress indicator bar and spinning fin tokens.
114    pub fn progress_indicator(&self) -> &ProgressIndicatorMetrics { self.tokens.progress_indicator_metrics() }
115    /// Returns table view and sortable header tokens.
116    pub fn table_view(&self) -> &TableViewMetrics { self.tokens.table_view_metrics() }
117    /// Returns token field pill capsule tokens.
118    pub fn token_field(&self) -> &TokenFieldMetrics { self.tokens.token_field_metrics() }
119    /// Returns level indicator VU meter tokens.
120    pub fn level_indicator(&self) -> &LevelIndicatorMetrics { self.tokens.level_indicator_metrics() }
121    /// Returns AVKit trim scrubber timeline tokens.
122    pub fn trim_scrubber(&self) -> &TrimScrubberMetrics { self.tokens.trim_scrubber_metrics() }
123    /// Returns path control breadcrumb bar tokens.
124    pub fn path_control(&self) -> &PathControlMetrics { self.tokens.path_control_metrics() }
125    /// Returns disclosure group & button tokens.
126    pub fn disclosure_group(&self) -> &DisclosureGroupMetrics { self.tokens.disclosure_group_metrics() }
127    /// Returns combo box tokens.
128    pub fn combo_box(&self) -> &ComboBoxMetrics { self.tokens.combo_box_metrics() }
129    /// Returns tab view tokens.
130    pub fn tab_view(&self) -> &TabViewMetrics { self.tokens.tab_view_metrics() }
131    /// Returns date picker tokens.
132    pub fn date_picker(&self) -> &DatePickerMetrics { self.tokens.date_picker_metrics() }
133    /// Returns collection view tokens.
134    pub fn collection_view(&self) -> &CollectionViewMetrics { self.tokens.collection_view_metrics() }
135    /// Returns player view tokens.
136    pub fn player_view(&self) -> &PlayerViewMetrics { self.tokens.player_view_metrics() }
137    /// Returns box view tokens.
138    pub fn box_view(&self) -> &BoxViewMetrics { self.tokens.box_view_metrics() }
139    /// Returns rule editor tokens.
140    pub fn rule_editor(&self) -> &RuleEditorMetrics { self.tokens.rule_editor_metrics() }
141    /// Returns square AppKit checkbox (`NSButtonTypeSwitch`) tokens.
142    pub fn checkbox(&self) -> &CheckboxMetrics { self.tokens.checkbox_metrics() }
143    /// Returns non-editable AppKit label (`NSTextField.labelWithString:`) tokens.
144    pub fn label_metrics(&self) -> &LabelMetrics { self.tokens.label_metrics() }
145    /// Returns circular AppKit help button (`NSBezelStyleHelpButton`) tokens.
146    pub fn help_button(&self) -> &HelpButtonMetrics { self.tokens.help_button_metrics() }
147    /// Returns circular inline action badge button (`16x16pt`) tokens.
148    pub fn inline_action_button(&self) -> &InlineActionButtonMetrics { self.tokens.inline_action_button_metrics() }
149    /// Returns typography and SF Pro optical tracking tokens.
150    pub fn typography(&self) -> &MacTypographyTokens { self.tokens.typography() }
151    /// Returns CoreAnimation spring physics preset tokens.
152    pub fn motion(&self) -> &MacMotionTokens { self.tokens.motion() }
153
154    /// Evaluates [`MacBackgroundStyle`] for the given background surface color.
155    pub fn background_style(&self, surface_bg: Color32) -> MacBackgroundStyle {
156        MacBackgroundStyle::from_color(surface_bg)
157    }
158    /// Evaluates [`MacBackgroundStyle`] for [`Self::control_accent`] (or custom accent override).
159    pub fn accent_background_style(&self) -> MacBackgroundStyle {
160        MacBackgroundStyle::from_color(self.control_accent())
161    }
162    /// Evaluates [`MacBackgroundStyle`] for [`Self::selected_control`].
163    pub fn selected_control_background_style(&self) -> MacBackgroundStyle {
164        MacBackgroundStyle::from_color(self.selected_control())
165    }
166    /// Returns disabled control opacity factor (`0.45`).
167    pub fn disabled_opacity(&self) -> f32 {
168        self.tokens.control_metrics().disabled_opacity.points()
169    }
170    /// Scales `color` alpha by [`Self::disabled_opacity`] when `enabled` is `false`.
171    pub fn apply_enabled(&self, color: Color32, enabled: bool) -> Color32 {
172        if enabled { color } else { color.gamma_multiply(self.disabled_opacity()) }
173    }
174
175    /// Renders an AppKit outer keyboard focus ring (`NSFocusRingPlacementOutside`) around `rect`.
176    pub fn paint_focus_ring(&self, painter: &egui::Painter, rect: egui::Rect, corner_radius: f32) {
177        let ring = self.focus_ring();
178        let focus_rect = rect.expand(ring.offset.points());
179        let focus_radius = corner_radius + ring.corner_radius_delta.points();
180        painter.rect_stroke(
181            focus_rect,
182            egui::CornerRadius::same(focus_radius as u8),
183            egui::Stroke::new(ring.stroke_width.points(), self.keyboard_focus_indicator()),
184            egui::StrokeKind::Outside,
185        );
186    }
187}
egui_macview/theme/accessors.rs

egui_macview/theme/
accessors.rs
