@decaf-ts/for-os 0.0.0-stage → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +21 -0
- package/README.md +380 -2
- package/lib/cjs/errors.cjs +73 -0
- package/lib/cjs/errors.cjs.map +1 -0
- package/lib/cjs/index.cjs +46 -0
- package/lib/cjs/index.cjs.map +1 -0
- package/lib/cjs/native/icons.cjs +123 -0
- package/lib/cjs/native/icons.cjs.map +1 -0
- package/lib/cjs/native/loader.cjs +123 -0
- package/lib/cjs/native/loader.cjs.map +1 -0
- package/lib/cjs/native/types.cjs +4 -0
- package/lib/cjs/native/types.cjs.map +1 -0
- package/lib/cjs/notifications/NotificationCenter.cjs +328 -0
- package/lib/cjs/notifications/NotificationCenter.cjs.map +1 -0
- package/lib/cjs/tray/TrayIcon.cjs +367 -0
- package/lib/cjs/tray/TrayIcon.cjs.map +1 -0
- package/lib/cjs/tray/assets.cjs +31 -0
- package/lib/cjs/tray/assets.cjs.map +1 -0
- package/lib/esm/errors.js +65 -0
- package/lib/esm/errors.js.map +1 -0
- package/lib/esm/index.js +28 -0
- package/lib/esm/index.js.map +1 -0
- package/lib/esm/native/icons.js +117 -0
- package/lib/esm/native/icons.js.map +1 -0
- package/lib/esm/native/loader.js +116 -0
- package/lib/esm/native/loader.js.map +1 -0
- package/lib/esm/native/types.js +8 -0
- package/lib/esm/native/types.js.map +1 -0
- package/lib/esm/notifications/NotificationCenter.js +322 -0
- package/lib/esm/notifications/NotificationCenter.js.map +1 -0
- package/lib/esm/tray/TrayIcon.js +362 -0
- package/lib/esm/tray/TrayIcon.js.map +1 -0
- package/lib/esm/tray/assets.js +26 -0
- package/lib/esm/tray/assets.js.map +1 -0
- package/lib/types/errors.d.cts +56 -0
- package/lib/types/errors.d.mts +56 -0
- package/lib/types/index.d.cts +27 -0
- package/lib/types/index.d.mts +27 -0
- package/lib/types/native/icons.d.cts +71 -0
- package/lib/types/native/icons.d.mts +71 -0
- package/lib/types/native/loader.d.cts +37 -0
- package/lib/types/native/loader.d.mts +37 -0
- package/lib/types/native/types.d.cts +104 -0
- package/lib/types/native/types.d.mts +104 -0
- package/lib/types/notifications/NotificationCenter.d.cts +163 -0
- package/lib/types/notifications/NotificationCenter.d.mts +163 -0
- package/lib/types/tray/TrayIcon.d.cts +174 -0
- package/lib/types/tray/TrayIcon.d.mts +174 -0
- package/lib/types/tray/assets.d.cts +25 -0
- package/lib/types/tray/assets.d.mts +25 -0
- package/native/tray-icon-node/Cargo.lock +1511 -0
- package/native/tray-icon-node/Cargo.toml +45 -0
- package/native/tray-icon-node/Cross.toml +10 -0
- package/native/tray-icon-node/LICENSE +21 -0
- package/native/tray-icon-node/UPSTREAM-README.md +281 -0
- package/native/tray-icon-node/UPSTREAM.md +213 -0
- package/native/tray-icon-node/build-manifest.json +16 -0
- package/native/tray-icon-node/build.rs +5 -0
- package/native/tray-icon-node/index.d.ts +368 -0
- package/native/tray-icon-node/index.js +609 -0
- package/native/tray-icon-node/package.json +55 -0
- package/native/tray-icon-node/rustfmt.toml +31 -0
- package/native/tray-icon-node/source-manifest.json +30 -0
- package/native/tray-icon-node/src/common.rs +101 -0
- package/native/tray-icon-node/src/icon.rs +255 -0
- package/native/tray-icon-node/src/lib.rs +449 -0
- package/native/tray-icon-node/src/menu.rs +849 -0
- package/native/tray-icon-node/src/tray.rs +251 -0
- package/native/tray-icon-node/tray-icon-node.linux-x64-gnu.node +0 -0
- package/package.json +131 -4
- package/scripts/for-os-build.mjs +60 -0
- package/scripts/for-os-init.mjs +327 -0
- package/scripts/for-os-install.mjs +47 -0
- package/scripts/for-os-integration.mjs +137 -0
- package/scripts/for-os-integrity.mjs +51 -0
- package/scripts/for-os-package.mjs +49 -0
- package/scripts/lib/native.mjs +591 -0
|
@@ -0,0 +1,849 @@
|
|
|
1
|
+
use crate::icon::Icon;
|
|
2
|
+
use napi::bindgen_prelude::*;
|
|
3
|
+
use napi_derive::napi;
|
|
4
|
+
use std::collections::HashMap;
|
|
5
|
+
use std::sync::{Arc, Mutex};
|
|
6
|
+
use tray_icon::menu as tray_menu;
|
|
7
|
+
|
|
8
|
+
pub enum AnyMenuItem {
|
|
9
|
+
Standard(tray_menu::MenuItem),
|
|
10
|
+
Check(tray_menu::CheckMenuItem),
|
|
11
|
+
Icon(tray_menu::IconMenuItem),
|
|
12
|
+
Submenu(Submenu),
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
// SAFETY: All variants of `AnyMenuItem` wrap types from the `tray-icon` crate,
|
|
16
|
+
// which guarantees `Send + Sync` safety across all supported platforms (Windows, macOS, Linux).
|
|
17
|
+
// The underlying OS handles (HMENU, NSMenu, GtkMenu) are reference-counted and safe to move
|
|
18
|
+
// between threads for read-only operations. Mutable access is protected by the `Mutex` in `Menu`.
|
|
19
|
+
#[allow(clippy::non_send_fields_in_send_ty)]
|
|
20
|
+
unsafe impl Send for AnyMenuItem {}
|
|
21
|
+
#[allow(clippy::non_send_fields_in_send_ty)]
|
|
22
|
+
unsafe impl Sync for AnyMenuItem {}
|
|
23
|
+
|
|
24
|
+
#[inline]
|
|
25
|
+
fn lock_registry(
|
|
26
|
+
reg: &Mutex<HashMap<String, AnyMenuItem>>,
|
|
27
|
+
) -> std::sync::MutexGuard<'_, HashMap<String, AnyMenuItem>> {
|
|
28
|
+
reg.lock().unwrap_or_else(|poisoned| poisoned.into_inner())
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
#[inline]
|
|
32
|
+
pub(crate) fn next_checked_state(current: bool) -> bool {
|
|
33
|
+
!current
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
#[napi]
|
|
37
|
+
pub struct Menu {
|
|
38
|
+
pub(crate) inner: tray_menu::Menu,
|
|
39
|
+
pub(crate) registry: Arc<Mutex<HashMap<String, AnyMenuItem>>>,
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
#[napi]
|
|
43
|
+
impl Menu {
|
|
44
|
+
#[napi(constructor)]
|
|
45
|
+
pub fn new() -> Self {
|
|
46
|
+
Self {
|
|
47
|
+
inner: tray_menu::Menu::new(),
|
|
48
|
+
registry: Arc::new(Mutex::new(HashMap::new())),
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
fn register(&self, id: String, item: AnyMenuItem) {
|
|
53
|
+
let mut reg = lock_registry(&self.registry);
|
|
54
|
+
reg.insert(id, item);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/// Appends a checkable menu item to this menu.
|
|
58
|
+
///
|
|
59
|
+
/// # Errors
|
|
60
|
+
///
|
|
61
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
62
|
+
#[napi]
|
|
63
|
+
pub fn append_check_menu_item(&self, item: &CheckMenuItem, id: String) -> Result<()> {
|
|
64
|
+
self.inner
|
|
65
|
+
.append(&item.0)
|
|
66
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
67
|
+
|
|
68
|
+
self.register(id, AnyMenuItem::Check(item.0.clone()));
|
|
69
|
+
Ok(())
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/// Appends a standard menu item to this menu.
|
|
73
|
+
///
|
|
74
|
+
/// # Errors
|
|
75
|
+
///
|
|
76
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
77
|
+
#[napi]
|
|
78
|
+
pub fn append_menu_item(&self, item: &MenuItem, id: Option<String>) -> Result<()> {
|
|
79
|
+
self.inner
|
|
80
|
+
.append(&item.0)
|
|
81
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
82
|
+
|
|
83
|
+
if let Some(id_str) = id {
|
|
84
|
+
self.register(id_str, AnyMenuItem::Standard(item.0.clone()));
|
|
85
|
+
}
|
|
86
|
+
Ok(())
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/// Appends a submenu to this menu.
|
|
90
|
+
///
|
|
91
|
+
/// # Errors
|
|
92
|
+
///
|
|
93
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
94
|
+
#[napi]
|
|
95
|
+
pub fn append_submenu(&self, item: &Submenu, id: Option<String>) -> Result<()> {
|
|
96
|
+
self.inner
|
|
97
|
+
.append(&item.inner)
|
|
98
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
99
|
+
|
|
100
|
+
if let Some(id_str) = id {
|
|
101
|
+
self.register(id_str, AnyMenuItem::Submenu(item.clone()));
|
|
102
|
+
}
|
|
103
|
+
Ok(())
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/// Appends an icon menu item to this menu.
|
|
107
|
+
///
|
|
108
|
+
/// # Errors
|
|
109
|
+
///
|
|
110
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
111
|
+
#[napi]
|
|
112
|
+
pub fn append_icon_menu_item(&self, item: &IconMenuItem, id: String) -> Result<()> {
|
|
113
|
+
self.inner
|
|
114
|
+
.append(&item.0)
|
|
115
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
116
|
+
|
|
117
|
+
self.register(id, AnyMenuItem::Icon(item.0.clone()));
|
|
118
|
+
Ok(())
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/// Appends a predefined menu item (e.g., separator) to this menu.
|
|
122
|
+
///
|
|
123
|
+
/// # Errors
|
|
124
|
+
///
|
|
125
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
126
|
+
#[napi]
|
|
127
|
+
pub fn append_predefined_menu_item(&self, item: &PredefinedMenuItem) -> Result<()> {
|
|
128
|
+
self.inner
|
|
129
|
+
.append(&item.0)
|
|
130
|
+
.map_err(|e| Error::from_reason(format!("{e}")))
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
#[napi]
|
|
134
|
+
pub fn is_checked(&self, id: String) -> bool {
|
|
135
|
+
let reg = lock_registry(&self.registry);
|
|
136
|
+
if let Some(AnyMenuItem::Check(item)) = reg.get(&id) {
|
|
137
|
+
return item.is_checked();
|
|
138
|
+
}
|
|
139
|
+
for item in reg.values() {
|
|
140
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
141
|
+
if submenu.is_checked(id.clone()) {
|
|
142
|
+
return true;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
false
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
#[napi]
|
|
150
|
+
pub fn toggle_check(&self, id: String) -> bool {
|
|
151
|
+
let reg = lock_registry(&self.registry);
|
|
152
|
+
if let Some(AnyMenuItem::Check(item)) = reg.get(&id) {
|
|
153
|
+
let next = next_checked_state(item.is_checked());
|
|
154
|
+
item.set_checked(next);
|
|
155
|
+
return next;
|
|
156
|
+
}
|
|
157
|
+
for item in reg.values() {
|
|
158
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
159
|
+
if submenu.has_id(&id) {
|
|
160
|
+
return submenu.toggle_check(id.clone());
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
false
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
#[napi]
|
|
168
|
+
pub fn set_text(&self, id: String, text: String) {
|
|
169
|
+
let reg = lock_registry(&self.registry);
|
|
170
|
+
if let Some(any_item) = reg.get(&id) {
|
|
171
|
+
match any_item {
|
|
172
|
+
AnyMenuItem::Standard(i) => i.set_text(text),
|
|
173
|
+
AnyMenuItem::Check(i) => i.set_text(text),
|
|
174
|
+
AnyMenuItem::Icon(i) => i.set_text(text),
|
|
175
|
+
AnyMenuItem::Submenu(i) => i.inner.set_text(text),
|
|
176
|
+
}
|
|
177
|
+
return;
|
|
178
|
+
}
|
|
179
|
+
for item in reg.values() {
|
|
180
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
181
|
+
if submenu.has_id(&id) {
|
|
182
|
+
submenu.set_text(id, text);
|
|
183
|
+
return;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
impl Default for Menu {
|
|
191
|
+
fn default() -> Self {
|
|
192
|
+
Self::new()
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
#[napi]
|
|
197
|
+
pub struct MenuItem(pub(crate) tray_menu::MenuItem);
|
|
198
|
+
|
|
199
|
+
#[napi]
|
|
200
|
+
impl MenuItem {
|
|
201
|
+
#[napi]
|
|
202
|
+
pub fn set_text(&self, text: String) {
|
|
203
|
+
self.0.set_text(text);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
#[napi]
|
|
207
|
+
pub fn set_enabled(&self, enabled: bool) {
|
|
208
|
+
self.0.set_enabled(enabled);
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
#[napi]
|
|
213
|
+
#[derive(Clone)]
|
|
214
|
+
pub struct MenuItemBuilder {
|
|
215
|
+
text: String,
|
|
216
|
+
enabled: bool,
|
|
217
|
+
id: Option<String>,
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
#[napi]
|
|
221
|
+
impl MenuItemBuilder {
|
|
222
|
+
#[napi(constructor)]
|
|
223
|
+
pub fn new() -> Self {
|
|
224
|
+
Self {
|
|
225
|
+
text: String::new(),
|
|
226
|
+
enabled: true,
|
|
227
|
+
id: None,
|
|
228
|
+
}
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
#[napi]
|
|
232
|
+
#[must_use]
|
|
233
|
+
pub fn with_text(&mut self, text: String) -> Self {
|
|
234
|
+
self.text = text;
|
|
235
|
+
self.clone()
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
#[napi]
|
|
239
|
+
#[must_use]
|
|
240
|
+
pub fn with_enabled(&mut self, enabled: bool) -> Self {
|
|
241
|
+
self.enabled = enabled;
|
|
242
|
+
self.clone()
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
#[napi]
|
|
246
|
+
#[must_use]
|
|
247
|
+
pub fn with_id(&mut self, id: String) -> Self {
|
|
248
|
+
self.id = Some(id);
|
|
249
|
+
self.clone()
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/// Builds the menu item.
|
|
253
|
+
///
|
|
254
|
+
/// # Errors
|
|
255
|
+
///
|
|
256
|
+
/// Returns an error if the underlying OS fails to create the menu item.
|
|
257
|
+
#[napi]
|
|
258
|
+
pub fn build(&self) -> Result<MenuItem> {
|
|
259
|
+
let item = if let Some(id) = &self.id {
|
|
260
|
+
tray_menu::MenuItem::with_id(
|
|
261
|
+
tray_menu::MenuId(id.clone()),
|
|
262
|
+
&self.text,
|
|
263
|
+
self.enabled,
|
|
264
|
+
None,
|
|
265
|
+
)
|
|
266
|
+
} else {
|
|
267
|
+
tray_menu::MenuItem::new(&self.text, self.enabled, None)
|
|
268
|
+
};
|
|
269
|
+
Ok(MenuItem(item))
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
impl Default for MenuItemBuilder {
|
|
274
|
+
fn default() -> Self {
|
|
275
|
+
Self::new()
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
#[napi]
|
|
280
|
+
pub struct CheckMenuItem(pub(crate) tray_menu::CheckMenuItem);
|
|
281
|
+
|
|
282
|
+
#[napi]
|
|
283
|
+
#[derive(Clone)]
|
|
284
|
+
pub struct CheckMenuItemBuilder {
|
|
285
|
+
text: String,
|
|
286
|
+
enabled: bool,
|
|
287
|
+
checked: bool,
|
|
288
|
+
id: Option<String>,
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
#[napi]
|
|
292
|
+
impl CheckMenuItemBuilder {
|
|
293
|
+
#[napi(constructor)]
|
|
294
|
+
pub fn new() -> Self {
|
|
295
|
+
Self {
|
|
296
|
+
text: String::new(),
|
|
297
|
+
enabled: true,
|
|
298
|
+
checked: false,
|
|
299
|
+
id: None,
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
#[napi]
|
|
304
|
+
#[must_use]
|
|
305
|
+
pub fn with_text(&mut self, text: String) -> Self {
|
|
306
|
+
self.text = text;
|
|
307
|
+
self.clone()
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
#[napi]
|
|
311
|
+
#[must_use]
|
|
312
|
+
pub fn with_enabled(&mut self, enabled: bool) -> Self {
|
|
313
|
+
self.enabled = enabled;
|
|
314
|
+
self.clone()
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
#[napi]
|
|
318
|
+
#[must_use]
|
|
319
|
+
pub fn with_checked(&mut self, checked: bool) -> Self {
|
|
320
|
+
self.checked = checked;
|
|
321
|
+
self.clone()
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
#[napi]
|
|
325
|
+
#[must_use]
|
|
326
|
+
pub fn with_id(&mut self, id: String) -> Self {
|
|
327
|
+
self.id = Some(id);
|
|
328
|
+
self.clone()
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
/// Builds the check menu item.
|
|
332
|
+
///
|
|
333
|
+
/// # Errors
|
|
334
|
+
///
|
|
335
|
+
/// Returns an error if the underlying OS fails to create the menu item.
|
|
336
|
+
#[napi]
|
|
337
|
+
pub fn build(&self) -> Result<CheckMenuItem> {
|
|
338
|
+
let item = if let Some(id) = &self.id {
|
|
339
|
+
tray_menu::CheckMenuItem::with_id(
|
|
340
|
+
tray_menu::MenuId(id.clone()),
|
|
341
|
+
&self.text,
|
|
342
|
+
self.enabled,
|
|
343
|
+
self.checked,
|
|
344
|
+
None,
|
|
345
|
+
)
|
|
346
|
+
} else {
|
|
347
|
+
tray_menu::CheckMenuItem::new(&self.text, self.enabled, self.checked, None)
|
|
348
|
+
};
|
|
349
|
+
Ok(CheckMenuItem(item))
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
impl Default for CheckMenuItemBuilder {
|
|
354
|
+
fn default() -> Self {
|
|
355
|
+
Self::new()
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
#[napi]
|
|
360
|
+
#[derive(Clone)]
|
|
361
|
+
pub struct Submenu {
|
|
362
|
+
pub(crate) inner: tray_menu::Submenu,
|
|
363
|
+
pub(crate) registry: Arc<Mutex<HashMap<String, AnyMenuItem>>>,
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
#[napi]
|
|
367
|
+
impl CheckMenuItem {
|
|
368
|
+
#[napi]
|
|
369
|
+
pub fn is_checked(&self) -> bool {
|
|
370
|
+
self.0.is_checked()
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
#[napi]
|
|
374
|
+
pub fn set_checked(&self, checked: bool) {
|
|
375
|
+
self.0.set_checked(checked);
|
|
376
|
+
}
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
impl Submenu {
|
|
380
|
+
fn register(&self, id: String, item: AnyMenuItem) {
|
|
381
|
+
let mut reg = lock_registry(&self.registry);
|
|
382
|
+
reg.insert(id, item);
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
fn has_id(&self, id: &str) -> bool {
|
|
386
|
+
let reg = lock_registry(&self.registry);
|
|
387
|
+
if reg.contains_key(id) {
|
|
388
|
+
return true;
|
|
389
|
+
}
|
|
390
|
+
for item in reg.values() {
|
|
391
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
392
|
+
if submenu.has_id(id) {
|
|
393
|
+
return true;
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
}
|
|
397
|
+
false
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
fn set_text(&self, id: String, text: String) {
|
|
401
|
+
let reg = lock_registry(&self.registry);
|
|
402
|
+
if let Some(any_item) = reg.get(&id) {
|
|
403
|
+
match any_item {
|
|
404
|
+
AnyMenuItem::Standard(i) => i.set_text(text),
|
|
405
|
+
AnyMenuItem::Check(i) => i.set_text(text),
|
|
406
|
+
AnyMenuItem::Icon(i) => i.set_text(text),
|
|
407
|
+
AnyMenuItem::Submenu(i) => i.inner.set_text(text),
|
|
408
|
+
}
|
|
409
|
+
return;
|
|
410
|
+
}
|
|
411
|
+
for item in reg.values() {
|
|
412
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
413
|
+
if submenu.has_id(&id) {
|
|
414
|
+
submenu.set_text(id, text);
|
|
415
|
+
return;
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
#[napi]
|
|
423
|
+
impl Submenu {
|
|
424
|
+
/// Appends a standard menu item to this submenu.
|
|
425
|
+
///
|
|
426
|
+
/// # Errors
|
|
427
|
+
///
|
|
428
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
429
|
+
#[napi]
|
|
430
|
+
pub fn append_menu_item(&self, item: &MenuItem, id: Option<String>) -> Result<()> {
|
|
431
|
+
self.inner
|
|
432
|
+
.append(&item.0)
|
|
433
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
434
|
+
|
|
435
|
+
if let Some(id_str) = id {
|
|
436
|
+
self.register(id_str, AnyMenuItem::Standard(item.0.clone()));
|
|
437
|
+
}
|
|
438
|
+
Ok(())
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
/// Appends a nested submenu to this submenu.
|
|
442
|
+
///
|
|
443
|
+
/// # Errors
|
|
444
|
+
///
|
|
445
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
446
|
+
#[allow(clippy::use_self)]
|
|
447
|
+
#[napi]
|
|
448
|
+
pub fn append_submenu(&self, item: &Submenu, id: Option<String>) -> Result<()> {
|
|
449
|
+
self.inner
|
|
450
|
+
.append(&item.inner)
|
|
451
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
452
|
+
|
|
453
|
+
if let Some(id_str) = id {
|
|
454
|
+
self.register(id_str, AnyMenuItem::Submenu(item.clone()));
|
|
455
|
+
}
|
|
456
|
+
Ok(())
|
|
457
|
+
}
|
|
458
|
+
|
|
459
|
+
/// Appends a checkable menu item to this submenu.
|
|
460
|
+
///
|
|
461
|
+
/// # Errors
|
|
462
|
+
///
|
|
463
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
464
|
+
#[napi]
|
|
465
|
+
pub fn append_check_menu_item(&self, item: &CheckMenuItem, id: String) -> Result<()> {
|
|
466
|
+
self.inner
|
|
467
|
+
.append(&item.0)
|
|
468
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
469
|
+
|
|
470
|
+
self.register(id, AnyMenuItem::Check(item.0.clone()));
|
|
471
|
+
Ok(())
|
|
472
|
+
}
|
|
473
|
+
|
|
474
|
+
/// Appends an icon menu item to this submenu.
|
|
475
|
+
///
|
|
476
|
+
/// # Errors
|
|
477
|
+
///
|
|
478
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
479
|
+
#[napi]
|
|
480
|
+
pub fn append_icon_menu_item(&self, item: &IconMenuItem, id: Option<String>) -> Result<()> {
|
|
481
|
+
self.inner
|
|
482
|
+
.append(&item.0)
|
|
483
|
+
.map_err(|e| Error::from_reason(format!("{e}")))?;
|
|
484
|
+
|
|
485
|
+
if let Some(id_str) = id {
|
|
486
|
+
self.register(id_str, AnyMenuItem::Icon(item.0.clone()));
|
|
487
|
+
}
|
|
488
|
+
Ok(())
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
/// Appends a predefined menu item (e.g., separator) to this submenu.
|
|
492
|
+
///
|
|
493
|
+
/// # Errors
|
|
494
|
+
///
|
|
495
|
+
/// Returns an error if the underlying OS menu operation fails.
|
|
496
|
+
#[napi]
|
|
497
|
+
pub fn append_predefined_menu_item(&self, item: &PredefinedMenuItem) -> Result<()> {
|
|
498
|
+
self.inner
|
|
499
|
+
.append(&item.0)
|
|
500
|
+
.map_err(|e| Error::from_reason(format!("{e}")))
|
|
501
|
+
}
|
|
502
|
+
|
|
503
|
+
#[napi]
|
|
504
|
+
pub fn is_checked(&self, id: String) -> bool {
|
|
505
|
+
let reg = lock_registry(&self.registry);
|
|
506
|
+
if let Some(AnyMenuItem::Check(item)) = reg.get(&id) {
|
|
507
|
+
return item.is_checked();
|
|
508
|
+
}
|
|
509
|
+
for item in reg.values() {
|
|
510
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
511
|
+
if submenu.is_checked(id.clone()) {
|
|
512
|
+
return true;
|
|
513
|
+
}
|
|
514
|
+
}
|
|
515
|
+
}
|
|
516
|
+
false
|
|
517
|
+
}
|
|
518
|
+
|
|
519
|
+
#[napi]
|
|
520
|
+
pub fn toggle_check(&self, id: String) -> bool {
|
|
521
|
+
let reg = lock_registry(&self.registry);
|
|
522
|
+
if let Some(AnyMenuItem::Check(item)) = reg.get(&id) {
|
|
523
|
+
let next = next_checked_state(item.is_checked());
|
|
524
|
+
item.set_checked(next);
|
|
525
|
+
return next;
|
|
526
|
+
}
|
|
527
|
+
for item in reg.values() {
|
|
528
|
+
if let AnyMenuItem::Submenu(submenu) = item {
|
|
529
|
+
if submenu.has_id(&id) {
|
|
530
|
+
return submenu.toggle_check(id.clone());
|
|
531
|
+
}
|
|
532
|
+
}
|
|
533
|
+
}
|
|
534
|
+
false
|
|
535
|
+
}
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
#[napi]
|
|
539
|
+
#[derive(Clone)]
|
|
540
|
+
pub struct SubmenuBuilder {
|
|
541
|
+
text: String,
|
|
542
|
+
enabled: bool,
|
|
543
|
+
}
|
|
544
|
+
|
|
545
|
+
#[napi]
|
|
546
|
+
impl SubmenuBuilder {
|
|
547
|
+
#[napi(constructor)]
|
|
548
|
+
pub fn new() -> Self {
|
|
549
|
+
Self {
|
|
550
|
+
text: String::new(),
|
|
551
|
+
enabled: true,
|
|
552
|
+
}
|
|
553
|
+
}
|
|
554
|
+
|
|
555
|
+
#[napi]
|
|
556
|
+
#[must_use]
|
|
557
|
+
pub fn with_text(&mut self, text: String) -> Self {
|
|
558
|
+
self.text = text;
|
|
559
|
+
self.clone()
|
|
560
|
+
}
|
|
561
|
+
|
|
562
|
+
#[napi]
|
|
563
|
+
#[must_use]
|
|
564
|
+
pub fn with_enabled(&mut self, enabled: bool) -> Self {
|
|
565
|
+
self.enabled = enabled;
|
|
566
|
+
self.clone()
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
/// Builds the submenu.
|
|
570
|
+
///
|
|
571
|
+
/// # Errors
|
|
572
|
+
///
|
|
573
|
+
/// Returns an error if the underlying OS fails to create the submenu.
|
|
574
|
+
#[napi]
|
|
575
|
+
pub fn build(&self) -> Result<Submenu> {
|
|
576
|
+
Ok(Submenu {
|
|
577
|
+
inner: tray_menu::Submenu::new(&self.text, self.enabled),
|
|
578
|
+
registry: Arc::new(Mutex::new(HashMap::new())),
|
|
579
|
+
})
|
|
580
|
+
}
|
|
581
|
+
}
|
|
582
|
+
|
|
583
|
+
impl Default for SubmenuBuilder {
|
|
584
|
+
fn default() -> Self {
|
|
585
|
+
Self::new()
|
|
586
|
+
}
|
|
587
|
+
}
|
|
588
|
+
|
|
589
|
+
#[napi]
|
|
590
|
+
pub struct PredefinedMenuItem(pub(crate) tray_menu::PredefinedMenuItem);
|
|
591
|
+
|
|
592
|
+
#[napi]
|
|
593
|
+
impl PredefinedMenuItem {
|
|
594
|
+
#[napi]
|
|
595
|
+
pub fn separator() -> Self {
|
|
596
|
+
Self(tray_menu::PredefinedMenuItem::separator())
|
|
597
|
+
}
|
|
598
|
+
}
|
|
599
|
+
|
|
600
|
+
#[napi]
|
|
601
|
+
pub struct IconMenuItem(pub(crate) tray_menu::IconMenuItem);
|
|
602
|
+
|
|
603
|
+
#[napi]
|
|
604
|
+
impl IconMenuItem {
|
|
605
|
+
#[napi]
|
|
606
|
+
pub fn set_text(&self, text: String) {
|
|
607
|
+
self.0.set_text(text);
|
|
608
|
+
}
|
|
609
|
+
|
|
610
|
+
#[napi]
|
|
611
|
+
pub fn set_enabled(&self, enabled: bool) {
|
|
612
|
+
self.0.set_enabled(enabled);
|
|
613
|
+
}
|
|
614
|
+
}
|
|
615
|
+
|
|
616
|
+
#[napi]
|
|
617
|
+
#[derive(Clone)]
|
|
618
|
+
pub struct IconMenuItemBuilder {
|
|
619
|
+
text: String,
|
|
620
|
+
enabled: bool,
|
|
621
|
+
icon: Option<tray_menu::Icon>,
|
|
622
|
+
id: Option<String>,
|
|
623
|
+
}
|
|
624
|
+
|
|
625
|
+
#[napi]
|
|
626
|
+
impl IconMenuItemBuilder {
|
|
627
|
+
#[napi(constructor)]
|
|
628
|
+
pub fn new() -> Self {
|
|
629
|
+
Self {
|
|
630
|
+
text: String::new(),
|
|
631
|
+
enabled: true,
|
|
632
|
+
icon: None,
|
|
633
|
+
id: None,
|
|
634
|
+
}
|
|
635
|
+
}
|
|
636
|
+
|
|
637
|
+
#[napi]
|
|
638
|
+
#[must_use]
|
|
639
|
+
pub fn with_text(&mut self, text: String) -> Self {
|
|
640
|
+
self.text = text;
|
|
641
|
+
self.clone()
|
|
642
|
+
}
|
|
643
|
+
|
|
644
|
+
#[napi]
|
|
645
|
+
#[must_use]
|
|
646
|
+
pub fn with_enabled(&mut self, enabled: bool) -> Self {
|
|
647
|
+
self.enabled = enabled;
|
|
648
|
+
self.clone()
|
|
649
|
+
}
|
|
650
|
+
|
|
651
|
+
/// Sets the icon for this menu item.
|
|
652
|
+
///
|
|
653
|
+
/// # Errors
|
|
654
|
+
///
|
|
655
|
+
/// Returns an error if the icon data is invalid or the OS fails to create the icon.
|
|
656
|
+
#[napi]
|
|
657
|
+
pub fn with_icon(&mut self, icon: &Icon) -> Result<Self> {
|
|
658
|
+
let tray_icon = tray_menu::Icon::from_rgba(icon.rgba.clone(), icon.width, icon.height)
|
|
659
|
+
.map_err(|e| Error::from_reason(format!("Failed to create menu icon: {e}")))?;
|
|
660
|
+
self.icon = Some(tray_icon);
|
|
661
|
+
Ok(self.clone())
|
|
662
|
+
}
|
|
663
|
+
|
|
664
|
+
#[napi]
|
|
665
|
+
#[must_use]
|
|
666
|
+
pub fn with_id(&mut self, id: String) -> Self {
|
|
667
|
+
self.id = Some(id);
|
|
668
|
+
self.clone()
|
|
669
|
+
}
|
|
670
|
+
|
|
671
|
+
/// Builds the icon menu item.
|
|
672
|
+
///
|
|
673
|
+
/// # Errors
|
|
674
|
+
///
|
|
675
|
+
/// Returns an error if no icon was set or the OS fails to create the menu item.
|
|
676
|
+
#[napi]
|
|
677
|
+
pub fn build(&self) -> Result<IconMenuItem> {
|
|
678
|
+
let icon = self
|
|
679
|
+
.icon
|
|
680
|
+
.clone()
|
|
681
|
+
.ok_or_else(|| Error::from_reason("Icon is required".to_string()))?;
|
|
682
|
+
let item = if let Some(id) = &self.id {
|
|
683
|
+
tray_menu::IconMenuItem::with_id(
|
|
684
|
+
tray_menu::MenuId(id.clone()),
|
|
685
|
+
&self.text,
|
|
686
|
+
self.enabled,
|
|
687
|
+
Some(icon),
|
|
688
|
+
None,
|
|
689
|
+
)
|
|
690
|
+
} else {
|
|
691
|
+
tray_menu::IconMenuItem::new(&self.text, self.enabled, Some(icon), None)
|
|
692
|
+
};
|
|
693
|
+
Ok(IconMenuItem(item))
|
|
694
|
+
}
|
|
695
|
+
}
|
|
696
|
+
|
|
697
|
+
impl Default for IconMenuItemBuilder {
|
|
698
|
+
fn default() -> Self {
|
|
699
|
+
Self::new()
|
|
700
|
+
}
|
|
701
|
+
}
|
|
702
|
+
|
|
703
|
+
#[napi(object)]
|
|
704
|
+
pub struct MenuEvent {
|
|
705
|
+
pub id: String,
|
|
706
|
+
}
|
|
707
|
+
|
|
708
|
+
#[napi]
|
|
709
|
+
pub fn poll_menu_events() -> Option<MenuEvent> {
|
|
710
|
+
tray_menu::MenuEvent::receiver()
|
|
711
|
+
.try_recv()
|
|
712
|
+
.ok()
|
|
713
|
+
.map(|e| MenuEvent { id: e.id.0 })
|
|
714
|
+
}
|
|
715
|
+
|
|
716
|
+
#[napi(object)]
|
|
717
|
+
pub struct AboutMetadata {
|
|
718
|
+
pub name: Option<String>,
|
|
719
|
+
pub version: Option<String>,
|
|
720
|
+
pub copyright: Option<String>,
|
|
721
|
+
pub authors: Option<Vec<String>>,
|
|
722
|
+
pub website: Option<String>,
|
|
723
|
+
pub website_label: Option<String>,
|
|
724
|
+
pub comments: Option<String>,
|
|
725
|
+
}
|
|
726
|
+
|
|
727
|
+
#[napi]
|
|
728
|
+
#[derive(Clone)]
|
|
729
|
+
pub struct AboutMetadataBuilder {
|
|
730
|
+
pub name: Option<String>,
|
|
731
|
+
pub version: Option<String>,
|
|
732
|
+
pub copyright: Option<String>,
|
|
733
|
+
pub authors: Option<Vec<String>>,
|
|
734
|
+
pub website: Option<String>,
|
|
735
|
+
pub website_label: Option<String>,
|
|
736
|
+
pub comments: Option<String>,
|
|
737
|
+
}
|
|
738
|
+
|
|
739
|
+
#[napi]
|
|
740
|
+
impl AboutMetadataBuilder {
|
|
741
|
+
#[napi(constructor)]
|
|
742
|
+
pub fn new() -> Self {
|
|
743
|
+
Self {
|
|
744
|
+
name: None,
|
|
745
|
+
version: None,
|
|
746
|
+
copyright: None,
|
|
747
|
+
authors: None,
|
|
748
|
+
website: None,
|
|
749
|
+
website_label: None,
|
|
750
|
+
comments: None,
|
|
751
|
+
}
|
|
752
|
+
}
|
|
753
|
+
|
|
754
|
+
#[napi]
|
|
755
|
+
#[must_use]
|
|
756
|
+
pub fn with_name(&mut self, name: String) -> Self {
|
|
757
|
+
self.name = Some(name);
|
|
758
|
+
self.clone()
|
|
759
|
+
}
|
|
760
|
+
|
|
761
|
+
#[napi]
|
|
762
|
+
#[must_use]
|
|
763
|
+
pub fn with_version(&mut self, version: String) -> Self {
|
|
764
|
+
self.version = Some(version);
|
|
765
|
+
self.clone()
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
#[napi]
|
|
769
|
+
#[must_use]
|
|
770
|
+
pub fn with_copyright(&mut self, copyright: String) -> Self {
|
|
771
|
+
self.copyright = Some(copyright);
|
|
772
|
+
self.clone()
|
|
773
|
+
}
|
|
774
|
+
|
|
775
|
+
#[napi]
|
|
776
|
+
#[must_use]
|
|
777
|
+
pub fn with_authors(&mut self, authors: Vec<String>) -> Self {
|
|
778
|
+
self.authors = Some(authors);
|
|
779
|
+
self.clone()
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
#[napi]
|
|
783
|
+
#[must_use]
|
|
784
|
+
pub fn with_website(&mut self, website: String) -> Self {
|
|
785
|
+
self.website = Some(website);
|
|
786
|
+
self.clone()
|
|
787
|
+
}
|
|
788
|
+
|
|
789
|
+
#[napi]
|
|
790
|
+
#[must_use]
|
|
791
|
+
pub fn with_website_label(&mut self, website_label: String) -> Self {
|
|
792
|
+
self.website_label = Some(website_label);
|
|
793
|
+
self.clone()
|
|
794
|
+
}
|
|
795
|
+
|
|
796
|
+
#[napi]
|
|
797
|
+
#[must_use]
|
|
798
|
+
pub fn with_comments(&mut self, comments: String) -> Self {
|
|
799
|
+
self.comments = Some(comments);
|
|
800
|
+
self.clone()
|
|
801
|
+
}
|
|
802
|
+
|
|
803
|
+
#[napi]
|
|
804
|
+
pub fn build(&self) -> AboutMetadata {
|
|
805
|
+
AboutMetadata {
|
|
806
|
+
name: self.name.clone(),
|
|
807
|
+
version: self.version.clone(),
|
|
808
|
+
copyright: self.copyright.clone(),
|
|
809
|
+
authors: self.authors.clone(),
|
|
810
|
+
website: self.website.clone(),
|
|
811
|
+
website_label: self.website_label.clone(),
|
|
812
|
+
comments: self.comments.clone(),
|
|
813
|
+
}
|
|
814
|
+
}
|
|
815
|
+
}
|
|
816
|
+
|
|
817
|
+
impl Default for AboutMetadataBuilder {
|
|
818
|
+
fn default() -> Self {
|
|
819
|
+
Self::new()
|
|
820
|
+
}
|
|
821
|
+
}
|
|
822
|
+
|
|
823
|
+
#[cfg(test)]
|
|
824
|
+
mod menu_toggle_tests {
|
|
825
|
+
use super::next_checked_state;
|
|
826
|
+
|
|
827
|
+
#[test]
|
|
828
|
+
fn toggling_a_checkable_item_twice_returns_to_unchecked() {
|
|
829
|
+
let mut checked = false;
|
|
830
|
+
assert!(!checked, "checkable items start unchecked");
|
|
831
|
+
|
|
832
|
+
checked = next_checked_state(checked);
|
|
833
|
+
assert!(checked, "first toggle must flip false -> true");
|
|
834
|
+
|
|
835
|
+
checked = next_checked_state(checked);
|
|
836
|
+
assert!(!checked, "second toggle must flip true -> false");
|
|
837
|
+
}
|
|
838
|
+
|
|
839
|
+
#[test]
|
|
840
|
+
fn toggling_a_checked_item_twice_returns_to_checked() {
|
|
841
|
+
let mut checked = true;
|
|
842
|
+
|
|
843
|
+
checked = next_checked_state(checked);
|
|
844
|
+
assert!(!checked, "first toggle must flip true -> false");
|
|
845
|
+
|
|
846
|
+
checked = next_checked_state(checked);
|
|
847
|
+
assert!(checked, "second toggle must flip false -> true");
|
|
848
|
+
}
|
|
849
|
+
}
|