argui-platform 0.2.1

Native platform integrations for Argui applications
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

use argui_platform::{
    AppIcon, ApplicationId, ApplicationIdentity, IconSet, WindowBackend, WindowConfig, WindowKey,
    WindowLevel, WindowSpec,
};

#[test]
fn default_window_is_a_decorated_resizable_surface() {
    let config = WindowConfig::default();

    assert_eq!(config.title, "Argui");
    assert!(config.decorations);
    assert!(config.resizable);
    assert!(!config.transparent);
    assert_eq!(config.desktop_backdrop, None);
    assert!(!config.native_shadow);
    assert_eq!(config.level, WindowLevel::Normal);
    assert!(config.append_to_document);
    assert_eq!(config.safe_area_insets, None);
    let _attributes = config.into_attributes();
}

#[test]
fn window_safe_area_override_uses_logical_insets() {
    let insets = argui_platform::Insets::new(24.0, 0.0, 30.0, 0.0);
    let config = WindowConfig::default().with_safe_area_insets(insets);

    assert_eq!(config.safe_area_insets, Some(insets));
    let _attributes = config.into_attributes();
}

#[test]
fn desktop_materials_opt_into_window_transparency() {
    assert_eq!(
        argui_core::BackdropMaterial::default(),
        argui_core::BackdropMaterial::Glass
    );
    for material in [
        argui_core::BackdropMaterial::Glass,
        argui_core::BackdropMaterial::Sidebar,
        argui_core::BackdropMaterial::Header,
    ] {
        let attributes = WindowConfig {
            desktop_backdrop: Some(material),
            ..WindowConfig::default()
        }
        .into_attributes();
        assert!(attributes.transparent);
    }
}

#[test]
fn capabilities_expose_real_backend_limits() {
    let wayland = WindowBackend::Wayland.capabilities();
    assert!(wayland.native_drag);
    assert!(!wayland.native_shadow);
    assert!(wayland.mouse_passthrough);
    assert!(!wayland.window_level);

    for backend in [
        WindowBackend::Windows,
        WindowBackend::MacOs,
        WindowBackend::X11,
    ] {
        let capabilities = backend.capabilities();
        assert!(capabilities.native_drag);
        assert!(capabilities.minimize);
        assert!(capabilities.maximize);
        assert!(capabilities.window_level);
        assert!(capabilities.mouse_passthrough);
    }
    assert!(WindowBackend::Windows.capabilities().native_shadow);
    assert!(WindowBackend::MacOs.capabilities().native_shadow);

    for backend in [WindowBackend::Android, WindowBackend::Ios] {
        let capabilities = backend.capabilities();
        assert_eq!(capabilities.backend, backend);
        assert!(!capabilities.native_drag);
        assert!(!capabilities.native_shadow);
        assert!(!capabilities.minimize);
        assert!(!capabilities.maximize);
        assert!(!capabilities.window_level);
        assert!(!capabilities.mouse_passthrough);
    }

    assert_eq!(
        WindowBackend::Web.capabilities(),
        argui_platform::WindowCapabilities {
            backend: WindowBackend::Web,
            native_drag: false,
            native_shadow: false,
            minimize: false,
            maximize: false,
            window_level: false,
            mouse_passthrough: false,
        }
    );
}

#[test]
fn window_attributes_inherit_identity_and_accept_native_icons() {
    let identity_without_icon = ApplicationIdentity::new(
        ApplicationId::new("dev.argui.window").unwrap(),
        "Identity title",
        IconSet::new(),
    );
    let _inherited = WindowConfig {
        title: String::new(),
        ..WindowConfig::default()
    }
    .into_attributes_with_identity(&identity_without_icon);

    let icon = AppIcon::from_rgba8(2, 2, vec![255; 2 * 2 * 4]).unwrap();
    let identity_with_icon = ApplicationIdentity::new(
        ApplicationId::new("dev.argui.icon-window").unwrap(),
        "Fallback title",
        IconSet::new().with(icon),
    );
    let _explicit = WindowConfig {
        title: "Explicit title".into(),
        ..WindowConfig::default()
    }
    .into_attributes_with_identity(&identity_with_icon);

    let spec = WindowSpec::new(WindowKey::new("secondary"), WindowConfig::default());
    assert_eq!(spec.key.as_str(), "secondary");
    assert!(spec.visible);
}