@ericsanchezok/synergy-util 3.0.23 → 3.1.0

package/dist/render-artifact.d.ts

@@ -0,0 +1,352 @@
+import { z } from "zod";
+/** Portable render protocol shared by the Media owner and its untrusted UI runtime. */
+export declare namespace RenderArtifact {
+    const MIME = "application/vnd.synergy.visual+json";
+    const SOURCE_BYTES: number;
+    const STATE_BYTES: number;
+    const IMAGE_URL_LIMIT: number;
+    const Library: z.ZodEnum<{
+        chart: "chart";
+        d3: "d3";
+        mermaid: "mermaid";
+    }>;
+    const ID: z.ZodString;
+    const Source: z.ZodObject<{
+        format: z.ZodLiteral<"synergy.visual">;
+        version: z.ZodLiteral<1>;
+        id: z.ZodString;
+        mode: z.ZodEnum<{
+            interactive: "interactive";
+            static: "static";
+        }>;
+        title: z.ZodString;
+        layout: z.ZodEnum<{
+            normal: "normal";
+            wide: "wide";
+        }>;
+        libraries: z.ZodArray<z.ZodEnum<{
+            chart: "chart";
+            d3: "d3";
+            mermaid: "mermaid";
+        }>>;
+        renderer: z.ZodOptional<z.ZodEnum<{
+            html: "html";
+            native: "native";
+        }>>;
+        ui: z.ZodOptional<z.ZodObject<{
+            state: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            computed: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                op: z.ZodEnum<{
+                    add: "add";
+                    divide: "divide";
+                    max: "max";
+                    min: "min";
+                    multiply: "multiply";
+                    subtract: "subtract";
+                }>;
+                inputs: z.ZodTuple<[z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                    ref: z.ZodString;
+                }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                    ref: z.ZodString;
+                }, z.core.$strict>]>], null>;
+            }, z.core.$strict>>>;
+            nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"heading">;
+                text: z.ZodString;
+                level: z.ZodOptional<z.ZodEnum<{
+                    2: "2";
+                    3: "3";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"row">;
+                columns: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"card">;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"metric">;
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                    ref: z.ZodString;
+                }, z.core.$strict>]>;
+                prefix: z.ZodOptional<z.ZodString>;
+                suffix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"slider">;
+                label: z.ZodString;
+                state: z.ZodString;
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+                step: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"select">;
+                label: z.ZodString;
+                state: z.ZodString;
+                options: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"checkbox">;
+                label: z.ZodString;
+                state: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"button">;
+                label: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                parent: z.ZodOptional<z.ZodString>;
+                type: z.ZodLiteral<"bar">;
+                label: z.ZodString;
+                items: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                        ref: z.ZodString;
+                    }, z.core.$strict>]>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>;
+        html: z.ZodString;
+        replaces: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    type Source = z.infer<typeof Source>;
+    const Descriptor: z.ZodObject<{
+        format: z.ZodLiteral<"synergy.visual">;
+        version: z.ZodLiteral<1>;
+        id: z.ZodString;
+        mode: z.ZodEnum<{
+            interactive: "interactive";
+            static: "static";
+        }>;
+        title: z.ZodString;
+        layout: z.ZodEnum<{
+            normal: "normal";
+            wide: "wide";
+        }>;
+        libraries: z.ZodArray<z.ZodEnum<{
+            chart: "chart";
+            d3: "d3";
+            mermaid: "mermaid";
+        }>>;
+        renderer: z.ZodOptional<z.ZodEnum<{
+            html: "html";
+            native: "native";
+        }>>;
+        replaces: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+    }, z.core.$strict>;
+    type Descriptor = z.infer<typeof Descriptor>;
+    const Content: z.ZodObject<{
+        modelContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+        uiContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+    }, z.core.$strict>;
+    type Content = z.infer<typeof Content>;
+    const State: z.ZodObject<{
+        revision: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        mutationID: z.ZodOptional<z.ZodString>;
+        content: z.ZodObject<{
+            modelContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+            uiContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    type State = z.infer<typeof State>;
+    const Write: z.ZodObject<{
+        revision: z.ZodNumber;
+        mutationID: z.ZodString;
+        content: z.ZodObject<{
+            modelContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+            uiContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    type Write = z.infer<typeof Write>;
+    const Target: z.ZodObject<{
+        sessionID: z.ZodString;
+        messageID: z.ZodString;
+        partID: z.ZodString;
+    }, z.core.$strict>;
+    type Target = z.infer<typeof Target>;
+    const Snapshot: z.ZodObject<{
+        descriptor: z.ZodObject<{
+            format: z.ZodLiteral<"synergy.visual">;
+            version: z.ZodLiteral<1>;
+            id: z.ZodString;
+            mode: z.ZodEnum<{
+                interactive: "interactive";
+                static: "static";
+            }>;
+            title: z.ZodString;
+            layout: z.ZodEnum<{
+                normal: "normal";
+                wide: "wide";
+            }>;
+            libraries: z.ZodArray<z.ZodEnum<{
+                chart: "chart";
+                d3: "d3";
+                mermaid: "mermaid";
+            }>>;
+            renderer: z.ZodOptional<z.ZodEnum<{
+                html: "html";
+                native: "native";
+            }>>;
+            replaces: z.ZodOptional<z.ZodString>;
+            source: z.ZodString;
+        }, z.core.$strict>;
+        source: z.ZodObject<{
+            format: z.ZodLiteral<"synergy.visual">;
+            version: z.ZodLiteral<1>;
+            id: z.ZodString;
+            mode: z.ZodEnum<{
+                interactive: "interactive";
+                static: "static";
+            }>;
+            title: z.ZodString;
+            layout: z.ZodEnum<{
+                normal: "normal";
+                wide: "wide";
+            }>;
+            libraries: z.ZodArray<z.ZodEnum<{
+                chart: "chart";
+                d3: "d3";
+                mermaid: "mermaid";
+            }>>;
+            renderer: z.ZodOptional<z.ZodEnum<{
+                html: "html";
+                native: "native";
+            }>>;
+            ui: z.ZodOptional<z.ZodObject<{
+                state: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+                computed: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    op: z.ZodEnum<{
+                        add: "add";
+                        divide: "divide";
+                        max: "max";
+                        min: "min";
+                        multiply: "multiply";
+                        subtract: "subtract";
+                    }>;
+                    inputs: z.ZodTuple<[z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                        ref: z.ZodString;
+                    }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                        ref: z.ZodString;
+                    }, z.core.$strict>]>], null>;
+                }, z.core.$strict>>>;
+                nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"heading">;
+                    text: z.ZodString;
+                    level: z.ZodOptional<z.ZodEnum<{
+                        2: "2";
+                        3: "3";
+                    }>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"text">;
+                    text: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"row">;
+                    columns: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"card">;
+                    title: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"metric">;
+                    label: z.ZodString;
+                    value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                        ref: z.ZodString;
+                    }, z.core.$strict>]>;
+                    prefix: z.ZodOptional<z.ZodString>;
+                    suffix: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"slider">;
+                    label: z.ZodString;
+                    state: z.ZodString;
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    step: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"select">;
+                    label: z.ZodString;
+                    state: z.ZodString;
+                    options: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"checkbox">;
+                    label: z.ZodString;
+                    state: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"button">;
+                    label: z.ZodString;
+                    text: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    id: z.ZodString;
+                    parent: z.ZodOptional<z.ZodString>;
+                    type: z.ZodLiteral<"bar">;
+                    label: z.ZodString;
+                    items: z.ZodArray<z.ZodObject<{
+                        label: z.ZodString;
+                        value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                            ref: z.ZodString;
+                        }, z.core.$strict>]>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>], "type">>;
+            }, z.core.$strict>>;
+            html: z.ZodString;
+            replaces: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        state: z.ZodObject<{
+            revision: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            mutationID: z.ZodOptional<z.ZodString>;
+            content: z.ZodObject<{
+                modelContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+                uiContent: z.ZodOptional<z.ZodType<z.JSONType, unknown, z.core.$ZodTypeInternals<z.JSONType, unknown>>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strip>;
+    const FollowUp: z.ZodObject<{
+        requestID: z.ZodString;
+        text: z.ZodString;
+        image: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    type FollowUp = z.infer<typeof FollowUp>;
+    function emptyState(): State;
+    function descriptor(metadata: unknown): Descriptor | undefined;
+    function state(metadata: unknown): State;
+}

package/dist/render-artifact.js

@@ -0,0 +1,115 @@
+import { z } from "zod";
+import { JsonValue } from "./json-value";
+import { RenderUI } from "./render-ui";
+/** Portable render protocol shared by the Media owner and its untrusted UI runtime. */
+export var RenderArtifact;
+(function (RenderArtifact) {
+    RenderArtifact.MIME = "application/vnd.synergy.visual+json";
+    RenderArtifact.SOURCE_BYTES = 1024 * 1024;
+    RenderArtifact.STATE_BYTES = 16 * 1024;
+    RenderArtifact.IMAGE_URL_LIMIT = 350 * 1024;
+    RenderArtifact.Library = z.enum(["d3", "chart", "mermaid"]);
+    RenderArtifact.ID = z.string().uuid();
+    const SourceFields = z
+        .object({
+        format: z.literal("synergy.visual"),
+        version: z.literal(1),
+        id: RenderArtifact.ID,
+        mode: z.enum(["static", "interactive"]),
+        title: z.string().min(1).max(160),
+        layout: z.enum(["normal", "wide"]),
+        libraries: z.array(RenderArtifact.Library).max(3),
+        renderer: z.enum(["native", "html"]).optional(),
+        ui: RenderUI.Spec.optional(),
+        html: z
+            .string()
+            .min(1)
+            .refine((text) => new TextEncoder().encode(text).byteLength <= RenderArtifact.SOURCE_BYTES, "HTML exceeds 1 MiB"),
+        replaces: RenderArtifact.ID.optional(),
+    })
+        .strict();
+    RenderArtifact.Source = SourceFields.superRefine((source, ctx) => {
+        if ((source.renderer === "native") !== (source.ui !== undefined))
+            ctx.addIssue({ code: "custom", message: "Native sources require ui; HTML sources cannot contain ui" });
+        if (source.ui && source.libraries.length)
+            ctx.addIssue({ code: "custom", message: "Native sources cannot load libraries" });
+    }).meta({ ref: "RenderSource" });
+    RenderArtifact.Descriptor = SourceFields.omit({ html: true, ui: true })
+        .extend({
+        source: z.string().regex(/^asset:\/\/[a-f0-9]{16}\.bin$/),
+    })
+        .strict()
+        .meta({ ref: "RenderDescriptor" });
+    RenderArtifact.Content = z
+        .object({
+        modelContent: JsonValue.optional(),
+        uiContent: JsonValue.optional(),
+    })
+        .strict()
+        .refine((value) => {
+        try {
+            return new TextEncoder().encode(JSON.stringify(value)).byteLength <= RenderArtifact.STATE_BYTES;
+        }
+        catch {
+            return false;
+        }
+    }, "State exceeds 16 KiB")
+        .meta({ ref: "RenderContent" });
+    RenderArtifact.State = z
+        .object({
+        revision: z.number().int().nonnegative(),
+        updatedAt: z.number().nonnegative(),
+        mutationID: z.string().max(100).optional(),
+        content: RenderArtifact.Content,
+    })
+        .strict()
+        .meta({ ref: "RenderState" });
+    RenderArtifact.Write = z
+        .object({
+        revision: z.number().int().nonnegative(),
+        mutationID: z.string().min(1).max(100),
+        content: RenderArtifact.Content,
+    })
+        .strict()
+        .meta({ ref: "RenderStateWrite" });
+    RenderArtifact.Target = z
+        .object({
+        sessionID: z.string().regex(/^ses_[\w]+$/),
+        messageID: z.string().regex(/^msg_[\w]+$/),
+        partID: z.string().regex(/^prt_[\w]+$/),
+    })
+        .strict()
+        .meta({ ref: "RenderTarget" });
+    RenderArtifact.Snapshot = z
+        .object({ descriptor: RenderArtifact.Descriptor, source: RenderArtifact.Source, state: RenderArtifact.State })
+        .meta({ ref: "RenderSnapshot" });
+    RenderArtifact.FollowUp = z
+        .object({
+        requestID: z.string().min(1).max(100),
+        text: z.string().trim().min(1).max(8000),
+        image: z
+            .string()
+            .max(RenderArtifact.IMAGE_URL_LIMIT)
+            .regex(/^data:image\/png;base64,iVBORw0KGgo[A-Za-z0-9+/]*={0,2}$/)
+            .optional(),
+    })
+        .strict();
+    function emptyState() {
+        return { revision: 0, updatedAt: 0, content: {} };
+    }
+    RenderArtifact.emptyState = emptyState;
+    function descriptor(metadata) {
+        if (!metadata || typeof metadata !== "object" || !("visual" in metadata))
+            return;
+        const result = RenderArtifact.Descriptor.safeParse(metadata.visual);
+        return result.success ? result.data : undefined;
+    }
+    RenderArtifact.descriptor = descriptor;
+    function state(metadata) {
+        if (!metadata || typeof metadata !== "object" || !("visualState" in metadata))
+            return emptyState();
+        const result = RenderArtifact.State.safeParse(metadata.visualState);
+        return result.success ? result.data : emptyState();
+    }
+    RenderArtifact.state = state;
+})(RenderArtifact || (RenderArtifact = {}));

package/dist/render-ui.d.ts

@@ -0,0 +1,202 @@
+import { z } from "zod";
+export declare namespace RenderUI {
+    const Key: z.ZodString;
+    const Value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    type Value = z.infer<typeof Value>;
+    const Binding: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+        ref: z.ZodString;
+    }, z.core.$strict>]>;
+    type Binding = z.infer<typeof Binding>;
+    const Node: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"heading">;
+        text: z.ZodString;
+        level: z.ZodOptional<z.ZodEnum<{
+            2: "2";
+            3: "3";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"row">;
+        columns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"card">;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"metric">;
+        label: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+            ref: z.ZodString;
+        }, z.core.$strict>]>;
+        prefix: z.ZodOptional<z.ZodString>;
+        suffix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"slider">;
+        label: z.ZodString;
+        state: z.ZodString;
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        step: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"select">;
+        label: z.ZodString;
+        state: z.ZodString;
+        options: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"checkbox">;
+        label: z.ZodString;
+        state: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"button">;
+        label: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"bar">;
+        label: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                ref: z.ZodString;
+            }, z.core.$strict>]>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "type">;
+    type Node = z.infer<typeof Node>;
+    const Computed: z.ZodObject<{
+        id: z.ZodString;
+        op: z.ZodEnum<{
+            add: "add";
+            divide: "divide";
+            max: "max";
+            min: "min";
+            multiply: "multiply";
+            subtract: "subtract";
+        }>;
+        inputs: z.ZodTuple<[z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+            ref: z.ZodString;
+        }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+            ref: z.ZodString;
+        }, z.core.$strict>]>], null>;
+    }, z.core.$strict>;
+    const Spec: z.ZodObject<{
+        state: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        computed: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            op: z.ZodEnum<{
+                add: "add";
+                divide: "divide";
+                max: "max";
+                min: "min";
+                multiply: "multiply";
+                subtract: "subtract";
+            }>;
+            inputs: z.ZodTuple<[z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                ref: z.ZodString;
+            }, z.core.$strict>]>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                ref: z.ZodString;
+            }, z.core.$strict>]>], null>;
+        }, z.core.$strict>>>;
+        nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"heading">;
+            text: z.ZodString;
+            level: z.ZodOptional<z.ZodEnum<{
+                2: "2";
+                3: "3";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"row">;
+            columns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"card">;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"metric">;
+            label: z.ZodString;
+            value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                ref: z.ZodString;
+            }, z.core.$strict>]>;
+            prefix: z.ZodOptional<z.ZodString>;
+            suffix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"slider">;
+            label: z.ZodString;
+            state: z.ZodString;
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            step: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"select">;
+            label: z.ZodString;
+            state: z.ZodString;
+            options: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"checkbox">;
+            label: z.ZodString;
+            state: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"button">;
+            label: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            parent: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"bar">;
+            label: z.ZodString;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodObject<{
+                    ref: z.ZodString;
+                }, z.core.$strict>]>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>;
+    type Spec = z.infer<typeof Spec>;
+    /**
+     * Provenance: https://www.openui.com/blog/how-chatgpt-intelligent-ui-works
+     * Local adaptation: bounded declarative data, keyed controls and local arithmetic replace authored programs.
+     */
+    function evaluate(spec: Spec, state: Record<string, Value>): Record<string, Value>;
+    function preview(input: unknown): Spec | undefined;
+    function fallback(spec: Spec): string;
+}