@forgeax/interface 0.5.0 → 0.7.0

package/dist/package/browser/lib/global-shortcuts.d.ts

@@ -10,7 +10,7 @@
  *   Ctrl+/        focus chat composer
  *   Ctrl+Shift+H  open Settings → Changelog (was Ctrl+H before 2026-08-04 —
  *                 UE-parity editor hide claimed Ctrl+H for "show all hidden")
- *   Esc           stop viewport Play; otherwise close current overlay
+ *   Esc           close current overlay (higher-priority owners may claim it)
  *                 (Settings → Dashboard → Fullscreen)
  *
  * IME 安全:
@@ -21,75 +21,15 @@
  *
  * 注册:在 App 顶层调用 `useGlobalShortcuts()` 一次。
  */
+import type { ApplicationShortcut, ApplicationShortcutRegistry } from '@forgeax/app-shell/application';
 import type { ContextualKeybindingsApi } from '../core/contextual-keybindings';
-export interface ShortcutDef {
-    /** 显示给用户的字符串,e.g. "Ctrl+Shift+F"。Mac 上 UI 会自动替换 Ctrl → ⌘/⌃。 */
-    combo: string;
-    /** 触发条件:keydown event → boolean。 */
-    match: (e: KeyboardEvent) => boolean;
-    /** 一行描述,显示在 Settings 表里。 */
-    label: string;
-    /** 分组(Layout / Mode / Overlay / Focus / general / edit)。 */
-    group: 'layout' | 'mode' | 'overlay' | 'focus' | 'general' | 'edit';
-    /** 触发动作。返回 true 表示 preventDefault。 */
-    run: (e?: KeyboardEvent) => boolean | void;
-    /** Esc 这种允许在 input 里触发(其他必须 target 不是 editable 才触发)。 */
-    allowInInput?: boolean;
-}
+export type ShortcutDef = ApplicationShortcut;
 export declare function isTypingTarget(e: KeyboardEvent): boolean;
 /** Preview canvases own their edit-domain keyboard input locally. */
 export declare function isKeyboardOwnedSurface(e: KeyboardEvent): boolean;
 export declare function shouldSkipGlobalShortcut(e: KeyboardEvent, shortcut: Pick<ShortcutDef, 'group'>): boolean;
 export declare function isComposing(e: KeyboardEvent): boolean;
 export declare function isEditorSurfaceActive(): boolean;
-export interface RouterSelectedAsset {
-    guid: string;
-    kind: string;
-    name: string;
-    packPath: string;
-    payload: Record<string, unknown>;
-}
-export interface KeyboardRouterDeps {
-    /** Dispatch an editor op through the one gateway door. */
-    dispatch: (op: {
-        kind: string;
-        [k: string]: unknown;
-    }, origin?: string) => void;
-    /** Current entity-selection handles (for Ctrl+D / H routing). */
-    getEntitySelection: () => number[];
-    /** Current asset-selection list (for Ctrl+D routing). */
-    getAssetSelection: () => RouterSelectedAsset[];
-    /** Derive of "who was selected last" — retained for not-yet-migrated Ctrl+D. */
-    getLastSelectionDomain: () => 'entity' | 'asset' | 'folder' | null;
-    /** True under ▶ Play. */
-    isPlayMode: () => boolean;
-    /** Current viewport display axis (for G / Shift+G Game View toggle, AC-Cb4). */
-    getDisplay: () => 'scene' | 'game';
-    /** Current input owner. */
-    getInputTarget: () => 'editor' | 'game';
-    /** Legacy command-registry support; no longer bound to global Delete. */
-    deleteEntities: (ids: number[]) => void;
-    /** Entity: duplicate the given handles. */
-    duplicateEntities: (ids: number[]) => void;
-    /** Entity: hide the given handles (H — UE parity; one transaction, one undo). */
-    hideEntities: (ids: number[]) => void;
-    /** Entity: show every hidden entity (Ctrl+H — UE parity). */
-    showAllHidden: () => void;
-    /** Entity: hide everything not selected (Shift+H — isolate selection). */
-    hideUnselected: () => void;
-    /** Legacy command-registry support; no longer bound to global Mod+A. */
-    selectAllEntities: () => void;
-    /** Asset: duplicate the given asset (guid, packPath). */
-    duplicateAsset: (guid: string, packPath: string) => void;
-    /** Editor history actions, injected so the interface stays editor-agnostic. */
-    undo: () => void;
-    redo: () => void;
-    save: () => void;
-    /** Recreate the active Play/runtime surface after a terminal viewport failure. */
-    restartPreview?: () => void;
-    /** Viewport W/E/R/F handling, including fly-mode/input ownership policy. */
-    handleViewportKeyDown: (event: KeyboardEvent) => void;
-}
 /**
  * Register a short-lived keydown owner for an interaction that is not a
  * discoverable editor command (for example, Escape while a dock drag is
@@ -99,16 +39,7 @@ export interface KeyboardRouterDeps {
 export type GlobalKeydownHandler = (event: KeyboardEvent) => boolean;
 export declare function registerGlobalKeydownHandler(handler: GlobalKeydownHandler): () => void;
 export declare function dispatchGlobalKeydownHandlers(event: KeyboardEvent): boolean;
-/** Inject the editor-side callbacks the router needs. Called once at host boot
- *  (forgeax-editor standalone/main.tsx) BEFORE the App mounts (useGlobalShortcuts
- *  reads this at effect time, which is after mount, so registration first is safe). */
-export declare function registerKeyboardRouterDeps(deps: KeyboardRouterDeps | null): void;
-/** Read the currently injected router deps. Returns null until the host has
- *  called registerKeyboardRouterDeps() at boot. Command-bus wrappers
- *  (editor-commands extension) resolve deps lazily via this getter so they
- *  stay editor-agnostic and boot-order-safe. */
-export declare function getKeyboardRouterDeps(): KeyboardRouterDeps | null;
-export declare function buildShortcuts(): ShortcutDef[];
+export declare function buildShortcuts(contributions?: ApplicationShortcutRegistry): ShortcutDef[];
 /**
  * Mount once at App root. Returns nothing — purely an effect.
  *
@@ -117,5 +48,5 @@ export declare function buildShortcuts(): ShortcutDef[];
  * Ctrl+Shift+1/2/3 (which Chrome maps to tab switching only WITHOUT Shift,
  * so we're safe, but we preventDefault anyway).
  */
-export declare function useGlobalShortcuts(keybindings?: ContextualKeybindingsApi): void;
+export declare function useGlobalShortcuts(keybindings: ContextualKeybindingsApi, contributions: ApplicationShortcutRegistry): void;
 export declare function prettyCombo(combo: string, platform?: 'mac' | 'windows'): string;

package/dist/package/browser/lib/global-shortcuts.js

@@ -10,7 +10,7 @@
  *   Ctrl+/        focus chat composer
  *   Ctrl+Shift+H  open Settings → Changelog (was Ctrl+H before 2026-08-04 —
  *                 UE-parity editor hide claimed Ctrl+H for "show all hidden")
- *   Esc           stop viewport Play; otherwise close current overlay
+ *   Esc           close current overlay (higher-priority owners may claim it)
  *                 (Settings → Dashboard → Fullscreen)
  *
  * IME 安全:
@@ -77,16 +77,9 @@ function mod(e) {
 }
 // Is the scene editor the surface the user is currently looking at?
 //
-// The remaining legacy `edit` group (Ctrl+D / viewport W-E-R-F …) is injected
-// globally at boot and still dispatches against module-level editor selection /
-// viewport state. This coarse surface gate lets those keys escape whenever the editor is
-// not the foreground surface. Two facts, both interface-local (no editor
-// import, no focus/DOM resolver — that larger redesign is ADR-0029 scope; this
-// is its Phase 0 short-term mitigation):
-//   1. an overlay (Dashboard / Settings) is covering the shell, or
-//   2. the editor Page anchor is not currently visible.
-// Read live at event time (cached snapshot — cheap) so switching tab / opening
-// an overlay takes effect immediately.
+// Contributions classified as edit use the product shell's existing surface
+// identity and visibility policy. Read at event time so page/overlay changes
+// take effect without rebuilding the host or listener.
 export function isEditorSurfaceActive() {
     if (useShellStore.getState().activeOverlay)
         return false;
@@ -95,7 +88,6 @@ export function isEditorSurfaceActive() {
         : document.querySelector('[data-surface-anchor="edit"]');
     return Boolean(anchor && anchor.getClientRects().length > 0);
 }
-let routerDeps = null;
 const transientKeydownHandlers = new Set();
 export function registerGlobalKeydownHandler(handler) {
     transientKeydownHandlers.add(handler);
@@ -108,204 +100,9 @@ export function dispatchGlobalKeydownHandlers(event) {
     }
     return false;
 }
-/** Inject the editor-side callbacks the router needs. Called once at host boot
- *  (forgeax-editor standalone/main.tsx) BEFORE the App mounts (useGlobalShortcuts
- *  reads this at effect time, which is after mount, so registration first is safe). */
-export function registerKeyboardRouterDeps(deps) {
-    routerDeps = deps;
-}
-/** Read the currently injected router deps. Returns null until the host has
- *  called registerKeyboardRouterDeps() at boot. Command-bus wrappers
- *  (editor-commands extension) resolve deps lazily via this getter so they
- *  stay editor-agnostic and boot-order-safe. */
-export function getKeyboardRouterDeps() {
-    return routerDeps;
-}
-// Build the edit-domain shortcut list from injected deps. Pure dispatcher: every
-// branch routes through a dep callback (which the editor maps onto gateway ops),
-// so this file stays editor-agnostic. Three-layer guards (IME / typing-target /
-// play-mode) are enforced by the host's onKey wrapper (isComposing / isTypingTarget)
-// plus the per-op play-mode checks below.
-function editShortcuts(deps) {
-    const routeCtrlD = () => {
-        const domain = deps.getLastSelectionDomain() ?? 'entity';
-        if (domain === 'asset') {
-            for (const a of deps.getAssetSelection())
-                deps.duplicateAsset(a.guid, a.packPath);
-            return true;
-        }
-        const ids = deps.getEntitySelection();
-        if (ids.length > 0) {
-            deps.duplicateEntities(ids);
-            return true;
-        }
-        return false;
-    };
-    // UE-parity editor hide (docs 2026-08-04-editor-hide-ue-parity-plan M2):
-    // H hides the selection, Ctrl+H shows every hidden entity, Shift+H hides
-    // the unselected (isolate). Entity-domain only; under Play the game keeps
-    // its keys (same guard as entity Delete).
-    const routeH = () => {
-        if (deps.isPlayMode())
-            return false;
-        const ids = deps.getEntitySelection();
-        if (ids.length === 0)
-            return false;
-        deps.hideEntities(ids);
-        return true;
-    };
-    const routeShiftH = () => {
-        if (deps.isPlayMode())
-            return false;
-        if (deps.getEntitySelection().length === 0)
-            return false;
-        deps.hideUnselected();
-        return true;
-    };
-    const routeCtrlH = () => {
-        if (deps.isPlayMode())
-            return false;
-        deps.showAllHidden();
-        return true;
-    };
-    // Viewport Game View toggle. Plain G is editor-only while not playing so a
-    // running game retains its gameplay binding; Shift+G remains the explicit
-    // Play shortcut and is also available in Edit Viewport.
-    const routeShiftG = () => {
-        deps.dispatch({ kind: 'setDisplay', display: deps.getDisplay() === 'game' ? 'scene' : 'game' }, 'human');
-        return true;
-    };
-    const routeEditorOwnedPlayKey = (e) => {
-        if (!e)
-            return true;
-        deps.handleViewportKeyDown(e);
-        return true;
-    };
-    const routeViewportInput = (e) => {
-        if (!e)
-            return false;
-        if (deps.getInputTarget() === 'game')
-            return false;
-        deps.handleViewportKeyDown(e);
-        return true;
-    };
-    return [
-        {
-            combo: 'Ctrl+D',
-            group: 'edit',
-            label: t('shortcuts.duplicateSelection'),
-            match: (e) => mod(e) && !e.shiftKey && !e.altKey
-                && (e.code === 'KeyD' || safeKeyLower(e) === 'd'),
-            run: routeCtrlD,
-        },
-        {
-            combo: 'H',
-            group: 'edit',
-            label: t('shortcuts.hideSelected'),
-            match: (e) => !mod(e) && !e.shiftKey && !e.altKey && e.code === 'KeyH',
-            run: routeH,
-        },
-        {
-            combo: 'Shift+H',
-            group: 'edit',
-            label: t('shortcuts.hideUnselected'),
-            match: (e) => !mod(e) && e.shiftKey && !e.altKey && e.code === 'KeyH',
-            run: routeShiftH,
-        },
-        {
-            combo: 'Ctrl+H',
-            group: 'edit',
-            label: t('shortcuts.showAllHidden'),
-            match: (e) => mod(e) && !e.shiftKey && !e.altKey && e.code === 'KeyH',
-            run: routeCtrlH,
-        },
-        {
-            combo: 'Shift+G',
-            group: 'edit',
-            label: t('shortcuts.toggleViewportGameView'),
-            match: (e) => !mod(e) && e.shiftKey && !e.altKey
-                && (e.key === 'g' || e.key === 'G'),
-            run: routeShiftG,
-        },
-        {
-            combo: 'G',
-            group: 'edit',
-            label: t('shortcuts.toggleViewportGameView'),
-            match: (e) => !mod(e) && !e.shiftKey && !e.altKey
-                && !deps.isPlayMode() && deps.getInputTarget() !== 'game'
-                && (e.key === 'g' || e.key === 'G'),
-            run: routeShiftG,
-        },
-        {
-            combo: 'Ctrl+Z',
-            group: 'edit',
-            label: t('shortcuts.undo'),
-            allowInInput: true,
-            match: (e) => mod(e) && !e.altKey && !e.shiftKey && (e.code === 'KeyZ' || safeKeyLower(e) === 'z'),
-            run: () => { deps.undo(); return true; },
-        },
-        {
-            combo: 'Ctrl+Shift+Z',
-            group: 'edit',
-            label: t('shortcuts.redo'),
-            allowInInput: true,
-            match: (e) => mod(e) && !e.altKey && e.shiftKey && (e.code === 'KeyZ' || safeKeyLower(e) === 'z'),
-            run: () => { deps.redo(); return true; },
-        },
-        {
-            combo: 'Ctrl+Y',
-            group: 'edit',
-            label: t('shortcuts.redo'),
-            allowInInput: true,
-            match: (e) => mod(e) && !e.altKey && !e.shiftKey && (e.code === 'KeyY' || safeKeyLower(e) === 'y'),
-            run: () => { deps.redo(); return true; },
-        },
-        {
-            combo: 'Ctrl+S',
-            group: 'edit',
-            label: t('shortcuts.save'),
-            // Must fire while typing in Input Map / MI fields (⌘/Ctrl+S is a document
-            // command, not a text-editing key). Without this, focus inside `.im-editor`
-            // makes isTypingTarget true and silently drops save.
-            allowInInput: true,
-            match: (e) => mod(e) && !e.altKey && !e.shiftKey && (e.code === 'KeyS' || safeKeyLower(e) === 's'),
-            run: () => { deps.save(); return true; },
-        },
-        {
-            combo: 'Viewport camera and fly input',
-            group: 'edit',
-            label: t('shortcuts.viewportNavigation'),
-            match: (e) => {
-                if (deps.getInputTarget() === 'game')
-                    return false;
-                const key = safeKeyLower(e);
-                if (!key)
-                    return false;
-                // UE-style view presets (Alt+G/H/J/K) route to the viewport handler,
-                // which owns the camera. All other Alt combos stay excluded here.
-                if (e.altKey) {
-                    return !mod(e) && !e.shiftKey && ['g', 'h', 'j', 'k'].includes(key);
-                }
-                const plainCameraKey = !mod(e)
-                    && (['w', 'e', 'r', 'f', 'a', 's', 'd', 'q', 'v', 'z', 'c', 'escape', 'shift'].includes(key)
-                        || /^[1-9]$/.test(key));
-                const bookmarkKey = mod(e) && !e.shiftKey && /^[1-9]$/.test(key);
-                return plainCameraKey || bookmarkKey;
-            },
-            run: routeViewportInput,
-        },
-        {
-            combo: 'Play editor input shield',
-            group: 'edit',
-            label: t('shortcuts.shieldGameInput'),
-            match: () => deps.isPlayMode() && deps.getInputTarget() !== 'game',
-            run: routeEditorOwnedPlayKey,
-        },
-    ];
-}
-// Build the shortcut registry. Each match() / run() is plain JS so we can
-// drive them from a Settings table later (or a Command Palette).
-export function buildShortcuts() {
+// Build the Settings list in product order, not event-routing priority order.
+// Exact duplicate descriptions share a row, but remain separate runtime owners.
+export function buildShortcuts(contributions) {
     const store = useShellStore.getState;
     const shortcuts = [
         // ── Layout (collapse / fullscreen) ──
@@ -394,13 +191,6 @@ export function buildShortcuts() {
             allowInInput: true,
             match: (e) => e.key === 'Escape' && !mod(e) && !e.shiftKey && !e.altKey,
             run: () => {
-                // Escape is a Play-only viewport shortcut: stop the transient play
-                // session and return to edit mode. The listener stays in the single
-                // global router; outside Play this branch is inactive.
-                if (routerDeps?.isPlayMode()) {
-                    routerDeps.dispatch({ kind: 'stop' }, 'human');
-                    return true;
-                }
                 const s = store();
                 // Browser fullscreen exits automatically on Esc — but be defensive
                 // in case some browser swallows the event before reaching the native
@@ -460,18 +250,29 @@ export function buildShortcuts() {
             },
         },
     ];
-    // Inject the host editor's remaining edit-domain shortcuts when deps were
-    // registered at boot. Focus-owned F2/Delete/Mod+A live in host.keybindings.
-    if (routerDeps)
-        shortcuts.push(...editShortcuts(routerDeps));
     shortcuts.push({
+        priority: -20,
         combo: 'Ctrl+K',
         group: 'general',
         label: t('shortcuts.toggleCommandPalette'),
         match: (e) => mod(e) && !e.altKey && !e.shiftKey && (e.code === 'KeyK' || safeKeyLower(e) === 'k'),
         run: () => { toggleCommandPalette(); return true; },
     });
-    return shortcuts;
+    const shell = shortcuts.map((shortcut) => ({ priority: 10, ...shortcut }));
+    const rowKey = ({ combo, group, label }) => JSON.stringify([combo, group, label]);
+    const seen = new Set(shell.map(rowKey));
+    const contributedRows = [];
+    for (const shortcut of contributions?.snapshot() ?? []) {
+        const key = rowKey(shortcut);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        contributedRows.push(shortcut);
+    }
+    return [...shell.slice(0, -1), ...contributedRows, ...shell.slice(-1)];
+}
+function orderShortcuts(shell, contributions) {
+    return [...shell, ...(contributions?.snapshot() ?? [])].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
 }
 /**
  * Mount once at App root. Returns nothing — purely an effect.
@@ -481,9 +282,9 @@ export function buildShortcuts() {
  * Ctrl+Shift+1/2/3 (which Chrome maps to tab switching only WITHOUT Shift,
  * so we're safe, but we preventDefault anyway).
  */
-export function useGlobalShortcuts(keybindings) {
+export function useGlobalShortcuts(keybindings, contributions) {
     useEffect(() => {
-        const shortcuts = buildShortcuts();
+        const shell = buildShortcuts();
         const onKey = (e) => {
             // 0. IME composing — bail. Never intercept Chinese pinyin chord.
             if (isComposing(e))
@@ -499,11 +300,11 @@ export function useGlobalShortcuts(keybindings) {
             // 2. The contextual resolver gets first refusal inside the ONE capture
             // listener. A handled or disabled-but-claimed binding must not fall into
             // legacy application shortcuts; passthrough/unclaimed continues below.
-            const contextual = keybindings?.handle(e);
+            const contextual = keybindings.handle(e);
             if (contextual?.status === 'handled' || contextual?.status === 'claimed-disabled')
                 return;
-            // 3. Find first matching legacy shortcut.
-            for (const s of shortcuts) {
+            // 3. Read live host contributions after contextual first refusal.
+            for (const s of orderShortcuts(shell, contributions)) {
                 // A focused preview owns camera/fly keys locally. Keep non-edit global
                 // shortcuts available, but never route preview input to the main editor.
                 if (shouldSkipGlobalShortcut(e, s))
@@ -532,7 +333,7 @@ export function useGlobalShortcuts(keybindings) {
             onKeyDown: onKey,
         });
         return disposeKeydownObservation;
-    }, [keybindings]);
+    }, [keybindings, contributions]);
 }
 // macOS pretty-printing for shortcut combos shown in Settings.
 // Returns the canonical UI string. When platform is omitted, auto-detects macOS.

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;