@flighthq/menu 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './menu';
+export * from './menu-templates';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './menu';
+export * from './menu-templates';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC"}

package/dist/menu-templates.d.ts

@@ -0,0 +1,8 @@
+import type { MenuItemTemplate } from '@flighthq/types';
+export declare function createDefaultAppMenuTemplate(appName: string): MenuItemTemplate;
+export declare function createDefaultEditMenuTemplate(): MenuItemTemplate;
+export declare function createDefaultFileMenuTemplate(): MenuItemTemplate;
+export declare function createDefaultHelpMenuTemplate(): MenuItemTemplate;
+export declare function createDefaultViewMenuTemplate(): MenuItemTemplate;
+export declare function createDefaultWindowMenuTemplate(): MenuItemTemplate;
+//# sourceMappingURL=menu-templates.d.ts.map

package/dist/menu-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-templates.d.ts","sourceRoot":"","sources":["../src/menu-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMxD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA0D9E;AAMD,wBAAgB,6BAA6B,IAAI,gBAAgB,CAyEhE;AAID,wBAAgB,6BAA6B,IAAI,gBAAgB,CA+ChE;AAID,wBAAgB,6BAA6B,IAAI,gBAAgB,CAgBhE;AAID,wBAAgB,6BAA6B,IAAI,gBAAgB,CAmDhE;AAID,wBAAgB,+BAA+B,IAAI,gBAAgB,CAyBlE"}

package/dist/menu-templates.js

@@ -0,0 +1,293 @@
+import { WellKnownMenuItemRole } from '@flighthq/types';
+// Returns a standard macOS-style application menu (the first menu, labeled with the app name).
+// On Windows/Linux this menu is typically omitted; native backends handle that automatically when
+// the whole-submenu role 'appMenu' is set. Includes About, Services, Hide/Show, and Quit.
+export function createDefaultAppMenuTemplate(appName) {
+    return {
+        label: appName,
+        role: WellKnownMenuItemRole.appMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'about',
+                label: `About ${appName}`,
+                role: WellKnownMenuItemRole.about,
+                type: 'normal',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'services',
+                label: 'Services',
+                role: WellKnownMenuItemRole.services,
+                type: 'submenu',
+                submenu: [],
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'hide',
+                label: `Hide ${appName}`,
+                role: WellKnownMenuItemRole.hide,
+                accelerator: 'CmdOrCtrl+H',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'hideOthers',
+                label: 'Hide Others',
+                role: WellKnownMenuItemRole.hideOthers,
+                accelerator: 'CmdOrCtrl+Alt+H',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'unhide',
+                label: 'Show All',
+                role: WellKnownMenuItemRole.unhide,
+                type: 'normal',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'quit',
+                label: `Quit ${appName}`,
+                role: WellKnownMenuItemRole.quit,
+                accelerator: 'CmdOrCtrl+Q',
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+// Returns a standard Edit menu template with common text-editing operations. The whole-submenu
+// role 'editMenu' is set so native hosts (Electron/Tauri) can substitute their own platform-native
+// Edit menu where that is more appropriate. Items are also individually role-tagged for finer
+// native control.
+export function createDefaultEditMenuTemplate() {
+    return {
+        label: 'Edit',
+        role: WellKnownMenuItemRole.editMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'undo',
+                label: 'Undo',
+                role: WellKnownMenuItemRole.undo,
+                accelerator: 'CmdOrCtrl+Z',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'redo',
+                label: 'Redo',
+                role: WellKnownMenuItemRole.redo,
+                accelerator: 'Shift+CmdOrCtrl+Z',
+                type: 'normal',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'cut',
+                label: 'Cut',
+                role: WellKnownMenuItemRole.cut,
+                accelerator: 'CmdOrCtrl+X',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'copy',
+                label: 'Copy',
+                role: WellKnownMenuItemRole.copy,
+                accelerator: 'CmdOrCtrl+C',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'paste',
+                label: 'Paste',
+                role: WellKnownMenuItemRole.paste,
+                accelerator: 'CmdOrCtrl+V',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'pasteAndMatchStyle',
+                label: 'Paste and Match Style',
+                role: WellKnownMenuItemRole.pasteAndMatchStyle,
+                accelerator: 'Shift+CmdOrCtrl+V',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'delete',
+                label: 'Delete',
+                role: WellKnownMenuItemRole.delete,
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'selectAll',
+                label: 'Select All',
+                role: WellKnownMenuItemRole.selectAll,
+                accelerator: 'CmdOrCtrl+A',
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+// Returns a standard File menu template. The whole-submenu role 'fileMenu' signals native backends
+// to place the menu in the standard File slot. Includes New, Open, Save, Save As, and Close.
+export function createDefaultFileMenuTemplate() {
+    return {
+        label: 'File',
+        role: WellKnownMenuItemRole.fileMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'newFile',
+                label: 'New',
+                type: 'normal',
+                accelerator: 'CmdOrCtrl+N',
+                enabled: true,
+            },
+            {
+                id: 'openFile',
+                label: 'Open…',
+                type: 'normal',
+                accelerator: 'CmdOrCtrl+O',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'saveFile',
+                label: 'Save',
+                type: 'normal',
+                accelerator: 'CmdOrCtrl+S',
+                enabled: true,
+            },
+            {
+                id: 'saveFileAs',
+                label: 'Save As…',
+                type: 'normal',
+                accelerator: 'Shift+CmdOrCtrl+S',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'closeFile',
+                label: 'Close',
+                role: WellKnownMenuItemRole.close,
+                accelerator: 'CmdOrCtrl+W',
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+// Returns a standard Help menu template. The whole-submenu role 'helpMenu' signals native backends
+// to place the menu in the standard Help slot (macOS help-menu convention).
+export function createDefaultHelpMenuTemplate() {
+    return {
+        label: 'Help',
+        role: WellKnownMenuItemRole.helpMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'help',
+                label: 'Search',
+                role: WellKnownMenuItemRole.help,
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+// Returns a standard View menu template covering reload and zoom. The whole-submenu role 'viewMenu'
+// signals native backends to substitute a platform-native View menu where appropriate.
+export function createDefaultViewMenuTemplate() {
+    return {
+        label: 'View',
+        role: WellKnownMenuItemRole.viewMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'reload',
+                label: 'Reload',
+                role: WellKnownMenuItemRole.reload,
+                accelerator: 'CmdOrCtrl+R',
+                type: 'normal',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'resetZoom',
+                label: 'Actual Size',
+                role: WellKnownMenuItemRole.resetZoom,
+                accelerator: 'CmdOrCtrl+0',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'zoomIn',
+                label: 'Zoom In',
+                role: WellKnownMenuItemRole.zoomIn,
+                accelerator: 'CmdOrCtrl+Plus',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'zoomOut',
+                label: 'Zoom Out',
+                role: WellKnownMenuItemRole.zoomOut,
+                accelerator: 'CmdOrCtrl+-',
+                type: 'normal',
+                enabled: true,
+            },
+            { type: 'separator', enabled: true },
+            {
+                id: 'toggleFullscreen',
+                label: 'Toggle Full Screen',
+                role: WellKnownMenuItemRole.toggleFullscreen,
+                accelerator: 'F11',
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+// Returns a standard Window menu template. The whole-submenu role 'windowMenu' signals native
+// backends (notably macOS) to manage the Window menu list automatically.
+export function createDefaultWindowMenuTemplate() {
+    return {
+        label: 'Window',
+        role: WellKnownMenuItemRole.windowMenu,
+        type: 'submenu',
+        submenu: [
+            {
+                id: 'minimize',
+                label: 'Minimize',
+                role: WellKnownMenuItemRole.minimize,
+                accelerator: 'CmdOrCtrl+M',
+                type: 'normal',
+                enabled: true,
+            },
+            {
+                id: 'close',
+                label: 'Close',
+                role: WellKnownMenuItemRole.close,
+                accelerator: 'CmdOrCtrl+W',
+                type: 'normal',
+                enabled: true,
+            },
+        ],
+        enabled: true,
+    };
+}
+//# sourceMappingURL=menu-templates.js.map

package/dist/menu-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-templates.js","sourceRoot":"","sources":["../src/menu-templates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,+FAA+F;AAC/F,kGAAkG;AAClG,0FAA0F;AAC1F,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,qBAAqB,CAAC,OAAO;QACnC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,OAAO;gBACX,KAAK,EAAE,SAAS,OAAO,EAAE;gBACzB,IAAI,EAAE,qBAAqB,CAAC,KAAK;gBACjC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,qBAAqB,CAAC,QAAQ;gBACpC,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,QAAQ,OAAO,EAAE;gBACxB,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,YAAY;gBAChB,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,qBAAqB,CAAC,UAAU;gBACtC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,qBAAqB,CAAC,MAAM;gBAClC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,QAAQ,OAAO,EAAE;gBACxB,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,mGAAmG;AACnG,8FAA8F;AAC9F,kBAAkB;AAClB,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,qBAAqB,CAAC,QAAQ;QACpC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,qBAAqB,CAAC,GAAG;gBAC/B,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,OAAO;gBACX,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,qBAAqB,CAAC,KAAK;gBACjC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,oBAAoB;gBACxB,KAAK,EAAE,uBAAuB;gBAC9B,IAAI,EAAE,qBAAqB,CAAC,kBAAkB;gBAC9C,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,qBAAqB,CAAC,MAAM;gBAClC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,qBAAqB,CAAC,SAAS;gBACrC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,6FAA6F;AAC7F,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,qBAAqB,CAAC,QAAQ;QACpC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,KAAK;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,YAAY;gBAChB,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;gBAChC,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,qBAAqB,CAAC,KAAK;gBACjC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,qBAAqB,CAAC,QAAQ;QACpC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,uFAAuF;AACvF,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,qBAAqB,CAAC,QAAQ;QACpC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,qBAAqB,CAAC,MAAM;gBAClC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,aAAa;gBACpB,IAAI,EAAE,qBAAqB,CAAC,SAAS;gBACrC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,qBAAqB,CAAC,MAAM;gBAClC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,qBAAqB,CAAC,OAAO;gBACnC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;YACpC;gBACE,EAAE,EAAE,kBAAkB;gBACtB,KAAK,EAAE,oBAAoB;gBAC3B,IAAI,EAAE,qBAAqB,CAAC,gBAAgB;gBAC5C,WAAW,EAAE,KAAK;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,yEAAyE;AACzE,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,qBAAqB,CAAC,UAAU;QACtC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,qBAAqB,CAAC,QAAQ;gBACpC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;YACD;gBACE,EAAE,EAAE,OAAO;gBACX,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,qBAAqB,CAAC,KAAK;gBACjC,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI;aACd;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/menu.d.ts

@@ -0,0 +1,13 @@
+import type { MenuBackend, MenuItemTemplate, MenuSignals } from '@flighthq/types';
+export declare function cloneMenuTemplate(template: Readonly<MenuItemTemplate>): MenuItemTemplate;
+export declare function createMenuItemTemplate(template?: Readonly<Partial<MenuItemTemplate>>): MenuItemTemplate;
+export declare function createWebMenuBackend(): MenuBackend;
+export declare function enableMenuSignals(): MenuSignals;
+export declare function getMenuBackend(): MenuBackend;
+export declare function getMenuSignals(): Readonly<MenuSignals> | null;
+export declare function onMenuSelect(listener: (id: string) => void): () => void;
+export declare function setApplicationMenu(items: readonly MenuItemTemplate[]): boolean;
+export declare function setMenuBackend(backend: MenuBackend | null): void;
+export declare function showContextMenu(items: readonly MenuItemTemplate[], x: number, y: number): Promise<string | null>;
+export declare function validateMenuItemTemplate(template: Readonly<MenuItemTemplate>): string | null;
+//# sourceMappingURL=menu.d.ts.map

package/dist/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIlF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAMxF;AAKD,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,gBAAgB,CAUvG;AAKD,wBAAgB,oBAAoB,IAAI,WAAW,CAclD;AAKD,wBAAgB,iBAAiB,IAAI,WAAW,CAU/C;AAGD,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAGD,wBAAgB,cAAc,IAAI,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAE7D;AAKD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAKvE;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAE9E;AAGD,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEhE;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQhH;AAKD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,GAAG,IAAI,CAE5F"}

package/dist/menu.js

@@ -0,0 +1,329 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+// Deep-clones a MenuItemTemplate tree. The returned tree has the same shape and values. Safe to call
+// with a template carrying a submenu — children are cloned recursively.
+export function cloneMenuTemplate(template) {
+    const clone = { ...template };
+    if (template.submenu !== undefined) {
+        clone.submenu = template.submenu.map(cloneMenuTemplate);
+    }
+    return clone;
+}
+// Builds a menu item template, filling defaults (type 'normal', enabled true). Recursively normalizes
+// any submenu children through the same default-fill, so every item in the tree has canonical defaults
+// regardless of nesting depth.
+export function createMenuItemTemplate(template) {
+    const item = {
+        type: 'normal',
+        enabled: true,
+        ...template,
+    };
+    if (item.submenu !== undefined) {
+        item.submenu = item.submenu.map((child) => createMenuItemTemplate(child));
+    }
+    return item;
+}
+// Builds the default web backend. The app-menu bar returns false (native host required for a true menu
+// bar). popupContextMenu delegates to the DOM-rendered context-menu popup. subscribeSelect never fires
+// on web (no native app menu).
+export function createWebMenuBackend() {
+    return {
+        setApplicationMenu() {
+            // Web has no native menu bar; return false (not an error — caller should handle gracefully).
+            return false;
+        },
+        popupContextMenu(items, x, y) {
+            return showWebContextMenu(items, x, y);
+        },
+        subscribeSelect() {
+            // Web app-menu has no select source — native host required.
+            return () => { };
+        },
+    };
+}
+// Activates the optional MenuSignals group and returns it. Calling this is when the cost is assumed.
+// The returned object is shared for the lifetime of the package; calling enableMenuSignals multiple
+// times returns the same instance. Connect slots via connectSignal from @flighthq/signals.
+export function enableMenuSignals() {
+    if (_menuSignals === null) {
+        _menuSignals = {
+            onContextMenuClose: createSignal(),
+            onContextMenuOpen: createSignal(),
+            onMenuItemHighlight: createSignal(),
+            onMenuItemSelect: createSignal(),
+        };
+    }
+    return _menuSignals;
+}
+// Returns the active backend; lazily creates a web default on first call.
+export function getMenuBackend() {
+    if (_backend === null)
+        _backend = createWebMenuBackend();
+    return _backend;
+}
+// Returns the active MenuSignals group, or null if enableMenuSignals has not been called.
+export function getMenuSignals() {
+    return _menuSignals;
+}
+// Subscribes to application menu item selections by item id. Returns an unsubscribe function. On web
+// this never fires (no native app menu bar). Selections are also fanned out to onMenuItemSelect when
+// the MenuSignals group is enabled.
+export function onMenuSelect(listener) {
+    return getMenuBackend().subscribeSelect((id) => {
+        listener(id);
+        if (_menuSignals !== null)
+            emitSignal(_menuSignals.onMenuItemSelect, id);
+    });
+}
+// Installs the application menu bar. Returns true on success, or false when the host lacks a native
+// menu bar (e.g. web).
+export function setApplicationMenu(items) {
+    return getMenuBackend().setApplicationMenu(items);
+}
+// Sets the active menu backend; pass null to fall back to the web default.
+export function setMenuBackend(backend) {
+    _backend = backend;
+}
+// Pops up a context menu at (x, y) and resolves the clicked item id, or null when dismissed. On web,
+// renders a positioned DOM popup (separators, enabled/checked rendering, dismiss on outside-click /
+// Escape). On a native host, delegates to the OS context menu.
+export function showContextMenu(items, x, y) {
+    if (_menuSignals !== null)
+        emitSignal(_menuSignals.onContextMenuOpen);
+    const promise = getMenuBackend().popupContextMenu(items, x, y);
+    if (_menuSignals !== null) {
+        const signals = _menuSignals;
+        void promise.then(() => emitSignal(signals.onContextMenuClose));
+    }
+    return promise;
+}
+// Validates a MenuItemTemplate tree for consistency. Returns null on success, or a string describing
+// the first violation found. Does not throw — returns a sentinel for expected failures. Throws only
+// for cyclic submenu references (programmer error).
+export function validateMenuItemTemplate(template) {
+    return _validateItem(template, new Set());
+}
+let _backend = null;
+let _menuSignals = null;
+function _validateItem(item, seen) {
+    if (seen.has(item)) {
+        throw new Error('validateMenuItemTemplate: cyclic submenu reference detected');
+    }
+    if (item.type === 'separator') {
+        if (item.label !== undefined && item.label !== '') {
+            return `separator item has a label: "${item.label}" (separators should not have labels)`;
+        }
+        if (item.accelerator !== undefined) {
+            return `separator item has an accelerator: "${item.accelerator}"`;
+        }
+        if (item.submenu !== undefined) {
+            return 'separator item has a submenu';
+        }
+        return null;
+    }
+    if (item.type !== 'submenu' && item.submenu !== undefined && item.submenu.length > 0) {
+        return `item type "${item.type ?? 'normal'}" has a submenu (only type "submenu" should carry children)`;
+    }
+    if (item.submenu !== undefined) {
+        seen.add(item);
+        for (const child of item.submenu) {
+            const err = _validateItem(child, seen);
+            if (err !== null)
+                return err;
+        }
+        seen.delete(item);
+    }
+    return null;
+}
+// --- Web context-menu renderer ---
+// Renders a minimal DOM popup for showContextMenu in a browser environment. Returns the clicked item
+// id or null when the menu is dismissed without a selection. Supports keyboard navigation (ArrowUp/
+// Down, Enter, Escape) and submenu expansion on hover/arrow-right.
+function showWebContextMenu(items, x, y) {
+    return new Promise((resolve) => {
+        if (typeof document === 'undefined') {
+            resolve(null);
+            return;
+        }
+        const overlay = document.createElement('div');
+        overlay.style.cssText = 'position:fixed;inset:0;z-index:2147483646;';
+        const menu = buildWebMenuElement(items, (id) => close(id));
+        function clampMenu(el, anchorX, anchorY) {
+            el.style.left = `${anchorX}px`;
+            el.style.top = `${anchorY}px`;
+            const rect = el.getBoundingClientRect();
+            const vw = typeof window !== 'undefined' ? window.innerWidth : 0;
+            const vh = typeof window !== 'undefined' ? window.innerHeight : 0;
+            if (rect.right > vw)
+                el.style.left = `${Math.max(0, anchorX - rect.width)}px`;
+            if (rect.bottom > vh)
+                el.style.top = `${Math.max(0, anchorY - rect.height)}px`;
+        }
+        function close(selectedId) {
+            document.removeEventListener('keydown', onKeyDown);
+            overlay.remove();
+            menu.remove();
+            resolve(selectedId);
+        }
+        // Keyboard navigation
+        const focusableItems = menu.querySelectorAll('li[data-enabled="true"]');
+        let focusIndex = -1;
+        function moveFocus(delta) {
+            const items = Array.from(focusableItems);
+            if (items.length === 0)
+                return;
+            focusIndex = (focusIndex + delta + items.length) % items.length;
+            items.forEach((el, i) => {
+                if (i === focusIndex) {
+                    el.setAttribute('data-focused', 'true');
+                    el.style.background = '#0066cc';
+                    el.style.color = '#fff';
+                }
+                else {
+                    el.removeAttribute('data-focused');
+                    el.style.background = '';
+                    el.style.color = '#111';
+                }
+            });
+            if (_menuSignals !== null) {
+                const focused = items[focusIndex];
+                const itemId = focused?.dataset['itemId'];
+                if (itemId !== undefined)
+                    emitSignal(_menuSignals.onMenuItemHighlight, itemId);
+            }
+        }
+        function onKeyDown(e) {
+            if (e.key === 'Escape') {
+                e.preventDefault();
+                close(null);
+            }
+            else if (e.key === 'ArrowDown') {
+                e.preventDefault();
+                moveFocus(1);
+            }
+            else if (e.key === 'ArrowUp') {
+                e.preventDefault();
+                moveFocus(-1);
+            }
+            else if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault();
+                const focused = Array.from(focusableItems)[focusIndex];
+                if (focused !== undefined) {
+                    const itemId = focused.dataset['itemId'];
+                    if (itemId !== undefined)
+                        close(itemId);
+                }
+            }
+        }
+        overlay.addEventListener('click', () => close(null));
+        document.addEventListener('keydown', onKeyDown);
+        document.body.appendChild(overlay);
+        document.body.appendChild(menu);
+        clampMenu(menu, x, y);
+    });
+}
+function buildWebMenuElement(items, onSelect) {
+    const menu = document.createElement('ul');
+    menu.style.cssText = [
+        'position:fixed',
+        'z-index:2147483647',
+        'margin:0',
+        'padding:4px 0',
+        'list-style:none',
+        'background:#fff',
+        'border:1px solid #ccc',
+        'border-radius:4px',
+        'box-shadow:0 4px 12px rgba(0,0,0,.15)',
+        'min-width:160px',
+        'font:13px/1.4 system-ui,sans-serif',
+        'color:#111',
+        'user-select:none',
+    ].join(';');
+    for (const item of items) {
+        const li = document.createElement('li');
+        if (item.type === 'separator') {
+            li.style.cssText = 'height:1px;margin:4px 8px;background:#e0e0e0;';
+            menu.appendChild(li);
+            continue;
+        }
+        const enabled = item.enabled !== false;
+        const hasSubmenu = item.submenu !== undefined && item.submenu.length > 0;
+        li.setAttribute('data-enabled', enabled ? 'true' : 'false');
+        if (item.id !== undefined)
+            li.dataset['itemId'] = item.id;
+        li.style.cssText = [
+            'display:flex',
+            'align-items:center',
+            'padding:5px 12px 5px 28px',
+            'cursor:' + (enabled ? 'default' : 'not-allowed'),
+            'color:' + (enabled ? '#111' : '#999'),
+            'position:relative',
+        ].join(';');
+        // Checkmark / radio dot
+        if (item.checked === true) {
+            const mark = document.createElement('span');
+            mark.textContent = item.type === 'radio' ? '●' : '✓';
+            mark.style.cssText = 'position:absolute;left:8px;font-size:11px;';
+            li.appendChild(mark);
+        }
+        const labelEl = document.createElement('span');
+        labelEl.textContent = item.label ?? '';
+        labelEl.style.cssText = 'flex:1;';
+        li.appendChild(labelEl);
+        if (hasSubmenu) {
+            const arrow = document.createElement('span');
+            arrow.textContent = '▶';
+            arrow.style.cssText = 'margin-left:8px;font-size:9px;color:#888;';
+            li.appendChild(arrow);
+        }
+        else if (item.accelerator !== undefined) {
+            const accel = document.createElement('span');
+            accel.textContent = item.accelerator;
+            accel.style.cssText = 'margin-left:24px;color:#888;font-size:11px;';
+            li.appendChild(accel);
+        }
+        if (enabled) {
+            li.addEventListener('mouseenter', () => {
+                li.style.background = '#0066cc';
+                li.style.color = '#fff';
+                const accelEl = li.querySelector('span:last-child');
+                if (accelEl !== null && accelEl !== labelEl)
+                    accelEl.style.color = 'rgba(255,255,255,.7)';
+                if (_menuSignals !== null && item.id !== undefined) {
+                    emitSignal(_menuSignals.onMenuItemHighlight, item.id);
+                }
+            });
+            li.addEventListener('mouseleave', () => {
+                li.style.background = '';
+                li.style.color = '#111';
+                const accelEl = li.querySelector('span:last-child');
+                if (accelEl !== null && accelEl !== labelEl)
+                    accelEl.style.color = '#888';
+            });
+            if (hasSubmenu) {
+                // Submenu: open on hover, select from child list.
+                const submenuEl = buildWebMenuElement(item.submenu, onSelect);
+                submenuEl.style.position = 'absolute';
+                submenuEl.style.top = '0';
+                submenuEl.style.left = '100%';
+                submenuEl.style.display = 'none';
+                li.appendChild(submenuEl);
+                li.addEventListener('mouseenter', () => {
+                    submenuEl.style.display = 'block';
+                });
+                li.addEventListener('mouseleave', () => {
+                    submenuEl.style.display = 'none';
+                });
+            }
+            else if (item.id !== undefined) {
+                const itemId = item.id;
+                li.addEventListener('click', (e) => {
+                    e.stopPropagation();
+                    onSelect(itemId);
+                });
+            }
+        }
+        menu.appendChild(li);
+    }
+    return menu;
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/menu",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Native application and context menus over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/menu-templates.test.ts

@@ -0,0 +1,162 @@
+import type { MenuItemTemplate } from '@flighthq/types';
+
+import {
+  createDefaultAppMenuTemplate,
+  createDefaultEditMenuTemplate,
+  createDefaultFileMenuTemplate,
+  createDefaultHelpMenuTemplate,
+  createDefaultViewMenuTemplate,
+  createDefaultWindowMenuTemplate,
+} from './menu-templates';
+
+function collectIds(items: readonly MenuItemTemplate[]): string[] {
+  const ids: string[] = [];
+  for (const item of items) {
+    if (item.id !== undefined) ids.push(item.id);
+    if (item.submenu !== undefined) ids.push(...collectIds(item.submenu));
+  }
+  return ids;
+}
+
+describe('createDefaultAppMenuTemplate', () => {
+  it('returns a submenu template with the app name as label', () => {
+    const menu = createDefaultAppMenuTemplate('MyApp');
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('MyApp');
+    expect(menu.role).toBe('appMenu');
+  });
+  it('includes about, hide, quit items with app name interpolation', () => {
+    const menu = createDefaultAppMenuTemplate('MyApp');
+    const sub = menu.submenu!;
+    const about = sub.find((i) => i.id === 'about');
+    const quit = sub.find((i) => i.id === 'quit');
+    const hide = sub.find((i) => i.id === 'hide');
+    expect(about?.label).toBe('About MyApp');
+    expect(quit?.label).toBe('Quit MyApp');
+    expect(hide?.label).toBe('Hide MyApp');
+  });
+  it('includes accelerators for hide and quit', () => {
+    const menu = createDefaultAppMenuTemplate('MyApp');
+    const sub = menu.submenu!;
+    const quit = sub.find((i) => i.id === 'quit');
+    const hide = sub.find((i) => i.id === 'hide');
+    expect(quit?.accelerator).toBeDefined();
+    expect(hide?.accelerator).toBeDefined();
+  });
+  it('all items have enabled true by default', () => {
+    const menu = createDefaultAppMenuTemplate('MyApp');
+    const items = [menu, ...(menu.submenu ?? [])];
+    for (const item of items) {
+      if (item.type !== 'separator') {
+        expect(item.enabled).toBe(true);
+      }
+    }
+  });
+});
+
+describe('createDefaultEditMenuTemplate', () => {
+  it('returns a submenu template with label Edit and role editMenu', () => {
+    const menu = createDefaultEditMenuTemplate();
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('Edit');
+    expect(menu.role).toBe('editMenu');
+  });
+  it('includes undo, redo, cut, copy, paste, delete, selectAll', () => {
+    const menu = createDefaultEditMenuTemplate();
+    const ids = collectIds([menu]);
+    expect(ids).toContain('undo');
+    expect(ids).toContain('redo');
+    expect(ids).toContain('cut');
+    expect(ids).toContain('copy');
+    expect(ids).toContain('paste');
+    expect(ids).toContain('delete');
+    expect(ids).toContain('selectAll');
+  });
+  it('items carry well-known role strings', () => {
+    const menu = createDefaultEditMenuTemplate();
+    const undo = menu.submenu!.find((i) => i.id === 'undo');
+    expect(undo?.role).toBe('undo');
+  });
+  it('includes separators between groups', () => {
+    const menu = createDefaultEditMenuTemplate();
+    const hasSeparator = menu.submenu!.some((i) => i.type === 'separator');
+    expect(hasSeparator).toBe(true);
+  });
+});
+
+describe('createDefaultFileMenuTemplate', () => {
+  it('returns a submenu template with label File and role fileMenu', () => {
+    const menu = createDefaultFileMenuTemplate();
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('File');
+    expect(menu.role).toBe('fileMenu');
+  });
+  it('includes newFile, openFile, saveFile, saveFileAs, closeFile', () => {
+    const menu = createDefaultFileMenuTemplate();
+    const ids = collectIds([menu]);
+    expect(ids).toContain('newFile');
+    expect(ids).toContain('openFile');
+    expect(ids).toContain('saveFile');
+    expect(ids).toContain('saveFileAs');
+    expect(ids).toContain('closeFile');
+  });
+  it('includes accelerators for New and Save', () => {
+    const menu = createDefaultFileMenuTemplate();
+    const newItem = menu.submenu!.find((i) => i.id === 'newFile');
+    const saveItem = menu.submenu!.find((i) => i.id === 'saveFile');
+    expect(newItem?.accelerator).toBeDefined();
+    expect(saveItem?.accelerator).toBeDefined();
+  });
+  it('includes separators between groups', () => {
+    const menu = createDefaultFileMenuTemplate();
+    const hasSeparator = menu.submenu!.some((i) => i.type === 'separator');
+    expect(hasSeparator).toBe(true);
+  });
+});
+
+describe('createDefaultHelpMenuTemplate', () => {
+  it('returns a submenu template with label Help and role helpMenu', () => {
+    const menu = createDefaultHelpMenuTemplate();
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('Help');
+    expect(menu.role).toBe('helpMenu');
+  });
+  it('includes a help search item', () => {
+    const menu = createDefaultHelpMenuTemplate();
+    const ids = collectIds([menu]);
+    expect(ids).toContain('help');
+  });
+});
+
+describe('createDefaultViewMenuTemplate', () => {
+  it('returns a submenu template with label View and role viewMenu', () => {
+    const menu = createDefaultViewMenuTemplate();
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('View');
+    expect(menu.role).toBe('viewMenu');
+  });
+  it('includes reload, zoomIn, zoomOut, resetZoom, toggleFullscreen', () => {
+    const menu = createDefaultViewMenuTemplate();
+    const ids = collectIds([menu]);
+    expect(ids).toContain('reload');
+    expect(ids).toContain('zoomIn');
+    expect(ids).toContain('zoomOut');
+    expect(ids).toContain('resetZoom');
+    expect(ids).toContain('toggleFullscreen');
+  });
+});
+
+describe('createDefaultWindowMenuTemplate', () => {
+  it('returns a submenu template with label Window and role windowMenu', () => {
+    const menu = createDefaultWindowMenuTemplate();
+    expect(menu.type).toBe('submenu');
+    expect(menu.label).toBe('Window');
+    expect(menu.role).toBe('windowMenu');
+  });
+  it('includes minimize and close items', () => {
+    const menu = createDefaultWindowMenuTemplate();
+    const ids = collectIds([menu]);
+    expect(ids).toContain('minimize');
+    expect(ids).toContain('close');
+  });
+});

package/src/menu.test.ts

@@ -0,0 +1,162 @@
+import type { MenuBackend } from '@flighthq/types';
+
+import {
+  cloneMenuTemplate,
+  createMenuItemTemplate,
+  createWebMenuBackend,
+  enableMenuSignals,
+  getMenuBackend,
+  getMenuSignals,
+  onMenuSelect,
+  setApplicationMenu,
+  setMenuBackend,
+  showContextMenu,
+  validateMenuItemTemplate,
+} from './menu';
+
+function fakeBackend(overrides?: Partial<MenuBackend>): MenuBackend {
+  return {
+    setApplicationMenu: () => true,
+    popupContextMenu: () => Promise.resolve(null),
+    subscribeSelect: () => () => {},
+    ...overrides,
+  };
+}
+
+describe('cloneMenuTemplate', () => {
+  it('produces an equal but distinct tree', () => {
+    const original = createMenuItemTemplate({
+      id: 'file',
+      type: 'submenu',
+      submenu: [{ id: 'open', label: 'Open' }],
+    });
+    const clone = cloneMenuTemplate(original);
+    expect(clone).toStrictEqual(original);
+    expect(clone).not.toBe(original);
+    expect(clone.submenu).not.toBe(original.submenu);
+    expect(clone.submenu![0]).not.toBe(original.submenu![0]);
+  });
+});
+
+describe('createMenuItemTemplate', () => {
+  it('fills type and enabled defaults', () => {
+    const item = createMenuItemTemplate({ id: 'copy', label: 'Copy' });
+    expect(item.type).toBe('normal');
+    expect(item.enabled).toBe(true);
+  });
+
+  it('normalizes submenu children recursively', () => {
+    const item = createMenuItemTemplate({ type: 'submenu', submenu: [{ id: 'child' }] });
+    expect(item.submenu![0].type).toBe('normal');
+    expect(item.submenu![0].enabled).toBe(true);
+  });
+});
+
+describe('createWebMenuBackend', () => {
+  it('reports no native application menu', () => {
+    const backend = createWebMenuBackend();
+    expect(backend.setApplicationMenu([])).toBe(false);
+  });
+
+  it('returns an unsubscribe function from subscribeSelect', () => {
+    const backend = createWebMenuBackend();
+    expect(typeof backend.subscribeSelect(() => {})).toBe('function');
+  });
+});
+
+describe('enableMenuSignals', () => {
+  it('returns a stable instance across calls', () => {
+    expect(enableMenuSignals()).toBe(enableMenuSignals());
+  });
+});
+
+describe('getMenuBackend', () => {
+  afterEach(() => setMenuBackend(null));
+
+  it('lazily returns a web default backend', () => {
+    setMenuBackend(null);
+    expect(getMenuBackend()).not.toBeNull();
+  });
+});
+
+describe('getMenuSignals', () => {
+  it('returns the active signal group once enabled', () => {
+    const signals = enableMenuSignals();
+    expect(getMenuSignals()).toBe(signals);
+  });
+});
+
+describe('onMenuSelect', () => {
+  afterEach(() => setMenuBackend(null));
+
+  it('delivers the selected id from the backend', () => {
+    let captured: ((id: string) => void) | null = null;
+    setMenuBackend(
+      fakeBackend({
+        subscribeSelect: (l) => {
+          captured = l;
+          return () => {};
+        },
+      }),
+    );
+    const received: string[] = [];
+    onMenuSelect((id) => received.push(id));
+    captured!('save');
+    expect(received).toEqual(['save']);
+  });
+});
+
+describe('setApplicationMenu', () => {
+  afterEach(() => setMenuBackend(null));
+
+  it('delegates to the active backend', () => {
+    let installed = 0;
+    setMenuBackend(
+      fakeBackend({
+        setApplicationMenu: (i) => {
+          installed = i.length;
+          return true;
+        },
+      }),
+    );
+    expect(setApplicationMenu([{ id: 'a' }])).toBe(true);
+    expect(installed).toBe(1);
+  });
+});
+
+describe('setMenuBackend', () => {
+  afterEach(() => setMenuBackend(null));
+
+  it('installs an explicit backend and reverts to the web default on null', () => {
+    const backend = fakeBackend();
+    setMenuBackend(backend);
+    expect(getMenuBackend()).toBe(backend);
+    setMenuBackend(null);
+    expect(getMenuBackend()).not.toBe(backend);
+  });
+});
+
+describe('showContextMenu', () => {
+  afterEach(() => setMenuBackend(null));
+
+  it('resolves the id returned by the backend popup', async () => {
+    setMenuBackend(fakeBackend({ popupContextMenu: () => Promise.resolve('copy') }));
+    await expect(showContextMenu([], 0, 0)).resolves.toBe('copy');
+  });
+});
+
+describe('validateMenuItemTemplate', () => {
+  it('returns null for a well-formed item', () => {
+    expect(validateMenuItemTemplate(createMenuItemTemplate({ id: 'ok', label: 'Ok' }))).toBeNull();
+  });
+
+  it('rejects a separator that carries a label', () => {
+    expect(validateMenuItemTemplate({ type: 'separator', label: 'X' })).not.toBeNull();
+  });
+
+  it('throws on a cyclic submenu reference', () => {
+    const node = createMenuItemTemplate({ type: 'submenu' });
+    node.submenu = [node];
+    expect(() => validateMenuItemTemplate(node)).toThrow();
+  });
+});