@dimina-kit/devtools 0.4.0-dev.20260828161241 → 0.4.0-dev.20260907055341

package/dist/main/ipc/simulator.js

@@ -1,41 +1,35 @@
-import { ServiceHostChannel, SimulatorChannel, SimulatorCustomApiChannel } from '../../shared/ipc-channels.js';
+import { SimulatorChannel, SimulatorCustomApiChannel } from '../../shared/ipc-channels.js';
 import { SimulatorAttachNativeSchema, SimulatorCustomApiInvokeSchema, SimulatorSetDeviceInfoSchema, SimulatorSoftReloadSchema, } from '../../shared/ipc-schemas.js';
-import { deviceInfoToHostEnv } from '../../shared/bridge-channels.js';
 import { validate } from '../utils/ipc-schema.js';
 import { IpcRegistry } from '../utils/ipc-registry.js';
-export function registerSimulatorIpc(ctx) {
-    return new IpcRegistry(ctx.senderPolicy)
-        .handle(SimulatorChannel.AttachNative, (_, ...args) => {
+import { toIpcContextSource } from '../utils/ipc-context-source.js';
+export function registerSimulatorIpc(input) {
+    return new IpcRegistry(toIpcContextSource(input))
+        .handleRouted(SimulatorChannel.AttachNative, (ctx, _e, ...args) => {
         const [simulatorUrl, simWidth] = validate(SimulatorChannel.AttachNative, SimulatorAttachNativeSchema, args);
         return ctx.views.attachNativeSimulator(simulatorUrl, simWidth);
     })
-        .handle(SimulatorChannel.SoftReload, (_, ...args) => {
+        .handleRouted(SimulatorChannel.SoftReload, (ctx, _e, ...args) => {
         const [simulatorUrl] = validate(SimulatorChannel.SoftReload, SimulatorSoftReloadSchema, args);
         return ctx.views.softReloadNativeSimulator(simulatorUrl);
     })
-        .handle(SimulatorChannel.Detach, () => {
+        .handleRouted(SimulatorChannel.Detach, (ctx) => {
         ctx.views.detachSimulator();
     })
-        .handle(SimulatorChannel.SetDeviceInfo, (_, ...args) => {
+        .handleRouted(SimulatorChannel.SetDeviceInfo, (ctx, _e, ...args) => {
         const [device] = validate(SimulatorChannel.SetDeviceInfo, SimulatorSetDeviceInfoSchema, args);
         // Cache the selection (rides the next NATIVE_HOST_ENABLED reply for a
         // race-free DeviceShell init) and push DEVICE_CHANGE to the live simulator
         // WCV so the DeviceShell resizes the bezel + re-renders status bar / notch.
+        // `setDevice` also pushes `hostEnvUpdate` + `pageResize` to every running
+        // service host, so `wx.getSystemInfoSync()` and `Page.onResize` follow
+        // the selection without a relaunch.
         ctx.bridge?.setDevice(device);
         // Re-push the CSS env(safe-area-inset-*) override to attached render-host
         // guests so notch-aware page layout updates without a reload.
         ctx.views.reapplySafeArea(device);
-        // Live-update the running service-host window's host-env snapshot so
-        // `wx.getSystemInfoSync()` reflects the selected device without a relaunch.
-        // The service-host preload mutates `__diminaSpawnContext` in place;
-        // `getSystemInfoSync` reads it fresh on each call. No service window yet
-        // (pre-spawn) → no-op.
-        const serviceWc = ctx.bridge?.getServiceWc();
-        if (serviceWc && !serviceWc.isDestroyed()) {
-            serviceWc.send(ServiceHostChannel.HostEnvUpdate, deviceInfoToHostEnv(device));
-        }
     })
-        .handle(SimulatorCustomApiChannel.Invoke, (_, ...args) => {
+        .handleRouted(SimulatorCustomApiChannel.Invoke, (ctx, _e, ...args) => {
         const [name, params] = validate(SimulatorCustomApiChannel.Invoke, SimulatorCustomApiInvokeSchema, args);
         return ctx.simulatorApis.invoke(name, params);
     });

package/dist/main/ipc/tooltip.d.ts

@@ -2,12 +2,13 @@ import type { WorkbenchModule } from '../services/module.js';
 import type { ViewManager } from '../services/views/view-manager.js';
 import type { Disposable } from '@dimina-kit/electron-deck/main';
 import { type SenderPolicy } from '../utils/ipc-registry.js';
+import { type IpcInput } from '../utils/ipc-context-source.js';
 /** Module-local narrow deps — deliberately NOT `Pick<WorkbenchContext, ...>`
  * (the gate in eslint.config.* is shrink-only; see its message). */
 export interface TooltipIpcDeps {
     views: Pick<ViewManager, 'prepareTooltip' | 'showTooltip' | 'hideTooltip' | 'markOverlayReady' | 'applyTooltipMeasurement'>;
     senderPolicy?: SenderPolicy;
 }
-export declare function registerTooltipIpc(ctx: TooltipIpcDeps): Disposable;
+export declare function registerTooltipIpc(input: IpcInput<TooltipIpcDeps>): Disposable;
 export declare const tooltipModule: WorkbenchModule;
 //# sourceMappingURL=tooltip.d.ts.map

package/dist/main/ipc/tooltip.js

@@ -2,22 +2,23 @@ import { OverlayChannel, TooltipChannel } from '../../shared/ipc-channels-overla
 import { TooltipMeasuredSchema, TooltipShowSchema } from '../../shared/ipc-schemas.js';
 import { validate } from '../utils/ipc-schema.js';
 import { IpcRegistry } from '../utils/ipc-registry.js';
-export function registerTooltipIpc(ctx) {
-    return new IpcRegistry(ctx.senderPolicy)
-        .on(TooltipChannel.Prepare, () => {
+import { toIpcContextSource } from '../utils/ipc-context-source.js';
+export function registerTooltipIpc(input) {
+    return new IpcRegistry(toIpcContextSource(input))
+        .onRouted(TooltipChannel.Prepare, (ctx) => {
         ctx.views.prepareTooltip();
     })
-        .on(TooltipChannel.Show, (_event, ...args) => {
+        .onRouted(TooltipChannel.Show, (ctx, _event, ...args) => {
         const [data] = validate(TooltipChannel.Show, TooltipShowSchema, args);
         ctx.views.showTooltip(data);
     })
-        .on(TooltipChannel.Hide, () => {
+        .onRouted(TooltipChannel.Hide, (ctx) => {
         ctx.views.hideTooltip();
     })
-        .on(OverlayChannel.Ready, (event) => {
+        .onRouted(OverlayChannel.Ready, (ctx, event) => {
         ctx.views.markOverlayReady(event.sender.id);
     })
-        .on(TooltipChannel.Measured, (event, ...args) => {
+        .onRouted(TooltipChannel.Measured, (ctx, event, ...args) => {
         const [measurement] = validate(TooltipChannel.Measured, TooltipMeasuredSchema, args);
         ctx.views.applyTooltipMeasurement(event.sender.id, measurement);
     });

package/dist/main/ipc/views.d.ts

@@ -1,5 +1,7 @@
 import type { WorkbenchContext } from '../services/workbench-context.js';
 import type { Disposable } from '@dimina-kit/electron-deck/main';
+import { type IpcInput } from '../utils/ipc-context-source.js';
+type ViewsIpcCtx = Pick<WorkbenchContext, 'views' | 'senderPolicy'>;
 /**
  * Renderer-driven overlay bounds, plus the renderer bootstrap's
  * placement-generation seed pull.
@@ -29,5 +31,6 @@ import type { Disposable } from '@dimina-kit/electron-deck/main';
  * disables it on the fatal boot-failure page, or leave placement silently
  * non-functional. See disabled-module.test.ts for the end-to-end guard.
  */
-export declare function registerViewsIpc(ctx: Pick<WorkbenchContext, 'views' | 'senderPolicy'>): Disposable;
+export declare function registerViewsIpc(input: IpcInput<ViewsIpcCtx>): Disposable;
+export {};
 //# sourceMappingURL=views.d.ts.map

package/dist/main/ipc/views.js

@@ -3,6 +3,7 @@ import { ViewChannel } from '../../shared/ipc-channels-overlays.js';
 import { PlacementSnapshotSchema, HostToolbarAdvertiseHeightSchema, HostSidebarAdvertiseWidthSchema, HostDialogAdvertiseSizeSchema, } from '../../shared/ipc-schemas.js';
 import { validate } from '../utils/ipc-schema.js';
 import { IpcRegistry } from '../utils/ipc-registry.js';
+import { toIpcContextSource } from '../utils/ipc-context-source.js';
 /**
  * Renderer-driven overlay bounds, plus the renderer bootstrap's
  * placement-generation seed pull.
@@ -32,16 +33,23 @@ import { IpcRegistry } from '../utils/ipc-registry.js';
  * disables it on the fatal boot-failure page, or leave placement silently
  * non-functional. See disabled-module.test.ts for the end-to-end guard.
  */
-export function registerViewsIpc(ctx) {
-    const registry = new IpcRegistry(ctx.senderPolicy)
+export function registerViewsIpc(input) {
+    const source = toIpcContextSource(input);
+    // The raw listeners below trust an exact wc id, and each window mounts its
+    // own host slots — so the id itself names the owning window. Scanning the
+    // live contexts for the one whose slot holds this sender is both the trust
+    // gate and the routing decision; no match means the message came from
+    // somewhere that is not a host slot at all, and is dropped.
+    const ownerOfSlot = (event, slotWebContentsId) => source.list().find((ctx) => slotWebContentsId(ctx) === event.sender.id) ?? null;
+    const registry = new IpcRegistry(source)
         // Renderer bootstrap: allocate this session's placement-generation seed
         // (see renderer-placement-generation.ts / PlacementReconciler.allocateGeneration).
-        .handle(ViewChannel.AllocatePlacementGeneration, () => ctx.views.allocatePlacementGeneration())
+        .handleRouted(ViewChannel.AllocatePlacementGeneration, (ctx) => ctx.views.allocatePlacementGeneration())
         // Window-level placement snapshot: the single source of truth for every
         // managed native view's bounds/visibility/z-order. The renderer's central
         // publisher coalesces one snapshot per frame; the reconciler diffs it
         // against the actual view tree. Supersedes the per-view bounds channels.
-        .handle(ViewChannel.PlacementSnapshot, (_event, ...args) => {
+        .handleRouted(ViewChannel.PlacementSnapshot, (ctx, _event, ...args) => {
         const [snapshot] = validate(ViewChannel.PlacementSnapshot, PlacementSnapshotSchema, args);
         ctx.views.setPlacementSnapshot(snapshot);
     })
@@ -53,10 +61,10 @@ export function registerViewsIpc(ctx) {
         // senderPolicy-gated registry as HostToolbarBounds: the toolbar WCV's
         // arbitrary host content must not reach this — only the trusted main
         // renderer pulls. Live delegation, not a registration-time snapshot.
-        .handle(ViewChannel.HostToolbarGetHeight, () => ctx.views.getHostToolbarHeight())
+        .handleRouted(ViewChannel.HostToolbarGetHeight, (ctx) => ctx.views.getHostToolbarHeight())
         // Same mount-time replay role as HostToolbarGetHeight, on the sidebar's
         // inline (width) axis.
-        .handle(ViewChannel.HostSidebarGetWidth, () => ctx.views.getHostSidebarWidth());
+        .handleRouted(ViewChannel.HostSidebarGetWidth, (ctx) => ctx.views.getHostSidebarWidth());
     // Reverse size-advertiser: the toolbar WCV's OWN renderer sends this, and the
     // host loads ARBITRARY content into that WCV. We DELIBERATELY do NOT add the
     // toolbar wc to the global sender policy — that would trust it for ALL ~72
@@ -68,7 +76,8 @@ export function registerViewsIpc(ctx) {
     // The host content can reach ONLY this one channel, carrying only a
     // non-negative integer height.
     const onAdvertiseHeight = (event, ...args) => {
-        if (event.sender.id !== ctx.views.getHostToolbarWebContentsId())
+        const ctx = ownerOfSlot(event, (c) => c.views.getHostToolbarWebContentsId());
+        if (!ctx)
             return;
         let extent;
         try {
@@ -84,7 +93,8 @@ export function registerViewsIpc(ctx) {
     // Same precise-sender-id trust model as onAdvertiseHeight, on the
     // sidebar's inline (width) axis.
     const onAdvertiseWidth = (event, ...args) => {
-        if (event.sender.id !== ctx.views.getHostSidebarWebContentsId())
+        const ctx = ownerOfSlot(event, (c) => c.views.getHostSidebarWebContentsId());
+        if (!ctx)
             return;
         let extent;
         try {
@@ -102,7 +112,8 @@ export function registerViewsIpc(ctx) {
     // slot: either axis may arrive, and the view manager re-centers using
     // whichever axes it has measured so far.
     const onAdvertiseDialogSize = (event, ...args) => {
-        if (event.sender.id !== ctx.views.getHostDialogWebContentsId())
+        const ctx = ownerOfSlot(event, (c) => c.views.getHostDialogWebContentsId());
+        if (!ctx)
             return;
         let axis;
         let extent;

package/dist/main/runtime/devtools-backend-before-quit.harness.d.ts

@@ -1,30 +1,12 @@
 import type { WorkbenchAppConfig } from '../../shared/types.js';
 import type { RuntimeBackend } from '@dimina-kit/electron-deck';
-declare const stubs: {
-    handlers: Map<string, (...args: unknown[]) => unknown>;
-    projectsJsonPath: string;
-    getProjectsJson(): string | null;
-    setProjectsJson(v: string | null): void;
-    projectsWithAppJson: Set<string>;
-    makeEmitter: () => {
-        listeners: Record<string, Set<(...args: unknown[]) => unknown>>;
-        on(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
-        once(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
-        off(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
-        removeListener(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
-        emit(event: string, ...args: unknown[]): void;
-    };
-    reset: () => void;
-};
-declare const devkitStubs: {
-    sessionClose: import("vitest").Mock<() => Promise<void>>;
-};
 declare const viewManagerStubs: {
     createdManagers: Array<{
         disposeAll: () => void;
     }>;
 };
-export { stubs, devkitStubs, viewManagerStubs };
+export { stubs, devkitStubs } from './devtools-runtime-mock.harness.js';
+export { viewManagerStubs };
 /**
  * Shared per-test setup both `devtools-backend-before-quit.test.ts` and
  * `devtools-backend-shutdown-race.test.ts` need identically: reset modules

package/dist/main/runtime/devtools-backend-before-quit.harness.js

@@ -1,291 +1,21 @@
 /**
  * Shared vitest mock harness for `devtools-backend-before-quit.test.ts` and
  * `devtools-backend-shutdown-race.test.ts` — both drive the REAL
- * `createDevtoolsBackend`/`createDevtoolsRuntime` against this same
- * electron/fs/`@dimina-kit/devkit`/view-manager mock set (lifted from
- * `quit-flag-onclose.test.ts`), split out to keep each test file under the
- * repo's 500-line file-length ratchet without duplicating ~350 lines of
- * mock setup between them.
+ * `createDevtoolsBackend`/`createDevtoolsRuntime` against the electron/fs/
+ * `@dimina-kit/devkit` mock set defined in `./devtools-runtime-mock.harness.ts`,
+ * plus the view-manager spy shim and backend-lifecycle helpers below that
+ * only these two tests need.
  *
- * `vi.mock(...)` calls here run once per importing test file's own isolated
- * module graph (vitest scopes mocking per test file), so importing this
- * module has the same effect as if each call were written directly in the
- * importing file — both test files' `beforeEach` still dynamically
- * `await import('./devtools-backend.js')` AFTER `vi.resetModules()`, well
- * after this module's mock registrations have already run.
+ * `vi.mock(...)` calls in the imported core module run once per importing
+ * test file's own isolated module graph (vitest scopes mocking per test
+ * file); chaining through this module has the same effect as if they were
+ * written directly in the importing file — both test files' `beforeEach`
+ * still dynamically `await import('./devtools-backend.js')` AFTER
+ * `vi.resetModules()`, well after the core module's mock registrations have
+ * already run.
  */
 import { beforeEach, expect, vi } from 'vitest';
-// ── Hoisted stub state (lifted from quit-flag-onclose.test.ts) ────────────
-// `export const x = vi.hoisted(...)` is rejected by vitest's hoisting
-// transform ("Cannot export hoisted variable") — declare then export below.
-const stubs = vi.hoisted(() => {
-    const handlers = new Map();
-    const projectsJsonPath = '/tmp/dimina-test-userdata/dimina-projects.json';
-    let projectsJsonContent = null;
-    const projectsWithAppJson = new Set();
-    function makeEmitter() {
-        const listeners = {};
-        return {
-            listeners,
-            on(event, fn) {
-                ;
-                (listeners[event] ??= new Set()).add(fn);
-                return this;
-            },
-            once(event, fn) {
-                const wrap = (...args) => {
-                    listeners[event]?.delete(wrap);
-                    return fn(...args);
-                };
-                (listeners[event] ??= new Set()).add(wrap);
-                return this;
-            },
-            off(event, fn) {
-                listeners[event]?.delete(fn);
-                return this;
-            },
-            removeListener(event, fn) {
-                listeners[event]?.delete(fn);
-                return this;
-            },
-            emit(event, ...args) {
-                for (const fn of [...(listeners[event] ?? [])])
-                    fn(...args);
-            },
-        };
-    }
-    function reset() {
-        handlers.clear();
-        projectsJsonContent = null;
-        projectsWithAppJson.clear();
-    }
-    return {
-        handlers,
-        projectsJsonPath,
-        getProjectsJson() {
-            return projectsJsonContent;
-        },
-        setProjectsJson(v) {
-            projectsJsonContent = v;
-        },
-        projectsWithAppJson,
-        makeEmitter,
-        reset,
-    };
-});
-// ── electron stub ────────────────────────────────────────────────────────
-// `app` is a live emitter so `registerAppLifecycle` can attach a
-// `before-quit` listener that the test fires directly.
-vi.mock('electron', () => {
-    const ipcEmitter = stubs.makeEmitter();
-    const ipcMain = {
-        ...ipcEmitter,
-        handle: vi.fn((channel, fn) => {
-            stubs.handlers.set(channel, fn);
-        }),
-        removeHandler: vi.fn((channel) => {
-            stubs.handlers.delete(channel);
-        }),
-        on: vi.fn((event, fn) => ipcEmitter.on(event, fn)),
-        removeListener: vi.fn((event, fn) => ipcEmitter.removeListener(event, fn)),
-    };
-    const appEmitter = stubs.makeEmitter();
-    const app = {
-        ...appEmitter,
-        isPackaged: true,
-        whenReady: vi.fn(() => Promise.resolve()),
-        getPath: vi.fn(() => '/tmp/dimina-test-userdata'),
-        quit: vi.fn(),
-        setName: vi.fn(),
-        commandLine: {
-            getSwitchValue: vi.fn(() => ''),
-            appendSwitch: vi.fn(),
-        },
-    };
-    // `WebContents` and `BrowserWindow` below both wrap a `stubs.makeEmitter()`
-    // and need the SAME on/once/off/removeListener/emit delegation (the
-    // emitter's own methods use `this` internally, so a plain property copy
-    // would call them with the wrong receiver — each needs `.bind(em)`). Shared
-    // base class instead of re-declaring the same 5 bound fields in both.
-    class EmittingStub {
-        em = stubs.makeEmitter();
-        on = this.em.on.bind(this.em);
-        once = this.em.once.bind(this.em);
-        off = this.em.off.bind(this.em);
-        removeListener = this.em.removeListener.bind(this.em);
-        emit = this.em.emit.bind(this.em);
-    }
-    class WebContents extends EmittingStub {
-        destroyed = false;
-        id = Math.floor(Math.random() * 1e6);
-        send = vi.fn();
-        isDestroyed = () => this.destroyed;
-        openDevTools = vi.fn();
-        closeDevTools = vi.fn();
-        setDevToolsWebContents = vi.fn();
-        setWindowOpenHandler = vi.fn();
-        loadFile = vi.fn(() => Promise.resolve());
-        loadURL = vi.fn(() => Promise.resolve());
-        executeJavaScript = vi.fn(() => Promise.resolve(undefined));
-        reload = vi.fn();
-        getType = () => 'window';
-        getURL = () => '';
-        debugger = {
-            attach: vi.fn(),
-            detach: vi.fn(),
-            isAttached: () => false,
-            on: vi.fn(),
-            removeListener: vi.fn(),
-            sendCommand: vi.fn(() => Promise.resolve({ entries: [] })),
-        };
-        close = vi.fn(() => {
-            this.destroyed = true;
-        });
-    }
-    class WebContentsView {
-        webContents = new WebContents();
-        setBounds = vi.fn();
-        setBackgroundColor = vi.fn();
-    }
-    class View {
-        children = [];
-        addChildView(child) {
-            this.children.push(child);
-        }
-        removeChildView(child) {
-            const i = this.children.indexOf(child);
-            if (i >= 0)
-                this.children.splice(i, 1);
-        }
-    }
-    class BrowserWindow extends EmittingStub {
-        destroyed = false;
-        webContents = new WebContents();
-        contentView = new WebContentsView();
-        isDestroyed = () => this.destroyed;
-        getContentSize = () => [1280, 980];
-        setIcon = vi.fn();
-        setTitle = vi.fn();
-        show = vi.fn();
-        showInactive = vi.fn();
-        focus = vi.fn();
-        close = vi.fn();
-        destroy = vi.fn(() => {
-            this.destroyed = true;
-        });
-        loadFile = vi.fn(() => Promise.resolve());
-        loadURL = vi.fn(() => Promise.resolve());
-        static getAllWindows = vi.fn(() => []);
-    }
-    const sessionStub = {
-        fromPartition: vi.fn(() => ({
-            webRequest: {
-                onBeforeSendHeaders: vi.fn(),
-                onHeadersReceived: vi.fn(),
-            },
-            registerPreloadScript: vi.fn(),
-            protocol: { handle: vi.fn(), unhandle: vi.fn() },
-        })),
-        defaultSession: {
-            protocol: { handle: vi.fn(), unhandle: vi.fn() },
-        },
-    };
-    const dialog = {
-        showOpenDialog: vi.fn(() => Promise.resolve({ canceled: true, filePaths: [] })),
-        showMessageBox: vi.fn(() => Promise.resolve({ response: 0 })),
-    };
-    const Menu = {
-        buildFromTemplate: vi.fn((tpl) => ({ template: tpl })),
-        setApplicationMenu: vi.fn(),
-    };
-    const shell = {
-        openExternal: vi.fn(() => Promise.resolve()),
-        openPath: vi.fn(() => Promise.resolve('')),
-    };
-    const nativeImage = {
-        createFromPath: vi.fn(() => ({ isEmpty: () => true })),
-    };
-    const nativeTheme = { ...stubs.makeEmitter(), themeSource: 'system' };
-    const globalShortcut = {
-        register: vi.fn(() => false),
-        unregister: vi.fn(),
-        unregisterAll: vi.fn(),
-    };
-    const webContentsStatic = {
-        fromId: vi.fn(() => null),
-        getAllWebContents: vi.fn(() => []),
-    };
-    const Tray = vi.fn();
-    return {
-        app,
-        ipcMain,
-        BrowserWindow,
-        WebContentsView,
-        BrowserView: WebContentsView,
-        View,
-        webContents: webContentsStatic,
-        session: sessionStub,
-        protocol: { registerSchemesAsPrivileged: vi.fn(), handle: vi.fn(), unhandle: vi.fn() },
-        dialog,
-        Menu,
-        shell,
-        nativeImage,
-        nativeTheme,
-        globalShortcut,
-        Tray,
-        default: {},
-    };
-});
-vi.mock('fs', async () => {
-    const real = await vi.importActual('fs');
-    function existsSync(p) {
-        const s = String(p);
-        if (s === stubs.projectsJsonPath)
-            return stubs.getProjectsJson() !== null;
-        if (s.endsWith('/app.json') || s.endsWith('\\app.json')) {
-            const dir = s.replace(/[\\/]app\.json$/, '');
-            return stubs.projectsWithAppJson.has(dir);
-        }
-        return true;
-    }
-    function readFileSync(p, opts) {
-        const s = String(p);
-        if (s === stubs.projectsJsonPath) {
-            const content = stubs.getProjectsJson();
-            if (content === null)
-                throw Object.assign(new Error('ENOENT'), { code: 'ENOENT' });
-            return content;
-        }
-        return real.readFileSync(p, opts);
-    }
-    function writeFileSync(p, data) {
-        const s = String(p);
-        if (s === stubs.projectsJsonPath) {
-            stubs.setProjectsJson(typeof data === 'string' ? data : Buffer.from(data).toString('utf8'));
-        }
-    }
-    const mocked = {
-        ...real,
-        existsSync,
-        readFileSync,
-        writeFileSync,
-        mkdirSync: vi.fn(),
-        statSync: vi.fn(() => ({ isDirectory: () => true, isFile: () => false, size: 0, mtimeMs: 0 })),
-        watch: vi.fn(),
-        realpathSync: vi.fn((p) => p),
-    };
-    return { ...mocked, default: mocked };
-});
-const devkitStubs = vi.hoisted(() => ({
-    sessionClose: vi.fn(() => Promise.resolve()),
-}));
-vi.mock('@dimina-kit/devkit', () => ({
-    openProject: vi.fn(() => Promise.resolve({
-        port: 12345,
-        appInfo: { appId: 'fakeApp' },
-        close: devkitStubs.sessionClose,
-    })),
-}));
+import { stubs, devkitStubs } from './devtools-runtime-mock.harness.js';
 // ── view-manager spy shim ───────────────────────────────────────────────
 // `createDevtoolsBackend` keeps its assembled `instance` in a private
 // closure — the returned `RuntimeBackend` exposes no getter for
@@ -309,7 +39,8 @@ vi.mock('../services/views/view-manager.js', async (importOriginal) => {
         },
     };
 });
-export { stubs, devkitStubs, viewManagerStubs };
+export { stubs, devkitStubs } from './devtools-runtime-mock.harness.js';
+export { viewManagerStubs };
 export function registerBackendTestLifecycle() {
     const state = {};
     beforeEach(async () => {

package/dist/main/runtime/devtools-backend.js

@@ -1,5 +1,6 @@
 import { runDevtoolsBootstrap, createDevtoolsRuntime } from '../app/app.js';
 import { isAppQuitting, registerAppLifecycle } from '../app/lifecycle.js';
+import { closeAllCoiHosts } from '../services/workbench-coi-host.js';
 /**
  * Adapts the devtools runtime into a {@link RuntimeBackend} the framework
  * (`@dimina-kit/electron-deck`) orchestrates. The framework owns the process
@@ -61,7 +62,7 @@ export function createDevtoolsBackend(config = {}) {
             // handler closing an already-torn-down MessagePort segfaults natively.
             // Safe to run again from `onShutdown`'s `instance.dispose()` afterwards
             // — `views.disposeAll()` and its constituents are dispose-idempotent.
-            registerAppLifecycle(() => instance?.context.views.disposeAll());
+            registerAppLifecycle(() => instance?.disposeViews());
             // `onInstanceCreated` (not the return value) is what assigns `instance`:
             // `createDevtoolsRuntime` awaits the host's `config.onSetup(instance)`
             // — which may run arbitrarily long and can itself load the host toolbar
@@ -74,7 +75,7 @@ export function createDevtoolsBackend(config = {}) {
                 // this instance existed, so the hook above ran with nothing to
                 // dispose. Self-heal: run the same teardown now that there is.
                 if (isAppQuitting())
-                    instance.context.views.disposeAll();
+                    instance.disposeViews();
             }).then(() => { });
             await assembling;
         },
@@ -94,7 +95,17 @@ export function createDevtoolsBackend(config = {}) {
         // not a reason to skip disposing whatever DID get constructed.
         onShutdown: async () => {
             await assembling?.catch(() => { });
-            await instance?.dispose();
+            // The workbench COI listener is deliberately kept alive across project
+            // windows (its port IS the workbench origin, see workbench-coi-host.ts),
+            // so no window teardown ever closes it. Process shutdown is the one place
+            // that must — after the windows above have released their routes, and
+            // even if one of their disposers threw on the way.
+            try {
+                await instance?.dispose();
+            }
+            finally {
+                await closeAllCoiHosts();
+            }
         },
     };
 }

package/dist/main/runtime/devtools-runtime-mock.harness.d.ts

@@ -0,0 +1,21 @@
+declare const stubs: {
+    handlers: Map<string, (...args: unknown[]) => unknown>;
+    projectsJsonPath: string;
+    getProjectsJson(): string | null;
+    setProjectsJson(v: string | null): void;
+    projectsWithAppJson: Set<string>;
+    makeEmitter: () => {
+        listeners: Record<string, Set<(...args: unknown[]) => unknown>>;
+        on(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
+        once(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
+        off(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
+        removeListener(event: string, fn: (...args: unknown[]) => unknown): /*elided*/ any;
+        emit(event: string, ...args: unknown[]): void;
+    };
+    reset: () => void;
+};
+declare const devkitStubs: {
+    sessionClose: import("vitest").Mock<() => Promise<void>>;
+};
+export { stubs, devkitStubs };
+//# sourceMappingURL=devtools-runtime-mock.harness.d.ts.map