@neta-art/cohub 8.10.2 → 8.12.0

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

@@ -0,0 +1 @@
+import { z } from "zod";

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-animation.js
+const extensionKindSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+const finiteSchema = z.number().finite();
+/** Parameters shared by the built-in deal entrance preset. */
+const BoardDealParamsSchema = z.object({
+	lift: finiteSchema.nonnegative().max(2e3).optional(),
+	swing: finiteSchema.nonnegative().max(2e3).optional(),
+	curve: finiteSchema.nonnegative().max(2e3).optional(),
+	tilt: finiteSchema.nonnegative().max(180).optional(),
+	scale: finiteSchema.positive().max(2).optional(),
+	duration: finiteSchema.positive().max(1e4).optional(),
+	landing: finiteSchema.nonnegative().max(1e4).optional()
+}).strict();
+/** A versioned, reusable animation preset reference. */
+const BoardAnimationSpecSchema = z.object({
+	kind: extensionKindSchema,
+	kindVersion: z.number().int().positive().default(1),
+	params: jsonObjectSchema.default({})
+}).strict().superRefine((spec, context) => {
+	if (spec.kind !== "effects.deal" || spec.kindVersion !== 1) return;
+	const parsed = BoardDealParamsSchema.safeParse(spec.params);
+	if (parsed.success) return;
+	context.addIssue({
+		code: "custom",
+		message: parsed.error.issues[0]?.message ?? "invalid effects.deal parameters",
+		path: ["params", ...parsed.error.issues[0]?.path ?? []]
+	});
+});
+/** Board-wide default motion policies. Omitted policies mean no motion. */
+const BoardMotionSchema = z.object({ enter: BoardAnimationSpecSchema.optional() }).strict();
+//#endregion
+export { BoardAnimationSpecSchema, BoardDealParamsSchema, BoardMotionSchema };

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

@@ -1140,10 +1140,11 @@ declare const BoardSemanticCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"board">;
     }, z.core.$strict>], "type">;
     kind: z.ZodString;
-    kindVersion: z.ZodNumber;
+    kindVersion: z.ZodDefault<z.ZodNumber>;
     enabled: z.ZodDefault<z.ZodBoolean>;
     lifecycle: z.ZodEnum<{
       manual: "manual";
+      "on-enter": "on-enter";
       persistent: "persistent";
       "when-visible": "when-visible";
     }>;

package/dist/protocol/dist/board-capability-registry.js

@@ -1,8 +1,17 @@
-import { BOARD_BUILTIN_CLIP_KINDS, BOARD_BUILTIN_EFFECT_KINDS, DEFAULT_BOARD_RENDER_LIMITS } from "./board-constants.js";
+import { BOARD_BUILTIN_CAPABILITIES, BOARD_BUILTIN_CLIP_KINDS, BOARD_BUILTIN_EFFECT_KINDS, DEFAULT_BOARD_RENDER_LIMITS } from "./board-constants.js";
 import { BoardCameraFocusParamsSchema } from "./board.js";
+import { BoardDealParamsSchema } from "./board-animation.js";
 //#region ../protocol/dist/board-capability-registry.js
 const CLIPS = new Set(BOARD_BUILTIN_CLIP_KINDS);
-new Set(BOARD_BUILTIN_EFFECT_KINDS);
+const EFFECTS = new Set(BOARD_BUILTIN_EFFECT_KINDS);
+const BUILTIN_VERSIONS = new Set(BOARD_BUILTIN_CAPABILITIES.map((c) => `${c.kind}:${c.id}@${c.version}`));
+/**
+* True when a built-in renderer exists for exactly this kind@version. A known
+* kind at an unknown version is not built-in: it must not pass as one.
+*/
+function isBuiltinBoardCapability(kind, id, version) {
+	return BUILTIN_VERSIONS.has(`${kind}:${id}@${version}`);
+}
 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") {
@@ -36,6 +45,47 @@ function validateBuiltinBoardClip(clip, path = "clip") {
 	}
 	return errors;
 }
+function validateBuiltinBoardEffect(effect, path = "effect") {
+	const diagnostics = [];
+	if (effect.lifecycle === "on-enter") {
+		if (effect.target.type !== "item") diagnostics.push({
+			severity: "error",
+			code: "INVALID_BOARD_EFFECT",
+			message: "on-enter effects must target an item",
+			path: `${path}.target`
+		});
+		if (effect.timeOrigin !== "activation") diagnostics.push({
+			severity: "error",
+			code: "INVALID_BOARD_EFFECT",
+			message: "on-enter effects must use activation time",
+			path: `${path}.timeOrigin`
+		});
+	} else if (EFFECTS.has(effect.kind) && effect.target.type !== "item") diagnostics.push({
+		severity: "error",
+		code: "INVALID_BOARD_EFFECT",
+		message: `${effect.kind} must target an item`,
+		path: `${path}.target`
+	});
+	if (effect.kind === "effects.deal" && effect.kindVersion === 1) {
+		if (effect.lifecycle !== "on-enter") diagnostics.push({
+			severity: "error",
+			code: "INVALID_BOARD_EFFECT",
+			message: "effects.deal must use the on-enter lifecycle",
+			path: `${path}.lifecycle`
+		});
+		const parsed = BoardDealParamsSchema.safeParse(effect.params);
+		if (!parsed.success) diagnostics.push({
+			severity: "error",
+			code: "INVALID_BOARD_EFFECT",
+			message: parsed.error.issues[0]?.message ?? "invalid effects.deal parameters",
+			path: `${path}.params`
+		});
+	}
+	return diagnostics;
+}
+function estimateBuiltinBoardEffectCost(effect) {
+	return isBuiltinBoardCapability("effect", effect.kind, effect.kindVersion) ? { drawCalls: 1 } : {};
+}
 function estimateBuiltinBoardClipCost(clip) {
 	switch (clip.kind) {
 		case "effects.particles": {
@@ -70,4 +120,4 @@ function estimateBuiltinBoardClipCost(clip) {
 	}
 }
 //#endregion
-export { estimateBuiltinBoardClipCost, validateBuiltinBoardClip };
+export { estimateBuiltinBoardClipCost, estimateBuiltinBoardEffectCost, isBuiltinBoardCapability, validateBuiltinBoardClip, validateBuiltinBoardEffect };

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

@@ -1,6 +1,6 @@
 import { BoardAuthoringItemSchema, BoardItemPatchSchema } from "./board-authoring.js";
 import { BoardNodeInputSchema } from "./board.js";
-import { boardArrowFrame, boardDrawBounds, boardDrawPointsToLocal } from "./board-geometry.js";
+import { boardArrowFrame, boardDrawBounds, boardDrawPointsToLocal, boardDrawPointsToWorld } from "./board-geometry.js";
 import { BOARD_NATIVE_NODE_TYPES, validateBoardNodeInput } from "./board-node.js";
 //#region ../protocol/dist/board-codec.js
 var BoardItemValidationError = class extends Error {
@@ -30,6 +30,153 @@ function authoringDiagnostic(diagnostic, path) {
 	};
 }
 const isRecord = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+function baseItem(node) {
+	return {
+		id: node.nodeId,
+		position: {
+			x: node.x,
+			y: node.y
+		},
+		size: {
+			width: node.width,
+			height: node.height
+		},
+		rotation: node.rotation,
+		...node.parentId ? { parentId: node.parentId } : {},
+		...node.data.locked === true ? { locked: true } : {},
+		...isRecord(node.data.metadata) ? { metadata: node.data.metadata } : {}
+	};
+}
+function filePath(node) {
+	if (!node.refPath) throw new Error(`Board item ${node.nodeId} is missing its source path`);
+	return node.refPath;
+}
+function style(node) {
+	const value = {};
+	if (typeof node.data.color === "string") value.color = node.data.color;
+	if (typeof node.data.size === "number") value.strokeWidth = node.data.size;
+	if (typeof node.data.fillOpacity === "number") value.fillOpacity = node.data.fillOpacity;
+	return Object.keys(value).length ? value : void 0;
+}
+function boardNodeToAuthoringItem(node) {
+	const base = baseItem(node);
+	if (node.type === "draw" || node.type === "arrow") {
+		delete base.size;
+		delete base.position;
+	}
+	const visual = style(node);
+	let candidate;
+	switch (node.type) {
+		case "text":
+			candidate = {
+				...base,
+				type: "text",
+				props: {
+					text: node.data.text ?? "",
+					fontSize: node.data.fontSize ?? 24
+				},
+				...visual ? { style: visual } : {}
+			};
+			break;
+		case "geo":
+			candidate = {
+				...base,
+				type: "geo",
+				props: {
+					shape: node.data.geo ?? "rectangle",
+					text: node.data.text ?? ""
+				},
+				...visual ? { style: visual } : {}
+			};
+			break;
+		case "draw":
+			candidate = {
+				...base,
+				type: "draw",
+				props: { points: Array.isArray(node.data.points) ? boardDrawPointsToWorld(node.data.points, node.x, node.y) : [] },
+				...visual ? { style: visual } : {}
+			};
+			break;
+		case "arrow":
+			candidate = {
+				...base,
+				type: "arrow",
+				props: {
+					start: node.data.start,
+					end: node.data.end,
+					bend: node.data.bend ?? 0,
+					arrowStart: node.data.arrowStart ?? false,
+					arrowEnd: node.data.arrowEnd ?? true,
+					label: node.data.label ?? ""
+				},
+				...visual ? { style: visual } : {}
+			};
+			break;
+		case "frame":
+			candidate = {
+				...base,
+				type: "frame",
+				props: { label: node.data.label ?? "Frame" },
+				...visual ? { style: visual } : {}
+			};
+			break;
+		case "image":
+			candidate = {
+				...base,
+				type: "image",
+				props: isRecord(node.data.crop) ? { crop: node.data.crop } : {},
+				source: {
+					kind: "space-file",
+					path: filePath(node),
+					...Object.keys(node.view).length ? { snapshot: node.view } : {}
+				}
+			};
+			break;
+		case "video":
+		case "audio":
+		case "file":
+			candidate = {
+				...base,
+				type: node.type,
+				props: {},
+				source: {
+					kind: "space-file",
+					path: filePath(node),
+					...Object.keys(node.view).length ? { snapshot: node.view } : {}
+				}
+			};
+			break;
+		case "task":
+			candidate = {
+				...base,
+				type: "task",
+				props: {
+					taskRunId: node.data.taskRunId,
+					snapshot: node.view
+				}
+			};
+			break;
+		default: {
+			const props = { ...node.data };
+			delete props.locked;
+			delete props.metadata;
+			delete props.kindVersion;
+			candidate = {
+				...base,
+				type: node.type,
+				kindVersion: typeof node.data.kindVersion === "number" ? node.data.kindVersion : 1,
+				props,
+				...Object.keys(node.style).length ? { style: node.style } : {},
+				...node.refPath ? { source: {
+					kind: node.refKind ?? "space-file",
+					ref: node.refPath,
+					...Object.keys(node.view).length ? { snapshot: node.view } : {}
+				} } : {}
+			};
+		}
+	}
+	return BoardAuthoringItemSchema.parse(candidate);
+}
 function commonData(item) {
 	return {
 		...item.locked ? { locked: true } : {},
@@ -233,4 +380,4 @@ function mergePatch(current, patch) {
 	return result;
 }
 //#endregion
-export { BoardItemValidationError, applyBoardItemPatch, authoringSchemaDiagnostics, boardAuthoringItemToNode };
+export { BoardItemValidationError, applyBoardItemPatch, authoringSchemaDiagnostics, boardAuthoringItemToNode, boardNodeToAuthoringItem };

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

@@ -21,7 +21,11 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 	"camera.focus",
 	"camera.shake"
 ];
-const BOARD_BUILTIN_EFFECT_KINDS = ["effects.pulse", "effects.float"];
+const BOARD_BUILTIN_EFFECT_KINDS = [
+	"effects.pulse",
+	"effects.float",
+	"effects.deal"
+];
 /**
 * World-space typography for board text.
 *
@@ -85,6 +89,20 @@ function clipSchema(id) {
 		default: return;
 	}
 }
+function effectSchema(id) {
+	switch (id) {
+		case "effects.deal": return { params: {
+			lift: { unit: "board" },
+			swing: { unit: "board" },
+			curve: { unit: "board" },
+			tilt: { unit: "degree" },
+			scale: { unit: "ratio" },
+			duration: { unit: "ms" },
+			landing: { unit: "ms" }
+		} };
+		default: return;
+	}
+}
 const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => {
 	const schema = clipSchema(id);
 	return {
@@ -94,11 +112,15 @@ const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => {
 		renderers: ["webgpu", "webgl"],
 		...schema ? { schema } : {}
 	};
-}), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => ({
-	kind: "effect",
-	id,
-	version: 1,
-	renderers: ["webgpu", "webgl"]
-}))];
+}), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => {
+	const schema = effectSchema(id);
+	return {
+		kind: "effect",
+		id,
+		version: 1,
+		renderers: ["webgpu", "webgl"],
+		...schema ? { schema } : {}
+	};
+})];
 //#endregion
 export { BOARD_ARROW_STROKE_SIZE, BOARD_BUILTIN_CAPABILITIES, BOARD_BUILTIN_CLIP_KINDS, BOARD_BUILTIN_EFFECT_KINDS, BOARD_CONNECTION_STROKE_SIZE, BOARD_FONT_STACK, BOARD_MONO_FONT_STACK, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TEXT_FONT_FAMILY, DEFAULT_BOARD_RENDER_LIMITS, clampBoardStrokeSize };

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

@@ -21,7 +21,21 @@ declare const BoardViewportSchema: z.ZodObject<{
   zoom: z.ZodNumber;
 }, z.core.$strip>;
 declare const BoardAppearanceSchema: z.ZodObject<{
-  theme: z.ZodDefault<z.ZodString>;
+  theme: z.ZodOptional<z.ZodString>;
+  motion: z.ZodOptional<z.ZodObject<{
+    enter: z.ZodOptional<z.ZodObject<{
+      kind: z.ZodString;
+      kindVersion: z.ZodDefault<z.ZodNumber>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  mood: z.ZodOptional<z.ZodEnum<{
+    arcane: "arcane";
+    clean: "clean";
+    cyber: "cyber";
+    natural: "natural";
+    playful: "playful";
+  }>>;
   background: z.ZodDefault<z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<{
       custom: "custom";
@@ -52,13 +66,6 @@ declare const BoardAppearanceSchema: z.ZodObject<{
     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<{
@@ -1046,7 +1053,21 @@ declare const BoardDocumentSchema: z.ZodObject<{
   kind: z.ZodLiteral<"cohub.board">;
   version: z.ZodLiteral<1>;
   appearance: z.ZodDefault<z.ZodObject<{
-    theme: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    motion: z.ZodOptional<z.ZodObject<{
+      enter: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        kindVersion: z.ZodDefault<z.ZodNumber>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    mood: z.ZodOptional<z.ZodEnum<{
+      arcane: "arcane";
+      clean: "clean";
+      cyber: "cyber";
+      natural: "natural";
+      playful: "playful";
+    }>>;
     background: z.ZodDefault<z.ZodObject<{
       kind: z.ZodDefault<z.ZodEnum<{
         custom: "custom";
@@ -1077,13 +1098,6 @@ declare const BoardDocumentSchema: z.ZodObject<{
       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;

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

@@ -1,6 +1,7 @@
 import { BOARD_ARROW_STROKE_SIZE } from "./board-constants.js";
 import { BoardConnectionSchema } from "./board-connection.js";
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION } from "./board.js";
+import { BoardMotionSchema } from "./board-animation.js";
 import { BOARD_REMOTE_URL_MAX_LENGTH, BoardRemoteUrlSchema, isPublicBoardRemoteAddress, normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-document.js
@@ -23,7 +24,18 @@ const BoardViewportSchema = z.object({
 	zoom: z.number().finite().min(.05).max(8)
 });
 const BoardAppearanceSchema = z.object({
-	theme: z.string().min(1).default("clean"),
+	/** Legacy field retained when reading older Board documents; not used for rendering. */
+	theme: z.string().min(1).optional(),
+	/** Board-wide motion policies. Omitted policies mean no motion. */
+	motion: BoardMotionSchema.optional(),
+	/** Legacy field retained when reading older Board documents; not used for rendering. */
+	mood: z.enum([
+		"clean",
+		"playful",
+		"arcane",
+		"cyber",
+		"natural"
+	]).optional(),
 	background: z.object({
 		kind: z.enum([
 			"solid",
@@ -57,14 +69,7 @@ const BoardAppearanceSchema = z.object({
 		visible: false,
 		size: 24,
 		opacity: .12
-	}),
-	mood: z.enum([
-		"clean",
-		"playful",
-		"arcane",
-		"cyber",
-		"natural"
-	]).default("clean")
+	})
 });
 /** Optional visual chrome still carried by a few older shapes. */
 const BoardItemStyleSchema = z.object({
@@ -390,14 +395,12 @@ const BoardDocumentSchema = z.object({
 	kind: z.literal(BOARD_DOCUMENT_KIND),
 	version: z.literal(1),
 	appearance: BoardAppearanceSchema.default({
-		theme: "clean",
 		background: { kind: "solid" },
 		grid: {
 			visible: false,
 			size: 24,
 			opacity: .12
-		},
-		mood: "clean"
+		}
 	}),
 	viewport: BoardViewportSchema,
 	items: z.array(BoardItemSchema),

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

@@ -18,10 +18,11 @@ declare const BoardEffectSchema: z.ZodObject<{
     type: z.ZodLiteral<"board">;
   }, z.core.$strict>], "type">;
   kind: z.ZodString;
-  kindVersion: z.ZodNumber;
+  kindVersion: z.ZodDefault<z.ZodNumber>;
   enabled: z.ZodDefault<z.ZodBoolean>;
   lifecycle: z.ZodEnum<{
     manual: "manual";
+    "on-enter": "on-enter";
     persistent: "persistent";
     "when-visible": "when-visible";
   }>;
@@ -60,10 +61,11 @@ declare const BoardEffectInputSchema: z.ZodObject<{
     type: z.ZodLiteral<"board">;
   }, z.core.$strict>], "type">;
   kind: z.ZodString;
-  kindVersion: z.ZodNumber;
+  kindVersion: z.ZodDefault<z.ZodNumber>;
   enabled: z.ZodDefault<z.ZodBoolean>;
   lifecycle: z.ZodEnum<{
     manual: "manual";
+    "on-enter": "on-enter";
     persistent: "persistent";
     "when-visible": "when-visible";
   }>;

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

@@ -21,12 +21,13 @@ const BoardEffectSchema = z.object({
 		itemId: idSchema
 	}).strict(), z.object({ type: z.literal("board") }).strict()]),
 	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
+	kindVersion: z.number().int().positive().default(1),
 	enabled: z.boolean().default(true),
 	lifecycle: z.enum([
 		"persistent",
 		"when-visible",
-		"manual"
+		"manual",
+		"on-enter"
 	]),
 	timeOrigin: z.enum([
 		"board",