@forgeax/interface 0.5.0 → 0.6.0

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/node/ApplicationShell.js

@@ -25,7 +25,7 @@ import { isTauri } from './lib/platform/runtime.js';
 
 export { ApplicationDetachedShell } from './ApplicationDetachedShell.js';
 function KeyboardRouter({ runtime }) {
-    useGlobalShortcuts(runtime.host.keybindings);
+    useGlobalShortcuts(runtime.host.keybindings, runtime.host.shortcuts);
     return null;
 }
 export function isApplicationOnboardingEnabled(onboarding) {

package/dist/package/node/appHostBootstrap.js

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

package/dist/package/node/application.js

@@ -2,7 +2,6 @@ import { bootstrapAppHost, } from './appHostBootstrap.js';
 import { bootStageAppMounted } from './boot/driver.js';
 import { changeLanguage, initI18n } from './i18n/index.js';
 import { useShellStore } from './store.js';
-import { registerKeyboardRouterDeps, } from './lib/global-shortcuts.js';
 /**
  * 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/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 } from '@forgeax/app-shell/application';
 const BUILT_IN_CAPS = [
-    'commands', 'keybindings', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
+    'commands', 'keybindings', 'shortcuts', 'bus', 'storage', 'panels', 'panelActions', 'panelControls', 'contextKeys', 'pages',
     'activities', 'resourceEditors',
 ];
 export function createAppHost(deps = {}) {
@@ -23,6 +24,7 @@ export function createAppHost(deps = {}) {
     for (const c of BUILT_IN_CAPS)
         caps.add(c);
     const commands = createCommandsRegistry();
+    const shortcuts = createApplicationShortcutRegistry();
     const keybindings = createContextualKeybindings(commands, {
         onCommandError(error, commandId) {
             log.error(`[app-shell] keybinding command "${commandId}" failed`, error);
@@ -62,7 +64,7 @@ export function createAppHost(deps = {}) {
     const extensionFields = {};
     let activeSetup = null;
     const base = {
-        commands, keybindings, bus, storage, contextKeys,
+        commands, keybindings, shortcuts, bus, storage, contextKeys,
         get panels() { return panelsSnapshot(); },
         panelActions,
         panelControls,
@@ -181,6 +183,7 @@ export function createAppHost(deps = {}) {
             removePageNavigation();
             await pageSession.dispose();
             keybindings.dispose();
+            shortcuts.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/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": {