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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
use crate::core::window::{Icon, Id, Level, Mode, Settings, UserAttention};
use crate::core::{Point, Size};
use crate::futures::MaybeSend;
use crate::window::Screenshot;

use raw_window_handle::WindowHandle;

use std::fmt;

/// An operation to be performed on some window.
pub enum Action<T> {
    /// Spawns a new window with some [`Settings`].
    Spawn(Id, Settings),
    /// Close the window and exits the application.
    Close(Id),
    /// Move the window with the left mouse button until the button is
    /// released.
    ///
    /// There’s no guarantee that this will work unless the left mouse
    /// button was pressed immediately before this function is called.
    Drag(Id),
    /// Resize the window to the given logical dimensions.
    Resize(Id, Size),
    /// Fetch the current logical dimensions of the window.
    FetchSize(Id, Box<dyn FnOnce(Size) -> T + 'static>),
    /// Fetch if the current window is maximized or not.
    ///
    /// ## Platform-specific
    /// - **iOS / Android / Web:** Unsupported.
    FetchMaximized(Id, Box<dyn FnOnce(bool) -> T + 'static>),
    /// Set the window to maximized or back
    Maximize(Id, bool),
    /// Fetch if the current window is minimized or not.
    ///
    /// ## Platform-specific
    /// - **Wayland:** Always `None`.
    /// - **iOS / Android / Web:** Unsupported.
    FetchMinimized(Id, Box<dyn FnOnce(Option<bool>) -> T + 'static>),
    /// Set the window to minimized or back
    Minimize(Id, bool),
    /// Fetch the current logical coordinates of the window.
    FetchPosition(Id, Box<dyn FnOnce(Option<Point>) -> T + 'static>),
    /// Move the window to the given logical coordinates.
    ///
    /// Unsupported on Wayland.
    Move(Id, Point),
    /// Change the [`Mode`] of the window.
    ChangeMode(Id, Mode),
    /// Fetch the current [`Mode`] of the window.
    FetchMode(Id, Box<dyn FnOnce(Mode) -> T + 'static>),
    /// Toggle the window to maximized or back
    ToggleMaximize(Id),
    /// Toggle whether window has decorations.
    ///
    /// ## Platform-specific
    /// - **X11:** Not implemented.
    /// - **Web:** Unsupported.
    ToggleDecorations(Id),
    /// Request user attention to the window, this has no effect if the application
    /// is already focused. How requesting for user attention manifests is platform dependent,
    /// see [`UserAttention`] for details.
    ///
    /// Providing `None` will unset the request for user attention. Unsetting the request for
    /// user attention might not be done automatically by the WM when the window receives input.
    ///
    /// ## Platform-specific
    ///
    /// - **iOS / Android / Web:** Unsupported.
    /// - **macOS:** `None` has no effect.
    /// - **X11:** Requests for user attention must be manually cleared.
    /// - **Wayland:** Requires `xdg_activation_v1` protocol, `None` has no effect.
    RequestUserAttention(Id, Option<UserAttention>),
    /// Bring the window to the front and sets input focus. Has no effect if the window is
    /// already in focus, minimized, or not visible.
    ///
    /// This method steals input focus from other applications. Do not use this method unless
    /// you are certain that's what the user wants. Focus stealing can cause an extremely disruptive
    /// user experience.
    ///
    /// ## Platform-specific
    ///
    /// - **Web / Wayland:** Unsupported.
    GainFocus(Id),
    /// Change the window [`Level`].
    ChangeLevel(Id, Level),
    /// Show the system menu at cursor position.
    ///
    /// ## Platform-specific
    /// Android / iOS / macOS / Orbital / Web / X11: Unsupported.
    ShowSystemMenu(Id),
    /// Fetch the raw identifier unique to the window.
    FetchId(Id, Box<dyn FnOnce(u64) -> T + 'static>),
    /// Change the window [`Icon`].
    ///
    /// On Windows and X11, this is typically the small icon in the top-left
    /// corner of the titlebar.
    ///
    /// ## Platform-specific
    ///
    /// - **Web / Wayland / macOS:** Unsupported.
    ///
    /// - **Windows:** Sets `ICON_SMALL`. The base size for a window icon is 16x16, but it's
    ///   recommended to account for screen scaling and pick a multiple of that, i.e. 32x32.
    ///
    /// - **X11:** Has no universal guidelines for icon sizes, so you're at the whims of the WM. That
    ///   said, it's usually in the same ballpark as on Windows.
    ChangeIcon(Id, Icon),
    /// Runs the closure with the native window handle of the window with the given [`Id`].
    RunWithHandle(Id, Box<dyn FnOnce(&WindowHandle<'_>) -> T + 'static>),
    /// Screenshot the viewport of the window.
    Screenshot(Id, Box<dyn FnOnce(Screenshot) -> T + 'static>),
}

impl<T> Action<T> {
    /// Maps the output of a window [`Action`] using the provided closure.
    pub fn map<A>(
        self,
        f: impl Fn(T) -> A + 'static + MaybeSend + Sync,
    ) -> Action<A>
    where
        T: 'static,
    {
        match self {
            Self::Spawn(id, settings) => Action::Spawn(id, settings),
            Self::Close(id) => Action::Close(id),
            Self::Drag(id) => Action::Drag(id),
            Self::Resize(id, size) => Action::Resize(id, size),
            Self::FetchSize(id, o) => {
                Action::FetchSize(id, Box::new(move |s| f(o(s))))
            }
            Self::FetchMaximized(id, o) => {
                Action::FetchMaximized(id, Box::new(move |s| f(o(s))))
            }
            Self::Maximize(id, maximized) => Action::Maximize(id, maximized),
            Self::FetchMinimized(id, o) => {
                Action::FetchMinimized(id, Box::new(move |s| f(o(s))))
            }
            Self::Minimize(id, minimized) => Action::Minimize(id, minimized),
            Self::FetchPosition(id, o) => {
                Action::FetchPosition(id, Box::new(move |s| f(o(s))))
            }
            Self::Move(id, position) => Action::Move(id, position),
            Self::ChangeMode(id, mode) => Action::ChangeMode(id, mode),
            Self::FetchMode(id, o) => {
                Action::FetchMode(id, Box::new(move |s| f(o(s))))
            }
            Self::ToggleMaximize(id) => Action::ToggleMaximize(id),
            Self::ToggleDecorations(id) => Action::ToggleDecorations(id),
            Self::RequestUserAttention(id, attention_type) => {
                Action::RequestUserAttention(id, attention_type)
            }
            Self::GainFocus(id) => Action::GainFocus(id),
            Self::ChangeLevel(id, level) => Action::ChangeLevel(id, level),
            Self::ShowSystemMenu(id) => Action::ShowSystemMenu(id),
            Self::FetchId(id, o) => {
                Action::FetchId(id, Box::new(move |s| f(o(s))))
            }
            Self::ChangeIcon(id, icon) => Action::ChangeIcon(id, icon),
            Self::RunWithHandle(id, o) => {
                Action::RunWithHandle(id, Box::new(move |s| f(o(s))))
            }
            Self::Screenshot(id, tag) => Action::Screenshot(
                id,
                Box::new(move |screenshot| f(tag(screenshot))),
            ),
        }
    }
}

impl<T> fmt::Debug for Action<T> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Spawn(id, settings) => {
                write!(f, "Action::Spawn({id:?}, {settings:?})")
            }
            Self::Close(id) => write!(f, "Action::Close({id:?})"),
            Self::Drag(id) => write!(f, "Action::Drag({id:?})"),
            Self::Resize(id, size) => {
                write!(f, "Action::Resize({id:?}, {size:?})")
            }
            Self::FetchSize(id, _) => write!(f, "Action::FetchSize({id:?})"),
            Self::FetchMaximized(id, _) => {
                write!(f, "Action::FetchMaximized({id:?})")
            }
            Self::Maximize(id, maximized) => {
                write!(f, "Action::Maximize({id:?}, {maximized})")
            }
            Self::FetchMinimized(id, _) => {
                write!(f, "Action::FetchMinimized({id:?})")
            }
            Self::Minimize(id, minimized) => {
                write!(f, "Action::Minimize({id:?}, {minimized}")
            }
            Self::FetchPosition(id, _) => {
                write!(f, "Action::FetchPosition({id:?})")
            }
            Self::Move(id, position) => {
                write!(f, "Action::Move({id:?}, {position})")
            }
            Self::ChangeMode(id, mode) => {
                write!(f, "Action::SetMode({id:?}, {mode:?})")
            }
            Self::FetchMode(id, _) => write!(f, "Action::FetchMode({id:?})"),
            Self::ToggleMaximize(id) => {
                write!(f, "Action::ToggleMaximize({id:?})")
            }
            Self::ToggleDecorations(id) => {
                write!(f, "Action::ToggleDecorations({id:?})")
            }
            Self::RequestUserAttention(id, _) => {
                write!(f, "Action::RequestUserAttention({id:?})")
            }
            Self::GainFocus(id) => write!(f, "Action::GainFocus({id:?})"),
            Self::ChangeLevel(id, level) => {
                write!(f, "Action::ChangeLevel({id:?}, {level:?})")
            }
            Self::ShowSystemMenu(id) => {
                write!(f, "Action::ShowSystemMenu({id:?})")
            }
            Self::FetchId(id, _) => write!(f, "Action::FetchId({id:?})"),
            Self::ChangeIcon(id, _icon) => {
                write!(f, "Action::ChangeIcon({id:?})")
            }
            Self::RunWithHandle(id, _) => {
                write!(f, "Action::RunWithHandle({id:?})")
            }
            Self::Screenshot(id, _) => write!(f, "Action::Screenshot({id:?})"),
        }
    }
}