@dimina-kit/devtools 0.3.2-dev.20260601115343 → 0.3.2-dev.20260610114009

package/dist/main/index.js

@@ -1,3 +1,11 @@
+import { app } from 'electron';
 import { launch } from './app/launch.js';
-launch();
+// Fire-and-forget boot: launch() returns the electron-deck whenReady gate
+// promise. A bare call would let a boot failure escape as an unhandledRejection
+// (no diagnostics, can be swallowed). Surface it via a structured failure exit:
+// log the cause and exit non-zero (per workbench-model.md fire-and-forget rule).
+launch().catch((err) => {
+    console.error('[devtools] fatal: launch() failed during boot', err);
+    app.exit(1);
+});
 //# sourceMappingURL=index.js.map

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

@@ -1,4 +1,4 @@
 import type { WorkbenchContext } from '../services/workbench-context.js';
-import type { Disposable } from '../utils/disposable.js';
+import type { Disposable } from '@dimina-kit/electron-deck/main';
 export declare function registerAppIpc(ctx: Pick<WorkbenchContext, 'preloadPath' | 'brandingProvider' | 'appName' | 'headerHeight' | 'senderPolicy'>): Disposable;
 //# sourceMappingURL=app.d.ts.map

package/dist/main/ipc/bridge-router.d.ts

@@ -0,0 +1,61 @@
+import type { WebContents } from 'electron';
+import type { NativeDeviceInfo } from '../../shared/ipc-channels.js';
+import type { PageStackEntry } from '../../shared/bridge-channels.js';
+import type { WorkbenchContext } from '../services/workbench-context.js';
+import type { DebugTap } from '@dimina-kit/electron-deck/main';
+/**
+ * Accessor over the bridge-router's private `RouterState`, stashed on
+ * `ctx.bridge` so other main-process services (simulator-storage, automation,
+ * appdata) can resolve live WebContents handles without owning router state.
+ * All getters resolve fresh each call (the pre-warm pool can swap windows on
+ * respawn, so cached handles go stale).
+ */
+/**
+ * Render-side activity worth re-reading panel data on: a page's DOM mounted
+ * (`domReady`) or the visible page changed (`activePage`). Panels that pull
+ * from the active render guest (WXML/element-inspect) subscribe via
+ * `BridgeRouterHandle.onRenderEvent` so they can refresh without polling.
+ */
+export interface RenderEvent {
+    kind: 'domReady' | 'activePage';
+    appId: string;
+    bridgeId: string;
+    /** activePage only: the now-visible page's route (bare pagePath), if known.
+     * Lets the current-page panel push the route without a separate lookup. */
+    pagePath?: string;
+}
+export interface BridgeRouterHandle {
+    /** Whether native-host mode is on (main is the source of truth). */
+    isNativeHost(): boolean;
+    /** The render-host `<webview>` WebContents for a page bridgeId, or null. */
+    resolveRenderWc(bridgeId: string): WebContents | null;
+    /** The hidden service-host window WebContents for the active (or named) app. */
+    getServiceWc(appId?: string): WebContents | null;
+    /** The service-host window WebContents for the app that owns a page bridgeId,
+     * or null. Lets render-side consumers (console forwarder) target the matching
+     * app's service host even with multiple sessions open. */
+    getServiceWcForBridge(bridgeId: string): WebContents | null;
+    /** The visible page's render WebContents for the active (or named) app. */
+    getActiveRenderWc(appId?: string): WebContents | null;
+    /** The visible top-of-stack page bridgeId for the active (or named) app. */
+    getActiveBridgeId(appId?: string): string | null;
+    /** The full ordered page stack (bottom→top) reported by DeviceShell, or null
+     * before the first PAGE_STACK signal. Optional: only the native-host bridge
+     * provides it (the default path derives the stack from the simulator URL). */
+    getPageStack?(appId?: string): PageStackEntry[] | null;
+    /** Subscribe to render-side activity (domReady / active-page change). */
+    onRenderEvent(listener: (event: RenderEvent) => void): () => void;
+    /** The currently-selected device (renderer toolbar), or null pre-selection. */
+    getDevice(): NativeDeviceInfo | null;
+    /** Cache the selected device + push DEVICE_CHANGE to the live simulator WC(s). */
+    setDevice(device: NativeDeviceInfo): void;
+    /**
+     * The flag-gated debugTap (§7) over the bridge message stream. Exposed so a
+     * hidden devtools panel / automation can read `.entries()` when
+     * `DIMINA_DEBUG_TAP=1`; a no-op snapshot otherwise. Optional so the many
+     * partial `BridgeRouterHandle` test mocks don't each have to stub it.
+     */
+    debugTap?: DebugTap;
+}
+export declare function installBridgeRouter(ctx: WorkbenchContext): void;
+//# sourceMappingURL=bridge-router.d.ts.map