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
120
121
122
123
124
125
126
127
128
129
130
131

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum NativeUiPlatform {
    Windows,
    Macos,
    Linux,
    Android,
}

impl NativeUiPlatform {
    pub const fn platform_name(self) -> &'static str {
        match self {
            Self::Windows => "windows",
            Self::Macos => "macos",
            Self::Linux => "linux",
            Self::Android => "android",
        }
    }

    pub const fn current_target() -> Option<Self> {
        #[cfg(target_os = "windows")]
        {
            return Some(Self::Windows);
        }
        #[cfg(target_os = "macos")]
        {
            return Some(Self::Macos);
        }
        #[cfg(target_os = "android")]
        {
            return Some(Self::Android);
        }
        #[cfg(all(target_os = "linux", not(target_env = "ohos")))]
        {
            return Some(Self::Linux);
        }
        #[allow(unreachable_code)]
        None
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum NativeUiToolkit {
    WinitDesktop,
    Win32Gdi,
    AppKit,
    LinuxDirect,
    Gtk4Libadwaita,
    AndroidActivity,
}

impl NativeUiToolkit {
    pub const fn toolkit_name(self) -> &'static str {
        match self {
            Self::WinitDesktop => "winit_desktop",
            Self::Win32Gdi => "win32_gdi",
            Self::AppKit => "appkit",
            Self::LinuxDirect => "linux_direct",
            Self::Gtk4Libadwaita => "gtk4_libadwaita",
            Self::AndroidActivity => "android_activity",
        }
    }
}

pub const SUPPORTED_NATIVE_UI_PLATFORMS: [NativeUiPlatform; 4] = [
    NativeUiPlatform::Windows,
    NativeUiPlatform::Macos,
    NativeUiPlatform::Linux,
    NativeUiPlatform::Android,
];

pub const SUPPORTED_NATIVE_UI_TOOLKITS: [NativeUiToolkit; 5] = [
    NativeUiToolkit::Win32Gdi,
    NativeUiToolkit::AppKit,
    NativeUiToolkit::LinuxDirect,
    NativeUiToolkit::Gtk4Libadwaita,
    NativeUiToolkit::AndroidActivity,
];

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum NativeUiBackendStatus {
    NativeHostIntegrated,
    NativeHostFirstPass,
    AdapterBoundaryScaffold,
}

impl NativeUiBackendStatus {
    pub const fn status_name(self) -> &'static str {
        match self {
            Self::NativeHostIntegrated => "native_host_integrated",
            Self::NativeHostFirstPass => "native_host_first_pass",
            Self::AdapterBoundaryScaffold => "adapter_boundary_scaffold",
        }
    }

    pub const fn is_native_runtime_ready(self) -> bool {
        matches!(self, Self::NativeHostIntegrated)
    }

    pub const fn is_scaffold(self) -> bool {
        matches!(self, Self::AdapterBoundaryScaffold)
    }

    pub const fn is_first_pass_native_host(self) -> bool {
        matches!(self, Self::NativeHostFirstPass)
    }
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
pub struct NativeUiBackendDescriptor {
    pub platform: NativeUiPlatform,
    pub toolkit: NativeUiToolkit,
    pub status: NativeUiBackendStatus,
    pub adapter_boundary: &'static str,
    pub module_path: &'static str,
}

impl NativeUiBackendDescriptor {
    pub const fn platform_name(&self) -> &'static str {
        self.platform.platform_name()
    }

    pub const fn toolkit_name(&self) -> &'static str {
        self.toolkit.toolkit_name()
    }

    pub const fn status_name(&self) -> &'static str {
        self.status.status_name()
    }
}