zsui 0.3.0-alpha.2

Rust-first feature-gated native UI framework for Win32, AppKit, and Linux.
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

use serde::{Deserialize, Serialize};

/// Deterministic desktop design profile used by low-level render contracts.
///
/// Ordinary applications declare semantic components and theme tokens instead
/// of selecting this profile. The framework resolves the current value through
/// its private platform experience, while render/proof code can select a
/// profile explicitly to produce deterministic platform evidence.
///
/// A future backend may reuse an existing design profile or add its mapping in
/// the platform experience without introducing another component-specific
/// platform enum.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum ZsPlatformStyle {
    Windows,
    Macos,
    Gtk,
}

impl ZsPlatformStyle {
    /// Resolves the design profile registered for the current build target.
    pub const fn current() -> Self {
        match crate::platform_experience::PlatformExperience::current() {
            Some(experience) => match experience.shared_component_style() {
                Some(style) => style,
                None => Self::Windows,
            },
            None => Self::Windows,
        }
    }

    pub const fn typography(self) -> Self {
        self
    }

    #[cfg(feature = "tabs")]
    pub const fn arrow_selects(self) -> bool {
        crate::platform_component_profile::PlatformComponentProfile::for_style(self)
            .tabs
            .arrow_selects
    }

    #[cfg(feature = "tabs")]
    pub const fn supports_home_end_focus(self) -> bool {
        crate::platform_component_profile::PlatformComponentProfile::for_style(self)
            .tabs
            .supports_home_end_focus
    }

    #[cfg(feature = "time-picker")]
    pub const fn default_clock(self) -> crate::ZsClockFormat {
        crate::platform_component_profile::PlatformTimePickerProfile::for_platform(self)
            .default_clock
    }

    #[cfg(feature = "password-box")]
    pub const fn default_password_reveal_mode(self) -> crate::ZsPasswordRevealMode {
        crate::platform_component_profile::PlatformPasswordBoxProfile::for_platform(self)
            .default_reveal_mode
    }
}

#[cfg(test)]
mod tests {
    use super::ZsPlatformStyle;

    #[test]
    fn shared_profile_preserves_typography_identity() {
        assert_eq!(
            ZsPlatformStyle::Windows.typography(),
            ZsPlatformStyle::Windows
        );
    }

    #[cfg(feature = "tabs")]
    #[test]
    fn shared_profile_delegates_tab_interaction_conventions() {
        assert!(!ZsPlatformStyle::Windows.arrow_selects());
        assert!(ZsPlatformStyle::Macos.arrow_selects());
        assert!(!ZsPlatformStyle::Gtk.arrow_selects());
        assert!(!ZsPlatformStyle::Windows.supports_home_end_focus());
        assert!(!ZsPlatformStyle::Macos.supports_home_end_focus());
        assert!(ZsPlatformStyle::Gtk.supports_home_end_focus());
    }

    #[cfg(feature = "time-picker")]
    #[test]
    fn shared_profile_preserves_clock_defaults() {
        assert_eq!(
            ZsPlatformStyle::Windows.default_clock(),
            crate::ZsClockFormat::TwelveHour
        );
        assert_eq!(
            ZsPlatformStyle::Macos.default_clock(),
            crate::ZsClockFormat::TwentyFourHour
        );
        assert_eq!(
            ZsPlatformStyle::Gtk.default_clock(),
            crate::ZsClockFormat::TwentyFourHour
        );
    }

    #[cfg(feature = "password-box")]
    #[test]
    fn shared_profile_preserves_password_reveal_defaults() {
        assert_eq!(
            ZsPlatformStyle::Windows.default_password_reveal_mode(),
            crate::ZsPasswordRevealMode::Peek
        );
        assert_eq!(
            ZsPlatformStyle::Macos.default_password_reveal_mode(),
            crate::ZsPasswordRevealMode::Hidden
        );
        assert_eq!(
            ZsPlatformStyle::Gtk.default_password_reveal_mode(),
            crate::ZsPasswordRevealMode::Hidden
        );
    }
}