@forgeax/interface 0.4.1

package/dist/package/browser/core/extensions/builtin-commands.js

@@ -0,0 +1,256 @@
+// packages/interface/src/core/extensions/builtin-commands.ts
+//
+// Ports `lib/builtin-actions.ts` to the command bus. The zustand store is
+// still the state SSOT (until PR 3); the actions here are thin wrappers
+// that (a) live on the command bus (so keyboard / palette / iframe all
+// hit the same entry) and (b) still call `useShellStore` / clients under
+// the hood.
+//
+// Static imports are used instead of the lazy `require(...)` pattern the
+// spec suggested — the interface is ESM ("type": "module") and no cycle
+// exists: this file is a leaf plugin, nothing else imports it. Direct
+// static imports keep the concept count lower.
+import { useShellStore } from '../../store';
+import { bumpDockResetEpoch } from '../../components/DockShell/dockResetEpoch';
+import { chatWidthStore, CHAT_DEFAULT_WIDTH } from '../../components/ChatColumn/useChatWidth';
+import { isDockPanelVisible } from '@forgeax/app-shell/dock';
+import { useFeedbackStore } from '../../components/Feedback/store';
+import { isTauri } from '../../lib/platform/runtime';
+import { getSessionClient, hasSessionClient } from '../../store-parts/session-client';
+import { executeFocusedTextEditAction } from '../../lib/text-edit-actions';
+const getState = () => useShellStore.getState();
+export const builtinCommandsExtension = {
+    id: 'builtin-commands',
+    version: '1.0.0',
+    requires: ['commands'],
+    setup(ctx) {
+        const { registerCommand } = ctx;
+        const cleanups = [];
+        const registerTextEditCommand = (id, title, action) => {
+            cleanups.push(registerCommand({
+                id,
+                title,
+                execute: async () => ({
+                    status: await executeFocusedTextEditAction(action) ? 'completed' : 'rejected',
+                }),
+            }));
+        };
+        registerTextEditCommand('text.cut', '剪切输入框选区', 'cut');
+        registerTextEditCommand('text.copy', '复制输入框选区', 'copy');
+        registerTextEditCommand('text.paste', '粘贴到输入框', 'paste');
+        cleanups.push(registerCommand({
+            id: 'app.panel.open',
+            title: 'Open (or focus) a dock panel by id',
+            execute: (args) => {
+                const id = args?.id;
+                if (!id)
+                    throw new Error('app.panel.open: missing { id }');
+                ctx.bus.emit('panel:open', { id });
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.panel.reveal',
+            title: 'Reveal a dock panel wherever it lives (grid, closed, or edge drawer)',
+            execute: (args) => {
+                const id = args?.id;
+                if (!id)
+                    throw new Error('app.panel.reveal: missing { id }');
+                ctx.bus.emit('panel:reveal', { id });
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.panel.focus',
+            title: 'Focus an existing dock panel by id (no reopen)',
+            execute: (args) => {
+                const id = args?.id;
+                if (!id)
+                    throw new Error('app.panel.focus: missing { id }');
+                ctx.bus.emit('panel:focus', { id });
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.panel.close',
+            title: 'Close a dock panel by id (no-op if not open)',
+            execute: (args) => {
+                const id = args?.id;
+                if (!id)
+                    throw new Error('app.panel.close: missing { id }');
+                ctx.bus.emit('panel:close', { id });
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.panel.toggle',
+            title: 'Toggle a dock panel by id (open if hidden, close if visible)',
+            execute: (args) => {
+                const id = args?.id;
+                if (!id)
+                    throw new Error('app.panel.toggle: missing { id }');
+                // Visibility comes from App Shell's shared mount registry, which
+                // DockRegion updates from Dockview lifecycle events. This product
+                // command only chooses which existing event to emit.
+                if (isDockPanelVisible(id))
+                    ctx.bus.emit('panel:close', { id });
+                else
+                    ctx.bus.emit('panel:open', { id });
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.open_url',
+            title: 'Open an external http(s) URL in the OS default browser',
+            execute: async (args) => {
+                const url = args?.url;
+                if (typeof url !== 'string' || !url)
+                    throw new Error('app.open_url: missing { url }');
+                const trimmed = url.trim();
+                if (!/^https?:\/\//i.test(trimmed)) {
+                    throw new Error(`app.open_url: only http(s) URLs are allowed, got: ${trimmed}`);
+                }
+                if (isTauri()) {
+                    // Prefer the plugin-shell opener so the URL goes to the OS default
+                    // browser, not the tauri webview. If the capability isn't granted the
+                    // call rejects — fall through to window.open in that case.
+                    try {
+                        const shell = await import('@tauri-apps/plugin-shell');
+                        await shell.open(trimmed);
+                        return { status: 'completed' };
+                    }
+                    catch { /* fall through */ }
+                }
+                try {
+                    window.open(trimmed, '_blank', 'noopener');
+                }
+                catch { /* noop */ }
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.dock.reset',
+            title: 'Reset dock layout',
+            execute: () => {
+                // Epoch first so DockRegions that are not yet subscribed / onReady can
+                // still apply this reset exactly once when they become ready.
+                bumpDockResetEpoch();
+                ctx.bus.emit('dock:reset', {});
+                // The chat column's WIDTH is a shell store (ChatDockResizer), not part of
+                // the dockview layout the dock:reset rebuild restores — reset it here at
+                // the single command entry point so 重置布局 also restores chat's width.
+                try {
+                    chatWidthStore.setSize(CHAT_DEFAULT_WIDTH);
+                }
+                catch { /* noop */ }
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.dock.layoutToggle',
+            title: 'Open the dock layout menu',
+            execute: (args) => {
+                ctx.bus.emit('dock:layout-toggle', args ?? {});
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'panel.toggle_sidebar',
+            title: '折叠/展开侧栏',
+            execute: () => { getState().toggleSidebar(); return { status: 'completed' }; },
+        }));
+        cleanups.push(registerCommand({
+            id: 'panel.toggle_chatpanel',
+            title: '折叠/展开聊天面板',
+            execute: () => { getState().toggleChatpanel(); return { status: 'completed' }; },
+        }));
+        cleanups.push(registerCommand({
+            id: 'app.set_fullscreen',
+            title: '沉浸模式',
+            execute: (args) => {
+                const value = args?.value ?? false;
+                getState().setFullscreen(value);
+                return { status: 'completed', value };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'overlay.open',
+            title: '打开浮层',
+            execute: (args) => {
+                const p = args;
+                if (!p?.id)
+                    throw new Error('overlay.open: missing { id }');
+                getState().openOverlay(p.id, p.param);
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'overlay.close',
+            title: '关闭浮层',
+            execute: () => { getState().closeOverlay(); return { status: 'completed' }; },
+        }));
+        cleanups.push(registerCommand({
+            id: 'feedback.open',
+            title: '打开反馈面板',
+            execute: () => {
+                useFeedbackStore.getState().openPanel('write');
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(registerCommand({
+            id: 'session.reconnect',
+            title: '重连当前会话',
+            execute: () => {
+                const sid = getState().activeSid;
+                if (!sid || !hasSessionClient())
+                    throw new Error('session.reconnect: no active session client');
+                const client = getSessionClient();
+                client.disconnectForgeaXWs();
+                client.connectForgeaXWs(sid);
+                return { status: 'completed' };
+            },
+        }));
+        // Game flows — a game is exactly one game directory.
+        cleanups.push(registerCommand({
+            id: 'game.open-directory',
+            title: '打开游戏目录',
+            execute: () => { getState().openGameDirectoryModal(); return { status: 'completed' }; },
+        }));
+        cleanups.push(registerCommand({
+            id: 'game.new',
+            title: '新建游戏',
+            execute: () => { getState().openGameModal(); return { status: 'completed' }; },
+        }));
+        cleanups.push(registerCommand({
+            id: 'game.open',
+            title: '打开游戏（游戏列表）',
+            execute: () => { getState().setGameSwitcherOpen(true); return { status: 'completed' }; },
+        }));
+        // game.pick — switch directly to a specific game by slug. Drives the File →
+        // 打开最近 submenu (each recent-game row dispatches this with its slug). Same
+        // store.setActiveGame mechanism the game.switch action + game-list modal use —
+        // no second code path, just a command-bus entry so the menu can reach it.
+        cleanups.push(registerCommand({
+            id: 'game.pick',
+            title: '切换到游戏',
+            execute: (args) => {
+                const slug = args?.slug;
+                if (typeof slug !== 'string' || !slug)
+                    return { status: 'rejected' };
+                void getState().setActiveGame(slug);
+                return { status: 'completed' };
+            },
+        }));
+        // Remaining actions (extension.list / extension.open /
+        // console.clear / console.read / network.clear / session.* / game.switch)
+        // stay in lib/builtin-actions.ts for now — they're consumed by
+        // action-registry (AI's tool registry). PR 3 will unify.
+        return () => {
+            // Reverse order so first-registered is torn down last (T9 fixup lesson).
+            // `.slice()` clones the array — never mutate the closed-over `cleanups`
+            // directly with `.reverse()` or repeat unloads would break.
+            for (const c of cleanups.slice().reverse())
+                c();
+        };
+    },
+};

package/dist/package/browser/core/extensions/builtin-menus.d.ts

@@ -0,0 +1,2 @@
+import type { AppExtension } from '../app-shell/types';
+export declare const builtinMenusExtension: AppExtension;

package/dist/package/browser/core/extensions/builtin-menus.js

@@ -0,0 +1,252 @@
+// packages/interface/src/core/extensions/builtin-menus.ts
+//
+// Declares the built-in top-menu-bar items via `menu-registry.registerMenuItem`.
+// One extension declaratively populates BRAND / FILE / EDIT / WINDOW / BUILD /
+// SELECT / HELP so the web renderer (T6/T7) and the Tauri native bridge (T5)
+// share the exact same SSOT (menu-registry) — same UI, one place to edit.
+//
+// An item WITHOUT a `commandId` is intentionally disabled — it renders as a
+// greyed-out placeholder for a capability we haven't wired yet (the registry
+// defaults `enabled` to `!!commandId`, so no explicit `enabled: () => false`
+// is needed). Once the underlying command lands, the only change is adding
+// `commandId` here — the item will light up automatically.
+//
+// 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 { isDockPanelVisible } from '@forgeax/app-shell/dock';
+import { useShellStore } from '../../store';
+import { getRecentGames } from '../../lib/recent-games';
+// Window-menu `checked()` predicates read from App Shell's shared visibility
+// registry, kept in sync by DockRegion's Dockview lifecycle subscriptions.
+// Non-reactive is fine: Radix rebuilds
+// dropdown content on every open, so `checked()` runs at open-time and
+// reflects the current state.
+const isVisible = (id) => () => isDockPanelVisible(id);
+// Chat panel visibility lives in the store slice; the panel itself is always
+// mounted, `chatpanelCollapsed` flips its collapsed state — invert for
+// "checked = visible".
+const isChatpanelOpen = () => !useShellStore.getState().chatpanelCollapsed;
+export const builtinMenusExtension = {
+    id: 'builtin-menus',
+    version: '1.0.0',
+    setup() {
+        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
+        // by group-first-seen then `order`, so declaration order below is
+        // documentation only (except for stable in-group tie-breaks).
+        const items = [
+            // ─── BRAND ────────────────────────────────────────────────────────────
+            { id: 'brand.settings', menu: 'brand', group: 'app', order: 10,
+                labelKey: 'menu.brand.settings', icon: 'settings',
+                commandId: 'overlay.open', args: { id: 'settings' } },
+            { id: 'brand.about', menu: 'brand', group: 'about', order: 10,
+                labelKey: 'menu.brand.about', icon: 'info',
+                commandId: 'overlay.open', args: { id: 'settings', param: 'about' } },
+            { id: 'brand.checkUpdate', menu: 'brand', group: 'about', order: 20,
+                labelKey: 'menu.brand.checkUpdate', icon: 'refresh-cw' },
+            // ─── FILE ─────────────────────────────────────────────────────────────
+            // A game is the user-facing unit. The host's private instance root is
+            // intentionally absent from this menu.
+            // 打开最近 → a hover submenu of recent games (dynamicChildren, derived from
+            // the recent-games cache by mtime); each row switches to that game via
+            // game.pick. Closing a game stays unimplemented (disabled).
+            { id: 'file.newGame', menu: 'file', group: 'game', order: 10,
+                labelKey: 'menu.file.newGame', commandId: 'game.new', icon: 'file-plus' },
+            { id: 'file.openGameDirectory', menu: 'file', group: 'game', order: 20,
+                labelKey: 'menu.file.openGameDirectory', commandId: 'game.open-directory', icon: 'folder-open' },
+            { id: 'file.openRecent', menu: 'file', group: 'game', order: 30,
+                labelKey: 'menu.file.openRecent', icon: 'clock',
+                // 事实:每个动态子项都执行 game.pick,子项 id = file.openRecent.<slug>。
+                // 门对账靠它把 catalog 的 game.switch(别名 game.pick)解析到这条链,
+                // 无需展开动态列表。
+                dynamicChildCommandId: 'game.pick', dynamicChildIdFromArg: 'slug',
+                // Dynamic submenu: recent games (mtime-desc). Label uses the raw game
+                // name as the i18n key — `t()` falls back to the key when unmatched, so
+                // the display name shows as-is (same fallback the top-menu titles rely
+                // on). Clicking dispatches game.pick with the slug (→ store.setActiveGame).
+                dynamicChildren: () => getRecentGames().map((g) => ({
+                    id: `file.openRecent.${g.slug}`,
+                    menu: 'file', group: 'recent', order: 0,
+                    labelKey: (typeof g.name === 'string' && g.name) ? g.name : g.slug,
+                    commandId: 'game.pick', args: { slug: g.slug },
+                })) },
+            { id: 'file.closeGame', menu: 'file', group: 'game', order: 40,
+                labelKey: 'menu.file.closeGame', icon: 'x' },
+            { id: 'file.save', menu: 'file', group: 'file', order: 10,
+                labelKey: 'menu.file.save', icon: 'save',
+                commandId: 'editor.save', keybinding: 'Ctrl+S' },
+            { id: 'file.saveAll', menu: 'file', group: 'file', order: 20,
+                labelKey: 'menu.file.saveAll', icon: 'save-all', keybinding: 'Ctrl+Shift+S' },
+            // reveal + import: capabilities not confirmed wired yet — leave DISABLED
+            // per task brief; flip on `commandId` when T4 confirms.
+            { id: 'file.reveal', menu: 'file', group: 'file', order: 30,
+                labelKey: 'menu.file.reveal', icon: 'folder-search' },
+            { id: 'file.import', menu: 'file', group: 'io', order: 10,
+                labelKey: 'menu.file.import', icon: 'upload' },
+            { id: 'file.export', menu: 'file', group: 'io', order: 20,
+                labelKey: 'menu.file.export', icon: 'package' },
+            { id: 'file.package', menu: 'file', group: 'io', order: 30,
+                labelKey: 'menu.file.package', icon: 'globe' },
+            // ─── EDIT ─────────────────────────────────────────────────────────────
+            { id: 'edit.undo', menu: 'edit', group: 'history', order: 10,
+                labelKey: 'menu.edit.undo', icon: 'undo-2',
+                commandId: 'editor.undo', keybinding: 'Ctrl+Z' },
+            { id: 'edit.redo', menu: 'edit', group: 'history', order: 20,
+                labelKey: 'menu.edit.redo', icon: 'redo-2',
+                commandId: 'editor.redo', keybinding: 'Ctrl+Shift+Z' },
+            { id: 'edit.cut', menu: 'edit', group: 'clipboard', order: 10,
+                labelKey: 'menu.edit.cut', icon: 'scissors',
+                commandId: 'text.cut', keybinding: 'Ctrl+X' },
+            { id: 'edit.copy', menu: 'edit', group: 'clipboard', order: 20,
+                labelKey: 'menu.edit.copy', icon: 'copy',
+                commandId: 'text.copy', keybinding: 'Ctrl+C' },
+            { id: 'edit.paste', menu: 'edit', group: 'clipboard', order: 30,
+                labelKey: 'menu.edit.paste', icon: 'clipboard',
+                commandId: 'text.paste', keybinding: 'Ctrl+V' },
+            { id: 'edit.delete', menu: 'edit', group: 'clipboard', order: 40,
+                labelKey: 'menu.edit.delete', icon: 'trash-2', danger: true,
+                commandId: 'editor.delete' },
+            { id: 'edit.copyPath', menu: 'edit', group: 'clipboard', order: 50,
+                labelKey: 'menu.edit.copyPath', icon: 'copy' },
+            { id: 'edit.copyGuid', menu: 'edit', group: 'clipboard', order: 60,
+                labelKey: 'menu.edit.copyGuid', icon: 'hash' },
+            { id: 'edit.find', menu: 'edit', group: 'find', order: 10,
+                labelKey: 'menu.edit.find', icon: 'search', keybinding: 'Ctrl+F' },
+            { id: 'edit.rollback', menu: 'edit', group: 'version', order: 10,
+                labelKey: 'menu.edit.rollback', icon: 'rotate-ccw' },
+            // ─── WINDOW ───────────────────────────────────────────────────────────
+            // Runtime dock ids: editor sub-panels live under `ep:*` (see panelRegistry
+            // `buildEditorPanelComponents`), so the toggle args + `checked()` mirror
+            // those exact ids. `viewport` is an interface-owned core panel with a bare
+            // id. `chat` uses a dedicated store toggle instead of dock-visibility.
+            { id: 'window.outline', menu: 'window', group: 'panels', order: 10,
+                labelKey: 'menu.window.outline',
+                commandId: 'app.panel.toggle', args: { id: 'ep:hierarchy' },
+                checked: isVisible('ep:hierarchy') },
+            { id: 'window.inspector', menu: 'window', group: 'panels', order: 20,
+                labelKey: 'menu.window.inspector',
+                commandId: 'app.panel.toggle', args: { id: 'ep:inspector' },
+                checked: isVisible('ep:inspector') },
+            { id: 'window.files', menu: 'window', group: 'panels', order: 30,
+                labelKey: 'menu.window.files',
+                commandId: 'app.panel.toggle', args: { id: 'ep:assets' },
+                checked: isVisible('ep:assets') },
+            { id: 'window.timeline', menu: 'window', group: 'panels', order: 40,
+                labelKey: 'menu.window.timeline' },
+            { id: 'window.runtime', menu: 'window', group: 'panels', order: 50,
+                labelKey: 'menu.window.runtime' },
+            { id: 'window.viewport', menu: 'window', group: 'panels', order: 60,
+                labelKey: 'menu.window.viewport',
+                commandId: 'app.panel.toggle', args: { id: 'viewport' },
+                checked: isVisible('viewport') },
+            { id: 'window.chat', menu: 'window', group: 'panels', order: 70,
+                labelKey: 'menu.window.chat',
+                commandId: 'panel.toggle_chatpanel',
+                checked: isChatpanelOpen },
+            { id: 'window.resetLayout', menu: 'window', group: 'layout', order: 10,
+                labelKey: 'menu.window.resetLayout', icon: 'layout-grid',
+                commandId: 'app.dock.reset' },
+            { id: 'window.fullscreen', menu: 'window', group: 'layout', order: 20,
+                labelKey: 'menu.window.fullscreen', icon: 'maximize',
+                commandId: 'app.set_fullscreen', args: { value: true } },
+            // ─── BUILD ────────────────────────────────────────────────────────────
+            { id: 'build.play', menu: 'build', group: 'run', order: 10,
+                labelKey: 'menu.build.play', icon: 'play',
+                commandId: 'editor.play' },
+            { id: 'build.stop', menu: 'build', group: 'run', order: 20,
+                labelKey: 'menu.build.stop', icon: 'square',
+                commandId: 'editor.stop' },
+            { id: 'build.editScene', menu: 'build', group: 'run', order: 30,
+                labelKey: 'menu.build.editScene', icon: 'pencil',
+                commandId: 'editor.toggleDisplay' },
+            // reload: `editor.reloadPreview` currently only emits `preview:reload` on
+            // the bus with no consumer wired — clicking would silently no-op (a
+            // mock-success path, forbidden by the no-silent-fallback rule). Leave the
+            // menu item DISABLED (no commandId) until a listener lands in a standalone-application owner.
+            { id: 'build.reload', menu: 'build', group: 'run', order: 40,
+                labelKey: 'menu.build.reload', icon: 'refresh-cw' },
+            { id: 'build.export', menu: 'build', group: 'export', order: 10,
+                labelKey: 'menu.build.export', icon: 'package' },
+            { id: 'build.settings', menu: 'build', group: 'export', order: 20,
+                labelKey: 'menu.build.settings', icon: 'settings' },
+            // ─── SELECT ───────────────────────────────────────────────────────────
+            { id: 'select.all', menu: 'select', group: 'basic', order: 10,
+                labelKey: 'menu.select.all', icon: 'box-select',
+                commandId: 'editor.selectAll', keybinding: 'Ctrl+A' },
+            { id: 'select.none', menu: 'select', group: 'basic', order: 20,
+                labelKey: 'menu.select.none', icon: 'square-dashed',
+                commandId: 'editor.deselect' },
+            { id: 'select.invert', menu: 'select', group: 'basic', order: 30,
+                labelKey: 'menu.select.invert', icon: 'flip-horizontal-2' },
+            { id: 'select.byType', menu: 'select', group: 'byCond', order: 10,
+                labelKey: 'menu.select.byType', icon: 'shapes',
+                children: [
+                    { id: 'select.byType.mesh', menu: 'select', group: 'byCond', order: 10,
+                        labelKey: 'menu.select.byType.mesh' },
+                    { id: 'select.byType.light', menu: 'select', group: 'byCond', order: 20,
+                        labelKey: 'menu.select.byType.light' },
+                    { id: 'select.byType.camera', menu: 'select', group: 'byCond', order: 30,
+                        labelKey: 'menu.select.byType.camera' },
+                    { id: 'select.byType.collider', menu: 'select', group: 'byCond', order: 40,
+                        labelKey: 'menu.select.byType.collider' },
+                ] },
+            { id: 'select.marquee', menu: 'select', group: 'byCond', order: 20,
+                labelKey: 'menu.select.marquee', icon: 'scan' },
+            { id: 'select.frame', menu: 'select', group: 'view', order: 10,
+                labelKey: 'menu.select.frame', icon: 'focus',
+                commandId: 'editor.frameSelected' },
+            // ─── HELP ─────────────────────────────────────────────────────────────
+            { id: 'help.docs', menu: 'help', group: 'docs', order: 10,
+                labelKey: 'menu.help.docs', icon: 'book-open',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/docs' } },
+            { id: 'help.tutorials', menu: 'help', group: 'docs', order: 20,
+                labelKey: 'menu.help.tutorials', icon: 'graduation-cap',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/tutorials' } },
+            { id: 'help.examples', menu: 'help', group: 'docs', order: 30,
+                labelKey: 'menu.help.examples', icon: 'code',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/examples' } },
+            { id: 'help.blog', menu: 'help', group: 'docs', order: 40,
+                labelKey: 'menu.help.blog', icon: 'newspaper',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/blog' } },
+            { id: 'help.games', menu: 'help', group: 'resources', order: 10,
+                labelKey: 'menu.help.games', icon: 'gamepad-2',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/games' } },
+            { id: 'help.marketplace', menu: 'help', group: 'resources', order: 20,
+                labelKey: 'menu.help.marketplace', icon: 'store',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/marketplace' } },
+            { id: 'help.changelog', menu: 'help', group: 'resources', order: 30,
+                labelKey: 'menu.help.changelog', icon: 'scroll-text',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/changelog' } },
+            { id: 'help.shortcuts', menu: 'help', group: 'app', order: 10,
+                labelKey: 'menu.help.shortcuts', icon: 'keyboard',
+                commandId: 'overlay.open', args: { id: 'settings', param: 'shortcuts' } },
+            { id: 'help.askAi', menu: 'help', group: 'app', order: 20,
+                labelKey: 'menu.help.askAi', icon: 'sparkles',
+                commandId: 'app.open_url', args: { url: 'https://forgeax.github.io/' } },
+            { id: 'help.github', menu: 'help', group: 'about', order: 10,
+                labelKey: 'menu.help.github', icon: 'github',
+                commandId: 'app.open_url', args: { url: 'https://github.com/ForgeaX-Games' } },
+            { id: 'help.report', menu: 'help', group: 'about', order: 20,
+                labelKey: 'menu.help.report', icon: 'message-circle',
+                commandId: 'feedback.open' },
+            { id: 'help.about', menu: 'help', group: 'about', order: 30,
+                labelKey: 'menu.help.about', icon: 'info',
+                commandId: 'overlay.open', args: { id: 'settings', param: 'about' } },
+            { id: 'help.license', menu: 'help', group: 'about', order: 40,
+                labelKey: 'menu.help.license', icon: 'scale',
+                commandId: 'app.open_url', args: { url: 'https://www.apache.org/licenses/LICENSE-2.0' } },
+        ];
+        for (const def of items)
+            cleanups.push(registerMenuItem(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
+            // doesn't mutate the closed-over `cleanups`.
+            for (const c of cleanups.slice().reverse())
+                c();
+        };
+    },
+};

package/dist/package/browser/core/extensions/chrome-drawer.d.ts

@@ -0,0 +1,3 @@
+import type { AppExtension } from '../app-shell/types';
+export declare const EDGE_DRAWER_EVENT = "forgeax:edge-drawer";
+export declare const chromeDrawerExtension: AppExtension;

package/dist/package/browser/core/extensions/chrome-drawer.js

@@ -0,0 +1,45 @@
+export const EDGE_DRAWER_EVENT = 'forgeax:edge-drawer';
+function dispatchEdgeDrawer(action, id) {
+    window.dispatchEvent(new CustomEvent(EDGE_DRAWER_EVENT, { detail: { action, id } }));
+}
+export const chromeDrawerExtension = {
+    id: 'chrome.drawer',
+    version: '2.0.0',
+    requires: ['commands'],
+    setup(ctx) {
+        const cleanups = [];
+        const idOf = (args) => args?.id;
+        cleanups.push(ctx.registerCommand({
+            id: 'app.drawer.toggle',
+            title: 'Toggle a footer bottom-edge panel by id',
+            execute: (args) => {
+                const id = idOf(args);
+                if (!id)
+                    throw new Error('app.drawer.toggle: missing { id }');
+                dispatchEdgeDrawer('toggle', id);
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(ctx.registerCommand({
+            id: 'app.drawer.open',
+            title: 'Open (expand) a footer bottom-edge panel by id',
+            execute: (args) => {
+                const id = idOf(args);
+                if (!id)
+                    throw new Error('app.drawer.open: missing { id }');
+                dispatchEdgeDrawer('open', id);
+                return { status: 'completed' };
+            },
+        }));
+        cleanups.push(ctx.registerCommand({
+            id: 'app.drawer.close',
+            title: 'Collapse the footer bottom-edge drawer',
+            execute: () => {
+                dispatchEdgeDrawer('close');
+                return { status: 'completed' };
+            },
+        }));
+        return () => { for (const c of cleanups.reverse())
+            c(); };
+    },
+};

package/dist/package/browser/core/extensions/chrome-statusbar.d.ts

@@ -0,0 +1,6 @@
+import type { AppExtension } from '../app-shell/types';
+import type { StatusItemContribution } from '../panels';
+/** Fold an ordered list of status items into the keyed `stripItems` record the
+ *  derive step sub-merges per id. Exported so product assemblers reuse it. */
+export declare function toStripItems(items: readonly StatusItemContribution[]): Record<string, StatusItemContribution>;
+export declare const chromeStatusBarExtension: AppExtension;

package/dist/package/browser/core/extensions/chrome-statusbar.js

@@ -0,0 +1,26 @@
+import { surfaceOverlayStatusItem } from '../../components/Surfaces/SurfaceOverlay';
+import { pulseStatusItems } from '../../components/StatusBar/feeds/PulseFeeds';
+import { forgeaxBuildVersionStatusItem } from '../../components/StatusBar/footer/ForgeaxBuildPopover';
+import { diagnosticsStatusItem } from '../../components/StatusBar/footer/DiagnosticsPopover';
+/** Fold an ordered list of status items into the keyed `stripItems` record the
+ *  derive step sub-merges per id. Exported so product assemblers reuse it. */
+export function toStripItems(items) {
+    const out = {};
+    for (const it of items)
+        out[it.id] = it;
+    return out;
+}
+export const chromeStatusBarExtension = {
+    id: 'chrome.statusbar',
+    version: '1.0.0',
+    contributes: {
+        panels: {
+            stripItems: toStripItems([
+                forgeaxBuildVersionStatusItem,
+                diagnosticsStatusItem,
+                surfaceOverlayStatusItem,
+                ...pulseStatusItems,
+            ]),
+        },
+    },
+};

package/dist/package/browser/core/extensions/detached-agents-browser.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+import type { AppExtension } from '../app-shell/types';
+export declare function createDetachedAgentsBrowserExtension(AgentsBrowser: React.ComponentType): AppExtension;

package/dist/package/browser/core/extensions/detached-agents-browser.js

@@ -0,0 +1,9 @@
+import { createAppSurfaceExtension } from '../app-shell/surface-extension';
+export function createDetachedAgentsBrowserExtension(AgentsBrowser) {
+    return createAppSurfaceExtension({
+        id: 'detached.agents-browser',
+        title: 'Agents Browser',
+        surface: 'detached',
+        components: { AgentsBrowser },
+    });
+}

package/dist/package/browser/core/extensions/detached-files-browser.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+import type { AppExtension } from '../app-shell/types';
+export declare function createDetachedFilesBrowserExtension(FilesBrowser: React.ComponentType): AppExtension;

package/dist/package/browser/core/extensions/detached-files-browser.js

@@ -0,0 +1,6 @@
+export function createDetachedFilesBrowserExtension(FilesBrowser) {
+    return {
+        id: 'detached.files-browser', version: '1.0.0',
+        contributes: { panels: { detached: { FilesBrowser } } },
+    };
+}

package/dist/package/browser/core/extensions/editor-commands.d.ts

@@ -0,0 +1,2 @@
+import type { AppExtension } from '../app-shell/types';
+export declare const editorCommandsExtension: AppExtension;