@dimina-kit/electron-deck 0.1.0-dev.20260618090552 → 0.1.0-dev.20260624040247

package/dist/host/index.js

@@ -1,2 +1,2 @@
-import { a as WireTransport, c as InMemoryTypedIpcRegistry, i as createControlBus, l as EventBus, o as createCapabilityRegistry, r as validateConfig, s as createTrustSet } from "../electron-deck-CW6gkGS-.js";
+import { a as WireTransport, c as InMemoryTypedIpcRegistry, i as createControlBus, l as EventBus, o as createCapabilityRegistry, r as validateConfig, s as createTrustSet } from "../electron-deck-C9_Yu3fd.js";
 export { EventBus, InMemoryTypedIpcRegistry, WireTransport, createCapabilityRegistry, createControlBus, createTrustSet, validateConfig };

package/dist/index.js

@@ -1,3 +1,3 @@
 import { i as UndeclaredHostEventError, n as DeckRemoteError, r as EventNotBoundError, t as DeckClientNotReadyError } from "./errors-NE2ig7L5.js";
-import { n as startElectronDeck, t as electronDeck, u as defineEvent } from "./electron-deck-CW6gkGS-.js";
+import { n as startElectronDeck, t as electronDeck, u as defineEvent } from "./electron-deck-C9_Yu3fd.js";
 export { DeckClientNotReadyError, DeckRemoteError, EventNotBoundError, UndeclaredHostEventError, defineEvent, electronDeck, startElectronDeck };

package/dist/internal/deck-app.d.ts

@@ -5,28 +5,28 @@ import { type Scope } from '../main/scope.js';
 import { type CapabilityPolicy } from '../host/capability.js';
 import { type MinimalIpcMain, type MinimalWebContents } from './wire-transport.js';
 /**
- * Optional dependencies for {@link DeckApp} —— Phase 3b 用于注入真 (或
+ * Optional dependencies for {@link DeckApp} —— 用于注入真 (或
  * mock) Electron `ipcMain` + trusted webContents 集合，让 framework 接通跨进程
- * wire transport。不注入则保持 Phase 2 main-internal-only 行为。
+ * wire transport。不注入则保持 main-internal-only 行为。
  *
  * @internal
  */
 export interface DeckAppOptions {
     readonly wireTransport?: {
         readonly ipcMain: MinimalIpcMain;
-        /** 默认返回 framework 内部维护的 trusted set（Phase 4 由 windows.trust 填）。 */
+        /** 默认返回 framework 内部维护的 trusted set（由 windows.trust 填）。 */
         readonly trustedWebContents?: () => readonly MinimalWebContents[];
         /** 自定义 senderPolicy（默认按 trusted set 判断）。 */
         readonly senderPolicy?: SenderPolicy;
     };
     /**
-     * Phase 4 — 注入真 (或 fake) Electron `BrowserWindow` / `WebContentsView`
+     * 注入真 (或 fake) Electron `BrowserWindow` / `WebContentsView`
      * 构造器；提供后 framework 会装配 mainWindow / toolbarView / declared
-     * windows，否则保持 Phase 3b electron-unavailable 行为。
+     * windows，否则保持 electron-unavailable 行为。
      */
     readonly electron?: MinimalElectron;
     /**
-     * v2 — 领域 backend。提供后 framework 在 whenReady 前跑 `beforeReady`，
+     * 领域 backend。提供后 framework 在 whenReady 前跑 `beforeReady`，
      * 在 setup 阶段跑 `assemble(runtime)`。不提供则退化为纯框架（桩 context，
      * 仅测试/演示用）。
      */
@@ -34,8 +34,8 @@ export interface DeckAppOptions {
 }
 /**
  * Framework-internal "app" object —— `electronDeck(config)` 顶层入口的 plain-class
- * 形态，便于 Phase 2 测试驱动 lifecycle 转换。Phase 3b 加 wireTransport 注入
- * 后可接真 ipcMain；Phase 4 加 electron 注入后可装配 mainWindow / toolbarView
+ * 形态，便于测试驱动 lifecycle 转换。加 wireTransport 注入
+ * 后可接真 ipcMain；加 electron 注入后可装配 mainWindow / toolbarView
  * / declared windows。两者都不注入时退化为同进程内存 fake。
  *
  * @internal
@@ -48,21 +48,21 @@ export declare class DeckApp {
     private readonly ipc;
     private readonly fwListeners;
     private readonly trustSet;
-    /** P4 Phase B — privileged-command grant registry. The policy gates
+    /** Privileged-command grant registry. The policy gates
      *  ControlBus.dispatch; grants are minted via `runtime.grants.issue`. */
     private readonly capability;
-    /** P4 Phase B — the grant-gated command bus for PRIVILEGED `layout.*`
+    /** The grant-gated command bus for PRIVILEGED `layout.*`
      *  commands. Constructed in `bindWireTransport` with the capability policy
      *  injected, so `dispatch` default-DENIES any command lacking a live grant.
      *  Privileged commands are registered via `runtime.layout.command`; ordinary
      *  domain APIs stay on the un-gated `InMemoryTypedIpcRegistry`. */
     private controlBus;
-    /** v2 — per-webContents backend `onWindowTrusted` Disposable, so a window's
+    /** Per-webContents backend `onWindowTrusted` Disposable, so a window's
      *  trust mirror is undone when THAT window closes (not only at teardown). */
     private readonly backendTrustDisposables;
     private readonly options;
     private wireTransport;
-    /** v2 — the live wire senderPolicy, reused by buildRuntime so
+    /** The live wire senderPolicy, reused by buildRuntime so
      *  `context._senderPolicy` reflects real trust instead of a `() => true` stub. */
     private wireSenderPolicy;
     private mainWindow;
@@ -70,23 +70,19 @@ export declare class DeckApp {
     private readonly declaredWindows;
     private readonly trackedWindows;
     /**
-     * unified-lifetime P0 (observation-only, zero-regression). The root lifetime
-     * scope of the app + a shadow map mirroring `trackedWindows`, keyed by each
-     * window's webContents, carrying a per-window child Scope. P0 is PURELY
-     * OBSERVATIONAL: these windowScopes own NO resources (no destroy/trust/wire is
-     * moved onto them), so `rootScope.close()` during shutdown is a no-op for app
-     * behaviour — it exists only to lay the foundation P1 will take over. The
+     * The root lifetime scope of the app + a shadow map mirroring `trackedWindows`,
+     * keyed by each window's webContents, carrying a per-window child Scope. The
      * shadow's key set is kept in lock-step with `trackedWindows` at every
      * maintenance point.
      */
     private readonly rootScope;
     private readonly lifetimeShadow;
     /**
-     * unified-lifetime P1b: per-trusted-webContents trust record. `wcScope` is a
+     * Per-trusted-webContents trust record. `wcScope` is a
      * child of the owning window's `windowScope`; it OWNS the wc's trust ref-count
      * lease(s). When the window closes, `windowScope.close()` cascades into this
      * `wcScope` (children-first LIFO), disposing every lease → ref-count hits 0 →
-     * the wc leaves the trust set. This replaces the imperative `deleteEntry`.
+     * the wc leaves the trust set.
      * A wc can be trusted more than once (framework auto-trust + host
      * `windows.trust`), so `leases` is a Set.
      */
@@ -94,13 +90,13 @@ export declare class DeckApp {
     private readonly pendingWindowCreated;
     private readonly pendingLoadFailed;
     /**
-     * host-view slice 1 — per-window native-view substrate, keyed by the window's
+     * Per-window native-view substrate, keyed by the window's
      * webContents (same key discipline as `lifetimeShadow`). Created at both
      * window-construction sites; dropped in `handleSubWindowClosed`.
      */
     private readonly windowSubstrates;
     /**
-     * P3 — per-adopted-window registration handle, keyed by the adopted window's
+     * Per-adopted-window registration handle, keyed by the adopted window's
      * webContents. `runtime.windows.adopt` is idempotent by wc identity: a second
      * adopt of the same window returns this stored Disposable (no double-admit, no
      * second substrate). The entry is removed when the registration is disposed
@@ -108,7 +104,7 @@ export declare class DeckApp {
      */
     private readonly adoptedWindows;
     /**
-     * C1/C4 — per-registered-window {@link DeckWindow} facade + its per-window
+     * Per-registered-window {@link DeckWindow} facade + its per-window
      * close deciders, keyed by the window's control wc. Populated by
      * {@link registerWindow} for framework-created and adopted windows, plus the
      * framework-built main window. `deciders` is an ORDERED list run in
@@ -116,13 +112,13 @@ export declare class DeckApp {
      * decision latch (mirrors the main-window `closingDecisionPromise`).
      */
     private readonly windowRegistrations;
-    /** C1 — the framework-built main window's control wc, so `runtime.windows.main`
+    /** The framework-built main window's control wc, so `runtime.windows.main`
      *  can resolve its {@link DeckWindow}. Null under an `ownsWindows:true` backend. */
     private mainControlWc;
-    /** host-view slice 1 — monotonic id source for `runtime.view` native views. */
+    /** Monotonic id source for `runtime.view` native views. */
     private viewSeq;
     /**
-     * P2 — provenance map for `runtime.scopes.create()` sessions: maps an opaque
+     * Provenance map for `runtime.scopes.create()` sessions: maps an opaque
      * {@link DeckSession} to its internal `rootScope.child()` Scope. A WeakMap so a
      * dropped session is GC'd; the framework holds the scope's lifetime via
      * rootScope anyway (the session scope is a rootScope child). `runtime.view`
@@ -139,7 +135,7 @@ export declare class DeckApp {
      * without `keepAlive` never participate.
      */
     private readonly keepAliveGroups;
-    /** C3: wcs that already have the `did-start-navigation` grant-reset hook bound,
+    /** Wcs that already have the `did-start-navigation` grant-reset hook bound,
      *  so {@link bindNavigationGrantReset} is idempotent — a wc admitted to trust
      *  more than once (e.g. constructed `autoTrust:false` then `windows.trust()`ed,
      *  or un-adopted then re-adopted) never accumulates duplicate nav listeners. */
@@ -159,9 +155,9 @@ export declare class DeckApp {
     /** Set when shutdown is driven by the `will-quit` handler — the app is already
      *  quitting, so `doShutdown()` must NOT re-`app.quit()` (re-entrant quit). */
     private quitInitiated;
-    /** v2 close machine: non-null while a close decision is awaiting (in-flight latch). */
+    /** Close machine: non-null while a close decision is awaiting (in-flight latch). */
     private closingDecisionPromise;
-    /** v2 close machine: set once a 'close' decision is committed (guards the
+    /** Close machine: set once a 'close' decision is committed (guards the
      *  window between decision-resolve and the 'closed' event). Never resets. */
     private shuttingDown;
     /** Idempotency latch for {@link runShutdownCleanup}: the cleanup body
@@ -192,7 +188,7 @@ export declare class DeckApp {
     private bindAppLifecycle;
     shutdown(): Promise<void>;
     /**
-     * @internal Phase 4 windows.trust() / framework 内部添加 trusted webContents.
+     * @internal windows.trust() / framework 内部添加 trusted webContents.
      * Backend-owned / untracked-window fallback: there is no framework windowScope
      * for these (the backend manages their lifetime), so the trust lease is owned
      * by `rootScope` as an app-shutdown backstop. The backend still disposes the
@@ -200,18 +196,18 @@ export declare class DeckApp {
      */
     _trustWebContents(wc: MinimalWebContents): Disposable;
     /**
-     * unified-lifetime P1b: admit `wc` to the trust set under `windowScope`. Gets
+     * Admit `wc` to the trust set under `windowScope`. Gets
      * or creates the wc's `wcScope` (a child of `windowScope`), takes a fresh
      * `trustSet.admit(wc, wcScope)` ref-count lease OWNED BY that wcScope, and returns a
      * one-shot host-facing Disposable that releases just THIS lease early. On
      * `wcScope.close()` (window-close cascade) every still-held lease is disposed
-     * → ref-count zeroes → the wc leaves the set (equivalent to the old
-     * `deleteEntry`, but driven by Scope teardown and covering partially-built
-     * windows too). Idempotent registry cleanup is owned by the wcScope.
+     * → ref-count zeroes → the wc leaves the set (driven by Scope teardown,
+     * covering partially-built windows too). Idempotent registry cleanup is owned
+     * by the wcScope.
      */
     private admitTrust;
     /**
-     * C3 (P0 security) — bind the main-frame cross-document navigation grant-reset
+     * Bind the main-frame cross-document navigation grant-reset
      * hook on a control `wc`. On a MAIN-FRAME CROSS-DOCUMENT navigation
      * (`isMainFrame && !isInPlace`) this SYNCHRONOUSLY revokes the wc's capability
      * grants (`capability.revokeBySenderId`) and slot tokens, so the navigated-to
@@ -227,7 +223,7 @@ export declare class DeckApp {
      */
     private bindNavigationGrantReset;
     /**
-     * C1 — build the {@link DeckWindow} facade over a registered window and record
+     * Build the {@link DeckWindow} facade over a registered window and record
      * it (so `runtime.windows.create()` / `runtime.windows.main` can return it and
      * the per-window close machine can find its deciders). `newSession()` mints a
      * window-rooted {@link DeckSession} (a `windowScope.child()` registered in the
@@ -238,7 +234,7 @@ export declare class DeckApp {
     /**
      * Resolve a window argument that may be either a raw `BrowserWindow` (the
      * historical `runtime.view().placeIn(window)` shape) OR a {@link DeckWindow}
-     * handle (the C1 `runtime.windows.create()` return). A DeckWindow exposes the
+     * handle (the `runtime.windows.create()` return). A DeckWindow exposes the
      * underlying window via `.window` and has no `.webContents` of its own; a raw
      * window has `.webContents`. Unwrap so the substrate lookup keys off the real
      * control webContents either way — keeping the `placeIn(deckWindow)` and
@@ -246,7 +242,7 @@ export declare class DeckApp {
      */
     private resolveWindowArg;
     /**
-     * C4 — run a registered window's per-window close deciders (registration order;
+     * Run a registered window's per-window close deciders (registration order;
      * any `'keep'` vetoes), with an in-flight latch so a re-entrant close during a
      * pending decision decides ONCE. A throw / rejection fails CLOSED. Returns the
      * committed decision, or `null` when the decision is still in flight / there are
@@ -254,7 +250,7 @@ export declare class DeckApp {
      */
     private runWindowCloseDeciders;
     /**
-     * C4 — arm the per-window cancelable close-decision machine on a CREATED /
+     * Arm the per-window cancelable close-decision machine on a CREATED /
      * adopted window. On a `close` attempt: `preventDefault`, dispatch the
      * per-window deciders behind an in-flight latch (re-entrant closes swallowed),
      * and on a `'close'` decision `win.destroy()` (→ `'closed'` → revoke +
@@ -265,44 +261,43 @@ export declare class DeckApp {
      */
     private armSubWindowCloseMachine;
     /**
-     * @internal unified-lifetime P0 accessors (observation-only). The live shadow
-     * map mirroring `trackedWindows`, the root Scope, and a consistency assertion.
+     * @internal Lifetime accessors. The live shadow map mirroring `trackedWindows`,
+     * the root Scope, and a consistency assertion.
      */
     __lifetimeShadow(): Map<MinimalWebContents, {
         window: MinimalBrowserWindow;
         windowScope: Scope;
     }>;
-    /** @internal unified-lifetime P0: the root lifetime Scope. */
+    /** @internal The root lifetime Scope. */
     __rootScope(): Scope;
-    /** @internal unified-lifetime P1b: the per-trusted-wc trust records. */
+    /** @internal The per-trusted-wc trust records. */
     __wcRecords(): Map<MinimalWebContents, {
         wcScope: Scope;
         leases: Set<Disposable>;
         windowScope: Scope;
     }>;
-    /** @internal P4 Phase B: the live capability policy (grant gate reads it). */
+    /** @internal The live capability policy (grant gate reads it). */
     __capabilityPolicy(): CapabilityPolicy;
     /**
-     * @internal unified-lifetime P0 invariant (A): the shadow's per-window set
+     * @internal Lifetime invariant: the shadow's per-window set
      * (the `window` of each entry) must equal `trackedWindows` membership. Throws
      * if violated; no-op otherwise.
      */
     __assertLifetimeConsistent(): void;
     private bindDeclarativeFields;
     /**
-     * host-view slice 1 — build a per-window {@link ViewSubstrate}. The
+     * Build a per-window {@link ViewSubstrate}. The
      * `ContentViewHost` adapts `win.contentView` and tracks the Compositor-managed
      * z-order in `order` (the minimal `contentView` has no `children()`). The
      * substrate's `detachAll` is owned on `windowScope` AFTER the window's
-     * `win.destroy` own, so LIFO teardown runs detachAll (STEP1) BEFORE destroy
-     * (STEP4) — the A4 ordering.
+     * `win.destroy` own, so LIFO teardown runs detachAll BEFORE destroy.
      */
     private createWindowSubstrate;
     private assembleElectron;
-    /** Phase 4 race fix：在 wireTransport.start 之后再 loadURL/loadFile。 */
+    /** 在 wireTransport.start 之后再 loadURL/loadFile，避免 preload 先于 ipcMain handler 注册触发 invoke。 */
     private loadAssembledSources;
     /**
-     * #3 R5/C2 — load is best-effort: log + emit `load-failed` if it rejects,
+     * Load is best-effort: log + emit `load-failed` if it rejects,
      * but never let start() reject because of a renderer load issue (we'd
      * leave the host blocked indefinitely while the framework is otherwise
      * happy).
@@ -323,7 +318,7 @@ export declare class DeckApp {
      */
     private isPrivilegedCommandName;
     /**
-     * KA-4: warn ONCE about an invalid `keepAlive.max` (negative / non-integer /
+     * Warn ONCE about an invalid `keepAlive.max` (negative / non-integer /
      * NaN). Such a view is not keep-alive-managed (the group is skipped); warning
      * once avoids log spam when many views share the same bad config.
      */
@@ -331,7 +326,7 @@ export declare class DeckApp {
     private warnInvalidKeepAliveMax;
     private constructWindow;
     /**
-     * P3 — register an EXTERNALLY-created window into the framework so
+     * Register an EXTERNALLY-created window into the framework so
      * `runtime.view().placeIn(win)` works for it: a `rootScope.child()`
      * windowScope, a per-window {@link ViewSubstrate}, and the TRUST lifecycle —
      * mirroring {@link constructWindow}'s registration, but for a window the host
@@ -345,7 +340,7 @@ export declare class DeckApp {
      *     windowScope so app shutdown destroys the window; for `'observe'` the host
      *     keeps lifetime control (the framework never destroys it),
      *  4) arm trust+grant+slot-token revocation as the FIRST `'closed'` listener via
-     *     `prependListener` (codex R2 — runs before any external `'closed'` listener),
+     *     `prependListener` (runs before any external `'closed'` listener),
      *  5) `admitTrust` AFTER the revoke listener is registered (constructWindow order).
      *
      * Idempotent by webContents identity: a second adopt of the same window returns
@@ -353,12 +348,11 @@ export declare class DeckApp {
      */
     private adoptWindow;
     /**
-     * unified-lifetime P1b: synchronously revoke BOTH trust leases AND capability
+     * Synchronously revoke BOTH trust leases AND capability
      * grants for every wc admitted under `windowScope` (the window's control wc +
      * any siblings like the toolbar wc). Called from the window's 'closed' handler
-     * so both authorizations are gone the instant the window is destroyed —
-     * matching the old synchronous `deleteEntry` timing and closing every
-     * async-cascade race (a destroyed wc can never be observed trusted OR granted
+     * so both authorizations are gone the instant the window is destroyed,
+     * closing every async-cascade race (a destroyed wc can never be observed trusted OR granted
      * by a later shutdown/beforeClose, nor by a NEW window that reuses the same
      * wc.id before the async scope cascade revokes it). The leases are ALSO owned
      * by their wcScope, so the async `windowScope.close()` still runs (it disposes
@@ -371,8 +365,8 @@ export declare class DeckApp {
      */
     private revokeWindowTrust;
     /**
-     * Arm the wire's slot-token inbound channels (idempotent). P5 eager-arm:
-     * called once at framework start() (bindWireTransport, right after
+     * Arm the wire's slot-token inbound channels (idempotent). Called once at
+     * framework start() (bindWireTransport, right after
      * transport.start()) so a layout client can subscribe before the first
      * anchored placeIn; the anchored `placeIn` call site is now a redundant no-op
      * (kept for safety). No-op when there's no wire transport (main-internal-only
@@ -396,7 +390,7 @@ export declare class DeckApp {
     private revokeSlotTokensForWc;
     private handleSubWindowClosed;
     /**
-     * v2 — notify the backend that the framework has edge-trusted one of its
+     * Notify the backend that the framework has edge-trusted one of its
      * (framework-built) webContents, so the backend can mirror it into the domain
      * trust set. The returned Disposable is disposed when THAT window closes
      * ({@link handleSubWindowClosed}) — honouring the contract "framework disposes

package/dist/internal/deck-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deck-app.d.ts","sourceRoot":"","sources":["../../src/internal/deck-app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,UAAU,EAIV,cAAc,EACd,OAAO,EACP,YAAY,EAIZ,UAAU,EASV,MAAM,aAAa,CAAA;AAIpB,OAAO,KAAK,EAEX,oBAAoB,EAEpB,eAAe,EAGf,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAQ1D,OAAO,EAEN,KAAK,gBAAgB,EACrB,MAAM,uBAAuB,CAAA;AAK9B,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,MAAM,qBAAqB,CAAA;AAQ5B;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;QAChC,mEAAmE;QACnE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,SAAS,kBAAkB,EAAE,CAAA;QACjE,4CAA4C;QAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;KACpC,CAAA;IACD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CACjC;AAiDD;;;;;;;GAOG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAE3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiC;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoE;IAChG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD;6EACyE;IACzE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD;;;;uEAImE;IACnE,OAAO,CAAC,UAAU,CAA0B;IAC5C;iFAC6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA4C;IACpF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,aAAa,CAA6B;IAClD;sFACkF;IAClF,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG5B;IACH;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGvB;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAClE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+C;IAChF;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAC3E;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAWjC;IACH;wFACoF;IACpF,OAAO,CAAC,aAAa,CAAkC;IACvD,+EAA+E;IAC/E,OAAO,CAAC,OAAO,CAAI;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG7B;IACH;;;oFAGgF;IAChF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IACjE;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGxB;IACH,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAA6B;IACpD;kFAC8E;IAC9E,OAAO,CAAC,aAAa,CAAQ;IAC7B,uFAAuF;IACvF,OAAO,CAAC,sBAAsB,CAAyC;IACvE;iFAC6E;IAC7E,OAAO,CAAC,YAAY,CAAQ;IAC5B;;;;;;;;;;;0EAWsE;IACtE,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,cAAmB;IAwB5D,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,IAAI,OAAO,IAAI,OAAO,CAKrB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiF5B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAwBxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAMzB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,GAAG,UAAU;IAIrD;;;;;;;;;OASG;IACH,OAAO,CAAC,UAAU;IAkClB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,wBAAwB;IA+BhC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAmDvB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;OAMG;YACW,sBAAsB;IAoBpC;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IA8BhC;;;OAGG;IACH,gBAAgB,IAAI,GAAG,CAAC,kBAAkB,EAAE;QAAE,MAAM,EAAE,oBAAoB,CAAC;QAAC,WAAW,EAAE,KAAK,CAAA;KAAE,CAAC;IAIjG,8DAA8D;IAC9D,WAAW,IAAI,KAAK;IAIpB,wEAAwE;IACxE,WAAW,IAAI,GAAG,CAAC,kBAAkB,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAA;KAAE,CAAC;IAIvG,8EAA8E;IAC9E,kBAAkB,IAAI,gBAAgB;IAItC;;;;OAIG;IACH,0BAA0B,IAAI,IAAI;IAiBlC,OAAO,CAAC,qBAAqB;IAoC7B;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAmD7B,OAAO,CAAC,gBAAgB;IAqOxB,mEAAmE;IACnE,OAAO,CAAC,oBAAoB;IAmB5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAehB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;IAiGzB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB,CAAQ;IACzC,OAAO,CAAC,uBAAuB;IAS/B,OAAO,CAAC,eAAe;IAqFvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAW;IA0GnB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAM7B,oFAAoF;IACpF,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,qBAAqB;IAuC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,kBAAkB;YAiBZ,cAAc;YAOd,UAAU;IA8BxB,OAAO,CAAC,kBAAkB;YAYZ,iBAAiB;IAkF/B,OAAO,CAAC,YAAY;CAupBpB"}
+{"version":3,"file":"deck-app.d.ts","sourceRoot":"","sources":["../../src/internal/deck-app.ts"],"names":[],"mappings":"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"}

package/dist/internal/electron-types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Phase 4 — minimal structural typing for the Electron surface the electron-deck
+ * Minimal structural typing for the Electron surface the electron-deck
  * framework needs to assemble its real windows / views. Tests inject a plain
  * object satisfying these shapes via {@link DeckAppOptions.electron};
  * the framework does **not** import 'electron' directly.
@@ -57,8 +57,8 @@ export interface MinimalContentView {
     addChildView(view: MinimalWebContentsView): void;
     removeChildView(view: MinimalWebContentsView): void;
     /** The window's live child views (real Electron `View.children`). Used by the
-     *  moveTo rollback to guard against removing a child the dest never added
-     *  (codex P0 round-3 BUG 2). Optional so existing fakes stay valid; an absent
+     *  moveTo rollback to guard against removing a child the dest never added.
+     *  Optional so existing fakes stay valid; an absent
      *  array is treated as "membership unknown" by the guard's `?? []`. */
     readonly children?: readonly MinimalWebContentsView[];
 }

package/dist/internal/trust-set.d.ts

@@ -1,8 +1,8 @@
 /**
- * TrustSet — SEALED refcount membership of trusted webContents (P2).
+ * TrustSet — SEALED refcount membership of trusted webContents.
  *
- * Refcount membership extracted from `DeckApp`'s former private `trustedWcRefs`
- * (Map<wc, refcount>) so the same primitive can back both `DeckApp` and the
+ * Refcount membership (Map<wc, refcount>) factored into a standalone primitive
+ * so it can back both `DeckApp` and the
  * domain-neutral `ControlBus` facade.
  *
  * SEALED WRITE MODEL: there is exactly ONE writer — `admit(wc, owner)`. It forces

package/dist/internal/wire-transport.d.ts

@@ -1,5 +1,5 @@
 /**
- * WireTransport — main 端的真 Electron wire 桥接（Phase 3b）。
+ * WireTransport — main 端的真 Electron wire 桥接。
  *
  * 责任：
  * - 在 `ipcMain.handle('__electron-deck:invoke')` / `'__electron-deck:probe'` 上路由
@@ -26,7 +26,7 @@ export declare const DECK_CODE: {
     readonly UntrustedFrame: "DECK_UNTRUSTED_FRAME";
     readonly UnknownKind: "DECK_UNKNOWN_KIND";
     readonly BadRequest: "DECK_BAD_REQUEST";
-    /** P4 Phase B — the grant gate denied a privileged command for this sender. */
+    /** The grant gate denied a privileged command for this sender. */
     readonly Forbidden: "DECK_FORBIDDEN";
 };
 /** Minimal RenderFrameHost identity used for main-frame discrimination. */
@@ -38,8 +38,8 @@ export interface FrameRef {
  * Per-invoke context threaded from {@link WireTransport.handleInvoke} into the
  * host/simulator invoke seams. Constructed ONLY after the wire's trust gate +
  * main-frame gate have both passed, so `senderId` is a real trusted webContents
- * id (never undefined). Phase B's grant gate (in `ControlBus.dispatch`) reads
- * this; Phase A just plumbs it through as a REQUIRED param so a missing call
+ * id (never undefined). The grant gate (in `ControlBus.dispatch`) reads
+ * this; it is a REQUIRED param so a missing call
  * site is a COMPILE error, not a silent security downgrade.
  */
 export interface InvokeCtx {
@@ -70,7 +70,7 @@ export interface WireTransportDeps {
     /** 取当前 trusted webContents 快照；用于 event push 广播。lazy：每次 publish 重调。 */
     readonly trustedWebContents: () => readonly MinimalWebContents[];
     /** 路由 host kind 调用；handler 抛错由 WireTransport 接住 → InvokeFailure。
-     *  `ctx` 必填：携带已过 trust + main-frame gate 的 senderId（Phase B 授权门读它）。 */
+     *  `ctx` 必填：携带已过 trust + main-frame gate 的 senderId（授权门读它）。 */
     readonly invokeHost: (name: string, args: readonly JsonValue[], ctx: InvokeCtx) => Promise<JsonValue>;
     /** 路由 simulator kind 调用；同上（`ctx` 必填）。 */
     readonly invokeSimulator: (name: string, args: readonly JsonValue[], ctx: InvokeCtx) => Promise<JsonValue>;

package/dist/internal/wire-transport.d.ts.map

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

package/dist/layout/index.d.ts

@@ -11,4 +11,5 @@ export { serializeLayout, parseLayout, validateTree } from './serialize.js';
 export { sanitizeFlexibleWeights } from './sanitize.js';
 export { setSizes, setConstraint, setActive, movePanel, splitPanel, closePanel, extractPanel, insertPanel, } from './mutations.js';
 export { createLayoutModel } from './model.js';
+export { closePanelForUser } from './user-actions.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACX,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EACN,QAAQ,EACR,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACX,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EACN,QAAQ,EACR,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/layout/index.js

@@ -1,2 +1,2 @@
-import { a as movePanel, c as setSizes, d as parseLayout, f as serializeLayout, i as insertPanel, l as splitPanel, m as createPanelRegistry, n as closePanel, o as setActive, p as validateTree, r as extractPanel, s as setConstraint, t as createLayoutModel, u as sanitizeFlexibleWeights } from "../layout-WI8y1hxP.js";
-export { closePanel, createLayoutModel, createPanelRegistry, extractPanel, insertPanel, movePanel, parseLayout, sanitizeFlexibleWeights, serializeLayout, setActive, setConstraint, setSizes, splitPanel, validateTree };
+import { a as insertPanel, c as setConstraint, d as sanitizeFlexibleWeights, f as parseLayout, h as createPanelRegistry, i as extractPanel, l as setSizes, m as validateTree, n as createLayoutModel, o as movePanel, p as serializeLayout, r as closePanel, s as setActive, t as closePanelForUser, u as splitPanel } from "../layout-oJQ9hind.js";
+export { closePanel, closePanelForUser, createLayoutModel, createPanelRegistry, extractPanel, insertPanel, movePanel, parseLayout, sanitizeFlexibleWeights, serializeLayout, setActive, setConstraint, setSizes, splitPanel, validateTree };

package/dist/layout/types.d.ts

@@ -57,9 +57,10 @@ export interface LayoutTree {
 /**
  * Per-panel drag/drop capability policy. All fields are OPTIONAL and
  * DEFAULT-PERMISSIVE, so existing registrations keep today's behavior (a fully
- * draggable panel that may move/split freely). The two fields are orthogonal:
+ * draggable, closable panel that may move/split freely). The fields are orthogonal:
  * `draggable` governs whether the panel is a drag SOURCE / drop ANCHOR at all;
- * `dropPolicy` governs where a draggable panel may LAND.
+ * `dropPolicy` governs where a draggable panel may LAND; `closable` governs
+ * whether DockView exposes the panel's close affordance.
  */
 export interface PanelCapabilities {
     /**
@@ -77,6 +78,11 @@ export interface PanelCapabilities {
      * `undefined` is treated as `'free'`.
      */
     readonly dropPolicy?: 'free' | 'reorder-only';
+    /**
+     * When `false`, DockView does not render a close affordance for this panel.
+     * `undefined` is treated as `true`.
+     */
+    readonly closable?: boolean;
     /**
      * When `true`, this panel contributes NO tab to the group's tab strip. A
      * group whose every panel hides its tab renders no tab strip at all (its body

package/dist/layout/types.d.ts.map

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

package/dist/layout/user-actions.d.ts

@@ -0,0 +1,9 @@
+import type { LayoutTree, PanelRegistry } from './types.js';
+/**
+ * Close a panel only when its descriptor permits user closure.
+ *
+ * Missing descriptors and an omitted `closable` capability retain the historic
+ * close behavior. Only an explicit `closable:false` blocks the operation.
+ */
+export declare function closePanelForUser(tree: LayoutTree, panelId: string, registry: PanelRegistry): LayoutTree;
+//# sourceMappingURL=user-actions.d.ts.map

package/dist/layout/user-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-actions.d.ts","sourceRoot":"","sources":["../../src/layout/user-actions.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,GACrB,UAAU,CAEZ"}

package/dist/{layout-WI8y1hxP.js → layout-oJQ9hind.js}

@@ -566,6 +566,24 @@ function createLayoutModel(initial) {
 	};
 }
 //#endregion
-export { movePanel as a, setSizes as c, parseLayout as d, serializeLayout as f, insertPanel as i, splitPanel as l, createPanelRegistry as m, closePanel as n, setActive as o, validateTree as p, extractPanel as r, setConstraint as s, createLayoutModel as t, sanitizeFlexibleWeights as u };
+//#region src/layout/user-actions.ts
+/**
+* Capability-aware layout operations for user-triggered interactions.
+*
+* Keep these separate from the pure mutations: callers may still use
+* `closePanel` for restore/migration/programmatic layout transforms, while UI
+* entry points consistently honor registry capabilities.
+*/
+/**
+* Close a panel only when its descriptor permits user closure.
+*
+* Missing descriptors and an omitted `closable` capability retain the historic
+* close behavior. Only an explicit `closable:false` blocks the operation.
+*/
+function closePanelForUser(tree, panelId, registry) {
+	return registry.get(panelId)?.closable === false ? tree : closePanel(tree, panelId);
+}
+//#endregion
+export { insertPanel as a, setConstraint as c, sanitizeFlexibleWeights as d, parseLayout as f, createPanelRegistry as h, extractPanel as i, setSizes as l, validateTree as m, createLayoutModel as n, movePanel as o, serializeLayout as p, closePanel as r, setActive as s, closePanelForUser as t, splitPanel as u };
 
-//# sourceMappingURL=layout-WI8y1hxP.js.map
+//# sourceMappingURL=layout-oJQ9hind.js.map