@forgeax/interface 0.4.1

package/dist/package/browser/lib/file-family.js

@@ -0,0 +1,25 @@
+/**
+ * Shared file-family taxonomy used by the interface file tree and chat assets.
+ *
+ * Keep this module free of React and CSS imports.  The family key is the
+ * contract; visual consumers map it to `--fx-family-*` tokens.
+ */
+export const FAMILY_ORDER = [
+    { key: 'code', label: 'CODE', extensions: ['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs'] },
+    { key: 'config', label: 'CFG', extensions: ['json', 'json5', 'jsonc', 'lock', 'yaml', 'yml', 'toml', 'ini', 'env'] },
+    { key: 'doc', label: 'DOC', extensions: ['md', 'markdown', 'txt', 'rst', 'adoc'] },
+    { key: 'scene', label: 'SCENE', extensions: ['scene', 'fxscene'] },
+    { key: 'pack', label: 'PACK', extensions: ['pack', 'fxpack', 'zip', 'tar', 'gz'] },
+    { key: 'meta', label: 'META', extensions: ['meta'] },
+    { key: 'image', label: 'IMG', extensions: ['png', 'jpg', 'jpeg', 'webp', 'gif', 'svg', 'ico', 'avif'] },
+    { key: 'audio', label: 'AUD', extensions: ['mp3', 'wav', 'ogg', 'flac', 'm4a', 'aac'] },
+    { key: 'model', label: 'MODEL', extensions: ['glb', 'gltf', 'fbx', 'obj', 'dae', 'blend', '3ds'] },
+    { key: 'data', label: 'DATA', extensions: ['csv', 'tsv', 'xml', 'bin', 'dat', 'db', 'sqlite', 'sqlite3'] },
+];
+const EXTENSION_TO_FAMILY = new Map(FAMILY_ORDER.flatMap(({ key, extensions }) => extensions.map((extension) => [extension, key])));
+/** Classify a file path by its final extension. Unknown files are `data`. */
+export function familyOf(path) {
+    const name = path.replace(/\\/g, '/').split('/').pop() ?? path;
+    const extension = name.includes('.') ? name.split('.').pop()?.toLowerCase() ?? '' : '';
+    return EXTENSION_TO_FAMILY.get(extension) ?? 'data';
+}

package/dist/package/browser/lib/game-templates.d.ts

@@ -0,0 +1,7 @@
+/** Built-in game templates exposed by the game service. */
+export interface GameTemplate {
+    readonly slug: string;
+    readonly name: string;
+}
+/** Read the engine-owned template catalog used by both onboarding and New Game. */
+export declare function listGameTemplates(): Promise<GameTemplate[]>;

package/dist/package/browser/lib/game-templates.js

@@ -0,0 +1,15 @@
+function isGameTemplate(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.slug === 'string' && candidate.slug.length > 0
+        && typeof candidate.name === 'string' && candidate.name.length > 0);
+}
+/** Read the engine-owned template catalog used by both onboarding and New Game. */
+export async function listGameTemplates() {
+    const response = await fetch('/api/projects/templates');
+    if (!response.ok)
+        throw new Error(`listGameTemplates → HTTP ${response.status}`);
+    const body = (await response.json());
+    return Array.isArray(body.templates) ? body.templates.filter(isGameTemplate) : [];
+}

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

@@ -0,0 +1,121 @@
+/**
+ * Global keyboard shortcuts · Blender-inspired, IME-safe.
+ *
+ *   Ctrl+Shift+F  toggle fullscreen (hide TopBar / Sidebar / ChatPanel / StatusBar)
+ *   Ctrl+,        open / close Settings
+ *   Ctrl+Shift+B  toggle Sidebar
+ *   Ctrl+Shift+C  toggle ChatPanel
+ *   Ctrl+Shift+D  toggle Dashboard overlay
+ *   Ctrl+Shift+0  open Settings → Plugins
+ *   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
+ *                 (Settings → Dashboard → Fullscreen)
+ *
+ * IME 安全:
+ *   - 总是用 Ctrl+Shift 复合,避开浏览器原生 (Ctrl+1/2/3 切 tab · Ctrl+J 下载 · Ctrl+B 收藏栏 · Ctrl+W/T 关/开 tab)
+ *   - keydown 时检查 `event.isComposing` / `event.keyCode === 229` (中文输入法组词中)
+ *   - target 是 input/textarea/contenteditable 时跳过非 Esc / Ctrl+/ (允许"focus composer"在输入框里也能撤焦再聚)
+ *   - macOS:Cmd 与 Ctrl 同义 (event.metaKey || event.ctrlKey)
+ *
+ * 注册:在 App 顶层调用 `useGlobalShortcuts()` 一次。
+ */
+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 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
+ * armed). The owner still runs through the single global keyboard listener;
+ * feature modules must not install competing window-level listeners.
+ */
+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[];
+/**
+ * Mount once at App root. Returns nothing — purely an effect.
+ *
+ * `passive: false` so we can preventDefault — required for Ctrl+, (Chrome
+ * historically had no native binding but treat it as user gesture) and
+ * 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 prettyCombo(combo: string, platform?: 'mac' | 'windows'): string;