@neta-art/cohub 8.10.2 → 8.12.0

package/dist/board/core/file-snapshot.js

@@ -0,0 +1,503 @@
+//#region src/board/core/file-snapshot.ts
+/**
+* File-card snapshot derivation — pure, renderer-agnostic, dependency-free.
+*
+* Whoever holds the file content calls `buildFileSnapshot`; today that is the
+* web client, for cards near its viewport. Nothing here ever writes back to the
+* workspace file. The file on disk stays the single source of truth, and the
+* snapshot is a cache keyed by mtime so a stale card is detectable.
+*/
+/** Hard cap on a stored excerpt. Board cards show a few lines at most. */
+const FILE_EXCERPT_MAX_CHARS = 480;
+/** Files above this size are shown as `blank`; we never pull them for a preview. */
+const FILE_EXCERPT_MAX_BYTES = 262144;
+const TITLE_KEYS = [
+	"title",
+	"name",
+	"label",
+	"heading"
+];
+const COVER_KEYS = [
+	"cover",
+	"coverImage",
+	"cover_image",
+	"image",
+	"banner",
+	"thumbnail",
+	"ogImage",
+	"og:image",
+	"hero",
+	"poster",
+	"featured_image",
+	"header_image",
+	"icon",
+	"avatar"
+];
+const COVER_FALLBACK_KEYS = /* @__PURE__ */ new Set(["icon", "avatar"]);
+const NESTED_COVER_KEYS = [
+	"src",
+	"url",
+	"path"
+];
+const DESCRIPTION_KEYS = [
+	"description",
+	"summary",
+	"abstract"
+];
+const DOC_EXTENSIONS = /* @__PURE__ */ new Set([
+	"md",
+	"mdx",
+	"markdown",
+	"txt",
+	"rst",
+	"adoc",
+	"org"
+]);
+const DATA_EXTENSIONS = /* @__PURE__ */ new Set([
+	"json",
+	"jsonc",
+	"jsonl",
+	"yaml",
+	"yml",
+	"toml",
+	"csv",
+	"tsv",
+	"xml",
+	"ndjson"
+]);
+const CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+	"ts",
+	"tsx",
+	"js",
+	"jsx",
+	"mjs",
+	"cjs",
+	"py",
+	"go",
+	"rs",
+	"java",
+	"kt",
+	"swift",
+	"rb",
+	"php",
+	"c",
+	"h",
+	"hh",
+	"hpp",
+	"cpp",
+	"cc",
+	"cs",
+	"scala",
+	"lua",
+	"sh",
+	"bash",
+	"zsh",
+	"fish",
+	"vue",
+	"svelte",
+	"css",
+	"scss",
+	"less",
+	"html",
+	"htm",
+	"sql",
+	"graphql",
+	"proto",
+	"zig",
+	"dart",
+	"r"
+]);
+const MEDIA_EXTENSIONS = /* @__PURE__ */ new Set([
+	"png",
+	"jpg",
+	"jpeg",
+	"gif",
+	"webp",
+	"avif",
+	"svg",
+	"bmp",
+	"ico",
+	"mp4",
+	"webm",
+	"mov",
+	"m4v",
+	"mp3",
+	"wav",
+	"ogg",
+	"m4a",
+	"flac",
+	"aac",
+	"pdf",
+	"zip",
+	"gz",
+	"tgz"
+]);
+const IMAGE_REF_RE = /\.(png|jpe?g|gif|webp|avif|svg|bmp|ico)(\?|#|$)/i;
+function extensionOf(path) {
+	const name = path.split("/").filter(Boolean).pop() ?? path;
+	const dot = name.lastIndexOf(".");
+	if (dot <= 0) return "";
+	return name.slice(dot + 1).toLowerCase();
+}
+function normalizeMime(mimeType) {
+	if (!mimeType) return "";
+	return mimeType.split(";")[0]?.trim().toLowerCase() ?? "";
+}
+/** Classify a file so excerpt, title and colour can vary without a second source of truth. */
+function fileCategory(path, mimeType) {
+	const mime = normalizeMime(mimeType);
+	if (mime) {
+		if (mime === "text/markdown" || mime === "text/x-markdown" || mime === "text/plain" || mime === "text/x-rst") return "doc";
+		if (mime === "application/json" || mime === "application/yaml" || mime === "application/x-yaml" || mime === "application/toml" || mime === "application/csv" || mime === "application/xml" || mime === "text/csv" || mime === "text/xml" || mime === "text/yaml" || mime === "application/x-ndjson") return "data";
+		if (mime.startsWith("image/") || mime.startsWith("video/") || mime.startsWith("audio/") || mime === "application/pdf" || mime === "application/zip" || mime === "application/gzip") return "media";
+		if (mime.startsWith("text/x-") || mime === "application/javascript" || mime === "application/typescript" || mime === "text/javascript" || mime === "text/css" || mime === "text/html" || mime === "application/sql") return "code";
+	}
+	const ext = extensionOf(path);
+	if (DOC_EXTENSIONS.has(ext)) return "doc";
+	if (DATA_EXTENSIONS.has(ext)) return "data";
+	if (CODE_EXTENSIONS.has(ext)) return "code";
+	if (MEDIA_EXTENSIONS.has(ext)) return "media";
+	if (mime.startsWith("text/")) return "doc";
+	return "other";
+}
+/** Basename of a path, used as a last-resort card title. */
+function fileBaseName(path) {
+	return path.split("/").filter(Boolean).pop() ?? path;
+}
+/** Basename with a trailing extension stripped. Dotfiles keep their full name. */
+function fileStem(path) {
+	const name = fileBaseName(path);
+	const dot = name.lastIndexOf(".");
+	if (dot <= 0) return name;
+	return name.slice(0, dot);
+}
+/** Normalise a space-relative path: resolve `.`/`..` against the file's dir. */
+function resolveSpacePath(fromFilePath, ref) {
+	const base = ref.startsWith("/") ? [] : fromFilePath.split("/").slice(0, -1).filter(Boolean);
+	const segments = ref.replace(/^\//, "").split("/");
+	const out = [...base];
+	for (const segment of segments) {
+		if (!segment || segment === ".") continue;
+		if (segment === "..") {
+			out.pop();
+			continue;
+		}
+		out.push(segment);
+	}
+	return out.join("/");
+}
+function looksLikeCoverRef(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return false;
+	if (trimmed.startsWith("/") || trimmed.startsWith("./") || trimmed.startsWith("../") || trimmed.startsWith("http://") || trimmed.startsWith("https://") || trimmed.startsWith("//")) return true;
+	if (trimmed.includes("/")) return true;
+	return IMAGE_REF_RE.test(trimmed);
+}
+/**
+* Classify a raw cover reference from frontmatter.
+*
+* Remote covers are allowed on purpose — a lot of real markdown points at a CDN.
+* `http:` / `data:` / `blob:` are rejected so a board never downgrades the page
+* or embeds opaque bytes.
+*/
+function resolveCoverRef(fromFilePath, raw) {
+	const value = (raw ?? "").trim();
+	if (!value) return null;
+	if (value.startsWith("//")) return {
+		kind: "url",
+		url: `https:${value}`
+	};
+	const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(value)?.[1]?.toLowerCase();
+	if (scheme) {
+		if (scheme === "https") return {
+			kind: "url",
+			url: value
+		};
+		return null;
+	}
+	const path = resolveSpacePath(fromFilePath, value);
+	return path ? {
+		kind: "path",
+		path
+	} : null;
+}
+function stripBom(source) {
+	return source.charCodeAt(0) === 65279 ? source.slice(1) : source;
+}
+function isFenceLine(line, fence) {
+	const trimmed = line.trim();
+	if (trimmed === fence) return true;
+	return fence === "---" && trimmed === "...";
+}
+/**
+* Split leading YAML (`---`) or TOML (`+++`) frontmatter from a source.
+*
+* BOM and leading blank lines are ignored. The closing fence may carry trailing
+* whitespace; YAML also accepts `...`. An unterminated block is treated as body.
+*/
+function splitFrontmatter(source) {
+	const text = stripBom(source);
+	const lines = text.split(/\r?\n/);
+	let start = 0;
+	while (start < lines.length && !(lines[start] ?? "").trim()) start += 1;
+	const opener = (lines[start] ?? "").trim();
+	if (opener !== "---" && opener !== "+++") return {
+		frontmatter: null,
+		body: text
+	};
+	for (let index = start + 1; index < lines.length; index += 1) {
+		if (!isFenceLine(lines[index] ?? "", opener)) continue;
+		return {
+			frontmatter: lines.slice(start + 1, index).join("\n"),
+			body: lines.slice(index + 1).join("\n")
+		};
+	}
+	return {
+		frontmatter: null,
+		body: text
+	};
+}
+function unquote(value) {
+	const trimmed = value.trim();
+	if (trimmed.length < 2) return trimmed;
+	const first = trimmed[0];
+	const last = trimmed[trimmed.length - 1];
+	if (first === "\"" && last === "\"" || first === "'" && last === "'") return trimmed.slice(1, -1);
+	return trimmed;
+}
+function isBlockScalar(value) {
+	const trimmed = value.trim();
+	return trimmed === ">" || trimmed === "|" || trimmed === ">-" || trimmed === "|-";
+}
+function scalarKeyValue(line) {
+	if (!line.trim() || /^\s/.test(line) || line.trimStart().startsWith("#")) return null;
+	const match = /^([A-Za-z0-9_:.-]+)\s*[:=]\s*(.*)$/.exec(line);
+	if (!match) return null;
+	const key = match[1];
+	if (!key) return null;
+	return {
+		key,
+		value: unquote(match[2] ?? "")
+	};
+}
+function readIndentedScalars(lines, from) {
+	const found = /* @__PURE__ */ new Map();
+	for (let index = from; index < lines.length; index += 1) {
+		const line = lines[index] ?? "";
+		if (!line.trim()) continue;
+		if (!/^\s/.test(line)) break;
+		const match = /^\s+([A-Za-z0-9_:.-]+)\s*[:=]\s*(.*)$/.exec(line);
+		if (!match?.[1]) continue;
+		const value = unquote(match[2] ?? "");
+		if (value && !isBlockScalar(value) && !found.has(match[1])) found.set(match[1], value);
+	}
+	return found;
+}
+/** Read non-empty top-level scalar values from a frontmatter / YAML / TOML block. */
+function readFrontmatterScalars(frontmatter) {
+	const found = /* @__PURE__ */ new Map();
+	if (!frontmatter) return found;
+	const lines = frontmatter.split(/\r?\n/);
+	for (let index = 0; index < lines.length; index += 1) {
+		const parsed = scalarKeyValue(lines[index] ?? "");
+		if (!parsed) continue;
+		if (parsed.value && !isBlockScalar(parsed.value) && !found.has(parsed.key)) {
+			found.set(parsed.key, parsed.value);
+			continue;
+		}
+		if (!parsed.value && !found.has(parsed.key)) {
+			const nested = readIndentedScalars(lines, index + 1);
+			for (const nestedKey of NESTED_COVER_KEYS) {
+				const nestedValue = nested.get(nestedKey);
+				if (nestedValue) {
+					found.set(parsed.key, nestedValue);
+					break;
+				}
+			}
+		}
+	}
+	return found;
+}
+function readTitleFromFrontmatter(frontmatter) {
+	const found = readFrontmatterScalars(frontmatter);
+	for (const key of TITLE_KEYS) {
+		const value = found.get(key);
+		if (value) return value;
+	}
+	return null;
+}
+function readCoverFromFrontmatter(frontmatter) {
+	const found = readFrontmatterScalars(frontmatter);
+	let fallback = null;
+	for (const key of COVER_KEYS) {
+		const value = found.get(key);
+		if (!value) continue;
+		if (COVER_FALLBACK_KEYS.has(key)) {
+			fallback ??= value;
+			continue;
+		}
+		if (key === "image" && !looksLikeCoverRef(value)) continue;
+		return value;
+	}
+	return fallback;
+}
+function readDescriptionFromScalars(found) {
+	for (const key of DESCRIPTION_KEYS) {
+		const value = found.get(key);
+		if (value) return value;
+	}
+	return null;
+}
+const ATX_H1 = /^(?:[ \t]*#[ \t]+)(.+?)\s*#*\s*$/;
+const SETEXT_H1_UNDERLINE = /^[ \t]*=+[ \t]*$/;
+function firstHeading(body) {
+	const lines = body.split(/\r?\n/);
+	let index = 0;
+	while (index < lines.length && !(lines[index] ?? "").trim()) index += 1;
+	if (index >= lines.length) return null;
+	const atx = ATX_H1.exec(lines[index] ?? "");
+	if (atx?.[1]) return {
+		title: atx[1].trim(),
+		body: [...lines.slice(0, index), ...lines.slice(index + 1)].join("\n")
+	};
+	const next = lines[index + 1] ?? "";
+	if (SETEXT_H1_UNDERLINE.test(next) && (lines[index] ?? "").trim()) return {
+		title: (lines[index] ?? "").trim(),
+		body: [...lines.slice(0, index), ...lines.slice(index + 2)].join("\n")
+	};
+	return null;
+}
+function resolveFileTitle(input) {
+	const fromFrontmatter = readTitleFromFrontmatter(input.frontmatter);
+	if (fromFrontmatter) return {
+		title: fromFrontmatter,
+		body: input.body
+	};
+	const heading = firstHeading(input.body);
+	if (heading) return heading;
+	return {
+		title: input.fallback?.trim() || fileStem(input.path),
+		body: input.body
+	};
+}
+function collapseWhitespace(value, limit) {
+	const cleaned = value.replace(/\r\n?/g, "\n").replace(/[ \t]+/g, " ").replace(/\n{2,}/g, "\n").replace(/[ \t]*\n[ \t]*/g, "\n").trim();
+	if (cleaned.length <= limit) return cleaned;
+	const slice = cleaned.slice(0, limit);
+	const lastSpace = slice.lastIndexOf(" ");
+	return `${(lastSpace > limit * .6 ? slice.slice(0, lastSpace) : slice).trimEnd()}…`;
+}
+/**
+* Reduce markdown to a short, readable excerpt.
+*
+* Decoration is flattened rather than rendered: fenced code is dropped, headings
+* and list markers go, links keep their text. Emphasis markers are only removed
+* when they wrap a span, so a stray `*` does not punch holes in the prose.
+*/
+function buildFileExcerpt(source, limit = 480) {
+	if (!source) return "";
+	return collapseWhitespace(source.replace(/```[\s\S]*?(?:```|$)/g, " ").replace(/<!--[\s\S]*?-->/g, " ").replace(/<\/?[a-z][^>]*>/gi, " ").replace(/!\[[^\]]*\]\([^)]*\)/g, " ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/^[ \t]*#{1,6}[ \t]+/gm, "").replace(/^[ \t]*>[ \t]?/gm, "").replace(/^[ \t]*[-*+][ \t]+/gm, "").replace(/^[ \t]*\d+\.[ \t]+/gm, "").replace(/^[ \t]*([-*_])(?:[ \t]*\1){2,}[ \t]*$/gm, " ").replace(/\|/g, " ").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/__([^_]+)__/g, "$1").replace(/\*([^*\n]+)\*/g, "$1").replace(/_([^_\n]+)_/g, "$1").replace(/`([^`]+)`/g, "$1").replace(/~~([^~]+)~~/g, "$1"), limit);
+}
+function stripCommentDecor(block) {
+	return block.replace(/^\/\*+/, "").replace(/\*+\/$/, "").replace(/^#!.*$/m, "").replace(/^[ \t]*(\/\/+|#|--|\*)[ \t]?/gm, "").trim();
+}
+function buildCodeExcerpt(source, limit = 480) {
+	if (!source) return "";
+	const text = stripBom(source);
+	const leading = text.match(/^[ \t\r\n]*/)?.[0] ?? "";
+	const rest = text.slice(leading.length);
+	const block = rest.match(/^\/\*\*[\s\S]*?\*\//)?.[0] ?? rest.match(/^\/\*[\s\S]*?\*\//)?.[0] ?? rest.match(/^(?:[ \t]*\/\/[^\n]*(?:\n|$)){1,12}/)?.[0] ?? rest.match(/^(?:[ \t]*#[^\n]*(?:\n|$)){1,12}/)?.[0] ?? rest.match(/^(?:[ \t]*--[^\n]*(?:\n|$)){1,12}/)?.[0];
+	if (!block) return "";
+	return collapseWhitespace(stripCommentDecor(block), limit);
+}
+function readJsonScalars(source) {
+	const found = /* @__PURE__ */ new Map();
+	const trimmed = source.trim();
+	if (!trimmed.startsWith("{")) return found;
+	try {
+		const parsed = JSON.parse(trimmed);
+		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return found;
+		for (const [key, value] of Object.entries(parsed)) if (typeof value === "string" && value.trim()) found.set(key, value.trim());
+	} catch {
+		return found;
+	}
+	return found;
+}
+function dataScalars(path, source) {
+	const ext = extensionOf(path);
+	if (ext === "json" || ext === "jsonc") return readJsonScalars(source);
+	return readFrontmatterScalars(source);
+}
+function coverFromScalars(found) {
+	let fallback = null;
+	for (const key of COVER_KEYS) {
+		const value = found.get(key);
+		if (!value) continue;
+		if (COVER_FALLBACK_KEYS.has(key)) {
+			fallback ??= value;
+			continue;
+		}
+		if (key === "image" && !looksLikeCoverRef(value)) continue;
+		return value;
+	}
+	return fallback;
+}
+function applyCover(snapshot, fromPath, raw) {
+	const cover = resolveCoverRef(fromPath, raw);
+	if (cover?.kind === "url") snapshot.coverUrl = cover.url;
+	else if (cover?.kind === "path") snapshot.coverPath = cover.path;
+}
+/**
+* Build the cached display facts for a file node.
+*
+* Content is optional: a snapshot built without it still produces a usable
+* `blank` card, so a node can be created the instant a file is dropped and
+* enriched later without blocking on a read.
+*/
+function buildFileSnapshot(input) {
+	const category = fileCategory(input.path, input.mimeType);
+	const snapshot = { title: input.title?.trim() || fileStem(input.path) };
+	if (input.mimeType) snapshot.mimeType = input.mimeType;
+	if (typeof input.size === "number" && Number.isFinite(input.size)) snapshot.size = input.size;
+	if (typeof input.mtimeMs === "number" && Number.isFinite(input.mtimeMs)) snapshot.mtimeMs = input.mtimeMs;
+	const content = input.content;
+	if (typeof content !== "string" || content.length === 0) return snapshot;
+	if (category === "data") {
+		const found = dataScalars(input.path, content);
+		const title = found.get("title") ?? found.get("name") ?? found.get("label");
+		if (title) snapshot.title = title;
+		applyCover(snapshot, input.path, coverFromScalars(found));
+		const description = readDescriptionFromScalars(found);
+		if (description) snapshot.excerpt = collapseWhitespace(description, 480);
+		return snapshot;
+	}
+	if (category === "code") {
+		const excerpt = buildCodeExcerpt(content);
+		if (excerpt) snapshot.excerpt = excerpt;
+		return snapshot;
+	}
+	if (category === "doc") {
+		const { frontmatter, body } = splitFrontmatter(content);
+		const resolved = resolveFileTitle({
+			path: input.path,
+			frontmatter,
+			body,
+			fallback: input.title
+		});
+		snapshot.title = resolved.title;
+		applyCover(snapshot, input.path, readCoverFromFrontmatter(frontmatter));
+		const excerpt = buildFileExcerpt(resolved.body);
+		if (excerpt) snapshot.excerpt = excerpt;
+		return snapshot;
+	}
+	const excerpt = collapseWhitespace(stripBom(content), 480);
+	if (excerpt) snapshot.excerpt = excerpt;
+	return snapshot;
+}
+/** Whether a file is small enough that fetching a text preview is worthwhile. */
+function shouldFetchFileExcerpt(input) {
+	if (input.size !== void 0 && input.size > 262144) return false;
+	return true;
+}
+//#endregion
+export { FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, buildCodeExcerpt, buildFileExcerpt, buildFileSnapshot, fileBaseName, fileCategory, fileStem, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, resolveCoverRef, resolveFileTitle, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter };

package/dist/board/index.d.ts

@@ -14,7 +14,8 @@ import { CONNECTION_ENDPOINT_GAP, ConnectionIndex, FrameLookup, ResolvedConnecti
 import { StrokeRibbonGeometry, buildStrokeOutline, buildStrokeRibbonGeometry, computeDrawBounds, distanceToStroke, isStrokeCorner, sampleRadius, simplifyDrawIndices } from "./core/draw-geometry.js";
 import { BOARD_EXPORT_MAX_TEXTURES, BoardExportAssetSelection, selectBoardExportAssets } from "./core/export-assets.js";
 import { BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, boardFrameLookup, exportConnectionBounds, exportItemBounds, normalizeBoardDocument, planBoardExport } from "./core/export-plan.js";
-import { BoardFileSnapshotFacts, BuildSnapshotInput, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FileAvailability, FilePreviewKind, ResolvedCover, availabilityFromError, buildFileExcerpt, buildFileSnapshot, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot, readCoverFromFrontmatter, readTitleFromFrontmatter, resolveCoverRef, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-preview.js";
+import { BoardFileSnapshotFacts, BuildSnapshotInput, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FileCategory, ResolvedCover, buildCodeExcerpt, buildFileExcerpt, buildFileSnapshot, fileBaseName, fileCategory, fileStem, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, resolveCoverRef, resolveFileTitle, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-snapshot.js";
+import { FileAvailability, FilePreviewKind, availabilityFromError, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot } from "./core/file-preview.js";
 import { BOARD_COLORS, BoardColorEntry, BoardColorValue, BoardShapeColors, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor } from "./core/palette.js";
 import { ArrowShapeProps, AudioShapeProps, DrawShapeProps, FULL_CAPABILITIES, GEO_KINDS, GeoKind, GeoShapeProps, HandleDragResult, ImageShapeProps, ShapeCapabilities, ShapeGeometry, ShapeHandle, ShapeHandleId, ShapeResizeMode, TextShapeProps, VideoShapeProps, isGeoKind, resizeModeForCapabilities } from "./core/shape-types.js";
 import { ShapeDefinition, definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition } from "./core/shape-definition.js";
@@ -25,6 +26,7 @@ import { DEFAULT_BOARD_APPEARANCE, applyBoardAuthoringSnapshot, boardAuthoringIt
 import { BoardMediaKind, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind } from "./media.js";
 import { BoardAssetSource, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache } from "./media-playback.js";
 import { patchBoardAppearance } from "./mutation.js";
+import { BoardReplayActorKind, BoardReplayEntry, BoardReplayPlayer, boardReplayActorKind, createBoardReplayPlayer } from "./replay.js";
 import { applyBoardSemanticCommands, boardDocumentToSemanticCommands } from "./semantic-mutation.js";
 import { featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot } from "./task.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, type ArrowShapeProps, type AudioShapeProps, BOARD_CHANNELS, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardAssetSource, BoardAudioItem, BoardAudioItemSchema, type BoardCameraFocus, type BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, type BoardCameraState, BoardCameraStateSchema, BoardColorEntry, type BoardColorId, BoardColorValue, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionDefinition, BoardExtensionRegistry, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotFacts, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaKind, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardNormalizedPoint, BoardPlayableMedia, BoardPoint, BoardPointSchema, BoardPresetDefinition, BoardRelationSchema, BoardRemoteUrlSchema, BoardScreenOffset, BoardScreenPoint, BoardShapeColors, BoardStyledToolId, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardToolStyleMap, BoardToolStylePatch, type BoardTrackInterpolation, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BoardWorldOffset, BoardWorldPoint, BoardWorldRect, BuildSnapshotInput, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompositionInput, ConnectionIndex, CornerResizeHandle, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPoint, DrawPointSchema, type DrawShapeProps, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, FilePreviewKind, FrameLookup, GEO_KINDS, type GeoKind, type GeoShapeProps, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, type HandleDragResult, type ImageShapeProps, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, ProceduralClipInput, QualityProfile, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, RenderBounds, ResizeHandle, ResolvedArrow, ResolvedConnection, ResolvedConnectionEndpoint, ResolvedCover, SampledTrack, ScreenPoint, type ShapeCapabilities, ShapeDefinition, type ShapeGeometry, type ShapeHandle, type ShapeHandleId, type ShapeResizeMode, Size, SpaceFileRef, SpaceFileRefSchema, StrokeRibbonGeometry, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, type TextShapeProps, TrackInput, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, type VideoShapeProps, WorldPoint, anchorPointOnFrame, anchorToWorld, angleFromCenter, applyBoardAuthoringSnapshot, applyBoardSemanticCommands, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardAuthoringItemToDocumentItem, boardAuthoringSnapshotToDocument, boardColorCssVar, boardDocumentToSemanticCommands, boardFrameLookup, boardImageKeySource, boardItemToAuthoringItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, compileComposition, composition, boardArrowFrame as computeArrowFrame, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, featuredTaskArtifact, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, getShapeDefinition, handlePosition, imageAssetKey, inferBoardMediaKind, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isPublicBoardRemoteAddress, isStrokeCorner, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, patchBoardAppearance, pathMidpoint, pickBoardColor, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, proceduralClip, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, registerShapeDefinition, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleCompositionTracks, sampleEasing, sampleRadius, sampleTrack, scaleFrames, screenOffset, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, splitFrontmatter, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot, track, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldOffset, worldPoint, worldRect, worldToAnchor, worldToScreen, zoomAround };
+export { AUTO_BOARD_CONNECTION_ANCHOR, type ArrowShapeProps, type AudioShapeProps, BOARD_CHANNELS, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardAssetSource, BoardAudioItem, BoardAudioItemSchema, type BoardCameraFocus, type BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, type BoardCameraState, BoardCameraStateSchema, BoardColorEntry, type BoardColorId, BoardColorValue, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionDefinition, BoardExtensionRegistry, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, type BoardFileSnapshotFacts, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaKind, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardNormalizedPoint, BoardPlayableMedia, BoardPoint, BoardPointSchema, BoardPresetDefinition, BoardRelationSchema, BoardRemoteUrlSchema, BoardReplayActorKind, BoardReplayEntry, BoardReplayPlayer, BoardScreenOffset, BoardScreenPoint, BoardShapeColors, BoardStyledToolId, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardToolStyleMap, BoardToolStylePatch, type BoardTrackInterpolation, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BoardWorldOffset, BoardWorldPoint, BoardWorldRect, type BuildSnapshotInput, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompositionInput, ConnectionIndex, CornerResizeHandle, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPoint, DrawPointSchema, type DrawShapeProps, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, type FileCategory, FilePreviewKind, FrameLookup, GEO_KINDS, type GeoKind, type GeoShapeProps, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, type HandleDragResult, type ImageShapeProps, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, ProceduralClipInput, QualityProfile, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, RenderBounds, ResizeHandle, ResolvedArrow, ResolvedConnection, ResolvedConnectionEndpoint, type ResolvedCover, SampledTrack, ScreenPoint, type ShapeCapabilities, ShapeDefinition, type ShapeGeometry, type ShapeHandle, type ShapeHandleId, type ShapeResizeMode, Size, SpaceFileRef, SpaceFileRefSchema, StrokeRibbonGeometry, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, type TextShapeProps, TrackInput, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, type VideoShapeProps, WorldPoint, anchorPointOnFrame, anchorToWorld, angleFromCenter, applyBoardAuthoringSnapshot, applyBoardSemanticCommands, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardAuthoringItemToDocumentItem, boardAuthoringSnapshotToDocument, boardColorCssVar, boardDocumentToSemanticCommands, boardFrameLookup, boardImageKeySource, boardItemToAuthoringItem, boardReplayActorKind, boardTextLineHeight, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, compileComposition, composition, boardArrowFrame as computeArrowFrame, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, createBoardExtensionRegistry, createBoardReplayPlayer, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, getShapeDefinition, handlePosition, imageAssetKey, inferBoardMediaKind, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isPublicBoardRemoteAddress, isStrokeCorner, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, patchBoardAppearance, pathMidpoint, pickBoardColor, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, proceduralClip, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, registerShapeDefinition, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveFileTitle, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleCompositionTracks, sampleEasing, sampleRadius, sampleTrack, scaleFrames, screenOffset, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, splitFrontmatter, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot, track, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldOffset, worldPoint, worldRect, worldToAnchor, worldToScreen, zoomAround };

package/dist/board/index.js

@@ -14,7 +14,8 @@ import { CONNECTION_ENDPOINT_GAP, anchorPointOnFrame, anchorToWorld, autoConnect
 import { buildStrokeOutline, buildStrokeRibbonGeometry, computeDrawBounds, distanceToStroke, isStrokeCorner, sampleRadius, simplifyDrawIndices } from "./core/draw-geometry.js";
 import { BOARD_EXPORT_MAX_TEXTURES, selectBoardExportAssets } from "./core/export-assets.js";
 import { BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, boardFrameLookup, exportConnectionBounds, exportItemBounds, normalizeBoardDocument, planBoardExport } from "./core/export-plan.js";
-import { FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, availabilityFromError, buildFileExcerpt, buildFileSnapshot, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot, readCoverFromFrontmatter, readTitleFromFrontmatter, resolveCoverRef, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-preview.js";
+import { FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, buildCodeExcerpt, buildFileExcerpt, buildFileSnapshot, fileBaseName, fileCategory, fileStem, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, resolveCoverRef, resolveFileTitle, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-snapshot.js";
+import { availabilityFromError, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot } from "./core/file-preview.js";
 import { BOARD_COLORS, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor } from "./core/palette.js";
 import { FULL_CAPABILITIES, GEO_KINDS, isGeoKind, resizeModeForCapabilities } from "./core/shape-types.js";
 import { definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition } from "./core/shape-definition.js";
@@ -23,5 +24,6 @@ import { DEFAULT_BOARD_TOOL_STYLES, createBoardToolStyles } from "./core/tool-st
 import { getMediaExtension, getMediaResourceTitle, inferBoardMediaKind } from "./media.js";
 import { playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache } from "./media-playback.js";
 import { patchBoardAppearance } from "./mutation.js";
+import { boardReplayActorKind, createBoardReplayPlayer } from "./replay.js";
 import { applyBoardSemanticCommands, boardDocumentToSemanticCommands } from "./semantic-mutation.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CHANNELS, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearanceSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardRelationSchema, BoardRemoteUrlSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPointSchema, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, GEO_KINDS, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, KNOWN_BOARD_ITEM_TYPES, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, anchorPointOnFrame, anchorToWorld, angleFromCenter, applyBoardAuthoringSnapshot, applyBoardSemanticCommands, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardAuthoringItemToDocumentItem, boardAuthoringSnapshotToDocument, boardColorCssVar, boardDocumentToSemanticCommands, boardFrameLookup, boardImageKeySource, boardItemToAuthoringItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, compileComposition, composition, boardArrowFrame as computeArrowFrame, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, featuredTaskArtifact, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, getShapeDefinition, handlePosition, imageAssetKey, inferBoardMediaKind, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isPublicBoardRemoteAddress, isStrokeCorner, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, patchBoardAppearance, pathMidpoint, pickBoardColor, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, proceduralClip, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, registerShapeDefinition, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleCompositionTracks, sampleEasing, sampleRadius, sampleTrack, scaleFrames, screenOffset, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, splitFrontmatter, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot, track, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldOffset, worldPoint, worldRect, worldToAnchor, worldToScreen, zoomAround };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CHANNELS, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearanceSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardRelationSchema, BoardRemoteUrlSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPointSchema, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, GEO_KINDS, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, KNOWN_BOARD_ITEM_TYPES, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, anchorPointOnFrame, anchorToWorld, angleFromCenter, applyBoardAuthoringSnapshot, applyBoardSemanticCommands, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardAuthoringItemToDocumentItem, boardAuthoringSnapshotToDocument, boardColorCssVar, boardDocumentToSemanticCommands, boardFrameLookup, boardImageKeySource, boardItemToAuthoringItem, boardReplayActorKind, boardTextLineHeight, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, compileComposition, composition, boardArrowFrame as computeArrowFrame, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, createBoardExtensionRegistry, createBoardReplayPlayer, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, getShapeDefinition, handlePosition, imageAssetKey, inferBoardMediaKind, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isPublicBoardRemoteAddress, isStrokeCorner, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, patchBoardAppearance, pathMidpoint, pickBoardColor, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, proceduralClip, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, registerShapeDefinition, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveFileTitle, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleCompositionTracks, sampleEasing, sampleRadius, sampleTrack, scaleFrames, screenOffset, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, splitFrontmatter, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot, track, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldOffset, worldPoint, worldRect, worldToAnchor, worldToScreen, zoomAround };

package/dist/board/mutation.js

@@ -6,7 +6,8 @@ function patchBoardAppearance(current, patch) {
 		...current,
 		...patch,
 		background: patch.background ?? current.background,
-		grid: patch.grid ?? current.grid
+		grid: patch.grid ?? current.grid,
+		...Object.hasOwn(patch, "motion") ? { motion: patch.motion } : current.motion ? { motion: current.motion } : {}
 	});
 }
 //#endregion

package/dist/board/render/board-background.d.ts

@@ -0,0 +1,16 @@
+import { BoardDocument, BoardViewport } from "../../protocol/dist/board-document.js";
+import { BoardRenderPalette } from "./renderers/board-renderer-registry.js";
+import { Application, Container } from "pixi.js";
+//#region src/board/render/board-background.d.ts
+type BoardBackgroundContext = {
+  app: Application;
+  document: BoardDocument;
+  viewport: BoardViewport;
+  palette: BoardRenderPalette;
+  /** The host renders an image backdrop below the transparent Pixi canvas. */
+  hasImageBackground?: boolean;
+};
+declare function createBoardBackground(context: BoardBackgroundContext): Container;
+declare function updateBoardBackground(container: Container, context: BoardBackgroundContext): void;
+//#endregion
+export { BoardBackgroundContext, createBoardBackground, updateBoardBackground };