@kumwe/studio-preview 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kumwe Studio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# `@kumwe/studio-preview`
+
+Status: pre-Gate-A foundation alpha. The channel is an executable contract spike, not a qualified adapter.
+
+An exact-origin, typed request channel between Studio and a host-rendered preview surface. A host can
+render Twig, Liquid, JSX, or another server template without teaching the canvas to reproduce its
+markup. Wildcard target origins are rejected.
+
+The channel handles correlation, timeouts, abort signals, protocol filtering, and disposal. The host
+still owns authentication, authorization, CSP, sandboxing, and rendering.
+
+## Host responder and handshake
+
+`PreviewClient` is the Studio half of the channel; `PreviewHost` is the preview-surface half. Both
+pin an exact target origin and drop any inbound message whose source window, origin, schema, channel
+ID, session generation, or sequence does not match; each direction stamps its own monotonic sequence
+counter.
+
+The handshake and request flow is announce → ready → render → rendered:
+
+1. The host constructs a `PreviewHost` with its renderer id, viewport inventory, and a render
+   callback, then calls `announce()` to post `studio.preview/ready`.
+2. Studio awaits `client.ready()`, which resolves with the announced payload — immediately when the
+   announcement already arrived — and rejects on timeout, abort, or disposal.
+3. Studio requests `studio.preview/render` via `client.render()`. The host invokes its render
+   callback and replies with `studio.preview/rendered` carrying the same draft digest as the
+   request. A newer request supersedes an in-flight one on both sides, so a stale result is never
+   posted or resolved.
+4. A failed render is answered with `studio.preview/error` (code `studio.preview/render-failed`, the
+   draft digest as `correlationId`, `retryable: true`) and a generic message — renderer failure
+   details never cross the channel.
+5. `client.select()` forwards `studio.preview/select` to the host's `onSelect` listeners.
+
+## Marker geometry
+
+`client.measure()` posts `studio.preview/measure` with a bounded marker list and resolves with the
+`studio.preview/measurements` answer: per marker, one or more CSS-pixel rectangles relative to the
+preview viewport origin (inline content fragments across lines), plus viewport metrics. Markers the
+renderer cannot place are returned in a distinct `unknown` list, never thrown.
+
+The host never reads the DOM. The embedding renderer passes a `measure` callback in
+`PreviewHostOptions`; without one, measure requests are answered with the qualified
+`studio.preview/measure-unavailable` error, and a throwing measurer is answered with
+`studio.preview/measure-failed` — measurer failure details never cross the channel.
+
+Geometry is volatile, not document state: each response is stamped with the digest of the render it
+was measured against. A response whose digest no longer matches the client's latest completed render
+resolves as a typed `{ status: 'stale' }` outcome instead of geometry, and a reload voids in-flight
+measurements exactly like it voids renders. Newer measure requests supersede older ones on both
+sides.
+
+Version negotiation currently requires the exact draft wire version on both sides: schema filtering
+accepts only `STUDIO_WIRE_PROTOCOL_VERSION`, so a ready announcement from a host speaking any other
+version is discarded and `ready()` times out instead of resolving against an incompatible host.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PreviewClient, type PreviewClientOptions, type PreviewMeasureOptions, type PreviewMeasureOutcome, type PreviewMessageEvent, type PreviewMessageListener, type PreviewMessageSource, type PreviewMessageTarget, type PreviewProtocolListener, type PreviewReadyOptions, type PreviewRenderOptions, } from './preview-client.js';
+export { PreviewHost, type PreviewHostOptions, type PreviewMeasureCallback, type PreviewMeasurement, type PreviewRenderCallback, type PreviewSelectListener, } from './preview-host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { PreviewClient, } from './preview-client.js';
+export { PreviewHost, } from './preview-host.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAWd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,GAMZ,MAAM,mBAAmB,CAAC"}

package/dist/preview-client.d.ts

@@ -0,0 +1,75 @@
+import { type PreviewMeasurePayload, type PreviewMeasurementsPayload, type PreviewMessage, type PreviewReadyPayload, type PreviewRenderedPayload, type PreviewRenderPayload, type PreviewSelectPayload, type PreviewTeardownPayload } from '@kumwe/studio-protocol';
+export interface PreviewMessageEvent {
+    data: unknown;
+    origin: string;
+    source: unknown;
+}
+export type PreviewMessageListener = (event: PreviewMessageEvent) => void;
+export interface PreviewMessageSource {
+    addEventListener(type: 'message', listener: PreviewMessageListener): void;
+    removeEventListener(type: 'message', listener: PreviewMessageListener): void;
+}
+export interface PreviewMessageTarget {
+    postMessage(message: unknown, targetOrigin: string): void;
+}
+export interface PreviewClientOptions {
+    channelId: string;
+    sessionGeneration: string;
+    source: PreviewMessageSource;
+    target: PreviewMessageTarget;
+    targetOrigin: string;
+    timeoutMilliseconds?: number;
+}
+export interface PreviewReadyOptions {
+    signal?: AbortSignal;
+}
+export interface PreviewRenderOptions {
+    signal?: AbortSignal;
+}
+export interface PreviewMeasureOptions {
+    signal?: AbortSignal;
+}
+/**
+ * Result of a `measure()` call. Geometry whose render digest no longer matches the
+ * client's latest rendered digest is discarded and surfaced as a `stale` outcome —
+ * a typed signal to re-measure, not an error.
+ */
+export type PreviewMeasureOutcome = {
+    geometry: PreviewMeasurementsPayload;
+    status: 'measured';
+} | {
+    measuredDigest: string;
+    status: 'stale';
+};
+export type PreviewProtocolListener = (message: PreviewMessage) => void;
+export declare class PreviewClient {
+    #private;
+    constructor(options: PreviewClientOptions);
+    dispose(): void;
+    onMessage(listener: PreviewProtocolListener): () => void;
+    /**
+     * Resolves once the host announces `studio.preview/ready` on this channel. If the
+     * announcement was already received, the cached payload resolves immediately.
+     *
+     * `isPreviewMessage` accepts only ready payloads carrying the exact draft wire protocol
+     * version, so an announcement from an incompatible host is filtered out and never resolves
+     * this promise — the wait times out instead. The promise also rejects on abort or when the
+     * client is disposed.
+     */
+    ready(options?: PreviewReadyOptions): Promise<PreviewReadyPayload>;
+    render(payload: PreviewRenderPayload, options?: PreviewRenderOptions): Promise<PreviewRenderedPayload>;
+    /**
+     * Requests the on-screen geometry of render markers from the responder. Resolves with a
+     * `measured` outcome carrying viewport-relative CSS-pixel rectangles, or a `stale`
+     * outcome when the response was measured against a render this client no longer
+     * considers latest. Rejects on teardown, reload, supersession, abort, timeout, and
+     * disposal exactly like `render()` does. Requires a completed render: geometry is a
+     * volatile measurement of a specific render digest, never document state.
+     */
+    measure(payload: PreviewMeasurePayload, options?: PreviewMeasureOptions): Promise<PreviewMeasureOutcome>;
+    select(payload: PreviewSelectPayload): void;
+    /** Announce channel closure to the host, then dispose this client. */
+    teardown(reason: PreviewTeardownPayload['reason']): void;
+}
+export declare function normalizeOrigin(input: string): string;
+//# sourceMappingURL=preview-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-client.d.ts","sourceRoot":"","sources":["../src/preview-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC1E,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC9E;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,EAAE,0BAA0B,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC5D;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAuBxE,qBAAa,aAAa;;gBAmBL,OAAO,EAAE,oBAAoB;IAazC,OAAO,IAAI,IAAI;IA2Bf,SAAS,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAO/D;;;;;;;;OAQG;IACI,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqCtE,MAAM,CACX,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC;IAiElC;;;;;;;OAOG;IACI,OAAO,CACZ,OAAO,EAAE,qBAAqB,EAC9B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC;IA6D1B,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAqJlD,sEAAsE;IAC/D,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,GAAG,IAAI;CAahE;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD"}

package/dist/preview-client.js

@@ -0,0 +1,393 @@
+import { isPreviewMessage, STUDIO_CONTRACT_VERSION, } from '@kumwe/studio-protocol';
+export class PreviewClient {
+    #channelId;
+    #listener;
+    #listeners = new Set();
+    #pending = new Map();
+    #pendingMeasures = new Map();
+    #pendingReady = new Set();
+    #sessionGeneration;
+    #source;
+    #target;
+    #targetOrigin;
+    #timeoutMilliseconds;
+    #disposed = false;
+    #lastInboundSequence = -1;
+    #latestRenderDigest;
+    #latestRenderedDigest;
+    #readyPayload;
+    #sequence = 0;
+    constructor(options) {
+        this.#targetOrigin = normalizeOrigin(options.targetOrigin);
+        this.#channelId = options.channelId;
+        this.#sessionGeneration = options.sessionGeneration;
+        this.#source = options.source;
+        this.#target = options.target;
+        this.#timeoutMilliseconds = options.timeoutMilliseconds ?? 10_000;
+        this.#listener = (event) => {
+            this.#receive(event);
+        };
+        this.#source.addEventListener('message', this.#listener);
+    }
+    dispose() {
+        if (this.#disposed) {
+            return;
+        }
+        this.#disposed = true;
+        this.#source.removeEventListener('message', this.#listener);
+        for (const pending of this.#pending.values()) {
+            clearTimeout(pending.timeout);
+            pending.cleanup();
+            pending.reject(new Error('Preview client was disposed.'));
+        }
+        this.#pending.clear();
+        for (const pending of this.#pendingMeasures.values()) {
+            clearTimeout(pending.timeout);
+            pending.cleanup();
+            pending.reject(new Error('Preview client was disposed.'));
+        }
+        this.#pendingMeasures.clear();
+        for (const pending of this.#pendingReady) {
+            clearTimeout(pending.timeout);
+            pending.cleanup();
+            pending.reject(new Error('Preview client was disposed.'));
+        }
+        this.#pendingReady.clear();
+        this.#listeners.clear();
+    }
+    onMessage(listener) {
+        this.#listeners.add(listener);
+        return () => {
+            this.#listeners.delete(listener);
+        };
+    }
+    /**
+     * Resolves once the host announces `studio.preview/ready` on this channel. If the
+     * announcement was already received, the cached payload resolves immediately.
+     *
+     * `isPreviewMessage` accepts only ready payloads carrying the exact draft wire protocol
+     * version, so an announcement from an incompatible host is filtered out and never resolves
+     * this promise — the wait times out instead. The promise also rejects on abort or when the
+     * client is disposed.
+     */
+    ready(options = {}) {
+        if (this.#disposed) {
+            return Promise.reject(new Error('Preview client was disposed.'));
+        }
+        if (options.signal?.aborted === true) {
+            return Promise.reject(new Error('Preview ready wait was aborted.', { cause: options.signal.reason }));
+        }
+        if (this.#readyPayload !== undefined) {
+            return Promise.resolve(this.#readyPayload);
+        }
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                if (this.#pendingReady.delete(pending)) {
+                    clearTimeout(pending.timeout);
+                    pending.cleanup();
+                    pending.reject(new Error('Preview ready wait was aborted.'));
+                }
+            };
+            const cleanup = () => {
+                options.signal?.removeEventListener('abort', abort);
+            };
+            const timeout = setTimeout(() => {
+                if (this.#pendingReady.delete(pending)) {
+                    pending.cleanup();
+                    pending.reject(new Error('Preview ready wait timed out.'));
+                }
+            }, this.#timeoutMilliseconds);
+            const pending = { cleanup, reject, resolve, timeout };
+            this.#pendingReady.add(pending);
+            options.signal?.addEventListener('abort', abort, { once: true });
+        });
+    }
+    render(payload, options = {}) {
+        if (this.#disposed) {
+            return Promise.reject(new Error('Preview client was disposed.'));
+        }
+        if (options.signal?.aborted === true) {
+            return Promise.reject(new Error('Preview render was aborted.', { cause: options.signal.reason }));
+        }
+        if (this.#pending.has(payload.draftDigest)) {
+            return Promise.reject(new Error(`Render ${payload.draftDigest} is already pending.`));
+        }
+        for (const [digest, pending] of this.#pending) {
+            clearTimeout(pending.timeout);
+            pending.cleanup();
+            pending.reject(new Error(`Preview render ${digest} was superseded by ${payload.draftDigest}.`));
+        }
+        this.#pending.clear();
+        this.#latestRenderDigest = payload.draftDigest;
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                const pending = this.#pending.get(payload.draftDigest);
+                if (pending !== undefined) {
+                    clearTimeout(pending.timeout);
+                    this.#pending.delete(payload.draftDigest);
+                    pending.cleanup();
+                    if (this.#latestRenderDigest === payload.draftDigest) {
+                        this.#latestRenderDigest = undefined;
+                    }
+                    pending.reject(new Error('Preview render was aborted.'));
+                }
+            };
+            const cleanup = () => {
+                options.signal?.removeEventListener('abort', abort);
+            };
+            const timeout = setTimeout(() => {
+                const pending = this.#pending.get(payload.draftDigest);
+                if (pending !== undefined) {
+                    this.#pending.delete(payload.draftDigest);
+                    pending.cleanup();
+                    if (this.#latestRenderDigest === payload.draftDigest) {
+                        this.#latestRenderDigest = undefined;
+                    }
+                    pending.reject(new Error(`Preview render ${payload.draftDigest} timed out.`));
+                }
+            }, this.#timeoutMilliseconds);
+            this.#pending.set(payload.draftDigest, { cleanup, reject, resolve, timeout });
+            options.signal?.addEventListener('abort', abort, { once: true });
+            this.#post({
+                channelId: this.#channelId,
+                contractVersion: STUDIO_CONTRACT_VERSION,
+                kind: 'preview-message',
+                payload,
+                sequence: this.#sequence++,
+                sessionGeneration: this.#sessionGeneration,
+                type: 'studio.preview/render',
+            });
+        });
+    }
+    /**
+     * Requests the on-screen geometry of render markers from the responder. Resolves with a
+     * `measured` outcome carrying viewport-relative CSS-pixel rectangles, or a `stale`
+     * outcome when the response was measured against a render this client no longer
+     * considers latest. Rejects on teardown, reload, supersession, abort, timeout, and
+     * disposal exactly like `render()` does. Requires a completed render: geometry is a
+     * volatile measurement of a specific render digest, never document state.
+     */
+    measure(payload, options = {}) {
+        if (this.#disposed) {
+            return Promise.reject(new Error('Preview client was disposed.'));
+        }
+        if (options.signal?.aborted === true) {
+            return Promise.reject(new Error('Preview measure was aborted.', { cause: options.signal.reason }));
+        }
+        if (this.#latestRenderedDigest === undefined) {
+            return Promise.reject(new Error('Preview measure requires a completed render.'));
+        }
+        if (this.#pendingMeasures.has(payload.requestId)) {
+            return Promise.reject(new Error(`Measure ${payload.requestId} is already pending.`));
+        }
+        for (const [requestId, pending] of this.#pendingMeasures) {
+            clearTimeout(pending.timeout);
+            pending.cleanup();
+            pending.reject(new Error(`Preview measure ${requestId} was superseded by ${payload.requestId}.`));
+        }
+        this.#pendingMeasures.clear();
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                const pending = this.#pendingMeasures.get(payload.requestId);
+                if (pending !== undefined) {
+                    clearTimeout(pending.timeout);
+                    this.#pendingMeasures.delete(payload.requestId);
+                    pending.cleanup();
+                    pending.reject(new Error('Preview measure was aborted.'));
+                }
+            };
+            const cleanup = () => {
+                options.signal?.removeEventListener('abort', abort);
+            };
+            const timeout = setTimeout(() => {
+                const pending = this.#pendingMeasures.get(payload.requestId);
+                if (pending !== undefined) {
+                    this.#pendingMeasures.delete(payload.requestId);
+                    pending.cleanup();
+                    pending.reject(new Error(`Preview measure ${payload.requestId} timed out.`));
+                }
+            }, this.#timeoutMilliseconds);
+            this.#pendingMeasures.set(payload.requestId, { cleanup, reject, resolve, timeout });
+            options.signal?.addEventListener('abort', abort, { once: true });
+            this.#post({
+                channelId: this.#channelId,
+                contractVersion: STUDIO_CONTRACT_VERSION,
+                kind: 'preview-message',
+                payload,
+                sequence: this.#sequence++,
+                sessionGeneration: this.#sessionGeneration,
+                type: 'studio.preview/measure',
+            });
+        });
+    }
+    select(payload) {
+        this.#assertActive();
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload,
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/select',
+        });
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error('Preview client was disposed.');
+        }
+    }
+    #post(message) {
+        this.#target.postMessage(message, this.#targetOrigin);
+    }
+    #receive(event) {
+        if (event.origin !== this.#targetOrigin ||
+            event.source !== this.#target ||
+            !isPreviewMessage(event.data) ||
+            event.data.channelId !== this.#channelId ||
+            event.data.sessionGeneration !== this.#sessionGeneration ||
+            event.data.sequence <= this.#lastInboundSequence) {
+            return;
+        }
+        this.#lastInboundSequence = event.data.sequence;
+        if (event.data.type === 'studio.preview/rendered') {
+            if (event.data.payload.draftDigest !== this.#latestRenderDigest) {
+                return;
+            }
+            const pending = this.#pending.get(event.data.payload.draftDigest);
+            if (pending !== undefined) {
+                clearTimeout(pending.timeout);
+                pending.cleanup();
+                this.#pending.delete(event.data.payload.draftDigest);
+                this.#latestRenderDigest = undefined;
+                this.#latestRenderedDigest = event.data.payload.draftDigest;
+                pending.resolve(event.data.payload);
+            }
+        }
+        else if (event.data.type === 'studio.preview/measurements') {
+            const pending = this.#pendingMeasures.get(event.data.payload.requestId);
+            if (pending !== undefined) {
+                clearTimeout(pending.timeout);
+                pending.cleanup();
+                this.#pendingMeasures.delete(event.data.payload.requestId);
+                // Geometry measured against a superseded render is discarded, not surfaced:
+                // the typed stale outcome tells the caller to re-measure.
+                if (event.data.payload.draftDigest === this.#latestRenderedDigest) {
+                    pending.resolve({ geometry: event.data.payload, status: 'measured' });
+                }
+                else {
+                    pending.resolve({ measuredDigest: event.data.payload.draftDigest, status: 'stale' });
+                }
+            }
+        }
+        else if (event.data.type === 'studio.preview/error') {
+            const message = event.data.payload.message.defaultMessage ?? event.data.payload.message.key;
+            const correlationId = event.data.payload.correlationId;
+            if (correlationId !== undefined) {
+                const pendingRender = this.#pending.get(correlationId);
+                const pendingMeasure = this.#pendingMeasures.get(correlationId);
+                if (pendingRender === undefined && pendingMeasure === undefined) {
+                    return;
+                }
+                if (pendingRender !== undefined) {
+                    clearTimeout(pendingRender.timeout);
+                    pendingRender.cleanup();
+                    pendingRender.reject(new Error(message));
+                    this.#pending.delete(correlationId);
+                    if (this.#latestRenderDigest === correlationId) {
+                        this.#latestRenderDigest = undefined;
+                    }
+                }
+                if (pendingMeasure !== undefined) {
+                    clearTimeout(pendingMeasure.timeout);
+                    pendingMeasure.cleanup();
+                    pendingMeasure.reject(new Error(message));
+                    this.#pendingMeasures.delete(correlationId);
+                }
+            }
+            else {
+                for (const pending of this.#pending.values()) {
+                    clearTimeout(pending.timeout);
+                    pending.cleanup();
+                    pending.reject(new Error(message));
+                }
+                this.#pending.clear();
+                for (const pending of this.#pendingMeasures.values()) {
+                    clearTimeout(pending.timeout);
+                    pending.cleanup();
+                    pending.reject(new Error(message));
+                }
+                this.#pendingMeasures.clear();
+                this.#latestRenderDigest = undefined;
+            }
+        }
+        else if (event.data.type === 'studio.preview/ready') {
+            this.#readyPayload = event.data.payload;
+            const waiters = [...this.#pendingReady];
+            this.#pendingReady.clear();
+            for (const pending of waiters) {
+                clearTimeout(pending.timeout);
+                pending.cleanup();
+                pending.resolve(event.data.payload);
+            }
+        }
+        else if (event.data.type === 'studio.preview/reload' ||
+            event.data.type === 'studio.preview/teardown') {
+            const reason = event.data.type === 'studio.preview/reload'
+                ? 'Preview renderer reloaded before responding.'
+                : 'Preview channel was torn down.';
+            for (const pending of this.#pending.values()) {
+                clearTimeout(pending.timeout);
+                pending.cleanup();
+                pending.reject(new Error(reason));
+            }
+            this.#pending.clear();
+            // A reload voids in-flight measurements exactly like it voids renders, and the
+            // digest they were bound to no longer describes what the surface shows.
+            for (const pending of this.#pendingMeasures.values()) {
+                clearTimeout(pending.timeout);
+                pending.cleanup();
+                pending.reject(new Error(reason));
+            }
+            this.#pendingMeasures.clear();
+            this.#latestRenderDigest = undefined;
+            this.#latestRenderedDigest = undefined;
+            // A reloaded renderer announces itself again; the cached payload may
+            // no longer describe it.
+            this.#readyPayload = undefined;
+        }
+        const teardown = event.data.type === 'studio.preview/teardown';
+        for (const listener of this.#listeners) {
+            listener(event.data);
+        }
+        if (teardown) {
+            this.dispose();
+        }
+    }
+    /** Announce channel closure to the host, then dispose this client. */
+    teardown(reason) {
+        this.#assertActive();
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: { reason },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/teardown',
+        });
+        this.dispose();
+    }
+}
+// Shared with PreviewHost; intentionally not re-exported from the package index.
+export function normalizeOrigin(input) {
+    if (input === '*') {
+        throw new TypeError('Preview target origin must be exact; wildcard origins are forbidden.');
+    }
+    const url = new URL(input);
+    if (url.origin === 'null') {
+        throw new TypeError('Preview target origin must use a network origin.');
+    }
+    return url.origin;
+}
+//# sourceMappingURL=preview-client.js.map

package/dist/preview-client.js.map

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

package/dist/preview-host.d.ts

@@ -0,0 +1,54 @@
+import { type LocalName, type PreviewMarkerRect, type PreviewRenderedPayload, type PreviewRenderPayload, type PreviewSelectPayload, type PreviewViewportMetrics, type QualifiedName, type StableId } from '@kumwe/studio-protocol';
+import { type PreviewMessageSource, type PreviewMessageTarget } from './preview-client.js';
+export type PreviewRenderCallback = (payload: PreviewRenderPayload) => Promise<PreviewRenderedPayload>;
+/**
+ * Raw measurement produced by the embedding renderer. The responder never reads the
+ * DOM itself: the renderer supplies marker rectangles and viewport metrics, keeping
+ * this package DOM-free and testable. Markers absent from `rects` (or mapped to an
+ * empty rectangle list) are reported back as unknown, never thrown.
+ */
+export interface PreviewMeasurement {
+    rects: Record<StableId, PreviewMarkerRect[]>;
+    viewport: PreviewViewportMetrics;
+}
+export type PreviewMeasureCallback = (markers: StableId[]) => Promise<PreviewMeasurement>;
+export type PreviewSelectListener = (payload: PreviewSelectPayload) => void;
+export interface PreviewHostOptions {
+    channelId: string;
+    /** Renderer-supplied marker measurer; without one, measure requests are answered as unavailable. */
+    measure?: PreviewMeasureCallback;
+    render: PreviewRenderCallback;
+    renderer: QualifiedName;
+    sessionGeneration: string;
+    source: PreviewMessageSource;
+    target: PreviewMessageTarget;
+    targetOrigin: string;
+    viewports: LocalName[];
+}
+/**
+ * The preview-surface half of the channel: answers `studio.preview/render` and
+ * `studio.preview/measure` requests from a `PreviewClient` and forwards
+ * `studio.preview/select` to registered listeners. Inbound messages are filtered exactly
+ * like the client filters its own: pinned origin, expected source window, canonical
+ * schema, channel ID, session generation, and a strictly increasing sequence.
+ */
+export declare class PreviewHost {
+    #private;
+    constructor(options: PreviewHostOptions);
+    /**
+     * Posts the `studio.preview/ready` announcement carrying the wire protocol version,
+     * renderer id, and viewport inventory. Announcement is an explicit step so the host can
+     * finish its own setup before opening the channel.
+     */
+    announce(): void;
+    dispose(): void;
+    onSelect(listener: PreviewSelectListener): () => void;
+    /**
+     * Announce that the renderer reloaded: any in-flight render or measurement is
+     * void and the client must resend. The host re-announces readiness afterwards.
+     */
+    reload(reason: QualifiedName): void;
+    /** Announce channel closure to the client, then dispose this host. */
+    teardown(reason: QualifiedName): void;
+}
+//# sourceMappingURL=preview-host.d.ts.map

package/dist/preview-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-host.d.ts","sourceRoot":"","sources":["../src/preview-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,iBAAiB,EAGtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE1F,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;;gBAmBH,OAAO,EAAE,kBAAkB;IAgB9C;;;;OAIG;IACI,QAAQ,IAAI,IAAI;IAiBhB,OAAO,IAAI,IAAI;IAYf,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAO5D;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAiB1C,sEAAsE;IAC/D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;CA2O7C"}

package/dist/preview-host.js

@@ -0,0 +1,330 @@
+import { isPreviewMessage, STUDIO_CONTRACT_VERSION, STUDIO_WIRE_PROTOCOL_VERSION, } from '@kumwe/studio-protocol';
+import { normalizeOrigin, } from './preview-client.js';
+/**
+ * The preview-surface half of the channel: answers `studio.preview/render` and
+ * `studio.preview/measure` requests from a `PreviewClient` and forwards
+ * `studio.preview/select` to registered listeners. Inbound messages are filtered exactly
+ * like the client filters its own: pinned origin, expected source window, canonical
+ * schema, channel ID, session generation, and a strictly increasing sequence.
+ */
+export class PreviewHost {
+    #channelId;
+    #listener;
+    #measureCallback;
+    #renderCallback;
+    #renderer;
+    #selectListeners = new Set();
+    #sessionGeneration;
+    #source;
+    #target;
+    #targetOrigin;
+    #viewports;
+    #disposed = false;
+    #lastInboundSequence = -1;
+    #latestMeasureRequestId;
+    #latestRenderDigest;
+    #measuredRenderDigest;
+    #sequence = 0;
+    constructor(options) {
+        this.#targetOrigin = normalizeOrigin(options.targetOrigin);
+        this.#channelId = options.channelId;
+        this.#sessionGeneration = options.sessionGeneration;
+        this.#source = options.source;
+        this.#target = options.target;
+        this.#measureCallback = options.measure;
+        this.#renderCallback = options.render;
+        this.#renderer = options.renderer;
+        this.#viewports = [...options.viewports];
+        this.#listener = (event) => {
+            this.#receive(event);
+        };
+        this.#source.addEventListener('message', this.#listener);
+    }
+    /**
+     * Posts the `studio.preview/ready` announcement carrying the wire protocol version,
+     * renderer id, and viewport inventory. Announcement is an explicit step so the host can
+     * finish its own setup before opening the channel.
+     */
+    announce() {
+        this.#assertActive();
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: {
+                protocolVersion: STUDIO_WIRE_PROTOCOL_VERSION,
+                renderer: this.#renderer,
+                viewports: [...this.#viewports],
+            },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/ready',
+        });
+    }
+    dispose() {
+        if (this.#disposed) {
+            return;
+        }
+        this.#disposed = true;
+        this.#source.removeEventListener('message', this.#listener);
+        this.#selectListeners.clear();
+        this.#latestMeasureRequestId = undefined;
+        this.#latestRenderDigest = undefined;
+        this.#measuredRenderDigest = undefined;
+    }
+    onSelect(listener) {
+        this.#selectListeners.add(listener);
+        return () => {
+            this.#selectListeners.delete(listener);
+        };
+    }
+    /**
+     * Announce that the renderer reloaded: any in-flight render or measurement is
+     * void and the client must resend. The host re-announces readiness afterwards.
+     */
+    reload(reason) {
+        this.#assertActive();
+        this.#latestMeasureRequestId = undefined;
+        this.#latestRenderDigest = undefined;
+        this.#measuredRenderDigest = undefined;
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: { reason },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/reload',
+        });
+        this.announce();
+    }
+    /** Announce channel closure to the client, then dispose this host. */
+    teardown(reason) {
+        this.#assertActive();
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: { reason },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/teardown',
+        });
+        this.dispose();
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error('Preview host was disposed.');
+        }
+    }
+    #handleMeasure(payload) {
+        const requestId = payload.requestId;
+        this.#latestMeasureRequestId = requestId;
+        if (this.#measureCallback === undefined) {
+            this.#settleMeasureFailure(requestId, {
+                code: 'studio.preview/measure-unavailable',
+                defaultMessage: 'Preview measurement is unavailable.',
+                retryable: false,
+            });
+            return;
+        }
+        if (this.#measuredRenderDigest === undefined) {
+            // Nothing has rendered yet, so there is no digest to bind geometry to.
+            this.#settleMeasureFailure(requestId, {
+                code: 'studio.preview/measure-unavailable',
+                defaultMessage: 'Preview measurement is unavailable.',
+                retryable: true,
+            });
+            return;
+        }
+        const markers = [...new Set(payload.markers)];
+        let result;
+        try {
+            result = this.#measureCallback(markers);
+        }
+        catch {
+            this.#settleMeasureFailure(requestId, measureFailed());
+            return;
+        }
+        void result.then((measurement) => {
+            this.#settleMeasured(requestId, markers, measurement);
+        }, () => {
+            this.#settleMeasureFailure(requestId, measureFailed());
+        });
+    }
+    #handleRender(payload) {
+        const draftDigest = payload.draftDigest;
+        this.#latestRenderDigest = draftDigest;
+        let result;
+        try {
+            result = this.#renderCallback(payload);
+        }
+        catch {
+            this.#settleFailure(draftDigest);
+            return;
+        }
+        void result.then((rendered) => {
+            this.#settleRendered(draftDigest, rendered);
+        }, () => {
+            this.#settleFailure(draftDigest);
+        });
+    }
+    #post(message) {
+        this.#target.postMessage(message, this.#targetOrigin);
+    }
+    #receive(event) {
+        if (event.origin !== this.#targetOrigin ||
+            event.source !== this.#target ||
+            !isPreviewMessage(event.data) ||
+            event.data.channelId !== this.#channelId ||
+            event.data.sessionGeneration !== this.#sessionGeneration ||
+            event.data.sequence <= this.#lastInboundSequence) {
+            return;
+        }
+        this.#lastInboundSequence = event.data.sequence;
+        if (event.data.type === 'studio.preview/render') {
+            this.#handleRender(event.data.payload);
+        }
+        else if (event.data.type === 'studio.preview/measure') {
+            this.#handleMeasure(event.data.payload);
+        }
+        else if (event.data.type === 'studio.preview/select') {
+            for (const listener of this.#selectListeners) {
+                listener(event.data.payload);
+            }
+        }
+        else if (event.data.type === 'studio.preview/teardown') {
+            this.dispose();
+        }
+    }
+    // Measurer failure details never cross the channel: the rejection reason is dropped and a
+    // stable generic error is posted instead, correlated by the request identifier.
+    #settleMeasureFailure(requestId, failure) {
+        if (this.#disposed || this.#latestMeasureRequestId !== requestId) {
+            return;
+        }
+        this.#latestMeasureRequestId = undefined;
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: {
+                code: failure.code,
+                correlationId: requestId,
+                message: { defaultMessage: failure.defaultMessage, key: failure.code },
+                retryable: failure.retryable,
+            },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/error',
+        });
+    }
+    // Geometry is stamped with the digest of the render the surface currently shows, and only
+    // markers from the request are answered — requested markers the measurer cannot place are
+    // listed as unknown, extra markers it invents are dropped. A measurement superseded by a
+    // newer request, voided by a reload, or settling after disposal is dropped silently.
+    #settleMeasured(requestId, markers, measurement) {
+        const draftDigest = this.#measuredRenderDigest;
+        if (this.#disposed || this.#latestMeasureRequestId !== requestId || draftDigest === undefined) {
+            return;
+        }
+        this.#latestMeasureRequestId = undefined;
+        const measurements = {};
+        const unknown = [];
+        for (const marker of markers) {
+            const rects = Object.hasOwn(measurement.rects, marker)
+                ? measurement.rects[marker]
+                : undefined;
+            if (rects === undefined || rects.length === 0) {
+                unknown.push(marker);
+            }
+            else {
+                measurements[marker] = rects.map((rect) => ({
+                    height: rect.height,
+                    width: rect.width,
+                    x: rect.x,
+                    y: rect.y,
+                }));
+            }
+        }
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: {
+                draftDigest,
+                measurements,
+                requestId,
+                unknown,
+                viewport: {
+                    devicePixelRatio: measurement.viewport.devicePixelRatio,
+                    height: measurement.viewport.height,
+                    scrollX: measurement.viewport.scrollX,
+                    scrollY: measurement.viewport.scrollY,
+                    width: measurement.viewport.width,
+                },
+            },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/measurements',
+        });
+    }
+    // Renderer failure details never cross the channel: the rejection reason is dropped and a
+    // stable generic error is posted instead, correlated by the request's draft digest.
+    #settleFailure(draftDigest) {
+        if (this.#disposed || this.#latestRenderDigest !== draftDigest) {
+            return;
+        }
+        this.#latestRenderDigest = undefined;
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: {
+                code: 'studio.preview/render-failed',
+                correlationId: draftDigest,
+                message: {
+                    defaultMessage: 'Preview rendering failed.',
+                    key: 'studio.preview/render-failed',
+                },
+                retryable: true,
+            },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/error',
+        });
+    }
+    // The response digest is stamped from the request, so a callback can never answer for a
+    // different draft than the one it was asked to render. Results that were superseded by a
+    // newer request, or that settle after disposal, are dropped silently.
+    #settleRendered(draftDigest, rendered) {
+        if (this.#disposed || this.#latestRenderDigest !== draftDigest) {
+            return;
+        }
+        this.#latestRenderDigest = undefined;
+        // The surface now shows this render; measurements are bound to its digest.
+        this.#measuredRenderDigest = draftDigest;
+        this.#post({
+            channelId: this.#channelId,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            kind: 'preview-message',
+            payload: {
+                diagnostics: rendered.diagnostics,
+                draftDigest,
+                markers: rendered.markers,
+                ...(rendered.markerMap === undefined ? {} : { markerMap: rendered.markerMap }),
+            },
+            sequence: this.#sequence++,
+            sessionGeneration: this.#sessionGeneration,
+            type: 'studio.preview/rendered',
+        });
+    }
+}
+function measureFailed() {
+    return {
+        code: 'studio.preview/measure-failed',
+        defaultMessage: 'Preview measurement failed.',
+        retryable: true,
+    };
+}
+//# sourceMappingURL=preview-host.js.map

package/dist/preview-host.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kumwe/studio-preview",
+  "version": "0.1.0-alpha.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kumwe/studio.git",
+    "directory": "packages/preview"
+  },
+  "homepage": "https://github.com/kumwe/studio/tree/main/packages/preview#readme",
+  "bugs": "https://github.com/kumwe/studio/issues",
+  "description": "Origin-bound request channel for server-rendered Studio previews.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kumwe/studio-protocol": "0.1.0-alpha.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}