@neta-art/cohub 12.1.1 → 12.3.0

package/dist/media.d.ts

@@ -1,4 +1,4 @@
-import { ossProcessUrl } from "./protocol/dist/core/media.js";
+import { MediaInfo, mediaInfoFromHeaders, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize } from "./protocol/dist/core/media.js";
 //#region src/media.d.ts
 type MediaType = "image" | "video" | "audio";
 /**
@@ -7,18 +7,9 @@ type MediaType = "image" | "video" | "audio";
  * keep the original's rendered size.
  */
 type MediaFit = "cover" | "contain" | "width";
-type MediaInfo = {
-  width?: number;
-  height?: number;
-  durationMs?: number;
-  frameCount?: number;
-  firstFrameUrl?: string;
-  lastFrameUrl?: string;
-  mimeType?: string;
-  bytes?: number;
-};
 /** Fixed variant widths keep CDN cache hits high; pick with `mediaVariantSize`. */
 declare const MEDIA_VARIANT_SIZES: readonly [192, 384, 768, 1536];
+declare const MEDIA_VARIANT_MAX = 1536;
 type MediaVariantSize = (typeof MEDIA_VARIANT_SIZES)[number];
 /** Smallest variant covering `pixels` device pixels, capped at the largest. */
 declare function mediaVariantSize(pixels: number): MediaVariantSize;
@@ -53,20 +44,5 @@ declare function mediaPreviewCandidates(media: MediaPreviewSource, options: {
   size: MediaVariantSize;
   fit?: MediaFit;
 }, info?: Pick<MediaInfo, "firstFrameUrl">): string[];
-/** Media facts from response headers; `x-oss-meta-*` need CORS exposure in browsers. */
-declare function mediaInfoFromHeaders(headers: Headers, url: string): MediaInfo;
-/** Fields of `primary` win; `fallback` fills the rest. */
-declare function mergeMediaInfo(primary: MediaInfo, fallback: MediaInfo): MediaInfo;
-type ProbeOptions = {
-  type: MediaType;
-  fetch?: typeof globalThis.fetch;
-  signal?: AbortSignal;
-};
-/**
- * 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.
- */
-declare function probeMediaInfo(url: string, options: ProbeOptions): Promise<MediaInfo>;
 //#endregion
-export { MEDIA_VARIANT_SIZES, MediaFit, MediaInfo, MediaPreviewSource, MediaType, MediaVariantSize, imageVariantUrl, mediaInfoFromHeaders, mediaPreviewCandidates, mediaVariantSize, mergeMediaInfo, ossProcessUrl, probeMediaInfo, variantSource, videoFrameUrl };
+export { MEDIA_VARIANT_MAX, MEDIA_VARIANT_SIZES, MediaFit, type MediaInfo, MediaPreviewSource, MediaType, MediaVariantSize, imageVariantUrl, mediaInfoFromHeaders, mediaPreviewCandidates, mediaVariantSize, mergeMediaInfo, ossProcessUrl, probeMediaInfo, probeMediaSize, probeVideoFrameSize, variantSource, videoFrameUrl };

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/board-model.d.ts

@@ -1139,6 +1139,13 @@ declare const BoardCustomItemSchema: z.ZodObject<{
   props: z.ZodDefault<z.ZodObject<{}, z.core.$strict>>;
 }, z.core.$strict>;
 declare const BOARD_EXTENSION_TYPE_PATTERN: RegExp;
+declare const BoardItemPreviewSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  excerpt: z.ZodOptional<z.ZodString>;
+  cover: z.ZodOptional<z.ZodString>;
+  src: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type BoardItemPreview = z.infer<typeof BoardItemPreviewSchema>;
 declare const BoardExtensionItemSchema: z.ZodObject<{
   script: z.ZodOptional<z.ZodObject<{
     src: z.ZodString;
@@ -1190,6 +1197,12 @@ declare const BoardExtensionItemSchema: z.ZodObject<{
   }, z.core.$strict>>;
   type: z.ZodString;
   props: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  preview: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    excerpt: z.ZodOptional<z.ZodString>;
+    cover: z.ZodOptional<z.ZodString>;
+    src: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 }, z.core.$strict>;
 declare const BOARD_ITEM_SCHEMAS: {
   readonly frame: z.ZodObject<{
@@ -2070,6 +2083,7 @@ type BoardItemType = BoardItem["type"];
 type BoardFileBackedItem = BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem;
 declare function isBuiltinItemType(type: string): type is BoardBuiltinItemType;
 declare function isBuiltinItem(item: BoardItem): item is BoardBuiltinItem;
+declare function boardItemPreview(item: BoardItem): BoardItemPreview | null;
 declare function isFileBackedItem(item: BoardItem): item is BoardFileBackedItem;
 declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardAudioItem;
 declare const BOARD_DERIVED_SIZE_TYPES: readonly ["text", "draw", "arrow"];
@@ -2274,4 +2288,4 @@ type BoardDelta = {
 };
 declare function isEmptyBoardDelta(delta: BoardDelta): boolean;
 //#endregion
-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_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 };
+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_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, BoardItemPreview, BoardItemPreviewSchema, 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, boardItemPreview, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

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

@@ -406,10 +406,17 @@ const BoardCustomItemSchema = z.object({
 	props: z.object({}).strict().default({})
 }).strict();
 const BOARD_EXTENSION_TYPE_PATTERN = /^[a-z][a-z0-9]*(?:\.[a-z0-9-]+)+$/;
+const BoardItemPreviewSchema = z.object({
+	title: z.string().max(500).optional(),
+	excerpt: z.string().max(2e3).optional(),
+	cover: BoardMediaSourceSchema.optional().describe("An image for the card."),
+	src: BoardMediaSourceSchema.optional().describe("The file or page the card stands for.")
+}).strict().describe("How a client without this type's renderer shows the card, and what it refers to. The type's own client keeps it current.");
 const BoardExtensionItemSchema = z.object({
 	...boxed(BOARD_DEFAULT_ITEM_SIZE),
 	type: z.string().regex(BOARD_EXTENSION_TYPE_PATTERN),
-	props: z.record(z.string(), z.unknown()).default({})
+	props: z.record(z.string(), z.unknown()).default({}),
+	preview: BoardItemPreviewSchema.optional()
 }).strict();
 const BOARD_ITEM_SCHEMAS = {
 	frame: BoardFrameItemSchema,
@@ -432,6 +439,9 @@ function isBuiltinItemType(type) {
 function isBuiltinItem(item) {
 	return isBuiltinItemType(item.type);
 }
+function boardItemPreview(item) {
+	return isBuiltinItem(item) ? null : item.preview ?? null;
+}
 function isFileBackedItem(item) {
 	return item.type === "image" || item.type === "video" || item.type === "audio" || item.type === "file";
 }
@@ -612,4 +622,4 @@ function isEmptyBoardDelta(delta) {
 	return !delta.board && Object.keys(delta.items ?? {}).length === 0 && Object.keys(delta.animations ?? {}).length === 0 && Object.keys(delta.tracks ?? {}).length === 0;
 }
 //#endregion
-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_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };
+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_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardItemPreviewSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemPreview, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

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 { applyMatrix, arrowBindings, createBoardLayout, invertMatrix, isArrowBinding } from "./board-layout.js";
 import { boardJsonEquals } from "./board-json.js";
+import { applyMatrix, arrowBindings, createBoardLayout, invertMatrix, isArrowBinding } from "./board-layout.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-patch.js
 function slot(map, key) {

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", "script", "camera", ...("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[]];
+declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "script", "extension", "camera", ...("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[]];
 type BoardJsonSchemaResult = {
   schema?: JsonSchema;
   properties?: Array<{
@@ -73,6 +73,7 @@ declare function boardSchemaOverview(): {
     };
   };
   types: ("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[];
+  extensionTypes: string;
   colors: {
     tokens: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
     css: string;

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

@@ -1,5 +1,5 @@
 import { BOARD_DEFAULT_SIZES, BOARD_PAGE_SIZE, BOARD_TEXT_SCALE } from "./board-constants.js";
-import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardKeySchema, BoardScriptSchema, 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, BoardExtensionItemSchema, BoardKeySchema, BoardScriptSchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
 import { listBoardProperties, resolveBoardProperty } from "./board-patch.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-schema.js
@@ -15,6 +15,7 @@ const BOARD_SCHEMA_TARGETS = [
 	"animation",
 	"track",
 	"script",
+	"extension",
 	BOARD_CAMERA_TARGET,
 	...BOARD_ITEM_TYPES
 ];
@@ -26,6 +27,7 @@ function boardJsonSchema(target) {
 	};
 	if (target === "track") return { schema: toJsonSchema(BoardTrackSchema) };
 	if (target === "script") return { schema: toJsonSchema(BoardScriptSchema) };
+	if (target === "extension") return { schema: toJsonSchema(BoardExtensionItemSchema) };
 	if (target === "camera") {
 		const properties = listBoardProperties(target);
 		const fields = Object.fromEntries(properties.map(({ property }) => {
@@ -61,6 +63,7 @@ function boardSchemaOverview() {
 			itemSizes: BOARD_DEFAULT_SIZES
 		},
 		types: BOARD_ITEM_TYPES,
+		extensionTypes: "Namespaced types like acme.order keep props as written; give them a preview (title, excerpt, cover, src) so every client can show them. See schema extension.",
 		colors: {
 			tokens: BOARD_COLOR_TOKENS,
 			css: "any CSS color",

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

@@ -4,8 +4,12 @@ const MEDIA_HOSTS = /* @__PURE__ */ new Map([
 		transform: "oss",
 		metaHeaders: true
 	}],
+	["oss.talesofai.com", { transform: "oss" }],
 	["public.cohub.live", { transform: "oss" }],
+	["public.cohub.run", { transform: "oss" }],
 	["sessions.cohub.live", { transform: "oss" }],
+	["works.cohub.live", { transform: "oss" }],
+	["works.cohub.run", { transform: "oss" }],
 	["cca.neta.art", { transform: "cloudflare" }]
 ]);
 const parseHttpsUrl = (url) => {
@@ -36,5 +40,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 };