@forgeax/interface 0.6.0 → 0.7.0

package/dist/package/browser/ApplicationShell.js

@@ -46,7 +46,8 @@ export function ApplicationShell({ runtime, onboarding }) {
     useEffect(() => {
         if (!isTauri())
             return;
-        void initNativeMenuBridge({
+        return initNativeMenuBridge({
+            menus: runtime.host.menus,
             execute: (id, args) => runtime.host.commands.execute(id, args),
             translate: t,
         });

package/dist/package/browser/appHostBootstrap.js

@@ -61,9 +61,14 @@ export async function bootstrapAppHost(overrides = {}) {
         ...m,
         async setup(ctx) {
             control.beginSetup(m);
+            const menuCleanups = [];
             try {
                 const cleanups = [];
                 let pageCleanup;
+                for (const menu of m.contributes?.menus ?? []) {
+                    menuCleanups.push(host.menus.register(menu));
+                }
+                cleanups.push(...menuCleanups);
                 if (m.contributes?.panels) {
                     cleanups.push(control.contributePanels(m.id, m.contributes.panels));
                 }
@@ -94,6 +99,11 @@ export async function bootstrapAppHost(overrides = {}) {
                         await c();
                 };
             }
+            catch (error) {
+                for (const cleanup of menuCleanups.slice().reverse())
+                    await cleanup();
+                throw error;
+            }
             finally {
                 control.endSetup();
             }

package/dist/package/browser/components/MenuBar/MenuBar.d.ts

@@ -1,5 +1,6 @@
 import { type TFunction } from '../../i18n';
-import { type MenuId, type MenuItemDef } from '../../lib/menu-registry';
+import type { MenuId } from '../../lib/menu-registry';
+import type { ApplicationMenuItem as MenuItemDef } from '@forgeax/app-shell/application';
 import './MenuBar.css';
 /** 第三个参数 itemId 是**记账用**的稳定菜单项 id(如 file.save)。可选,所以
  *  只传两参的既有调用点照常编译。为什么需要它:人机同账要求两侧记录形状一致 ——
@@ -9,7 +10,7 @@ import './MenuBar.css';
 type Execute = (id: string, args?: unknown, itemId?: string) => void;
 interface TopMenuProps {
     menu: MenuId;
-    items: MenuItemDef[];
+    items: readonly MenuItemDef[];
     t: TFunction;
     execute: Execute;
     /** Controlled open flag — the whole bar shares one "which menu is open"

package/dist/package/browser/components/MenuBar/MenuBar.js

@@ -17,20 +17,19 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * time; the underlying accessor is identical). This keeps keyboard shortcuts,
  * command palette, and menu clicks on one entry.
  */
-import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';
+import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from 'react';
 import { BookOpen, BoxSelect, Check, Clipboard, Clock, Code, Copy, FilePlus, FlipHorizontal2, Focus, FolderOpen, FolderSearch, Gamepad2, Github, Globe, GraduationCap, Hash, Info, Keyboard, LayoutGrid, Maximize, MessageCircle, Newspaper, Package, Pencil, Play, Redo2, RefreshCw, RotateCcw, Save, SaveAll, Scale, Scan, Scissors, ScrollText, Search, Settings, Shapes, Sparkles, Square, SquareDashed, Store, Trash2, Undo2, Upload, X, } from 'lucide-react';
 import { useTranslation } from '../../i18n';
 import { useHost } from '../../core/app-shell';
 import { useBrand } from '../../brand/BrandProvider';
 import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from '../ui/dropdown-menu';
-import { onMenuChange, snapshotAllMenus, } from '../../lib/menu-registry';
+import { projectApplicationMenus } from '../../lib/application-menu-projection';
 import { prettyCombo } from '../../lib/global-shortcuts';
 import { useMenubarSurface } from './menubar-surface';
 import { openMenuFromTriggerPointerDown } from './menubar-open-state';
 import { isTauri } from '../../lib/platform/runtime';
 import { captureFocusedTextEditTarget } from '../../lib/text-edit-actions';
 import { getRecentGamesRevision, subscribeRecentGames, warmRecentGames, } from '../../lib/recent-games';
-import { repairBuiltinMenusIfEmpty } from '../../lib/repair-builtin-menus';
 import './MenuBar.css';
 // Icon name → lucide component. Mirrors ContextMenu.tsx's MENU_ICONS pattern
 // (single-file lookup so an unknown name gracefully renders no icon rather
@@ -83,30 +82,7 @@ const MENU_ICONS = {
     upload: Upload,
     x: X,
 };
-// ── snapshot cache (stable identity across getSnapshot calls) ────────────
-// snapshotAllMenus() computes a fresh object each call; useSyncExternalStore
-// requires that repeated getSnapshot() reads return the SAME identity until
-// the store actually changes, else React re-renders on every read (potential
-// infinite loop). Module-level cache + a single change-listener keeps identity
-// stable between registrations. Registry lives as long as this module, so a
-// single unbound listener at import time is fine (no cleanup handle needed).
-let cachedSnapshot = snapshotAllMenus();
-onMenuChange(() => { cachedSnapshot = snapshotAllMenus(); });
-function getSnapshot() {
-    return cachedSnapshot;
-}
-// SSR/server snapshot — stable identity across calls. This app is a pure
-// client build, so this branch never actually fires; providing it satisfies
-// the useSyncExternalStore contract and future-proofs against SSR.
-const EMPTY_SNAPSHOT = Object.freeze({
-    brand: [], file: [], edit: [], window: [], build: [], select: [], help: [], publish: [],
-});
-function getServerSnapshot() {
-    return EMPTY_SNAPSHOT;
-}
-function subscribe(cb) {
-    return onMenuChange(cb);
-}
+const EMPTY_MENU_ITEMS = Object.freeze([]);
 // Top-level dropdowns rendered on web, in order. `publish` is excluded (TopBar
 // owns the Publish CTA at the far right); `brand` renders separately at the
 // far left.
@@ -130,7 +106,7 @@ function MenuItemRow({ item, t, execute }) {
     if (item.when && !item.when())
         return null;
     const enabled = resolveEnabled(item);
-    const label = t(item.labelKey);
+    const label = item.label;
     const combo = item.keybinding ? prettyCombo(item.keybinding) : '';
     const checked = item.checked ? item.checked() : false;
     const hasStaticChildren = !!item.children && item.children.length > 0;
@@ -209,12 +185,12 @@ export function TopMenu({ menu, items, t, execute, open, onOpenChange, onTrigger
 }
 // ── Public component ─────────────────────────────────────────────────────
 export function MenuBar() {
-    // StrictMode dispose / Vite HMR can leave the registry empty while chrome
-    // stays mounted — repair synchronously so the first render sees menus.
-    repairBuiltinMenusIfEmpty();
     const { t, i18n } = useTranslation();
-    const menus = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
     const host = useHost();
+    const subscribe = useCallback((listener) => host.menus.subscribe(listener), [host]);
+    const getSnapshot = useCallback(() => host.menus.snapshot(), [host]);
+    const items = useSyncExternalStore(subscribe, getSnapshot, () => EMPTY_MENU_ITEMS);
+    const menus = useMemo(() => projectApplicationMenus(items), [items]);
     // Same command bus TopBar uses. Fire-and-forget: menu clicks never await
     // the command result — that would block dropdown-close animation.
     // 纯执行,不记账。AI 经 host.menubar.invoke 走的就是这一个 —— 它那一路已经由
@@ -245,7 +221,7 @@ export function MenuBar() {
     // 传 i18n.language 而不是 t:`t` 是模块级恒定标识(i18n/index.ts 刻意如此,
     // 免得列进依赖数组造成无限重渲染),用它当依赖等于永不重投影 —— 切语言后 DOM
     // 变了、snapshot 还是旧语言,AI 按 label 导航与用户所见错位(2026-08-06 探测)。
-    useMenubarSurface(menus, t, executeForSurface, i18n.language);
+    useMenubarSurface(host.menus, t, executeForSurface, i18n.language);
     // One shared "which top-level menu is open" value for the whole bar. This is
     // what makes it behave like a native/UE menu bar rather than N unrelated
     // dropdowns: only one panel is open at a time, and once ANY panel is open,

package/dist/package/browser/components/MenuBar/menubar-surface.d.ts

@@ -1,4 +1,5 @@
 import type { TFunction } from '../../i18n';
+import type { ApplicationMenuRegistry } from '@forgeax/app-shell/application';
 export interface MenuTreeNode {
     id: string;
     label: string;
@@ -20,10 +21,10 @@ export interface MenuTreeNode {
 /** AI 路径的执行器**必须返回 promise**:run 会 await 它,命令失败 → throw →
  *  ack ok=false。人路径的 fire-and-forget 版本(不卡下拉动画)不在此签名内。 */
 type Execute = (commandId: string, args?: unknown) => Promise<unknown>;
-export declare function projectMenuTree(t: TFunction): Record<string, MenuTreeNode[]>;
+export declare function projectMenuTree(t: TFunction, registry: ApplicationMenuRegistry): Record<string, MenuTreeNode[]>;
 /** MenuBar 挂载时注册 host.menubar。menusRevision 传注册表快照对象,引用一变
  *  (注册表变更触发的重渲染)就重新投影 PUT。 */
-export declare function useMenubarSurface(menusRevision: unknown, t: TFunction, execute: Execute, 
+export declare function useMenubarSurface(registry: ApplicationMenuRegistry, t: TFunction, execute: Execute, 
 /** 当前语言。**必须**由调用方传:`t` 的标识是模块级恒定的(见 i18n/index.ts
  *  的注释:列进依赖会造成无限重渲染),拿它当依赖 = 永不重投影。 */
 language?: string): void;

package/dist/package/browser/components/MenuBar/menubar-surface.js

@@ -17,7 +17,7 @@
  */
 import { useEffect, useRef } from 'react';
 import { useSurface } from '../../lib/surface';
-import { snapshotAllMenus } from '../../lib/menu-registry';
+import { projectApplicationMenus } from '../../lib/application-menu-projection';
 import { warmRecentGames } from '../../lib/recent-games';
 const MENUBAR_SCHEMA = {
     type: 'object',
@@ -42,7 +42,7 @@ function projectItem(item, t) {
         .filter((node) => node !== null);
     return {
         id: item.id,
-        label: t(item.labelKey),
+        label: item.label,
         kind: isSub ? 'submenu' : item.commandId ? 'command' : 'placeholder',
         ...(item.commandId ? { commandId: item.commandId } : {}),
         ...(item.args !== undefined ? { args: item.args } : {}),
@@ -53,9 +53,9 @@ function projectItem(item, t) {
         ...(children && children.length ? { children } : {}),
     };
 }
-export function projectMenuTree(t) {
+export function projectMenuTree(t, registry) {
     const out = {};
-    for (const [menu, defs] of Object.entries(snapshotAllMenus())) {
+    for (const [menu, defs] of Object.entries(projectApplicationMenus(registry.snapshot()))) {
         out[menu] = defs
             .map((def) => projectItem(def, t))
             .filter((node) => node !== null);
@@ -64,7 +64,7 @@ export function projectMenuTree(t) {
 }
 /** 在注册表里解析一个可执行菜单项:先静态(含 children 递归),再对动态子菜单
  *  求值按 id 或 label 匹配(动态项的 labelKey 就是显示名,如游戏名)。 */
-function resolveInvokable(target, t) {
+function resolveInvokable(target, t, registry) {
     /** 与 projectItem 同一条谓词:`when()` 为假 = 该项在界面上根本不存在。
      *  2026-08-06 探测:此前只有投影过滤 when(),解析器完全不看 —— 一个在 snapshot
      *  和 DOM 里都不存在的项仍可被 invoke 执行。人点不到的东西 AI 不能点,否则
@@ -89,7 +89,7 @@ function resolveInvokable(target, t) {
             return null;
         }
         return kids.filter(visible).find((kid) => (target.itemId && kid.id === target.itemId)
-            || (target.label && (kid.labelKey === target.label || t(kid.labelKey) === target.label))) ?? null;
+            || (target.label && (kid.label === target.label || kid.label === target.label))) ?? null;
     };
     const walk = (defs) => {
         for (const def of defs) {
@@ -99,7 +99,7 @@ function resolveInvokable(target, t) {
                 continue;
             if (target.itemId && def.id === target.itemId)
                 return def;
-            if (target.label && !target.itemId && t(def.labelKey) === target.label)
+            if (target.label && !target.itemId && def.label === target.label)
                 return def;
             if (def.children) {
                 const hit = walk(def.children);
@@ -114,7 +114,7 @@ function resolveInvokable(target, t) {
         }
         return null;
     };
-    for (const defs of Object.values(snapshotAllMenus())) {
+    for (const defs of Object.values(projectApplicationMenus(registry.snapshot()))) {
         const hit = walk(defs);
         if (hit)
             return hit;
@@ -123,10 +123,13 @@ function resolveInvokable(target, t) {
 }
 /** MenuBar 挂载时注册 host.menubar。menusRevision 传注册表快照对象,引用一变
  *  (注册表变更触发的重渲染)就重新投影 PUT。 */
-export function useMenubarSurface(menusRevision, t, execute, 
+export function useMenubarSurface(registry, t, execute, 
 /** 当前语言。**必须**由调用方传:`t` 的标识是模块级恒定的(见 i18n/index.ts
  *  的注释:列进依赖会造成无限重渲染),拿它当依赖 = 永不重投影。 */
 language) {
+    const menusRevision = registry.snapshot();
+    const registryRef = useRef(registry);
+    registryRef.current = registry;
     const executeRef = useRef(execute);
     executeRef.current = execute;
     const tRef = useRef(t);
@@ -135,7 +138,7 @@ language) {
         id: 'host.menubar',
         layer: 'host',
         schema: MENUBAR_SCHEMA,
-        initialSnapshot: { menus: projectMenuTree(t) },
+        initialSnapshot: { menus: projectMenuTree(t, registry) },
         actions: {
             invoke: {
                 id: 'invoke',
@@ -149,14 +152,14 @@ language) {
                 },
                 run: async (raw) => {
                     const target = (raw ?? {});
-                    let def = resolveInvokable(target, tRef.current);
+                    let def = resolveInvokable(target, tRef.current, registryRef.current);
                     if (!def) {
                         // 冷缓存(2026-08-06 外审 B6②):动态子项(最近游戏)只在人点开 File 下拉
                         // 或 Tauri 原生菜单构建时被预热;web 模式下人没点过 File,dynamicChildren()
                         // 恒空,AI 按 id/label 解析动态项必然 not found —— 桌面能用、web 不能用。
                         // AI 先到时主动预热一次再重解析,与人"点开就看见"对齐。
                         await warmRecentGames();
-                        def = resolveInvokable(target, tRef.current);
+                        def = resolveInvokable(target, tRef.current, registryRef.current);
                     }
                     if (!def)
                         throw new Error(`menu item not found: ${JSON.stringify(target)}`);
@@ -195,7 +198,7 @@ language) {
         },
     });
     useEffect(() => {
-        surface.setSnapshot({ menus: projectMenuTree(tRef.current) });
+        surface.setSnapshot({ menus: projectMenuTree(tRef.current, registry) });
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [menusRevision, language]);
 }

package/dist/package/browser/core/app-shell/host.js

@@ -13,9 +13,9 @@ import { derivePanelRenderers } from './derive-panel-renderers';
 import { DEFAULT_PANEL_RENDERERS } from '../../components/DockShell/panelRenderers';
 import { installPageNavigation } from '../page-navigation';
 import { createContextualKeybindings } from '../contextual-keybindings';
-import { createApplicationShortcutRegistry } from '@forgeax/app-shell/application';
+import { createApplicationShortcutRegistry, createApplicationMenuRegistry } from '@forgeax/app-shell/application';
 const BUILT_IN_CAPS = [
-    'commands', 'keybindings', 'shortcuts', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
+    'commands', 'keybindings', 'shortcuts', 'menus', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
     'activities', 'resourceEditors',
 ];
 export function createAppHost(deps = {}) {
@@ -25,6 +25,7 @@ export function createAppHost(deps = {}) {
         caps.add(c);
     const commands = createCommandsRegistry();
     const shortcuts = createApplicationShortcutRegistry();
+    const menus = createApplicationMenuRegistry();
     const keybindings = createContextualKeybindings(commands, {
         onCommandError(error, commandId) {
             log.error(`[app-shell] keybinding command "${commandId}" failed`, error);
@@ -64,7 +65,7 @@ export function createAppHost(deps = {}) {
     const extensionFields = {};
     let activeSetup = null;
     const base = {
-        commands, keybindings, shortcuts, bus, storage, contextKeys,
+        commands, keybindings, shortcuts, menus, bus, storage, contextKeys,
         get panels() { return panelsSnapshot(); },
         panelActions,
         panelControls,
@@ -184,6 +185,7 @@ export function createAppHost(deps = {}) {
             await pageSession.dispose();
             keybindings.dispose();
             shortcuts.dispose();
+            menus.dispose();
             bus.destroy();
         },
     };

package/dist/package/browser/core/app-shell/types.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationShortcutRegistry } from '@forgeax/app-shell/application';
+import type { ApplicationShortcutRegistry, ApplicationMenuRegistry, ApplicationMenuItem } from '@forgeax/app-shell/application';
 import type { ExtensionManifest, Cleanup } from '../extension-foundation';
 import type { EventBus } from '../extension-foundation/bus';
 import type { CommandsRegistry, CommandDescriptor } from '../extension-foundation/commands';
@@ -115,6 +115,7 @@ export interface AppHostBase {
     readonly commands: CommandsRegistry;
     readonly keybindings: ContextualKeybindingsApi;
     readonly shortcuts: ApplicationShortcutRegistry;
+    readonly menus: ApplicationMenuRegistry;
     readonly bus: EventBus<AppBusEventMap>;
     readonly storage: StorageApi;
     readonly contextKeys: ContextKeysApi;
@@ -160,6 +161,7 @@ export interface AppExtensionContext {
  *  before setup() runs and removed with the extension's cleanup; a pure-UI
  *  extension is just data (no setup at all). */
 export interface AppExtensionContributes {
+    readonly menus?: readonly ApplicationMenuItem[];
     readonly panels?: Partial<PanelRenderers>;
     readonly panelActions?: readonly PanelActionContribution[];
     readonly panelControls?: readonly PanelControlContribution[];

package/dist/package/browser/core/extensions/builtin-menus.js

@@ -14,7 +14,7 @@
 // Mirrors the style of `builtin-commands.ts`: a single `AppExtension` whose
 // `setup(ctx)` calls the registrar for every item, collects the cleanups, and
 // returns a reverse-order cleanup runner.
-import { registerMenuItem } from '../../lib/menu-registry';
+import { t } from '../../i18n';
 import { isDockPanelVisible } from '@forgeax/app-shell/dock';
 import { useShellStore } from '../../store';
 import { getRecentGames } from '../../lib/recent-games';
@@ -28,10 +28,30 @@ const isVisible = (id) => () => isDockPanelVisible(id);
 // mounted, `chatpanelCollapsed` flips its collapsed state — invert for
 // "checked = visible".
 const isChatpanelOpen = () => !useShellStore.getState().chatpanelCollapsed;
+// Product section order is explicit, independent of extension activation order.
+const SECTION_ORDER = {
+    brand: { app: 10, about: 20 }, file: { game: 10, file: 20, io: 30, recent: 10 },
+    edit: { history: 10, clipboard: 20, find: 30, version: 40 },
+    window: { panels: 10, layout: 20 }, build: { run: 10, export: 20 },
+    select: { basic: 10, byCond: 20, view: 30 },
+    help: { docs: 10, resources: 20, app: 30, about: 40 },
+};
+function localizeMenu(def) {
+    const { labelKey, children, dynamicChildren, ...metadata } = def;
+    const groupOrder = SECTION_ORDER[def.menu]?.[def.group];
+    if (groupOrder === undefined)
+        throw new Error(`Missing menu section order: ${def.menu}/${def.group}`);
+    return {
+        ...metadata, groupOrder,
+        get label() { return t(labelKey); },
+        ...(children ? { children: children.map(localizeMenu) } : {}),
+        ...(dynamicChildren ? { dynamicChildren: () => dynamicChildren().map(localizeMenu) } : {}),
+    };
+}
 export const builtinMenusExtension = {
     id: 'builtin-menus',
     version: '1.0.0',
-    setup() {
+    setup({ host }) {
         const cleanups = [];
         // Every item to register — sorted by menu / group / order so the shape
         // reads top-to-bottom the way it renders. The registrar itself re-sorts
@@ -240,7 +260,7 @@ export const builtinMenusExtension = {
                 commandId: 'app.open_url', args: { url: 'https://www.apache.org/licenses/LICENSE-2.0' } },
         ];
         for (const def of items)
-            cleanups.push(registerMenuItem(def));
+            cleanups.push(host.menus.register(localizeMenu(def)));
         return () => {
             // Reverse order so first-registered is torn down last — same pattern
             // as builtin-commands.ts; `.slice()` clones the array so a repeat unload

package/dist/package/browser/lib/application-menu-projection.d.ts

@@ -0,0 +1,5 @@
+import type { ApplicationMenuItem } from '@forgeax/app-shell/application';
+import type { MenuId, NativeMenu } from './menu-registry';
+export declare function projectApplicationMenus(items: readonly ApplicationMenuItem[]): Record<MenuId, readonly ApplicationMenuItem[]>;
+/** Pure native projection of the same immutable snapshot used by the web menu. */
+export declare function serializeApplicationMenusForNative(items: readonly ApplicationMenuItem[]): NativeMenu[];

package/dist/package/browser/lib/application-menu-projection.js

@@ -0,0 +1,53 @@
+/** Product menu locations; contributions and their lifetime belong to the host. */
+const MENU_IDS = ['brand', 'file', 'edit', 'window', 'build', 'select', 'help', 'publish'];
+export function projectApplicationMenus(items) {
+    const result = {
+        brand: [], file: [], edit: [], window: [], build: [], select: [], help: [], publish: [],
+    };
+    for (const menu of MENU_IDS)
+        result[menu] = items.filter(item => item.menu === menu);
+    return result;
+}
+function serializeItem(item) {
+    if (item.when && !item.when())
+        return null;
+    const children = item.children?.length ? item.children : item.dynamicChildren?.();
+    const result = {
+        id: item.id,
+        // Already resolved by the owner, including live locale getters. Never
+        // reinterpret a contributor's literal label as an Interface locale key.
+        label: item.label,
+        enabled: item.enabled ? item.enabled() : children?.length ? true : !!item.commandId,
+    };
+    if (item.keybinding) {
+        result.accelerator = item.keybinding.split('+')
+            .map(part => part === 'Ctrl' ? 'CmdOrCtrl' : part).join('+');
+    }
+    if (item.danger)
+        result.danger = true;
+    if (children?.length) {
+        const projected = children.map(serializeItem).filter((child) => child !== null);
+        if (projected.length)
+            result.children = projected;
+    }
+    return result;
+}
+/** Pure native projection of the same immutable snapshot used by the web menu. */
+export function serializeApplicationMenusForNative(items) {
+    const menus = projectApplicationMenus(items);
+    return MENU_IDS.map(menu => {
+        const projected = [];
+        let previousGroup = null;
+        for (const item of menus[menu]) {
+            const native = serializeItem(item);
+            // Retain the existing bridge's hidden-row group boundary semantics.
+            if (native) {
+                if (previousGroup !== null && previousGroup !== item.group)
+                    native.separatorBefore = true;
+                projected.push(native);
+            }
+            previousGroup = item.group;
+        }
+        return { menu, items: projected };
+    });
+}

package/dist/package/browser/lib/menu-registry.d.ts

@@ -1,25 +1,3 @@
-/** menu-registry —— 顶部菜单栏的单一真值源 (SSOT for the menu bar).
- *
- *  一张注册表服务两个消费者 (压缩公理:消掉「Web 菜单和原生菜单是不是同一套?」):
- *    1. Web 端渲染器 (React) —— 通过 `snapshotMenu(...)` / `snapshotAllMenus()` + `onMenuChange`
- *       走 useSyncExternalStore 拿到当前菜单结构;
- *    2. Tauri 原生菜单桥接 —— 通过 `serializeMenusForNative(t)` 拿到已翻译、去函数、
- *       JSON 可序列化的原生菜单契约,一次性 build native menu / 每次注册表变化时 rebuild.
- *
- *  设计与 action-registry.ts 对齐 (模块级 Map 页级单例 + change listener):
- *    - 菜单项按 `menu`(顶层大类) + `group`(段落分组) + `order`(段内序) 三级组织;
- *    - 同 id 重复注册 = **替换** (幂等,HMR / StrictMode 双挂载安全,cleanup
- *      走身份检查避免误删);
- *    - 键位串遵循全仓 canonical combo 格式 (见 lib/global-shortcuts.ts `prettyCombo`),
- *      例:'Ctrl+S' / 'Ctrl+Shift+Z' / 'Ctrl+,'。Web 显示走 prettyCombo,原生菜单走
- *      `serializeMenusForNative` 内部的 accelerator 转换 (Ctrl→CmdOrCtrl,保留 Shift/Alt)。
- *
- *  分隔符策略 (评审):**注册者不显式发 separator sentinel** —— 只填 `group`,
- *  渲染器按 `snapshotMenu` 返回结果中相邻两项的 `group` 差异自行绘制分隔线;
- *  原生序列化则在 `serializeMenusForNative` 中把段边界翻成 `separatorBefore=true`。
- *  这样避免维护「三种分隔来源」(注册者手插 + 渲染器 + 原生桥)—— 一处派生 (§2 Derive)。
- */
-/** 菜单顶层大类。品牌菜单 (brand) 在 macOS 原生菜单里通常对应 app 菜单,由 T5 决定放置策略。 */
 export type MenuId = 'brand' | 'file' | 'edit' | 'window' | 'build' | 'select' | 'help' | 'publish';
 export interface MenuItemDef {
     /** 稳定唯一 id,例:'file.save' / 'window.toggle_chat'。重复注册会抛错。 */
@@ -64,23 +42,6 @@ export interface MenuItemDef {
      *  原生序列化不含动态子项 (native 菜单结构在 build 时固化)。 */
     dynamicChildren?: () => MenuItemDef[];
 }
-/** 注册一项菜单 —— 同 id 重复注册 = 替换 (幂等,HMR / StrictMode 双挂载安全)。
- *  返回 cleanup 函数;cleanup 幂等 (身份检查:仅当当前项仍是本次注册的 def
- *  才 delete,避免 A 注册→A 注销 后误删掉 B 的 same-id 覆盖)。
- *
- *  设计变更 (T7 集成):初版为 throw-on-duplicate,与 action-registry 的
- *  「替换即幂等」策略不一致 —— React StrictMode 会双执行 App.tsx 的
- *  bootstrapAppHost useEffect,两次 setup 并发跑到同一个模块级 Map 时必抛
- *  「duplicate menu item id」把整个菜单栏打空。改为 last-writer-wins 后
- *  两次 setup 都能顺利完成,先释放的 cleanup 通过身份检查不会误删,
- *  与 action-registry 的语义对齐 (§SSOT / 兄弟注册表一致性)。 */
-export declare function registerMenuItem(def: MenuItemDef): () => void;
-/** 注册表变更订阅 —— 供 useSyncExternalStore / native bridge rebuild 消费。 */
-export declare function onMenuChange(listener: () => void): () => void;
-/** 取单个菜单的排序后条目 —— 渲染器直接消费。 */
-export declare function snapshotMenu(menu: MenuId): MenuItemDef[];
-/** 取所有菜单的排序后条目,按 MenuId 组织。 */
-export declare function snapshotAllMenus(): Record<MenuId, MenuItemDef[]>;
 export interface NativeMenuItem {
     /** 对应 MenuItemDef.id。 */
     id: string;
@@ -101,13 +62,3 @@ export interface NativeMenu {
     menu: MenuId;
     items: NativeMenuItem[];
 }
-/** 序列化全部菜单为原生契约 —— T5 (Tauri 桥) 的唯一入口。契约要点:
- *    - `when === false` 的项被 drop;
- *    - `enabled` 缺省时默认 = `!!commandId` (无命令 = 禁用);
- *    - `labelKey` 走 `translate` 翻译,函数不出墙;
- *    - `keybinding` 转 native accelerator (Ctrl→CmdOrCtrl,Shift/Alt 保留);
- *    - 段边界翻成 `separatorBefore=true` (每个菜单首项除外);
- *    - 输出**完全 JSON 可序列化** (JSON.stringify 无损 roundtrip,无函数残留)。 */
-export declare function serializeMenusForNative(translate: (key: string) => string): NativeMenu[];
-/** 清空注册表 —— 仅供单测 beforeEach 使用。 */
-export declare function __resetMenuRegistryForTest(): void;