@dimina-kit/electron-deck 0.1.0-dev.20260610082053

package/dist/preload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/preload/index.ts"],"sourcesContent":["import { contextBridge, ipcRenderer } from 'electron'\nimport {\n\tBRIDGE_PROTOCOL_VERSION,\n\tDEFAULT_BRIDGE_GLOBAL,\n\tDEFAULT_LAYOUT_BRIDGE_GLOBAL,\n\tDeckChannel,\n} from '../shared/protocol.js'\nimport type {\n\tEventEnvelope,\n\tInvokeRequest,\n\tInvokeResponse,\n\tProbeResponse,\n\tDeckBridge,\n} from '../shared/protocol.js'\nimport type { LayoutBridge, SlotGrant } from '../client/layout-client.js'\n\nexport interface ExposeBridgeOptions {\n\t/** 暴露到 window 的全局名，默认 `__electronDeckBridge` */\n\treadonly globalName?: string\n}\n\n/**\n * 在 host preload 内调用，把 framework typed RPC + event push bridge 暴露到\n * webview window：\n *\n * ```ts\n * import { contextBridge, ipcRenderer } from 'electron'\n * import { exposeDeckBridge } from '@dimina-kit/electron-deck/preload'\n * exposeDeckBridge()\n * ```\n *\n * 见 `DeckBridge` 接口（`shared/protocol.ts`）。\n */\nexport function exposeDeckBridge(options?: ExposeBridgeOptions): void {\n\tif (typeof contextBridge?.exposeInMainWorld !== 'function' || typeof ipcRenderer?.invoke !== 'function') {\n\t\tthrow new Error('exposeDeckBridge: must be called from a preload script (electron contextBridge / ipcRenderer unavailable)')\n\t}\n\n\tconst globalName = options?.globalName ?? DEFAULT_BRIDGE_GLOBAL\n\t// 自检 globalThis —— contextBridge 内部也维护去重，但我们抢先抛更明确的诊断\n\tconst g = globalThis as unknown as Record<string, unknown>\n\tif (g[globalName] !== undefined) {\n\t\tthrow new Error(`Deck bridge already exposed at \"${globalName}\"`)\n\t}\n\n\tconst bridge: DeckBridge = {\n\t\tversion: BRIDGE_PROTOCOL_VERSION,\n\t\tprobe(): Promise<ProbeResponse> {\n\t\t\treturn ipcRenderer.invoke(DeckChannel.Probe) as Promise<ProbeResponse>\n\t\t},\n\t\tinvoke(req: InvokeRequest): Promise<InvokeResponse> {\n\t\t\treturn ipcRenderer.invoke(DeckChannel.Invoke, req) as Promise<InvokeResponse>\n\t\t},\n\t\tonEvent(listener: (env: EventEnvelope) => void): () => void {\n\t\t\tconst wrapped = (_event: unknown, env: EventEnvelope): void => {\n\t\t\t\tlistener(env)\n\t\t\t}\n\t\t\tipcRenderer.on(DeckChannel.Event, wrapped)\n\t\t\treturn () => {\n\t\t\t\tipcRenderer.removeListener(DeckChannel.Event, wrapped)\n\t\t\t}\n\t\t},\n\t}\n\n\tcontextBridge.exposeInMainWorld(globalName, bridge)\n}\n\nexport interface ExposeLayoutBridgeOptions {\n\t/** 暴露到 window 的全局名，默认 `__electronDeckLayoutBridge` */\n\treadonly globalName?: string\n}\n\n/**\n * 在 host preload 内调用，把三条 slot-token LAYOUT channel（`slot-grant` PUSH /\n * `place` send / `layout-subscribe` invoke）封装成一个 `LayoutBridge`-shaped\n * 对象暴露到 webview window，供 renderer：\n *\n * ```ts\n * import { exposeDeckLayoutBridge } from '@dimina-kit/electron-deck/preload'\n * exposeDeckLayoutBridge()\n * // renderer:\n * createDeckLayoutClient({ bridge: window.__electronDeckLayoutBridge })\n * ```\n *\n * channel 名一律取自框架 `DeckChannel`（不手抄字符串）。`onSlotGrant` 返回一个\n * 纯 unsubscribe 函数（可跨 contextBridge），不是 Disposable 对象。\n */\nexport function exposeDeckLayoutBridge(options?: ExposeLayoutBridgeOptions): void {\n\tif (typeof contextBridge?.exposeInMainWorld !== 'function' || typeof ipcRenderer?.on !== 'function') {\n\t\tthrow new Error('exposeDeckLayoutBridge: must be called from a preload script (electron contextBridge / ipcRenderer unavailable)')\n\t}\n\n\tconst globalName = options?.globalName ?? DEFAULT_LAYOUT_BRIDGE_GLOBAL\n\tconst g = globalThis as unknown as Record<string, unknown>\n\tif (g[globalName] !== undefined) {\n\t\tthrow new Error(`Deck layout bridge already exposed at \"${globalName}\"`)\n\t}\n\n\tconst bridge: LayoutBridge = {\n\t\tonSlotGrant(cb: (grant: SlotGrant) => void): () => void {\n\t\t\tconst listener = (_event: unknown, grant: SlotGrant): void => {\n\t\t\t\tcb(grant)\n\t\t\t}\n\t\t\tipcRenderer.on(DeckChannel.SlotGrant, listener)\n\t\t\treturn () => {\n\t\t\t\tipcRenderer.removeListener(DeckChannel.SlotGrant, listener)\n\t\t\t}\n\t\t},\n\t\tsendPlace(msg): void {\n\t\t\tvoid ipcRenderer.invoke(DeckChannel.Place, msg).catch(() => {})\n\t\t},\n\t\tsubscribe(): void {\n\t\t\tvoid ipcRenderer.invoke(DeckChannel.LayoutSubscribe).catch(() => {})\n\t\t},\n\t}\n\n\tcontextBridge.exposeInMainWorld(globalName, bridge)\n}\n\nexport type {\n\tEventEnvelope,\n\tInvokeRequest,\n\tInvokeResponse,\n\tProbeResponse,\n\tDeckBridge,\n\tLayoutBridge,\n\tSlotGrant,\n}\nexport { BRIDGE_PROTOCOL_VERSION, DEFAULT_BRIDGE_GLOBAL, DEFAULT_LAYOUT_BRIDGE_GLOBAL, DeckChannel }\n"],"mappings":";;;;;;;;;;;;;;;AAiCA,SAAgB,iBAAiB,SAAqC;CACrE,IAAI,OAAO,eAAe,sBAAsB,cAAc,OAAO,aAAa,WAAW,YAC5F,MAAM,IAAI,MAAM,2GAA2G;CAG5H,MAAM,aAAa,SAAS,cAAA;CAG5B,IAAI,WAAE,gBAAgB,KAAA,GACrB,MAAM,IAAI,MAAM,mCAAmC,WAAW,EAAE;CAGjE,MAAM,SAAqB;EAC1B,SAAS;EACT,QAAgC;GAC/B,OAAO,YAAY,OAAO,YAAY,KAAK;EAC5C;EACA,OAAO,KAA6C;GACnD,OAAO,YAAY,OAAO,YAAY,QAAQ,GAAG;EAClD;EACA,QAAQ,UAAoD;GAC3D,MAAM,WAAW,QAAiB,QAA6B;IAC9D,SAAS,GAAG;GACb;GACA,YAAY,GAAG,YAAY,OAAO,OAAO;GACzC,aAAa;IACZ,YAAY,eAAe,YAAY,OAAO,OAAO;GACtD;EACD;CACD;CAEA,cAAc,kBAAkB,YAAY,MAAM;AACnD;;;;;;;;;;;;;;;;AAsBA,SAAgB,uBAAuB,SAA2C;CACjF,IAAI,OAAO,eAAe,sBAAsB,cAAc,OAAO,aAAa,OAAO,YACxF,MAAM,IAAI,MAAM,iHAAiH;CAGlI,MAAM,aAAa,SAAS,cAAA;CAE5B,IAAI,WAAE,gBAAgB,KAAA,GACrB,MAAM,IAAI,MAAM,0CAA0C,WAAW,EAAE;CAqBxE,cAAc,kBAAkB,YAAY;EAjB3C,YAAY,IAA4C;GACvD,MAAM,YAAY,QAAiB,UAA2B;IAC7D,GAAG,KAAK;GACT;GACA,YAAY,GAAG,YAAY,WAAW,QAAQ;GAC9C,aAAa;IACZ,YAAY,eAAe,YAAY,WAAW,QAAQ;GAC3D;EACD;EACA,UAAU,KAAW;GACpB,YAAiB,OAAO,YAAY,OAAO,GAAG,EAAE,YAAY,CAAC,CAAC;EAC/D;EACA,YAAkB;GACjB,YAAiB,OAAO,YAAY,eAAe,EAAE,YAAY,CAAC,CAAC;EACpE;CAG2C,CAAM;AACnD"}

package/dist/protocol-BJqo-vP2.js

@@ -0,0 +1,23 @@
+//#region src/shared/protocol.ts
+/** Bridge global 默认挂的全局名（contextBridge.exposeInMainWorld） */
+var DEFAULT_BRIDGE_GLOBAL = "__electronDeckBridge";
+/**
+* Slot-token LAYOUT bridge 默认挂的全局名。`exposeDeckLayoutBridge()` 默认暴露到
+* 此名，renderer 的 `createDeckLayoutClient({ bridge: window.__electronDeckLayoutBridge })`
+* 读取同名。单一来源避免 preload helper 与 client 之间字符串漂移。
+*/
+var DEFAULT_LAYOUT_BRIDGE_GLOBAL = "__electronDeckLayoutBridge";
+/** Bridge protocol semver；client 在 ready() 时校验 major 一致 */
+var BRIDGE_PROTOCOL_VERSION = "1.0.0";
+var DeckChannel = {
+	Invoke: "__electron-deck:invoke",
+	Event: "__electron-deck:event",
+	Probe: "__electron-deck:probe",
+	Place: "__electron-deck:place",
+	SlotGrant: "__electron-deck:slot-grant",
+	LayoutSubscribe: "__electron-deck:layout-subscribe"
+};
+//#endregion
+export { DeckChannel as i, DEFAULT_BRIDGE_GLOBAL as n, DEFAULT_LAYOUT_BRIDGE_GLOBAL as r, BRIDGE_PROTOCOL_VERSION as t };
+
+//# sourceMappingURL=protocol-BJqo-vP2.js.map

package/dist/protocol-BJqo-vP2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-BJqo-vP2.js","names":[],"sources":["../src/shared/protocol.ts"],"sourcesContent":["/**\n * Deck framework wire protocol —— main ↔ webview 之间的 channel 名 + 帧\n * 形态。SoT 在此，preload / client / main runtime 都从这里 import。\n *\n * 设计：把 declared `hostServices` / `simulatorApis` / `events` 三类全部走\n * **两个** 统一 channel，避免 channel name 爆炸 / 难以加 senderPolicy 白名单。\n * - `__electron-deck:invoke`  — webview → main RPC (ipcRenderer.invoke)\n * - `__electron-deck:event`   — main → webview event push (webContents.send)\n * - `__electron-deck:probe`   — webview → main 探活，bridge ready 检查\n *\n * 帧用 JSON 对象一层 envelope，便于扩展 + 校验。\n *\n * @internal\n */\n\nimport type { JsonValue } from '../types.js'\n\n/** Bridge global 默认挂的全局名（contextBridge.exposeInMainWorld） */\nexport const DEFAULT_BRIDGE_GLOBAL = '__electronDeckBridge'\n\n/**\n * Slot-token LAYOUT bridge 默认挂的全局名。`exposeDeckLayoutBridge()` 默认暴露到\n * 此名，renderer 的 `createDeckLayoutClient({ bridge: window.__electronDeckLayoutBridge })`\n * 读取同名。单一来源避免 preload helper 与 client 之间字符串漂移。\n */\nexport const DEFAULT_LAYOUT_BRIDGE_GLOBAL = '__electronDeckLayoutBridge'\n\n/** Bridge protocol semver；client 在 ready() 时校验 major 一致 */\nexport const BRIDGE_PROTOCOL_VERSION = '1.0.0'\n\nexport const DeckChannel = {\n\tInvoke: '__electron-deck:invoke',\n\tEvent: '__electron-deck:event',\n\tProbe: '__electron-deck:probe',\n\tPlace: '__electron-deck:place',\n\tSlotGrant: '__electron-deck:slot-grant',\n\tLayoutSubscribe: '__electron-deck:layout-subscribe',\n} as const\n\nexport type InvokeKind = 'host' | 'simulator'\n\nexport interface InvokeRequest {\n\treadonly kind: InvokeKind\n\treadonly name: string\n\treadonly args: readonly JsonValue[]\n}\n\nexport interface InvokeSuccess<R extends JsonValue = JsonValue> {\n\treadonly ok: true\n\treadonly result: R\n}\n\nexport interface InvokeFailure {\n\treadonly ok: false\n\treadonly error: {\n\t\treadonly remoteName: string\n\t\treadonly message: string\n\t\treadonly code?: string\n\t}\n}\n\nexport type InvokeResponse<R extends JsonValue = JsonValue> =\n\t| InvokeSuccess<R>\n\t| InvokeFailure\n\nexport interface EventEnvelope<P extends JsonValue = JsonValue> {\n\treadonly name: string\n\treadonly payload: P\n}\n\nexport interface ProbeResponse {\n\treadonly ready: true\n\treadonly version: typeof BRIDGE_PROTOCOL_VERSION\n}\n\n/**\n * Bridge global 暴露到 webview window 的 shape。preload 把它通过\n * `contextBridge.exposeInMainWorld(globalName, bridge)` 注入；webview-side\n * `createDeckClient()` 通过 `globalThis[globalName]` 读取。\n *\n * 注意所有方法必须是 contextBridge-friendly（plain values + serializable\n * arguments），不要把 Map / Set / Date / Promise.race 等 leak 进 bridge 接口。\n */\nexport interface DeckBridge {\n\treadonly version: typeof BRIDGE_PROTOCOL_VERSION\n\tprobe(): Promise<ProbeResponse>\n\tinvoke(req: InvokeRequest): Promise<InvokeResponse>\n\t/** 订阅 event channel；返回 unsubscribe 函数（不是 Disposable，因为要跨 contextBridge） */\n\tonEvent(listener: (env: EventEnvelope) => void): () => void\n}\n"],"mappings":";;AAkBA,IAAa,wBAAwB;;;;;;AAOrC,IAAa,+BAA+B;;AAG5C,IAAa,0BAA0B;AAEvC,IAAa,cAAc;CAC1B,QAAQ;CACR,OAAO;CACP,OAAO;CACP,OAAO;CACP,WAAW;CACX,iBAAiB;AAClB"}

package/dist/shared/protocol.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Deck framework wire protocol —— main ↔ webview 之间的 channel 名 + 帧
+ * 形态。SoT 在此，preload / client / main runtime 都从这里 import。
+ *
+ * 设计：把 declared `hostServices` / `simulatorApis` / `events` 三类全部走
+ * **两个** 统一 channel，避免 channel name 爆炸 / 难以加 senderPolicy 白名单。
+ * - `__electron-deck:invoke`  — webview → main RPC (ipcRenderer.invoke)
+ * - `__electron-deck:event`   — main → webview event push (webContents.send)
+ * - `__electron-deck:probe`   — webview → main 探活，bridge ready 检查
+ *
+ * 帧用 JSON 对象一层 envelope，便于扩展 + 校验。
+ *
+ * @internal
+ */
+import type { JsonValue } from '../types.js';
+/** Bridge global 默认挂的全局名（contextBridge.exposeInMainWorld） */
+export declare const DEFAULT_BRIDGE_GLOBAL = "__electronDeckBridge";
+/**
+ * Slot-token LAYOUT bridge 默认挂的全局名。`exposeDeckLayoutBridge()` 默认暴露到
+ * 此名，renderer 的 `createDeckLayoutClient({ bridge: window.__electronDeckLayoutBridge })`
+ * 读取同名。单一来源避免 preload helper 与 client 之间字符串漂移。
+ */
+export declare const DEFAULT_LAYOUT_BRIDGE_GLOBAL = "__electronDeckLayoutBridge";
+/** Bridge protocol semver；client 在 ready() 时校验 major 一致 */
+export declare const BRIDGE_PROTOCOL_VERSION = "1.0.0";
+export declare const DeckChannel: {
+    readonly Invoke: "__electron-deck:invoke";
+    readonly Event: "__electron-deck:event";
+    readonly Probe: "__electron-deck:probe";
+    readonly Place: "__electron-deck:place";
+    readonly SlotGrant: "__electron-deck:slot-grant";
+    readonly LayoutSubscribe: "__electron-deck:layout-subscribe";
+};
+export type InvokeKind = 'host' | 'simulator';
+export interface InvokeRequest {
+    readonly kind: InvokeKind;
+    readonly name: string;
+    readonly args: readonly JsonValue[];
+}
+export interface InvokeSuccess<R extends JsonValue = JsonValue> {
+    readonly ok: true;
+    readonly result: R;
+}
+export interface InvokeFailure {
+    readonly ok: false;
+    readonly error: {
+        readonly remoteName: string;
+        readonly message: string;
+        readonly code?: string;
+    };
+}
+export type InvokeResponse<R extends JsonValue = JsonValue> = InvokeSuccess<R> | InvokeFailure;
+export interface EventEnvelope<P extends JsonValue = JsonValue> {
+    readonly name: string;
+    readonly payload: P;
+}
+export interface ProbeResponse {
+    readonly ready: true;
+    readonly version: typeof BRIDGE_PROTOCOL_VERSION;
+}
+/**
+ * Bridge global 暴露到 webview window 的 shape。preload 把它通过
+ * `contextBridge.exposeInMainWorld(globalName, bridge)` 注入；webview-side
+ * `createDeckClient()` 通过 `globalThis[globalName]` 读取。
+ *
+ * 注意所有方法必须是 contextBridge-friendly（plain values + serializable
+ * arguments），不要把 Map / Set / Date / Promise.race 等 leak 进 bridge 接口。
+ */
+export interface DeckBridge {
+    readonly version: typeof BRIDGE_PROTOCOL_VERSION;
+    probe(): Promise<ProbeResponse>;
+    invoke(req: InvokeRequest): Promise<InvokeResponse>;
+    /** 订阅 event channel；返回 unsubscribe 函数（不是 Disposable，因为要跨 contextBridge） */
+    onEvent(listener: (env: EventEnvelope) => void): () => void;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/shared/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/shared/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,yBAAyB,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,+BAA+B,CAAA;AAExE,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,UAAU,CAAA;AAE9C,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAA;AAE7C,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC7D,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACD;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IACvD,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAA;AAEhB,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,uBAAuB,CAAA;CAChD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,uBAAuB,CAAA;IAChD,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACnD,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC3D"}

package/dist/types.d.ts

@@ -0,0 +1,504 @@
+import type { BrowserWindow, NativeImage, WebContents, WebContentsView, ipcMain } from 'electron';
+import type { MinimalApp, MinimalElectron } from './internal/electron-types.js';
+import type { MinimalIpcMain, MinimalWebContents } from './internal/wire-transport.js';
+export type MaybePromise<T> = T | Promise<T>;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | {
+    readonly [k: string]: JsonValue;
+} | readonly JsonValue[];
+export interface Disposable {
+    dispose(): void | Promise<void>;
+}
+/** Opaque session handle minted by `runtime.scopes.create()` (app-root) or
+ *  `DeckWindow.newSession()` (window-rooted). Wraps a child Scope, so disposing
+ *  it (or app shutdown / window close) tears down every view bound to it. Does
+ *  NOT expose the internal Scope (no adopt/child escape). */
+export interface DeckSession {
+    /** Release THIS session's views (and any other owned resources of its current
+     *  segment), keeping the session AND its window alive — a fresh segment opens. */
+    reset(): Promise<void>;
+    /** Terminal: dispose every view bound to the session and close it. */
+    dispose(): Promise<void>;
+}
+/** A per-window close decision. `'keep'` vetoes the close; `'close'` proceeds. */
+export type WindowCloseDecision = 'keep' | 'close';
+/** A cancelable per-window close decider registered via {@link DeckWindow.onClose}. */
+export type WindowCloseDecider = () => MaybePromise<WindowCloseDecision>;
+/**
+ * Opaque handle over a framework-registered window (`runtime.windows.create()`
+ * / `runtime.windows.main`). Exposes the BrowserWindow + its control wc, a
+ * window-rooted session factory, and a per-window cancelable close decider.
+ *
+ * **Never exposes** the raw windowScope / substrate / trust lease.
+ */
+export interface DeckWindow {
+    /** The BrowserWindow this handle wraps. */
+    readonly window: BrowserWindow;
+    /** The window's primary control WebContents (=== `window.webContents`),
+     *  captured once at registration. */
+    readonly controlWc: WebContents;
+    /** Mint a window-rooted {@link DeckSession} (a child of this window's lifetime).
+     *  `runtime.view({ scope })` accepts it under the same provenance check as an
+     *  app-root session; closing the window cascades every session minted here. */
+    newSession(): DeckSession;
+    /** Register a per-window cancelable close decider. On a close attempt the
+     *  framework `preventDefault()`s, runs the registered deciders in registration
+     *  order; any `'keep'` vetoes, else the window is destroyed. On the MAIN window
+     *  a live decider supersedes {@link RuntimeBackend.onMainWindowClose}. */
+    onClose(decider: WindowCloseDecider): Disposable;
+}
+/**
+ * `defineEvent(name)` 创建的 HostEvent。pure factory，无 side effect —— 必须在
+ * `DeckConfig.events` 中显式列出 framework 才会绑 transport。
+ */
+export interface HostEvent<P extends JsonValue> {
+    readonly name: string;
+    publish(payload: P): void;
+    on(listener: (payload: P) => void): Disposable;
+}
+/**
+ * Handler 形参故意宽松（`any[]`）—— host 写 `(p: { code: string }) => ...` 这种
+ * narrower 签名必须能赋值给 `Record<string, Handler>`。framework 在 IPC 边界
+ * 做 JSON 校验，narrower 类型在 webview-side `createDeckClient<HS, EV>()`
+ * 通过 `Parameters<HS[K]>` 推断。返回值 framework 不约束 TS 类型，但 runtime
+ * 强制要求 JSON-safe（非 JSON 值反序列化时报错）。
+ */
+export type SimulatorApiHandler = (...args: any[]) => unknown;
+export type HostServiceHandler = (...args: any[]) => unknown;
+export interface AppConfig {
+    readonly name?: string;
+    readonly icon?: string;
+    /**
+     * Optional content source for the framework-built main window. When set AND
+     * the framework owns the main window (NOT an `ownsWindows:true` backend), the
+     * framework auto-loads it after the window is built, via the same safeLoad path
+     * the toolbar / declared windows use. Omitted → the host owns the load. Ignored
+     * under an `ownsWindows:true` backend (the backend builds + loads its own window).
+     */
+    readonly source?: WebviewSource;
+    /**
+     * Opt-in process-lifecycle: bind `window-all-closed`. Omitted → the framework
+     * does NOT touch `window-all-closed` (Electron's default, or the consumer's own
+     * handler, applies). `true` → quit when all windows close; `false` → bind but
+     * suppress the default quit.
+     */
+    readonly quitOnAllWindowsClosed?: boolean;
+    /**
+     * Opt-in single-instance lock. When true, `start()` acquires the OS
+     * single-instance lock before `whenReady`; a second instance quits immediately.
+     * `second-instance` is forwarded to {@link RuntimeBackend.onSecondInstance}.
+     */
+    readonly singleInstance?: boolean;
+    readonly window?: {
+        readonly width?: number;
+        readonly height?: number;
+        readonly minWidth?: number;
+        readonly minHeight?: number;
+        readonly show?: boolean;
+        readonly backgroundColor?: string;
+        readonly webPreferences?: Record<string, unknown>;
+    };
+}
+export type WebviewSource = {
+    readonly url: string;
+} | {
+    readonly file: string;
+};
+export interface ToolbarContribution {
+    readonly source: WebviewSource;
+    /** 必填：host 完全控制 preload */
+    readonly preloadPath: string;
+    /** 必填：固定高度（px）；宽度自动跟随主窗口 */
+    readonly height: number;
+}
+export interface WindowContribution {
+    readonly title?: string;
+    readonly source: WebviewSource;
+    readonly preloadPath?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly modal?: boolean;
+}
+export interface MenuContribution {
+    build(ctx: MenuBuildContext): void;
+}
+export interface MenuBuildContext {
+    readonly mainWindow: BrowserWindow;
+    readonly appName: string;
+    readonly theme: 'light' | 'dark';
+}
+export interface LifecycleContribution {
+    /**
+     * 在主窗口关闭 / app 退出之前调用，await 完成；超时则 log error 后继续 shutdown 流程（不阻止关闭）。
+     * host 如需更细粒度（区分 close 与 quit），用 `setup(runtime)` 内
+     * `runtime.electron.app.on('before-quit', ...)` escape。
+     */
+    readonly beforeClose?: () => MaybePromise<void>;
+    /** beforeClose 超时（ms），默认 10_000 */
+    readonly timeoutMs?: number;
+}
+/**
+ * 顶层 `electronDeck(config, options?)` 的第二参数。
+ *
+ * **生产路径**：缺省即可——framework lazy `await import('electron')` 取真
+ * `ipcMain` / `BrowserWindow` / `WebContentsView`。host 在 Electron main 进程
+ * 入口直接 `electronDeck(config)`，不需要手动注入。
+ *
+ * **测试 / 非 Electron 环境**：完全显式注入 `{ electron, ipcMain }` 即可绕过
+ * lazy import（vitest 跑 `await import('electron')` 会解析到 Electron 安装包
+ * 的 entry stub —— 它导出可执行路径字符串而非 main-process module，所以
+ * `ipcMain` / `BrowserWindow` 都是 undefined。framework 用 lazy import 时若
+ * 取不到 `ipcMain` 会抛清晰错误，提示注入。
+ *
+ * `trustedWebContents` / `senderPolicy` 是可选 override —— 缺省 framework 用
+ * 内部维护的 trusted set + 默认 isTrusted 策略。
+ *
+ * 注意：`backend` 不在这里——它是「这个 deck 跑什么领域装配」的配置，属于
+ * {@link DeckConfig}，不是测试注入旋钮。
+ */
+export interface DeckOptions {
+    /** 注入自定义 Electron（测试 fake 或 production override）。缺省时 framework lazy import 真 electron。 */
+    readonly electron?: MinimalElectron;
+    /** 注入 ipcMain；缺省时 framework 用 lazy-imported electron.ipcMain。 */
+    readonly ipcMain?: MinimalIpcMain;
+    /** 自定义 trustedWebContents 回调；默认走 framework 内部维护 set。 */
+    readonly trustedWebContents?: () => readonly MinimalWebContents[];
+    /** 自定义 senderPolicy；默认按 trusted 集判断。 */
+    readonly senderPolicy?: SenderPolicy;
+}
+export interface DeckConfig {
+    readonly app?: AppConfig;
+    /**
+     * 领域 backend。提供后 framework 跑 `beforeReady`(pre-ready) + `assemble`
+     * (setup)，并把 main-window 装配让给 backend（framework 不建自己的窗口）。
+     * backend host 的主入口字段：`electronDeck({ backend })`——无需空 `{}` + options。
+     */
+    readonly backend?: RuntimeBackend;
+    /** 暴露给小程序，自动投影为 `wx.<name>` */
+    readonly simulatorApis?: Record<string, SimulatorApiHandler>;
+    /** 暴露给 trusted webview（toolbar 等）的 RPC */
+    readonly hostServices?: Record<string, HostServiceHandler>;
+    /** main → webview 推送；必须显式列出，避免 module load order 隐式注册 */
+    readonly events?: readonly HostEvent<JsonValue>[];
+    readonly toolbar?: ToolbarContribution;
+    readonly windows?: Record<string, WindowContribution>;
+    readonly menu?: MenuContribution;
+    readonly lifecycle?: LifecycleContribution;
+    /** Imperative escape：声明表达不了的运行时操作 */
+    readonly setup?: (runtime: Runtime) => MaybePromise<void>;
+}
+export interface TypedIpcRegistry {
+    handle<A extends JsonValue[], R extends JsonValue>(channel: string, handler: (...args: A) => MaybePromise<R>, options?: {
+        validator?: (args: unknown[]) => A;
+    }): Disposable;
+    on<P extends JsonValue>(channel: string, listener: (payload: P) => void): Disposable;
+    send(target: 'mainWindow' | BrowserWindow, channel: string, payload: JsonValue): void;
+}
+export interface SettingsSnapshot {
+    readonly theme: 'light' | 'dark';
+    readonly [k: string]: JsonValue;
+}
+export interface SenderPolicy {
+    /** trusted webContentsId set，框架内部维护；@internal */
+    isTrusted(senderId: number): boolean;
+}
+export interface ResourceRegistry {
+    /** @internal LIFO dispose */
+    add(d: Disposable | (() => MaybePromise<void>)): Disposable;
+    disposeAll(): Promise<void>;
+}
+export interface DeckContext {
+    readonly settings: SettingsSnapshot;
+    readonly theme: 'light' | 'dark';
+    /** @internal unsupported escape；破坏 I1/I2/I3 服务承诺 */
+    readonly _registry: ResourceRegistry;
+    /** @internal unsupported escape */
+    readonly _senderPolicy: SenderPolicy;
+}
+export interface FrameworkEvents {
+    'window-created': {
+        window: BrowserWindow;
+        role: 'main' | 'toolbar' | 'host';
+    };
+    'window-closed': {
+        window: BrowserWindow;
+    };
+    /** webContents.loadURL/loadFile 失败时 emit。framework 不 reject start()，host 可订阅做兜底/重试 */
+    'load-failed': {
+        source: WebviewSource;
+        error: unknown;
+    };
+}
+export interface WindowCreateOptions {
+    readonly source: WebviewSource;
+    readonly preloadPath?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly modal?: boolean;
+    readonly parent?: BrowserWindow;
+    /** 默认 true */
+    readonly autoTrust?: boolean;
+}
+/** A screen-space rectangle (CSS px), mirroring the `view-handle` `Bounds`. */
+export interface ViewBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Explicit visibility + geometry for a host-managed native view. Structurally
+ * identical to the internal `view-handle` `Placement`; re-declared here so the
+ * public `Runtime` surface adds no internal-module dependency.
+ */
+export type ViewPlacement = {
+    readonly visible: true;
+    readonly bounds: ViewBounds;
+} | {
+    readonly visible: false;
+};
+/** Options for {@link Runtime.view}. */
+export interface ViewCreateOptions {
+    readonly source: WebviewSource;
+    /** The view's home lifetime — a {@link DeckSession} from
+     *  `runtime.scopes.create()`. Disposing the session detaches + unregisters the
+     *  view (display teardown) and closes its native WebContents; because the
+     *  session is a child of the app root, app shutdown also cascades into it.
+     *  Omitting it binds the view to the app root (no per-session teardown; the
+     *  view's display still tears down with its placeIn window, and shutdown closes
+     *  it). A raw/foreign Scope is REJECTED — only a session minted by
+     *  `runtime.scopes.create()` is accepted (provenance check). */
+    readonly scope?: DeckSession;
+    /**
+     * Opt-in keep-alive eviction policy (B3.2). When set, the framework disposes
+     * the least-recently-VISIBLE HIDDEN view in this view's group once the group's
+     * HIDDEN count exceeds `max` — destroying that view's native WebContents.
+     * Currently-visible views are NEVER evicted. Views sharing the same `max` form
+     * one group. Omitting `keepAlive` → the framework evicts nothing (pure host
+     * management; the host decides what to keep).
+     */
+    readonly keepAlive?: {
+        readonly policy: 'lru';
+        readonly max: number;
+    };
+}
+/**
+ * A host-API handle over ONE native view (`runtime.view(...)`). Chainable:
+ * `placeIn` and `applyPlacement` both return the handle so calls compose.
+ * `dispose` detaches the view and makes the placement sink inert.
+ */
+export interface DeckViewHandle {
+    /** Mount the native view into `window`'s content view at the given zone.
+     *  `anchor` is accepted + stored for the future slot-token step (unused in
+     *  slice 1). Chainable. */
+    placeIn(window: BrowserWindow, opts: {
+        zone?: number;
+        anchor?: string;
+    }): DeckViewHandle;
+    /** Drive the native view's visibility + bounds. `visible:true` (re)mounts and
+     *  sets bounds directly; `visible:false` detaches but keeps the view alive.
+     *  A frame after `dispose` is dropped. Chainable. */
+    applyPlacement(placement: ViewPlacement): DeckViewHandle;
+    /** Migrate the placed view to another window (the ONLY re-placement path —
+     *  placeIn twice throws). Moves the per-window substrate registration + re-issues
+     *  the slot-token anchor for the dest; atomic (rolls back to the source on dest
+     *  failure). `rehome:true` re-parents the view's lifetime to the dest window. */
+    moveTo(win: BrowserWindow, opts: {
+        zone?: number;
+        anchor?: string;
+        rehome?: boolean;
+    }): Promise<void>;
+    /** Tear down this placement (detach the native view, disable the sink). */
+    dispose(): Promise<void>;
+    /** The native view's `WebContents`. Available immediately — the handle owns
+     *  its view before any `placeIn`, so a caller can recover the WebContents (and
+     *  its bounds/screenshot below) without diffing `mainWindow.contentView.children`. */
+    readonly webContents: WebContents;
+    /** The view's LIVE screen-space rect when it is currently placed AND visible;
+     *  `null` before any placement, after `applyPlacement({visible:false})`, and
+     *  after `dispose()`. */
+    bounds(): ViewBounds | null;
+    /** Capture the native view as a `NativeImage` (pass-through to the view's
+     *  `webContents.capturePage()`). */
+    capturePage(): Promise<NativeImage>;
+}
+export interface Runtime {
+    readonly electron: typeof import('electron');
+    readonly mainWindow: BrowserWindow;
+    readonly toolbarView: WebContentsView | null;
+    readonly ipc: TypedIpcRegistry;
+    readonly rawIpcMain: typeof ipcMain;
+    readonly call: {
+        simulator(name: string, ...args: JsonValue[]): Promise<JsonValue>;
+        host(name: string, ...args: JsonValue[]): Promise<JsonValue>;
+    };
+    readonly windows: {
+        create(opts: WindowCreateOptions): DeckWindow;
+        get(id: string): BrowserWindow | undefined;
+        all(): BrowserWindow[];
+        /** The framework-built main window's {@link DeckWindow}, or `null` when the
+         *  framework does not own a main window (e.g. an `ownsWindows:true` backend). */
+        readonly main: DeckWindow | null;
+        trust(win: BrowserWindow): Disposable;
+        /**
+         * Register an EXTERNALLY-created window (one the host built itself, e.g.
+         * under a `ownsWindows:true` backend) into the framework: its windowScope,
+         * per-window native-view substrate, and TRUST lifecycle — so
+         * `runtime.view().placeIn(win)` works for it. Trust + slot-tokens + grants
+         * for the window's webContents are revoked SYNCHRONOUSLY and FIRST on the
+         * window's `'closed'` (the framework arms its revoke via `prependListener`,
+         * so it runs before any external `'closed'` listener the host registered
+         * earlier — a host listener must never observe a still-trusted wc whose id
+         * Electron may immediately reuse).
+         *
+         * Idempotent by webContents identity: adopting the same window twice returns
+         * the existing registration (no second substrate, no double trust lease).
+         * Throws if the window (or its webContents) is already destroyed — a dead
+         * wc.id could be reused, so admitting one would be a privilege-escalation
+         * hazard.
+         *
+         * `ownership`:
+         *  - `'transfer'` → the framework owns the window's lifetime and destroys it
+         *    at app shutdown (as it does for its own windows).
+         *  - `'observe'` (default) → the HOST owns the window's lifetime; the
+         *    framework NEVER calls `destroy()` on it, but still tears down the
+         *    substrate + trust when the registration is disposed or the app shuts down.
+         *
+         * The returned {@link Disposable} un-adopts the window early (tears down its
+         * substrate + trust); it is idempotent.
+         */
+        adopt(win: BrowserWindow, opts?: {
+            ownership?: 'transfer' | 'observe';
+        }): Disposable;
+    };
+    /** Create a host-managed native view and return a chainable handle. Throws
+     *  if the build has no Electron (mirrors `windows.create`). */
+    view(opts: ViewCreateOptions): DeckViewHandle;
+    /** Session factory. `create()` mints an opaque {@link DeckSession} (internally
+     *  a child of the app root) — the ONLY legitimate source of a `scope` for
+     *  `runtime.view`. Disposing the session tears down every view bound to it;
+     *  app shutdown also cascades into it. */
+    readonly scopes: {
+        create(): DeckSession;
+    };
+    readonly grants: {
+        /** Authorize `controlWc` to invoke the given privileged commands. The grant
+         *  is revoked automatically when the control wc's lifetime Scope resets
+         *  (navigation) or closes (destroy) — wc.id-reuse safe. Throws if `controlWc`
+         *  is not trusted.
+         *
+         *  `targetScope` is OPTIONAL and reserved: when supplied it is stored as the
+         *  authorization boundary for FUTURE per-target view-command checks; the
+         *  current grant gate authorizes by (senderId, command-name) only — no command
+         *  resolves a target view yet, so targetScope is not consulted at dispatch. */
+        issue(controlWc: WebContents, opts: {
+            commands: readonly string[];
+            targetScope?: DeckSession;
+        }): Disposable;
+    };
+    readonly layout: {
+        /** Register a PRIVILEGED command (must be a `layout.*` name) handled through
+         *  the capability-gated ControlBus. A caller can only invoke it if a live
+         *  grant covers (senderId, name); otherwise DECK_FORBIDDEN. Ordinary domain
+         *  APIs go in `hostServices` (un-gated) — never register privileged names there. */
+        command(name: string, handler: (...args: JsonValue[]) => JsonValue | Promise<JsonValue>): Disposable;
+    };
+    readonly context: DeckContext;
+    on<E extends keyof FrameworkEvents>(event: E, listener: (payload: FrameworkEvents[E]) => void): Disposable;
+    add(d: Disposable | (() => MaybePromise<void>)): Disposable;
+}
+/**
+ * Frame-aware sender identity for trust checks. `frame` is null when the
+ * platform cannot resolve a sender frame (e.g. some sync paths / destroyed
+ * frames) — callers decide fail-closed vs sender-level fallback per channel.
+ */
+export interface TrustedSenderRef {
+    readonly webContentsId: number;
+    readonly frame: {
+        readonly url: string;
+        readonly isMainFrame: boolean;
+        readonly processId: number;
+        readonly routingId: number;
+    } | null;
+}
+/**
+ * Domain backend injected into the framework. The framework owns process
+ * lifecycle / windows / wire / trust primitives; the backend supplies the
+ * domain assembly (real context, mainWindow content, projects/simulator/views,
+ * IPC modules) the framework is deliberately ignorant of. All hooks except
+ * `assemble` are optional; absent hooks fall back to framework defaults.
+ *
+ * @internal exported via `/host` for backend implementers.
+ */
+export interface RuntimeBackend {
+    /**
+     * When true, the backend builds the main window itself (in `assemble`) and
+     * the framework skips its own window/toolbar/declared-window assembly — used
+     * by hosts whose window needs construction-time options the generic factory
+     * can't express (e.g. a per-session preload partition). Default false: the
+     * framework owns the window and the backend only reacts (onMainWindowClose).
+     */
+    readonly ownsWindows?: boolean;
+    /**
+     * Pre-ready side effects (scheme/protocol registration, command-line
+     * switches, app name). Runs after electron is resolved but BEFORE
+     * `app.whenReady()`; receives the framework's resolved {@link MinimalApp}.
+     * Throwing aborts start() via cleanupOnError.
+     */
+    beforeReady?(app: MinimalApp): MaybePromise<void>;
+    /**
+     * Domain assembly. Runs in setup phase, after the runtime skeleton is built
+     * and the wire transport is live. Loads the main renderer, registers domain
+     * IPC modules, stands up simulator/CDP/views, etc.
+     */
+    assemble(runtime: Runtime): MaybePromise<void>;
+    /**
+     * Construction-time `webPreferences` for the framework-built main window.
+     * Called once, synchronously, BEFORE `new BrowserWindow(...)` in the
+     * `ownsWindows` falsy path. The returned prefs are merged into the window's
+     * `webPreferences` and take precedence over `config.app.window.webPreferences`
+     * on key collision. Only consulted when the framework owns the main window.
+     */
+    mainWindowWebPreferences?(): Record<string, unknown> | undefined;
+    /**
+     * Called once, synchronously, AFTER the framework constructs the main window
+     * and BEFORE any content load (loadFile/loadURL). Receives the framework-built
+     * main window and the injected electron module so the backend can attach
+     * listeners / views / state before the renderer starts. Only fires in the
+     * `ownsWindows` falsy path.
+     */
+    onMainWindowCreated?(win: BrowserWindow, electron: typeof import('electron')): void;
+    /**
+     * Called when the framework edge-trusts one of its webContents — covers the
+     * framework-built main window as well as framework-built declared / host /
+     * runtime-created windows. Lets the backend mirror trust into the domain
+     * trust set. Returns a Disposable the framework disposes on untrust / window
+     * destroy.
+     */
+    onWindowTrusted?(wc: MinimalWebContents): Disposable;
+    /**
+     * Main-window `close` decision (cancelable). `'keep'` → framework keeps the
+     * window (backend has already torn down its session / navigated back);
+     * `'close'` → framework destroys the window and shuts down. Must NOT call
+     * close/destroy itself; must finish any flush before returning `'close'`.
+     */
+    onMainWindowClose?(): MaybePromise<'keep' | 'close'>;
+    /** Framework resize hook — backend repositions its overlays against the
+     *  framework-built main window that emitted `resize`. */
+    repositionOverlays?(win: BrowserWindow): void;
+    /**
+     * Fired on `second-instance` when `config.app.singleInstance` is set and this
+     * process holds the lock — the backend typically focuses/restores its main
+     * window. Process-level: fires regardless of `ownsWindows`.
+     */
+    onSecondInstance?(): void;
+    /**
+     * Deterministic shutdown hook. AWAITED exactly ONCE during `app.shutdown()`'s
+     * cleanup, consistently with `config.lifecycle.beforeClose` — so a backend no
+     * longer hand-rolls `app.once('before-quit', ...)`. Best-effort: a throw/reject
+     * is logged and does NOT abort the rest of shutdown. Fires regardless of
+     * `ownsWindows`.
+     */
+    onShutdown?(): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}