@forgeax/interface 0.5.0 → 0.7.0

package/dist/package/node/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/index.js';
 import { useHost } from '../../core/app-shell/index.js';
 import { useBrand } from '../../brand/BrandProvider.js';
 import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from '../ui/dropdown-menu.js';
-import { onMenuChange, snapshotAllMenus, } from '../../lib/menu-registry.js';
+import { projectApplicationMenus } from '../../lib/application-menu-projection.js';
 import { prettyCombo } from '../../lib/global-shortcuts.js';
 import { useMenubarSurface } from './menubar-surface.js';
 import { openMenuFromTriggerPointerDown } from './menubar-open-state.js';
 import { isTauri } from '../../lib/platform/runtime.js';
 import { captureFocusedTextEditTarget } from '../../lib/text-edit-actions.js';
 import { getRecentGamesRevision, subscribeRecentGames, warmRecentGames, } from '../../lib/recent-games.js';
-import { repairBuiltinMenusIfEmpty } from '../../lib/repair-builtin-menus.js';
 
 // 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/node/components/MenuBar/menubar-surface.js

@@ -17,7 +17,7 @@
  */
 import { useEffect, useRef } from 'react';
 import { useSurface } from '../../lib/surface.js';
-import { snapshotAllMenus } from '../../lib/menu-registry.js';
+import { projectApplicationMenus } from '../../lib/application-menu-projection.js';
 import { warmRecentGames } from '../../lib/recent-games.js';
 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/node/core/app-shell/host.js

@@ -13,8 +13,9 @@ import { derivePanelRenderers } from './derive-panel-renderers.js';
 import { DEFAULT_PANEL_RENDERERS } from '../../components/DockShell/panelRenderers.js';
 import { installPageNavigation } from '../page-navigation.js';
 import { createContextualKeybindings } from '../contextual-keybindings.js';
+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/node/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/node/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.js';
+import { t } from '../../i18n/index.js';
 import { isDockPanelVisible } from '@forgeax/app-shell/dock';
 import { useShellStore } from '../../store.js';
 import { getRecentGames } from '../../lib/recent-games.js';
@@ -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/node/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/node/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/node/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 };
+    });
+}