@oddkin/workbench 0.0.0-stage → 1.0.0-beta.0

package/dist/preview/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `@oddkin/workbench/preview` — isolated preview frames and preview-owned stylesheets. Each
+ * frame has its own registry and module realm. `reload()` advances its generation for reset or
+ * registration replacement; frames execute trusted project code and are not a security sandbox.
+ * A shared component stylesheet is never mutated: inside one preview scope it is swapped for a
+ * copy, and edits replace the copy's rules without remounting elements (theming-and-styling.md §11).
+ */
+import type { CSSResult } from '@oddkin/core/styles';
+export interface PreviewStyles {
+    /** The preview-owned copy adopted in place of the shared sheet. */
+    readonly sheet: CSSStyleSheet;
+    /** Replace the copy's rules, e.g. with a recipe regenerated from edited conditions. */
+    update(cssText: string): void;
+    /** Swap the copy into roots added to the scope since the last call; returns how many. */
+    refresh(): number;
+    /** Put the shared sheet back everywhere the copy was adopted. */
+    restore(): void;
+}
+/**
+ * Within `scope`, adopt a preview-owned copy of `shared` wherever the shared sheet is adopted.
+ * Roots outside the scope, and the shared sheet itself, are left exactly as they were.
+ */
+export declare function previewStyles(shared: CSSResult, scope: Element): PreviewStyles;
+export { createIsolatedPreview, PreviewFrameError, previewProtocolStats } from './frame.js';
+export type { IsolatedPreview, IsolatedPreviewOptions } from './frame.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preview/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,uFAAuF;IACvF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yFAAyF;IACzF,OAAO,IAAI,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAqBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAgC9E;AAED,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/preview/index.js

@@ -0,0 +1,58 @@
+/** Open shadow roots under `scope`, nested ones included. */
+function shadowRoots(scope) {
+    const roots = [];
+    const visit = (node) => {
+        for (const element of node.querySelectorAll('*')) {
+            if (element.shadowRoot) {
+                roots.push(element.shadowRoot);
+                visit(element.shadowRoot);
+            }
+        }
+    };
+    if (scope.shadowRoot) {
+        roots.push(scope.shadowRoot);
+        visit(scope.shadowRoot);
+    }
+    visit(scope);
+    return roots;
+}
+/**
+ * Within `scope`, adopt a preview-owned copy of `shared` wherever the shared sheet is adopted.
+ * Roots outside the scope, and the shared sheet itself, are left exactly as they were.
+ */
+export function previewStyles(shared, scope) {
+    const doc = scope.ownerDocument;
+    const original = shared.sheetFor(doc);
+    if (!original)
+        throw new Error('previewStyles: constructable stylesheets are unavailable in this document.');
+    const view = doc.defaultView;
+    const sheet = new view.CSSStyleSheet();
+    sheet.replaceSync(shared.cssText);
+    const swapped = new Set();
+    const swap = (root, from, to) => {
+        root.adoptedStyleSheets = root.adoptedStyleSheets.map((s) => (s === from ? to : s));
+    };
+    const refresh = () => {
+        let count = 0;
+        for (const root of shadowRoots(scope))
+            if (!swapped.has(root) && root.adoptedStyleSheets.includes(original)) {
+                swap(root, original, sheet);
+                swapped.add(root);
+                count++;
+            }
+        return count;
+    };
+    refresh();
+    return {
+        sheet,
+        update: (cssText) => sheet.replaceSync(cssText),
+        refresh,
+        restore() {
+            for (const root of swapped)
+                swap(root, sheet, original);
+            swapped.clear();
+        },
+    };
+}
+export { createIsolatedPreview, PreviewFrameError, previewProtocolStats } from './frame.js';
+//# sourceMappingURL=index.js.map

package/dist/preview/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/preview/index.ts"],"names":[],"mappings":"AAoBA,6DAA6D;AAC7D,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,IAA0B,EAAE,EAAE;QAC3C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC/B,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7B,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,KAAc;IAC7D,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,CAAC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,GAAG,CAAC,WAAyC,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;IACvC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAc,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,IAAgB,EAAE,IAAmB,EAAE,EAAiB,EAAE,EAAE;QACxE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,KAAK,EAAE,CAAC;YACV,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,EAAE,CAAC;IACV,OAAO;QACL,KAAK;QACL,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC;QAC/C,OAAO;QACP,OAAO;YACL,KAAK,MAAM,IAAI,IAAI,OAAO;gBAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/preview/theme-generation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Theme generation off the main thread (workbench.md §6.4, theming-and-styling.md §8): one
+ * module Worker running the library's own `@oddkin/tokens/generate`. Latest wins: while a run is
+ * in flight, newer drafts replace each other and only the newest is generated next; a result
+ * for a superseded draft is discarded, never applied.
+ */
+import type { Scope } from '@oddkin/core/scope';
+export interface GenerationDiagnostic {
+    readonly severity?: string;
+    readonly code?: string;
+    readonly path?: string;
+    readonly message?: string;
+}
+export interface GenerationResult {
+    readonly id: number;
+    readonly ok: boolean;
+    readonly css?: string;
+    readonly diagnostics: readonly GenerationDiagnostic[];
+    /** Generation time inside the Worker. */
+    readonly ms: number;
+}
+export interface ThemeGeneration {
+    /** Generate `draft`; supersedes every earlier request that has not produced a result. */
+    request(draft: unknown): void;
+    readonly stats: {
+        readonly sent: number;
+        readonly superseded: number;
+        readonly delivered: number;
+    };
+}
+/** The Worker lives as long as `scope`. */
+export declare function createThemeGeneration(workerUrl: string, scope: Scope, onResult: (result: GenerationResult) => void, onError: (message: string) => void): ThemeGeneration;
+//# sourceMappingURL=theme-generation.d.ts.map

package/dist/preview/theme-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-generation.d.ts","sourceRoot":"","sources":["../../src/preview/theme-generation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,EAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,eAAe,CAyCjB"}

package/dist/preview/theme-generation.js

@@ -0,0 +1,48 @@
+/** The Worker lives as long as `scope`. */
+export function createThemeGeneration(workerUrl, scope, onResult, onError) {
+    const worker = new Worker(workerUrl, { type: 'module', name: 'oddkin-theme-studio' });
+    scope.add(() => worker.terminate(), 'theme generation worker');
+    const stats = { sent: 0, superseded: 0, delivered: 0 };
+    let nextId = 0;
+    let inFlight;
+    let queued;
+    const send = (draft) => {
+        inFlight = ++nextId;
+        stats.sent++;
+        worker.postMessage({ id: inFlight, draft });
+    };
+    scope.listen(worker, 'message', (event) => {
+        if (event.data.id !== inFlight)
+            return;
+        inFlight = undefined;
+        if (queued) {
+            stats.superseded++;
+            const next = queued;
+            queued = undefined;
+            send(next.draft);
+            return;
+        }
+        stats.delivered++;
+        onResult(event.data);
+    });
+    scope.listen(worker, 'error', (event) => {
+        inFlight = undefined;
+        queued = undefined;
+        onError(event.message || 'The theme generator could not be loaded.');
+    });
+    return {
+        request(draft) {
+            if (scope.disposed)
+                return;
+            if (inFlight === undefined)
+                send(draft);
+            else {
+                if (queued)
+                    stats.superseded++;
+                queued = { draft };
+            }
+        },
+        stats,
+    };
+}
+//# sourceMappingURL=theme-generation.js.map

package/dist/preview/theme-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-generation.js","sourceRoot":"","sources":["../../src/preview/theme-generation.ts"],"names":[],"mappings":"AAkCA,2CAA2C;AAC3C,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,KAAY,EACZ,QAA4C,EAC5C,OAAkC;IAElC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;IACtF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAA4B,CAAC;IACjC,IAAI,MAA+C,CAAC;IACpD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;QAC9B,QAAQ,GAAG,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,KAAqC,EAAE,EAAE;QACxE,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ;YAAE,OAAO;QACvC,QAAQ,GAAG,SAAS,CAAC;QACrB,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,UAAU,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,CAAC;YACpB,MAAM,GAAG,SAAS,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,SAAS,EAAE,CAAC;QAClB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,KAAiB,EAAE,EAAE;QAClD,QAAQ,GAAG,SAAS,CAAC;QACrB,MAAM,GAAG,SAAS,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,0CAA0C,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,OAAO;QACL,OAAO,CAAC,KAAK;YACX,IAAI,KAAK,CAAC,QAAQ;gBAAE,OAAO;YAC3B,IAAI,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC;iBACnC,CAAC;gBACJ,IAAI,MAAM;oBAAE,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC/B,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QACD,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,207 @@
+/** DOM-free message contracts shared by the Workbench host and preview frames. */
+export declare const FRAME_PROTOCOL = "oddkin.frame";
+export declare const FRAME_PROTOCOL_VERSION = 1;
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type ExampleId = `example:${string}/${string}`;
+export type EventId = `event:${string}#${string}`;
+export type PropertyId = `property:${string}#${string}`;
+export interface FrameIdentity {
+    readonly frame: string;
+    readonly generation: number;
+}
+export interface FrameSettings {
+    readonly viewport?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly container?: {
+        readonly width: number;
+        readonly height?: number;
+    };
+    readonly direction?: 'ltr' | 'rtl';
+    readonly mode?: 'light' | 'dark';
+    readonly density?: string;
+    readonly product?: string;
+    readonly profile?: string;
+}
+export interface FrameMountPayload {
+    readonly tag: string;
+    readonly registration: string;
+    readonly example: ExampleId;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+    readonly attributes?: Readonly<Record<string, string | null>>;
+    readonly slots?: Readonly<Record<string, string>>;
+    readonly events?: readonly string[];
+    /**
+     * Declared property ↔ event sync pairs (metadata `syncPairs`). After such an event the frame
+     * reports the property's value in a `state` notification (`{ property, value }`); nothing is
+     * inferred from event names.
+     */
+    readonly sync?: readonly {
+        readonly property: string;
+        readonly event: string;
+    }[];
+    readonly settings?: FrameSettings;
+}
+export interface FrameSetPayload {
+    readonly property?: string;
+    readonly value?: JsonValue;
+    readonly unset?: boolean;
+    readonly attribute?: string;
+    readonly attributeValue?: string | null;
+}
+export interface FrameSlotPayload {
+    readonly name: string;
+    readonly text: string;
+}
+/** One element per preview role, mounted together (Theme Studio specimens). */
+export interface FrameSpecimenItem extends FrameMountPayload {
+    /** The preview role this element plays, e.g. `primaryAction`. */
+    readonly role: string;
+    /** Visible caption naming the role. */
+    readonly label: string;
+}
+export interface FrameSpecimenPayload {
+    readonly items: readonly FrameSpecimenItem[];
+    readonly settings?: FrameSettings;
+}
+export interface FrameThemePayload {
+    readonly cssText: string;
+}
+export interface InspectPreviewRequest {
+    /** Stable example id, e.g. `example:odd-button/primary`. */
+    readonly example: ExampleId;
+    readonly settings?: FrameSettings;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+    readonly slots?: Readonly<Record<string, string>>;
+    readonly interactions?: readonly {
+        readonly id: EventId;
+        readonly event: string;
+        readonly target?: string;
+    }[];
+    readonly limits?: {
+        readonly errors?: number;
+        readonly events?: number;
+        readonly state?: number;
+        readonly checks?: number;
+    };
+}
+export interface InspectPreviewResponse {
+    readonly errors: readonly {
+        readonly id: EventId;
+        readonly phase: string;
+        readonly message: string;
+    }[];
+    readonly events: readonly {
+        readonly id: EventId;
+        readonly name: string;
+        readonly time: number;
+        readonly bubbles: boolean;
+        readonly composed: boolean;
+        readonly cancelable: boolean;
+        readonly detail?: JsonValue;
+    }[];
+    readonly state: readonly {
+        readonly id: PropertyId;
+        readonly value: JsonValue;
+    }[];
+    readonly checks: readonly {
+        readonly id: string;
+        readonly status: 'pass' | 'fail' | 'skip';
+        readonly engine: string;
+        readonly version: string;
+        readonly configuration: JsonValue;
+        readonly verification: string;
+    }[];
+    readonly conditions: JsonValue;
+    readonly engine: string;
+    readonly version: string;
+    readonly configuration: JsonValue;
+    readonly truncated: {
+        readonly errors: boolean;
+        readonly events: boolean;
+        readonly state: boolean;
+        readonly checks: boolean;
+    };
+}
+interface Envelope extends FrameIdentity {
+    readonly protocol: typeof FRAME_PROTOCOL;
+    readonly version: number;
+}
+export interface FrameHello extends Envelope {
+    readonly kind: 'hello';
+}
+export interface FrameConnect extends Envelope {
+    readonly kind: 'connect';
+}
+export type FrameRequest = (Envelope & {
+    readonly kind: 'mount';
+    readonly id: number;
+    readonly payload: FrameMountPayload;
+}) | (Envelope & {
+    readonly kind: 'specimen';
+    readonly id: number;
+    readonly payload: FrameSpecimenPayload;
+}) | (Envelope & {
+    readonly kind: 'set';
+    readonly id: number;
+    readonly payload: FrameSetPayload;
+}) | (Envelope & {
+    readonly kind: 'slot';
+    readonly id: number;
+    readonly payload: FrameSlotPayload;
+}) | (Envelope & {
+    readonly kind: 'reset';
+    readonly id: number;
+}) | (Envelope & {
+    readonly kind: 'dispose';
+    readonly id: number;
+}) | (Envelope & {
+    readonly kind: 'theme';
+    readonly id: number;
+    readonly payload: FrameThemePayload;
+}) | (Envelope & {
+    readonly kind: 'settings';
+    readonly id: number;
+    readonly payload: FrameSettings;
+}) | (Envelope & {
+    readonly kind: 'inspect';
+    readonly id: number;
+    readonly payload: InspectPreviewRequest;
+});
+export interface FrameReply extends Envelope {
+    readonly kind: 'reply';
+    readonly replyTo: number;
+    readonly payload?: JsonValue;
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export interface FrameNotification extends Envelope {
+    readonly kind: 'event' | 'error' | 'state' | 'size';
+    readonly payload?: JsonValue;
+}
+export type FrameRequestPayload = Extract<FrameRequest, {
+    readonly payload: unknown;
+}>['payload'];
+export type FrameMessage = FrameHello | FrameConnect | FrameRequest | FrameReply | FrameNotification;
+/** True only for finite, acyclic data that can be transferred as plain JSON without coercion. */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+export declare const isExampleId: (value: unknown) => value is ExampleId;
+export declare function isFrameMountPayload(value: unknown): value is FrameMountPayload;
+export declare function isFrameSpecimenPayload(value: unknown): value is FrameSpecimenPayload;
+/** Validates the common envelope and its JSON payload, without accepting a specific version. */
+export declare function isFrameMessage(value: unknown): value is FrameMessage;
+export declare function isCompatibleFrameMessage(value: unknown): value is FrameMessage;
+export declare const isFrameHello: (value: unknown) => value is FrameHello;
+export declare function isInspectPreviewRequest(value: unknown): value is InspectPreviewRequest;
+export declare function isFrameRequest(value: unknown): value is FrameRequest;
+export declare const isFrameReply: (value: unknown) => value is FrameReply;
+export declare function frameEnvelope<T extends FrameMessage['kind']>(identity: FrameIdentity, kind: T): Envelope & {
+    readonly kind: T;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/protocol/index.js

@@ -0,0 +1,261 @@
+/** DOM-free message contracts shared by the Workbench host and preview frames. */
+export const FRAME_PROTOCOL = 'oddkin.frame';
+export const FRAME_PROTOCOL_VERSION = 1;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** True only for finite, acyclic data that can be transferred as plain JSON without coercion. */
+export function isJsonValue(value) {
+    const active = new WeakSet();
+    const stack = [{ value, exit: false }];
+    while (stack.length) {
+        const item = stack.pop();
+        const current = item.value;
+        if (current === null ||
+            typeof current === 'string' ||
+            typeof current === 'boolean' ||
+            (typeof current === 'number' && Number.isFinite(current)))
+            continue;
+        if (typeof current !== 'object')
+            return false;
+        if (item.exit) {
+            active.delete(current);
+            continue;
+        }
+        if (active.has(current))
+            return false;
+        const array = Array.isArray(current);
+        if (array ? Object.getPrototypeOf(current) !== Array.prototype : !isRecord(current))
+            return false;
+        if (!array) {
+            const prototype = Object.getPrototypeOf(current);
+            if (prototype !== Object.prototype && prototype !== null)
+                return false;
+        }
+        active.add(current);
+        stack.push({ value: current, exit: true });
+        const keys = Reflect.ownKeys(current);
+        if (array) {
+            const list = current;
+            if (keys.length !== list.length + 1 || !keys.includes('length'))
+                return false;
+            for (let i = 0; i < list.length; i++) {
+                const descriptor = Object.getOwnPropertyDescriptor(list, String(i));
+                if (!descriptor?.enumerable || !('value' in descriptor))
+                    return false;
+                stack.push({ value: descriptor.value, exit: false });
+            }
+            continue;
+        }
+        for (const key of keys) {
+            if (typeof key !== 'string')
+                return false;
+            const descriptor = Object.getOwnPropertyDescriptor(current, key);
+            if (!descriptor?.enumerable || !('value' in descriptor))
+                return false;
+            stack.push({ value: descriptor.value, exit: false });
+        }
+    }
+    return true;
+}
+const isPositiveInteger = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+const isStringRecord = (value) => isRecord(value) && Object.values(value).every((item) => typeof item === 'string');
+export const isExampleId = (value) => typeof value === 'string' && /^example:[^/]+\/[^/]+$/.test(value);
+const isEventId = (value) => typeof value === 'string' && /^event:[^#]+#[^#]+$/.test(value);
+function isFrameSettings(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['direction'] !== undefined &&
+        value['direction'] !== 'ltr' &&
+        value['direction'] !== 'rtl')
+        return false;
+    if (value['mode'] !== undefined && value['mode'] !== 'light' && value['mode'] !== 'dark')
+        return false;
+    for (const key of ['density', 'product', 'profile'])
+        if (value[key] !== undefined && typeof value[key] !== 'string')
+            return false;
+    for (const key of ['viewport', 'container']) {
+        const size = value[key];
+        if (size === undefined)
+            continue;
+        if (!isRecord(size) ||
+            typeof size['width'] !== 'number' ||
+            !Number.isFinite(size['width']) ||
+            size['width'] <= 0)
+            return false;
+        if (size['height'] !== undefined &&
+            (typeof size['height'] !== 'number' ||
+                !Number.isFinite(size['height']) ||
+                size['height'] <= 0))
+            return false;
+    }
+    return true;
+}
+export function isFrameMountPayload(value) {
+    if (!isRecord(value) ||
+        typeof value['tag'] !== 'string' ||
+        typeof value['registration'] !== 'string' ||
+        !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/.test(value['tag']) ||
+        !isExampleId(value['example']) ||
+        !value['example'].startsWith(`example:${value['tag']}/`))
+        return false;
+    if (value['properties'] !== undefined && !isJsonValue(value['properties']))
+        return false;
+    if (value['attributes'] !== undefined) {
+        const attributes = value['attributes'];
+        if (!isRecord(attributes) ||
+            !Object.values(attributes).every((item) => item === null || typeof item === 'string'))
+            return false;
+    }
+    if (value['slots'] !== undefined && !isStringRecord(value['slots']))
+        return false;
+    if (value['events'] !== undefined &&
+        (!Array.isArray(value['events']) || !value['events'].every((item) => typeof item === 'string')))
+        return false;
+    if (value['sync'] !== undefined &&
+        (!Array.isArray(value['sync']) ||
+            !value['sync'].every((pair) => isRecord(pair) &&
+                typeof pair['property'] === 'string' &&
+                typeof pair['event'] === 'string')))
+        return false;
+    return value['settings'] === undefined || isFrameSettings(value['settings']);
+}
+export function isFrameSpecimenPayload(value) {
+    return (isRecord(value) &&
+        Array.isArray(value['items']) &&
+        value['items'].every((item) => isFrameMountPayload(item) &&
+            typeof item['role'] === 'string' &&
+            typeof item['label'] === 'string') &&
+        (value['settings'] === undefined || isFrameSettings(value['settings'])));
+}
+/** Validates the common envelope and its JSON payload, without accepting a specific version. */
+export function isFrameMessage(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['protocol'] !== FRAME_PROTOCOL ||
+        !Number.isSafeInteger(value['version']) ||
+        typeof value['frame'] !== 'string' ||
+        value['frame'].length === 0 ||
+        !isPositiveInteger(value['generation']) ||
+        typeof value['kind'] !== 'string')
+        return false;
+    const hasPayload = Object.hasOwn(value, 'payload');
+    if (hasPayload && !isJsonValue(value['payload']))
+        return false;
+    switch (value['kind']) {
+        case 'hello':
+        case 'connect':
+            return !Object.hasOwn(value, 'id') && !Object.hasOwn(value, 'replyTo');
+        case 'mount':
+        case 'specimen':
+        case 'set':
+        case 'slot':
+        case 'reset':
+        case 'theme':
+        case 'settings':
+        case 'dispose':
+        case 'inspect':
+            return isPositiveInteger(value['id']) && !Object.hasOwn(value, 'replyTo');
+        case 'reply':
+            return (isPositiveInteger(value['replyTo']) &&
+                !(Object.hasOwn(value, 'payload') && Object.hasOwn(value, 'error')) &&
+                (!Object.hasOwn(value, 'error') ||
+                    (isRecord(value['error']) &&
+                        typeof value['error']['code'] === 'string' &&
+                        typeof value['error']['message'] === 'string')));
+        case 'event':
+        case 'error':
+        case 'state':
+        case 'size':
+            return !Object.hasOwn(value, 'id') && !Object.hasOwn(value, 'replyTo');
+        default:
+            return false;
+    }
+}
+export function isCompatibleFrameMessage(value) {
+    return isFrameMessage(value) && value.version === FRAME_PROTOCOL_VERSION;
+}
+export const isFrameHello = (value) => isCompatibleFrameMessage(value) && value.kind === 'hello';
+export function isInspectPreviewRequest(value) {
+    if (!isRecord(value) || !isExampleId(value['example']))
+        return false;
+    if ((value['settings'] !== undefined && !isFrameSettings(value['settings'])) ||
+        (value['properties'] !== undefined && !isJsonValue(value['properties'])) ||
+        (value['slots'] !== undefined && !isStringRecord(value['slots'])))
+        return false;
+    const limits = value['limits'];
+    if (limits !== undefined &&
+        (!isRecord(limits) ||
+            !['errors', 'events', 'state', 'checks'].every((key) => {
+                const limit = limits[key];
+                return (limit === undefined ||
+                    (typeof limit === 'number' && Number.isSafeInteger(limit) && limit >= 0));
+            })))
+        return false;
+    const interactions = value['interactions'];
+    return (interactions === undefined ||
+        (Array.isArray(interactions) &&
+            interactions.every((item) => isRecord(item) &&
+                isEventId(item['id']) &&
+                typeof item['event'] === 'string' &&
+                (item['target'] === undefined || typeof item['target'] === 'string'))));
+}
+export function isFrameRequest(value) {
+    if (!isCompatibleFrameMessage(value))
+        return false;
+    if (![
+        'mount',
+        'specimen',
+        'set',
+        'slot',
+        'reset',
+        'theme',
+        'settings',
+        'dispose',
+        'inspect',
+    ].includes(value.kind))
+        return false;
+    const request = value;
+    switch (request.kind) {
+        case 'mount':
+            return isFrameMountPayload(request.payload);
+        case 'specimen':
+            return isFrameSpecimenPayload(request.payload);
+        case 'set': {
+            if (!isRecord(request.payload))
+                return false;
+            const hasProperty = typeof request.payload['property'] === 'string';
+            const hasAttribute = typeof request.payload['attribute'] === 'string';
+            if (hasProperty === hasAttribute)
+                return false;
+            return hasProperty
+                ? (request.payload['unset'] === true ||
+                    (Object.hasOwn(request.payload, 'value') && isJsonValue(request.payload['value']))) &&
+                    (request.payload['unset'] !== true || !Object.hasOwn(request.payload, 'value'))
+                : request.payload['attributeValue'] === null ||
+                    typeof request.payload['attributeValue'] === 'string';
+        }
+        case 'slot':
+            return (isRecord(request.payload) &&
+                typeof request.payload['name'] === 'string' &&
+                typeof request.payload['text'] === 'string');
+        case 'reset':
+        case 'dispose':
+            return !Object.hasOwn(request, 'payload');
+        case 'theme':
+            return isRecord(request.payload) && typeof request.payload['cssText'] === 'string';
+        case 'settings':
+            return isFrameSettings(request.payload);
+        case 'inspect':
+            return isInspectPreviewRequest(request.payload);
+    }
+}
+export const isFrameReply = (value) => isCompatibleFrameMessage(value) && value.kind === 'reply';
+export function frameEnvelope(identity, kind) {
+    return {
+        protocol: FRAME_PROTOCOL,
+        version: FRAME_PROTOCOL_VERSION,
+        frame: identity.frame,
+        generation: identity.generation,
+        kind,
+    };
+}
+//# sourceMappingURL=index.js.map