@neta-art/cohub 12.1.1 → 12.2.0

package/dist/board/stage/stage.js

@@ -1,24 +1,26 @@
-import { applyMatrix, invertMatrix } from "../../protocol/dist/board-layout.js";
 import { featuredTaskArtifact } from "../../protocol/dist/board-task.js";
+import { applyMatrix, invertMatrix } from "../../protocol/dist/board-layout.js";
 import { pointToWorld, screenPoint, stableCullRect, visibleWorldRect, worldPoint } from "../model/geometry.js";
 import { boardScriptScope, composeBoardScriptItems, prepareBoardScriptOutput, validateBoardScriptCommit } from "../model/script-scene.js";
 import { boardScriptTarget } from "../model/script-hit.js";
 import { createBoardAnimationSampler, resolveBoardAnimationCamera } from "../model/sampling.js";
 import { resolveSceneArrow } from "../model/arrow-geometry.js";
-import { buildFallbackShapeColors, pickBoardColor, resolveItemColor } from "../model/palette.js";
+import { boardTextureEdge } from "../model/asset-key.js";
+import { pickBoardColor, resolveItemColor } from "../model/palette.js";
 import { elementClientToLocal } from "../model/client-geometry.js";
 import { isCreationBoardTool } from "../editor/tool.js";
 import { resizeCursorForHandle } from "../editor/selection-transform.js";
 import { parseBoardCssColor } from "../render/css-color.js";
-import { defaultBoardPalette, itemAlpha } from "../render/palette.js";
+import { itemAlpha } from "../render/palette.js";
+import { onBoardTextFontsChange } from "../render/text-measurement.js";
 import { createBoardBackground, updateBoardBackground } from "../render/board-background.js";
 import { getBoardResolution } from "../render/text-resolution.js";
 import { DEFAULT_BOARD_RENDER_LABELS, getBoardCardRenderer } from "../render/renderers/board-renderer-registry.js";
 import { createBoardScriptHost } from "../render/script-host.js";
 import { defaultBoardRenderStyle } from "../render/style.js";
-import { createBoardPlayer } from "../player/index.js";
+import { boardRenderTheme } from "../render/theme.js";
 import { createBoardScriptObservers } from "../model/script-observers.js";
-import { boardTextureEdge } from "./assets.js";
+import { createBoardPlayer } from "../player/index.js";
 import { boardCanvasSize, measureBoardCanvasBox } from "./canvas-size.js";
 import { observeDisplayDensity } from "./display-density.js";
 import { toBoardPointerEvent } from "./pointer.js";
@@ -42,18 +44,17 @@ const LIVE_CHANNELS = [
 	"editing",
 	"playback"
 ];
-function defaultTheme() {
-	return {
-		key: "dark",
-		palette: defaultBoardPalette("dark"),
-		colors: buildFallbackShapeColors("dark"),
-		colorScheme: "dark"
-	};
-}
+const DEFAULT_THEME = {
+	key: "dark",
+	...boardRenderTheme("dark")
+};
 const NO_IDS = /* @__PURE__ */ new Set();
 const MARCH_STEP_MS = 160;
 const MARCH_SMOOTH_MS = 40;
 const TEXTURE_SETTLE_MS = 150;
+const ADOPT_PIXELS_PER_FRAME = 4194304;
+const LOAD_LEAD_MS = 300;
+const CULL_PADDING = 96;
 const ROTATE_CURSOR = `url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24'%3E%3Cpath d='M21 12a9 9 0 1 1-2.64-6.36L21 8M21 3v5h-5' fill='none' stroke='%23fff' stroke-width='4' stroke-linecap='round' stroke-linejoin='round'/%3E%3Cpath d='M21 12a9 9 0 1 1-2.64-6.36L21 8M21 3v5h-5' fill='none' stroke='%231d1d1f' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") 12 12, crosshair`;
 const defaultStyles = /* @__PURE__ */ new Map();
 function styleOf(theme) {
@@ -66,7 +67,7 @@ function styleOf(theme) {
 }
 function mountBoardStage(host, options) {
 	const { editor, assets } = options;
-	const theme = options.theme ?? defaultTheme;
+	const theme = options.theme ?? (() => DEFAULT_THEME);
 	const resolveRenderer = options.renderers ?? getBoardCardRenderer;
 	let app = null;
 	let world = null;
@@ -115,6 +116,8 @@ function mountBoardStage(host, options) {
 	let resizeFrame = 0;
 	let canvasBox = null;
 	let cardEpoch = 0;
+	let fontEpoch = 0;
+	let shownEditingId = null;
 	let surface = {
 		width: 0,
 		height: 0
@@ -192,6 +195,49 @@ function mountBoardStage(host, options) {
 			}
 		}, TEXTURE_SETTLE_MS);
 	}
+	function cullView(camera) {
+		const view = visibleWorldRect(camera, surface.width, surface.height);
+		const pad = CULL_PADDING / camera.zoom;
+		return {
+			x: view.x - pad,
+			y: view.y - pad,
+			width: view.width + pad * 2,
+			height: view.height + pad * 2
+		};
+	}
+	const arrivals = /* @__PURE__ */ new Set();
+	function adoptArrivals() {
+		let pixels = 0;
+		for (const key of arrivals) {
+			const texture = assets.getTexture(key);
+			const size = texture ? texture.width * texture.height : 0;
+			if (pixels > 0 && pixels + size > ADOPT_PIXELS_PER_FRAME) {
+				scheduleTick();
+				return;
+			}
+			pixels += size;
+			arrivals.delete(key);
+			for (const id of scene?.holders(key) ?? []) {
+				staleIds.add(id);
+				naturalIds.add(id);
+			}
+		}
+	}
+	let lastCenter = null;
+	function loadFocus(center, camera) {
+		const time = performance.now();
+		const previous = lastCenter;
+		lastCenter = {
+			...center,
+			time
+		};
+		const elapsed = previous ? time - previous.time : 0;
+		if (!previous || elapsed <= 0 || elapsed > 100) return center;
+		const lead = LOAD_LEAD_MS / elapsed;
+		const reach = Math.max(surface.width, surface.height) / 2 / camera.zoom;
+		const ahead = (from, to) => to + Math.max(-reach, Math.min(reach, (to - from) * lead));
+		return worldPoint(ahead(previous.x, center.x), ahead(previous.y, center.y));
+	}
 	const naturalIds = /* @__PURE__ */ new Set();
 	let liveVersion = -1;
 	function adoptNaturalSizes() {
@@ -237,11 +283,12 @@ function mountBoardStage(host, options) {
 			hoveredId: editor.hoverId,
 			resizingIds: interaction.type === "resizing" ? new Set(interaction.origin.keys()) : /* @__PURE__ */ new Set(),
 			liftedIds: liftedIds(),
+			editingId: editor.editingId,
 			palette: current.palette,
 			colors: current.colors,
 			colorScheme: current.colorScheme,
 			style: styleOf(current),
-			themeKey: current.key,
+			themeKey: `${current.key}:${fontEpoch}`,
 			rendererType: app?.renderer.type === RendererType.CANVAS ? "canvas" : "gpu",
 			zoom: renderCamera().zoom,
 			textResolution: textResolution.value,
@@ -636,6 +683,9 @@ function mountBoardStage(host, options) {
 		world.position.set(camera.x, camera.y);
 		world.scale.set(camera.zoom);
 		const ids = visibleIds();
+		const center = pointToWorld(screenPoint(surface.width / 2, surface.height / 2), camera);
+		assets.focus(loadFocus(center, camera));
+		adoptArrivals();
 		textResolution.update(textureScale());
 		const context = renderContext(current, renderScene, frame.time);
 		if (animationId && effectSampler) {
@@ -646,6 +696,10 @@ function mountBoardStage(host, options) {
 		for (const item of renderScene.items) if (item.type === "effect" && item.props.kind === "trail" && renderScene.opacity(item.id) > 0) pinnedIds.add(item.id);
 		for (const id of previews.keys()) pinnedIds.add(id);
 		if (editor.editingId) pinnedIds.add(editor.editingId);
+		if (editor.editingId !== shownEditingId) {
+			for (const id of [shownEditingId, editor.editingId]) if (id) staleIds.add(id);
+			shownEditingId = editor.editingId;
+		}
 		for (const id of frame.items.keys()) {
 			pinnedIds.add(id);
 			for (const child of renderScene.descendants(id)) pinnedIds.add(child);
@@ -659,12 +713,17 @@ function mountBoardStage(host, options) {
 			getItem: (id) => renderScene.get(id) ?? null,
 			visibleIds: ids,
 			pinnedIds,
-			globalSig: [cardEpoch, current.key].join("|"),
+			globalSig: [
+				cardEpoch,
+				current.key,
+				fontEpoch
+			].join("|"),
 			staleIds,
 			structureVersion: editor.structureVersion,
-			geometryVersion: editor.geometryVersion,
 			gestureActive: editor.gestureActive && editor.interaction.type !== "panning",
-			focus: pointToWorld(screenPoint(surface.width / 2, surface.height / 2), camera)
+			focus: center,
+			view: ids ? cullView(camera) : void 0,
+			lod: options.lod?.()
 		});
 		staleIds.clear();
 		if (scene.liveVersion !== liveVersion) {
@@ -855,13 +914,14 @@ function mountBoardStage(host, options) {
 		["dblclick", handleDoubleClick]
 	];
 	const stopEditor = editor.subscribe(LIVE_CHANNELS, scheduleTick);
+	const stopFonts = onBoardTextFontsChange(() => {
+		editor.relayoutText();
+		fontEpoch += 1;
+		scene?.redrawText();
+		scheduleTick();
+	});
 	const stopAssets = assets.subscribe((key) => {
-		const ids = scene?.holders(key);
-		if (!ids?.size) return;
-		for (const id of ids) {
-			staleIds.add(id);
-			naturalIds.add(id);
-		}
+		arrivals.add(key);
 		scheduleTick();
 	});
 	const resizeObserver = new ResizeObserver((entries) => {
@@ -1004,6 +1064,18 @@ function mountBoardStage(host, options) {
 			scheduleTick();
 		},
 		isMaterialized: (id) => Boolean(scene?.getNode(id)),
+		stats() {
+			const { textures, cooling, bytes } = assets.stats();
+			return {
+				...scene?.counts() ?? {
+					live: 0,
+					far: 0
+				},
+				textures,
+				cooling,
+				textureBytes: bytes
+			};
+		},
 		toWorld: (clientX, clientY) => pointToWorld(localPoint(clientX, clientY), renderCamera()),
 		destroy() {
 			disposed = true;
@@ -1018,6 +1090,7 @@ function mountBoardStage(host, options) {
 			stopMaintenance?.();
 			stopDensity?.();
 			stopEditor();
+			stopFonts();
 			stopAssets();
 			resizeObserver.disconnect();
 			cancelAnimationFrame(scriptTickFrame);

package/dist/board/stage/texture-pool.d.ts

@@ -7,6 +7,13 @@ type BoardImageTexturePool = {
 /** A CDN variant that fails to process falls back to the media it came from. */
 declare function loadBoardImageTexture(url: string): Promise<Texture>;
 declare function unloadBoardImageTexture(url: string, texture: Texture | null): Promise<void>;
+/**
+ * Decode an image no larger than `edge` along its long side, for sources
+ * without CDN variants. The texture is unshared; destroy it to release it.
+ */
+declare function loadFittedImageTexture(url: string, edge: number): Promise<Texture>;
+/** A smaller unshared copy of a decoded texture, or null when it cannot be read back. */
+declare function shrinkBoardTexture(texture: Texture, edge: number): Promise<Texture | null>;
 /**
  * Share image textures by resolved URL without sharing Board ownership.
  *
@@ -21,4 +28,4 @@ declare function createBoardImageTexturePool(options?: {
 }): BoardImageTexturePool;
 declare const boardImageTexturePool: BoardImageTexturePool;
 //#endregion
-export { BoardImageTexturePool, boardImageTexturePool, createBoardImageTexturePool, loadBoardImageTexture, unloadBoardImageTexture };
+export { BoardImageTexturePool, boardImageTexturePool, createBoardImageTexturePool, loadBoardImageTexture, loadFittedImageTexture, shrinkBoardTexture, unloadBoardImageTexture };

package/dist/board/stage/texture-pool.js

@@ -62,6 +62,42 @@ async function unloadBoardImageTexture(url, texture) {
 	await Assets.unload(url).catch(() => {});
 	if (!texture?.destroyed) texture?.destroy(true);
 }
+function fit(width, height, edge) {
+	const scale = edge / Math.max(width, height);
+	return scale < 1 ? {
+		resizeWidth: Math.max(1, Math.round(width * scale)),
+		resizeHeight: Math.max(1, Math.round(height * scale))
+	} : null;
+}
+/**
+* Decode an image no larger than `edge` along its long side, for sources
+* without CDN variants. The texture is unshared; destroy it to release it.
+*/
+async function loadFittedImageTexture(url, edge) {
+	const response = await fetch(url);
+	if (!response.ok) throw new Error(`HTTP ${response.status}`);
+	const image = await createImageBitmap(await response.blob());
+	const size = fit(image.width, image.height, edge);
+	if (!size) return Texture.from(image, true);
+	try {
+		return Texture.from(await createImageBitmap(image, {
+			...size,
+			resizeQuality: "high"
+		}), true);
+	} finally {
+		image.close();
+	}
+}
+/** A smaller unshared copy of a decoded texture, or null when it cannot be read back. */
+async function shrinkBoardTexture(texture, edge) {
+	const resource = texture.source.resource;
+	const size = fit(texture.width, texture.height, edge);
+	if (!resource || !size || typeof createImageBitmap !== "function") return null;
+	return Texture.from(await createImageBitmap(resource, {
+		...size,
+		resizeQuality: "medium"
+	}), true);
+}
 /**
 * Share image textures by resolved URL without sharing Board ownership.
 *
@@ -150,4 +186,4 @@ function createBoardImageTexturePool(options) {
 }
 const boardImageTexturePool = createBoardImageTexturePool();
 //#endregion
-export { boardImageTexturePool, createBoardImageTexturePool, loadBoardImageTexture, unloadBoardImageTexture };
+export { boardImageTexturePool, createBoardImageTexturePool, loadBoardImageTexture, loadFittedImageTexture, shrinkBoardTexture, unloadBoardImageTexture };

package/dist/index.js

@@ -865,6 +865,128 @@ function boardJsonEquals(a, b) {
 	return keys.length === Object.keys(bRecord).length && keys.every((key) => Object.hasOwn(bRecord, key) && boardJsonEquals(aRecord[key], bRecord[key]));
 }
 //#endregion
+//#region ../protocol/dist/generation/blocks.js
+const EXCERPT_LIMIT = 240;
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
+	if (typeof value !== "string") return void 0;
+	const clean = value.replace(/\s+/g, " ").trim();
+	if (!clean) return void 0;
+	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
+}
+function blockText(block) {
+	return cleanExcerpt(block.text ?? block.content ?? block.value);
+}
+function blockUrl(block) {
+	const source = asRecord(block.source);
+	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
+}
+function blockMimeType(block) {
+	const source = asRecord(block.source);
+	const value = source?.mediaType ?? source?.media_type ?? source?.mimeType ?? block.mediaType ?? block.media_type ?? block.mimeType;
+	return typeof value === "string" ? value : void 0;
+}
+function positiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function blockNaturalSize(block) {
+	const source = asRecord(block.source);
+	const naturalWidth = positiveNumber(source?.width ?? source?.naturalWidth ?? block.width ?? block.naturalWidth);
+	const naturalHeight = positiveNumber(source?.height ?? source?.naturalHeight ?? block.height ?? block.naturalHeight);
+	return {
+		...naturalWidth ? { naturalWidth } : {},
+		...naturalHeight ? { naturalHeight } : {}
+	};
+}
+function contentBlocks(value) {
+	return Array.isArray(value) ? value.filter((item) => asRecord(item)) : [];
+}
+function taskData(run) {
+	const payload = asRecord(run.payload);
+	return asRecord(payload?.data) ?? payload;
+}
+function generationOutput(run) {
+	return contentBlocks(asRecord(run.result)?.output);
+}
+function generationPrompt(run) {
+	for (const block of contentBlocks(taskData(run)?.content)) {
+		const text = blockText(block);
+		if (text) return text;
+	}
+}
+function blockMeta(block) {
+	return asRecord(block.meta);
+}
+function blockIdentity(block) {
+	const meta = blockMeta(block);
+	const value = meta?.id ?? meta?.clip_id ?? meta?.clipId ?? block.id ?? block.clip_id ?? block.clipId;
+	if (typeof value !== "string" && typeof value !== "number") return void 0;
+	return cleanExcerpt(String(value), 220);
+}
+function blockTitle(block) {
+	return cleanExcerpt(blockMeta(block)?.title ?? block.title ?? block.name, 240);
+}
+function blockDurationMs(block) {
+	const source = asRecord(block.source);
+	const meta = blockMeta(block);
+	const milliseconds = positiveNumber(source?.durationMs ?? meta?.durationMs ?? block.durationMs);
+	if (milliseconds) return Math.round(milliseconds);
+	const seconds = positiveNumber(source?.duration ?? meta?.duration ?? block.duration);
+	return seconds ? Math.round(seconds * 1e3) : void 0;
+}
+function blockPreviewUrl(block) {
+	const source = asRecord(block.source);
+	return normalizeBoardRemoteUrl(source?.poster ?? source?.thumbnail ?? source?.previewUrl ?? block.poster ?? block.thumbnail ?? block.previewUrl);
+}
+/**
+* Image roles that depict playable media, by the media types they may cover;
+* `last_frame` stays a result of its own.
+*/
+const COVER_ROLES = /* @__PURE__ */ new Map([
+	["first_frame", /* @__PURE__ */ new Set(["video"])],
+	["cover", /* @__PURE__ */ new Set(["video", "audio"])],
+	["poster", /* @__PURE__ */ new Set(["video", "audio"])],
+	["thumbnail", /* @__PURE__ */ new Set(["video", "audio"])]
+]);
+function isPlayable(block) {
+	return block.type === "video" || block.type === "audio";
+}
+/**
+* Pair playable media with its cover image, returning media index → cover
+* index. An image sharing the provider id wins (music tracks and their art,
+* shared by every media of that id); otherwise cover-role images pair in
+* order with remaining media their role fits (a video and its `first_frame`).
+* Covers need a remote URL, so an inline image is never folded away.
+*/
+function generationCovers(blocks) {
+	const covers = /* @__PURE__ */ new Map();
+	const isCover = (block) => block.type === "image" && blockUrl(block) !== void 0 && blockMeta(block)?.role !== "last_frame";
+	blocks.forEach((block, index) => {
+		const id = blockIdentity(block);
+		if (!isPlayable(block) || id === void 0) return;
+		const cover = blocks.findIndex((candidate) => isCover(candidate) && blockIdentity(candidate) === id);
+		if (cover >= 0) covers.set(index, cover);
+	});
+	const paired = new Set(covers.values());
+	const roleCovers = blocks.flatMap((block, index) => {
+		const role = blockMeta(block)?.role;
+		const types = typeof role === "string" ? COVER_ROLES.get(role) : void 0;
+		return isCover(block) && !paired.has(index) && types ? [{
+			index,
+			types
+		}] : [];
+	});
+	blocks.forEach((block, index) => {
+		if (!isPlayable(block) || covers.has(index)) return;
+		const at = roleCovers.findIndex(({ types }) => types.has(String(block.type)));
+		const [cover] = at < 0 ? [] : roleCovers.splice(at, 1);
+		if (cover) covers.set(index, cover.index);
+	});
+	return covers;
+}
+//#endregion
 //#region ../protocol/dist/board-layout.js
 const IDENTITY_MATRIX = [
 	1,
@@ -927,8 +1049,14 @@ function estimateTextWidth(text, fontSize) {
 	}
 	return ems * fontSize;
 }
-function measureLine(text, fontSize, fontWeight, font) {
-	return 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 [""];
@@ -957,13 +1085,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 } = 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
@@ -1918,128 +2048,6 @@ function parseBoardDocument(input) {
 	} : result;
 }
 //#endregion
-//#region ../protocol/dist/generation/blocks.js
-const EXCERPT_LIMIT = 240;
-function asRecord(value) {
-	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
-}
-function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
-	if (typeof value !== "string") return void 0;
-	const clean = value.replace(/\s+/g, " ").trim();
-	if (!clean) return void 0;
-	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
-}
-function blockText(block) {
-	return cleanExcerpt(block.text ?? block.content ?? block.value);
-}
-function blockUrl(block) {
-	const source = asRecord(block.source);
-	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
-}
-function blockMimeType(block) {
-	const source = asRecord(block.source);
-	const value = source?.mediaType ?? source?.media_type ?? source?.mimeType ?? block.mediaType ?? block.media_type ?? block.mimeType;
-	return typeof value === "string" ? value : void 0;
-}
-function positiveNumber(value) {
-	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
-}
-function blockNaturalSize(block) {
-	const source = asRecord(block.source);
-	const naturalWidth = positiveNumber(source?.width ?? source?.naturalWidth ?? block.width ?? block.naturalWidth);
-	const naturalHeight = positiveNumber(source?.height ?? source?.naturalHeight ?? block.height ?? block.naturalHeight);
-	return {
-		...naturalWidth ? { naturalWidth } : {},
-		...naturalHeight ? { naturalHeight } : {}
-	};
-}
-function contentBlocks(value) {
-	return Array.isArray(value) ? value.filter((item) => asRecord(item)) : [];
-}
-function taskData(run) {
-	const payload = asRecord(run.payload);
-	return asRecord(payload?.data) ?? payload;
-}
-function generationOutput(run) {
-	return contentBlocks(asRecord(run.result)?.output);
-}
-function generationPrompt(run) {
-	for (const block of contentBlocks(taskData(run)?.content)) {
-		const text = blockText(block);
-		if (text) return text;
-	}
-}
-function blockMeta(block) {
-	return asRecord(block.meta);
-}
-function blockIdentity(block) {
-	const meta = blockMeta(block);
-	const value = meta?.id ?? meta?.clip_id ?? meta?.clipId ?? block.id ?? block.clip_id ?? block.clipId;
-	if (typeof value !== "string" && typeof value !== "number") return void 0;
-	return cleanExcerpt(String(value), 220);
-}
-function blockTitle(block) {
-	return cleanExcerpt(blockMeta(block)?.title ?? block.title ?? block.name, 240);
-}
-function blockDurationMs(block) {
-	const source = asRecord(block.source);
-	const meta = blockMeta(block);
-	const milliseconds = positiveNumber(source?.durationMs ?? meta?.durationMs ?? block.durationMs);
-	if (milliseconds) return Math.round(milliseconds);
-	const seconds = positiveNumber(source?.duration ?? meta?.duration ?? block.duration);
-	return seconds ? Math.round(seconds * 1e3) : void 0;
-}
-function blockPreviewUrl(block) {
-	const source = asRecord(block.source);
-	return normalizeBoardRemoteUrl(source?.poster ?? source?.thumbnail ?? source?.previewUrl ?? block.poster ?? block.thumbnail ?? block.previewUrl);
-}
-/**
-* Image roles that depict playable media, by the media types they may cover;
-* `last_frame` stays a result of its own.
-*/
-const COVER_ROLES = /* @__PURE__ */ new Map([
-	["first_frame", /* @__PURE__ */ new Set(["video"])],
-	["cover", /* @__PURE__ */ new Set(["video", "audio"])],
-	["poster", /* @__PURE__ */ new Set(["video", "audio"])],
-	["thumbnail", /* @__PURE__ */ new Set(["video", "audio"])]
-]);
-function isPlayable(block) {
-	return block.type === "video" || block.type === "audio";
-}
-/**
-* Pair playable media with its cover image, returning media index → cover
-* index. An image sharing the provider id wins (music tracks and their art,
-* shared by every media of that id); otherwise cover-role images pair in
-* order with remaining media their role fits (a video and its `first_frame`).
-* Covers need a remote URL, so an inline image is never folded away.
-*/
-function generationCovers(blocks) {
-	const covers = /* @__PURE__ */ new Map();
-	const isCover = (block) => block.type === "image" && blockUrl(block) !== void 0 && blockMeta(block)?.role !== "last_frame";
-	blocks.forEach((block, index) => {
-		const id = blockIdentity(block);
-		if (!isPlayable(block) || id === void 0) return;
-		const cover = blocks.findIndex((candidate) => isCover(candidate) && blockIdentity(candidate) === id);
-		if (cover >= 0) covers.set(index, cover);
-	});
-	const paired = new Set(covers.values());
-	const roleCovers = blocks.flatMap((block, index) => {
-		const role = blockMeta(block)?.role;
-		const types = typeof role === "string" ? COVER_ROLES.get(role) : void 0;
-		return isCover(block) && !paired.has(index) && types ? [{
-			index,
-			types
-		}] : [];
-	});
-	blocks.forEach((block, index) => {
-		if (!isPlayable(block) || covers.has(index)) return;
-		const at = roleCovers.findIndex(({ types }) => types.has(String(block.type)));
-		const [cover] = at < 0 ? [] : roleCovers.splice(at, 1);
-		if (cover) covers.set(index, cover.index);
-	});
-	return covers;
-}
-//#endregion
 //#region ../protocol/dist/turn-origin.js
 const record$1 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 const normalizeSessionTurnOrigin = (value) => {

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 };