@forgeax/interface 0.4.1 → 0.6.0

package/README.md

@@ -2,6 +2,57 @@
 
 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]
+> Action registration and dispatch now belong to `@forgeax/app-shell/application`.
+> Interface no longer exports these functions or their types through `application`
+> or `lib/action-registry`. Consumers must use the same exact App Shell version as
+> Interface so product discovery and external registration share one registry.
+
+```ts
+import {
+  dispatchAction,
+  registerAction,
+  type UiActionDef,
+} from '@forgeax/app-shell/application';
+```
+
+| App Shell owns | Interface retains |
+| :-- | :-- |
+| Registration, replacement-safe disposal and registry notifications | Product action definitions and capability declarations |
+| Dispatch validation, source events and structured results | Handler behavior, permission decisions and visual feedback |
+| Derived action/state snapshots and manifest metadata | DOM discovery, command-palette presentation and bridge wiring |
+
+Application startup, normal/detached shells and global CSS remain Interface
+entrypoints. This change removes the registry implementation, not those product
+dependencies; it adds no compatibility facade or second action registry.
+
 ## 技术栈
 
 - **Bun** runtime · **Vite 6** dev server · **React 19** · **TypeScript**

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) {

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';
@@ -108,7 +107,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,7 +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';
-export { dispatchAction, registerAction } from './lib/action-registry';
-export type { JsonSchemaObject, UiActionDef, UiActionResult, UiCapability, } from './lib/action-registry';

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
@@ -61,4 +52,3 @@ export async function startInterfaceApplication(overrides = {}, options = {}) {
 // Product boot injects the existing domain authority without importing store
 // internals. This is the same configuration function, not another client registry.
 export { configureStudioDomainClients, } from './store-parts/domain-clients';
-export { dispatchAction, registerAction } from './lib/action-registry';

package/dist/package/browser/components/CommandPalette/CommandPalette.js

@@ -12,7 +12,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Command } from 'cmdk';
 import { createRestartableTimeoutTaskLifecycle } from '@forgeax/app-shell/react';
-import { dispatchAction, getAction, snapshotActions, } from '../../lib/action-registry';
+import { dispatchAction, getAction, snapshotActions, } from '@forgeax/app-shell/application';
 import { setCommandPaletteOpen, useCommandPaletteOpen } from '../../lib/command-palette-store';
 import './CommandPalette.css';
 /** 从 action 的 JSON Schema 派生顶层参数清单(与 registry 的 validateArgs 同口径)。 */

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 } 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/browser/core/app-shell/types.d.ts

@@ -1,3 +1,4 @@
+import type { ApplicationShortcutRegistry } 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,7 @@ export interface AppLogger {
 export interface AppHostBase {
     readonly commands: CommandsRegistry;
     readonly keybindings: ContextualKeybindingsApi;
+    readonly shortcuts: ApplicationShortcutRegistry;
     readonly bus: EventBus<AppBusEventMap>;
     readonly storage: StorageApi;
     readonly contextKeys: ContextKeysApi;

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/trajectory.js

@@ -1,4 +1,4 @@
-import { registerAction, registerStateSlice } from '../../lib/action-registry';
+import { registerAction, registerStateSlice } from '@forgeax/app-shell/application';
 import { TRAJECTORY_MAX, clearTrajectory, readTrajectory, startTrajectoryRecording, } from '../../lib/ui-trajectory';
 /** 随每次 ui_snapshot 内联出墙的尾部条数(压 token;更多靠 trajectory.read 拉)。 */
 const SNAPSHOT_TAIL = 20;

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/action-dom-discovery.js

@@ -12,7 +12,7 @@
  *    data-fx-capability   权限分级(8 类之一;缺省 'other'。危险按钮**务必**标
  *                         delete/credential,编排层会据此弹确认卡)
  */
-import { registerAction } from './action-registry';
+import { registerAction } from '@forgeax/app-shell/application';
 const VALID_CAPS = new Set([
     'read', 'write', 'delete', 'exec', 'network', 'credential', 'delegate', 'other',
 ]);

package/dist/package/browser/lib/ai-intents.js

@@ -1,4 +1,4 @@
-import { getAction } from './action-registry';
+import { getAction } from '@forgeax/app-shell/application';
 /** 按 RefDescriptor.kind 的专属 intent(SSOT:每类可引用单元的 AI 动作都列在这里)。 */
 const KIND_INTENTS = {
     'console-row': [

package/dist/package/browser/lib/builtin-actions.js

@@ -8,7 +8,7 @@
  *  surface 口径(方案 §5):纯视图操作 'ui';背后是 server REST 的标 'both'(headless
  *  等价路径 P1 接线,声明先行,UI run() 已经就是调同一 HTTP API,server 是行为 SSOT)。
  */
-import { registerAction, registerStateSlice } from './action-registry';
+import { registerAction, registerStateSlice } from '@forgeax/app-shell/application';
 import { getSessionClient } from '../store-parts/session-client';
 import { useShellStore, tabLabel } from '../store';
 import { openExtensionPage, resolveRegisteredOverlayId } from '../core/page-navigation';

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;