egui-macview 0.6.0

Cross-platform macOS AppKit Layout Engine, Authentic Control Primitive Suite, and CoreAnimation Physics Runtime for egui on Windows 11, macOS, Linux, and Web.
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

#![doc = include_str!("../README.md")]
//!
//! Grounded in Apple AppKit, macOS Human Interface Guidelines (HIG), and W3C DTCG Design Tokens.
//!
//! # Architecture & Highlights
//!
//! - **Authentic Control Primitives**: Complete macOS AppKit controls including [`MacToggle`], [`MacSlider`],
//!   [`MacSegmentedControl`], [`MacPopUpButton`], [`MacSearchField`], [`MacStepper`], [`MacColorWell`],
//!   [`MacOutlineView`], [`MacButtonCell`], [`MacInputCell`], and [`MacThumbnailCell`].
//! - **Deterministic Layout Engines**: Subpixel-snapped linear [`MacStackView`] (`NSStackView`), draggable hairline [`MacSplitView`] (`NSSplitView`),
//!   zero-gutter floating overlay [`MacScrollView`] (`NSScrollView`), absolute [`MacFixedView`], and autolayout [`MacRow`].
//! - **CoreAnimation Physics**: Analytical spring physics runtime [`CASpring`] matching Apple's `CASpringAnimation`
//!   and SwiftUI `.spring(response:dampingRatio:)` with analytical displacement and velocity calculations.
//! - **W3C DTCG Token Catalog & Theming**: Dynamic theming via [`MacTheme`] and [`MacAppearance`] supporting Aqua and DarkAqua
//!   appearances, configurable window control decorations via [`WindowControlsStyle`], and dynamic system accent colors.
//! - **Subpixel Snapping**: Physical pixel boundary rounding via [`subpixel_snap`], [`subpixel_snap_pos`], and [`subpixel_snap_rect`].
//!
//! # Quick Start Example
//!
//! ```rust
//! use egui_macview::{
//!     CASpring, MacAppearance, MacSlider, MacStackView, MacTheme, MacToggle,
//! };
//!
//! # let ctx = egui::Context::default();
//! # let mut output = ctx.run_ui(egui::RawInput::default(), |ui| {
//! // 1. Initialize macOS dynamic theme (Aqua or DarkAqua)
//! let theme = MacTheme::new(MacAppearance::DarkAqua);
//!
//! // 2. Assemble controls inside an NSStackView linear layout
//! let mut enabled = true;
//! let mut volume = 75.0f32;
//!
//! MacStackView::vertical()
//!     .theme(&theme)
//!     .show_separators(true)
//!     .show(ui, |stack| {
//!         stack.add(|ui| {
//!             ui.add(MacToggle::new(&mut enabled).theme(&theme));
//!         });
//!         stack.add(|ui| {
//!             MacSlider::new(&mut volume, 0.0..=100.0)
//!                 .theme(&theme)
//!                 .ticks(5, true)
//!                 .show(ui);
//!         });
//!     });
//!
//! // 3. Analytical spring physics evaluation
//! let spring = CASpring::new(0.35, 0.85);
//! let displacement = spring.evaluate(0.15); // t = 150ms
//! # assert!(displacement > 0.0);
//! # });
//! # output.textures_delta.clear();
//! ```

#![deny(missing_docs)]

/// Crate release version string extracted from `Cargo.toml`.
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

pub mod controls;
pub mod feedback;
pub mod layout;
pub mod motion;
pub mod navigation;
pub mod state;
pub mod surfaces;
pub mod symbols;
pub mod theme;
pub mod tokens;

pub use symbols::{
    setup_symbols_font, MacSymbol, CUPERTINO_ICONS_FONT_BYTES, CUPERTINO_ICONS_FONT_NAME,
};

pub use theme::{
    contrast_ratio, relative_luminance, MacAppearance, MacBackgroundStyle, MacTheme,
    WindowControlsStyle,
};

pub use controls::{
    calculate_pan_weights, MacBox, MacButtonCell, MacCircularSlider, MacCollectionView,
    MacCollectionViewFlowLayout, MacColorWell, MacComboBox, MacControlSize, MacDate, MacDatePicker,
    MacDatePickerElementFlags, MacDatePickerStyle, MacDisclosureButton, MacDisclosureGroup,
    MacInputCell, MacLevelIndicator, MacLevelIndicatorStyle, MacLevelOrientation, MacOutlineRow,
    MacOutlineRowResponse, MacOutlineTree, MacOutlineView, MacPathComponent, MacPathControl,
    MacPathControlResponse, MacPlayerControlsStyle, MacPlayerView, MacPopUpButton,
    MacProgressControlSize, MacProgressIndicator, MacProgressStyle, MacRatingIndicator,
    MacSearchField, MacSegmentedControl, MacSlider, MacSortDirection, MacStepper, MacTabItem,
    MacTabStyle, MacTabView, MacTableColumn, MacTableView, MacTableViewOutput, MacTableViewResponse,
    MacThumbnailCell, MacTimelineZone, MacToggle, MacTokenField, MacTrimScrubber,
    MacTrimScrubberResponse, UNIT_STAR, MacInsets,
};
pub use feedback::{clamp_menu_rect, MacContextMenu, MacToast, MacToastManager, ToastLevel};
pub use layout::{
    is_window_active, subpixel_snap, subpixel_snap_pos, subpixel_snap_rect, MacFixedView, MacForm,
    MacFormUi, MacFrame, MacRow, MacScrollView, MacScrollViewOutput, MacSplitOrientation,
    MacSplitView, MacStackAlignment, MacStackOrientation, MacStackUi, MacStackView,
    MacStackViewOutput,
};
pub use motion::CASpring;
pub use navigation::{
    CommandPaletteItem, MacCanvasFooter, MacCanvasFooterAction, MacCommandPalette,
    MacKeyboardShortcut, MacMenuBar, MacMenuItemKind, MacToolbar, MacToolbarResponse, NSMenu,
    NSMenuItem, CANVAS_FOOTER_HEIGHT, COMMAND_PALETTE_HEIGHT, COMMAND_PALETTE_WIDTH,
};
pub use state::{NSUndoManager, DEFAULT_UNDO_CAPACITY};
pub use surfaces::{MacCard, MacFloatingInfoBox, MacPanel, MacPopover, MacPopoverArrowEdge};
pub use tokens::{
    sf_pro_tracking, ColorWellMetrics, LayoutMetrics, LevelIndicatorMetrics, MacColorTokens,
    MacControlMetrics, MacDesignTokens, MacMotionTokens, MacTypographyTokens, OutlineViewMetrics,
    PathControlMetrics, PopUpButtonMetrics, ProgressIndicatorMetrics, ProgressSizeMetrics,
    ScrollViewMetrics, SearchFieldMetrics, SliderMetrics, SplitViewMetrics, StackViewMetrics,
    StepperMetrics, TableViewMetrics, ThumbnailCellMetrics, ToggleMetrics, TokenFieldMetrics,
    TrimScrubberMetrics,
};