@neta-art/cohub 3.0.0 → 3.2.0

package/dist/protocol/dist/board-document.d.ts

@@ -0,0 +1,1124 @@
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION } from "./board.js";
+import { z } from "zod";
+//#region ../protocol/dist/board-document.d.ts
+declare const BoardFrameSchema: z.ZodObject<{
+  x: z.ZodNumber;
+  y: z.ZodNumber;
+  width: z.ZodNumber;
+  height: z.ZodNumber;
+  rotation: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * The board camera. This is local UI state, not synced content: semantic ops
+ * (see diffBoardDocuments) never describe the viewport, and the editor holds
+ * the live camera separately from the persisted document. Here it only serves
+ * as an initial camera hint when a document is first loaded.
+ */
+declare const BoardViewportSchema: z.ZodObject<{
+  x: z.ZodNumber;
+  y: z.ZodNumber;
+  zoom: z.ZodNumber;
+}, z.core.$strip>;
+declare const BoardAppearanceSchema: z.ZodObject<{
+  theme: z.ZodDefault<z.ZodString>;
+  background: z.ZodDefault<z.ZodObject<{
+    kind: z.ZodDefault<z.ZodEnum<{
+      custom: "custom";
+      dots: "dots";
+      grid: "grid";
+      image: "image";
+      shader: "shader";
+      solid: "solid";
+    }>>;
+    color: z.ZodOptional<z.ZodString>;
+    imageUrl: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  grid: z.ZodDefault<z.ZodObject<{
+    visible: z.ZodDefault<z.ZodBoolean>;
+    size: z.ZodDefault<z.ZodNumber>;
+    opacity: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+  mood: z.ZodDefault<z.ZodEnum<{
+    arcane: "arcane";
+    clean: "clean";
+    cyber: "cyber";
+    natural: "natural";
+    playful: "playful";
+  }>>;
+}, z.core.$strip>;
+/** Optional visual chrome still carried by a few older shapes. */
+declare const BoardItemStyleSchema: z.ZodObject<{
+  variant: z.ZodDefault<z.ZodString>;
+  theme: z.ZodOptional<z.ZodString>;
+  accentColor: z.ZodOptional<z.ZodString>;
+  size: z.ZodDefault<z.ZodEnum<{
+    lg: "lg";
+    md: "md";
+    sm: "sm";
+  }>>;
+  emphasis: z.ZodDefault<z.ZodEnum<{
+    epic: "epic";
+    legendary: "legendary";
+    normal: "normal";
+    rare: "rare";
+  }>>;
+  effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const SpaceFileRefSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"space-file">;
+  path: z.ZodString;
+}, z.core.$strip>;
+declare const BoardMediaSnapshotSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  mimeType: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodNumber>;
+  mtimeMs: z.ZodOptional<z.ZodNumber>;
+  naturalWidth: z.ZodOptional<z.ZodNumber>;
+  naturalHeight: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Freestanding text — no card chrome; its frame always follows the glyphs. */
+declare const BoardTextItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"text">;
+  text: z.ZodDefault<z.ZodString>;
+  color: z.ZodDefault<z.ZodString>;
+  fontSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const BoardNoteItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"note">;
+  text: z.ZodDefault<z.ZodString>;
+  color: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const BoardGeoItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"geo">;
+  geo: z.ZodDefault<z.ZodString>;
+  text: z.ZodDefault<z.ZodString>;
+  color: z.ZodDefault<z.ZodString>;
+  fillOpacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** A raw freehand sample. Pressure defaults to 0.5 (mouse) when absent. */
+declare const DrawPointSchema: z.ZodObject<{
+  x: z.ZodNumber;
+  y: z.ZodNumber;
+  p: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const BoardDrawItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"draw">;
+  points: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    p: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>>;
+  color: z.ZodDefault<z.ZodString>;
+  size: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** An arrow endpoint: a free point or a binding to another shape. */
+declare const ArrowEndpointSchema: z.ZodUnion<readonly [z.ZodObject<{
+  kind: z.ZodLiteral<"point">;
+  x: z.ZodNumber;
+  y: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"binding">;
+  target: z.ZodString;
+  nx: z.ZodDefault<z.ZodNumber>;
+  ny: z.ZodDefault<z.ZodNumber>;
+  precise: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>]>;
+declare const BoardArrowItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"arrow">;
+  start: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"point">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"binding">;
+    target: z.ZodString;
+    nx: z.ZodDefault<z.ZodNumber>;
+    ny: z.ZodDefault<z.ZodNumber>;
+    precise: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>]>;
+  end: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"point">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"binding">;
+    target: z.ZodString;
+    nx: z.ZodDefault<z.ZodNumber>;
+    ny: z.ZodDefault<z.ZodNumber>;
+    precise: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>]>;
+  bend: z.ZodDefault<z.ZodNumber>;
+  color: z.ZodDefault<z.ZodString>;
+  size: z.ZodDefault<z.ZodNumber>;
+  arrowStart: z.ZodDefault<z.ZodBoolean>;
+  arrowEnd: z.ZodDefault<z.ZodBoolean>;
+  label: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/** A frame container for organising shapes. */
+declare const BoardFrameItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"frame">;
+  label: z.ZodDefault<z.ZodString>;
+  color: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/** Image node — space file only, natural aspect, no chrome. */
+declare const BoardImageItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"image">;
+  ref: z.ZodObject<{
+    kind: z.ZodLiteral<"space-file">;
+    path: z.ZodString;
+  }, z.core.$strip>;
+  snapshot: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    mtimeMs: z.ZodOptional<z.ZodNumber>;
+    naturalWidth: z.ZodOptional<z.ZodNumber>;
+    naturalHeight: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+  crop: z.ZodOptional<z.ZodObject<{
+    x: z.ZodDefault<z.ZodNumber>;
+    y: z.ZodDefault<z.ZodNumber>;
+    w: z.ZodDefault<z.ZodNumber>;
+    h: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Video node — space file only. Playback state is local UI, never synced. */
+declare const BoardVideoItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"video">;
+  ref: z.ZodObject<{
+    kind: z.ZodLiteral<"space-file">;
+    path: z.ZodString;
+  }, z.core.$strip>;
+  snapshot: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    mtimeMs: z.ZodOptional<z.ZodNumber>;
+    naturalWidth: z.ZodOptional<z.ZodNumber>;
+    naturalHeight: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Cached display facts for a file card.
+ *
+ * Purely derived from the referenced file and versioned by `mtimeMs`, so it is a
+ * cache and never a second source of truth: the workspace file remains
+ * authoritative, and a stale snapshot is detectable rather than silently wrong.
+ * It is stored so that opening a board renders complete cards immediately, with
+ * no per-node file read on the first paint.
+ */
+declare const BoardFileSnapshotSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  mimeType: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodNumber>;
+  mtimeMs: z.ZodOptional<z.ZodNumber>;
+  excerpt: z.ZodOptional<z.ZodString>;
+  coverPath: z.ZodOptional<z.ZodString>;
+  coverUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * File node — a thumbnail entry point to any workspace file.
+ *
+ * This is the fallback for every dropped file that is not natively an image or
+ * video, including binaries and unknown extensions: a board should never refuse
+ * a file, only present it with less detail. Presentation tiers are derived from
+ * the snapshot (see filePreviewKind), not stored, so there is no display state
+ * to drift from the facts.
+ */
+declare const BoardFileItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"file">;
+  ref: z.ZodObject<{
+    kind: z.ZodLiteral<"space-file">;
+    path: z.ZodString;
+  }, z.core.$strip>;
+  snapshot: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    mtimeMs: z.ZodOptional<z.ZodNumber>;
+    excerpt: z.ZodOptional<z.ZodString>;
+    coverPath: z.ZodOptional<z.ZodString>;
+    coverUrl: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The set of shape types this client understands natively. Anything else is
+ * preserved verbatim as an unknown item (see BoardUnknownItem) so documents
+ * authored by newer clients round-trip losslessly — data is never dropped or
+ * silently downgraded just because this client predates a shape type.
+ */
+declare const KNOWN_BOARD_ITEM_TYPES: readonly ["image", "video", "file", "text", "note", "geo", "draw", "arrow", "frame"];
+type KnownBoardItemType = (typeof KNOWN_BOARD_ITEM_TYPES)[number];
+/**
+ * A forward-compatible carrier for shape types this client does not recognise.
+ * Its discriminant is the literal `"unknown"` so the item union still narrows
+ * cleanly on `type`. The real type string and every original field are preserved
+ * verbatim in `raw`.
+ */
+declare const UNKNOWN_BOARD_ITEM_TYPE: "unknown";
+type BoardUnknownItem = {
+  id: string;
+  type: typeof UNKNOWN_BOARD_ITEM_TYPE;
+  frame: z.infer<typeof BoardFrameSchema>;
+  locked?: boolean;
+  style?: z.infer<typeof BoardItemStyleSchema>;
+  metadata?: Record<string, unknown>;
+  /** Verbatim original item record (carries the real `type`). */
+  raw: Record<string, unknown>;
+};
+/** The real (preserved) type string of an unknown item. */
+declare function unknownRealType(item: BoardUnknownItem): string;
+declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownItem | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "image";
+  ref: {
+    kind: "space-file";
+    path: string;
+  };
+  snapshot?: {
+    title?: string | undefined;
+    mimeType?: string | undefined;
+    size?: number | undefined;
+    mtimeMs?: number | undefined;
+    naturalWidth?: number | undefined;
+    naturalHeight?: number | undefined;
+  } | undefined;
+  crop?: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+  } | undefined;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "video";
+  ref: {
+    kind: "space-file";
+    path: string;
+  };
+  snapshot?: {
+    title?: string | undefined;
+    mimeType?: string | undefined;
+    size?: number | undefined;
+    mtimeMs?: number | undefined;
+    naturalWidth?: number | undefined;
+    naturalHeight?: number | undefined;
+  } | undefined;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "file";
+  ref: {
+    kind: "space-file";
+    path: string;
+  };
+  snapshot?: {
+    title?: string | undefined;
+    mimeType?: string | undefined;
+    size?: number | undefined;
+    mtimeMs?: number | undefined;
+    excerpt?: string | undefined;
+    coverPath?: string | undefined;
+    coverUrl?: string | undefined;
+  } | undefined;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "text";
+  text: string;
+  color: string;
+  fontSize: number;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "note";
+  text: string;
+  color: string;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "geo";
+  geo: string;
+  text: string;
+  color: string;
+  fillOpacity: number;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "draw";
+  points: {
+    x: number;
+    y: number;
+    p: number;
+  }[];
+  color: string;
+  size: number;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "arrow";
+  start: {
+    kind: "point";
+    x: number;
+    y: number;
+  } | {
+    kind: "binding";
+    target: string;
+    nx: number;
+    ny: number;
+    precise: boolean;
+  };
+  end: {
+    kind: "point";
+    x: number;
+    y: number;
+  } | {
+    kind: "binding";
+    target: string;
+    nx: number;
+    ny: number;
+    precise: boolean;
+  };
+  bend: number;
+  color: string;
+  size: number;
+  arrowStart: boolean;
+  arrowEnd: boolean;
+  label: string;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "frame";
+  label: string;
+  color: string;
+}, any>>;
+/**
+ * Parse a single item leniently: known types are validated and normalised;
+ * anything else becomes a lossless unknown item. Never throws on shape data —
+ * a malformed known item degrades to unknown rather than failing the document.
+ */
+declare function parseBoardItemLoose(raw: unknown): BoardItem;
+declare const BoardDocumentSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"cohub.board">;
+  version: z.ZodLiteral<1>;
+  appearance: z.ZodDefault<z.ZodObject<{
+    theme: z.ZodDefault<z.ZodString>;
+    background: z.ZodDefault<z.ZodObject<{
+      kind: z.ZodDefault<z.ZodEnum<{
+        custom: "custom";
+        dots: "dots";
+        grid: "grid";
+        image: "image";
+        shader: "shader";
+        solid: "solid";
+      }>>;
+      color: z.ZodOptional<z.ZodString>;
+      imageUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    grid: z.ZodDefault<z.ZodObject<{
+      visible: z.ZodDefault<z.ZodBoolean>;
+      size: z.ZodDefault<z.ZodNumber>;
+      opacity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    mood: z.ZodDefault<z.ZodEnum<{
+      arcane: "arcane";
+      clean: "clean";
+      cyber: "cyber";
+      natural: "natural";
+      playful: "playful";
+    }>>;
+  }, z.core.$strip>>;
+  viewport: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    zoom: z.ZodNumber;
+  }, z.core.$strip>;
+  items: z.ZodArray<z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownItem | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "image";
+    ref: {
+      kind: "space-file";
+      path: string;
+    };
+    snapshot?: {
+      title?: string | undefined;
+      mimeType?: string | undefined;
+      size?: number | undefined;
+      mtimeMs?: number | undefined;
+      naturalWidth?: number | undefined;
+      naturalHeight?: number | undefined;
+    } | undefined;
+    crop?: {
+      x: number;
+      y: number;
+      w: number;
+      h: number;
+    } | undefined;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "video";
+    ref: {
+      kind: "space-file";
+      path: string;
+    };
+    snapshot?: {
+      title?: string | undefined;
+      mimeType?: string | undefined;
+      size?: number | undefined;
+      mtimeMs?: number | undefined;
+      naturalWidth?: number | undefined;
+      naturalHeight?: number | undefined;
+    } | undefined;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "file";
+    ref: {
+      kind: "space-file";
+      path: string;
+    };
+    snapshot?: {
+      title?: string | undefined;
+      mimeType?: string | undefined;
+      size?: number | undefined;
+      mtimeMs?: number | undefined;
+      excerpt?: string | undefined;
+      coverPath?: string | undefined;
+      coverUrl?: string | undefined;
+    } | undefined;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "text";
+    text: string;
+    color: string;
+    fontSize: number;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "note";
+    text: string;
+    color: string;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "geo";
+    geo: string;
+    text: string;
+    color: string;
+    fillOpacity: number;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "draw";
+    points: {
+      x: number;
+      y: number;
+      p: number;
+    }[];
+    color: string;
+    size: number;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "arrow";
+    start: {
+      kind: "point";
+      x: number;
+      y: number;
+    } | {
+      kind: "binding";
+      target: string;
+      nx: number;
+      ny: number;
+      precise: boolean;
+    };
+    end: {
+      kind: "point";
+      x: number;
+      y: number;
+    } | {
+      kind: "binding";
+      target: string;
+      nx: number;
+      ny: number;
+      precise: boolean;
+    };
+    bend: number;
+    color: string;
+    size: number;
+    arrowStart: boolean;
+    arrowEnd: boolean;
+    label: string;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "frame";
+    label: string;
+    color: string;
+  }, any>>>;
+}, z.core.$strip>;
+type BoardFrame = z.infer<typeof BoardFrameSchema>;
+type BoardViewport = z.infer<typeof BoardViewportSchema>;
+type BoardAppearance = z.infer<typeof BoardAppearanceSchema>;
+type BoardItemStyle = z.infer<typeof BoardItemStyleSchema>;
+type SpaceFileRef = z.infer<typeof SpaceFileRefSchema>;
+type BoardMediaSnapshot = z.infer<typeof BoardMediaSnapshotSchema>;
+type BoardTextItem = z.infer<typeof BoardTextItemSchema>;
+type BoardNoteItem = z.infer<typeof BoardNoteItemSchema>;
+type BoardGeoItem = z.infer<typeof BoardGeoItemSchema>;
+type DrawPoint = z.infer<typeof DrawPointSchema>;
+type BoardDrawItem = z.infer<typeof BoardDrawItemSchema>;
+type ArrowEndpoint = z.infer<typeof ArrowEndpointSchema>;
+type BoardArrowItem = z.infer<typeof BoardArrowItemSchema>;
+type BoardFrameItem = z.infer<typeof BoardFrameItemSchema>;
+type BoardImageItem = z.infer<typeof BoardImageItemSchema>;
+type BoardVideoItem = z.infer<typeof BoardVideoItemSchema>;
+type BoardFileSnapshot = z.infer<typeof BoardFileSnapshotSchema>;
+type BoardFileItem = z.infer<typeof BoardFileItemSchema>;
+/** Known (natively handled) item variants. */
+type BoardKnownItem = BoardImageItem | BoardVideoItem | BoardFileItem | BoardTextItem | BoardNoteItem | BoardGeoItem | BoardDrawItem | BoardArrowItem | BoardFrameItem;
+/** Any item, including forward-compatible unknown types. */
+type BoardItem = BoardKnownItem | BoardUnknownItem;
+type BoardDocument = z.infer<typeof BoardDocumentSchema>;
+declare function isUnknownItem(item: BoardItem): item is BoardUnknownItem;
+declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVideoItem;
+/** Whether an item references a workspace file (image, video or file card). */
+declare function isFileBackedItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardFileItem;
+//#endregion
+export { ArrowEndpoint, ArrowEndpointSchema, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardNoteItem, BoardNoteItemSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardItemLoose, unknownRealType };