@neta-art/cohub 6.0.0 → 7.0.0

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

@@ -100,6 +100,7 @@ declare const BoardTextItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -133,6 +134,7 @@ declare const BoardGeoItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -178,6 +180,7 @@ declare const BoardDrawItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -224,6 +227,7 @@ declare const BoardArrowItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -269,6 +273,7 @@ declare const BoardFrameItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -302,6 +307,7 @@ declare const BoardImageItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -351,6 +357,7 @@ declare const BoardVideoItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -394,6 +401,7 @@ declare const BoardAudioItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -464,6 +472,7 @@ declare const BoardFileItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -591,6 +600,7 @@ declare const BoardTaskItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -678,6 +688,7 @@ type BoardUnknownItem = {
   id: string;
   type: typeof UNKNOWN_BOARD_ITEM_TYPE;
   frame: z.infer<typeof BoardFrameSchema>;
+  parentId?: string | null;
   locked?: boolean;
   style?: z.infer<typeof BoardItemStyleSchema>;
   metadata?: Record<string, unknown>;
@@ -695,6 +706,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -733,6 +745,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -765,6 +778,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -798,6 +812,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -831,6 +846,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -893,6 +909,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -916,6 +933,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -940,6 +958,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -967,6 +986,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -1001,6 +1021,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -1078,6 +1099,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1116,6 +1138,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1148,6 +1171,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1181,6 +1205,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1214,6 +1239,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1276,6 +1302,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1299,6 +1326,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1323,6 +1351,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1350,6 +1379,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1384,6 +1414,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1401,7 +1432,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
   connections: z.ZodDefault<z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     source: z.ZodObject<{
-      nodeId: z.ZodString;
+      itemId: z.ZodString;
       portId: z.ZodOptional<z.ZodString>;
       anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"auto">;
@@ -1421,7 +1452,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       }, z.core.$strip>]>>;
     }, z.core.$strip>;
     target: z.ZodObject<{
-      nodeId: z.ZodString;
+      itemId: z.ZodString;
       portId: z.ZodOptional<z.ZodString>;
       anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"auto">;
@@ -1469,7 +1500,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       }>>;
     }, z.core.$strip>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>>>;
+  }, z.core.$strict>>>;
 }, z.core.$strip>;
 type BoardFrame = z.infer<typeof BoardFrameSchema>;
 type BoardViewport = z.infer<typeof BoardViewportSchema>;

package/dist/protocol/dist/board-document.js

@@ -100,6 +100,7 @@ const BoardMediaSnapshotSchema = z.object({
 const BoardItemBaseSchema = z.object({
 	id: z.string().min(1),
 	frame: BoardFrameSchema,
+	parentId: z.string().min(1).nullable().optional(),
 	/** When true the shape cannot be moved, resized, or deleted. */
 	locked: z.boolean().optional(),
 	style: BoardItemStyleSchema.optional(),
@@ -378,6 +379,7 @@ function makeUnknownItem(raw) {
 			height: 80,
 			rotation: 0
 		},
+		...typeof record.parentId === "string" || record.parentId === null ? { parentId: record.parentId } : {},
 		...record.locked === true ? { locked: true } : {},
 		...styleParsed.success && record.style ? { style: styleParsed.data } : {},
 		...record.metadata && typeof record.metadata === "object" ? { metadata: record.metadata } : {},
@@ -431,7 +433,7 @@ function parseBoardDocument(input) {
 function withResolvedConnections(document) {
 	if (document.connections.length === 0) return document;
 	const ids = new Set(document.items.map((item) => item.id));
-	const connections = document.connections.filter((connection) => ids.has(connection.source.nodeId) && ids.has(connection.target.nodeId));
+	const connections = document.connections.filter((connection) => ids.has(connection.source.itemId) && ids.has(connection.target.itemId));
 	return connections.length === document.connections.length ? document : {
 		...document,
 		connections

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

@@ -0,0 +1,94 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-effect.d.ts
+declare const BoardAssetRefSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    extension: "extension";
+    "space-file": "space-file";
+  }>;
+  ref: z.ZodString;
+  digest: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const BoardEffectSchema: z.ZodObject<{
+  id: z.ZodString;
+  boardId: z.ZodString;
+  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"board">;
+  }, z.core.$strict>], "type">;
+  kind: z.ZodString;
+  kindVersion: z.ZodNumber;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  lifecycle: z.ZodEnum<{
+    manual: "manual";
+    persistent: "persistent";
+    "when-visible": "when-visible";
+  }>;
+  timeOrigin: z.ZodEnum<{
+    activation: "activation";
+    board: "board";
+    visible: "visible";
+  }>;
+  layer: z.ZodDefault<z.ZodEnum<{
+    behind: "behind";
+    front: "front";
+    screen: "screen";
+  }>>;
+  seed: z.ZodString;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  assetRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      extension: "extension";
+      "space-file": "space-file";
+    }>;
+    ref: z.ZodString;
+    digest: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  revision: z.ZodNumber;
+}, z.core.$strict>;
+type BoardAssetRef = z.infer<typeof BoardAssetRefSchema>;
+type BoardEffect = z.infer<typeof BoardEffectSchema>;
+/** The client-authored effect form: no server-owned `boardId`/`revision`. */
+declare const BoardEffectInputSchema: z.ZodObject<{
+  id: z.ZodString;
+  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"board">;
+  }, z.core.$strict>], "type">;
+  kind: z.ZodString;
+  kindVersion: z.ZodNumber;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  lifecycle: z.ZodEnum<{
+    manual: "manual";
+    persistent: "persistent";
+    "when-visible": "when-visible";
+  }>;
+  timeOrigin: z.ZodEnum<{
+    activation: "activation";
+    board: "board";
+    visible: "visible";
+  }>;
+  layer: z.ZodDefault<z.ZodEnum<{
+    behind: "behind";
+    front: "front";
+    screen: "screen";
+  }>>;
+  seed: z.ZodString;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  assetRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      extension: "extension";
+      "space-file": "space-file";
+    }>;
+    ref: z.ZodString;
+    digest: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+type BoardEffectInput = z.infer<typeof BoardEffectInputSchema>;
+//#endregion
+export { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema };

package/dist/protocol/dist/board-effect.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-effect.js
+/**
+* Board effect schema, isolated so `board-authoring.ts` can reuse the exact
+* definition without a runtime cycle through `board.ts`. One definition, one
+* strictness level — semantic mutations and Board create must not drift apart.
+*/
+const idSchema = z.string().min(1).max(160);
+const extensionIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+const BoardAssetRefSchema = z.object({
+	type: z.enum(["space-file", "extension"]),
+	ref: z.string().min(1).max(4096),
+	digest: z.string().min(16).max(160).optional()
+}).strict();
+const BoardEffectSchema = z.object({
+	id: idSchema,
+	boardId: z.string().uuid(),
+	target: z.discriminatedUnion("type", [z.object({
+		type: z.literal("item"),
+		itemId: idSchema
+	}).strict(), z.object({ type: z.literal("board") }).strict()]),
+	kind: extensionIdSchema,
+	kindVersion: z.number().int().positive(),
+	enabled: z.boolean().default(true),
+	lifecycle: z.enum([
+		"persistent",
+		"when-visible",
+		"manual"
+	]),
+	timeOrigin: z.enum([
+		"board",
+		"visible",
+		"activation"
+	]),
+	layer: z.enum([
+		"behind",
+		"front",
+		"screen"
+	]).default("front"),
+	seed: z.string().min(1).max(160),
+	params: jsonObjectSchema.default({}),
+	assetRefs: z.array(BoardAssetRefSchema).default([]),
+	metadata: jsonObjectSchema.default({}),
+	revision: z.number().int().nonnegative()
+}).strict();
+/** The client-authored effect form: no server-owned `boardId`/`revision`. */
+const BoardEffectInputSchema = BoardEffectSchema.omit({
+	boardId: true,
+	revision: true
+});
+//#endregion
+export { BoardAssetRefSchema, BoardEffectInputSchema, BoardEffectSchema };

package/dist/protocol/dist/board-json.js

@@ -0,0 +1,16 @@
+//#region ../protocol/dist/board-json.js
+/** Structural equality for JSON-shaped semantic values. */
+function boardJsonEquals(a, b) {
+	if (a === b) return true;
+	if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) return Number.isNaN(a) && Number.isNaN(b);
+	const aArray = Array.isArray(a);
+	const bArray = Array.isArray(b);
+	if (aArray !== bArray) return false;
+	if (aArray && bArray) return a.length === b.length && a.every((value, index) => boardJsonEquals(value, b[index]));
+	const aRecord = a;
+	const bRecord = b;
+	const keys = Object.keys(aRecord);
+	return keys.length === Object.keys(bRecord).length && keys.every((key) => Object.hasOwn(bRecord, key) && boardJsonEquals(aRecord[key], bRecord[key]));
+}
+//#endregion
+export { boardJsonEquals };

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

@@ -1,7 +1,8 @@
 import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
-import { BoardConnectionInput, BoardConnectionPatch } from "./board-connection.js";
-import { BoardComposition } from "./board-composition.js";
-import "./board-node.js";
+import "./board-connection.js";
+import "./board-composition.js";
+import { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema } from "./board-effect.js";
+import "./board-authoring.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.d.ts
 declare const BOARD_EXTENSION: ".board";
@@ -13,10 +14,6 @@ declare const BoardManifestSchema: z.ZodObject<{
   title: z.ZodString;
 }, z.core.$strip>;
 type BoardManifest = z.infer<typeof BoardManifestSchema>;
-declare class InvalidBoardFileError extends Error {
-  readonly code = "INVALID_BOARD_FILE";
-  constructor(message?: string);
-}
 declare function parseBoardManifest(input: string | unknown): BoardManifest;
 declare function serializeBoardManifest(manifest: BoardManifest): string;
 declare const BoardCameraStateSchema: z.ZodObject<{
@@ -69,161 +66,27 @@ declare const BoardCameraFocusParamsSchema: z.ZodObject<{
   minZoom: z.ZodOptional<z.ZodNumber>;
   maxZoom: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-declare const BoardAssetRefSchema: z.ZodObject<{
-  type: z.ZodEnum<{
-    extension: "extension";
-    "space-file": "space-file";
-  }>;
-  ref: z.ZodString;
-  digest: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const BoardEffectSchema: z.ZodObject<{
-  id: z.ZodString;
-  boardId: z.ZodString;
-  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"item">;
-    itemId: z.ZodString;
-  }, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"board">;
-  }, z.core.$strict>], "type">;
-  kind: z.ZodString;
-  kindVersion: z.ZodNumber;
-  enabled: z.ZodDefault<z.ZodBoolean>;
-  lifecycle: z.ZodEnum<{
-    manual: "manual";
-    persistent: "persistent";
-    "when-visible": "when-visible";
-  }>;
-  timeOrigin: z.ZodEnum<{
-    activation: "activation";
-    board: "board";
-    visible: "visible";
-  }>;
-  layer: z.ZodDefault<z.ZodEnum<{
-    behind: "behind";
-    front: "front";
-    screen: "screen";
-  }>>;
-  seed: z.ZodString;
-  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  assetRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
-    type: z.ZodEnum<{
-      extension: "extension";
-      "space-file": "space-file";
-    }>;
-    ref: z.ZodString;
-    digest: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
-  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  revision: z.ZodNumber;
-}, z.core.$strip>;
 type BoardCameraState = z.infer<typeof BoardCameraStateSchema>;
 type BoardCameraFocus = z.infer<typeof BoardCameraFocusSchema>;
 type BoardCameraFocusParams = z.infer<typeof BoardCameraFocusParamsSchema>;
-type BoardAssetRef = z.infer<typeof BoardAssetRefSchema>;
-type BoardEffect = z.infer<typeof BoardEffectSchema>;
-type BoardRecord = {
-  id: string;
-  spaceId: string;
-  title: string;
-  version: number;
-  metadata: Record<string, unknown>;
-  createdAt: string | null;
-  updatedAt: string | null;
-};
-type BoardNodeRecord = {
-  boardId: string;
-  nodeId: string;
-  type: string;
-  parentId: string | null;
-  orderKey: string | null;
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-  rotation: number;
-  refKind: string | null;
-  refPath: string | null;
-  refUrl: string | null;
-  view: Record<string, unknown>;
-  style: Record<string, unknown>;
-  data: Record<string, unknown>;
-  version: number;
-  createdAt: string | null;
-  updatedAt: string | null;
-};
-type BoardNodeInput = Omit<BoardNodeRecord, "boardId" | "version" | "createdAt" | "updatedAt">;
-declare const BOARD_DELETE_REASONS: readonly ["user-delete", "orphan-cleanup", "layout-replace", "placeholder-cascade", "node-cascade"];
-type BoardDeleteReason = (typeof BOARD_DELETE_REASONS)[number] | (string & {});
-type BoardOperationBase = {
-  opId?: string;
-  /** Optional local undo hint. Servers recompute authoritative inverse data. */
-  inverse?: Record<string, unknown>;
-};
-type BoardOperation = (BoardOperationBase & {
-  type: "board.patch";
-  payload: {
-    patch: {
-      title?: string;
-      metadata?: Record<string, unknown>;
-      metadataPatch?: Record<string, unknown>;
-    };
-  };
-}) | (BoardOperationBase & {
-  type: "node.create";
-  payload: {
-    node: BoardNodeInput;
-  };
-}) | (BoardOperationBase & {
-  type: "node.patch";
-  payload: {
-    nodeId: string;
-    patch: Partial<BoardNodeInput>;
+type BoardMutationReceipt = {
+  mutationId: string;
+  status: "applied" | "validated";
+  outcome: "applied" | "noop" | "dry-run";
+  replayed: boolean;
+  board: {
+    id: string;
+    version: number;
   };
-}) | (BoardOperationBase & {
-  type: "node.delete";
-  payload: {
-    nodeId: string;
-    reason?: BoardDeleteReason;
+  changed: {
+    items: string[];
+    connections: string[];
+    effects: string[];
+    compositions: string[];
+    board: boolean;
+    orderChanged: boolean;
   };
-}) | (BoardOperationBase & {
-  type: "connection.create";
-  payload: {
-    connection: BoardConnectionInput;
-  };
-}) | (BoardOperationBase & {
-  type: "connection.patch";
-  payload: {
-    connectionId: string;
-    patch: BoardConnectionPatch;
-  };
-}) | (BoardOperationBase & {
-  type: "connection.delete";
-  payload: {
-    connectionId: string;
-    reason?: BoardDeleteReason;
-  };
-}) | (BoardOperationBase & {
-  type: "effect.upsert";
-  payload: {
-    effect: Omit<BoardEffect, "boardId" | "revision">;
-  };
-}) | (BoardOperationBase & {
-  type: "effect.delete";
-  payload: {
-    effectId: string;
-  };
-}) | (BoardOperationBase & {
-  type: "composition.apply";
-  payload: {
-    composition: Omit<BoardComposition, "revision">;
-  };
-}) | (BoardOperationBase & {
-  type: "composition.delete";
-  payload: {
-    compositionId: string;
-  };
-});
+};
 type BoardDiagnostic = {
   severity: "info" | "warning" | "error";
   code: string;
@@ -240,12 +103,19 @@ type BoardValidationResult = {
   diagnostics: BoardDiagnostic[];
   peakCost: BoardRenderCost;
 };
-/** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
-declare const BoardPlaybackPolicySchema: z.ZodObject<{
-  compositionId: z.ZodString;
-  delayMs: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-type BoardPlaybackPolicy = z.infer<typeof BoardPlaybackPolicySchema>;
+type BoardPlaybackStatus = "playing" | "paused" | "stopped";
+type BoardPlaybackSnapshot = {
+  boardId: string;
+  playbackId: string;
+  compositionId: string;
+  compositionRevision: number;
+  playbackRevision: number;
+  status: BoardPlaybackStatus;
+  position: number;
+  effectiveAt: number;
+  timeScale: number;
+  seed: string;
+};
 declare function isBoardPath(path: string): boolean;
 //#endregion
-export { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, type BoardRenderCost, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, type BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardDiagnostic, type BoardEffect, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, type BoardRenderCost, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest };