@neta-art/cohub 9.0.1 → 11.0.0

package/dist/board/model/items/registry.js

@@ -0,0 +1,84 @@
+import { hasAuthoredSize, parseBoardItem } from "../../../protocol/dist/board-model.js";
+import { frameContainsPoint, itemBounds } from "../geometry.js";
+import { FULL_CAPABILITIES } from "./definition.js";
+import { builtinBoardItems } from "./builtin.js";
+import { createBoardItemId } from "./id.js";
+//#region src/board/model/items/registry.ts
+const DEFAULT_ITEM_SIZE = {
+	width: 240,
+	height: 160
+};
+function createBoardRegistry(definitions = []) {
+	const byType = /* @__PURE__ */ new Map();
+	for (const definition of [...builtinBoardItems, ...definitions]) byType.set(definition.type, definition);
+	const capabilities = /* @__PURE__ */ new Map();
+	function capabilitiesOf(type) {
+		let value = capabilities.get(type);
+		if (!value) {
+			value = {
+				...FULL_CAPABILITIES,
+				...byType.get(type)?.capabilities
+			};
+			capabilities.set(type, value);
+		}
+		return value;
+	}
+	function validateProps(type, props) {
+		const schema = byType.get(type)?.props;
+		if (!schema) return { ok: true };
+		const parsed = schema.safeParse(props);
+		if (parsed.success) return { ok: true };
+		const issue = parsed.error.issues[0];
+		return {
+			ok: false,
+			message: `${type} props${issue?.path.length ? `.${issue.path.join(".")}` : ""}: ${issue?.message ?? "invalid"}`
+		};
+	}
+	return {
+		definitions: [...byType.values()],
+		get: (type) => byType.get(type),
+		capabilities: (item) => capabilitiesOf(item.type),
+		resizeMode(item) {
+			const value = capabilitiesOf(item.type);
+			if (!value.canResize) return "none";
+			return value.aspectLocked ? "uniform" : "free";
+		},
+		bounds: (item) => byType.get(item.type)?.bounds?.(item) ?? itemBounds(item.frame),
+		hitTest(item, point) {
+			const hitTest = byType.get(item.type)?.hitTest;
+			return hitTest ? hitTest(item, point) : frameContainsPoint(item.frame, point);
+		},
+		validateProps,
+		create(type, { props = {}, at, size, id = createBoardItemId() }) {
+			const valid = validateProps(type, props);
+			if (!valid.ok) throw new Error(valid.message);
+			const box = size ?? byType.get(type)?.size ?? DEFAULT_ITEM_SIZE;
+			const placement = hasAuthoredSize(type) ? {
+				position: {
+					x: at.x - box.width / 2,
+					y: at.y - box.height / 2
+				},
+				size: { ...box }
+			} : { position: {
+				x: at.x,
+				y: at.y
+			} };
+			const parsed = parseBoardItem({
+				type,
+				...placement,
+				props
+			});
+			if (!parsed.ok) {
+				const diagnostic = parsed.diagnostics[0];
+				throw new Error(`Invalid ${type} item: ${diagnostic?.path}: ${diagnostic?.message}`);
+			}
+			return {
+				id,
+				item: parsed.item
+			};
+		}
+	};
+}
+const defaultBoardRegistry = createBoardRegistry();
+//#endregion
+export { createBoardRegistry, defaultBoardRegistry };

package/dist/board/{media-playback.d.ts → model/media-playback.d.ts}

@@ -1,9 +1,10 @@
-import { BoardSceneItem } from "./core/scene.js";
-//#region src/board/media-playback.d.ts
+import { BoardSceneItem } from "./scene.js";
+//#region src/board/model/media-playback.d.ts
 type BoardAssetSource = {
   resolveFileUrl: (path: string) => Promise<string | null>;
   resolvePlaybackUrl?: (path: string) => Promise<string | null>;
 };
+declare function resolveBoardMediaUrl(src: string, source: BoardAssetSource, purpose?: "preview" | "playback"): Promise<string | null>;
 type BoardPlayableMedia = {
   id: string;
   kind: "video" | "audio";
@@ -16,4 +17,4 @@ declare function playableBoardMediaList(item: BoardSceneItem | null, assetSource
 declare function playableBoardMedia(item: BoardSceneItem | null, assetSource: BoardAssetSource, artifactId?: string | null): BoardPlayableMedia | null;
 declare function resetBoardPlaybackUrlCache(): void;
 //#endregion
-export { BoardAssetSource, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache };
+export { BoardAssetSource, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl };

package/dist/board/{media-playback.js → model/media-playback.js}

@@ -1,5 +1,13 @@
+import { parseBoardMediaSource } from "../../protocol/dist/board-model.js";
+import { getMediaResourceTitle } from "./media.js";
 import { rankedTaskArtifacts } from "./task.js";
-//#region src/board/media-playback.ts
+//#region src/board/model/media-playback.ts
+function resolveBoardMediaUrl(src, source, purpose = "preview") {
+	const parsed = parseBoardMediaSource(src);
+	if (!parsed) return Promise.resolve(null);
+	if (parsed.kind === "url") return Promise.resolve(parsed.value);
+	return purpose === "playback" && source.resolvePlaybackUrl ? source.resolvePlaybackUrl(parsed.value) : source.resolveFileUrl(parsed.value);
+}
 const resolvedUrls = /* @__PURE__ */ new Map();
 const sourceIds = /* @__PURE__ */ new WeakMap();
 const URL_CACHE_LIMIT = 64;
@@ -34,15 +42,17 @@ function cachedUrl(key, resolve) {
 function playableBoardMediaList(item, assetSource) {
 	if (item?.type === "video" || item?.type === "audio") {
 		const path = item.props.src;
+		const source = parseBoardMediaSource(path);
+		if (!source) return [];
 		const version = item.props.snapshot?.mtimeMs ?? "unknown";
-		const cacheKey = `${sourceId(assetSource)}:${item.type}:file:${path}:${version}`;
+		const cacheKey = `${sourceId(assetSource)}:${item.type}:${source.kind}:${path}:${version}`;
 		const durationMs = item.type === "audio" ? item.props.snapshot?.durationMs : void 0;
 		return [{
 			id: item.id,
 			kind: item.type,
-			title: item.props.snapshot?.title ?? path.split("/").pop() ?? item.type,
+			title: item.props.snapshot?.title ?? getMediaResourceTitle(path),
 			...durationMs ? { durationMs } : {},
-			resolveUrl: () => cachedUrl(cacheKey, () => (assetSource.resolvePlaybackUrl ?? assetSource.resolveFileUrl)(path)),
+			resolveUrl: () => cachedUrl(cacheKey, () => resolveBoardMediaUrl(path, assetSource, "playback")),
 			invalidateUrl: () => invalidateCachedUrl(cacheKey)
 		}];
 	}
@@ -64,4 +74,4 @@ function resetBoardPlaybackUrlCache() {
 	resolvedUrls.clear();
 }
 //#endregion
-export { playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache };
+export { playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl };

package/dist/board/{media.d.ts → model/media.d.ts}

@@ -1,4 +1,4 @@
-//#region src/board/media.d.ts
+//#region src/board/model/media.d.ts
 type BoardMediaKind = "image" | "video" | "audio" | "text" | "file";
 declare function getMediaExtension(value: string): string;
 declare function inferBoardMediaKind(value: string, mimeType?: string | null): BoardMediaKind;

package/dist/board/{media.js → model/media.js}

@@ -1,4 +1,4 @@
-//#region src/board/media.ts
+//#region src/board/model/media.ts
 const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 	"png",
 	"jpg",
@@ -59,9 +59,15 @@ function inferBoardMediaKind(value, mimeType) {
 	return "file";
 }
 function getMediaResourceTitle(value) {
+	if (!/^[a-z][a-z\d+.-]*:/i.test(value)) return value.split("/").filter(Boolean).pop() || value;
 	try {
 		const url = new URL(value);
-		return decodeURIComponent(url.pathname.split("/").filter(Boolean).pop() || url.hostname);
+		const title = url.pathname.split("/").filter(Boolean).pop() || url.hostname;
+		try {
+			return decodeURIComponent(title);
+		} catch {
+			return title;
+		}
 	} catch {
 		return value.split("/").filter(Boolean).pop() || value;
 	}

package/dist/board/{core → model}/palette.d.ts

@@ -1,6 +1,6 @@
 import { BoardColor, BoardColorToken } from "../../protocol/dist/board-model.js";
 import "../../protocol/dist/index.js";
-//#region src/board/core/palette.d.ts
+//#region src/board/model/palette.d.ts
 type BoardColorId = BoardColorToken;
 type BoardColorValue = {
   stroke: number;

package/dist/board/{core → model}/palette.js

@@ -1,4 +1,4 @@
-//#region src/board/core/palette.ts
+//#region src/board/model/palette.ts
 const LABEL_DARK = 16053492;
 const LABEL_LIGHT = 1579035;
 const BOARD_COLORS = [

package/dist/board/{presets.d.ts → model/presets.d.ts}

@@ -1,6 +1,6 @@
-import { BoardTrack } from "../protocol/dist/board-model.js";
-import "../protocol/dist/index.js";
-//#region src/board/presets.d.ts
+import { BoardTrack } from "../../protocol/dist/board-model.js";
+import "../../protocol/dist/index.js";
+//#region src/board/model/presets.d.ts
 declare const PRESETS: {
   "fade-in": {
     description: string;

package/dist/board/{presets.js → model/presets.js}

@@ -1,4 +1,4 @@
-//#region src/board/presets.ts
+//#region src/board/model/presets.ts
 const OUT = "cubic-bezier(0.22, 1, 0.36, 1)";
 const IN_OUT = "ease-in-out";
 const PRESETS = {

package/dist/board/{replay.d.ts → model/replay.d.ts}

@@ -1,8 +1,8 @@
-import { BoardDocument } from "../protocol/dist/board-model.js";
-import { RequestSource } from "../protocol/dist/provenance.js";
-import { BoardHistoryPage } from "../protocol/dist/board.js";
-import "../protocol/dist/index.js";
-//#region src/board/replay.d.ts
+import { BoardDocument } from "../../protocol/dist/board-model.js";
+import { RequestSource } from "../../protocol/dist/provenance.js";
+import { BoardHistoryPage } from "../../protocol/dist/board.js";
+import "../../protocol/dist/index.js";
+//#region src/board/model/replay.d.ts
 type BoardReplayActorKind = "human" | "cli" | "agent";
 type BoardReplayEntry = {
   version: number;

package/dist/board/{replay.js → model/replay.js}

@@ -1,5 +1,5 @@
-import { applyBoardDelta } from "../protocol/dist/board-patch.js";
-//#region src/board/replay.ts
+import { applyBoardDelta } from "../../protocol/dist/board-patch.js";
+//#region src/board/model/replay.ts
 function boardReplayActorKind(source) {
 	if (!source) return "human";
 	if (source.toolCallId) return "agent";

package/dist/board/model/sampling.d.ts

@@ -0,0 +1,19 @@
+import { BoardDocument } from "../../protocol/dist/board-model.js";
+import { BoardFrame } from "../../protocol/dist/board-layout.js";
+import "../../protocol/dist/index.js";
+import { BoardViewport, Size } from "./geometry.js";
+import { BoardScene } from "./scene.js";
+import { BoardCameraOverride, BoardEvaluateOptions, BoardEvaluation } from "./animation.js";
+//#region src/board/model/sampling.d.ts
+declare function createBoardAnimationSampler(document: BoardDocument, animation: string | null, options?: BoardEvaluateOptions): {
+  frameAt(id: string, time: number): BoardFrame | undefined;
+  at(time: number): {
+    document: BoardDocument;
+    evaluation: BoardEvaluation;
+    scene: BoardScene;
+  };
+};
+type BoardAnimationSampler = ReturnType<typeof createBoardAnimationSampler>;
+declare function resolveBoardAnimationCamera(override: BoardCameraOverride, bounds: (id: string) => BoardFrame | undefined, surface: Size, time: number, base?: BoardViewport): BoardViewport;
+//#endregion
+export { BoardAnimationSampler, createBoardAnimationSampler, resolveBoardAnimationCamera };

package/dist/board/model/sampling.js

@@ -0,0 +1,96 @@
+import { arrowBindings } from "../../protocol/dist/board-layout.js";
+import { cameraForFocus, cameraForState } from "./geometry.js";
+import { applyBoardEvaluation, boardAnimationTime, compileBoardAnimations, evaluateBoardAnimations } from "./animation.js";
+import { buildBoardScene } from "./scene.js";
+//#region src/board/model/sampling.ts
+function createBoardAnimationSampler(document, animation, options = {}) {
+	const selected = animation ? document.animations[animation] : void 0;
+	if (animation && !selected) throw new Error(`Animation ${animation} does not exist.`);
+	const compiled = compileBoardAnimations(document);
+	const cache = /* @__PURE__ */ new Map();
+	const geometry = /* @__PURE__ */ new Map();
+	function sample(time) {
+		const times = /* @__PURE__ */ new Map();
+		for (const [id, entry] of compiled.animations) if (entry.header.play === "always") times.set(id, boardAnimationTime(entry.header, time) ?? 0);
+		if (animation && selected) times.set(animation, Math.min(time, selected.duration));
+		const evaluation = evaluateBoardAnimations(compiled, times, options);
+		return {
+			document: applyBoardEvaluation(document, evaluation),
+			evaluation
+		};
+	}
+	function stateAt(time) {
+		if (!Number.isFinite(time) || time < 0) throw new Error("Animation time must be finite and non-negative.");
+		let value = cache.get(time);
+		if (!value) {
+			value = sample(time);
+			const oldest = cache.keys().next().value;
+			if (cache.size >= 64 && oldest !== void 0) cache.delete(oldest);
+			cache.set(time, value);
+		}
+		return value;
+	}
+	let current;
+	return {
+		frameAt(id, time) {
+			const key = `${time}:${id}`;
+			if (geometry.has(key)) return geometry.get(key);
+			const sampled = stateAt(time).document;
+			const items = {};
+			const pending = [id];
+			while (pending.length) {
+				const next = pending.pop();
+				if (!next || items[next]) continue;
+				const item = sampled.items[next];
+				if (!item) continue;
+				items[next] = item;
+				if (item.parent) pending.push(item.parent);
+				pending.push(...arrowBindings(item));
+			}
+			const frame = buildBoardScene({
+				...sampled,
+				items
+			}).get(id)?.frame;
+			if (geometry.size >= 2048) geometry.clear();
+			geometry.set(key, frame);
+			return frame;
+		},
+		at(time) {
+			if (current?.time === time) return current.value;
+			const sampled = stateAt(time);
+			const value = {
+				...sampled,
+				scene: buildBoardScene(sampled.document)
+			};
+			current = {
+				time,
+				value
+			};
+			return value;
+		}
+	};
+}
+function resolveBoardAnimationCamera(override, bounds, surface, time, base = {
+	x: 0,
+	y: 0,
+	zoom: 1
+}) {
+	let camera = override.focus === void 0 ? base : cameraForFocus(override.focus, bounds, surface, { padding: 48 }) ?? base;
+	if (override.zoom !== void 0) camera = {
+		...camera,
+		zoom: override.zoom
+	};
+	if (override.center) camera = cameraForState({
+		centerX: override.center.x,
+		centerY: override.center.y,
+		zoom: camera.zoom
+	}, surface);
+	if (override.shake) camera = {
+		...camera,
+		x: camera.x + Math.sin(time / 1e3 * 91.3) * override.shake,
+		y: camera.y + Math.cos(time / 1e3 * 77.9) * override.shake
+	};
+	return camera;
+}
+//#endregion
+export { createBoardAnimationSampler, resolveBoardAnimationCamera };

package/dist/board/{core → model}/scene.d.ts

@@ -1,7 +1,7 @@
 import { BoardDocument, BoardItem } from "../../protocol/dist/board-model.js";
 import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect } from "../../protocol/dist/board-layout.js";
 import "../../protocol/dist/index.js";
-//#region src/board/core/scene.d.ts
+//#region src/board/model/scene.d.ts
 type SceneItem<T extends BoardItem = BoardItem> = T & {
   readonly id: string;
   readonly frame: BoardFrame;

package/dist/board/{core → model}/scene.js

@@ -1,5 +1,5 @@
 import { IDENTITY_MATRIX, applyMatrix, arrowBindings, clampBoardFontSize, createBoardLayout, drawPointsBounds, invertMatrix, layoutBoardText, scaleVector } from "../../protocol/dist/board-layout.js";
-//#region src/board/core/scene.ts
+//#region src/board/model/scene.ts
 const EPSILON = 1e-6;
 function stripScene(item) {
 	if (!("frame" in item) && !("id" in item)) return item;

package/dist/board/model/script-example.d.ts

@@ -0,0 +1,4 @@
+//#region src/board/model/script-example.d.ts
+declare const BOARD_SCRIPT_DRAWING_EXAMPLE = "export const animated = true;\n\nexport const parameters = {\n  amplitude: { type: \"number\", label: \"Amplitude\", default: 40, min: 0, max: 120 }\n};\n\nexport function draw(ctx, { t, width, height, params }) {\n  ctx.strokeStyle = \"#e67845\";\n  ctx.lineWidth = 3;\n  ctx.beginPath();\n  for (let x = 0; x <= width; x += 2) {\n    const y = height / 2 + Math.sin(x / 40 - t / 800) * params.amplitude;\n    if (x === 0) ctx.moveTo(x, y);\n    else ctx.lineTo(x, y);\n  }\n  ctx.stroke();\n}\n";
+//#endregion
+export { BOARD_SCRIPT_DRAWING_EXAMPLE };

package/dist/board/model/script-example.js

@@ -0,0 +1,21 @@
+//#region src/board/model/script-example.ts
+const BOARD_SCRIPT_DRAWING_EXAMPLE = `export const animated = true;
+
+export const parameters = {
+  amplitude: { type: "number", label: "Amplitude", default: 40, min: 0, max: 120 }
+};
+
+export function draw(ctx, { t, width, height, params }) {
+  ctx.strokeStyle = "#e67845";
+  ctx.lineWidth = 3;
+  ctx.beginPath();
+  for (let x = 0; x <= width; x += 2) {
+    const y = height / 2 + Math.sin(x / 40 - t / 800) * params.amplitude;
+    if (x === 0) ctx.moveTo(x, y);
+    else ctx.lineTo(x, y);
+  }
+  ctx.stroke();
+}
+`;
+//#endregion
+export { BOARD_SCRIPT_DRAWING_EXAMPLE };

package/dist/board/model/script-hit.d.ts

@@ -0,0 +1,10 @@
+import { BoardScriptOutput } from "./script.js";
+import { WorldPoint } from "./geometry.js";
+import { BoardScene, BoardSceneItem } from "./scene.js";
+//#region src/board/model/script-hit.d.ts
+declare function boardScriptTarget(scene: BoardScene, candidates: readonly string[], point: WorldPoint, outputs: ReadonlyMap<string, BoardScriptOutput>, hitTest: (item: BoardSceneItem, point: WorldPoint) => boolean): {
+  owner: string;
+  target: string;
+} | null;
+//#endregion
+export { boardScriptTarget };

package/dist/board/model/script-hit.js

@@ -0,0 +1,52 @@
+import { applyMatrix, invertMatrix } from "../../protocol/dist/board-layout.js";
+import { frameContainsPoint } from "./geometry.js";
+import { scriptTemporaryPrefix } from "./script-scene.js";
+//#region src/board/model/script-hit.ts
+function boardScriptTarget(scene, candidates, point, outputs, hitTest) {
+	const owners = new Map([...outputs.keys()].map((id) => [scriptTemporaryPrefix(id), id]));
+	for (const id of [...candidates].sort((a, b) => scene.indexOf(b) - scene.indexOf(a))) {
+		const item = scene.get(id);
+		if (!item || scene.opacity(id) <= 0 || id.endsWith("root") && owners.has(id.slice(0, -4))) continue;
+		let parent = item.parent;
+		let clipped = false;
+		for (let depth = 0; parent && depth < 64; depth++) {
+			const ancestor = scene.get(parent);
+			if (!ancestor) break;
+			if (ancestor.type === "frame" && ancestor.props.clip && !frameContainsPoint(ancestor.frame, point)) {
+				clipped = true;
+				break;
+			}
+			parent = ancestor.parent;
+		}
+		if (clipped) continue;
+		const output = outputs.get(id);
+		if (output) {
+			const local = applyMatrix(invertMatrix(scene.layout.matrix(id)), point);
+			for (const [target, region] of Object.entries(output.hits).reverse()) if (local.x >= region.x && local.y >= region.y && local.x <= region.x + region.width && local.y <= region.y + region.height) return {
+				owner: id,
+				target
+			};
+		}
+		if (!hitTest(item, point)) continue;
+		let current = item;
+		for (let depth = 0; current && depth < 64; depth++) {
+			if (outputs.has(current.id)) return {
+				owner: current.id,
+				target: id
+			};
+			for (const [prefix, owner] of owners) {
+				if (current.id === `${prefix}root`) break;
+				if (current.id.startsWith(prefix)) return {
+					owner,
+					target: current.id.slice(prefix.length)
+				};
+			}
+			current = current.parent ? scene.get(current.parent) : void 0;
+		}
+		if (item.type === "frame" && item.props.decoration === "none") continue;
+		return null;
+	}
+	return null;
+}
+//#endregion
+export { boardScriptTarget };

package/dist/board/model/script-index.d.ts

@@ -0,0 +1,7 @@
+import { BoardDocument, BoardItem } from "../../protocol/dist/board-model.js";
+import "../../protocol/dist/index.js";
+//#region src/board/model/script-index.d.ts
+declare function boardScriptItems(document: Pick<BoardDocument, "items">): readonly (readonly [string, BoardItem])[];
+declare function hasBoardScripts(document: Pick<BoardDocument, "items">): boolean;
+//#endregion
+export { boardScriptItems, hasBoardScripts };

package/dist/board/model/script-index.js

@@ -0,0 +1,15 @@
+//#region src/board/model/script-index.ts
+const scriptsByItems = /* @__PURE__ */ new WeakMap();
+function boardScriptItems(document) {
+	let scripts = scriptsByItems.get(document.items);
+	if (!scripts) {
+		scripts = Object.entries(document.items).filter(([, item]) => item.script?.enabled);
+		scriptsByItems.set(document.items, scripts);
+	}
+	return scripts;
+}
+function hasBoardScripts(document) {
+	return boardScriptItems(document).length > 0;
+}
+//#endregion
+export { boardScriptItems, hasBoardScripts };

package/dist/board/model/script-scene.d.ts

@@ -0,0 +1,24 @@
+import { BoardDocument, BoardItem, BoardPatch } from "../../protocol/dist/board-model.js";
+import { BoardScriptOutput } from "./script.js";
+import { BoardScene } from "./scene.js";
+//#region src/board/model/script-scene.d.ts
+declare function boardScriptScope(document: Pick<BoardDocument, "items">, id: string): Set<string>;
+declare function validateBoardScriptOutput(output: BoardScriptOutput, scope: ReadonlySet<string>): void;
+declare function validateBoardScriptCommit(document: BoardDocument, id: string, patch: BoardPatch): void;
+declare function scriptTemporaryPrefix(owner: string): string;
+type PreparedOutput = {
+  document: BoardDocument;
+  owner: string;
+  rootId: string;
+  items: Map<string, BoardItem>;
+  presented: Map<string, {
+    base: BoardItem;
+    item: BoardItem;
+  }>;
+};
+declare function prepareBoardScriptOutput(document: BoardDocument, owner: string, output: BoardScriptOutput): PreparedOutput;
+declare function composeBoardScriptItems(document: BoardDocument, scene: BoardScene, outputs: ReadonlyMap<string, BoardScriptOutput>, incoming?: ReadonlyMap<string, BoardItem>, screen?: {
+  zoom: number;
+}, onError?: (owner: string, error: unknown) => void): Map<string, BoardItem>;
+//#endregion
+export { boardScriptScope, composeBoardScriptItems, prepareBoardScriptOutput, scriptTemporaryPrefix, validateBoardScriptCommit, validateBoardScriptOutput };