@neta-art/cohub 5.10.0 → 6.0.0

package/dist/chunks/http.js

@@ -1,7 +1,6 @@
 import { D as getRealtimeBoardRoom, O as getRealtimeSpaceRoom, n as HttpTransport, t as HttpError, y as isUuid } from "./transport.js";
 import { a as resolveApiBaseUrl } from "./environment.js";
 import { z } from "zod";
-import "perfect-freehand";
 //#region src/apis/channels.ts
 var ChannelsApi = class {
 	transport;
@@ -454,7 +453,6 @@ const DEFAULT_BOARD_RENDER_LIMITS = {
 	simulationSteps: 1e5
 };
 const BOARD_BUILTIN_CLIP_KINDS = [
-	"motion.keyframes",
 	"motion.path",
 	"draw.reveal",
 	"draw.handwrite",
@@ -463,9 +461,6 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 	"effects.trail",
 	"effects.impact",
 	"effects.flash",
-	"effects.color",
-	"camera.pan",
-	"camera.zoom",
 	"camera.focus",
 	"camera.shake"
 ];
@@ -478,16 +473,6 @@ function clampBoardStrokeSize(size) {
 }
 function clipSchema(id) {
 	switch (id) {
-		case "motion.keyframes": return { params: {
-			x: {
-				coordinateSpace: "world-offset",
-				unit: "board"
-			},
-			y: {
-				coordinateSpace: "world-offset",
-				unit: "board"
-			}
-		} };
 		case "motion.path": return { params: { points: {
 			coordinateSpace: "world-offset",
 			unit: "board"
@@ -496,17 +481,6 @@ function clipSchema(id) {
 			coordinateSpace: "world",
 			unit: "board"
 		} } };
-		case "camera.pan": return { params: {
-			x: {
-				coordinateSpace: "screen-offset",
-				unit: "css-px"
-			},
-			y: {
-				coordinateSpace: "screen-offset",
-				unit: "css-px"
-			}
-		} };
-		case "camera.zoom": return { params: { scale: { unit: "ratio" } } };
 		case "camera.focus": return { params: {
 			focus: {
 				coordinateSpace: "world",
@@ -693,13 +667,529 @@ function createBoardConnection(input) {
 	};
 }
 //#endregion
-//#region src/realtime.ts
-function ensureRealtimeConnected(websocketClient) {
-	if (websocketClient.state === "open" || websocketClient.state === "connecting" || websocketClient.state === "reconnecting") return;
-	websocketClient.connect().catch((error) => {
-		console.error("[CohubClient] Failed to connect realtime websocket:", error);
+//#region ../protocol/dist/board-composition.js
+const idSchema$3 = z.string().min(1).max(160);
+const finiteSchema$3 = z.number().finite();
+const jsonObjectSchema$2 = z.record(z.string(), z.unknown());
+const BoardEasingSchema = z.enum([
+	"linear",
+	"ease-in-quad",
+	"ease-out-quad",
+	"ease-in-out-quad",
+	"ease-in-cubic",
+	"ease-out-cubic",
+	"ease-in-out-cubic",
+	"ease-out-quart",
+	"ease-out-expo"
+]);
+const BoardAnimationTargetSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("item"),
+		itemId: idSchema$3
+	}).strict(),
+	z.object({
+		type: z.literal("effect"),
+		effectId: idSchema$3
+	}).strict(),
+	z.object({ type: z.literal("camera") }).strict(),
+	z.object({ type: z.literal("board") }).strict()
+]);
+const vector2Schema = z.object({
+	x: finiteSchema$3,
+	y: finiteSchema$3
+}).strict();
+const scaleSchema = z.union([finiteSchema$3.positive(), z.object({
+	x: finiteSchema$3.positive(),
+	y: finiteSchema$3.positive()
+}).strict()]);
+const BOARD_ANIMATION_CHANNELS = {
+	"transform.translation": {
+		targets: ["item"],
+		value: vector2Schema,
+		interpolations: ["linear", "step"],
+		coordinateSpace: "world-offset",
+		unit: "board"
+	},
+	"transform.rotation": {
+		targets: ["item"],
+		value: finiteSchema$3,
+		interpolations: ["linear", "step"],
+		unit: "radian"
+	},
+	"transform.scale": {
+		targets: ["item"],
+		value: scaleSchema,
+		interpolations: ["linear", "step"],
+		unit: "ratio"
+	},
+	"style.opacity": {
+		targets: ["item"],
+		value: finiteSchema$3.min(0).max(1),
+		interpolations: ["linear", "step"],
+		unit: "ratio"
+	}
+};
+const BoardTrackKeyframeSchema = z.object({
+	time: finiteSchema$3.nonnegative(),
+	value: z.unknown(),
+	easing: BoardEasingSchema.optional()
+}).strict();
+const BoardTrackSchema = z.object({
+	id: idSchema$3,
+	target: BoardAnimationTargetSchema,
+	channel: z.string().min(1).max(160),
+	channelVersion: z.number().int().positive().default(1),
+	interpolation: z.enum(["linear", "step"]).default("linear"),
+	fill: z.enum([
+		"none",
+		"backwards",
+		"forwards",
+		"both"
+	]).default("none"),
+	keyframes: z.array(BoardTrackKeyframeSchema).min(1).max(1e5),
+	metadata: jsonObjectSchema$2.default({})
+}).strict().superRefine((track, context) => {
+	let previous = -1;
+	for (const [index, keyframe] of track.keyframes.entries()) {
+		if (keyframe.time <= previous) context.addIssue({
+			code: "custom",
+			message: "keyframe times must be strictly increasing",
+			path: [
+				"keyframes",
+				index,
+				"time"
+			]
+		});
+		previous = keyframe.time;
+	}
+	const channel = BOARD_ANIMATION_CHANNELS[track.channel];
+	if (!channel) {
+		if (!/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+){2,}$/.test(track.channel)) context.addIssue({
+			code: "custom",
+			message: `unknown channel: ${track.channel}`,
+			path: ["channel"]
+		});
+		return;
+	}
+	if (!channel.targets.includes(track.target.type)) context.addIssue({
+		code: "custom",
+		message: `${track.channel} cannot target ${track.target.type}`,
+		path: ["target"]
+	});
+	if (!channel.interpolations.includes(track.interpolation)) context.addIssue({
+		code: "custom",
+		message: `${track.channel} does not support ${track.interpolation} interpolation`,
+		path: ["interpolation"]
+	});
+	for (const [index, keyframe] of track.keyframes.entries()) {
+		const parsed = channel.value.safeParse(keyframe.value);
+		if (!parsed.success) context.addIssue({
+			code: "custom",
+			message: parsed.error.issues[0]?.message ?? `invalid value for ${track.channel}`,
+			path: [
+				"keyframes",
+				index,
+				"value"
+			]
+		});
+	}
+});
+const extensionKindSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
+const BoardProceduralClipSchema = z.object({
+	id: idSchema$3,
+	kind: extensionKindSchema,
+	kindVersion: z.number().int().positive(),
+	target: BoardAnimationTargetSchema,
+	start: finiteSchema$3.nonnegative(),
+	duration: finiteSchema$3.positive(),
+	layer: z.enum([
+		"behind",
+		"content",
+		"front",
+		"screen"
+	]).default("content"),
+	fill: z.enum([
+		"none",
+		"backwards",
+		"forwards",
+		"both"
+	]).default("none"),
+	easing: BoardEasingSchema.default("linear"),
+	params: jsonObjectSchema$2.default({}),
+	assetRefs: z.array(z.object({
+		type: z.enum(["space-file", "extension"]),
+		ref: z.string().min(1).max(4096),
+		digest: z.string().min(16).max(160).optional()
+	}).strict()).default([]),
+	seed: idSchema$3,
+	metadata: jsonObjectSchema$2.default({})
+}).strict();
+const BoardTimelineMarkerSchema = z.object({
+	id: idSchema$3,
+	time: finiteSchema$3.nonnegative(),
+	duration: finiteSchema$3.nonnegative().optional(),
+	metadata: jsonObjectSchema$2.default({})
+}).strict();
+const BoardTimelineSchema = z.object({
+	duration: finiteSchema$3.nonnegative(),
+	tracks: z.array(BoardTrackSchema).max(5e4).default([]),
+	clips: z.array(BoardProceduralClipSchema).max(5e4).default([]),
+	markers: z.array(BoardTimelineMarkerSchema).max(1e4).default([])
+}).strict().superRefine((timeline, context) => {
+	const ids = /* @__PURE__ */ new Set();
+	const channels = /* @__PURE__ */ new Set();
+	for (const [index, track] of timeline.tracks.entries()) {
+		if (ids.has(track.id)) context.addIssue({
+			code: "custom",
+			message: `duplicate timeline id: ${track.id}`,
+			path: [
+				"tracks",
+				index,
+				"id"
+			]
+		});
+		ids.add(track.id);
+		const targetId = track.target.type === "item" ? track.target.itemId : track.target.type === "effect" ? track.target.effectId : track.target.type;
+		const key = `${track.target.type}:${targetId}:${track.channel}`;
+		if (channels.has(key)) context.addIssue({
+			code: "custom",
+			message: `multiple tracks control ${key}`,
+			path: [
+				"tracks",
+				index,
+				"channel"
+			]
+		});
+		channels.add(key);
+		for (const [keyframeIndex, keyframe] of track.keyframes.entries()) if (keyframe.time > timeline.duration) context.addIssue({
+			code: "custom",
+			message: "keyframe exceeds timeline duration",
+			path: [
+				"tracks",
+				index,
+				"keyframes",
+				keyframeIndex,
+				"time"
+			]
+		});
+	}
+	for (const [index, clip] of timeline.clips.entries()) {
+		if (ids.has(clip.id)) context.addIssue({
+			code: "custom",
+			message: `duplicate timeline id: ${clip.id}`,
+			path: [
+				"clips",
+				index,
+				"id"
+			]
+		});
+		ids.add(clip.id);
+		if (clip.start + clip.duration > timeline.duration) context.addIssue({
+			code: "custom",
+			message: "clip exceeds timeline duration",
+			path: [
+				"clips",
+				index,
+				"duration"
+			]
+		});
+	}
+	for (const [index, marker] of timeline.markers.entries()) {
+		if (ids.has(marker.id)) context.addIssue({
+			code: "custom",
+			message: `duplicate timeline id: ${marker.id}`,
+			path: [
+				"markers",
+				index,
+				"id"
+			]
+		});
+		ids.add(marker.id);
+		if (marker.time + (marker.duration ?? 0) > timeline.duration) context.addIssue({
+			code: "custom",
+			message: "marker exceeds timeline duration",
+			path: ["markers", index]
+		});
+	}
+});
+const BoardCompositionPlaybackSchema = z.object({
+	loop: z.boolean().default(false),
+	endBehavior: z.enum(["hold", "reset"]).default("hold"),
+	reducedMotion: z.discriminatedUnion("mode", [
+		z.object({ mode: z.literal("base") }).strict(),
+		z.object({
+			mode: z.literal("time"),
+			time: finiteSchema$3.nonnegative()
+		}).strict(),
+		z.object({
+			mode: z.literal("marker"),
+			markerId: idSchema$3
+		}).strict()
+	]).default({ mode: "base" })
+}).strict();
+const compositionFields = {
+	id: idSchema$3,
+	name: z.string().min(1).max(255),
+	timeline: BoardTimelineSchema,
+	playback: BoardCompositionPlaybackSchema.default({
+		loop: false,
+		endBehavior: "hold",
+		reducedMotion: { mode: "base" }
+	}),
+	metadata: jsonObjectSchema$2.default({})
+};
+function validateCompositionFallback(composition, context) {
+	const fallback = composition.playback.reducedMotion;
+	if (fallback.mode === "time" && fallback.time > composition.timeline.duration) context.addIssue({
+		code: "custom",
+		message: "reduced-motion time exceeds timeline duration",
+		path: [
+			"playback",
+			"reducedMotion",
+			"time"
+		]
+	});
+	if (fallback.mode === "marker" && !composition.timeline.markers.some((marker) => marker.id === fallback.markerId)) context.addIssue({
+		code: "custom",
+		message: `marker does not exist: ${fallback.markerId}`,
+		path: [
+			"playback",
+			"reducedMotion",
+			"markerId"
+		]
 	});
 }
+const BoardCompositionInputSchema = z.object(compositionFields).strict().superRefine(validateCompositionFallback);
+const BoardCompositionSchema = z.object({
+	...compositionFields,
+	revision: z.number().int().nonnegative().default(0)
+}).strict().superRefine(validateCompositionFallback);
+/** Accept inspect/get output as apply input while stripping server-owned revision. */
+function parseBoardCompositionInput(value) {
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const { revision: _revision, ...input } = value;
+		return BoardCompositionInputSchema.parse(input);
+	}
+	return BoardCompositionInputSchema.parse(value);
+}
+const BOARD_ANIMATION_CHANNEL_CAPABILITIES = Object.entries(BOARD_ANIMATION_CHANNELS).map(([id, definition]) => ({
+	id,
+	version: 1,
+	targets: definition.targets,
+	interpolations: definition.interpolations,
+	..."coordinateSpace" in definition ? { coordinateSpace: definition.coordinateSpace } : {},
+	..."unit" in definition ? { unit: definition.unit } : {},
+	valueSchema: z.toJSONSchema(definition.value)
+}));
+//#endregion
+//#region ../protocol/dist/board-authoring.js
+const BOARD_COLOR_IDS$1 = [
+	"brand",
+	"neutral",
+	"black",
+	"white",
+	"blue",
+	"green",
+	"amber",
+	"violet",
+	"rose"
+];
+const BOARD_GEO_KINDS$1 = [
+	"rectangle",
+	"rounded",
+	"ellipse",
+	"diamond",
+	"triangle"
+];
+const idSchema$2 = z.string().min(1).max(160);
+const jsonObjectSchema$1 = z.record(z.string(), z.unknown());
+const finiteSchema$2 = z.number().finite();
+const extensionTypeSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
+const BoardAuthoringFrameSchema = z.object({
+	x: finiteSchema$2,
+	y: finiteSchema$2,
+	width: finiteSchema$2.positive(),
+	height: finiteSchema$2.positive(),
+	rotation: finiteSchema$2.default(0)
+}).strict();
+const pointSchema$1 = z.object({
+	x: finiteSchema$2,
+	y: finiteSchema$2,
+	p: finiteSchema$2.min(0).max(1).default(.5)
+}).strict();
+const worldPointSchema$1 = z.object({
+	x: finiteSchema$2,
+	y: finiteSchema$2
+}).strict();
+const cropSchema = z.object({
+	x: finiteSchema$2.min(0).max(1),
+	y: finiteSchema$2.min(0).max(1),
+	w: finiteSchema$2.min(0).max(1),
+	h: finiteSchema$2.min(0).max(1)
+}).strict();
+const BoardItemStyleSchema$1 = z.object({
+	color: z.enum(BOARD_COLOR_IDS$1).optional(),
+	strokeWidth: finiteSchema$2.min(1).max(64).optional(),
+	fillOpacity: finiteSchema$2.min(0).max(1).optional()
+}).strict();
+const sourceSnapshotSchema = z.record(z.string(), z.unknown());
+function isSafeBoardSourcePath(value) {
+	return value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !value.startsWith("\\") && !value.includes("\\") && value.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
+}
+const BoardItemSourceSchema = z.object({
+	kind: z.literal("space-file"),
+	path: z.string().refine(isSafeBoardSourcePath, "source path must be a safe relative Board file path"),
+	snapshot: sourceSnapshotSchema.optional()
+}).strict();
+const baseFields = {
+	id: idSchema$2,
+	frame: BoardAuthoringFrameSchema,
+	parentId: idSchema$2.nullable().optional(),
+	locked: z.boolean().optional(),
+	metadata: jsonObjectSchema$1.optional()
+};
+const styledBaseFields = {
+	...baseFields,
+	style: BoardItemStyleSchema$1.optional()
+};
+const BoardTextAuthoringItemSchema = z.object({
+	...styledBaseFields,
+	type: z.literal("text"),
+	props: z.object({
+		text: z.string().default(""),
+		fontSize: finiteSchema$2.min(2).max(512).default(24)
+	}).strict()
+}).strict();
+const BoardGeoAuthoringItemSchema = z.object({
+	...styledBaseFields,
+	type: z.literal("geo"),
+	props: z.object({
+		shape: z.enum(BOARD_GEO_KINDS$1).default("rectangle"),
+		text: z.string().default("")
+	}).strict()
+}).strict();
+const BoardDrawAuthoringItemSchema = z.object({
+	...styledBaseFields,
+	type: z.literal("draw"),
+	props: z.object({ points: z.array(pointSchema$1).min(1) }).strict()
+}).strict();
+const BoardArrowAuthoringItemSchema = z.object({
+	...styledBaseFields,
+	type: z.literal("arrow"),
+	props: z.object({
+		start: worldPointSchema$1,
+		end: worldPointSchema$1,
+		bend: finiteSchema$2.min(-.85).max(.85).default(0),
+		arrowStart: z.boolean().default(false),
+		arrowEnd: z.boolean().default(true),
+		label: z.string().default("")
+	}).strict()
+}).strict();
+const BoardFrameAuthoringItemSchema = z.object({
+	...styledBaseFields,
+	type: z.literal("frame"),
+	props: z.object({ label: z.string().default("Frame") }).strict()
+}).strict();
+const fileBackedFields = {
+	...baseFields,
+	style: z.object({}).strict().optional(),
+	source: BoardItemSourceSchema
+};
+const builtinItemSchemas = [
+	BoardTextAuthoringItemSchema,
+	BoardGeoAuthoringItemSchema,
+	BoardDrawAuthoringItemSchema,
+	BoardArrowAuthoringItemSchema,
+	BoardFrameAuthoringItemSchema,
+	z.object({
+		...fileBackedFields,
+		type: z.literal("image"),
+		props: z.object({ crop: cropSchema.optional() }).strict()
+	}).strict(),
+	z.object({
+		...fileBackedFields,
+		type: z.literal("video"),
+		props: z.object({}).strict()
+	}).strict(),
+	z.object({
+		...fileBackedFields,
+		type: z.literal("audio"),
+		props: z.object({}).strict()
+	}).strict(),
+	z.object({
+		...fileBackedFields,
+		type: z.literal("file"),
+		props: z.object({}).strict()
+	}).strict(),
+	z.object({
+		...baseFields,
+		type: z.literal("task"),
+		props: z.object({
+			taskRunId: z.string().min(1),
+			snapshot: z.record(z.string(), z.unknown())
+		}).strict(),
+		style: z.object({}).strict().optional()
+	}).strict()
+];
+const BoardBuiltinAuthoringItemSchema = z.discriminatedUnion("type", builtinItemSchemas);
+const BoardExtensionAuthoringItemSchema = z.object({
+	...baseFields,
+	type: extensionTypeSchema,
+	kindVersion: z.number().int().positive(),
+	props: jsonObjectSchema$1,
+	style: jsonObjectSchema$1.optional(),
+	source: z.object({
+		kind: z.string().min(1).max(80),
+		ref: z.string().min(1).max(4096),
+		snapshot: jsonObjectSchema$1.optional()
+	}).strict().optional()
+}).strict();
+const BoardAuthoringItemSchema = z.union([BoardBuiltinAuthoringItemSchema, BoardExtensionAuthoringItemSchema]);
+const framePatchSchema = z.object({
+	x: finiteSchema$2.optional(),
+	y: finiteSchema$2.optional(),
+	width: finiteSchema$2.positive().optional(),
+	height: finiteSchema$2.positive().optional(),
+	rotation: finiteSchema$2.optional()
+}).strict();
+/** JSON Merge Patch semantics, constrained to the stable Item envelope. */
+const BoardItemPatchSchema = z.object({
+	frame: framePatchSchema.optional(),
+	parentId: idSchema$2.nullable().optional(),
+	locked: z.boolean().nullable().optional(),
+	props: jsonObjectSchema$1.optional(),
+	style: jsonObjectSchema$1.nullable().optional(),
+	source: jsonObjectSchema$1.nullable().optional(),
+	metadata: jsonObjectSchema$1.nullable().optional()
+}).strict().refine((patch) => Object.keys(patch).length > 0, "item patch is empty");
+const BoardSemanticCommandSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("item.create"),
+		item: BoardAuthoringItemSchema
+	}).strict(),
+	z.object({
+		type: z.literal("item.patch"),
+		itemId: idSchema$2,
+		patch: BoardItemPatchSchema
+	}).strict(),
+	z.object({
+		type: z.literal("item.replace"),
+		itemId: idSchema$2,
+		item: BoardAuthoringItemSchema
+	}).strict(),
+	z.object({
+		type: z.literal("item.delete"),
+		itemId: idSchema$2,
+		cascade: z.boolean().default(false)
+	}).strict()
+]);
+z.object({
+	mutationId: idSchema$2,
+	baseVersion: z.number().int().nonnegative(),
+	clientId: idSchema$2.optional(),
+	undoGroupId: idSchema$2.optional(),
+	commands: z.array(BoardSemanticCommandSchema).min(1).max(5e4)
+}).strict();
 //#endregion
 //#region ../protocol/dist/board.js
 const BOARD_DOCUMENT_KIND = "cohub.board";
@@ -714,18 +1204,6 @@ z.object({
 	boardId: z.string().uuid(),
 	title: z.string().min(1).max(255)
 });
-const BoardTargetSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema$1
-	}),
-	z.object({
-		type: z.literal("effect"),
-		effectId: idSchema$1
-	}),
-	z.object({ type: z.literal("board") }),
-	z.object({ type: z.literal("camera") })
-]);
 z.object({
 	centerX: finiteSchema$1,
 	centerY: finiteSchema$1,
@@ -742,12 +1220,12 @@ const BoardCameraFocusSchema = z.discriminatedUnion("type", [
 		})
 	}),
 	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema$1
+		type: z.literal("item"),
+		itemId: idSchema$1
 	}),
 	z.object({
-		type: z.literal("nodes"),
-		nodeIds: z.array(idSchema$1).min(1).max(1e3)
+		type: z.literal("items"),
+		itemIds: z.array(idSchema$1).min(1).max(1e3)
 	}),
 	z.object({
 		type: z.literal("frame"),
@@ -772,45 +1250,13 @@ const BoardAssetRefSchema = z.object({
 	ref: z.string().min(1).max(4096),
 	digest: z.string().min(16).max(160).optional()
 });
-const BoardKeyframeSchema = z.object({
-	at: finiteSchema$1.nonnegative(),
-	value: z.unknown(),
-	easing: z.string().min(1).max(80).optional()
-});
-const BoardClipSchema = z.object({
-	id: idSchema$1,
-	sequenceId: idSchema$1,
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	target: BoardTargetSchema,
-	start: finiteSchema$1.nonnegative(),
-	duration: finiteSchema$1.positive(),
-	layer: z.enum([
-		"behind",
-		"content",
-		"front",
-		"screen"
-	]).default("content"),
-	fill: z.enum([
-		"none",
-		"backwards",
-		"forwards",
-		"both"
-	]).default("none"),
-	easing: z.string().min(1).max(80).default("linear"),
-	params: jsonObjectSchema.default({}),
-	keyframes: z.array(BoardKeyframeSchema).default([]),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	seed: z.string().min(1).max(160),
-	metadata: jsonObjectSchema.default({})
-});
 const BoardEffectSchema = z.object({
 	id: idSchema$1,
 	boardId: z.string().uuid(),
 	target: z.discriminatedUnion("type", [z.object({
-		type: z.literal("node"),
-		nodeId: idSchema$1
-	}), z.object({ type: z.literal("board") })]),
+		type: z.literal("item"),
+		itemId: idSchema$1
+	}).strict(), z.object({ type: z.literal("board") }).strict()]),
 	kind: extensionIdSchema,
 	kindVersion: z.number().int().positive(),
 	enabled: z.boolean().default(true),
@@ -835,17 +1281,7 @@ const BoardEffectSchema = z.object({
 	metadata: jsonObjectSchema.default({}),
 	revision: z.number().int().nonnegative()
 });
-const BoardSequenceSchema = z.object({
-	id: idSchema$1,
-	boardId: z.string().uuid(),
-	name: z.string().min(1).max(255),
-	duration: finiteSchema$1.nonnegative(),
-	seed: z.string().min(1).max(160),
-	restPose: jsonObjectSchema.default({}),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardNodeInputSchema = z.object({
+z.object({
 	nodeId: idSchema$1,
 	type: z.string().min(1).max(40),
 	parentId: idSchema$1.nullable(),
@@ -868,27 +1304,20 @@ z.object({
 	mutationId: z.string().max(128).optional(),
 	title: z.string().min(1).max(255).optional(),
 	metadata: jsonObjectSchema.optional(),
-	nodes: z.array(BoardNodeInputSchema).max(5e4).optional(),
+	items: z.array(BoardAuthoringItemSchema).max(5e4).optional(),
 	connections: z.array(BoardConnectionSchema).max(5e4).optional(),
 	effects: z.array(BoardEffectSchema.omit({
 		boardId: true,
 		revision: true
 	})).optional(),
-	sequences: z.array(z.object({
-		sequence: BoardSequenceSchema.omit({
-			boardId: true,
-			revision: true
-		}),
-		clips: z.array(BoardClipSchema.omit({ sequenceId: true }))
-	})).optional()
+	compositions: z.array(BoardCompositionInputSchema).optional()
 });
 z.object({
 	include: z.array(z.enum([
 		"nodes",
 		"connections",
 		"effects",
-		"sequences",
-		"clips",
+		"compositions",
 		"playback"
 	])).optional(),
 	viewport: z.object({
@@ -900,10 +1329,9 @@ z.object({
 });
 /** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
 const BoardPlaybackPolicySchema = z.object({
-	sequenceId: idSchema$1,
+	compositionId: idSchema$1,
 	/** Delay before the first local playback after opening the Board, in milliseconds. */
-	delayMs: finiteSchema$1.nonnegative().default(0),
-	loop: z.boolean().default(false)
+	delayMs: finiteSchema$1.nonnegative().default(0)
 });
 function parseBoardPlaybackPolicy(metadata) {
 	const parsed = BoardPlaybackPolicySchema.safeParse(metadata.playback);
@@ -913,7 +1341,7 @@ z.discriminatedUnion("type", [
 	z.object({
 		commandId: idSchema$1,
 		type: z.literal("play"),
-		sequenceId: idSchema$1,
+		compositionId: idSchema$1,
 		position: finiteSchema$1.nonnegative().optional(),
 		timeScale: finiteSchema$1.positive().max(4).optional(),
 		shared: z.boolean().optional(),
@@ -936,27 +1364,77 @@ z.discriminatedUnion("type", [
 		playbackId: z.string().uuid()
 	})
 ]);
-const BoardContentKindSchema = z.enum([
-	"text",
-	"image",
-	"video",
-	"audio",
-	"file",
-	"json",
-	"collection"
-]);
-const BoardPortSchema = z.object({
-	id: z.string().min(1).max(120),
-	kind: BoardContentKindSchema,
-	role: z.string().min(1).max(80).optional(),
-	required: z.boolean().optional(),
-	multiple: z.boolean().optional(),
-	maxItems: z.number().int().positive().optional()
-}).strict();
-z.object({
-	inputs: z.array(BoardPortSchema),
-	outputs: z.array(BoardPortSchema)
-}).strict();
+//#endregion
+//#region ../protocol/dist/board-capability-registry.js
+const CLIPS = new Set(BOARD_BUILTIN_CLIP_KINDS);
+new Set(BOARD_BUILTIN_EFFECT_KINDS);
+const record = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+const finite = (value) => typeof value === "number" && Number.isFinite(value);
+function validateBuiltinBoardClip(clip, path = "clip") {
+	if (!CLIPS.has(clip.kind)) return [];
+	const errors = [];
+	const error = (message, suffix, coordinateSpace, code = "INVALID_BOARD_CLIP") => {
+		errors.push({
+			severity: "error",
+			code,
+			message,
+			path: `${path}.${suffix}`,
+			...coordinateSpace ? { coordinateSpace } : {}
+		});
+	};
+	if ((clip.kind.startsWith("motion.") || clip.kind.startsWith("draw.") || clip.kind === "text.reveal" || clip.kind === "effects.trail") && clip.target.type !== "item") error(`${clip.kind} must target an item`, "target");
+	if (clip.kind.startsWith("camera.") && clip.target.type !== "camera") error(`${clip.kind} must target the camera`, "target");
+	if (clip.kind === "motion.path") {
+		const points = clip.params.points;
+		if (!Array.isArray(points) || points.length < 2 || points.length > 1e4) error("motion path must contain 2 to 10000 world-offset points", "params.points", "world-offset");
+		else for (const [index, point] of points.entries()) if (!record(point) || !finite(point.x) || !finite(point.y)) error("motion path point must contain finite x and y", `params.points.${index}`, "world-offset");
+	}
+	if (clip.kind === "effects.particles") {
+		const count = clip.params.count;
+		if (!Number.isSafeInteger(count) || count < 1 || count > DEFAULT_BOARD_RENDER_LIMITS.particles) error(`particle count must be an integer from 1 to ${DEFAULT_BOARD_RENDER_LIMITS.particles}`, "params.count", void 0, "INVALID_PARTICLE_COUNT");
+		const bounds = clip.params.bounds;
+		if (!record(bounds) || !finite(bounds.x) || !finite(bounds.y) || !finite(bounds.width) || !finite(bounds.height) || bounds.width <= 0 || bounds.height <= 0) error("particles require positive finite world bounds", "params.bounds", "world", "PARTICLE_BOUNDS_REQUIRED");
+	}
+	if (clip.kind === "camera.focus") {
+		const parsed = BoardCameraFocusParamsSchema.safeParse(clip.params);
+		if (!parsed.success) error(parsed.error.issues[0]?.message ?? "invalid camera focus", "params", "world");
+	}
+	return errors;
+}
+function estimateBuiltinBoardClipCost(clip) {
+	switch (clip.kind) {
+		case "effects.particles": {
+			const count = Number.isSafeInteger(clip.params.count) ? Math.max(0, clip.params.count) : 0;
+			return {
+				particles: count,
+				vertices: count * 4,
+				dynamicVertices: count * 4,
+				drawCalls: 1,
+				bufferBytes: count * 48,
+				simulationSteps: count
+			};
+		}
+		case "effects.trail": return {
+			vertices: 32,
+			dynamicVertices: 32,
+			drawCalls: 1,
+			bufferBytes: 1024,
+			simulationSteps: 16
+		};
+		case "effects.impact":
+		case "effects.flash": return {
+			vertices: 64,
+			drawCalls: 1
+		};
+		case "draw.reveal":
+		case "draw.handwrite": return {
+			drawCalls: 1,
+			dynamicVertices: 1
+		};
+		case "motion.path": return { simulationSteps: Array.isArray(clip.params.points) ? clip.params.points.length : 0 };
+		default: return {};
+	}
+}
 //#endregion
 //#region ../protocol/dist/board-url.js
 const BOARD_REMOTE_URL_MAX_LENGTH = 4096;
@@ -1687,6 +2165,27 @@ function validateBoardNodeInput(node, path = "node") {
 	}
 	return [];
 }
+const BoardContentKindSchema = z.enum([
+	"text",
+	"image",
+	"video",
+	"audio",
+	"file",
+	"json",
+	"collection"
+]);
+const BoardPortSchema = z.object({
+	id: z.string().min(1).max(120),
+	kind: BoardContentKindSchema,
+	role: z.string().min(1).max(80).optional(),
+	required: z.boolean().optional(),
+	multiple: z.boolean().optional(),
+	maxItems: z.number().int().positive().optional()
+}).strict();
+z.object({
+	inputs: z.array(BoardPortSchema),
+	outputs: z.array(BoardPortSchema)
+}).strict();
 //#endregion
 //#region ../protocol/dist/realtime/board-awareness.js
 const idSchema = z.string().min(1).max(160);
@@ -2147,186 +2646,12 @@ const buildWorkComposerChipClear = (key) => ({
 	key
 });
 //#endregion
-//#region src/board/core/draw-geometry.ts
-/** Radius of a sample in world units given the stroke size and pressure. */
-function sampleRadius(size, pressure) {
-	const clamped = Math.min(1, Math.max(0, pressure));
-	return Math.max(.5, size / 2 * (.5 + clamped));
-}
-/** Axis-aligned bounds of a stroke in its local space, padded by stroke width. */
-function computeDrawBounds(points, size) {
-	if (points.length === 0) return {
-		x: 0,
-		y: 0,
-		width: 1,
-		height: 1
-	};
-	let minX = Number.POSITIVE_INFINITY;
-	let minY = Number.POSITIVE_INFINITY;
-	let maxX = Number.NEGATIVE_INFINITY;
-	let maxY = Number.NEGATIVE_INFINITY;
-	for (const point of points) {
-		const r = sampleRadius(size, point.p);
-		minX = Math.min(minX, point.x - r);
-		minY = Math.min(minY, point.y - r);
-		maxX = Math.max(maxX, point.x + r);
-		maxY = Math.max(maxY, point.y + r);
-	}
-	return {
-		x: minX,
-		y: minY,
-		width: Math.max(1, maxX - minX),
-		height: Math.max(1, maxY - minY)
-	};
-}
-//#endregion
-//#region src/board/nodes.ts
-var BoardInputError = class extends Error {
-	code = "INVALID_BOARD_NODE";
-	diagnostics;
-	body;
-	constructor(diagnostics) {
-		const message = diagnostics[0]?.message ?? "Invalid Board node";
-		super(message);
-		this.name = "BoardInputError";
-		this.diagnostics = diagnostics;
-		this.body = {
-			code: this.code,
-			message,
-			diagnostics
-		};
-	}
-};
-function baseNode(spec, frame) {
-	return {
-		nodeId: spec.id,
-		type: spec.type,
-		parentId: spec.parentId ?? null,
-		orderKey: spec.orderKey ?? null,
-		x: frame.x,
-		y: frame.y,
-		width: frame.width,
-		height: frame.height,
-		rotation: frame.rotation ?? 0,
-		refKind: null,
-		refPath: null,
-		refUrl: null,
-		view: {},
-		style: spec.style ?? {},
-		data: {}
-	};
-}
-function arrowFrame(start, end) {
-	const padding = 16;
-	return {
-		x: Math.min(start.x, end.x) - padding,
-		y: Math.min(start.y, end.y) - padding,
-		width: Math.max(1, Math.abs(end.x - start.x) + padding * 2),
-		height: Math.max(1, Math.abs(end.y - start.y) + padding * 2)
-	};
-}
-/**
-* Create one validated wire node from semantic Board input.
-*
-* Box nodes take an explicit world-space frame. Draw samples and arrow endpoints
-* take world coordinates; the builder derives their frame and local storage form.
-*/
-function createBoardNode(spec) {
-	let node;
-	if (spec.type === "draw") {
-		const size = spec.size ?? 4;
-		const worldPoints = spec.points.map((point) => ({
-			x: point.x,
-			y: point.y,
-			p: point.p ?? .5
-		}));
-		const bounds = computeDrawBounds(worldPoints, size);
-		node = baseNode(spec, bounds);
-		node.data = {
-			points: worldPoints.map((point) => ({
-				x: point.x - bounds.x,
-				y: point.y - bounds.y,
-				p: point.p
-			})),
-			color: spec.color ?? "brand",
-			size
-		};
-	} else if (spec.type === "arrow") {
-		node = baseNode(spec, arrowFrame(spec.start, spec.end));
-		node.data = {
-			start: spec.start,
-			end: spec.end,
-			bend: spec.bend ?? 0,
-			color: spec.color ?? "brand",
-			size: spec.size ?? 2.5,
-			arrowStart: spec.arrowStart ?? false,
-			arrowEnd: spec.arrowEnd ?? true,
-			label: spec.label ?? ""
-		};
-	} else {
-		node = baseNode(spec, spec.frame);
-		switch (spec.type) {
-			case "text":
-				node.data = {
-					text: spec.text ?? "",
-					color: spec.color ?? "neutral",
-					fontSize: spec.fontSize ?? 24
-				};
-				break;
-			case "geo":
-				node.data = {
-					geo: spec.geo ?? "rectangle",
-					text: spec.text ?? "",
-					color: spec.color ?? "brand",
-					fillOpacity: spec.fillOpacity ?? 0
-				};
-				break;
-			case "frame":
-				node.data = {
-					label: spec.label ?? "Frame",
-					color: spec.color ?? "neutral"
-				};
-				break;
-			case "image":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				node.data = spec.crop ? { crop: spec.crop } : {};
-				break;
-			case "video":
-			case "audio":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				break;
-			case "file":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				break;
-			case "task":
-				node.view = spec.snapshot;
-				node.data = { taskRunId: spec.taskRunId };
-				break;
-		}
-	}
-	assertBoardNodes([node]);
-	return node;
-}
-function validateBoardNodes(nodes, path = "nodes") {
-	return nodes.flatMap((node, index) => validateBoardNodeInput(node, `${path}.${index}`));
-}
-function assertBoardNodes(nodes, path = "nodes") {
-	const diagnostics = validateBoardNodes(nodes, path);
-	if (diagnostics.length > 0) throw new BoardInputError(diagnostics);
-}
-function assertBoardTransactionNodeCreates(operations) {
-	const diagnostics = operations.flatMap((operation, index) => {
-		if (operation.type !== "node.create") return [];
-		const payload = operation.payload;
-		return payload.node ? validateBoardNodeInput(payload.node, `operations.${index}.payload.node`) : [];
+//#region src/realtime.ts
+function ensureRealtimeConnected(websocketClient) {
+	if (websocketClient.state === "open" || websocketClient.state === "connecting" || websocketClient.state === "reconnecting") return;
+	websocketClient.connect().catch((error) => {
+		console.error("[CohubClient] Failed to connect realtime websocket:", error);
 	});
-	if (diagnostics.length > 0) throw new BoardInputError(diagnostics);
 }
 //#endregion
 //#region src/session-patch-reducer.ts
@@ -4382,19 +4707,43 @@ var BoardClient = class {
 	summary(customFetch) {
 		return this.boards.summary(this.id, customFetch);
 	}
+	authoring(customFetch) {
+		return this.boards.authoring(this.id, customFetch);
+	}
+	mutateSemantic(input) {
+		return this.boards.mutateSemantic(this.id, {
+			...input,
+			mutationId: input.mutationId ?? randomBoardId()
+		});
+	}
 	async mutate(input) {
 		const retries = input.retries ?? 1;
 		if (!Number.isSafeInteger(retries) || retries < 0 || retries > 3) throw new RangeError("Board mutation retries must be an integer from 0 to 3");
 		for (let attempt = 0;; attempt += 1) {
 			const current = await this.inspect({ include: input.include ?? [] });
 			const operations = await input.build(current);
-			if (operations.length === 0) return current;
+			if (operations.length === 0) return {
+				mutationId: randomBoardId(),
+				status: "validated",
+				replayed: false,
+				board: {
+					id: current.board.id,
+					version: current.board.version
+				},
+				changed: {
+					items: [],
+					connections: [],
+					effects: [],
+					compositions: [],
+					board: false
+				}
+			};
 			try {
 				return await this.apply({
 					txId: randomBoardId(),
 					baseVersion: current.board.version,
 					operations
-				}, { compact: true });
+				});
 			} catch (cause) {
 				if (!(cause instanceof BoardTransactionError) || !cause.isVersionConflict || attempt >= retries) throw cause;
 			}
@@ -4406,11 +4755,11 @@ var BoardClient = class {
 			boardId: this.id
 		});
 	}
-	apply(transaction, options) {
+	apply(transaction) {
 		return this.boards.apply({
 			...transaction,
 			boardId: this.id
-		}, options);
+		});
 	}
 	updateAwareness(seq, update) {
 		if (!this.websocketClient) return Promise.resolve();
@@ -4540,7 +4889,7 @@ var SpaceBoardsApi = class {
 		return new BoardClient(this.spaceId, boardId, this.transport, this.websocketClient);
 	}
 	create(input) {
-		assertBoardNodes(input.nodes ?? []);
+		for (const item of input.items ?? []) BoardAuthoringItemSchema.parse(item);
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
@@ -4554,6 +4903,16 @@ var SpaceBoardsApi = class {
 		const query = params.toString();
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}${query ? `?${query}` : ""}`, { fetch: customFetch });
 	}
+	authoring(boardId, customFetch) {
+		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/authoring`, { fetch: customFetch });
+	}
+	mutateSemantic(boardId, mutation) {
+		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/mutations`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(mutation)
+		});
+	}
 	summary(boardId, customFetch) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/summary`, { fetch: customFetch });
 	}
@@ -4567,10 +4926,9 @@ var SpaceBoardsApi = class {
 			body: JSON.stringify(transaction)
 		});
 	}
-	async apply(transaction, options) {
-		assertBoardTransactionNodeCreates(transaction.operations);
+	async apply(transaction) {
 		try {
-			return await this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/transactions${options?.compact ? "?compact=1" : ""}`, {
+			return await this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/transactions`, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify(transaction)
@@ -5359,4 +5717,4 @@ var CohubHttpClient = class {
 };
 const createHttpClient = (options) => new CohubHttpClient(options);
 //#endregion
-export { parseUsername as $, WORK_SURFACE_READY_TIMEOUT_MS as A, parseWorkSurfaceRequest as B, BoardInputError as C, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES as D, validateBoardNodes as E, buildWorkSurfaceRequest as F, UI_COMMAND_PENDING_TTL_SECONDS as G, UI_COMMAND_DEFAULT_TIMEOUT_MS as H, buildWorkSurfaceResponse as I, UI_COMMAND_VERSION as J, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as K, parseWorkComposerChipClear as L, buildWorkComposerChipClear as M, buildWorkComposerChipSet as N, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH as O, buildWorkSurfaceReady as P, parseSpaceSlug as Q, parseWorkComposerChipSet as R, createSessionPatchReducer as S, createBoardNode as T, UI_COMMAND_MAX_TIMEOUT_MS as U, parseWorkSurfaceResponse as V, UI_COMMAND_PAYLOAD_MAX_BYTES as W, isUiSurfaceMethod as X, isTerminalUiCommandStatus as Y, parseUiCommand as Z, buildSpacePath as _, PromptsApi as _t, ReferralsApi as a, validateBoardNodeInput as at, parseAssistantMessageCommit as b, CronJobsApi as bt, UiCommandsApi as c, parseBoardPlaybackPolicy as ct, BoardTransactionError as d, DEFAULT_BOARD_RENDER_LIMITS as dt, BoardAwarenessClientPayloadSchema as et, SpaceClient as f, SessionAccessApi as ft, buildSpaceInvitePath as g, SkillsApi as gt, PublicInviteApi as h, PublicAssetsApi as ht, WorksApi as i, BOARD_NODE_CONTRACT as it, WORK_SURFACE_REQUEST_TIMEOUT_MS as j, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH as k, TasksApi as l, ensureRealtimeConnected as lt, SpacesApi as m, SearchApi as mt, createHttpClient as n, BOARD_GEO_KINDS as nt, UsersApi as o, BoardCameraFocusParamsSchema as ot, SpacePublicFilesApi as p, ReferencesApi as pt, UI_COMMAND_TERMINAL_TTL_SECONDS as q, WorkCommerceApi as r, BOARD_NATIVE_NODE_TYPES as rt, UserApi as s, BoardPlaybackPolicySchema as st, CohubHttpClient as t, BOARD_COLOR_IDS as tt, BoardClient as u, BOARD_BUILTIN_CAPABILITIES as ut, SessionGenerationStreamClient as v, ModelsApi as vt, assertBoardNodes as w, SessionPatchReducer as x, ChannelsApi as xt, createSessionGenerationStreamClient as y, GenerationsApi as yt, parseWorkSurfaceReady as z };
+export { BOARD_GEO_KINDS as $, buildWorkComposerChipSet as A, UI_COMMAND_MAX_TIMEOUT_MS as B, ensureRealtimeConnected as C, SkillsApi as Ct, WORK_SURFACE_READY_TIMEOUT_MS as D, CronJobsApi as Dt, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH as E, GenerationsApi as Et, parseWorkComposerChipSet as F, UI_COMMAND_VERSION as G, UI_COMMAND_PENDING_TTL_SECONDS as H, parseWorkSurfaceReady as I, parseUiCommand as J, isTerminalUiCommandStatus as K, parseWorkSurfaceRequest as L, buildWorkSurfaceRequest as M, buildWorkSurfaceResponse as N, WORK_SURFACE_REQUEST_TIMEOUT_MS as O, ChannelsApi as Ot, parseWorkComposerChipClear as P, BOARD_COLOR_IDS as Q, parseWorkSurfaceResponse as R, createSessionPatchReducer as S, PublicAssetsApi as St, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH as T, ModelsApi as Tt, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as U, UI_COMMAND_PAYLOAD_MAX_BYTES as V, UI_COMMAND_TERMINAL_TTL_SECONDS as W, parseUsername as X, parseSpaceSlug as Y, BoardAwarenessClientPayloadSchema as Z, buildSpacePath as _, BOARD_BUILTIN_CAPABILITIES as _t, ReferralsApi as a, BoardEffectSchema as at, parseAssistantMessageCommit as b, ReferencesApi as bt, UiCommandsApi as c, BoardAuthoringItemSchema as ct, BoardTransactionError as d, BOARD_ANIMATION_CHANNEL_CAPABILITIES as dt, BOARD_NATIVE_NODE_TYPES as et, SpaceClient as f, BoardCompositionInputSchema as ft, buildSpaceInvitePath as g, parseBoardCompositionInput as gt, PublicInviteApi as h, BoardTrackSchema as ht, WorksApi as i, validateBuiltinBoardClip as it, buildWorkSurfaceReady as j, buildWorkComposerChipClear as k, TasksApi as l, BoardItemPatchSchema as lt, SpacesApi as m, BoardProceduralClipSchema as mt, createHttpClient as n, validateBoardNodeInput as nt, UsersApi as o, BoardPlaybackPolicySchema as ot, SpacePublicFilesApi as p, BoardCompositionSchema as pt, isUiSurfaceMethod as q, WorkCommerceApi as r, estimateBuiltinBoardClipCost as rt, UserApi as s, parseBoardPlaybackPolicy as st, CohubHttpClient as t, BOARD_NODE_CONTRACT as tt, BoardClient as u, BOARD_ANIMATION_CHANNELS as ut, SessionGenerationStreamClient as v, DEFAULT_BOARD_RENDER_LIMITS as vt, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES as w, PromptsApi as wt, SessionPatchReducer as x, SearchApi as xt, createSessionGenerationStreamClient as y, SessionAccessApi as yt, UI_COMMAND_DEFAULT_TIMEOUT_MS as z };