@neta-art/cohub 5.10.0 → 7.0.0

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-node.d.ts

@@ -1,19 +1,8 @@
-import { BoardCoordinateSpace } from "./board-constants.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-node.d.ts
 declare const BOARD_COLOR_IDS: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
 type BoardColorId = (typeof BOARD_COLOR_IDS)[number];
 declare const BOARD_GEO_KINDS: readonly ["rectangle", "rounded", "ellipse", "diamond", "triangle"];
 type BoardGeoKind = (typeof BOARD_GEO_KINDS)[number];
-type BoardNodeValidationDiagnostic = {
-  severity: "error";
-  code: "INVALID_BOARD_NODE" | "INVALID_BOARD_GEOMETRY";
-  message: string;
-  path: string;
-  expected?: string;
-  received?: unknown;
-  allowedValues?: readonly string[];
-  coordinateSpace?: BoardCoordinateSpace;
-};
 //#endregion
-export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind, BoardNodeValidationDiagnostic };
+export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind };

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

@@ -155,85 +155,5 @@ function jsonSchema(schema) {
 	return z.toJSONSchema(schema);
 }
 jsonSchema(nodeEnvelopeSchema), Object.fromEntries(BOARD_NATIVE_NODE_TYPES.map((type) => [type, jsonSchema(dataSchemas[type])])), Object.fromEntries(BOARD_NATIVE_NODE_TYPES.map((type) => [type, jsonSchema(viewSchemas[type])]));
-function issueDiagnostic(issue, path) {
-	const fullPath = [path, ...issue.path].join(".");
-	const values = "values" in issue && Array.isArray(issue.values) ? issue.values.filter((value) => typeof value === "string") : void 0;
-	return {
-		severity: "error",
-		code: "INVALID_BOARD_NODE",
-		message: `${fullPath}: ${issue.message}`,
-		path: fullPath,
-		...values?.length ? { allowedValues: values } : {}
-	};
-}
-function drawGeometryDiagnostic(node, data, path) {
-	let minX = Number.POSITIVE_INFINITY;
-	let minY = Number.POSITIVE_INFINITY;
-	let maxX = Number.NEGATIVE_INFINITY;
-	let maxY = Number.NEGATIVE_INFINITY;
-	for (const point of data.points) {
-		const radius = Math.max(.5, data.size / 2 * (.5 + point.p));
-		minX = Math.min(minX, point.x - radius);
-		minY = Math.min(minY, point.y - radius);
-		maxX = Math.max(maxX, point.x + radius);
-		maxY = Math.max(maxY, point.y + radius);
-	}
-	const width = Math.max(1, maxX - minX);
-	const height = Math.max(1, maxY - minY);
-	const tolerance = Math.max(.01, node.width * 1e-6, node.height * 1e-6);
-	if (Math.abs(minX) <= tolerance && Math.abs(minY) <= tolerance && Math.abs(width - node.width) <= tolerance && Math.abs(height - node.height) <= tolerance) return null;
-	return {
-		severity: "error",
-		code: "INVALID_BOARD_GEOMETRY",
-		message: `${path}.data.points must use frame-local coordinates and match the node frame`,
-		path: `${path}.data.points`,
-		expected: "frame-local points with bounds matching width and height",
-		coordinateSpace: "frame-local"
-	};
-}
-function validateBoardNodeInput(node, path = "node") {
-	const envelopeResult = nodeEnvelopeSchema.safeParse(node);
-	if (!envelopeResult.success) return envelopeResult.error.issues.map((issue) => issueDiagnostic(issue, path));
-	if (typeof node.type !== "string" || !BOARD_NATIVE_NODE_TYPES.includes(node.type)) return [{
-		severity: "error",
-		code: "INVALID_BOARD_NODE",
-		message: `${path}.type is not supported`,
-		path: `${path}.type`,
-		expected: "BoardNativeNodeType",
-		received: node.type,
-		allowedValues: BOARD_NATIVE_NODE_TYPES
-	}];
-	const type = node.type;
-	const dataResult = dataSchemas[type].safeParse(node.data ?? {});
-	if (!dataResult.success) return dataResult.error.issues.map((issue) => issueDiagnostic(issue, `${path}.data`));
-	const viewResult = viewSchemas[type].safeParse(node.view ?? {});
-	if (!viewResult.success) return viewResult.error.issues.map((issue) => issueDiagnostic(issue, `${path}.view`));
-	if (type === "image" || type === "video" || type === "audio" || type === "file") {
-		if (node.refKind !== "space_file" || typeof node.refPath !== "string" || !node.refPath) return [{
-			severity: "error",
-			code: "INVALID_BOARD_NODE",
-			message: `${path} requires a space file reference`,
-			path: `${path}.refPath`,
-			expected: "non-empty refPath with refKind space_file"
-		}];
-	}
-	if (type === "draw") {
-		const diagnostic = drawGeometryDiagnostic(node, dataResult.data, path);
-		return diagnostic ? [diagnostic] : [];
-	}
-	if (type === "arrow") {
-		const data = dataResult.data;
-		const inside = (point) => point.x >= node.x && point.x <= node.x + node.width && point.y >= node.y && point.y <= node.y + node.height;
-		if (!inside(data.start) || !inside(data.end)) return [{
-			severity: "error",
-			code: "INVALID_BOARD_GEOMETRY",
-			message: `${path}.data endpoints must be covered by the node frame`,
-			path: `${path}.data`,
-			expected: "world-space endpoints inside the node frame",
-			coordinateSpace: "world"
-		}];
-	}
-	return [];
-}
 //#endregion
-export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BoardColorIdSchema, BoardGeoKindSchema, validateBoardNodeInput };
+export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BoardColorIdSchema, BoardGeoKindSchema };

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

@@ -1,6 +1,8 @@
 import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
-import { BoardConnectionInput, BoardConnectionPatch } from "./board-connection.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";
@@ -12,23 +14,8 @@ 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 BoardTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"node">;
-  nodeId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"effect">;
-  effectId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"board">;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"camera">;
-}, z.core.$strip>], "type">;
 declare const BoardCameraStateSchema: z.ZodObject<{
   centerX: z.ZodNumber;
   centerY: z.ZodNumber;
@@ -43,11 +30,11 @@ declare const BoardCameraFocusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     height: z.ZodNumber;
   }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"node">;
-  nodeId: z.ZodString;
+  type: z.ZodLiteral<"item">;
+  itemId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"nodes">;
-  nodeIds: z.ZodArray<z.ZodString>;
+  type: z.ZodLiteral<"items">;
+  itemIds: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"frame">;
   frameId: z.ZodString;
@@ -62,11 +49,11 @@ declare const BoardCameraFocusParamsSchema: z.ZodObject<{
       height: z.ZodNumber;
     }, z.core.$strip>;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"node">;
-    nodeId: z.ZodString;
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
   }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"nodes">;
-    nodeIds: z.ZodArray<z.ZodString>;
+    type: z.ZodLiteral<"items">;
+    itemIds: z.ZodArray<z.ZodString>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"frame">;
     frameId: z.ZodString;
@@ -79,223 +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 BoardClipSchema: z.ZodObject<{
-  id: z.ZodString;
-  sequenceId: z.ZodString;
-  kind: z.ZodString;
-  kindVersion: z.ZodNumber;
-  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"node">;
-    nodeId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"effect">;
-    effectId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"board">;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"camera">;
-  }, z.core.$strip>], "type">;
-  start: z.ZodNumber;
-  duration: z.ZodNumber;
-  layer: z.ZodDefault<z.ZodEnum<{
-    behind: "behind";
-    content: "content";
-    front: "front";
-    screen: "screen";
-  }>>;
-  fill: z.ZodDefault<z.ZodEnum<{
-    backwards: "backwards";
-    both: "both";
-    forwards: "forwards";
-    none: "none";
-  }>>;
-  easing: z.ZodDefault<z.ZodString>;
-  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  keyframes: z.ZodDefault<z.ZodArray<z.ZodObject<{
-    at: z.ZodNumber;
-    value: z.ZodUnknown;
-    easing: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
-  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>>>;
-  seed: z.ZodString;
-  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-declare const BoardEffectSchema: z.ZodObject<{
-  id: z.ZodString;
-  boardId: z.ZodString;
-  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"node">;
-    nodeId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"board">;
-  }, z.core.$strip>], "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>;
-declare const BoardSequenceSchema: z.ZodObject<{
-  id: z.ZodString;
-  boardId: z.ZodString;
-  name: z.ZodString;
-  duration: z.ZodNumber;
-  seed: z.ZodString;
-  restPose: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  revision: z.ZodNumber;
-}, z.core.$strip>;
-type BoardTarget = z.infer<typeof BoardTargetSchema>;
 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 BoardClip = z.infer<typeof BoardClipSchema>;
-type BoardEffect = z.infer<typeof BoardEffectSchema>;
-type BoardSequence = z.infer<typeof BoardSequenceSchema>;
-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>;
-  };
-}) | (BoardOperationBase & {
-  type: "node.delete";
-  payload: {
-    nodeId: string;
-    reason?: BoardDeleteReason;
-  };
-}) | (BoardOperationBase & {
-  type: "connection.create";
-  payload: {
-    connection: BoardConnectionInput;
+type BoardMutationReceipt = {
+  mutationId: string;
+  status: "applied" | "validated";
+  outcome: "applied" | "noop" | "dry-run";
+  replayed: boolean;
+  board: {
+    id: string;
+    version: number;
   };
-}) | (BoardOperationBase & {
-  type: "connection.patch";
-  payload: {
-    connectionId: string;
-    patch: BoardConnectionPatch;
+  changed: {
+    items: string[];
+    connections: string[];
+    effects: string[];
+    compositions: string[];
+    board: boolean;
+    orderChanged: boolean;
   };
-}) | (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: "sequence.upsert";
-  payload: {
-    sequence: Omit<BoardSequence, "boardId" | "revision">;
-    clips: Array<Omit<BoardClip, "sequenceId">>;
-  };
-}) | (BoardOperationBase & {
-  type: "sequence.delete";
-  payload: {
-    sequenceId: string;
-  };
-});
+};
 type BoardDiagnostic = {
   severity: "info" | "warning" | "error";
   code: string;
@@ -312,13 +103,19 @@ type BoardValidationResult = {
   diagnostics: BoardDiagnostic[];
   peakCost: BoardRenderCost;
 };
-/** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
-declare const BoardPlaybackPolicySchema: z.ZodObject<{
-  sequenceId: z.ZodString;
-  delayMs: z.ZodDefault<z.ZodNumber>;
-  loop: z.ZodDefault<z.ZodBoolean>;
-}, 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, BoardClip, BoardClipSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, 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 };