@dimina-kit/electron-deck 0.1.0-dev.20260701083540 → 0.1.0-dev.20260702145840

package/dist/client/index.d.ts

@@ -5,6 +5,8 @@ import type { Disposable, HostEvent, JsonValue } from '../types.js';
 export { DeckClientNotReadyError, DeckRemoteError };
 export { createDeckLayoutClient } from './layout-client.js';
 export type { SlotGrant, LayoutBridge, LayoutClientDeps, } from './layout-client.js';
+export { createPlacementPublisher } from './placement-publisher.js';
+export type { PlacementPublisher, PlacementPublisherDeps, } from './placement-publisher.js';
 export interface CreateDeckClientOptions {
     /** 默认 `__electronDeckBridge`；必须与 host preload 对齐 */
     readonly globalName?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,eAAe,EACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,CAAA;AAEnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EACX,SAAS,EACT,YAAY,EACZ,gBAAgB,GAChB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,uBAAuB;IACvC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AASD,MAAM,WAAW,UAAU,CAE1B,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,EACxD,EAAE,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,EAAE;IAE1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,MAAM,EACjC,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,IAAI,GACnE,UAAU,CAAA;CACb;AAED,wBAAgB,gBAAgB,CAE/B,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,EACxD,EAAE,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,EAAE,EACzC,OAAO,CAAC,EAAE,uBAAuB,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CA+DvD;AAED,wBAAgB,oBAAoB,CACnC,UAAU,GAAE,MAA8B,GACxC,UAAU,GAAG,SAAS,CAKxB;AASD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,eAAe,EACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACN,uBAAuB,EACvB,qBAAqB,EACrB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,CAAA;AAEnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EACX,SAAS,EACT,YAAY,EACZ,gBAAgB,GAChB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACnE,YAAY,EACX,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,WAAW,uBAAuB;IACvC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AASD,MAAM,WAAW,UAAU,CAE1B,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,EACxD,EAAE,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,EAAE;IAE1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,MAAM,EACjC,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtC,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,IAAI,GACnE,UAAU,CAAA;CACb;AAED,wBAAgB,gBAAgB,CAE/B,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,EACxD,EAAE,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,EAAE,EACzC,OAAO,CAAC,EAAE,uBAAuB,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CA+DvD;AAED,wBAAgB,oBAAoB,CACnC,UAAU,GAAE,MAA8B,GACxC,UAAU,GAAG,SAAS,CAKxB;AASD,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/client/index.js

@@ -1,5 +1,5 @@
 import { n as DeckRemoteError, t as DeckClientNotReadyError } from "../errors-NE2ig7L5.js";
-import { n as DEFAULT_BRIDGE_GLOBAL, t as BRIDGE_PROTOCOL_VERSION } from "../protocol-BJqo-vP2.js";
+import { n as DEFAULT_BRIDGE_GLOBAL, t as BRIDGE_PROTOCOL_VERSION } from "../protocol-B6TOT9AP.js";
 //#region ../view-anchor/src/view-anchor.ts
 var clampRect = (r) => ({
 	x: Math.round(r.x),
@@ -62,6 +62,7 @@ function createPlacementAnchor(target, opts) {
 	let rafId = null;
 	let steadyFrames = 0;
 	const STEADY_CLOSE_FRAMES = 2;
+	const MAX_HIDDEN_FOLLOW_FRAMES = 30;
 	let pointerHeld = false;
 	let sentinelDeadline = null;
 	const computePlacement = () => {
@@ -76,6 +77,10 @@ function createPlacementAnchor(target, opts) {
 		lastPublished = p;
 		publish(p);
 	};
+	const shouldCloseOnHiddenPoll = () => {
+		if (lastPublished?.visible === false) return true;
+		return steadyFrames++ >= MAX_HIDDEN_FOLLOW_FRAMES;
+	};
 	const sentinelFrame = () => {
 		rafId = null;
 		if (disposed || !visible) {
@@ -87,6 +92,14 @@ function createPlacementAnchor(target, opts) {
 			return;
 		}
 		const p = computePlacement();
+		if (!p.visible) {
+			if (shouldCloseOnHiddenPoll()) {
+				sentinelDeadline = null;
+				return;
+			}
+			rafId = requestAnimationFrame(sentinelFrame);
+			return;
+		}
 		if (lastPublished && samePlacement(lastPublished, p)) {
 			steadyFrames++;
 			if (steadyFrames >= STEADY_CLOSE_FRAMES && !pointerHeld) {
@@ -201,45 +214,111 @@ function createPlacementAnchor(target, opts) {
 	};
 }
 //#endregion
+//#region src/client/placement-publisher.ts
+function createPlacementPublisher(deps) {
+	const requestFrame = deps.requestFrame ?? ((cb) => requestAnimationFrame(cb));
+	const cancelFrame = deps.cancelFrame ?? ((id) => cancelAnimationFrame(id));
+	const readGeneration = typeof deps.generation === "function" ? deps.generation : () => deps.generation;
+	const views = /* @__PURE__ */ new Map();
+	let dirty = false;
+	let frameId = null;
+	let epoch = 0;
+	let disposed = false;
+	function schedule() {
+		if (disposed || frameId !== null) return;
+		frameId = requestFrame(flush);
+	}
+	function flush() {
+		frameId = null;
+		if (disposed || !dirty) return;
+		dirty = false;
+		deps.publish({
+			generation: readGeneration(),
+			epoch: epoch++,
+			views: [...views.values()]
+		});
+	}
+	return {
+		set(view) {
+			if (disposed) return;
+			views.set(view.viewId, view);
+			dirty = true;
+			schedule();
+		},
+		remove(viewId) {
+			if (disposed) return;
+			if (!views.delete(viewId)) return;
+			dirty = true;
+			schedule();
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			if (frameId !== null) {
+				cancelFrame(frameId);
+				frameId = null;
+			}
+		}
+	};
+}
+//#endregion
 //#region src/client/layout-client.ts
 /**
-* Renderer half of the slot-token handshake (capability-and-lifecycle.md「原子下发握手协议」). Subscribes to main's
-* `slot-grant` pushes FIRST (so a grant replayed synchronously by `subscribe()`
-* cannot be missed), then on each grant anchors the granted DOM slot with this
-* session's hardening opts (followScroll / followGeometry / guardDisplayNone)
-* and threads each measured `Placement` back to main as a `place` carrying that
-* grant's `slotToken`.
+* Renderer half of the slot-token handshake. Subscribes to main's `slot-grant`
+* pushes FIRST (so a grant replayed synchronously by `subscribe()` cannot be
+* missed), then on each grant anchors the granted DOM slot with this session's
+* hardening opts (followScroll / followGeometry / guardDisplayNone). Each anchor's
+* measured `Placement` is written into a CENTRAL placement publisher keyed by
+* `viewId` — NOT sent per-view. The publisher coalesces every anchor's writes into
+* ONE window-level snapshot per animation frame, so a transient relayout that
+* momentarily measures 0×0 is overwritten before it is ever published. This is the
+* producer half of the level-triggered reconcile design (see
+* ../layout/placement-reconcile.ts); a per-view edge stream cannot self-correct a
+* lost or spurious frame, which is what caused a stuck detached (white-screen)
+* view.
 */
 function createDeckLayoutClient(deps) {
 	const resolveSlot = deps.resolveSlot ?? ((id) => document.querySelector(id));
 	const createAnchor = deps.createAnchor ?? createPlacementAnchor;
+	let maxGeneration = 0;
+	const publisher = createPlacementPublisher({
+		generation: () => maxGeneration,
+		publish: (snapshot) => deps.bridge.sendSnapshot(snapshot),
+		requestFrame: deps.requestFrame,
+		cancelFrame: deps.cancelFrame
+	});
 	const byViewId = /* @__PURE__ */ new Map();
 	let disposed = false;
 	const unsub = deps.bridge.onSlotGrant((grant) => {
 		if (disposed) return;
+		if (grant.generation > maxGeneration) maxGeneration = grant.generation;
 		const existing = byViewId.get(grant.viewId);
 		if (existing && existing.token === grant.slotToken) return;
 		if (existing) try {
 			existing.anchor.dispose();
 		} finally {
 			byViewId.delete(grant.viewId);
+			publisher.remove(grant.viewId);
 		}
 		const el = resolveSlot(grant.slotId);
 		if (!el) return;
+		const token = grant.slotToken;
 		const anchor = createAnchor(el, {
 			visible: true,
 			followScroll: true,
 			followGeometry: true,
 			guardDisplayNone: true,
 			publish: (placement) => {
-				deps.bridge.sendPlace({
-					slotToken: grant.slotToken,
-					placement
+				publisher.set({
+					viewId: grant.viewId,
+					placement,
+					layer: 0,
+					extra: { slotToken: token }
 				});
 			}
 		});
 		byViewId.set(grant.viewId, {
-			token: grant.slotToken,
+			token,
 			anchor
 		});
 	});
@@ -250,6 +329,7 @@ function createDeckLayoutClient(deps) {
 		unsub();
 		for (const { anchor } of byViewId.values()) anchor.dispose();
 		byViewId.clear();
+		publisher.dispose();
 	} };
 }
 //#endregion
@@ -305,6 +385,6 @@ function parseMajor(version) {
 	return Number.isNaN(n) ? NaN : n;
 }
 //#endregion
-export { BRIDGE_PROTOCOL_VERSION, DEFAULT_BRIDGE_GLOBAL, DeckClientNotReadyError, DeckRemoteError, createDeckClient, createDeckLayoutClient, readBridgeFromGlobal };
+export { BRIDGE_PROTOCOL_VERSION, DEFAULT_BRIDGE_GLOBAL, DeckClientNotReadyError, DeckRemoteError, createDeckClient, createDeckLayoutClient, createPlacementPublisher, readBridgeFromGlobal };
 
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../view-anchor/src/view-anchor.ts","../../src/client/layout-client.ts","../../src/client/index.ts"],"sourcesContent":["import type {\n  Bounds,\n  Placement,\n  ViewAnchorOptions,\n  ViewAnchorHandle,\n} from './types.js'\n\nconst ZERO: Bounds = { x: 0, y: 0, width: 0, height: 0 }\n\n// Round to integers (setBounds rejects fractionals). Width/height are clamped\n// to ≥0 (negative area is meaningless and `0` is the canonical \"hidden\"\n// signal). x/y are NOT clamped: a position is a position — an anchored overlay\n// scrolled past the top/left edge has a legitimately NEGATIVE origin, and\n// flooring it to 0 would pin the native view at the edge instead of letting it\n// track its element off-screen. (Each consumer's IPC schema enforces its own\n// origin policy — the simulator's allows negative; the DevTools placeholder\n// never goes negative, so its NonNegInt schema is unaffected.)\nconst clampRect = (r: {\n  x: number\n  y: number\n  width: number\n  height: number\n}): Bounds => ({\n  x: Math.round(r.x),\n  y: Math.round(r.y),\n  width: Math.max(0, Math.round(r.width)),\n  height: Math.max(0, Math.round(r.height)),\n})\n\n/**\n * Create an anchor binding ONE native view's bounds to `target`'s geometry.\n *\n * Imperative core — no React, no Electron. Behaviour:\n *   - `present === true`: publish `target.getBoundingClientRect()` (x/y rounded,\n *     width/height `Math.max(0, Math.round(...))`) immediately, then re-publish\n *     SYNCHRONOUSLY on every `ResizeObserver` tick and window `resize`.\n *   - `present === false`: publish `{0,0,0,0}` immediately; do not observe.\n *   - `update(opts)`: re-apply synchronously.\n *   - `dispose()`: stop observing, never publish again.\n *\n * Synchronous, NOT RAF-deferred: the native overlay is a cross-process\n * `WebContentsView` whose `setBounds` already lands ~1 compositor frame behind\n * the renderer's DOM paint (the two processes composite on different frames).\n * Deferring the measure+publish to a RAF stacked a SECOND frame on top — during\n * a height/splitter drag that read as the overlay visibly trailing the region\n * edge (worst when GROWING, where the not-yet-followed edge exposes background).\n * Publishing in the observer tick itself removes that self-inflicted frame and\n * leaves only the unavoidable cross-process frame (masked by matching the\n * placeholder/desk background colour). The anti-flood role the RAF used to play\n * — collapsing a burst of RO+resize ticks in one frame into one publish — is now\n * served by `lastPublished` dedup: a tick whose measured rect is byte-identical\n * to the last published one is dropped, so a continuous drag still emits at most\n * one publish per distinct rect.\n *\n * Teardown safety: there is no queued frame to outrun a state change — every\n * emit reads `disposed`/`present` synchronously, so a tick after\n * `update`/`dispose` can never write a stale rect over the live one.\n */\nexport function createViewAnchor(\n  target: HTMLElement,\n  opts: ViewAnchorOptions,\n): ViewAnchorHandle {\n  let present = opts.present\n  let publish = opts.publish\n  let observer: ResizeObserver | null = null\n  // The last rect handed to `publish`, for dedup-coalescing (see header). Reset\n  // to `null` on every `apply()` so a state change (e.g. zoom, which rides in\n  // the `publish` closure, not in `Bounds`) always forces one fresh publish\n  // even when the geometry is unchanged.\n  let lastPublished: Bounds | null = null\n  let disposed = false\n\n  const measure = (): Bounds => {\n    const r = target.getBoundingClientRect()\n    return clampRect({ x: r.left, y: r.top, width: r.width, height: r.height })\n  }\n\n  const sameRect = (a: Bounds, b: Bounds): boolean =>\n    a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height\n\n  // Measure + publish SYNCHRONOUSLY on the triggering tick — no RAF defer (see\n  // header for why). Bail if torn down or detached, and dedup a rect\n  // byte-identical to the last published one (collapses a same-frame RO+resize\n  // burst, and a steady drag that re-fires the same final rect, into one).\n  const emit = (): void => {\n    if (disposed || !present) return\n    const m = measure()\n    if (lastPublished && sameRect(lastPublished, m)) return\n    lastPublished = m\n    publish(m)\n  }\n\n  const startObserving = (): void => {\n    if (observer) return\n    observer = new ResizeObserver(emit)\n    observer.observe(target)\n    window.addEventListener('resize', emit)\n  }\n\n  const stopObserving = (): void => {\n    if (observer) {\n      observer.disconnect()\n      observer = null\n    }\n    window.removeEventListener('resize', emit)\n  }\n\n  // Apply the current (present, publish) synchronously. Reset `lastPublished`\n  // first so the publish below is never dedup-skipped — a state change (zoom,\n  // present flip, new publish target) must always re-emit even if the geometry\n  // is byte-identical to the previous emit.\n  const apply = (): void => {\n    lastPublished = null\n    if (present) {\n      startObserving()\n      lastPublished = measure()\n      publish(lastPublished)\n    } else {\n      stopObserving()\n      publish(ZERO)\n    }\n  }\n\n  apply()\n\n  return {\n    update(next: ViewAnchorOptions): void {\n      if (disposed) return\n      publish = next.publish\n      present = next.present\n      apply()\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      stopObserving()\n    },\n  }\n}\n\n// ── Explicit Placement API ────────────────────────────────────────────\n//\n// The modern surface that replaces the magic-`{0,0,0,0}` \"hidden\" value.\n// Visibility is an explicit discriminant, NEVER inferred from geometry — a\n// real 0×0-but-on-screen view is `{ visible:true, bounds:{...,width:0} }`\n// and a hidden one is `{ visible:false }` (no `bounds`). See `Placement`.\n\nexport interface PlacementAnchorOptions {\n  /**\n   * Caller's INTENT: should the native view be on-screen? `true` →\n   * publish the measured rect as `{ visible:true, bounds }`; `false` →\n   * publish `{ visible:false }`. Crucially, hiddenness comes from this\n   * flag, not from a measured zero size — so a legitimately 0-sized but\n   * visible target still publishes `visible:true`.\n   */\n  visible: boolean\n  /** Receives each explicit Placement. Owns IPC → host. */\n  publish: (placement: Placement) => void\n  /**\n   * Opt-in geometry detach. When true, a measured zero-area target (no\n   * geometry box — display:none / unmounted / unstable first layout) publishes\n   * `{ visible:false }` (detach-but-keep) instead of `{ visible:true,\n   * bounds:0×0 }`, and an IntersectionObserver is attached so a display:none\n   * transition (which ResizeObserver does not report) re-publishes. Default\n   * false keeps the legitimate 0×0-visible semantics.\n   */\n  guardDisplayNone?: boolean\n  /**\n   * Opt-in capture-phase ancestor-scroll follow. When true, the anchor\n   * listens for `scroll` on `window` in the CAPTURE phase (scroll events don't\n   * bubble, but reach `window` while capturing), so an ancestor scroll\n   * container scrolling the target re-measures and re-publishes. With\n   * `followGeometry` off, the scroll callback does a single synchronous\n   * `emit()`; with it on, the scroll OPENS the RAF sentinel window so the\n   * follow tracks every frame of a scroll burst. Default false.\n   */\n  followScroll?: boolean\n  /**\n   * Opt-in windowed RAF geometry sentinel. Catches ancestor\n   * transform / reflow moves that no DOM event reports. The sentinel is\n   * NON-resident: it is OPENED on demand (a scroll burst, a `[role=\"separator\"]`\n   * splitter pointerdown, or an explicit `pulse()`), polls geometry once per\n   * animation frame publishing IN-FRAME, and AUTO-CLOSES once the rect goes\n   * steady (a few unchanged frames). While closed it schedules no frame, so the\n   * static cost when idle is exactly zero. Default false.\n   */\n  followGeometry?: boolean\n}\n\nexport interface PlacementAnchorHandle {\n  /** Apply new options; re-publishes immediately (mirrors `createViewAnchor`). */\n  update(opts: PlacementAnchorOptions): void\n  /** Stop observing; never publish again. */\n  dispose(): void\n  /**\n   * Open the RAF sentinel window (animation follow); auto-closes after going\n   * steady or after `durationMs`. No-op when `followGeometry` is false.\n   */\n  pulse(durationMs?: number): void\n}\n\n/**\n * Pure measure: read `target`'s rect and wrap it as an explicit visible\n * Placement. Always `{ visible:true }` — hiddenness is a caller decision\n * (see `createPlacementAnchor`), so this never returns `{ visible:false }`\n * and never infers visibility from a 0 size. A collapsed (0×0) but present\n * element therefore yields `{ visible:true, bounds:{...,width:0,height:0} }`,\n * distinct from any hidden Placement.\n */\nexport function measurePlacement(target: HTMLElement): Placement {\n  const r = target.getBoundingClientRect()\n  return {\n    visible: true,\n    bounds: clampRect({ x: r.left, y: r.top, width: r.width, height: r.height }),\n  }\n}\n\nconst samePlacement = (a: Placement, b: Placement): boolean => {\n  // Discriminant-aware dedup: a visibility flip is always a change, even when\n  // the geometry would otherwise look identical.\n  if (a.visible !== b.visible) return false\n  if (a.visible && b.visible) {\n    return (\n      a.bounds.x === b.bounds.x &&\n      a.bounds.y === b.bounds.y &&\n      a.bounds.width === b.bounds.width &&\n      a.bounds.height === b.bounds.height\n    )\n  }\n  return true\n}\n\n/**\n * The explicit-Placement mirror of `createViewAnchor`. Same observer/dedup/\n * teardown machinery, but the sink receives a `Placement`:\n *   - `visible === true`  → publish `measurePlacement(target)` and re-publish\n *     SYNCHRONOUSLY on every `ResizeObserver`/`resize` tick.\n *   - `visible === false` → publish `{ visible:false }` (NOT a ZERO bounds);\n *     do not observe.\n *\n * Dedup carries the discriminant (`samePlacement`), so a visibility flip is\n * never coalesced away.\n *\n * Opt-in `guardDisplayNone` (default false): when on, a measured zero-area\n * target (display:none / unmounted / unstable first layout) publishes\n * `{ visible:false }` instead of `{ visible:true, bounds:0×0 }`, and an\n * IntersectionObserver is attached so a display:none transition (which\n * ResizeObserver does not report) re-publishes.\n */\nexport function createPlacementAnchor(\n  target: HTMLElement,\n  opts: PlacementAnchorOptions,\n): PlacementAnchorHandle {\n  let visible = opts.visible\n  let publish = opts.publish\n  const guardDisplayNone = opts.guardDisplayNone ?? false\n  // Captured at creation; the follow options are never re-set via update().\n  const followScroll = opts.followScroll ?? false\n  const followGeometry = opts.followGeometry ?? false\n  let observer: ResizeObserver | null = null\n  let io: IntersectionObserver | null = null\n  let lastPublished: Placement | null = null\n  let disposed = false\n\n  // ── Windowed RAF geometry sentinel state ──────────────────\n  // The sentinel is a windowed poll, opened on demand and auto-closing once\n  // the geometry goes steady. It publishes IN-FRAME (no nested defer): each\n  // frame measures, and either publishes a changed rect synchronously or\n  // counts toward the steady-close threshold. While closed `rafId` is null\n  // and no frame is scheduled — zero static cost when idle.\n  let rafId: number | null = null\n  let steadyFrames = 0\n  const STEADY_CLOSE_FRAMES = 2\n  // True while a [role=\"separator\"] splitter drag is in progress: set on the\n  // capture-phase pointerdown that opened the window, cleared on pointerup.\n  // A held pointer means the drag may still resume after a static pause, so a\n  // steady run while held must NOT close the sentinel — it only closes once the\n  // pointer is released. Without this gate a press that pauses a couple of\n  // frames before the drag actually moves would close mid-press and drop the\n  // entire subsequent drag.\n  let pointerHeld = false\n  // Absolute time (performance.now()) past which a `pulse(durationMs)` window\n  // force-closes even if the geometry is still changing — the upper bound that\n  // prevents a perpetually-animating target from keeping the sentinel resident.\n  // null = no time bound (scroll/splitter opens rely on steady-close instead).\n  let sentinelDeadline: number | null = null\n\n  // Measure the target, applying the opt-in first-frame / display:none guard:\n  // a zero-area box (no geometry to anchor) becomes a detach instead of a\n  // 0×0-visible Placement. Default off → byte-for-byte the plain measure.\n  const computePlacement = (): Placement => {\n    const p = measurePlacement(target)\n    if (\n      guardDisplayNone &&\n      p.visible &&\n      (p.bounds.width === 0 || p.bounds.height === 0)\n    ) {\n      return { visible: false }\n    }\n    return p\n  }\n\n  const emit = (): void => {\n    if (disposed || !visible) return\n    const p = computePlacement()\n    if (lastPublished && samePlacement(lastPublished, p)) return\n    lastPublished = p\n    publish(p)\n  }\n\n  // One sentinel frame: measure, publish-in-frame if changed, else count toward\n  // the steady-close threshold. A changed frame re-arms; a steady frame re-arms\n  // until STEADY_CLOSE_FRAMES consecutive unchanged frames, then closes (no\n  // re-arm). Reads `disposed`/`visible` live so a frame outliving teardown is\n  // inert.\n  const sentinelFrame = (): void => {\n    rafId = null\n    if (disposed || !visible) {\n      sentinelDeadline = null\n      return\n    }\n    // Upper bound: a pulse window past its deadline closes regardless of\n    // motion, so a target that changes every frame can't keep the sentinel alive.\n    if (sentinelDeadline !== null && performance.now() >= sentinelDeadline) {\n      sentinelDeadline = null\n      return // duration elapsed → close (no re-arm)\n    }\n    const p = computePlacement()\n    if (lastPublished && samePlacement(lastPublished, p)) {\n      steadyFrames++\n      // Steady-close only fires once the pointer is RELEASED: while a\n      // splitter drag is held, a static pause is a hesitation, not the end of\n      // the drag, so we keep polling (re-arm below) and let `steadyFrames`\n      // accrue — it converges to a close within N frames after pointerup.\n      if (steadyFrames >= STEADY_CLOSE_FRAMES && !pointerHeld) {\n        sentinelDeadline = null\n        return // steady (and released) → close\n      }\n    } else {\n      lastPublished = p\n      publish(p) // publish synchronously in THIS frame\n      steadyFrames = 0\n    }\n    // `publish` may have synchronously disposed (or hidden) the anchor; re-read\n    // live state so a re-entrant teardown leaves ZERO scheduled frames.\n    if (!disposed && visible) {\n      rafId = requestAnimationFrame(sentinelFrame) // keep polling\n    } else {\n      sentinelDeadline = null\n    }\n  }\n\n  const openSentinel = (): void => {\n    if (!followGeometry || disposed) return\n    steadyFrames = 0\n    if (rafId === null) rafId = requestAnimationFrame(sentinelFrame)\n  }\n\n  const closeSentinel = (): void => {\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId)\n      rafId = null\n    }\n    steadyFrames = 0\n    sentinelDeadline = null\n    pointerHeld = false\n  }\n\n  // An ancestor scroll moved the target's screen rect. With the sentinel on,\n  // open the window so the whole scroll burst is followed frame-by-frame;\n  // without it, a single synchronous emit() follows the new rect.\n  const onScroll = (): void => {\n    if (followGeometry) openSentinel()\n    else emit()\n  }\n\n  // A capture-phase pointerdown on a [role=\"separator\"] splitter handle marks\n  // the start of a drag that moves the target via ancestor reflow (no RO tick)\n  // → open the sentinel.\n  const onPointerDown = (e: Event): void => {\n    const t = e.target as Element | null\n    if (t && t.closest && t.closest('[role=\"separator\"]')) {\n      pointerHeld = true\n      openSentinel()\n    }\n  }\n\n  // Pointer released: the drag is over, so a steady run may now close the\n  // sentinel. Re-open it (a no-op if already polling) so the steady-close\n  // threshold is reached even if the geometry was already static at release.\n  const onPointerUp = (): void => {\n    if (!pointerHeld) return\n    pointerHeld = false\n    openSentinel()\n  }\n\n  const startObserving = (): void => {\n    if (observer) return\n    observer = new ResizeObserver(emit)\n    observer.observe(target)\n    window.addEventListener('resize', emit)\n    // A display:none transition is invisible to ResizeObserver; an\n    // IntersectionObserver re-fires `emit`, which re-measures via\n    // `computePlacement` (now-zero box → detach, restored box → visible).\n    if (guardDisplayNone && typeof IntersectionObserver !== 'undefined') {\n      io = new IntersectionObserver(emit)\n      io.observe(target)\n    }\n    if (followScroll) {\n      window.addEventListener('scroll', onScroll, {\n        capture: true,\n        passive: true,\n      })\n    }\n    if (followGeometry) {\n      window.addEventListener('pointerdown', onPointerDown, { capture: true })\n      window.addEventListener('pointerup', onPointerUp, { capture: true })\n    }\n  }\n\n  const stopObserving = (): void => {\n    if (observer) {\n      observer.disconnect()\n      observer = null\n    }\n    if (io) {\n      io.disconnect()\n      io = null\n    }\n    window.removeEventListener('resize', emit)\n    window.removeEventListener('scroll', onScroll, {\n      capture: true,\n    } as EventListenerOptions)\n    window.removeEventListener('pointerdown', onPointerDown, {\n      capture: true,\n    } as EventListenerOptions)\n    window.removeEventListener('pointerup', onPointerUp, {\n      capture: true,\n    } as EventListenerOptions)\n    closeSentinel()\n  }\n\n  const apply = (): void => {\n    lastPublished = null\n    if (visible) {\n      startObserving()\n      lastPublished = computePlacement()\n      publish(lastPublished)\n    } else {\n      stopObserving()\n      const hidden: Placement = { visible: false }\n      lastPublished = hidden\n      publish(hidden)\n    }\n  }\n\n  apply()\n\n  return {\n    update(next: PlacementAnchorOptions): void {\n      if (disposed) return\n      publish = next.publish\n      visible = next.visible\n      apply()\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      stopObserving()\n    },\n    pulse(durationMs?: number): void {\n      // Imperative window open: start the animation-follow window. It\n      // closes on steady (N=2 unchanged frames) OR, when `durationMs` is given,\n      // at that deadline — whichever comes first. The deadline is the upper bound\n      // that guarantees a still-animating target cannot keep the sentinel\n      // resident; without it, only steady-close applies.\n      if (disposed || !followGeometry) return\n      if (durationMs !== undefined && durationMs > 0) {\n        const next = performance.now() + durationMs\n        // Extend (never shorten) an existing window's deadline.\n        sentinelDeadline = sentinelDeadline === null ? next : Math.max(sentinelDeadline, next)\n      }\n      openSentinel()\n    },\n  }\n}\n","import { createPlacementAnchor } from '@dimina-kit/view-anchor'\nimport type { Placement } from '@dimina-kit/view-anchor'\n\n/** One main→renderer slot grant: a native view (`viewId`) wants to follow the\n *  DOM slot `slotId`; `slotToken` is the capability the renderer threads back on\n *  every `place` so main can match a placement to the granted slot. */\nexport interface SlotGrant {\n\tviewId: string\n\tslotId: string\n\tslotToken: string\n}\n\n/** The renderer-side transport for the slot-token handshake. `onSlotGrant`\n *  registers the grant listener (returns an unsubscribe); `subscribe` asks main\n *  to (re)play buffered grants AFTER the listener is attached; `sendPlace`\n *  forwards a measured placement carrying its slot's token. */\nexport interface LayoutBridge {\n\tonSlotGrant(cb: (grant: SlotGrant) => void): () => void\n\tsendPlace(msg: { slotToken: string; placement: Placement }): void\n\tsubscribe(): void\n}\n\nexport interface LayoutClientDeps {\n\tbridge: LayoutBridge\n\t/** Resolve a grant's `slotId` to its DOM element. Default:\n\t *  `document.querySelector(slotId)`. Returns `null` when the slot is not\n\t *  mounted (graceful no-op). */\n\tresolveSlot?(slotId: string): HTMLElement | null\n\t/** Anchor factory. Default: view-anchor's `createPlacementAnchor`. Injected\n\t *  in tests to capture `(target, opts)` without real RO/IO/RAF. */\n\tcreateAnchor?: (\n\t\ttarget: HTMLElement,\n\t\topts: {\n\t\t\tvisible: boolean\n\t\t\tpublish: (p: Placement) => void\n\t\t\tfollowScroll?: boolean\n\t\t\tfollowGeometry?: boolean\n\t\t\tguardDisplayNone?: boolean\n\t\t},\n\t) => { dispose(): void }\n}\n\n/**\n * Renderer half of the slot-token handshake (capability-and-lifecycle.md「原子下发握手协议」). Subscribes to main's\n * `slot-grant` pushes FIRST (so a grant replayed synchronously by `subscribe()`\n * cannot be missed), then on each grant anchors the granted DOM slot with this\n * session's hardening opts (followScroll / followGeometry / guardDisplayNone)\n * and threads each measured `Placement` back to main as a `place` carrying that\n * grant's `slotToken`.\n */\nexport function createDeckLayoutClient(deps: LayoutClientDeps): {\n\tdispose(): void\n} {\n\tconst resolveSlot =\n\t\tdeps.resolveSlot ??\n\t\t((id: string): HTMLElement | null => document.querySelector(id))\n\tconst createAnchor = deps.createAnchor ?? createPlacementAnchor\n\n  // One live anchor per `viewId`. Main intentionally re-delivers a grant on\n  // per-wc replay, so we dedup: a same-token replay is a no-op (keep the live\n  // anchor); a new token for an existing `viewId` replaces it (dispose old,\n  // create new). The map holds only CURRENTLY-LIVE anchors — a replaced anchor\n  // is disposed at replacement time and removed, so `dispose()` never\n  // double-disposes it.\n  const byViewId = new Map<string, { token: string; anchor: { dispose(): void } }>()\n  let disposed = false\n\n  // Register the grant listener BEFORE requesting replay (handshake):\n  // a grant the main side replays synchronously inside `subscribe()` must find\n  // the listener already attached.\n  const unsub = deps.bridge.onSlotGrant((grant) => {\n    if (disposed) return\n    const existing = byViewId.get(grant.viewId)\n    // Same viewId+token re-delivered (per-wc replay) → pure no-op: keep the\n    // live anchor, do not create a second, do not dispose the first.\n    if (existing && existing.token === grant.slotToken) return\n    // A new token for this viewId → REVOKE the stale anchor FIRST:\n    // dispose + drop it BEFORE resolving the new slot, so a stale\n    // anchor can never keep publishing a revoked token even when the new slot\n    // isn't mounted yet. Deleting before `createAnchor` also means a throw in\n    // `createAnchor` can't leave an already-disposed anchor in the map (which a\n    // later `dispose()` would double-dispose).\n    if (existing) {\n      // try/finally: the `delete` MUST run even if the old\n      // anchor's dispose throws — otherwise the disposed-but-still-mapped anchor\n      // keeps publishing the revoked token AND a later client.dispose() would\n      // dispose it a second time.\n      try {\n        existing.anchor.dispose()\n      }\n      finally {\n        byViewId.delete(grant.viewId)\n      }\n    }\n    const el = resolveSlot(grant.slotId)\n    if (!el) return // new slot not mounted → graceful no-op; old anchor already revoked\n    const anchor = createAnchor(el, {\n      visible: true,\n      followScroll: true,\n      followGeometry: true,\n      guardDisplayNone: true,\n      // Capture THIS grant's slotToken in the closure so each anchor publishes\n      // to its own token (no cross-talk between slots).\n      publish: (placement) => {\n        deps.bridge.sendPlace({ slotToken: grant.slotToken, placement })\n      },\n    })\n    byViewId.set(grant.viewId, { token: grant.slotToken, anchor })\n  })\n\n  // Request replay AFTER the listener is attached.\n  deps.bridge.subscribe()\n\n  return {\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      unsub()\n      for (const { anchor } of byViewId.values()) anchor.dispose()\n      byViewId.clear()\n    },\n  }\n}\n","import {\n\tDeckClientNotReadyError,\n\tDeckRemoteError,\n} from '../errors.js'\nimport {\n\tBRIDGE_PROTOCOL_VERSION,\n\tDEFAULT_BRIDGE_GLOBAL,\n} from '../shared/protocol.js'\nimport type { EventEnvelope, DeckBridge } from '../shared/protocol.js'\nimport type { Disposable, HostEvent, JsonValue } from '../types.js'\n\nexport { DeckClientNotReadyError, DeckRemoteError }\n\nexport { createDeckLayoutClient } from './layout-client.js'\nexport type {\n\tSlotGrant,\n\tLayoutBridge,\n\tLayoutClientDeps,\n} from './layout-client.js'\n\nexport interface CreateDeckClientOptions {\n\t/** 默认 `__electronDeckBridge`；必须与 host preload 对齐 */\n\treadonly globalName?: string\n}\n\n// HS / EV 使用 `any` 而非 `JsonValue[]` 约束：\n// (1) host 侧 HostServiceHandler 同样是 `(...args: any[]) => unknown`，两侧对称；\n// (2) JsonValue 索引签名挡掉常见 host 写法（`(p: { code: string }) => ...`），\n//     强迫 rest-only 签名时 `Parameters<HS[K]>` 推不出真实参数类型；\n// (3) Electron IPC 实际走 structured clone（非 JSON），原约束的\"前提\"本就错；\n// (4) 真要 runtime 校验，在 transport 边界用 `runtime.ipc.handle({ validator })`\n//     与 protocol envelope（`InvokeRequest.args: readonly JsonValue[]`）已经够。\nexport interface DeckClient<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tHS extends Record<keyof HS, (...args: any[]) => unknown>,\n\tEV extends readonly HostEvent<JsonValue>[],\n> {\n\tready(): Promise<void>\n\tinvoke<K extends keyof HS & string>(\n\t\tname: K,\n\t\t...args: Parameters<HS[K]>\n\t): Promise<Awaited<ReturnType<HS[K]>>>\n\ton<E extends EV[number]>(\n\t\tevent: E,\n\t\tlistener: (payload: E extends HostEvent<infer P> ? P : never) => void,\n\t): Disposable\n}\n\nexport function createDeckClient<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tHS extends Record<keyof HS, (...args: any[]) => unknown>,\n\tEV extends readonly HostEvent<JsonValue>[],\n>(options?: CreateDeckClientOptions): DeckClient<HS, EV> {\n\tconst globalName = options?.globalName ?? DEFAULT_BRIDGE_GLOBAL\n\n\tfunction getBridge(): DeckBridge {\n\t\tconst bridge = readBridgeFromGlobal(globalName)\n\t\tif (bridge === undefined) {\n\t\t\tthrow new DeckClientNotReadyError(\n\t\t\t\t`Deck framework bridge is missing on window[\"${globalName}\"] — did the host preload call exposeDeckBridge()?`,\n\t\t\t)\n\t\t}\n\t\treturn bridge\n\t}\n\n\treturn {\n\t\tasync ready(): Promise<void> {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst remoteMajor = parseMajor(bridge.version)\n\t\t\tconst localMajor = parseMajor(BRIDGE_PROTOCOL_VERSION)\n\t\t\tif (remoteMajor !== localMajor) {\n\t\t\t\tthrow new DeckClientNotReadyError(\n\t\t\t\t\t`Deck bridge protocol version mismatch: bridge=${String(bridge.version)}, client expected major ${localMajor}.x.x (${BRIDGE_PROTOCOL_VERSION})`,\n\t\t\t\t)\n\t\t\t}\n\t\t},\n\n\t\tasync invoke<K extends keyof HS & string>(\n\t\t\tname: K,\n\t\t\t...args: Parameters<HS[K]>\n\t\t): Promise<Awaited<ReturnType<HS[K]>>> {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst response = await bridge.invoke({\n\t\t\t\tkind: 'host',\n\t\t\t\tname,\n\t\t\t\targs: args as readonly JsonValue[],\n\t\t\t})\n\t\t\tif (response.ok) {\n\t\t\t\treturn response.result as Awaited<ReturnType<HS[K]>>\n\t\t\t}\n\t\t\tconst { remoteName, message, code } = response.error\n\t\t\tthrow new DeckRemoteError(remoteName, message, code)\n\t\t},\n\n\t\ton<E extends EV[number]>(\n\t\t\tevent: E,\n\t\t\tlistener: (payload: E extends HostEvent<infer P> ? P : never) => void,\n\t\t): Disposable {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst wrapped = (env: EventEnvelope): void => {\n\t\t\t\tif (env.name === event.name) {\n\t\t\t\t\tlistener(env.payload as E extends HostEvent<infer P> ? P : never)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst unsubscribe = bridge.onEvent(wrapped)\n\t\t\tlet disposed = false\n\t\t\treturn {\n\t\t\t\tdispose: () => {\n\t\t\t\t\tif (disposed) return\n\t\t\t\t\tdisposed = true\n\t\t\t\t\tunsubscribe()\n\t\t\t\t},\n\t\t\t}\n\t\t},\n\t}\n}\n\nexport function readBridgeFromGlobal(\n\tglobalName: string = DEFAULT_BRIDGE_GLOBAL,\n): DeckBridge | undefined {\n\tconst g = globalThis as unknown as Record<string, unknown>\n\tconst bridge = g[globalName]\n\tif (bridge === undefined || bridge === null) return undefined\n\treturn bridge as DeckBridge\n}\n\nfunction parseMajor(version: unknown): number {\n\tif (typeof version !== 'string') return Number.NaN\n\tconst head = version.split('.')[0] ?? ''\n\tconst n = Number.parseInt(head, 10)\n\treturn Number.isNaN(n) ? Number.NaN : n\n}\n\nexport { BRIDGE_PROTOCOL_VERSION, DEFAULT_BRIDGE_GLOBAL }\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../view-anchor/src/view-anchor.ts","../../src/client/placement-publisher.ts","../../src/client/layout-client.ts","../../src/client/index.ts"],"sourcesContent":["import type {\n  Bounds,\n  Placement,\n  ViewAnchorOptions,\n  ViewAnchorHandle,\n} from './types.js'\n\nconst ZERO: Bounds = { x: 0, y: 0, width: 0, height: 0 }\n\n// Round to integers (setBounds rejects fractionals). Width/height are clamped\n// to ≥0 (negative area is meaningless and `0` is the canonical \"hidden\"\n// signal). x/y are NOT clamped: a position is a position — an anchored overlay\n// scrolled past the top/left edge has a legitimately NEGATIVE origin, and\n// flooring it to 0 would pin the native view at the edge instead of letting it\n// track its element off-screen. (Each consumer's IPC schema enforces its own\n// origin policy — the simulator's allows negative; the DevTools placeholder\n// never goes negative, so its NonNegInt schema is unaffected.)\nconst clampRect = (r: {\n  x: number\n  y: number\n  width: number\n  height: number\n}): Bounds => ({\n  x: Math.round(r.x),\n  y: Math.round(r.y),\n  width: Math.max(0, Math.round(r.width)),\n  height: Math.max(0, Math.round(r.height)),\n})\n\n/**\n * Create an anchor binding ONE native view's bounds to `target`'s geometry.\n *\n * Imperative core — no React, no Electron. Behaviour:\n *   - `present === true`: publish `target.getBoundingClientRect()` (x/y rounded,\n *     width/height `Math.max(0, Math.round(...))`) immediately, then re-publish\n *     SYNCHRONOUSLY on every `ResizeObserver` tick and window `resize`.\n *   - `present === false`: publish `{0,0,0,0}` immediately; do not observe.\n *   - `update(opts)`: re-apply synchronously.\n *   - `dispose()`: stop observing, never publish again.\n *\n * Synchronous, NOT RAF-deferred: the native overlay is a cross-process\n * `WebContentsView` whose `setBounds` already lands ~1 compositor frame behind\n * the renderer's DOM paint (the two processes composite on different frames).\n * Deferring the measure+publish to a RAF stacked a SECOND frame on top — during\n * a height/splitter drag that read as the overlay visibly trailing the region\n * edge (worst when GROWING, where the not-yet-followed edge exposes background).\n * Publishing in the observer tick itself removes that self-inflicted frame and\n * leaves only the unavoidable cross-process frame (masked by matching the\n * placeholder/desk background colour). The anti-flood role the RAF used to play\n * — collapsing a burst of RO+resize ticks in one frame into one publish — is now\n * served by `lastPublished` dedup: a tick whose measured rect is byte-identical\n * to the last published one is dropped, so a continuous drag still emits at most\n * one publish per distinct rect.\n *\n * Teardown safety: there is no queued frame to outrun a state change — every\n * emit reads `disposed`/`present` synchronously, so a tick after\n * `update`/`dispose` can never write a stale rect over the live one.\n */\nexport function createViewAnchor(\n  target: HTMLElement,\n  opts: ViewAnchorOptions,\n): ViewAnchorHandle {\n  let present = opts.present\n  let publish = opts.publish\n  let observer: ResizeObserver | null = null\n  // The last rect handed to `publish`, for dedup-coalescing (see header). Reset\n  // to `null` on every `apply()` so a state change (e.g. zoom, which rides in\n  // the `publish` closure, not in `Bounds`) always forces one fresh publish\n  // even when the geometry is unchanged.\n  let lastPublished: Bounds | null = null\n  let disposed = false\n\n  const measure = (): Bounds => {\n    const r = target.getBoundingClientRect()\n    return clampRect({ x: r.left, y: r.top, width: r.width, height: r.height })\n  }\n\n  const sameRect = (a: Bounds, b: Bounds): boolean =>\n    a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height\n\n  // Measure + publish SYNCHRONOUSLY on the triggering tick — no RAF defer (see\n  // header for why). Bail if torn down or detached, and dedup a rect\n  // byte-identical to the last published one (collapses a same-frame RO+resize\n  // burst, and a steady drag that re-fires the same final rect, into one).\n  const emit = (): void => {\n    if (disposed || !present) return\n    const m = measure()\n    if (lastPublished && sameRect(lastPublished, m)) return\n    lastPublished = m\n    publish(m)\n  }\n\n  const startObserving = (): void => {\n    if (observer) return\n    observer = new ResizeObserver(emit)\n    observer.observe(target)\n    window.addEventListener('resize', emit)\n  }\n\n  const stopObserving = (): void => {\n    if (observer) {\n      observer.disconnect()\n      observer = null\n    }\n    window.removeEventListener('resize', emit)\n  }\n\n  // Apply the current (present, publish) synchronously. Reset `lastPublished`\n  // first so the publish below is never dedup-skipped — a state change (zoom,\n  // present flip, new publish target) must always re-emit even if the geometry\n  // is byte-identical to the previous emit.\n  const apply = (): void => {\n    lastPublished = null\n    if (present) {\n      startObserving()\n      lastPublished = measure()\n      publish(lastPublished)\n    } else {\n      stopObserving()\n      publish(ZERO)\n    }\n  }\n\n  apply()\n\n  return {\n    update(next: ViewAnchorOptions): void {\n      if (disposed) return\n      publish = next.publish\n      present = next.present\n      apply()\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      stopObserving()\n    },\n  }\n}\n\n// ── Explicit Placement API ────────────────────────────────────────────\n//\n// The modern surface that replaces the magic-`{0,0,0,0}` \"hidden\" value.\n// Visibility is an explicit discriminant, NEVER inferred from geometry — a\n// real 0×0-but-on-screen view is `{ visible:true, bounds:{...,width:0} }`\n// and a hidden one is `{ visible:false }` (no `bounds`). See `Placement`.\n\nexport interface PlacementAnchorOptions {\n  /**\n   * Caller's INTENT: should the native view be on-screen? `true` →\n   * publish the measured rect as `{ visible:true, bounds }`; `false` →\n   * publish `{ visible:false }`. Crucially, hiddenness comes from this\n   * flag, not from a measured zero size — so a legitimately 0-sized but\n   * visible target still publishes `visible:true`.\n   */\n  visible: boolean\n  /** Receives each explicit Placement. Owns IPC → host. */\n  publish: (placement: Placement) => void\n  /**\n   * Opt-in geometry detach. When true, a measured zero-area target (no\n   * geometry box — display:none / unmounted / unstable first layout) publishes\n   * `{ visible:false }` (detach-but-keep) instead of `{ visible:true,\n   * bounds:0×0 }`, and an IntersectionObserver is attached so a display:none\n   * transition (which ResizeObserver does not report) re-publishes. Default\n   * false keeps the legitimate 0×0-visible semantics.\n   */\n  guardDisplayNone?: boolean\n  /**\n   * Opt-in capture-phase ancestor-scroll follow. When true, the anchor\n   * listens for `scroll` on `window` in the CAPTURE phase (scroll events don't\n   * bubble, but reach `window` while capturing), so an ancestor scroll\n   * container scrolling the target re-measures and re-publishes. With\n   * `followGeometry` off, the scroll callback does a single synchronous\n   * `emit()`; with it on, the scroll OPENS the RAF sentinel window so the\n   * follow tracks every frame of a scroll burst. Default false.\n   */\n  followScroll?: boolean\n  /**\n   * Opt-in windowed RAF geometry sentinel. Catches ancestor\n   * transform / reflow moves that no DOM event reports. The sentinel is\n   * NON-resident: it is OPENED on demand (a scroll burst, a `[role=\"separator\"]`\n   * splitter pointerdown, or an explicit `pulse()`), polls geometry once per\n   * animation frame publishing IN-FRAME, and AUTO-CLOSES once the rect goes\n   * steady (a few unchanged frames). While closed it schedules no frame, so the\n   * static cost when idle is exactly zero. Default false.\n   */\n  followGeometry?: boolean\n}\n\nexport interface PlacementAnchorHandle {\n  /** Apply new options; re-publishes immediately (mirrors `createViewAnchor`). */\n  update(opts: PlacementAnchorOptions): void\n  /** Stop observing; never publish again. */\n  dispose(): void\n  /**\n   * Open the RAF sentinel window (animation follow); auto-closes after going\n   * steady or after `durationMs`. No-op when `followGeometry` is false.\n   */\n  pulse(durationMs?: number): void\n}\n\n/**\n * Pure measure: read `target`'s rect and wrap it as an explicit visible\n * Placement. Always `{ visible:true }` — hiddenness is a caller decision\n * (see `createPlacementAnchor`), so this never returns `{ visible:false }`\n * and never infers visibility from a 0 size. A collapsed (0×0) but present\n * element therefore yields `{ visible:true, bounds:{...,width:0,height:0} }`,\n * distinct from any hidden Placement.\n */\nexport function measurePlacement(target: HTMLElement): Placement {\n  const r = target.getBoundingClientRect()\n  return {\n    visible: true,\n    bounds: clampRect({ x: r.left, y: r.top, width: r.width, height: r.height }),\n  }\n}\n\nconst samePlacement = (a: Placement, b: Placement): boolean => {\n  // Discriminant-aware dedup: a visibility flip is always a change, even when\n  // the geometry would otherwise look identical.\n  if (a.visible !== b.visible) return false\n  if (a.visible && b.visible) {\n    return (\n      a.bounds.x === b.bounds.x &&\n      a.bounds.y === b.bounds.y &&\n      a.bounds.width === b.bounds.width &&\n      a.bounds.height === b.bounds.height\n    )\n  }\n  return true\n}\n\n/**\n * The explicit-Placement mirror of `createViewAnchor`. Same observer/dedup/\n * teardown machinery, but the sink receives a `Placement`:\n *   - `visible === true`  → publish `measurePlacement(target)` and re-publish\n *     SYNCHRONOUSLY on every `ResizeObserver`/`resize` tick.\n *   - `visible === false` → publish `{ visible:false }` (NOT a ZERO bounds);\n *     do not observe.\n *\n * Dedup carries the discriminant (`samePlacement`), so a visibility flip is\n * never coalesced away.\n *\n * Opt-in `guardDisplayNone` (default false): when on, a measured zero-area\n * target (display:none / unmounted / unstable first layout) publishes\n * `{ visible:false }` instead of `{ visible:true, bounds:0×0 }`, and an\n * IntersectionObserver is attached so a display:none transition (which\n * ResizeObserver does not report) re-publishes.\n */\nexport function createPlacementAnchor(\n  target: HTMLElement,\n  opts: PlacementAnchorOptions,\n): PlacementAnchorHandle {\n  let visible = opts.visible\n  let publish = opts.publish\n  const guardDisplayNone = opts.guardDisplayNone ?? false\n  // Captured at creation; the follow options are never re-set via update().\n  const followScroll = opts.followScroll ?? false\n  const followGeometry = opts.followGeometry ?? false\n  let observer: ResizeObserver | null = null\n  let io: IntersectionObserver | null = null\n  let lastPublished: Placement | null = null\n  let disposed = false\n\n  // ── Windowed RAF geometry sentinel state ──────────────────\n  // The sentinel is a windowed poll, opened on demand and auto-closing once\n  // the geometry goes steady. It publishes IN-FRAME (no nested defer): each\n  // frame measures, and either publishes a changed rect synchronously or\n  // counts toward the steady-close threshold. While closed `rafId` is null\n  // and no frame is scheduled — zero static cost when idle.\n  let rafId: number | null = null\n  let steadyFrames = 0\n  const STEADY_CLOSE_FRAMES = 2\n  // Bounds hidden polls the sentinel FOLLOWS so a no-deadline window can't spin.\n  const MAX_HIDDEN_FOLLOW_FRAMES = 30\n  // True while a [role=\"separator\"] splitter drag is in progress: set on the\n  // capture-phase pointerdown that opened the window, cleared on pointerup.\n  // A held pointer means the drag may still resume after a static pause, so a\n  // steady run while held must NOT close the sentinel — it only closes once the\n  // pointer is released. Without this gate a press that pauses a couple of\n  // frames before the drag actually moves would close mid-press and drop the\n  // entire subsequent drag.\n  let pointerHeld = false\n  // Absolute time (performance.now()) past which a `pulse(durationMs)` window\n  // force-closes even if the geometry is still changing — the upper bound that\n  // prevents a perpetually-animating target from keeping the sentinel resident.\n  // null = no time bound (scroll/splitter opens rely on steady-close instead).\n  let sentinelDeadline: number | null = null\n\n  // Measure the target, applying the opt-in first-frame / display:none guard:\n  // a zero-area box (no geometry to anchor) becomes a detach instead of a\n  // 0×0-visible Placement. Default off → byte-for-byte the plain measure.\n  const computePlacement = (): Placement => {\n    const p = measurePlacement(target)\n    if (\n      guardDisplayNone &&\n      p.visible &&\n      (p.bounds.width === 0 || p.bounds.height === 0)\n    ) {\n      return { visible: false }\n    }\n    return p\n  }\n\n  const emit = (): void => {\n    if (disposed || !visible) return\n    const p = computePlacement()\n    if (lastPublished && samePlacement(lastPublished, p)) return\n    lastPublished = p\n    publish(p)\n  }\n\n  // Hidden sentinel poll → close (true) once RO/IO recorded the real hide or the\n  // bounded follow run elapsed, else keep following (false); never publishes.\n  const shouldCloseOnHiddenPoll = (): boolean => {\n    if (lastPublished?.visible === false) return true\n    return steadyFrames++ >= MAX_HIDDEN_FOLLOW_FRAMES\n  }\n\n  // One sentinel frame: measure, publish-in-frame if changed, else count toward\n  // the steady-close threshold. Reads `disposed`/`visible` live so a frame\n  // outliving teardown is inert.\n  const sentinelFrame = (): void => {\n    rafId = null\n    if (disposed || !visible) {\n      sentinelDeadline = null\n      return\n    }\n    // Upper bound: a pulse window past its deadline closes regardless of\n    // motion, so a target that changes every frame can't keep the sentinel alive.\n    if (sentinelDeadline !== null && performance.now() >= sentinelDeadline) {\n      sentinelDeadline = null\n      return // duration elapsed → close (no re-arm)\n    }\n    const p = computePlacement()\n    // The sentinel FOLLOWS visible geometry and NEVER publishes a detach — a\n    // hidden poll is a relayout transient to follow until restore (the fix).\n    if (!p.visible) {\n      if (shouldCloseOnHiddenPoll()) { sentinelDeadline = null; return }\n      rafId = requestAnimationFrame(sentinelFrame)\n      return\n    }\n    if (lastPublished && samePlacement(lastPublished, p)) {\n      steadyFrames++\n      // Steady-close only fires once the pointer is RELEASED: while a\n      // splitter drag is held, a static pause is a hesitation, not the end of\n      // the drag, so we keep polling (re-arm below) and let `steadyFrames`\n      // accrue — it converges to a close within N frames after pointerup.\n      if (steadyFrames >= STEADY_CLOSE_FRAMES && !pointerHeld) {\n        sentinelDeadline = null\n        return // steady (and released) → close\n      }\n    } else {\n      lastPublished = p\n      publish(p) // publish synchronously in THIS frame\n      steadyFrames = 0\n    }\n    // `publish` may have synchronously disposed (or hidden) the anchor; re-read\n    // live state so a re-entrant teardown leaves ZERO scheduled frames.\n    if (!disposed && visible) {\n      rafId = requestAnimationFrame(sentinelFrame) // keep polling\n    } else {\n      sentinelDeadline = null\n    }\n  }\n\n  const openSentinel = (): void => {\n    if (!followGeometry || disposed) return\n    steadyFrames = 0\n    if (rafId === null) rafId = requestAnimationFrame(sentinelFrame)\n  }\n\n  const closeSentinel = (): void => {\n    if (rafId !== null) {\n      cancelAnimationFrame(rafId)\n      rafId = null\n    }\n    steadyFrames = 0\n    sentinelDeadline = null\n    pointerHeld = false\n  }\n\n  // An ancestor scroll moved the target's screen rect. With the sentinel on,\n  // open the window so the whole scroll burst is followed frame-by-frame;\n  // without it, a single synchronous emit() follows the new rect.\n  const onScroll = (): void => {\n    if (followGeometry) openSentinel()\n    else emit()\n  }\n\n  // A capture-phase pointerdown on a [role=\"separator\"] splitter handle marks\n  // the start of a drag that moves the target via ancestor reflow (no RO tick)\n  // → open the sentinel.\n  const onPointerDown = (e: Event): void => {\n    const t = e.target as Element | null\n    if (t && t.closest && t.closest('[role=\"separator\"]')) {\n      pointerHeld = true\n      openSentinel()\n    }\n  }\n\n  // Pointer released: the drag is over, so a steady run may now close the\n  // sentinel. Re-open it (a no-op if already polling) so the steady-close\n  // threshold is reached even if the geometry was already static at release.\n  const onPointerUp = (): void => {\n    if (!pointerHeld) return\n    pointerHeld = false\n    openSentinel()\n  }\n\n  const startObserving = (): void => {\n    if (observer) return\n    observer = new ResizeObserver(emit)\n    observer.observe(target)\n    window.addEventListener('resize', emit)\n    // A display:none transition is invisible to ResizeObserver; an\n    // IntersectionObserver re-fires `emit`, which re-measures via\n    // `computePlacement` (now-zero box → detach, restored box → visible).\n    if (guardDisplayNone && typeof IntersectionObserver !== 'undefined') {\n      io = new IntersectionObserver(emit)\n      io.observe(target)\n    }\n    if (followScroll) {\n      window.addEventListener('scroll', onScroll, {\n        capture: true,\n        passive: true,\n      })\n    }\n    if (followGeometry) {\n      window.addEventListener('pointerdown', onPointerDown, { capture: true })\n      window.addEventListener('pointerup', onPointerUp, { capture: true })\n    }\n  }\n\n  const stopObserving = (): void => {\n    if (observer) {\n      observer.disconnect()\n      observer = null\n    }\n    if (io) {\n      io.disconnect()\n      io = null\n    }\n    window.removeEventListener('resize', emit)\n    window.removeEventListener('scroll', onScroll, {\n      capture: true,\n    } as EventListenerOptions)\n    window.removeEventListener('pointerdown', onPointerDown, {\n      capture: true,\n    } as EventListenerOptions)\n    window.removeEventListener('pointerup', onPointerUp, {\n      capture: true,\n    } as EventListenerOptions)\n    closeSentinel()\n  }\n\n  const apply = (): void => {\n    lastPublished = null\n    if (visible) {\n      startObserving()\n      lastPublished = computePlacement()\n      publish(lastPublished)\n    } else {\n      stopObserving()\n      const hidden: Placement = { visible: false }\n      lastPublished = hidden\n      publish(hidden)\n    }\n  }\n\n  apply()\n\n  return {\n    update(next: PlacementAnchorOptions): void {\n      if (disposed) return\n      publish = next.publish\n      visible = next.visible\n      apply()\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      stopObserving()\n    },\n    pulse(durationMs?: number): void {\n      // Imperative window open: start the animation-follow window. It\n      // closes on steady (N=2 unchanged frames) OR, when `durationMs` is given,\n      // at that deadline — whichever comes first. The deadline is the upper bound\n      // that guarantees a still-animating target cannot keep the sentinel\n      // resident; without it, only steady-close applies.\n      if (disposed || !followGeometry) return\n      if (durationMs !== undefined && durationMs > 0) {\n        const next = performance.now() + durationMs\n        // Extend (never shorten) an existing window's deadline.\n        sentinelDeadline = sentinelDeadline === null ? next : Math.max(sentinelDeadline, next)\n      }\n      openSentinel()\n    },\n  }\n}\n","import type { DesiredView, PlacementSnapshot } from '../layout/index.js'\n\n// Renderer-side single source of truth for native-view placement. Every anchor\n// writes its view's desired placement here instead of invoking IPC directly; a\n// central scheduler reads the WHOLE table once per animation frame and publishes\n// one window-level snapshot (a monotonic epoch shared by all views in the tick).\n//\n// Coalescing a level stream is safe: many set()/remove() calls in one frame\n// collapse to the latest level, so a transient (e.g. a relayout that momentarily\n// measures 0×0 then restores) is overwritten before it is ever published. This\n// is what a per-view edge stream cannot do — it is the producer half of the\n// reconcile design (see ../layout/placement-reconcile.ts).\n\nexport interface PlacementPublisherDeps<Extra = unknown> {\n  // Renderer lifetime id stamped on every snapshot; a fresh renderer uses a\n  // higher generation so the main reconciler resets its table. A function is\n  // re-read on EVERY flush, so a host whose generation is assigned by main (via a\n  // grant that can arrive after the publisher is created) can hand a getter and\n  // have later snapshots pick up the newer value.\n  generation: number | (() => number)\n  publish: (snapshot: PlacementSnapshot<Extra>) => void\n  // Injectable for tests; default to requestAnimationFrame / cancelAnimationFrame.\n  requestFrame?: (cb: () => void) => number\n  cancelFrame?: (id: number) => void\n}\n\nexport interface PlacementPublisher<Extra = unknown> {\n  // Upsert one view's desired placement and schedule a coalesced publish.\n  set(view: DesiredView<Extra>): void\n  // Drop a view from the desired table and schedule a coalesced publish.\n  remove(viewId: string): void\n  dispose(): void\n}\n\nexport function createPlacementPublisher<Extra = unknown>(\n  deps: PlacementPublisherDeps<Extra>,\n): PlacementPublisher<Extra> {\n  const requestFrame =\n    deps.requestFrame ?? ((cb: () => void): number => requestAnimationFrame(cb))\n  const cancelFrame = deps.cancelFrame ?? ((id: number): void => cancelAnimationFrame(id))\n  const readGeneration =\n    typeof deps.generation === 'function' ? deps.generation : (): number => deps.generation as number\n\n  const views = new Map<string, DesiredView<Extra>>()\n  let dirty = false\n  let frameId: number | null = null\n  let epoch = 0\n  let disposed = false\n\n  function schedule(): void {\n    if (disposed || frameId !== null) return\n    frameId = requestFrame(flush)\n  }\n\n  function flush(): void {\n    frameId = null\n    // A frame that fires with nothing dirty (or after dispose) publishes\n    // nothing — coalescing means only a real change reaches the wire.\n    if (disposed || !dirty) return\n    dirty = false\n    deps.publish({\n      generation: readGeneration(),\n      epoch: epoch++,\n      views: [...views.values()],\n    })\n  }\n\n  return {\n    set(view: DesiredView<Extra>): void {\n      if (disposed) return\n      views.set(view.viewId, view)\n      dirty = true\n      schedule()\n    },\n    remove(viewId: string): void {\n      if (disposed) return\n      // Removing an absent id is not a change — don't arm a redundant frame.\n      if (!views.delete(viewId)) return\n      dirty = true\n      schedule()\n    },\n    dispose(): void {\n      if (disposed) return\n      disposed = true\n      if (frameId !== null) {\n        cancelFrame(frameId)\n        frameId = null\n      }\n    },\n  }\n}\n","import { createPlacementAnchor } from '@dimina-kit/view-anchor'\nimport type { Placement } from '@dimina-kit/view-anchor'\nimport { createPlacementPublisher } from './placement-publisher.js'\nimport type { PlacementSnapshot } from '../layout/index.js'\n\n/** Per-view host extra threaded on every DesiredView: the slot's capability\n *  token. Main derives the view's identity + z-order from this token (never from\n *  the renderer-reported viewId), so a valid token can't be spliced onto a forged\n *  viewId. */\nexport interface SlotExtra {\n\tslotToken: string\n}\n\n/** One main→renderer slot grant: a native view (`viewId`) wants to follow the\n *  DOM slot `slotId`; `slotToken` is the capability the renderer threads back\n *  (as a per-view extra) so main can match a placement to the granted slot.\n *  `generation` is a main-assigned, strictly-monotonic-per-wc renderer-lifetime\n *  id: it is stamped onto every published snapshot so a reload (new grants at a\n *  higher generation) resets main's reconciler regardless of IPC ordering. */\nexport interface SlotGrant {\n\tviewId: string\n\tslotId: string\n\tslotToken: string\n\tgeneration: number\n}\n\n/** The renderer-side transport for the slot-token handshake. `onSlotGrant`\n *  registers the grant listener (returns an unsubscribe); `subscribe` asks main\n *  to (re)play buffered grants AFTER the listener is attached; `sendSnapshot`\n *  forwards the whole window-level desired-placement table (one coalesced frame),\n *  each view carrying its slot's token as an extra. */\nexport interface LayoutBridge {\n\tonSlotGrant(cb: (grant: SlotGrant) => void): () => void\n\tsendSnapshot(snapshot: PlacementSnapshot<SlotExtra>): void\n\tsubscribe(): void\n}\n\nexport interface LayoutClientDeps {\n\tbridge: LayoutBridge\n\t/** Resolve a grant's `slotId` to its DOM element. Default:\n\t *  `document.querySelector(slotId)`. Returns `null` when the slot is not\n\t *  mounted (graceful no-op). */\n\tresolveSlot?(slotId: string): HTMLElement | null\n\t/** Anchor factory. Default: view-anchor's `createPlacementAnchor`. Injected\n\t *  in tests to capture `(target, opts)` without real RO/IO/RAF. */\n\tcreateAnchor?: (\n\t\ttarget: HTMLElement,\n\t\topts: {\n\t\t\tvisible: boolean\n\t\t\tpublish: (p: Placement) => void\n\t\t\tfollowScroll?: boolean\n\t\t\tfollowGeometry?: boolean\n\t\t\tguardDisplayNone?: boolean\n\t\t},\n\t) => { dispose(): void }\n\t/** Frame scheduler for the internal placement publisher. Default:\n\t *  requestAnimationFrame / cancelAnimationFrame. Injected in tests to drive\n\t *  coalesced publishes deterministically. */\n\trequestFrame?: (cb: () => void) => number\n\tcancelFrame?: (id: number) => void\n}\n\n/**\n * Renderer half of the slot-token handshake. Subscribes to main's `slot-grant`\n * pushes FIRST (so a grant replayed synchronously by `subscribe()` cannot be\n * missed), then on each grant anchors the granted DOM slot with this session's\n * hardening opts (followScroll / followGeometry / guardDisplayNone). Each anchor's\n * measured `Placement` is written into a CENTRAL placement publisher keyed by\n * `viewId` — NOT sent per-view. The publisher coalesces every anchor's writes into\n * ONE window-level snapshot per animation frame, so a transient relayout that\n * momentarily measures 0×0 is overwritten before it is ever published. This is the\n * producer half of the level-triggered reconcile design (see\n * ../layout/placement-reconcile.ts); a per-view edge stream cannot self-correct a\n * lost or spurious frame, which is what caused a stuck detached (white-screen)\n * view.\n */\nexport function createDeckLayoutClient(deps: LayoutClientDeps): {\n\tdispose(): void\n} {\n\tconst resolveSlot =\n\t\tdeps.resolveSlot ??\n\t\t((id: string): HTMLElement | null => document.querySelector(id))\n\tconst createAnchor = deps.createAnchor ?? createPlacementAnchor\n\n\t// Max generation seen across all grants. Main assigns strictly-monotonic\n\t// generations, so taking the max means a reload's higher-generation grants\n\t// bump every subsequent snapshot's generation → main's reconciler resets.\n\tlet maxGeneration = 0\n\n\t// Central publisher: every anchor writes its view's desired placement here; the\n\t// publisher reads the whole table once per frame and publishes one snapshot.\n\tconst publisher = createPlacementPublisher<SlotExtra>({\n\t\tgeneration: () => maxGeneration,\n\t\tpublish: snapshot => deps.bridge.sendSnapshot(snapshot),\n\t\trequestFrame: deps.requestFrame,\n\t\tcancelFrame: deps.cancelFrame,\n\t})\n\n\t// One live anchor per `viewId`. Main intentionally re-delivers a grant on\n\t// per-wc replay, so we dedup: a same-token replay is a no-op (keep the live\n\t// anchor); a new token for an existing `viewId` replaces it (dispose old,\n\t// create new). The map holds only CURRENTLY-LIVE anchors — a replaced anchor\n\t// is disposed at replacement time and removed, so `dispose()` never\n\t// double-disposes it.\n\tconst byViewId = new Map<string, { token: string; anchor: { dispose(): void } }>()\n\tlet disposed = false\n\n\t// Register the grant listener BEFORE requesting replay (handshake):\n\t// a grant the main side replays synchronously inside `subscribe()` must find\n\t// the listener already attached.\n\tconst unsub = deps.bridge.onSlotGrant((grant) => {\n\t\tif (disposed) return\n\t\tif (grant.generation > maxGeneration) maxGeneration = grant.generation\n\t\tconst existing = byViewId.get(grant.viewId)\n\t\t// Same viewId+token re-delivered (per-wc replay) → pure no-op: keep the\n\t\t// live anchor, do not create a second, do not dispose the first.\n\t\tif (existing && existing.token === grant.slotToken) return\n\t\t// A new token for this viewId → REVOKE the stale anchor FIRST: dispose it,\n\t\t// drop it from the publisher table, and remove it from the map BEFORE\n\t\t// resolving the new slot, so a stale anchor can never keep contributing a\n\t\t// revoked token even when the new slot isn't mounted yet.\n\t\tif (existing) {\n\t\t\t// try/finally: the map delete + publisher.remove MUST run even if the old\n\t\t\t// anchor's dispose throws — otherwise the disposed-but-still-mapped anchor\n\t\t\t// keeps its snapshot entry AND a later client.dispose() would dispose it a\n\t\t\t// second time.\n\t\t\ttry {\n\t\t\t\texisting.anchor.dispose()\n\t\t\t}\n\t\t\tfinally {\n\t\t\t\tbyViewId.delete(grant.viewId)\n\t\t\t\tpublisher.remove(grant.viewId)\n\t\t\t}\n\t\t}\n\t\tconst el = resolveSlot(grant.slotId)\n\t\tif (!el) return // new slot not mounted → graceful no-op; old anchor already revoked\n\t\tconst token = grant.slotToken\n\t\tconst anchor = createAnchor(el, {\n\t\t\tvisible: true,\n\t\t\tfollowScroll: true,\n\t\t\tfollowGeometry: true,\n\t\t\tguardDisplayNone: true,\n\t\t\t// Capture THIS grant's viewId + slotToken so the measured placement lands\n\t\t\t// in the central publisher under the right key with its own token (no\n\t\t\t// cross-talk between slots). layer is 0: z-order is host-controlled\n\t\t\t// (compositor zone), not renderer-driven.\n\t\t\tpublish: (placement) => {\n\t\t\t\tpublisher.set({ viewId: grant.viewId, placement, layer: 0, extra: { slotToken: token } })\n\t\t\t},\n\t\t})\n\t\tbyViewId.set(grant.viewId, { token, anchor })\n\t})\n\n\t// Request replay AFTER the listener is attached.\n\tdeps.bridge.subscribe()\n\n\treturn {\n\t\tdispose(): void {\n\t\t\tif (disposed) return\n\t\t\tdisposed = true\n\t\t\tunsub()\n\t\t\tfor (const { anchor } of byViewId.values()) anchor.dispose()\n\t\t\tbyViewId.clear()\n\t\t\t// Dispose the publisher LAST so no anchor teardown races a pending frame.\n\t\t\tpublisher.dispose()\n\t\t},\n\t}\n}\n","import {\n\tDeckClientNotReadyError,\n\tDeckRemoteError,\n} from '../errors.js'\nimport {\n\tBRIDGE_PROTOCOL_VERSION,\n\tDEFAULT_BRIDGE_GLOBAL,\n} from '../shared/protocol.js'\nimport type { EventEnvelope, DeckBridge } from '../shared/protocol.js'\nimport type { Disposable, HostEvent, JsonValue } from '../types.js'\n\nexport { DeckClientNotReadyError, DeckRemoteError }\n\nexport { createDeckLayoutClient } from './layout-client.js'\nexport type {\n\tSlotGrant,\n\tLayoutBridge,\n\tLayoutClientDeps,\n} from './layout-client.js'\n\nexport { createPlacementPublisher } from './placement-publisher.js'\nexport type {\n\tPlacementPublisher,\n\tPlacementPublisherDeps,\n} from './placement-publisher.js'\n\nexport interface CreateDeckClientOptions {\n\t/** 默认 `__electronDeckBridge`；必须与 host preload 对齐 */\n\treadonly globalName?: string\n}\n\n// HS / EV 使用 `any` 而非 `JsonValue[]` 约束：\n// (1) host 侧 HostServiceHandler 同样是 `(...args: any[]) => unknown`，两侧对称；\n// (2) JsonValue 索引签名挡掉常见 host 写法（`(p: { code: string }) => ...`），\n//     强迫 rest-only 签名时 `Parameters<HS[K]>` 推不出真实参数类型；\n// (3) Electron IPC 实际走 structured clone（非 JSON），原约束的\"前提\"本就错；\n// (4) 真要 runtime 校验，在 transport 边界用 `runtime.ipc.handle({ validator })`\n//     与 protocol envelope（`InvokeRequest.args: readonly JsonValue[]`）已经够。\nexport interface DeckClient<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tHS extends Record<keyof HS, (...args: any[]) => unknown>,\n\tEV extends readonly HostEvent<JsonValue>[],\n> {\n\tready(): Promise<void>\n\tinvoke<K extends keyof HS & string>(\n\t\tname: K,\n\t\t...args: Parameters<HS[K]>\n\t): Promise<Awaited<ReturnType<HS[K]>>>\n\ton<E extends EV[number]>(\n\t\tevent: E,\n\t\tlistener: (payload: E extends HostEvent<infer P> ? P : never) => void,\n\t): Disposable\n}\n\nexport function createDeckClient<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tHS extends Record<keyof HS, (...args: any[]) => unknown>,\n\tEV extends readonly HostEvent<JsonValue>[],\n>(options?: CreateDeckClientOptions): DeckClient<HS, EV> {\n\tconst globalName = options?.globalName ?? DEFAULT_BRIDGE_GLOBAL\n\n\tfunction getBridge(): DeckBridge {\n\t\tconst bridge = readBridgeFromGlobal(globalName)\n\t\tif (bridge === undefined) {\n\t\t\tthrow new DeckClientNotReadyError(\n\t\t\t\t`Deck framework bridge is missing on window[\"${globalName}\"] — did the host preload call exposeDeckBridge()?`,\n\t\t\t)\n\t\t}\n\t\treturn bridge\n\t}\n\n\treturn {\n\t\tasync ready(): Promise<void> {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst remoteMajor = parseMajor(bridge.version)\n\t\t\tconst localMajor = parseMajor(BRIDGE_PROTOCOL_VERSION)\n\t\t\tif (remoteMajor !== localMajor) {\n\t\t\t\tthrow new DeckClientNotReadyError(\n\t\t\t\t\t`Deck bridge protocol version mismatch: bridge=${String(bridge.version)}, client expected major ${localMajor}.x.x (${BRIDGE_PROTOCOL_VERSION})`,\n\t\t\t\t)\n\t\t\t}\n\t\t},\n\n\t\tasync invoke<K extends keyof HS & string>(\n\t\t\tname: K,\n\t\t\t...args: Parameters<HS[K]>\n\t\t): Promise<Awaited<ReturnType<HS[K]>>> {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst response = await bridge.invoke({\n\t\t\t\tkind: 'host',\n\t\t\t\tname,\n\t\t\t\targs: args as readonly JsonValue[],\n\t\t\t})\n\t\t\tif (response.ok) {\n\t\t\t\treturn response.result as Awaited<ReturnType<HS[K]>>\n\t\t\t}\n\t\t\tconst { remoteName, message, code } = response.error\n\t\t\tthrow new DeckRemoteError(remoteName, message, code)\n\t\t},\n\n\t\ton<E extends EV[number]>(\n\t\t\tevent: E,\n\t\t\tlistener: (payload: E extends HostEvent<infer P> ? P : never) => void,\n\t\t): Disposable {\n\t\t\tconst bridge = getBridge()\n\t\t\tconst wrapped = (env: EventEnvelope): void => {\n\t\t\t\tif (env.name === event.name) {\n\t\t\t\t\tlistener(env.payload as E extends HostEvent<infer P> ? P : never)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst unsubscribe = bridge.onEvent(wrapped)\n\t\t\tlet disposed = false\n\t\t\treturn {\n\t\t\t\tdispose: () => {\n\t\t\t\t\tif (disposed) return\n\t\t\t\t\tdisposed = true\n\t\t\t\t\tunsubscribe()\n\t\t\t\t},\n\t\t\t}\n\t\t},\n\t}\n}\n\nexport function readBridgeFromGlobal(\n\tglobalName: string = DEFAULT_BRIDGE_GLOBAL,\n): DeckBridge | undefined {\n\tconst g = globalThis as unknown as Record<string, unknown>\n\tconst bridge = g[globalName]\n\tif (bridge === undefined || bridge === null) return undefined\n\treturn bridge as DeckBridge\n}\n\nfunction parseMajor(version: unknown): number {\n\tif (typeof version !== 'string') return Number.NaN\n\tconst head = version.split('.')[0] ?? ''\n\tconst n = Number.parseInt(head, 10)\n\treturn Number.isNaN(n) ? Number.NaN : n\n}\n\nexport { BRIDGE_PROTOCOL_VERSION, DEFAULT_BRIDGE_GLOBAL }\n"],"mappings":"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"}

package/dist/client/layout-client.d.ts

@@ -1,22 +1,32 @@
 import type { Placement } from '@dimina-kit/view-anchor';
+import type { PlacementSnapshot } from '../layout/index.js';
+/** Per-view host extra threaded on every DesiredView: the slot's capability
+ *  token. Main derives the view's identity + z-order from this token (never from
+ *  the renderer-reported viewId), so a valid token can't be spliced onto a forged
+ *  viewId. */
+export interface SlotExtra {
+    slotToken: string;
+}
 /** One main→renderer slot grant: a native view (`viewId`) wants to follow the
- *  DOM slot `slotId`; `slotToken` is the capability the renderer threads back on
- *  every `place` so main can match a placement to the granted slot. */
+ *  DOM slot `slotId`; `slotToken` is the capability the renderer threads back
+ *  (as a per-view extra) so main can match a placement to the granted slot.
+ *  `generation` is a main-assigned, strictly-monotonic-per-wc renderer-lifetime
+ *  id: it is stamped onto every published snapshot so a reload (new grants at a
+ *  higher generation) resets main's reconciler regardless of IPC ordering. */
 export interface SlotGrant {
     viewId: string;
     slotId: string;
     slotToken: string;
+    generation: number;
 }
 /** The renderer-side transport for the slot-token handshake. `onSlotGrant`
  *  registers the grant listener (returns an unsubscribe); `subscribe` asks main
- *  to (re)play buffered grants AFTER the listener is attached; `sendPlace`
- *  forwards a measured placement carrying its slot's token. */
+ *  to (re)play buffered grants AFTER the listener is attached; `sendSnapshot`
+ *  forwards the whole window-level desired-placement table (one coalesced frame),
+ *  each view carrying its slot's token as an extra. */
 export interface LayoutBridge {
     onSlotGrant(cb: (grant: SlotGrant) => void): () => void;
-    sendPlace(msg: {
-        slotToken: string;
-        placement: Placement;
-    }): void;
+    sendSnapshot(snapshot: PlacementSnapshot<SlotExtra>): void;
     subscribe(): void;
 }
 export interface LayoutClientDeps {
@@ -36,14 +46,25 @@ export interface LayoutClientDeps {
     }) => {
         dispose(): void;
     };
+    /** Frame scheduler for the internal placement publisher. Default:
+     *  requestAnimationFrame / cancelAnimationFrame. Injected in tests to drive
+     *  coalesced publishes deterministically. */
+    requestFrame?: (cb: () => void) => number;
+    cancelFrame?: (id: number) => void;
 }
 /**
- * Renderer half of the slot-token handshake (capability-and-lifecycle.md「原子下发握手协议」). Subscribes to main's
- * `slot-grant` pushes FIRST (so a grant replayed synchronously by `subscribe()`
- * cannot be missed), then on each grant anchors the granted DOM slot with this
- * session's hardening opts (followScroll / followGeometry / guardDisplayNone)
- * and threads each measured `Placement` back to main as a `place` carrying that
- * grant's `slotToken`.
+ * Renderer half of the slot-token handshake. Subscribes to main's `slot-grant`
+ * pushes FIRST (so a grant replayed synchronously by `subscribe()` cannot be
+ * missed), then on each grant anchors the granted DOM slot with this session's
+ * hardening opts (followScroll / followGeometry / guardDisplayNone). Each anchor's
+ * measured `Placement` is written into a CENTRAL placement publisher keyed by
+ * `viewId` — NOT sent per-view. The publisher coalesces every anchor's writes into
+ * ONE window-level snapshot per animation frame, so a transient relayout that
+ * momentarily measures 0×0 is overwritten before it is ever published. This is the
+ * producer half of the level-triggered reconcile design (see
+ * ../layout/placement-reconcile.ts); a per-view edge stream cannot self-correct a
+ * lost or spurious frame, which is what caused a stuck detached (white-screen)
+ * view.
  */
 export declare function createDeckLayoutClient(deps: LayoutClientDeps): {
     dispose(): void;

package/dist/client/layout-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-client.d.ts","sourceRoot":"","sources":["../../src/client/layout-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD;;uEAEuE;AACvE,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;+DAG+D;AAC/D,MAAM,WAAW,YAAY;IAC5B,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACvD,SAAS,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAA;IACjE,SAAS,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB;;oCAEgC;IAChC,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IAChD;uEACmE;IACnE,YAAY,CAAC,EAAE,CACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;QACL,OAAO,EAAE,OAAO,CAAA;QAChB,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;QAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC1B,KACG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAC/D,OAAO,IAAI,IAAI,CAAA;CACf,CAsEA"}
+{"version":3,"file":"layout-client.d.ts","sourceRoot":"","sources":["../../src/client/layout-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D;;;cAGc;AACd,MAAM,WAAW,SAAS;IACzB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;;;8EAK8E;AAC9E,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED;;;;uDAIuD;AACvD,MAAM,WAAW,YAAY;IAC5B,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACvD,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IAC1D,SAAS,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB;;oCAEgC;IAChC,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IAChD;uEACmE;IACnE,YAAY,CAAC,EAAE,CACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;QACL,OAAO,EAAE,OAAO,CAAA;QAChB,OAAO,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;QAC/B,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC1B,KACG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAA;IACxB;;iDAE6C;IAC7C,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,CAAA;IACzC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAC/D,OAAO,IAAI,IAAI,CAAA;CACf,CAyFA"}

package/dist/client/placement-publisher.d.ts

@@ -0,0 +1,14 @@
+import type { DesiredView, PlacementSnapshot } from '../layout/index.js';
+export interface PlacementPublisherDeps<Extra = unknown> {
+    generation: number | (() => number);
+    publish: (snapshot: PlacementSnapshot<Extra>) => void;
+    requestFrame?: (cb: () => void) => number;
+    cancelFrame?: (id: number) => void;
+}
+export interface PlacementPublisher<Extra = unknown> {
+    set(view: DesiredView<Extra>): void;
+    remove(viewId: string): void;
+    dispose(): void;
+}
+export declare function createPlacementPublisher<Extra = unknown>(deps: PlacementPublisherDeps<Extra>): PlacementPublisher<Extra>;
+//# sourceMappingURL=placement-publisher.d.ts.map

package/dist/client/placement-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement-publisher.d.ts","sourceRoot":"","sources":["../../src/client/placement-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAaxE,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO;IAMrD,UAAU,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IACnC,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IAErD,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,MAAM,CAAA;IACzC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO;IAEjD,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IAEnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,GAAG,OAAO,EACtD,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAClC,kBAAkB,CAAC,KAAK,CAAC,CAsD3B"}

package/dist/dock-react/index.js

@@ -1,4 +1,4 @@
-import { i as extractPanel, l as setSizes, o as movePanel, s as setActive, t as closePanelForUser, u as splitPanel } from "../layout-B1t15b_q.js";
+import { a as closePanelForUser, c as extractPanel, d as setActive, m as splitPanel, p as setSizes, u as movePanel } from "../layout-ByOiOdnc.js";
 import { Fragment, createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { Group, Panel, Separator } from "react-resizable-panels";
 import { jsx, jsxs } from "react/jsx-runtime";