Enum MenuItemSpec 

pub enum MenuItemSpec {
    Item {
        id: String,
        label: String,
        accelerator: Option<String>,
        enabled: bool,
    },
    Role {
        role: MenuRole,
        label: Option<String>,
    },
    Separator,
    Submenu {
        label: String,
        menu: MenuSpec,
    },
}

The desktop app’s identity and native-integration vocabulary, re-exported from the desktop core so app code never names a shell crate: DesktopConfig (the whole declaration — app name, reverse-DNS id, window icon, menu bar, last-window-close policy — handed to App::desktop, run_desktop_config or app!’s desktop = { .. } argument), MenuSpec/MenuItemSpec/MenuRole (the platform-independent native menu tree a per-OS shell translates into an NSApp menu bar or an HMENU), DesktopIconData (decoded, tightly-packed RGBA8 — decoding a PNG/ICO/ICNS is the caller’s job), and DEFAULT_APP_NAME (the window title a config that names nothing still gets).

frust-shell-desktop‘s IconData is re-exported renamed: the facade already carries frust-widgets’ IconData, an in-UI vector icon, and the two are unrelated (one is a BezPath a widget paints, the other is the window/taskbar bitmap the OS shows). The Desktop prefix matches DesktopConfig, whose with_window_icon is its only consumer.

use frust::{DesktopConfig, MenuItemSpec, MenuRole, MenuSpec};

let file = MenuSpec::new()
    .with_item(MenuItemSpec::item("file.open", "Open…").with_accelerator("CmdOrCtrl+O"))
    .with_item(MenuItemSpec::separator())
    .with_item(MenuItemSpec::role(MenuRole::Quit));

let config = DesktopConfig::new()
    .with_app_name("Huddle")
    .with_app_id("dev.frust.huddle")
    .with_menu_spec(MenuSpec::new().with_item(MenuItemSpec::submenu("File", file)));

Desktop-only, unlike the menu_events read side: these types are defined in frust-shell-desktop, which is not in a mobile build’s or a wasm32 build’s dependency graph at all (see this crate’s Cargo.toml). Code shared with a mobile or wasm32 target keeps a DesktopConfig behind its own #[cfg(not(any(target_os = "android", target_os = "ios", target_arch = "wasm32")))] — or, more simply, writes it inline in app!’s desktop = { .. } argument, which the macro already emits only on the targets that have it. One entry in a MenuSpec.

Deliberately not #[non_exhaustive]: a per-OS shell must match it exhaustively, so a new variant is a compile error in every shell that would otherwise silently drop the item from the menu it builds.

Variants

Item

An app-defined item. Activating it pushes id through frust_reactive::push_menu_event, which app code observes via the facade’s menu_events().

Fields

id: String

The app’s own id for this item, echoed back verbatim on activation.

label: String

The text shown in the menu.

accelerator: Option<String>

An accelerator in the cross-platform "CmdOrCtrl+Shift+P" shorthand (Cmd/Ctrl/Alt/Shift + a key, joined by +), or None for no keyboard shortcut.

Kept a string rather than a parsed chord type because this crate binds no menu library: the per-OS shell parses it with whatever its menu backend already accepts, and is also where an unparseable accelerator is reported — validating it twice, in two vocabularies, would only let the two disagree.

enabled: bool

Whether the item is selectable. false renders it greyed out.

Role

A platform-standard item (MenuRole) the host implements itself — About/Hide/Quit and friends. No activation is reported for these: the platform performs the action, so app code has nothing to handle.

Fields

role: MenuRole

Which standard action this item performs.

label: Option<String>

An override for the platform’s own label, or None to use it (the normal case — a localized system label beats a hand-written one).

Separator

A separator line.

Submenu

A nested menu.

Fields

label: String

The text shown for the submenu itself.

menu: MenuSpec

The submenu’s own contents.

Implementations

impl MenuItemSpec

pub fn item(id: impl Into<String>, label: impl Into<String>) -> MenuItemSpec

An enabled, accelerator-free app item.

pub fn role(role: MenuRole) -> MenuItemSpec

A platform-standard item at the platform’s own label.

pub fn separator() -> MenuItemSpec

A separator line.

pub fn submenu(label: impl Into<String>, menu: MenuSpec) -> MenuItemSpec

A nested menu under label.

pub fn with_accelerator(self, accelerator: impl Into<String>) -> MenuItemSpec

Attach a keyboard accelerator (see Item::accelerator).

Returns the item unchanged for every other variant: a role item’s shortcut is the platform’s own (⌘Q for Quit), and a separator/submenu has nothing to activate.

pub fn disabled(self) -> MenuItemSpec

Mark the item greyed out. Returns the item unchanged for every variant but MenuItemSpec::Item (see with_accelerator).

pub fn with_label(self, label: impl Into<String>) -> MenuItemSpec

Override the label of a MenuItemSpec::Role item. Returns the item unchanged for every other variant (their labels are set at construction).

pub fn id(&self) -> Option<&str>

The activation id this item reports, or None for an item that reports none (a role item, a separator, a submenu).

Trait Implementations

impl Clone for MenuItemSpec

fn clone(&self) -> MenuItemSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MenuItemSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for MenuItemSpec

impl PartialEq for MenuItemSpec

fn eq(&self, other: &MenuItemSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MenuItemSpec