ashlar-app 0.1.0

ashlar runtime: App builder, frame scheduler, crash guard, logging, telemetry, agent control
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

//! The app's commands in the OS menu bar (feature `native-menu`, macOS and Windows): the same
//! command list the in-window bar is built from, mirrored into `ashlar_native::menu`.

use ashlar_command::CommandInfo;
use ashlar_native::menu::{MenuNode, MenuSpec, NativeMenuBar, Role, Submenu};

pub(crate) struct NativeMenu {
    bar: NativeMenuBar,
}

fn spec(infos: &[CommandInfo]) -> MenuSpec {
    let mut spec = MenuSpec::from_commands(infos, crate::runtime::MENU_ORDER);
    #[cfg(target_os = "macos")]
    {
        // the first menu is the application menu on macOS
        let app = Submenu::new(
            "App",
            vec![
                MenuNode::role(Role::About),
                MenuNode::Separator,
                MenuNode::role(Role::Services),
                MenuNode::Separator,
                MenuNode::role(Role::Hide),
                MenuNode::role(Role::HideOthers),
                MenuNode::role(Role::ShowAll),
            ],
        );
        spec.menus.insert(0, app);
    }
    #[cfg(not(target_os = "macos"))]
    let _ = Submenu::new("", vec![MenuNode::role(Role::About)]);
    spec
}

impl NativeMenu {
    /// Install the bar (main thread). `None` when the platform refuses; the in-window bar stays.
    pub fn install(infos: &[CommandInfo], ctx: &egui::Context) -> Option<NativeMenu> {
        let wake = ashlar_ui::wake::waker(ctx, ashlar_ui::wake::Reason::MENU);
        match NativeMenuBar::install(&spec(infos), std::sync::Arc::new(move || wake.wake())) {
            Ok(bar) => Some(NativeMenu { bar }),
            Err(e) => {
                log::warn!("native menu bar unavailable, using the in-window one: {e}");
                None
            }
        }
    }

    pub fn update(&mut self, infos: &[CommandInfo]) {
        if let Err(e) = self.bar.update(&spec(infos)) {
            log::warn!("native menu bar: {e}");
        }
    }

    /// Command ids chosen since the last call.
    pub fn drain(&self) -> Vec<String> {
        self.bar.drain()
    }
}