@forgeax/interface 0.5.0 → 0.7.0

package/README.md

@@ -2,6 +2,31 @@
 
 forgeax 前端工程（Studio 三栏 UI）。
 
+## Application shortcut ownership (0.6.0)
+
+> [!IMPORTANT]
+> `configureInterfaceKeyboardRouter`, `KeyboardRouterDeps` and the private
+> `editor-commands` extension have been removed. Products must install their
+> Editor-owned keyboard extension through application bootstrap overrides.
+> Interface consumes exact `@forgeax/app-shell@0.87.1`; no module-global Editor
+> callback setter or second keyboard listener remains.
+
+| Owner | Responsibility |
+| :-- | :-- |
+| App Shell | Per-host `shortcuts` registration, live snapshots and stale-callback fencing |
+| Interface | One capture listener, contextual first refusal, shell bindings, typing/preview/surface guards and focused `text.selectAll` |
+| Editor | Editor shortcuts, Play Escape, viewport callbacks and the twelve `editor.*` commands |
+
+`useGlobalShortcuts(host.keybindings, host.shortcuts)` requires both host APIs.
+Shortcut settings read `buildShortcuts(host.shortcuts)` so contributions added
+or removed after boot are not hidden behind an earlier snapshot. A matched
+shortcut returning `false` still terminates routing while yielding browser
+default behavior. Shell bindings retain priority 10, Play-only Escape uses 20,
+ordinary contributions use 0, and the palette fallback uses -20.
+
+The normal/detached product shells, startup and global CSS remain Interface
+entrypoints; this release does not complete their migration.
+
 ## Public action registry migration (0.5.0)
 
 > [!IMPORTANT]

package/dist/package/browser/ApplicationShell.js

@@ -25,7 +25,7 @@ import { isTauri } from './lib/platform/runtime';
 import './App.css';
 export { ApplicationDetachedShell } from './ApplicationDetachedShell';
 function KeyboardRouter({ runtime }) {
-    useGlobalShortcuts(runtime.host.keybindings);
+    useGlobalShortcuts(runtime.host.keybindings, runtime.host.shortcuts);
     return null;
 }
 export function isApplicationOnboardingEnabled(onboarding) {
@@ -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

@@ -21,7 +21,6 @@ import { foundationStorageExtension } from './core/extensions/foundation-storage
 import { builtinCommandsExtension } from './core/extensions/builtin-commands';
 import { hostCommandsExtension } from './core/extensions/host-commands';
 import { builtinMenusExtension } from './core/extensions/builtin-menus';
-import { editorCommandsExtension } from './core/extensions/editor-commands';
 import { panelsViewportExtension } from './core/extensions/panels-viewport';
 import { panelsChatExtension } from './core/extensions/panels-chat';
 import { chromeStatusBarExtension } from './core/extensions/chrome-statusbar';
@@ -62,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));
                 }
@@ -95,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();
             }
@@ -108,7 +117,6 @@ export async function bootstrapAppHost(overrides = {}) {
         builtinCommandsExtension,
         hostCommandsExtension,
         builtinMenusExtension,
-        editorCommandsExtension,
         panelsViewportExtension,
         panelsChatExtension,
         chromeStatusBarExtension,

package/dist/package/browser/application.d.ts

@@ -1,7 +1,6 @@
 import type { AppHost as ApplicationHost } from '@forgeax/app-shell/application';
 import { type AppHostBootstrapOverrides, type AppHostBootstrapResult } from './appHostBootstrap';
 import { type Locale } from './i18n';
-import { type KeyboardRouterDeps } from './lib/global-shortcuts';
 export type InterfaceApplicationRuntime = AppHostBootstrapResult & {
     readonly host: AppHostBootstrapResult['host'] & ApplicationHost;
 };
@@ -16,12 +15,6 @@ export interface InterfaceApplicationStartupOptions {
  * are observed. Product errors still propagate.
  */
 export declare function installApplicationOverlayRedirect(overlayId: string, onRedirect: () => void): () => void;
-/**
- * Configures product-owned editor callbacks consumed by Interface's single
- * keyboard router. Product assemblies use this public application boundary;
- * the router implementation remains private to Interface.
- */
-export declare function configureInterfaceKeyboardRouter(deps: KeyboardRouterDeps | null): void;
 /**
  * Starts the shared Interface application runtime without selecting a product
  * entry or product extensions. IDE and compatibility callers supply their own
@@ -29,5 +22,4 @@ export declare function configureInterfaceKeyboardRouter(deps: KeyboardRouterDep
  */
 export declare function startInterfaceApplication(overrides?: AppHostBootstrapOverrides, options?: InterfaceApplicationStartupOptions): Promise<InterfaceApplicationRuntime>;
 export type { AppHostBootstrapOverrides } from './appHostBootstrap';
-export type { KeyboardRouterDeps } from './lib/global-shortcuts';
 export { configureStudioDomainClients, type StudioDomainClients, } from './store-parts/domain-clients';

package/dist/package/browser/application.js

@@ -2,7 +2,6 @@ import { bootstrapAppHost, } from './appHostBootstrap';
 import { bootStageAppMounted } from './boot/driver';
 import { changeLanguage, initI18n } from './i18n';
 import { useShellStore } from './store';
-import { registerKeyboardRouterDeps, } from './lib/global-shortcuts';
 /**
  * Lets a product replace one shell overlay with its own destination. Interface
  * owns observation, clearing and synchronous reentry; the product owns routing.
@@ -24,14 +23,6 @@ export function installApplicationOverlayRedirect(overlayId, onRedirect) {
         }
     });
 }
-/**
- * Configures product-owned editor callbacks consumed by Interface's single
- * keyboard router. Product assemblies use this public application boundary;
- * the router implementation remains private to Interface.
- */
-export function configureInterfaceKeyboardRouter(deps) {
-    registerKeyboardRouterDeps(deps);
-}
 /**
  * Starts the shared Interface application runtime without selecting a product
  * entry or product extensions. IDE and compatibility callers supply their own

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,8 +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, createApplicationMenuRegistry } from '@forgeax/app-shell/application';
 const BUILT_IN_CAPS = [
-    'commands', 'keybindings', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
+    'commands', 'keybindings', 'shortcuts', 'menus', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
     'activities', 'resourceEditors',
 ];
 export function createAppHost(deps = {}) {
@@ -23,6 +24,8 @@ export function createAppHost(deps = {}) {
     for (const c of BUILT_IN_CAPS)
         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);
@@ -62,7 +65,7 @@ export function createAppHost(deps = {}) {
     const extensionFields = {};
     let activeSetup = null;
     const base = {
-        commands, keybindings, bus, storage, contextKeys,
+        commands, keybindings, shortcuts, menus, bus, storage, contextKeys,
         get panels() { return panelsSnapshot(); },
         panelActions,
         panelControls,
@@ -181,6 +184,8 @@ export function createAppHost(deps = {}) {
             removePageNavigation();
             await pageSession.dispose();
             keybindings.dispose();
+            shortcuts.dispose();
+            menus.dispose();
             bus.destroy();
         },
     };

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

@@ -1,3 +1,4 @@
+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';
@@ -103,7 +104,7 @@ export interface AppBusEventMap extends Record<string, unknown> {
         provider: string;
     };
 }
-export type HostCapability = 'commands' | 'keybindings' | 'bus' | 'storage' | 'panels' | 'panelActions' | 'panelControls' | 'contextKeys' | 'pages' | 'activities' | 'resourceEditors' | 'session' | 'observability' | 'editor' | (string & {});
+export type HostCapability = 'commands' | 'keybindings' | 'shortcuts' | 'bus' | 'storage' | 'panels' | 'panelActions' | 'panelControls' | 'contextKeys' | 'pages' | 'activities' | 'resourceEditors' | 'session' | 'observability' | 'editor' | (string & {});
 export interface AppLogger {
     debug(message: string, ...rest: unknown[]): void;
     info(message: string, ...rest: unknown[]): void;
@@ -113,6 +114,8 @@ export interface AppLogger {
 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;
@@ -158,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-commands.js

@@ -38,6 +38,7 @@ export const builtinCommandsExtension = {
         registerTextEditCommand('text.cut', '剪切输入框选区', 'cut');
         registerTextEditCommand('text.copy', '复制输入框选区', 'copy');
         registerTextEditCommand('text.paste', '粘贴到输入框', 'paste');
+        registerTextEditCommand('text.selectAll', 'Select all focused text', 'selectAll');
         cleanups.push(registerCommand({
             id: 'app.panel.open',
             title: 'Open (or focus) a dock panel by id',

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/i18n/locales/en.json

@@ -1288,22 +1288,12 @@
     "toggleDashboard": "Toggle Dashboard overview panel",
     "toggleSettings": "Open / close Settings overlay",
     "openChangelog": "Settings → About (changelog)",
-    "hideSelected": "Hide selected entities (UE parity · editor-only, never affects the game)",
-    "hideUnselected": "Hide unselected entities (isolate selection)",
-    "showAllHidden": "Show all hidden entities",
     "closeOverlay": "Close current overlay · browser fullscreen → game fullscreen → Settings → Dashboard in order",
     "modePreview": "Switch to Preview mode",
     "modePage": "Switch to Page mode",
     "switchPageN": "Switch to extension {{n}} (Blender parity — indexed into extension list)",
     "openExtensions": "Settings → Extensions (was the Bus mode tab)",
     "focusComposer": "Focus the right ChatPanel composer",
-    "duplicateSelection": "Duplicate selection",
-    "toggleViewportGameView": "Toggle viewport Game View",
-    "undo": "Undo",
-    "redo": "Redo",
-    "save": "Save",
-    "viewportNavigation": "Viewport navigation and gizmo mode",
-    "shieldGameInput": "Shield game input while editor-owned",
     "toggleCommandPalette": "Toggle command palette"
   },
   "analytics": {

package/dist/package/browser/i18n/locales/zh.json

@@ -1288,22 +1288,12 @@
     "toggleDashboard": "切换 Dashboard 总览面板",
     "toggleSettings": "打开 / 关闭 Settings 浮层",
     "openChangelog": "Settings → 关于（更新日志）",
-    "hideSelected": "隐藏选中实体(UE 对标 · 编辑器临时隐藏,不影响游戏)",
-    "hideUnselected": "隐藏未选中实体(孤立选择)",
-    "showAllHidden": "显示所有隐藏实体",
     "closeOverlay": "关闭当前浮层 · 浏览器全屏 → 游戏全屏 → Settings → Dashboard 依次撤回",
     "modePreview": "切到 Preview 模式",
     "modePage": "切到 Page 模式",
     "switchPageN": "切到第 {{n}} 个 extension(Blender 风格 · 按列表索引)",
     "openExtensions": "Settings → Extensions(原 Bus mode tab)",
     "focusComposer": "聚焦右侧 ChatPanel 输入框",
-    "duplicateSelection": "复制选中项",
-    "toggleViewportGameView": "切换视口 Game View",
-    "undo": "撤销",
-    "redo": "重做",
-    "save": "保存",
-    "viewportNavigation": "视口导航与 Gizmo 模式",
-    "shieldGameInput": "编辑器接管时屏蔽游戏输入",
     "toggleCommandPalette": "切换命令面板"
   },
   "analytics": {

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 };
+    });
+}