@forgeax/interface 0.5.0 → 0.7.0

package/dist/package/node/lib/native-menu-bridge.js

@@ -19,13 +19,14 @@
  */
 import { isTauri } from './platform/runtime.js';
 import { warmRecentGames } from './recent-games.js';
-import { onMenuChange, serializeMenusForNative, snapshotAllMenus, } from './menu-registry.js';
+import { subscribeLocale } from '../i18n/index.js';
+import { projectApplicationMenus, serializeApplicationMenusForNative } from './application-menu-projection.js';
 // ─── Menu id → command lookup (原生点击回吐用) ─────────────────────────────
 /** 展平所有菜单项 (含 children),建 id → def 的索引,供 menu:invoke 回吐时 O(1)
  *  查表。不缓存:每次点击都 fresh 一遍,让 when/enabled 变化立刻生效;菜单量级
  *  几十项,遍历开销可忽略。 */
-function findMenuItemById(id) {
-    const all = snapshotAllMenus();
+function findMenuItemById(id, menus) {
+    const all = projectApplicationMenus(menus.snapshot());
     for (const menuId of Object.keys(all)) {
         const found = findInList(all[menuId], id);
         if (found)
@@ -35,6 +36,8 @@ function findMenuItemById(id) {
 }
 function findInList(list, id) {
     for (const item of list) {
+        if ((item.when && !item.when()) || (item.enabled && !item.enabled()))
+            continue;
         if (item.id === id)
             return item;
         // Recurse into static children AND dynamic ones — a native click on a
@@ -67,85 +70,122 @@ export function fxTrace(line) {
     console.debug('[fx-trace]', line);
     traceSink?.(line);
 }
-/** 模块内简称。 */
-const trace = fxTrace;
-// ─── Push (registry → native) ─────────────────────────────────────────────
-/** 把当前注册表快照推给 Rust。失败时 warn 但不抛 —— 菜单更新失败不该让 boot
- *  炸掉;下次 onMenuChange 会重试。 */
-async function pushMenusToNative(invoke, translate) {
-    // Warm the recent-games cache so 打开最近's dynamicChildren serialize with a
-    // current list. Web warms on File-dropdown open; native has no such hook, so
-    // we warm here before every rebuild. Failures leave the last cache intact.
-    trace('push: warmRecentGames…');
-    await warmRecentGames();
-    trace('push: warmRecentGames done, serializing…');
-    const raw = serializeMenusForNative(translate);
-    // 补顶层 title —— 与 MenuBar.tsx 的 `t('menubar.${menu}')` 保持一致。
-    const payload = raw.map((m) => ({
-        ...m,
-        title: translate(`menubar.${m.menu}`),
-    }));
-    const fileIds = raw.find((m) => m.menu === 'file')?.items.map((i) => i.id) ?? [];
-    trace(`push: serialized menus=${payload.length} file.items=[${fileIds.join(',')}]`);
-    try {
-        await invoke('set_app_menu', { payload });
-        trace('push: set_app_menu resolved');
-    }
-    catch (err) {
-        trace(`push: set_app_menu REJECTED ${err?.message ?? String(err)}`);
-        console.warn('[native-menu-bridge] set_app_menu failed:', err?.message ?? err);
-    }
-}
-// ─── Init (唯一对外入口) ────────────────────────────────────────────────
-/** 幂等标记:StrictMode 双 invoke / boot 双路径都可能重入 init,原生只该被安装一次。
- *  一旦装上:后续调用直接返回。 */
-let installed = false;
-/** Public entry —— App.tsx 在 boot 完成后调用一次。返回 Promise 让调用方能
- *  await (不必须);浏览器形态立刻 resolve()。 */
-export async function initNativeMenuBridge(opts) {
-    if (!isTauri())
-        return; // web 形态 no-op
-    if (installed)
-        return;
-    installed = true;
-    const { translate } = opts;
-    // 懒加载 Tauri API —— 与 runtime.ts 的其它加载器同风格,避免把 chunk 塞进 web bundle。
-    const [{ invoke }, eventMod] = await Promise.all([
-        import('@tauri-apps/api/core'),
-        import('@tauri-apps/api/event'),
-    ]);
-    traceSink = (line) => { void invoke('fx_trace', { line }).catch(() => { }); };
-    trace('init: tauri api loaded, starting first push…');
-    // 1. 原生点击回吐 —— Rust 侧 on_menu_event emit 'menu:invoke' { id },
-    //    我们查注册表拿到 commandId + args,派发到 command bus。
-    //    先注册监听器再做首次 push:首次 push 会预热 listGames,若接口卡住,
-    //    旧菜单仍能响应点击,不会出现"菜单显示但点击无反应"的窗口。
-    await eventMod.listen('menu:invoke', (ev) => {
-        const id = ev.payload?.id;
-        trace(`recv: menu:invoke id=${String(id)}`);
-        if (!id)
-            return;
-        const def = findMenuItemById(id);
-        if (!def) {
-            // 原生菜单栏比 web 快照晚一拍时可能出现;下次 push 会对齐。
-            trace(`recv: id=${id} NOT FOUND in registry — dropped`);
-            console.warn('[native-menu-bridge] menu:invoke for unknown id:', id);
-            return;
+/** One mounted shell owns all native subscriptions, including asynchronous setup. */
+export function installNativeMenuBridge(opts, deps) {
+    let disposed = false;
+    const cleanups = [];
+    const report = (error) => {
+        try {
+            deps.reportError(error);
         }
-        if (!def.commandId) {
-            trace(`recv: id=${id} has no commandId (placeholder) — dropped`);
-            return; // 纯文本占位项,无命令。
+        catch { /* Reporting must not prevent cleanup. */ }
+    };
+    const safely = (cleanup) => {
+        try {
+            cleanup();
         }
-        trace(`dispatch: id=${id} → command '${def.commandId}' args=${JSON.stringify(def.args ?? null)}`);
-        void Promise.resolve(opts.execute(def.commandId, def.args)).then((r) => trace(`dispatch: '${def.commandId}' resolved ${JSON.stringify(r ?? null)}`), (e) => trace(`dispatch: '${def.commandId}' REJECTED ${e?.message ?? String(e)}`));
-    });
-    trace('init: menu:invoke listener registered — bridge live before first push');
-    // 2. 注册表变动 —— 后续 register/unregister/when 切换都会触发 rebuild。
-    //    在 change 时直接 fire-and-forget push;失败已在 pushMenusToNative 内吞。
-    onMenuChange(() => {
-        void pushMenusToNative(invoke, translate);
+        catch (error) {
+            report(error);
+        }
+    };
+    const retain = (cleanup) => {
+        if (disposed)
+            safely(cleanup);
+        else
+            cleanups.push(cleanup);
+    };
+    const dispose = () => {
+        if (disposed)
+            return;
+        disposed = true;
+        for (const cleanup of cleanups.splice(0).reverse())
+            safely(cleanup);
+    };
+    void (async () => {
+        const transport = await deps.loadTransport();
+        if (disposed)
+            return;
+        const sink = (line) => {
+            if (!disposed)
+                void transport.invoke('fx_trace', { line }).catch(() => { });
+        };
+        traceSink = sink;
+        retain(() => { if (traceSink === sink)
+            traceSink = null; });
+        // Subscribe before warming so existing native items remain responsive.
+        const off = await transport.listen(id => {
+            if (disposed || !id)
+                return;
+            try {
+                const item = findMenuItemById(id, opts.menus);
+                if (!item?.commandId)
+                    return;
+                void Promise.resolve(opts.execute(item.commandId, item.args)).catch(report);
+            }
+            catch (error) {
+                report(error);
+            }
+        });
+        retain(off);
+        if (disposed)
+            return;
+        // Serialize pushes: a slower old update must not overwrite a newer locale
+        // or host snapshot. Events arriving during warming are read in that push.
+        let dirty = false;
+        let running = false;
+        const refresh = () => {
+            if (disposed)
+                return;
+            dirty = true;
+            if (running)
+                return;
+            running = true;
+            void (async () => {
+                try {
+                    while (!disposed && dirty) {
+                        dirty = false;
+                        try {
+                            await deps.warmRecentGames();
+                            if (disposed)
+                                return;
+                            dirty = false;
+                            const payload = serializeApplicationMenusForNative(opts.menus.snapshot())
+                                .map(menu => ({ ...menu, title: opts.translate(`menubar.${menu.menu}`) }));
+                            await transport.invoke('set_app_menu', { payload });
+                        }
+                        catch (error) {
+                            report(error);
+                        }
+                    }
+                }
+                finally {
+                    running = false;
+                }
+            })();
+        };
+        retain(opts.menus.subscribe(refresh));
+        retain(deps.subscribeLocale(refresh));
+        refresh();
+    })().catch(error => { report(error); dispose(); });
+    return dispose;
+}
+/** Browser shells install nothing. React effect cleanup also fences late imports. */
+export function initNativeMenuBridge(opts) {
+    if (!isTauri())
+        return () => { };
+    return installNativeMenuBridge(opts, {
+        async loadTransport() {
+            const [core, events] = await Promise.all([
+                import('@tauri-apps/api/core'),
+                import('@tauri-apps/api/event'),
+            ]);
+            return {
+                invoke: (command, args) => core.invoke(command, args),
+                listen: listener => events.listen('menu:invoke', event => listener(event.payload?.id)),
+            };
+        },
+        warmRecentGames,
+        subscribeLocale: listener => subscribeLocale(listener),
+        reportError: error => console.warn('[native-menu-bridge]', error),
     });
-    // 3. 首次推送 —— 让原生菜单栏与当前注册表对齐。
-    await pushMenusToNative(invoke, translate);
-    trace('init: first push returned');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/interface",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "ForgeaX product interface shell and application composition boundary.",
   "license": "Apache-2.0",
@@ -92,7 +92,7 @@
     "lint:dep": "depcruise -c .dependency-cruiser.cjs src"
   },
   "dependencies": {
-    "@forgeax/app-shell": "0.86.0",
+    "@forgeax/app-shell": "0.88.0",
     "@forgeax/extension-host": "0.3.2",
     "@forgeax/extension-platform": "0.5.0",
     "@forgeax/toolkit": "0.1.2",

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

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

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

@@ -1,182 +0,0 @@
-// packages/interface/src/core/extensions/editor-commands.ts
-//
-// Command-bus wrappers for editor-domain actions (Play/Stop/Save/Undo/Redo/
-// select-all/delete/frame/toggle-display/deselect/…). These commands are the
-// single entry point the top menu bar (builtin-menus.ts) and the keyboard
-// router share so palette/menu/shortcut hit the same call path.
-//
-// The interface package is editor-agnostic (lint:agnostic forbids importing
-// @forgeax/editor), so every command routes through the injected
-// KeyboardRouterDeps — the host editor (studio/main.tsx) calls
-// registerKeyboardRouterDeps() at boot BEFORE <App> mounts, and each execute
-// resolves the deps LAZILY via getKeyboardRouterDeps(). Capture-at-setup
-// would freeze deps to null since setup runs during bootstrapAppHost() which
-// happens before main.tsx has finished mounting <App>; lazy resolution keeps
-// this file boot-order-safe regardless of whether registration happened first.
-//
-// import + reveal: NOT registered. Content-browser import and OS file-reveal
-// live outside KeyboardRouterDeps and can't be reached editor-agnostically
-// from the interface foundation. The corresponding menu items in builtin-menus.ts carry no
-// commandId and stay disabled — the correct signal for a not-yet-wired
-// capability. Flip them on when a dep or command later lands.
-//
-// reloadPreview: registered as a best-effort event emit (`preview:reload` on
-// ctx.bus). No listener consumes it yet — the Play iframe self-reload lives
-// in @forgeax/editor/PlaySurface which the interface foundation cannot import. Emitting the event
-// keeps the menu item live and gives a future HMR/preview owner a stable hook
-// to subscribe to without touching this file.
-import { APPLICATION_KEYBINDING_SCOPE } from '../contextual-keybindings';
-import { getKeyboardRouterDeps } from '../../lib/global-shortcuts';
-import { executeFocusedTextEditAction } from '../../lib/text-edit-actions';
-/** Resolve the injected router deps or throw a clear error naming the missing
- *  wiring — makes a mis-boot fail loudly at command-invoke time instead of
- *  silently no-op'ing. */
-function requireDeps() {
-    const deps = getKeyboardRouterDeps();
-    if (!deps)
-        throw new Error('editor-commands: editor deps not injected (host must call registerKeyboardRouterDeps before invoking editor.* commands)');
-    return deps;
-}
-export const editorCommandsExtension = {
-    id: 'editor-commands',
-    version: '1.0.0',
-    requires: ['commands', 'keybindings'],
-    setup(ctx) {
-        const { registerCommand, host } = ctx;
-        const cleanups = [];
-        cleanups.push(registerCommand({
-            id: 'editor.play',
-            title: '开始预览 (Play)',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'play' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.stop',
-            title: '停止预览 (Stop)',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'stop' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.toggleDisplay',
-            title: '切换 Scene / Game 视图',
-            execute: () => {
-                const deps = requireDeps();
-                const next = deps.getDisplay() === 'scene' ? 'game' : 'scene';
-                deps.dispatch({ kind: 'setDisplay', display: next }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.undo',
-            title: '撤销',
-            execute: () => {
-                requireDeps().undo();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.redo',
-            title: '重做',
-            execute: () => {
-                requireDeps().redo();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.save',
-            title: '保存',
-            execute: () => {
-                requireDeps().save();
-                return { status: 'completed' };
-            },
-        }));
-        // Application-scoped Mod+S runs before legacy edit shortcuts and is not
-        // gated on the viewport surface anchor. Material / Texture / other asset
-        // document pages replace the viewport dock layout, so isEditorSurfaceActive()
-        // is false there — without this binding Ctrl+S falls through to the browser
-        // "save page" dialog instead of editor.save → material-first save diversion.
-        cleanups.push(host.keybindings.register({
-            commandId: 'editor.save',
-            keys: 'Mod+S',
-            scope: APPLICATION_KEYBINDING_SCOPE,
-            allowInEditable: true,
-            priority: 100,
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.selectAll',
-            title: '全选实体',
-            execute: async () => {
-                if (await executeFocusedTextEditAction('selectAll')) {
-                    return { status: 'completed' };
-                }
-                requireDeps().selectAllEntities();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.deselect',
-            title: '清除选择',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'setSelection', id: null }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.frameSelected',
-            title: '聚焦所选',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'requestFrame' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.delete',
-            title: '删除所选实体',
-            execute: () => {
-                const deps = requireDeps();
-                const ids = deps.getEntitySelection();
-                if (ids.length > 0)
-                    deps.deleteEntities(ids);
-                return { status: 'completed' };
-            },
-        }));
-        // Partial: bus event only, no listener wired yet (see file header). A
-        // future preview/HMR owner in a standalone application subscribes to 'preview:reload'
-        // and forwards to the Play iframe self-reload. `ctx.bus.emit` is typed
-        // against AppBusEventMap which extends Record<string, unknown>, so an
-        // ad-hoc topic name is accepted with an `unknown` payload.
-        cleanups.push(registerCommand({
-            id: 'editor.reloadPreview',
-            title: '重载预览 (partial: 事件已发,尚无消费者)',
-            execute: () => {
-                // Not calling requireDeps() — reloadPreview is decoupled from the
-                // editor gateway; the current path is a bus-event handoff, and a
-                // future consumer may not even need the router deps.
-                ctx.bus.emit('preview:reload', {});
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.restartPreview',
-            title: '重建预览运行时',
-            execute: () => {
-                const restart = requireDeps().restartPreview;
-                if (!restart)
-                    throw new Error('editor.restartPreview: host did not provide restartPreview');
-                restart();
-                return { status: 'completed' };
-            },
-        }));
-        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/lib/repair-builtin-menus.d.ts

@@ -1,6 +0,0 @@
-/** Re-register built-in menus when the module-level registry was cleared
- *  (React StrictMode dispose race, Vite HMR module swap) but shell chrome
- *  is still mounted. Idempotent — no-op when File menu already populated. */
-export declare function repairBuiltinMenusIfEmpty(): void;
-/** Test-only: tear down ad-hoc repair registration. */
-export declare function __resetBuiltinMenuRepairForTest(): void;

package/dist/package/browser/lib/repair-builtin-menus.js

@@ -1,18 +0,0 @@
-import { builtinMenusExtension } from '../core/extensions/builtin-menus';
-import { snapshotMenu } from './menu-registry';
-let adhocCleanup;
-/** Re-register built-in menus when the module-level registry was cleared
- *  (React StrictMode dispose race, Vite HMR module swap) but shell chrome
- *  is still mounted. Idempotent — no-op when File menu already populated. */
-export function repairBuiltinMenusIfEmpty() {
-    if (snapshotMenu('file').length > 0)
-        return;
-    adhocCleanup?.();
-    const result = builtinMenusExtension.setup?.({});
-    adhocCleanup = typeof result === 'function' ? result : undefined;
-}
-/** Test-only: tear down ad-hoc repair registration. */
-export function __resetBuiltinMenuRepairForTest() {
-    adhocCleanup?.();
-    adhocCleanup = undefined;
-}

package/dist/package/node/core/extensions/editor-commands.js

@@ -1,182 +0,0 @@
-// packages/interface/src/core/extensions/editor-commands.ts
-//
-// Command-bus wrappers for editor-domain actions (Play/Stop/Save/Undo/Redo/
-// select-all/delete/frame/toggle-display/deselect/…). These commands are the
-// single entry point the top menu bar (builtin-menus.ts) and the keyboard
-// router share so palette/menu/shortcut hit the same call path.
-//
-// The interface package is editor-agnostic (lint:agnostic forbids importing
-// @forgeax/editor), so every command routes through the injected
-// KeyboardRouterDeps — the host editor (studio/main.tsx) calls
-// registerKeyboardRouterDeps() at boot BEFORE <App> mounts, and each execute
-// resolves the deps LAZILY via getKeyboardRouterDeps(). Capture-at-setup
-// would freeze deps to null since setup runs during bootstrapAppHost() which
-// happens before main.tsx has finished mounting <App>; lazy resolution keeps
-// this file boot-order-safe regardless of whether registration happened first.
-//
-// import + reveal: NOT registered. Content-browser import and OS file-reveal
-// live outside KeyboardRouterDeps and can't be reached editor-agnostically
-// from the interface foundation. The corresponding menu items in builtin-menus.ts carry no
-// commandId and stay disabled — the correct signal for a not-yet-wired
-// capability. Flip them on when a dep or command later lands.
-//
-// reloadPreview: registered as a best-effort event emit (`preview:reload` on
-// ctx.bus). No listener consumes it yet — the Play iframe self-reload lives
-// in @forgeax/editor/PlaySurface which the interface foundation cannot import. Emitting the event
-// keeps the menu item live and gives a future HMR/preview owner a stable hook
-// to subscribe to without touching this file.
-import { APPLICATION_KEYBINDING_SCOPE } from '../contextual-keybindings.js';
-import { getKeyboardRouterDeps } from '../../lib/global-shortcuts.js';
-import { executeFocusedTextEditAction } from '../../lib/text-edit-actions.js';
-/** Resolve the injected router deps or throw a clear error naming the missing
- *  wiring — makes a mis-boot fail loudly at command-invoke time instead of
- *  silently no-op'ing. */
-function requireDeps() {
-    const deps = getKeyboardRouterDeps();
-    if (!deps)
-        throw new Error('editor-commands: editor deps not injected (host must call registerKeyboardRouterDeps before invoking editor.* commands)');
-    return deps;
-}
-export const editorCommandsExtension = {
-    id: 'editor-commands',
-    version: '1.0.0',
-    requires: ['commands', 'keybindings'],
-    setup(ctx) {
-        const { registerCommand, host } = ctx;
-        const cleanups = [];
-        cleanups.push(registerCommand({
-            id: 'editor.play',
-            title: '开始预览 (Play)',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'play' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.stop',
-            title: '停止预览 (Stop)',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'stop' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.toggleDisplay',
-            title: '切换 Scene / Game 视图',
-            execute: () => {
-                const deps = requireDeps();
-                const next = deps.getDisplay() === 'scene' ? 'game' : 'scene';
-                deps.dispatch({ kind: 'setDisplay', display: next }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.undo',
-            title: '撤销',
-            execute: () => {
-                requireDeps().undo();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.redo',
-            title: '重做',
-            execute: () => {
-                requireDeps().redo();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.save',
-            title: '保存',
-            execute: () => {
-                requireDeps().save();
-                return { status: 'completed' };
-            },
-        }));
-        // Application-scoped Mod+S runs before legacy edit shortcuts and is not
-        // gated on the viewport surface anchor. Material / Texture / other asset
-        // document pages replace the viewport dock layout, so isEditorSurfaceActive()
-        // is false there — without this binding Ctrl+S falls through to the browser
-        // "save page" dialog instead of editor.save → material-first save diversion.
-        cleanups.push(host.keybindings.register({
-            commandId: 'editor.save',
-            keys: 'Mod+S',
-            scope: APPLICATION_KEYBINDING_SCOPE,
-            allowInEditable: true,
-            priority: 100,
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.selectAll',
-            title: '全选实体',
-            execute: async () => {
-                if (await executeFocusedTextEditAction('selectAll')) {
-                    return { status: 'completed' };
-                }
-                requireDeps().selectAllEntities();
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.deselect',
-            title: '清除选择',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'setSelection', id: null }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.frameSelected',
-            title: '聚焦所选',
-            execute: () => {
-                requireDeps().dispatch({ kind: 'requestFrame' }, 'human');
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.delete',
-            title: '删除所选实体',
-            execute: () => {
-                const deps = requireDeps();
-                const ids = deps.getEntitySelection();
-                if (ids.length > 0)
-                    deps.deleteEntities(ids);
-                return { status: 'completed' };
-            },
-        }));
-        // Partial: bus event only, no listener wired yet (see file header). A
-        // future preview/HMR owner in a standalone application subscribes to 'preview:reload'
-        // and forwards to the Play iframe self-reload. `ctx.bus.emit` is typed
-        // against AppBusEventMap which extends Record<string, unknown>, so an
-        // ad-hoc topic name is accepted with an `unknown` payload.
-        cleanups.push(registerCommand({
-            id: 'editor.reloadPreview',
-            title: '重载预览 (partial: 事件已发,尚无消费者)',
-            execute: () => {
-                // Not calling requireDeps() — reloadPreview is decoupled from the
-                // editor gateway; the current path is a bus-event handoff, and a
-                // future consumer may not even need the router deps.
-                ctx.bus.emit('preview:reload', {});
-                return { status: 'completed' };
-            },
-        }));
-        cleanups.push(registerCommand({
-            id: 'editor.restartPreview',
-            title: '重建预览运行时',
-            execute: () => {
-                const restart = requireDeps().restartPreview;
-                if (!restart)
-                    throw new Error('editor.restartPreview: host did not provide restartPreview');
-                restart();
-                return { status: 'completed' };
-            },
-        }));
-        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/node/lib/repair-builtin-menus.js

@@ -1,18 +0,0 @@
-import { builtinMenusExtension } from '../core/extensions/builtin-menus.js';
-import { snapshotMenu } from './menu-registry.js';
-let adhocCleanup;
-/** Re-register built-in menus when the module-level registry was cleared
- *  (React StrictMode dispose race, Vite HMR module swap) but shell chrome
- *  is still mounted. Idempotent — no-op when File menu already populated. */
-export function repairBuiltinMenusIfEmpty() {
-    if (snapshotMenu('file').length > 0)
-        return;
-    adhocCleanup?.();
-    const result = builtinMenusExtension.setup?.({});
-    adhocCleanup = typeof result === 'function' ? result : undefined;
-}
-/** Test-only: tear down ad-hoc repair registration. */
-export function __resetBuiltinMenuRepairForTest() {
-    adhocCleanup?.();
-    adhocCleanup = undefined;
-}