waterui-cli 0.3.2

Cross-platform tooling for WaterUI 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

//! Apple platform support.

/// Apple backend implementation.
pub mod backend;
/// Apple device detection and management.
pub mod device;
pub(crate) mod dynamic_runtime;
/// macOS local device gestures and screenshot.
#[cfg(target_os = "macos")]
pub mod local;
/// Non-macOS stub for local Apple automation APIs.
#[cfg(not(target_os = "macos"))]
pub mod local {
    use std::path::Path;

    use eyre::eyre;

    use crate::toolchain::Host;

    /// Information about a macOS window.
    #[derive(Debug, Clone)]
    pub struct WindowInfo {
        /// The window ID (used for screencapture -l).
        pub window_id: u32,
        /// The window title/name.
        pub name: String,
        /// The owning process ID.
        pub owner_pid: i32,
        /// The owning application name.
        pub owner_name: String,
        /// Window layer (0 = normal windows).
        pub layer: i32,
    }

    fn unsupported() -> eyre::Report {
        eyre!("apple::local is only supported on macOS")
    }

    fn unsupported_async<T>() -> impl std::future::Future<Output = eyre::Result<T>> {
        std::future::ready(Err(unsupported()))
    }

    /// Stub: local window enumeration is unavailable outside macOS.
    ///
    /// # Errors
    ///
    /// Always returns an unsupported-platform error.
    pub fn list_windows_by_pid(_pid: i32) -> eyre::Result<Vec<WindowInfo>> {
        Err(unsupported())
    }

    /// Stub: local screenshot is unavailable outside macOS.
    pub fn screenshot(
        _host: &Host,
        _output: &Path,
    ) -> impl std::future::Future<Output = eyre::Result<()>> {
        unsupported_async()
    }

    /// Stub: local screenshot is unavailable outside macOS.
    pub fn screenshot_bytes(
        _host: &Host,
    ) -> impl std::future::Future<Output = eyre::Result<Vec<u8>>> {
        unsupported_async()
    }

    /// Stub: local screenshot is unavailable outside macOS.
    pub fn screenshot_window(
        _host: &Host,
        _window_id: u32,
        _output: &Path,
    ) -> impl std::future::Future<Output = eyre::Result<()>> {
        unsupported_async()
    }

    /// Stub: local screenshot is unavailable outside macOS.
    pub fn screenshot_window_bytes(
        _host: &Host,
        _window_id: u32,
    ) -> impl std::future::Future<Output = eyre::Result<Vec<u8>>> {
        unsupported_async()
    }

    /// Stub: local tap is unavailable outside macOS.
    pub fn tap(
        _host: &Host,
        _x: u32,
        _y: u32,
    ) -> impl std::future::Future<Output = eyre::Result<()>> {
        unsupported_async()
    }

    /// Stub: local swipe is unavailable outside macOS.
    pub fn swipe(
        _host: &Host,
        _from: (u32, u32),
        _to: (u32, u32),
        _duration_ms: Option<u32>,
    ) -> impl std::future::Future<Output = eyre::Result<()>> {
        unsupported_async()
    }

    /// Stub: local text input is unavailable outside macOS.
    pub fn text(_host: &Host, _input: &str) -> impl std::future::Future<Output = eyre::Result<()>> {
        unsupported_async()
    }
}
/// Apple platform configuration.
pub mod physical;
pub mod platform;
/// Apple toolchain management.
pub mod toolchain;