@neta-art/cohub 9.0.1 → 11.0.0

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

@@ -1,6 +1,6 @@
 import { BOARD_CAMERA_TARGET, BoardAnimationHeaderSchema, BoardColorSchema, BoardPatchSchema, BoardSettingsSchema, BoardTrackSchema, BoardVec2Schema, boardItemSchema, isBuiltinItemType, parseBoardItem } from "./board-model.js";
-import { boardJsonEquals } from "./board-json.js";
 import { applyMatrix, arrowBindings, createBoardLayout, invertMatrix, isArrowBinding } from "./board-layout.js";
+import { boardJsonEquals } from "./board-json.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-patch.js
 function slot(map, key) {
@@ -82,7 +82,8 @@ const NOT_ANIMATABLE = /* @__PURE__ */ new Set([
 	"parent",
 	"z",
 	"locked",
-	"metadata"
+	"metadata",
+	"script"
 ]);
 const CAMERA_PROPERTIES = {
 	focus: {

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

@@ -1,6 +1,6 @@
 //#region ../protocol/dist/board-schema.d.ts
 type JsonSchema = Record<string, unknown>;
-declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[]];
+declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[]];
 type BoardJsonSchemaResult = {
   schema?: JsonSchema;
   properties?: Array<{
@@ -11,6 +11,7 @@ type BoardJsonSchemaResult = {
     description: string;
     parameters: Record<string, string>;
   }>;
+  semantics?: Record<string, string>;
 };
 declare function boardJsonSchema(target: string): BoardJsonSchemaResult | null;
 declare function boardSchemaOverview(): {
@@ -19,7 +20,8 @@ declare function boardSchemaOverview(): {
     rotation: string;
     length: string;
   };
-  types: ("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[];
+  coordinates: string;
+  types: ("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[];
   colors: {
     tokens: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
     css: string;

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

@@ -1,4 +1,4 @@
-import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
+import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardKeySchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
 import { listBoardProperties } from "./board-patch.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-schema.js
@@ -19,13 +19,26 @@ const BOARD_SCHEMA_TARGETS = [
 function boardJsonSchema(target) {
 	if (target === "board") return { schema: toJsonSchema(BoardSettingsSchema) };
 	if (target === "animation") return {
-		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(z.string(), BoardTrackSchema).optional() })),
-		properties: listBoardProperties("animation")
+		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardKeySchema, BoardTrackSchema).optional() })),
+		properties: listBoardProperties("animation"),
+		semantics: { composition: "Target another animation's time property to drive its local clock. Parent markers control pauses; child markers are not automatically promoted." }
+	};
+	if (target === "track") return {
+		schema: toJsonSchema(BoardTrackSchema),
+		semantics: {
+			boundary: "Before the first keyframe and after the last, the value is held. Use opacity tracks to control visibility.",
+			easing: "Defaults to linear. The destination keyframe controls the incoming segment. Supports CSS easing keywords, cubic-bezier() and steps().",
+			composition: "replace: the most recently started track wins; ties use the lexicographically larger track ID. Before any start, the nearest upcoming track wins. add: numbers and positions add; opacity and scale multiply.",
+			interpolation: "auto interpolates numbers, colors and vectors; other values step. spline smooths vector motion. orient follows the position tangent."
+		}
 	};
-	if (target === "track") return { schema: toJsonSchema(BoardTrackSchema) };
 	if (target === "effect") return {
 		schema: toJsonSchema(BOARD_ITEM_SCHEMAS.effect),
 		properties: listBoardProperties("effect"),
+		semantics: {
+			follow: "follow is used by trail only. Parent a particle effect to a decoration:none frame to move it with other items.",
+			time: "Effects use animation time in milliseconds. trail samples target history; seed makes procedural particles repeatable."
+		},
 		kinds: Object.fromEntries(BOARD_EFFECT_KINDS.map((kind) => [kind, BOARD_EFFECT_KIND_INFO[kind]]))
 	};
 	if (target === "camera") return { properties: listBoardProperties(BOARD_CAMERA_TARGET) };
@@ -42,6 +55,7 @@ function boardSchemaOverview() {
 			rotation: "degrees",
 			length: "board units (1 = 1 CSS px at zoom 1)"
 		},
+		coordinates: "Positions, draw points and unbound arrow endpoints are relative to their parent frame; without a parent they are world coordinates. Shape paths are fitted to the item size.",
 		types: BOARD_ITEM_TYPES,
 		colors: {
 			tokens: BOARD_COLOR_TOKENS,

package/dist/protocol/dist/board-script-modules.d.ts

@@ -0,0 +1,25 @@
+//#region ../protocol/dist/board-script-modules.d.ts
+declare const BOARD_SCRIPT_MAX_BYTES = 2000000;
+type BoardScriptSource = {
+  code: string;
+  imports: Array<{
+    start: number;
+    end: number;
+    path: string;
+    dynamic: boolean;
+  }>;
+};
+type BoardScriptSources = Record<string, BoardScriptSource>;
+declare function createBoardScriptModuleReader(read: (path: string) => Promise<string>, timeoutMs?: number): {
+  read(path: string): Promise<string>;
+  invalidate(path?: string): void;
+  destroy(): void;
+};
+declare function resolveScriptImport(from: string, specifier: string): string;
+declare function loadBoardScriptSources(src: string, read: (path: string) => Promise<string>, timeoutMs?: number): Promise<BoardScriptSources>;
+declare function scriptModuleUrls(sources: BoardScriptSources): {
+  urls: Record<string, string>;
+  dispose(): void;
+};
+//#endregion
+export { BOARD_SCRIPT_MAX_BYTES, BoardScriptSource, BoardScriptSources, createBoardScriptModuleReader, loadBoardScriptSources, resolveScriptImport, scriptModuleUrls };

package/dist/protocol/dist/board-script-modules.js

@@ -0,0 +1,127 @@
+import { isSafeBoardSourcePath } from "./board-model.js";
+//#region ../protocol/dist/board-script-modules.js
+const BOARD_SCRIPT_MAX_BYTES = 2e6;
+function createBoardScriptModuleReader(read, timeoutMs = 15e3) {
+	const cache = /* @__PURE__ */ new Map();
+	const queue = [];
+	let active = 0;
+	let disposed = false;
+	function pump() {
+		while (active < 4 && queue.length) queue.shift()?.();
+	}
+	return {
+		read(path) {
+			if (disposed) return Promise.reject(/* @__PURE__ */ new Error("Module reader is disposed."));
+			const cached = cache.get(path);
+			if (cached) return cached;
+			const promise = new Promise((resolve, reject) => {
+				queue.push(() => {
+					if (disposed) {
+						reject(/* @__PURE__ */ new Error("Module reader is disposed."));
+						return;
+					}
+					active++;
+					let timer;
+					const timeout = new Promise((_resolve, rejectRead) => {
+						timer = setTimeout(() => rejectRead(/* @__PURE__ */ new Error(`Module read timed out: ${path}`)), timeoutMs);
+					});
+					Promise.race([Promise.resolve().then(() => read(path)), timeout]).then(resolve, reject).finally(() => {
+						clearTimeout(timer);
+						active--;
+						pump();
+					});
+				});
+				pump();
+			});
+			cache.set(path, promise);
+			promise.catch(() => {
+				if (cache.get(path) === promise) cache.delete(path);
+			});
+			return promise;
+		},
+		invalidate(path) {
+			if (path) cache.delete(path);
+			else cache.clear();
+		},
+		destroy() {
+			disposed = true;
+			cache.clear();
+			for (const job of queue.splice(0)) job();
+		}
+	};
+}
+function resolveScriptImport(from, specifier) {
+	if (!specifier.startsWith("./") && !specifier.startsWith("../")) throw new Error(`Only relative module imports are supported: ${specifier}`);
+	const parts = from.split("/").slice(0, -1);
+	for (const part of specifier.split("/")) {
+		if (part === ".") continue;
+		if (part === "..") {
+			if (!parts.length) throw new Error("Module import leaves the Space.");
+			parts.pop();
+		} else parts.push(part);
+	}
+	const path = parts.join("/");
+	if (!isSafeBoardSourcePath(path) || !/\.m?js$/.test(path)) throw new Error(`Invalid module path: ${path}`);
+	return path;
+}
+async function loadBoardScriptSources(src, read, timeoutMs = 15e3) {
+	if (!isSafeBoardSourcePath(src) || !/\.m?js$/.test(src)) throw new Error("Invalid script entry path.");
+	const { init, parse } = await import("es-module-lexer");
+	await init;
+	const sources = {};
+	const visiting = /* @__PURE__ */ new Set();
+	let bytes = 0;
+	async function visit(path) {
+		if (visiting.has(path)) throw new Error(`Circular module dependency: ${path}`);
+		if (sources[path]) return;
+		if (Object.keys(sources).length + visiting.size >= 64) throw new Error("A script may load at most 64 modules.");
+		visiting.add(path);
+		let timer;
+		const code = await Promise.race([Promise.resolve().then(() => read(path)), new Promise((_resolve, reject) => {
+			timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`Module read timed out: ${path}`)), timeoutMs);
+		})]).finally(() => clearTimeout(timer));
+		bytes += new TextEncoder().encode(code).byteLength;
+		if (bytes > 2e6) throw new Error("Script modules exceed the 2 MB limit.");
+		const [imports] = parse(code, path);
+		const resolved = [];
+		for (const entry of imports) {
+			if (entry.d === -2) throw new Error("import.meta is not available in Board scripts.");
+			if (entry.n === void 0) throw new Error("Dynamic imports must use a literal relative path.");
+			const dependency = resolveScriptImport(path, entry.n);
+			await visit(dependency);
+			resolved.push({
+				start: entry.s,
+				end: entry.e,
+				path: dependency,
+				dynamic: entry.d >= 0
+			});
+		}
+		sources[path] = {
+			code,
+			imports: resolved
+		};
+		visiting.delete(path);
+	}
+	await visit(src);
+	return sources;
+}
+function scriptModuleUrls(sources) {
+	const urls = {};
+	for (const [path, source] of Object.entries(sources)) {
+		let code = source.code;
+		for (const entry of [...source.imports].reverse()) {
+			const url = urls[entry.path];
+			if (!url) throw new Error(`Unresolved module: ${entry.path}`);
+			code = code.slice(0, entry.start) + (entry.dynamic ? JSON.stringify(url) : url) + code.slice(entry.end);
+		}
+		urls[path] = URL.createObjectURL(new Blob([`${code}\n//# sourceURL=cohub-script/${path.split("/").map(encodeURIComponent).join("/")}`], { type: "text/javascript" }));
+	}
+	return {
+		urls,
+		dispose: () => {
+			for (const url of Object.values(urls)) URL.revokeObjectURL(url);
+		}
+	};
+}
+//#endregion
+export { BOARD_SCRIPT_MAX_BYTES, createBoardScriptModuleReader, loadBoardScriptSources, resolveScriptImport, scriptModuleUrls };

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

@@ -1,7 +1,9 @@
-import { BoardDelta, BoardPatch } from "./board-model.js";
+import { BoardDelta, BoardDiagnostic, BoardPatch } from "./board-model.js";
 import { RequestSource } from "./provenance.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.d.ts
+declare const BOARD_CLIPBOARD_KIND: "cohub.board.clipboard";
+declare const BOARD_CLIPBOARD_MIME: "application/x-cohub-board";
 declare const BoardManifestSchema: z.ZodObject<{
   kind: z.ZodLiteral<"cohub.board.manifest">;
   version: z.ZodLiteral<1>;
@@ -12,6 +14,30 @@ type BoardManifest = z.infer<typeof BoardManifestSchema>;
 declare function parseBoardManifest(input: string | unknown): BoardManifest;
 declare function serializeBoardManifest(manifest: BoardManifest): string;
 declare function isBoardPath(path: string): boolean;
+type BoardReadResult = {
+  id: string;
+  title: string;
+  version: number;
+  updatedAt: string | null;
+  board: Record<string, unknown>;
+  items?: Record<string, Record<string, unknown>>;
+  animations?: Record<string, Record<string, unknown>>;
+  playback: BoardPlaybackSnapshot | null;
+  next?: string;
+};
+type BoardChangeSummary = {
+  board: boolean;
+  items: string[];
+  animations: string[];
+};
+type BoardApplyResult = {
+  mutationId: string;
+  status: "applied" | "unchanged" | "validated";
+  replayed: boolean;
+  version: number;
+  changed: BoardChangeSummary;
+  diagnostics: BoardDiagnostic[];
+};
 type BoardTransactionRecord = {
   id: string;
   mutationId: string;
@@ -68,4 +94,4 @@ declare const BoardPlaybackCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strict>], "type">;
 type BoardPlaybackCommand = z.infer<typeof BoardPlaybackCommandSchema>;
 //#endregion
-export { BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardManifestSchema, type BoardPatch, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardReadResult, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/board.js

@@ -3,6 +3,8 @@ import { z } from "zod";
 //#region ../protocol/dist/board.js
 const BOARD_EXTENSION = ".board";
 const BOARD_MANIFEST_KIND = "cohub.board.manifest";
+const BOARD_CLIPBOARD_KIND = "cohub.board.clipboard";
+const BOARD_CLIPBOARD_MIME = "application/x-cohub-board";
 const BoardManifestSchema = z.object({
 	kind: z.literal(BOARD_MANIFEST_KIND),
 	version: z.literal(1),
@@ -104,4 +106,4 @@ z.discriminatedUnion("type", [
 	}).strict()
 ]);
 //#endregion
-export { BOARD_EXTENSION, BOARD_MANIFEST_KIND, BOARD_READ_SECTIONS, BoardManifestSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BOARD_READ_SECTIONS, BoardManifestSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/core/media.d.ts

@@ -0,0 +1,5 @@
+//#region ../protocol/dist/core/media.d.ts
+/** Append an OSS process to `url`, keeping its query and hash. */
+declare function ossProcessUrl(url: string, process: string): string;
+//#endregion
+export { ossProcessUrl };

package/dist/protocol/dist/core/media.js

@@ -0,0 +1,39 @@
+//#region ../protocol/dist/core/media.js
+const MEDIA_HOSTS = /* @__PURE__ */ new Map([
+	["router-files.neta.art", {
+		transform: "oss",
+		metaHeaders: true
+	}],
+	["public.cohub.live", { transform: "oss" }],
+	["cca.neta.art", { transform: "cloudflare" }]
+]);
+const parseHttpsUrl = (url) => {
+	if (!/^https:\/\//i.test(url)) return null;
+	try {
+		return new URL(url);
+	} catch {
+		return null;
+	}
+};
+function mediaHost(url) {
+	const parsed = parseHttpsUrl(url);
+	return parsed ? MEDIA_HOSTS.get(parsed.hostname) : void 0;
+}
+const OSS_PROCESS_PATTERN = /[?&]x-oss-process=/;
+/** Append an OSS process to `url`, keeping its query and hash. */
+function ossProcessUrl(url, process) {
+	if (/^(data|blob):/i.test(url) || OSS_PROCESS_PATTERN.test(url)) return url;
+	const hashIndex = url.indexOf("#");
+	const base = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
+	const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";
+	return `${base}${base.includes("?") ? "&" : "?"}x-oss-process=${process}${hash}`;
+}
+const MODEL_IMAGE = {
+	maxEdge: 1280,
+	quality: 75
+};
+const { maxEdge, quality } = MODEL_IMAGE;
+`${maxEdge}${maxEdge}${quality}`;
+`${maxEdge}${maxEdge}${quality}`;
+//#endregion
+export { MODEL_IMAGE, OSS_PROCESS_PATTERN, mediaHost, ossProcessUrl };

package/dist/protocol/dist/display/index.d.ts

@@ -1,2 +1,3 @@
 import "./actions.js";
+import "../rtc/index.js";
 import { z } from "zod";

package/dist/protocol/dist/index.d.ts

@@ -1,14 +1,16 @@
+import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "./board-model.js";
+import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextLayout, BoardTextMeasurer, IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor } from "./board-layout.js";
+import { BoardApplyOptions, BoardPatchResult, BoardPropertySpec, BoardState, BoardValueKind, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "./board-patch.js";
 import "./app-authorization.js";
-import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardSketchItem, BoardSketchItemSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem } from "./board-model.js";
 import { RequestSource, RequestSourceVia } from "./provenance.js";
-import { BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardReadResult, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
 import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } from "./board-constants.js";
 import "./board-content.js";
-import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextLayout, BoardTextMeasurer, IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor } from "./board-layout.js";
-import { BoardApplyOptions, BoardPatchResult, BoardPropertySpec, BoardState, BoardValueKind, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "./board-patch.js";
+import "./board-assets.js";
 import { BOARD_SCHEMA_TARGETS, BoardJsonSchemaResult, boardJsonSchema, boardSchemaOverview } from "./board-schema.js";
 import "./board-upgrade.js";
 import { isPublicBoardRemoteAddress, normalizeBoardRemoteUrl } from "./board-url.js";
+import "./rtc/index.js";
 import "./display/index.js";
 import "./runtime/index.js";
 import "./model/turn.js";
@@ -18,4 +20,4 @@ import "./app.js";
 import "./realtime/types.js";
 import "./app-catalog.js";
 import "./host-bridge.js";
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardRect, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardSketchItem, BoardSketchItemSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, IDENTITY_MATRIX, RequestSource, RequestSourceVia, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, pointsRect, pruneBoardTrack, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, trackReferences };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, IDENTITY_MATRIX, RequestSource, RequestSourceVia, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, trackReferences };

package/dist/protocol/dist/realtime/types.d.ts

@@ -1,5 +1,6 @@
 import "../board-model.js";
 import "../board.js";
+import "../rtc/index.js";
 import "../model/turn.js";
 import "../model/metrics.js";
 import "../model/session.js";

package/dist/protocol/dist/rtc/index.d.ts

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

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { BoardAnimation, BoardAnimationHeader, BoardColor, BoardDelta, BoardDiagnostic, BoardDocument, BoardItem, BoardKeyframe, BoardMarker, BoardPatch, BoardSettings, BoardStyle, BoardTrack } from "./protocol/dist/board-model.js";
-import { BoardHistoryPage, BoardManifest, BoardPlaybackCommand, BoardPlaybackSnapshot, BoardTransactionRecord } from "./protocol/dist/board.js";
+import { BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardPlaybackCommand, BoardPlaybackSnapshot, BoardReadResult, BoardTransactionRecord } from "./protocol/dist/board.js";
 import "./protocol/dist/model/session.js";
 import "./protocol/dist/index.js";
 //#region src/types.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "9.0.1",
+  "version": "11.0.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
@@ -58,24 +58,36 @@
       "import": "./dist/media.js"
     },
     "./board": {
-      "types": "./dist/board/index.d.ts",
-      "import": "./dist/board/index.js"
+      "types": "./dist/board/model/index.d.ts",
+      "import": "./dist/board/model/index.js"
+    },
+    "./board/editor": {
+      "types": "./dist/board/editor/index.d.ts",
+      "import": "./dist/board/editor/index.js"
+    },
+    "./board/replica": {
+      "types": "./dist/board/replica/index.d.ts",
+      "import": "./dist/board/replica/index.js"
     },
     "./board/player": {
-      "types": "./dist/board/runtime/board-player.d.ts",
-      "import": "./dist/board/runtime/board-player.js"
+      "types": "./dist/board/player/index.d.ts",
+      "import": "./dist/board/player/index.js"
     },
     "./board/render": {
       "types": "./dist/board/render/index.d.ts",
       "import": "./dist/board/render/index.js"
     },
+    "./board/stage": {
+      "types": "./dist/board/stage/index.d.ts",
+      "import": "./dist/board/stage/index.js"
+    },
     "./board/export": {
       "types": "./dist/board/export/index.d.ts",
       "import": "./dist/board/export/index.js"
     },
-    "./board/headless": {
-      "types": "./dist/board/headless/index.d.ts",
-      "import": "./dist/board/headless/index.js"
+    "./board/export/node": {
+      "types": "./dist/board/export/node/index.d.ts",
+      "import": "./dist/board/export/node/index.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -86,6 +98,7 @@
     "NOTICE"
   ],
   "dependencies": {
+    "es-module-lexer": "2.3.2",
     "perfect-freehand": "1.2.3",
     "zod": "^4.6.5"
   },

package/dist/board/core/shape-definition.d.ts

@@ -1,23 +0,0 @@
-import { Rect, WorldPoint } from "../geometry.js";
-import { BoardSceneItem } from "./scene.js";
-import { ShapeCapabilities, ShapeGeometry, ShapeHandle, ShapeResizeMode } from "./shape-types.js";
-//#region src/board/core/shape-definition.d.ts
-type ShapeDefinition = {
-  type: string;
-  capabilities: ShapeCapabilities;
-  getBounds?: (item: BoardSceneItem) => Rect;
-  hitTest?: (item: BoardSceneItem, point: WorldPoint) => boolean;
-  getHandles?: (item: BoardSceneItem) => ShapeHandle[];
-  getGeometry?: (item: BoardSceneItem) => ShapeGeometry;
-};
-declare function registerShapeDefinition(definition: ShapeDefinition): void;
-declare function getShapeDefinition(type: string): ShapeDefinition | undefined;
-declare const unknownShapeDefinition: ShapeDefinition;
-declare function definitionForItem(item: BoardSceneItem): ShapeDefinition;
-declare function shapeBounds(item: BoardSceneItem): Rect;
-declare function shapeHitTest(item: BoardSceneItem, point: WorldPoint): boolean;
-declare function shapeHandles(item: BoardSceneItem): ShapeHandle[];
-declare function shapeCapabilities(item: BoardSceneItem): ShapeCapabilities;
-declare function shapeResizeMode(item: BoardSceneItem): ShapeResizeMode;
-//#endregion
-export { ShapeDefinition, definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition };

package/dist/board/core/shape-definition.js

@@ -1,45 +0,0 @@
-import { frameContainsPoint, itemBounds } from "../geometry.js";
-import { resizeModeForCapabilities } from "./shape-types.js";
-//#region src/board/core/shape-definition.ts
-const definitions = /* @__PURE__ */ new Map();
-function registerShapeDefinition(definition) {
-	definitions.set(definition.type, definition);
-}
-function getShapeDefinition(type) {
-	return definitions.get(type);
-}
-const unknownShapeDefinition = {
-	type: "__unknown__",
-	capabilities: {
-		canMove: true,
-		canResize: true,
-		aspectLocked: false,
-		canRotate: true,
-		canEdit: false,
-		canConnect: true,
-		canSnap: true,
-		canLock: true
-	}
-};
-function definitionForItem(item) {
-	return definitions.get(item.type) ?? unknownShapeDefinition;
-}
-function shapeBounds(item) {
-	return definitionForItem(item).getBounds?.(item) ?? itemBounds(item.frame);
-}
-function shapeHitTest(item, point) {
-	const definition = definitionForItem(item);
-	if (definition.hitTest) return definition.hitTest(item, point);
-	return frameContainsPoint(item.frame, point);
-}
-function shapeHandles(item) {
-	return definitionForItem(item).getHandles?.(item) ?? [];
-}
-function shapeCapabilities(item) {
-	return definitionForItem(item).capabilities;
-}
-function shapeResizeMode(item) {
-	return resizeModeForCapabilities(shapeCapabilities(item));
-}
-//#endregion
-export { definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition };

package/dist/board/core/shape-types.d.ts

@@ -1,38 +0,0 @@
-import { BoardShapeGeometry } from "../../protocol/dist/board-model.js";
-import { BoardFrame } from "../../protocol/dist/board-layout.js";
-import "../../protocol/dist/index.js";
-import { Rect, WorldPoint } from "../geometry.js";
-//#region src/board/core/shape-types.d.ts
-type ShapeGeometry = {
-  bounds: Rect;
-  containsWorldPoint?: (frame: BoardFrame, point: WorldPoint) => boolean;
-};
-type ShapeHandleId = string;
-type ShapeHandle = {
-  id: ShapeHandleId;
-  x: number;
-  y: number;
-  radius?: number;
-};
-type HandleDragResult = {
-  frame?: BoardFrame;
-  props?: Record<string, unknown>;
-};
-type ShapeCapabilities = {
-  canMove: boolean;
-  canResize: boolean;
-  aspectLocked: boolean;
-  canRotate: boolean;
-  canEdit: boolean;
-  canConnect: boolean;
-  canSnap: boolean;
-  canLock: boolean;
-};
-type ShapeResizeMode = "none" | "uniform" | "free";
-declare function resizeModeForCapabilities(capabilities: ShapeCapabilities): ShapeResizeMode;
-declare const FULL_CAPABILITIES: ShapeCapabilities;
-type ShapeKind = Exclude<BoardShapeGeometry, "path">;
-declare const SHAPE_KINDS: ShapeKind[];
-declare function isShapeKind(value: unknown): value is ShapeKind;
-//#endregion
-export { FULL_CAPABILITIES, HandleDragResult, SHAPE_KINDS, ShapeCapabilities, ShapeGeometry, ShapeHandle, ShapeHandleId, ShapeKind, ShapeResizeMode, isShapeKind, resizeModeForCapabilities };

package/dist/board/core/shape-types.js

@@ -1,22 +0,0 @@
-import { BOARD_SHAPE_GEOMETRIES } from "../../protocol/dist/board-model.js";
-//#region src/board/core/shape-types.ts
-function resizeModeForCapabilities(capabilities) {
-	if (!capabilities.canResize) return "none";
-	return capabilities.aspectLocked ? "uniform" : "free";
-}
-const FULL_CAPABILITIES = {
-	canMove: true,
-	canResize: true,
-	aspectLocked: false,
-	canRotate: true,
-	canEdit: false,
-	canConnect: true,
-	canSnap: true,
-	canLock: true
-};
-const SHAPE_KINDS = BOARD_SHAPE_GEOMETRIES.filter((kind) => kind !== "path");
-function isShapeKind(value) {
-	return typeof value === "string" && SHAPE_KINDS.includes(value);
-}
-//#endregion
-export { FULL_CAPABILITIES, SHAPE_KINDS, isShapeKind, resizeModeForCapabilities };