@usetheo/ui 0.12.0 → 0.13.1

package/dist/components/primitives/whiteboard/schema.d.ts

@@ -0,0 +1,596 @@
+/**
+ * Zod schema for the Whiteboard JSON v1 (`WhiteboardScene`).
+ *
+ * Design goals (see RFC 0001 §4 and ADR D4 in the plan):
+ *   - LLM-friendly: minimal fields per element.
+ *   - Discriminated union by `type` for exhaustive typing in TS.
+ *   - Defensive against LLM mistakes:
+ *     - EC-3: `.finite()` everywhere — rejects NaN / Infinity.
+ *     - EC-4: `.max()` on dimensions to cap absurd values from the model.
+ */
+import { z } from "zod";
+declare const rectElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"rect">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    roundness: z.ZodOptional<z.ZodEnum<{
+        round: "round";
+        sharp: "sharp";
+    }>>;
+}, z.core.$strip>;
+declare const ellipseElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"ellipse">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const diamondElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"diamond">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const lineElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"line">;
+    to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strip>;
+declare const arrowElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"arrow">;
+    to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    label: z.ZodOptional<z.ZodString>;
+    headStart: z.ZodOptional<z.ZodBoolean>;
+    headEnd: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const textElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    align: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        center: "center";
+    }>>;
+    fontFamily: z.ZodOptional<z.ZodEnum<{
+        mono: "mono";
+        serif: "serif";
+        sans: "sans";
+        hand: "hand";
+    }>>;
+}, z.core.$strip>;
+declare const freedrawElement: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"freedraw">;
+    points: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodOptional<z.ZodNumber>], null>>;
+}, z.core.$strip>;
+export declare const whiteboardElement: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"rect">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    roundness: z.ZodOptional<z.ZodEnum<{
+        round: "round";
+        sharp: "sharp";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"ellipse">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"diamond">;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"line">;
+    to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"arrow">;
+    to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    label: z.ZodOptional<z.ZodString>;
+    headStart: z.ZodOptional<z.ZodBoolean>;
+    headEnd: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    align: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        right: "right";
+        center: "center";
+    }>>;
+    fontFamily: z.ZodOptional<z.ZodEnum<{
+        mono: "mono";
+        serif: "serif";
+        sans: "sans";
+        hand: "hand";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeStyle: z.ZodOptional<z.ZodEnum<{
+        dashed: "dashed";
+        dotted: "dotted";
+        solid: "solid";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillStyle: z.ZodOptional<z.ZodEnum<{
+        solid: "solid";
+        hachure: "hachure";
+        "cross-hatch": "cross-hatch";
+        zigzag: "zigzag";
+    }>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    roughness: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"freedraw">;
+    points: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodOptional<z.ZodNumber>], null>>;
+}, z.core.$strip>], "type">;
+export declare const whiteboardScene: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    background: z.ZodOptional<z.ZodString>;
+    elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"rect">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        roundness: z.ZodOptional<z.ZodEnum<{
+            round: "round";
+            sharp: "sharp";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"ellipse">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"diamond">;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"line">;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"arrow">;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        label: z.ZodOptional<z.ZodString>;
+        headStart: z.ZodOptional<z.ZodBoolean>;
+        headEnd: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        align: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            center: "center";
+        }>>;
+        fontFamily: z.ZodOptional<z.ZodEnum<{
+            mono: "mono";
+            serif: "serif";
+            sans: "sans";
+            hand: "hand";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeStyle: z.ZodOptional<z.ZodEnum<{
+            dashed: "dashed";
+            dotted: "dotted";
+            solid: "solid";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillStyle: z.ZodOptional<z.ZodEnum<{
+            solid: "solid";
+            hachure: "hachure";
+            "cross-hatch": "cross-hatch";
+            zigzag: "zigzag";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        roughness: z.ZodOptional<z.ZodNumber>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"freedraw">;
+        points: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodOptional<z.ZodNumber>], null>>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type WhiteboardElement = z.output<typeof whiteboardElement>;
+export type WhiteboardScene = z.output<typeof whiteboardScene>;
+export type RectElement = z.output<typeof rectElement>;
+export type EllipseElement = z.output<typeof ellipseElement>;
+export type DiamondElement = z.output<typeof diamondElement>;
+export type LineElement = z.output<typeof lineElement>;
+export type ArrowElement = z.output<typeof arrowElement>;
+export type TextElement = z.output<typeof textElement>;
+export type FreedrawElement = z.output<typeof freedrawElement>;
+export type WhiteboardElementInput = z.input<typeof whiteboardElement>;
+export type WhiteboardSceneInput = z.input<typeof whiteboardScene>;
+export {};

package/dist/components/primitives/whiteboard/seed.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Deterministic seed derivation for rough.js — see ADR D9.
+ *
+ * rough.js uses pseudo-randomness to produce the hand-drawn look. Without a
+ * stable seed every render shifts the strokes slightly, breaking snapshot
+ * tests, causing SSR hydration mismatches, and visible jitter when the parent
+ * re-renders. FNV-1a 32-bit gives us a fast, dependency-free hash.
+ */
+/** FNV-1a 32-bit hash. Returns a signed 32-bit integer. */
+export declare function fnv1a32(input: string): number;
+interface SeedableShape {
+    type: string;
+    x: number;
+    y: number;
+    w?: number;
+    h?: number;
+    label?: string;
+    seed?: number;
+}
+/** Return the element's explicit `seed` or derive a stable one from its props. */
+export declare function deriveSeed(el: SeedableShape): number;
+export {};

package/dist/components/primitives/whiteboard/validate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Public validator for `WhiteboardScene` JSON. Wraps Zod and converts errors
+ * into a structured shape that an LLM can consume to self-correct.
+ *
+ * Returns `{ ok: true, scene }` on success or `{ ok: false, errors }` with
+ * each error carrying `{ path, message, code, got? }`. See RFC 0001 §4.
+ */
+import { type WhiteboardScene } from "./schema.js";
+export interface ValidationError {
+    /** Dot-joined Zod path, e.g. "elements.2.type" or "width". */
+    path: string;
+    /** Human-readable explanation (passes through Zod's message). */
+    message: string;
+    /** Zod issue code: `invalid_type`, `too_small`, `invalid_literal`, ... */
+    code: string;
+    /** Actual value received at `path`. Populated for type mismatches, discriminator mismatches, and any issue where Zod's `received` is absent but the value can be recovered by walking the original input along `path`. */
+    got?: unknown;
+}
+export type ValidationResult = {
+    ok: true;
+    scene: WhiteboardScene;
+} | {
+    ok: false;
+    errors: ValidationError[];
+};
+export declare function validateScene(input: unknown): ValidationResult;

package/dist/components/primitives/whiteboard/viewport/use-pointer-pan.d.ts

@@ -0,0 +1,11 @@
+import type { ViewportControls } from "./use-viewport.js";
+/** Attaches pan + zoom listeners to an SVG element. */
+export declare function usePointerPan(ref: React.RefObject<SVGSVGElement | null>, viewport: ViewportControls, size: {
+    width: number;
+    height: number;
+}): {
+    onPointerDown: (e: React.PointerEvent<SVGSVGElement>) => void;
+    onPointerMove: (e: React.PointerEvent<SVGSVGElement>) => void;
+    onPointerUp: (e: React.PointerEvent<SVGSVGElement>) => void;
+    onPointerCancel: (e: React.PointerEvent<SVGSVGElement>) => void;
+};

package/dist/components/primitives/whiteboard/viewport/use-viewport.d.ts

@@ -0,0 +1,33 @@
+export declare const MIN_ZOOM = 0.1;
+export declare const MAX_ZOOM = 8;
+export interface ViewportState {
+    x: number;
+    y: number;
+    zoom: number;
+}
+export interface ViewportSize {
+    width: number;
+    height: number;
+}
+export interface ViewportBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+export interface UseViewportOptions {
+    width: number;
+    height: number;
+    initialZoom?: number;
+    initialCenter?: [number, number];
+}
+export interface ViewportControls {
+    state: ViewportState;
+    pan: (dx: number, dy: number) => void;
+    setZoom: (zoom: number) => void;
+    zoomAt: (screenX: number, screenY: number, delta: number, size: ViewportSize) => void;
+    reset: () => void;
+    fitTo: (bounds: ViewportBounds, size: ViewportSize) => void;
+    viewBox: (size: ViewportSize) => string;
+}
+export declare function useViewport(opts: UseViewportOptions): ViewportControls;