@neta-art/cohub 12.1.1 → 12.2.0

package/dist/media.js

@@ -1,4 +1,4 @@
-import { OSS_PROCESS_PATTERN, mediaHost, ossProcessUrl } from "./protocol/dist/core/media.js";
+import { mediaHost, mediaInfoFromHeaders, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize } from "./protocol/dist/core/media.js";
 //#region src/media.ts
 /**
 * Remote media delivery. Previews and metadata resolve through ordered
@@ -22,6 +22,7 @@ const MEDIA_VARIANT_SIZES = [
 	768,
 	1536
 ];
+const MEDIA_VARIANT_MAX = 1536;
 /** Smallest variant covering `pixels` device pixels, capped at the largest. */
 function mediaVariantSize(pixels) {
 	return MEDIA_VARIANT_SIZES.find((size) => size >= pixels) ?? 1536;
@@ -82,85 +83,5 @@ function mediaPreviewCandidates(media, options, info) {
 	}
 	return candidates;
 }
-function positive(value) {
-	const number = typeof value === "string" ? Number(value) : value;
-	return typeof number === "number" && Number.isFinite(number) && number > 0 ? number : void 0;
-}
-/** Frame URLs must stay on the media's own origin. */
-function sameOriginUrl(value, origin) {
-	if (!value) return void 0;
-	try {
-		const url = new URL(value);
-		return url.protocol === "https:" && url.origin === origin ? url.href : void 0;
-	} catch {
-		return;
-	}
-}
-function compact(info) {
-	return Object.fromEntries(Object.entries(info).filter(([, value]) => value !== void 0));
-}
-/** Media facts from response headers; `x-oss-meta-*` need CORS exposure in browsers. */
-function mediaInfoFromHeaders(headers, url) {
-	const origin = new URL(url).origin;
-	const meta = (name) => headers.get(`x-oss-meta-${name}`);
-	const seconds = positive(meta("duration"));
-	const frameCount = positive(meta("nb-frames"));
-	return compact({
-		width: positive(meta("width")),
-		height: positive(meta("height")),
-		durationMs: seconds ? Math.round(seconds * 1e3) : void 0,
-		frameCount: frameCount ? Math.round(frameCount) : void 0,
-		firstFrameUrl: sameOriginUrl(meta("first-frame"), origin),
-		lastFrameUrl: sameOriginUrl(meta("last-frame"), origin),
-		mimeType: headers.get("content-type")?.split(";")[0]?.trim() || void 0,
-		bytes: positive(headers.get("content-length"))
-	});
-}
-/** Fields of `primary` win; `fallback` fills the rest. */
-function mergeMediaInfo(primary, fallback) {
-	return compact({
-		...fallback,
-		...compact(primary)
-	});
-}
-function hasDimensions(info) {
-	return info.width !== void 0 && info.height !== void 0;
-}
-async function probeHeaders(url, options) {
-	const response = await (options.fetch ?? globalThis.fetch)(url, {
-		method: "HEAD",
-		signal: options.signal
-	});
-	return response.ok ? mediaInfoFromHeaders(response.headers, url) : {};
-}
-async function probeImageInfo(url, options) {
-	if (OSS_PROCESS_PATTERN.test(url)) return {};
-	const response = await (options.fetch ?? globalThis.fetch)(ossProcessUrl(url, "image/info"), { signal: options.signal });
-	if (!response.ok) return {};
-	const body = await response.json();
-	return compact({
-		width: positive(body.ImageWidth?.value),
-		height: positive(body.ImageHeight?.value),
-		bytes: positive(body.FileSize?.value)
-	});
-}
-/**
-* Probe remote media: OSS meta headers (one HEAD, the only source of video
-* duration and frames), then OSS `image/info` for image dimensions. Unknown
-* hosts and failed steps resolve to what was learned so far; never throws.
-*/
-async function probeMediaInfo(url, options) {
-	const host = ossHost(url);
-	if (!host) return {};
-	let info = {};
-	const attempt = async (strategy) => {
-		try {
-			info = mergeMediaInfo(info, await strategy());
-		} catch {}
-	};
-	if (host.metaHeaders) await attempt(() => probeHeaders(url, options));
-	if (options.type === "image" && !hasDimensions(info)) await attempt(() => probeImageInfo(url, options));
-	return info;
-}
 //#endregion
-export { MEDIA_VARIANT_SIZES, imageVariantUrl, mediaInfoFromHeaders, mediaPreviewCandidates, mediaVariantSize, mergeMediaInfo, ossProcessUrl, probeMediaInfo, variantSource, videoFrameUrl };
+export { MEDIA_VARIANT_MAX, MEDIA_VARIANT_SIZES, imageVariantUrl, mediaInfoFromHeaders, mediaPreviewCandidates, mediaVariantSize, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize, variantSource, videoFrameUrl };

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

@@ -1,5 +1,5 @@
 //#region ../protocol/dist/board-constants.js
-const BOARD_TEXT_FONT_FAMILY = "Geist";
+const BOARD_TEXT_FONT_FAMILY = "Geist Variable";
 const BOARD_ARROW_STROKE_SIZE = 2.5;
 const BOARD_PAGE_SIZE = {
 	width: 960,
@@ -62,7 +62,7 @@ function clampBoardStrokeSize(size) {
 	if (!Number.isFinite(size)) return BOARD_ARROW_STROKE_SIZE;
 	return Math.min(64, Math.max(1, size));
 }
-const BOARD_FONT_STACK = "\"Geist\", system-ui, -apple-system, \"Noto Sans CJK SC\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", \"Noto Sans Math\", \"Noto Sans Symbols 2\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", sans-serif";
-const BOARD_MONO_FONT_STACK = "\"Geist Mono\", \"Fira Code\", ui-monospace, \"Noto Sans Mono CJK SC\", \"Noto Sans Math\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", monospace";
+const BOARD_FONT_STACK = "\"Geist Variable\", \"Geist\", \"Noto Sans CJK SC\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", system-ui, -apple-system, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Noto Color Emoji\", \"Noto Sans Math\", \"Noto Sans Symbols 2\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", sans-serif";
+const BOARD_MONO_FONT_STACK = "\"Geist Mono Variable\", \"Geist Mono\", \"Fira Code\", ui-monospace, \"Noto Sans Mono CJK SC\", \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Noto Color Emoji\", \"Noto Sans Math\", \"DejaVu Sans\", \"FreeSans\", \"FreeSerif\", monospace";
 //#endregion
 export { BOARD_ARROW_STROKE_SIZE, BOARD_DEFAULT_ITEM_SIZE, BOARD_DEFAULT_SIZES, BOARD_FONT_STACK, BOARD_MONO_FONT_STACK, BOARD_PAGE_SIZE, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TEXT_FONT_FAMILY, BOARD_TEXT_SCALE, boardDefaultSize, clampBoardStrokeSize };

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

@@ -15,8 +15,17 @@ declare function multiplyMatrix(parent: BoardMatrix, child: BoardMatrix): BoardM
 declare function invertMatrix(matrix: BoardMatrix): BoardMatrix;
 declare function applyMatrix(matrix: BoardMatrix, point: BoardVec2): BoardVec2;
 declare function scaleVector(scale: BoardItem["scale"]): BoardVec2;
-type BoardTextMeasurer = (text: string, fontSize: number, fontWeight: number, font: string) => number | null;
-declare function setBoardTextMeasurer(measurer?: BoardTextMeasurer): void;
+type BoardTextFont = {
+  fontSize: number;
+  fontWeight: number;
+  font: string;
+};
+type BoardTextLines = {
+  lines: string[];
+  width: number;
+};
+type BoardTextLayouter = (text: string, font: BoardTextFont, maxWidth: number | undefined) => BoardTextLines;
+declare function setBoardTextLayouter(layouter?: BoardTextLayouter): void;
 declare function estimateTextWidth(text: string, fontSize: number): number;
 type BoardTextLayout = {
   width: number;
@@ -33,6 +42,11 @@ declare function fitBoardMediaSize(natural: {
   width: number;
   height: number;
 } | null;
+/** Fits media items to their natural aspect ratio using the shared Board rule. */
+declare function adoptBoardNaturalSize(item: BoardItem, natural: {
+  width: number;
+  height: number;
+}): BoardItem | null;
 declare function drawSampleRadius(strokeWidth: number, pressure: number): number;
 declare function drawPointsBounds(points: readonly BoardDrawPoint[], strokeWidth: number): BoardRect;
 declare function pointsRect(points: readonly BoardVec2[]): BoardRect;
@@ -63,4 +77,4 @@ declare function sideAnchor(side: "top" | "right" | "bottom" | "left", offset: n
 declare function anchorPoint(frame: BoardFrame, anchor: BoardArrowAnchor, toward: BoardVec2): BoardVec2;
 declare function createDocumentLayout(items: Readonly<Record<string, BoardItem>>): BoardLayout;
 //#endregion
-export { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextLayout, BoardTextMeasurer, IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor };
+export { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextFont, BoardTextLayout, BoardTextLayouter, BoardTextLines, IDENTITY_MATRIX, adoptBoardNaturalSize, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextLayouter, sideAnchor };

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

@@ -1,4 +1,5 @@
 import { boardDefaultSize } from "./board-constants.js";
+import { featuredTaskArtifact } from "./board-task.js";
 //#region ../protocol/dist/board-layout.js
 const IDENTITY_MATRIX = [
 	1,
@@ -45,9 +46,9 @@ function scaleVector(scale) {
 		y: scale
 	} : scale;
 }
-let textMeasurer;
-function setBoardTextMeasurer(measurer) {
-	textMeasurer = measurer;
+let textLayouter;
+function setBoardTextLayouter(layouter) {
+	textLayouter = layouter;
 	textSizeCache.clear();
 }
 function isWideCharacter(code) {
@@ -66,8 +67,14 @@ function estimateTextWidth(text, fontSize) {
 	}
 	return ems * fontSize;
 }
-function measureLine(text, fontSize, fontWeight, font) {
-	return textMeasurer?.(text, fontSize, fontWeight, font) ?? estimateTextWidth(text, fontSize);
+function estimateLines(text, { fontSize }, maxWidth) {
+	const measure = (line) => estimateTextWidth(line, fontSize);
+	const paragraphs = text.split("\n");
+	const lines = maxWidth ? paragraphs.flatMap((paragraph) => wrapParagraph(paragraph, maxWidth, measure)) : paragraphs;
+	return {
+		lines,
+		width: lines.reduce((max, line) => Math.max(max, measure(line)), 0)
+	};
 }
 function wrapParagraph(paragraph, width, measure) {
 	if (!paragraph) return [""];
@@ -96,13 +103,15 @@ function layoutBoardText(props) {
 	const key = `${fontSize}|${props.fontWeight}|${props.font}|${props.lineHeight}|${props.width ?? ""}|${props.text}`;
 	const cached = textSizeCache.get(key);
 	if (cached) return cached;
-	const measure = (text) => measureLine(text, fontSize, props.fontWeight ?? 500, props.font ?? "sans");
-	const paragraphs = (props.text || "").split("\n");
-	const lines = props.width ? paragraphs.flatMap((paragraph) => wrapParagraph(paragraph, props.width, measure)) : paragraphs;
+	const font = {
+		fontSize,
+		fontWeight: props.fontWeight ?? 500,
+		font: props.font ?? "sans"
+	};
+	const { lines, width } = (textLayouter ?? estimateLines)(props.text || "", font, props.width || void 0);
 	const lineHeight = fontSize * (props.lineHeight ?? 4 / 3);
-	const widest = lines.reduce((max, line) => Math.max(max, measure(line)), 0);
 	const layout = {
-		width: Math.max(props.width ?? 0, widest, fontSize * .5),
+		width: Math.max(props.width ?? 0, width, fontSize * .5),
 		height: Math.max(1, lines.length) * lineHeight,
 		lines,
 		lineHeight
@@ -124,6 +133,54 @@ function fitBoardMediaSize(natural, edge) {
 		height: Math.max(1, Math.round(height * scale))
 	};
 }
+/** Fits media items to their natural aspect ratio using the shared Board rule. */
+function adoptBoardNaturalSize(item, natural) {
+	const dimensions = {
+		naturalWidth: natural.width,
+		naturalHeight: natural.height
+	};
+	if (item.type === "task") {
+		const artifact = featuredTaskArtifact(item.props.snapshot.artifacts);
+		if (artifact?.type !== "image" && artifact?.type !== "video" || artifact.naturalWidth && artifact.naturalHeight) return null;
+		const size = fitBoardMediaSize(natural, Math.max(item.size.width, item.size.height));
+		if (!size) return null;
+		const artifacts = item.props.snapshot.artifacts.map((entry) => entry.id === artifact.id ? {
+			...entry,
+			...dimensions
+		} : entry);
+		return {
+			...item,
+			size,
+			props: {
+				...item.props,
+				snapshot: {
+					...item.props.snapshot,
+					artifacts
+				}
+			}
+		};
+	}
+	if (item.type !== "image" && item.type !== "video") return null;
+	if (item.props.snapshot?.naturalWidth && item.props.snapshot.naturalHeight) return null;
+	const size = fitBoardMediaSize(natural, Math.max(item.size.width, item.size.height));
+	if (!size) return null;
+	const position = {
+		x: item.position.x + (item.size.width - size.width) / 2,
+		y: item.position.y + (item.size.height - size.height) / 2
+	};
+	return {
+		...item,
+		position,
+		size,
+		props: {
+			...item.props,
+			snapshot: {
+				...item.props.snapshot,
+				...dimensions
+			}
+		}
+	};
+}
 function drawSampleRadius(strokeWidth, pressure) {
 	const clamped = Math.min(1, Math.max(0, pressure));
 	return Math.max(.5, strokeWidth / 2 * (.5 + clamped));
@@ -491,4 +548,4 @@ function createDocumentLayout(items) {
 	return createBoardLayout((id) => items[id], dependents);
 }
 //#endregion
-export { IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor };
+export { IDENTITY_MATRIX, adoptBoardNaturalSize, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextLayouter, sideAnchor };

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

@@ -1,5 +1,39 @@
 //#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;
+type MediaInfo = {
+  width?: number;
+  height?: number;
+  durationMs?: number;
+  frameCount?: number;
+  firstFrameUrl?: string;
+  lastFrameUrl?: string;
+  mimeType?: string;
+  bytes?: number;
+};
+/** Media facts from response headers; `x-oss-meta-*` need CORS exposure in browsers. */
+declare function mediaInfoFromHeaders(headers: Headers, url: string): MediaInfo;
+declare function mergeMediaInfo(primary: MediaInfo, fallback: MediaInfo): MediaInfo;
+type ProbeOptions = {
+  type: "image" | "video" | "audio";
+  fetch?: typeof globalThis.fetch;
+  signal?: AbortSignal;
+};
+declare function probeMediaInfo(url: string, options: ProbeOptions): Promise<MediaInfo>;
+/**
+ * A video's dimensions, read from the header of its first frame rendered as a
+ * full-size PNG by OSS; only the first 24 bytes are read. Throws on failure.
+ */
+declare function probeVideoFrameSize(url: string, options?: {
+  fetch?: typeof globalThis.fetch;
+  signal?: AbortSignal;
+}): Promise<Pick<MediaInfo, "width" | "height">>;
+declare function probeMediaSize(url: string, type: "image" | "video", options?: {
+  fetch?: typeof globalThis.fetch;
+  signal?: AbortSignal;
+}): Promise<{
+  width: number;
+  height: number;
+} | null>;
 //#endregion
-export { ossProcessUrl };
+export { MediaInfo, mediaInfoFromHeaders, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize };

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

@@ -36,5 +36,127 @@ const MODEL_IMAGE = {
 const { maxEdge, quality } = MODEL_IMAGE;
 `${maxEdge}${maxEdge}${quality}`;
 `${maxEdge}${maxEdge}${quality}`;
+function positive(value) {
+	const number = typeof value === "string" ? Number(value) : value;
+	return typeof number === "number" && Number.isFinite(number) && number > 0 ? number : void 0;
+}
+function sameOriginUrl(value, origin) {
+	if (!value) return void 0;
+	try {
+		const url = new URL(value);
+		return url.protocol === "https:" && url.origin === origin ? url.href : void 0;
+	} catch {
+		return;
+	}
+}
+function compact(info) {
+	return Object.fromEntries(Object.entries(info).filter(([, value]) => value !== void 0));
+}
+/** Media facts from response headers; `x-oss-meta-*` need CORS exposure in browsers. */
+function mediaInfoFromHeaders(headers, url) {
+	const origin = new URL(url).origin;
+	const meta = (name) => headers.get(`x-oss-meta-${name}`);
+	const seconds = positive(meta("duration"));
+	const frameCount = positive(meta("nb-frames"));
+	return compact({
+		width: positive(meta("width")),
+		height: positive(meta("height")),
+		durationMs: seconds ? Math.round(seconds * 1e3) : void 0,
+		frameCount: frameCount ? Math.round(frameCount) : void 0,
+		firstFrameUrl: sameOriginUrl(meta("first-frame"), origin),
+		lastFrameUrl: sameOriginUrl(meta("last-frame"), origin),
+		mimeType: headers.get("content-type")?.split(";")[0]?.trim() || void 0,
+		bytes: positive(headers.get("content-length"))
+	});
+}
+function mergeMediaInfo(primary, fallback) {
+	return compact({
+		...fallback,
+		...compact(primary)
+	});
+}
+function hasDimensions(info) {
+	return info.width !== void 0 && info.height !== void 0;
+}
+async function probeHeaders(url, options) {
+	const response = await (options.fetch ?? globalThis.fetch)(url, {
+		method: "HEAD",
+		signal: options.signal
+	});
+	return response.ok ? mediaInfoFromHeaders(response.headers, url) : {};
+}
+async function probeImageInfo(url, options) {
+	if (OSS_PROCESS_PATTERN.test(url)) return {};
+	const response = await (options.fetch ?? globalThis.fetch)(ossProcessUrl(url, "image/info"), { signal: options.signal });
+	if (!response.ok) return {};
+	const body = await response.json();
+	return compact({
+		width: positive(body.ImageWidth?.value),
+		height: positive(body.ImageHeight?.value),
+		bytes: positive(body.FileSize?.value)
+	});
+}
+async function probeMediaInfo(url, options) {
+	const host = mediaHost(url);
+	if (host?.transform !== "oss") return {};
+	let info = {};
+	const attempt = async (strategy) => {
+		try {
+			info = mergeMediaInfo(info, await strategy());
+		} catch {}
+	};
+	if (host.metaHeaders) await attempt(() => probeHeaders(url, options));
+	if (options.type === "image" && !hasDimensions(info)) await attempt(() => probeImageInfo(url, options));
+	return info;
+}
+const PNG_SIGNATURE = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+];
+/**
+* A video's dimensions, read from the header of its first frame rendered as a
+* full-size PNG by OSS; only the first 24 bytes are read. Throws on failure.
+*/
+async function probeVideoFrameSize(url, options = {}) {
+	if (mediaHost(url)?.transform !== "oss" || OSS_PROCESS_PATTERN.test(url)) return {};
+	const response = await (options.fetch ?? globalThis.fetch)(ossProcessUrl(url, "video/snapshot,t_0,f_png,w_0,h_0,m_fast"), {
+		headers: { Range: "bytes=0-23" },
+		signal: options.signal
+	});
+	if (!response.ok) throw new Error(`HTTP ${response.status}`);
+	const header = /* @__PURE__ */ new Uint8Array(24);
+	let length = 0;
+	const reader = response.body?.getReader();
+	while (reader && length < header.length) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		header.set(value.subarray(0, header.length - length), length);
+		length += Math.min(value.length, header.length - length);
+	}
+	await reader?.cancel().catch(() => void 0);
+	if (length < header.length || PNG_SIGNATURE.some((byte, index) => header[index] !== byte)) return {};
+	const view = new DataView(header.buffer);
+	return compact({
+		width: positive(view.getUint32(16)),
+		height: positive(view.getUint32(20))
+	});
+}
+async function probeMediaSize(url, type, options = {}) {
+	const info = await probeMediaInfo(url, {
+		...options,
+		type
+	});
+	const { width, height } = info.width || type !== "video" ? info : await probeVideoFrameSize(url, options).catch(() => info);
+	return width && height ? {
+		width,
+		height
+	} : null;
+}
 //#endregion
-export { MODEL_IMAGE, OSS_PROCESS_PATTERN, mediaHost, ossProcessUrl };
+export { MODEL_IMAGE, OSS_PROCESS_PATTERN, mediaHost, mediaInfoFromHeaders, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize };

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

@@ -1,5 +1,5 @@
 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, BoardMediaOrigin, BoardMediaOriginSchema, 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, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor } from "./board-layout.js";
+import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextFont, BoardTextLayout, BoardTextLayouter, BoardTextLines, IDENTITY_MATRIX, adoptBoardNaturalSize, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextLayouter, 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 { RequestSource, RequestSourceVia } from "./provenance.js";
@@ -24,4 +24,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_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_TASK_SOURCE_PREFIX, 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, BoardMediaOrigin, BoardMediaOriginSchema, 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, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, ModelFormat, RequestSource, RequestSourceVia, TaskRunStatus, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, fitBoardMediaSize, 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, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };
+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_TASK_SOURCE_PREFIX, 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, BoardMediaOrigin, BoardMediaOriginSchema, 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, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextFont, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextLayouter, BoardTextLines, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, ModelFormat, RequestSource, RequestSourceVia, TaskRunStatus, adoptBoardNaturalSize, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, fitBoardMediaSize, 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, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextLayouter, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "12.1.1",
+  "version": "12.2.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
@@ -98,6 +98,7 @@
     "NOTICE"
   ],
   "dependencies": {
+    "@chenglou/pretext": "1.0.0",
     "es-module-lexer": "2.3.2",
     "perfect-freehand": "1.2.3",
     "zod": "^4.6.5"
@@ -105,7 +106,7 @@
   "devDependencies": {
     "@biomejs/biome": "2.5.15",
     "@cohub/protocol": "2.0.0",
-    "@napi-rs/canvas": "^1.0.8",
+    "@napi-rs/canvas": "^1.0.13",
     "@types/node": "26.6.4",
     "pixi.js": "^8.20.1",
     "tsdown": "^0.22.14",

package/dist/board/model/image-key.d.ts

@@ -1,9 +0,0 @@
-import { BoardSceneItem } from "./scene.js";
-//#region src/board/model/image-key.d.ts
-declare function imageAssetKey(item: BoardSceneItem): string | null;
-declare function boardImageKeySource(key: string): {
-  kind: "file" | "url";
-  value: string;
-} | null;
-//#endregion
-export { boardImageKeySource, imageAssetKey };

package/dist/board/model/image-key.js

@@ -1,33 +0,0 @@
-import { parseBoardMediaSource } from "../../protocol/dist/board-model.js";
-import { featuredTaskArtifact, taskArtifactPreviewUrl } from "../../protocol/dist/board-task.js";
-//#region src/board/model/image-key.ts
-function imageAssetKey(item) {
-	if (item.type === "image") {
-		const source = parseBoardMediaSource(item.props.src);
-		return source ? `${source.kind}:${source.value}` : null;
-	}
-	if (item.type === "file") {
-		const snapshot = item.props.snapshot;
-		if (snapshot?.coverUrl) return `url:${snapshot.coverUrl}`;
-		if (snapshot?.coverPath) return `file:${snapshot.coverPath}`;
-		return null;
-	}
-	if (item.type === "task") {
-		const url = taskArtifactPreviewUrl(featuredTaskArtifact(item.props.snapshot.artifacts));
-		return url ? `url:${url}` : null;
-	}
-	return null;
-}
-function boardImageKeySource(key) {
-	if (key.startsWith("file:")) return {
-		kind: "file",
-		value: key.slice(5)
-	};
-	if (key.startsWith("url:")) return {
-		kind: "url",
-		value: key.slice(4)
-	};
-	return null;
-}
-//#endregion
-export { boardImageKeySource, imageAssetKey };