@neta-art/cohub 11.5.1 → 12.1.0

package/dist/board/model/items/index.d.ts

@@ -1,6 +1,6 @@
 import { BoardItemCapabilities, BoardItemDefinition, BoardItemOf, BoardItemResizeMode, FULL_CAPABILITIES, defineBoardItem } from "./definition.js";
 import { builtinBoardItems } from "./builtin.js";
-import { BoardAppMetadata, BoardItemEntry, BoardMediaItemKind, boardItemOrigin, boardOriginKey, createAppBoardItem, createArrowBoardItem, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, mediaFrameSize, titleForBoardItem } from "./create.js";
+import { BoardAppMetadata, BoardItemEntry, BoardMediaItemKind, boardItemOrigin, boardOriginKey, boardTaskCardSize, createAppBoardItem, createArrowBoardItem, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, mediaFrameSize, titleForBoardItem } from "./create.js";
 import { createBoardEntityId, createBoardItemId } from "./id.js";
 import { BoardItemInput, BoardRegistry, createBoardRegistry, defaultBoardRegistry } from "./registry.js";
-export { BoardAppMetadata, BoardItemCapabilities, BoardItemDefinition, BoardItemEntry, BoardItemInput, BoardItemOf, BoardItemResizeMode, BoardMediaItemKind, BoardRegistry, FULL_CAPABILITIES, boardItemOrigin, boardOriginKey, builtinBoardItems, createAppBoardItem, createArrowBoardItem, createBoardEntityId, createBoardItemId, createBoardRegistry, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, mediaFrameSize, titleForBoardItem };
+export { BoardAppMetadata, BoardItemCapabilities, BoardItemDefinition, BoardItemEntry, BoardItemInput, BoardItemOf, BoardItemResizeMode, BoardMediaItemKind, BoardRegistry, FULL_CAPABILITIES, boardItemOrigin, boardOriginKey, boardTaskCardSize, builtinBoardItems, createAppBoardItem, createArrowBoardItem, createBoardEntityId, createBoardItemId, createBoardRegistry, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, mediaFrameSize, titleForBoardItem };

package/dist/board/model/items/index.js

@@ -1,6 +1,6 @@
 import { FULL_CAPABILITIES, defineBoardItem } from "./definition.js";
 import { builtinBoardItems } from "./builtin.js";
 import { createBoardEntityId, createBoardItemId } from "./id.js";
-import { boardItemOrigin, boardOriginKey, createAppBoardItem, createArrowBoardItem, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, mediaFrameSize, titleForBoardItem } from "./create.js";
+import { boardItemOrigin, boardOriginKey, boardTaskCardSize, createAppBoardItem, createArrowBoardItem, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, mediaFrameSize, titleForBoardItem } from "./create.js";
 import { createBoardRegistry, defaultBoardRegistry } from "./registry.js";
-export { FULL_CAPABILITIES, boardItemOrigin, boardOriginKey, builtinBoardItems, createAppBoardItem, createArrowBoardItem, createBoardEntityId, createBoardItemId, createBoardRegistry, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, mediaFrameSize, titleForBoardItem };
+export { FULL_CAPABILITIES, boardItemOrigin, boardOriginKey, boardTaskCardSize, builtinBoardItems, createAppBoardItem, createArrowBoardItem, createBoardEntityId, createBoardItemId, createBoardRegistry, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, mediaFrameSize, titleForBoardItem };

package/dist/board/model/items/registry.js

@@ -1,13 +1,10 @@
+import { boardDefaultSize } from "../../../protocol/dist/board-constants.js";
 import { hasAuthoredSize, parseBoardItem } from "../../../protocol/dist/board-model.js";
 import { frameContainsPoint, itemBounds } from "../geometry.js";
 import { FULL_CAPABILITIES } from "./definition.js";
 import { builtinBoardItems } from "./builtin.js";
 import { createBoardItemId } from "./id.js";
 //#region src/board/model/items/registry.ts
-const DEFAULT_ITEM_SIZE = {
-	width: 240,
-	height: 160
-};
 function createBoardRegistry(definitions = []) {
 	const byType = /* @__PURE__ */ new Map();
 	for (const definition of [...builtinBoardItems, ...definitions]) byType.set(definition.type, definition);
@@ -52,7 +49,7 @@ function createBoardRegistry(definitions = []) {
 		create(type, { props = {}, at, size, id = createBoardItemId() }) {
 			const valid = validateProps(type, props);
 			if (!valid.ok) throw new Error(valid.message);
-			const box = size ?? byType.get(type)?.size ?? DEFAULT_ITEM_SIZE;
+			const box = size ?? byType.get(type)?.size ?? boardDefaultSize(type);
 			const placement = hasAuthoredSize(type) ? {
 				position: {
 					x: at.x - box.width / 2,

package/dist/board/model/json.d.ts

@@ -0,0 +1,4 @@
+//#region src/board/model/json.d.ts
+declare function sameJson(a: unknown, b: unknown): boolean;
+//#endregion
+export { sameJson };

package/dist/board/model/json.js

@@ -0,0 +1,22 @@
+//#region src/board/model/json.ts
+function sameJson(a, b) {
+	if (a === b) return true;
+	if (!a || !b || typeof a !== "object" || typeof b !== "object") return false;
+	if (Array.isArray(a) || Array.isArray(b)) {
+		if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+		for (let index = 0; index < a.length; index += 1) if (!sameJson(a[index], b[index])) return false;
+		return true;
+	}
+	const left = a;
+	const right = b;
+	let members = 0;
+	for (const key of Object.keys(left)) {
+		if (left[key] === void 0) continue;
+		members += 1;
+		if (!sameJson(left[key], right[key])) return false;
+	}
+	for (const key of Object.keys(right)) if (right[key] !== void 0) members -= 1;
+	return members === 0;
+}
+//#endregion
+export { sameJson };

package/dist/board/model/media-playback.d.ts

@@ -1,8 +1,11 @@
 import { BoardSceneItem } from "./scene.js";
 //#region src/board/model/media-playback.d.ts
+type BoardAssetUrlOptions = {
+  fresh?: boolean;
+};
 type BoardAssetSource = {
-  resolveFileUrl: (path: string) => Promise<string | null>;
-  resolvePlaybackUrl?: (path: string) => Promise<string | null>;
+  resolveFileUrl: (path: string, options?: BoardAssetUrlOptions) => Promise<string | null>;
+  resolvePlaybackUrl?: (path: string, options?: BoardAssetUrlOptions) => Promise<string | null>;
 };
 declare function resolveBoardMediaUrl(src: string, source: BoardAssetSource, purpose?: "preview" | "playback"): Promise<string | null>;
 type BoardPlayableMedia = {
@@ -17,4 +20,4 @@ declare function playableBoardMediaList(item: BoardSceneItem | null, assetSource
 declare function playableBoardMedia(item: BoardSceneItem | null, assetSource: BoardAssetSource, artifactId?: string | null): BoardPlayableMedia | null;
 declare function resetBoardPlaybackUrlCache(): void;
 //#endregion
-export { BoardAssetSource, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl };
+export { BoardAssetSource, BoardAssetUrlOptions, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl };

package/dist/board/player/index.d.ts

@@ -10,7 +10,11 @@ type BoardPlayerFrame = {
   playbackTime: number | null;
   running: boolean;
 };
-declare function playbackTimeAt(playback: BoardPlaybackSnapshot, document: BoardDocument, now: number): number | null;
+type BoardPlaybackClock = {
+  time: number | null;
+  advancing: boolean;
+};
+declare function playbackClockAt(playback: BoardPlaybackSnapshot, document: BoardDocument, now: number): BoardPlaybackClock;
 declare function createBoardPlayer(options?: {
   resolveColor?: BoardColorResolver;
 }): {
@@ -21,4 +25,4 @@ declare function createBoardPlayer(options?: {
 type BoardPlayer = ReturnType<typeof createBoardPlayer>;
 declare function nextLocalPlayback(current: BoardPlaybackSnapshot | null, command: BoardPlaybackCommand, document: BoardDocument, now?: number): BoardPlaybackSnapshot | null;
 //#endregion
-export { BoardPlayer, BoardPlayerFrame, createBoardPlayer, nextLocalPlayback, playbackTimeAt };
+export { BoardPlaybackClock, BoardPlayer, BoardPlayerFrame, createBoardPlayer, nextLocalPlayback, playbackClockAt };

package/dist/board/player/index.js

@@ -5,16 +5,35 @@ import { createBoardEntityId } from "../model/items/id.js";
 const ENTER_ANIMATION = "\0enter";
 const ENTER_STAGGER_MS = 45;
 const ENTER_MAX_ITEMS = 80;
-function playbackTimeAt(playback, document, now) {
+const SETTLED = {
+	time: null,
+	advancing: false
+};
+function playbackClockAt(playback, document, now) {
 	const animation = document.animations[playback.animationId];
-	if (!animation || playback.status === "stopped") return null;
-	if (playback.status !== "playing") return Math.min(playback.position, animation.duration);
-	let position = playback.position + Math.max(0, now - playback.effectiveAt) * playback.timeScale;
+	if (!animation || playback.status === "stopped") return SETTLED;
+	if (playback.status !== "playing") return {
+		time: Math.min(playback.position, animation.duration),
+		advancing: false
+	};
+	const position = playback.position + Math.max(0, now - playback.effectiveAt) * playback.timeScale;
 	const pause = animation.markers.find((marker) => marker.pause && marker.at > playback.position && marker.at <= position);
-	if (pause) return pause.at;
-	if (animation.loop || animation.play === "always") return animation.duration > 0 ? position % animation.duration : 0;
-	position = Math.min(position, animation.duration);
-	return animation.end === "reset" && position >= animation.duration ? null : position;
+	if (pause) return {
+		time: pause.at,
+		advancing: false
+	};
+	if (animation.loop || animation.play === "always") return {
+		time: position % animation.duration,
+		advancing: true
+	};
+	if (position < animation.duration) return {
+		time: position,
+		advancing: true
+	};
+	return {
+		time: animation.end === "reset" ? null : animation.duration,
+		advancing: false
+	};
 }
 function createBoardPlayer(options = {}) {
 	let document = null;
@@ -89,11 +108,10 @@ function createBoardPlayer(options = {}) {
 			}
 			let playbackTime = null;
 			if (playback && playback.animationId !== exclude) {
-				playbackTime = playbackTimeAt(playback, current, wallNow);
-				if (playbackTime !== null) {
-					times.set(playback.animationId, playbackTime);
-					if (playback.status === "playing") running = true;
-				}
+				const clock = playbackClockAt(playback, current, wallNow);
+				playbackTime = clock.time;
+				if (playbackTime !== null) times.set(playback.animationId, playbackTime);
+				if (clock.advancing) running = true;
 			}
 			if (entrance) {
 				times.set(ENTER_ANIMATION, now - entrance.startedAt);
@@ -111,7 +129,7 @@ function createBoardPlayer(options = {}) {
 	};
 }
 function nextLocalPlayback(current, command, document, now = Date.now()) {
-	const position = current ? playbackTimeAt(current, document, now) ?? 0 : 0;
+	const position = current ? playbackClockAt(current, document, now).time ?? 0 : 0;
 	const base = {
 		effectiveAt: now,
 		commandId: command.commandId,
@@ -159,4 +177,4 @@ function nextLocalPlayback(current, command, document, now = Date.now()) {
 	}
 }
 //#endregion
-export { createBoardPlayer, nextLocalPlayback, playbackTimeAt };
+export { createBoardPlayer, nextLocalPlayback, playbackClockAt };

package/dist/board/render/card-tag.d.ts

@@ -11,7 +11,6 @@ type CardTag = {
   icon: Graphics;
   text: Text | null;
   sig: string;
-  resolution: number;
   width: number;
 };
 declare function createCardTag(): CardTag;

package/dist/board/render/card-tag.js

@@ -1,5 +1,5 @@
 import { fitTextToWidth } from "./text-fit.js";
-import { syncTextResolution, textResolutionForZoom } from "./text-resolution.js";
+import { syncTextResolution } from "./text-resolution.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/card-tag.ts
 const CARD_TAG_SIZE = 11;
@@ -177,13 +177,15 @@ function createCardTag() {
 		icon,
 		text: null,
 		sig: "",
-		resolution: 0,
 		width: 0
 	};
 }
+function tagScale(zoom) {
+	return Math.min(MAX_GROWTH, Math.max(1, 1 / Math.max(zoom, .01)));
+}
 function zoomCardTag(tag, zoom) {
 	if (!tag.text || !tag.sig) return;
-	const scale = Math.min(MAX_GROWTH, Math.max(1, 1 / Math.max(zoom, .01)));
+	const scale = tagScale(zoom);
 	const span = 17 + tag.text.width;
 	tag.root.scale.set(scale);
 	tag.root.position.set(0, -18 * scale);
@@ -197,7 +199,6 @@ function syncCardTag(tag, input, context) {
 		return;
 	}
 	if (!tag.text) {
-		tag.resolution = textResolutionForZoom(context.zoom);
 		tag.text = new Text({
 			text: "",
 			style: {
@@ -205,30 +206,27 @@ function syncCardTag(tag, input, context) {
 				fontSize: 11,
 				fontWeight: "500"
 			},
-			resolution: tag.resolution,
 			roundPixels: true
 		});
 		tag.root.addChild(tag.text);
 	}
-	syncTextResolution(tag.text, tag, context.zoom);
 	const sig = [
 		input.glyph,
 		input.text,
 		input.width,
 		context.themeKey
 	].join("|");
-	if (sig === tag.sig) {
-		zoomCardTag(tag, context.zoom);
-		return;
+	if (sig !== tag.sig) {
+		tag.sig = sig;
+		const color = context.palette.muted;
+		const pixel = context.style.icons === "pixel";
+		drawCardGlyph(tag.icon.clear(), input.glyph, color, pixel);
+		tag.text.style.fill = color;
+		tag.text.style.fontFamily = context.style.font;
+		fitTextToWidth(tag.text, input.text, Math.max(1, input.width - ICON - GAP));
+		tag.text.position.set(17, (ICON - tag.text.height) / 2);
 	}
-	tag.sig = sig;
-	const color = context.palette.muted;
-	const pixel = context.style.icons === "pixel";
-	drawCardGlyph(tag.icon.clear(), input.glyph, color, pixel);
-	tag.text.style.fill = color;
-	tag.text.style.fontFamily = context.style.font;
-	fitTextToWidth(tag.text, input.text, Math.max(1, input.width - ICON - GAP));
-	tag.text.position.set(17, (ICON - tag.text.height) / 2);
+	syncTextResolution(tag.text, context.textResolution * tagScale(context.zoom));
 	zoomCardTag(tag, context.zoom);
 }
 //#endregion

package/dist/board/render/index.d.ts

@@ -11,10 +11,10 @@ import { defaultBoardPalette, itemAlpha, itemColor } from "./palette.js";
 import { BoardScriptHostOptions, BrowserBoardScriptHost, createBoardScriptHost } from "./script-host.js";
 import { prepareBrowserBoardScripts } from "./script-export.js";
 import { dashPattern, endAngle, roundRectPoints, traceArrowhead, tracePolyline, trimPolyline } from "./stroke.js";
-import { CardElevation, CardRect, CardSurface, PIXEL_STEP, cardElevation, cardOutlinePoints, cardShadow, containRect, drawCardShadow, drawCardSurface, isBoardCard, traceCardOutline, tracePixelRect } from "./surface.js";
+import { CardCrop, CardElevation, CardRect, CardSurface, PIXEL_STEP, cardElevation, cardOutlinePoints, cardShadow, containRect, drawCardShadow, drawCardSurface, fillCardPicture, isBoardCard, traceCardOutline, tracePixelRect } from "./surface.js";
 import { BOARD_EFFECT_MAX_PARTICLES } from "./renderers/effect-card-renderer.js";
 import { ellipsizeWrappedLines, fitLineWithEllipsis, fitTextToLines, fitTextToWidth } from "./text-fit.js";
 import { BOARD_FONT_STACKS, ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
-import { boardCardDetailed, getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
+import { boardCardDetailed, boardTextResolution, getBoardResolution, syncTextResolution, syncTextWrapWidth, textZoomBucket } from "./text-resolution.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, BoardBackgroundContext, BoardCardRenderer, BoardCardRendererResolver, BoardCssPaint, BoardMediaAction, BoardRenderContext, BoardRenderDiagnostic, BoardRenderLabels, BoardRenderPalette, BoardRenderStyle, BoardScriptHost, BoardScriptHostOptions, BoardSelectionStyle, BoardShadowStyle, BrowserBoardScriptHost, CARD_TAG_SIZE, CardElevation, CardGlyph, CardRect, CardSurface, CardTag, ClipGroup, DEFAULT_BOARD_RENDER_LABELS, PIXEL_STEP, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardCardDetailed, boardMediaActionAt, cardElevation, cardOutlinePoints, cardShadow, clippingAncestor, containRect, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, createCardTag, dashPattern, defaultBoardPalette, defaultBoardRenderStyle, drawCardGlyph, drawCardShadow, drawCardSurface, ellipsizeWrappedLines, endAngle, ensureBoardTextMeasurement, fitLineWithEllipsis, fitTextToLines, fitTextToWidth, formatBoardDuration, getBoardCardRenderer, getBoardResolution, inspectBoardItems, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceCardOutline, traceCube, traceFrameOutline, tracePixelRect, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize, zoomCardTag };
+export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, BoardBackgroundContext, BoardCardRenderer, BoardCardRendererResolver, BoardCssPaint, BoardMediaAction, BoardRenderContext, BoardRenderDiagnostic, BoardRenderLabels, BoardRenderPalette, BoardRenderStyle, BoardScriptHost, BoardScriptHostOptions, BoardSelectionStyle, BoardShadowStyle, BrowserBoardScriptHost, CARD_TAG_SIZE, CardCrop, CardElevation, CardGlyph, CardRect, CardSurface, CardTag, ClipGroup, DEFAULT_BOARD_RENDER_LABELS, PIXEL_STEP, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardCardDetailed, boardMediaActionAt, boardTextResolution, cardElevation, cardOutlinePoints, cardShadow, clippingAncestor, containRect, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, createCardTag, dashPattern, defaultBoardPalette, defaultBoardRenderStyle, drawCardGlyph, drawCardShadow, drawCardSurface, ellipsizeWrappedLines, endAngle, ensureBoardTextMeasurement, fillCardPicture, fitLineWithEllipsis, fitTextToLines, fitTextToWidth, formatBoardDuration, getBoardCardRenderer, getBoardResolution, inspectBoardItems, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textZoomBucket, traceArrowhead, traceCardOutline, traceCube, traceFrameOutline, tracePixelRect, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize, zoomCardTag };

package/dist/board/render/index.js

@@ -5,11 +5,11 @@ import { BOARD_FONT_STACKS, ensureBoardTextMeasurement, installBoardTextMeasurem
 import { inspectBoardItems, inspectBoardScene, measureBoardText } from "./diagnostics.js";
 import { createBoardBackground, updateBoardBackground } from "./board-background.js";
 import { ellipsizeWrappedLines, fitLineWithEllipsis, fitTextToLines, fitTextToWidth } from "./text-fit.js";
-import { boardCardDetailed, getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
+import { boardCardDetailed, boardTextResolution, getBoardResolution, syncTextResolution, syncTextWrapWidth, textZoomBucket } from "./text-resolution.js";
 import { CARD_TAG_SIZE, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, traceCube, zoomCardTag } from "./card-tag.js";
 import { clippingAncestor, isClippingFrame, syncClipGroup, traceFrameOutline } from "./clip.js";
 import { dashPattern, endAngle, roundRectPoints, traceArrowhead, tracePolyline, trimPolyline } from "./stroke.js";
-import { PIXEL_STEP, cardElevation, cardOutlinePoints, cardShadow, containRect, drawCardShadow, drawCardSurface, isBoardCard, traceCardOutline, tracePixelRect } from "./surface.js";
+import { PIXEL_STEP, cardElevation, cardOutlinePoints, cardShadow, containRect, drawCardShadow, drawCardSurface, fillCardPicture, isBoardCard, traceCardOutline, tracePixelRect } from "./surface.js";
 import { boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter } from "./media-interaction.js";
 import { BOARD_EFFECT_MAX_PARTICLES } from "./renderers/effect-card-renderer.js";
 import { DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
@@ -17,4 +17,4 @@ import { createBoardScriptHost } from "./script-host.js";
 import { prepareBrowserBoardScripts } from "./script-export.js";
 import { defaultBoardRenderStyle, resolveBoardRenderStyle } from "./style.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, CARD_TAG_SIZE, DEFAULT_BOARD_RENDER_LABELS, PIXEL_STEP, VIDEO_THUMBNAIL_MAX_EDGE, boardCardDetailed, boardMediaActionAt, cardElevation, cardOutlinePoints, cardShadow, clippingAncestor, containRect, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, createCardTag, dashPattern, defaultBoardPalette, defaultBoardRenderStyle, drawCardGlyph, drawCardShadow, drawCardSurface, ellipsizeWrappedLines, endAngle, ensureBoardTextMeasurement, fitLineWithEllipsis, fitTextToLines, fitTextToWidth, formatBoardDuration, getBoardCardRenderer, getBoardResolution, inspectBoardItems, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceCardOutline, traceCube, traceFrameOutline, tracePixelRect, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize, zoomCardTag };
+export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, CARD_TAG_SIZE, DEFAULT_BOARD_RENDER_LABELS, PIXEL_STEP, VIDEO_THUMBNAIL_MAX_EDGE, boardCardDetailed, boardMediaActionAt, boardTextResolution, cardElevation, cardOutlinePoints, cardShadow, clippingAncestor, containRect, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, createCardTag, dashPattern, defaultBoardPalette, defaultBoardRenderStyle, drawCardGlyph, drawCardShadow, drawCardSurface, ellipsizeWrappedLines, endAngle, ensureBoardTextMeasurement, fillCardPicture, fitLineWithEllipsis, fitTextToLines, fitTextToWidth, formatBoardDuration, getBoardCardRenderer, getBoardResolution, inspectBoardItems, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textZoomBucket, traceArrowhead, traceCardOutline, traceCube, traceFrameOutline, tracePixelRect, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize, zoomCardTag };

package/dist/board/render/renderers/arrow-card-renderer.js

@@ -1,7 +1,7 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { pathPointAt, resolveSceneArrow } from "../../model/arrow-geometry.js";
 import { itemAlpha, itemColor } from "../palette.js";
-import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { syncTextResolution } from "../text-resolution.js";
 import { dashPattern, endAngle, traceArrowhead, tracePolyline, trimPolyline } from "../stroke.js";
 import { drawCardSurface } from "../surface.js";
 import { drawFarStroke } from "./far-plate.js";
@@ -18,7 +18,6 @@ function sync(container, item, context) {
 	parts.line.alpha = itemAlpha(context, style.stroke);
 	const color = itemColor(context, style.stroke, "brand");
 	const size = style.strokeWidth ?? 2.5;
-	syncTextResolution(parts.label, parts, context.zoom);
 	const resolved = resolveSceneArrow(item, context.scene);
 	const path = trimPolyline(resolved.path, style.trim);
 	const lineSig = [
@@ -85,6 +84,7 @@ function sync(container, item, context) {
 			border: context.palette.border
 		});
 	}
+	syncTextResolution(parts.label, context.textResolution);
 	const visible = props.label.length > 0 && (style.trim === void 0 || style.trim >= .5);
 	parts.label.visible = visible;
 	parts.backdrop.visible = visible;
@@ -98,7 +98,6 @@ const arrowCardRenderer = {
 	create: (item, context) => {
 		const root = new Container();
 		const line = new Graphics();
-		const resolution = textResolutionForZoom(context.zoom);
 		const label = new Text({
 			text: "",
 			style: {
@@ -107,7 +106,7 @@ const arrowCardRenderer = {
 				fontSize: 14,
 				fontWeight: "500"
 			},
-			resolution,
+			resolution: context.textResolution,
 			roundPixels: true
 		});
 		label.anchor.set(.5);
@@ -119,8 +118,7 @@ const arrowCardRenderer = {
 			backdrop,
 			label,
 			lineSig: "",
-			labelSig: "",
-			resolution
+			labelSig: ""
 		});
 		if (item.type === "arrow") sync(root, item, context);
 		return root;
@@ -128,6 +126,10 @@ const arrowCardRenderer = {
 	update: (container, item, context) => {
 		if (item.type === "arrow") sync(container, item, context);
 	},
+	resolution: (container, _item, context) => {
+		const parts = partsByContainer.get(container);
+		if (parts) syncTextResolution(parts.label, context.textResolution);
+	},
 	renderFar: (graphics, item, context) => {
 		if (item.type !== "arrow") return;
 		const arrow = item;

package/dist/board/render/renderers/audio-card-renderer.js

@@ -1,6 +1,6 @@
 import { getMediaResourceTitle } from "../../model/media.js";
 import { fitTextToWidth } from "../text-fit.js";
-import { boardCardDetailed, syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { boardCardDetailed, syncTextResolution } from "../text-resolution.js";
 import { formatBoardDuration } from "../card-tag.js";
 import { drawAudioWaveform } from "../audio-waveform.js";
 import { cardElevation, drawCardSurface } from "../surface.js";
@@ -25,12 +25,15 @@ function audioKeyCenter(width, height) {
 function sync(container, item, context) {
 	const parts = partsByContainer.get(container);
 	if (!parts) return;
+	syncContent(parts, item, context);
+	syncTextResolution(parts.title, context.textResolution);
+}
+function syncContent(parts, item, context) {
 	positionShell(parts.root, item);
 	const { width, height } = item.frame;
 	const title = item.props.snapshot?.title ?? getMediaResourceTitle(item.props.src);
 	const durationMs = item.props.snapshot?.durationMs;
 	const detailed = boardCardDetailed(context.zoom);
-	syncTextResolution(parts.title, parts, context.zoom);
 	const elevation = cardElevation(context, item.id);
 	const sig = [
 		width,
@@ -83,14 +86,13 @@ const audioCardRenderer = {
 		const root = new Container();
 		const plate = new Graphics();
 		const wave = new Graphics();
-		const resolution = textResolutionForZoom(context.zoom);
 		const title = new Text({
 			text: "",
 			style: {
 				fontSize: 13,
 				fontWeight: "600"
 			},
-			resolution,
+			resolution: context.textResolution,
 			roundPixels: true
 		});
 		root.addChild(plate, wave, title);
@@ -99,8 +101,7 @@ const audioCardRenderer = {
 			plate,
 			wave,
 			title,
-			sig: "",
-			resolution
+			sig: ""
 		});
 		if (item.type === "audio") sync(root, item, context);
 		return root;
@@ -108,6 +109,9 @@ const audioCardRenderer = {
 	update: (container, item, context) => {
 		if (item.type === "audio") sync(container, item, context);
 	},
+	resolution: (container, item, context) => {
+		if (item.type === "audio") sync(container, item, context);
+	},
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
 			fill: context.palette.surface,

package/dist/board/render/renderers/base-card-renderer.d.ts

@@ -2,7 +2,7 @@ import { BoardFrame } from "../../../protocol/dist/board-layout.js";
 import "../../../protocol/dist/index.js";
 import { Container, Text } from "pixi.js";
 //#region src/board/render/renderers/base-card-renderer.d.ts
-declare function createLabel(text: string, style: Record<string, unknown>): Text;
+declare function createLabel(text: string, style: Record<string, unknown>, resolution: number): Text;
 declare function positionShell(root: Container, item: {
   frame: BoardFrame;
 }): void;

package/dist/board/render/renderers/base-card-renderer.js

@@ -1,10 +1,9 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
-import { getBoardResolution } from "../text-resolution.js";
 import { Text } from "pixi.js";
 //#region src/board/render/renderers/base-card-renderer.ts
-function createLabel(text, style) {
+function createLabel(text, style, resolution) {
 	return new Text({
-		resolution: getBoardResolution(),
+		resolution,
 		roundPixels: true,
 		text,
 		style: {

package/dist/board/render/renderers/board-renderer-registry.d.ts

@@ -22,7 +22,7 @@ type BoardScriptHost = {
   document?: (document: BoardDocument, time: number) => BoardDocument;
   ready?: (id: string) => boolean;
   revision?: (id: string) => number;
-  frame: (item: SceneItem<BoardCustomItem>, time: number, resolution: number) => Texture | null;
+  frame: (item: SceneItem<BoardCustomItem>, time: number) => Texture | null;
   error: (id: string) => string | null;
   release: (id: string) => void;
 };
@@ -48,6 +48,8 @@ type BoardRenderContext = {
   themeKey: string;
   rendererType: "gpu" | "canvas";
   zoom: number;
+  /** Texture pixels per world unit for text; see `boardTextResolution`. */
+  textResolution: number;
   time: number;
   reducedMotion: boolean;
   labels: BoardRenderLabels;
@@ -61,7 +63,7 @@ type BoardRenderContext = {
   getTexture: (key: string) => Texture | null;
   hasError: (key: string) => boolean;
   fileState: (path: string) => "ok" | "missing" | "unavailable";
-  acquireTexture: (key: string) => void;
+  acquireTexture: (key: string, item: BoardSceneItem) => void;
   releaseTexture: (key: string) => void;
 };
 type BoardCardRenderer = {
@@ -73,6 +75,8 @@ type BoardCardRenderer = {
   tick?: (container: Container, clock: number) => number | null;
   create: (item: BoardSceneItem, context: BoardRenderContext) => Container;
   update: (container: Container, item: BoardSceneItem, context: BoardRenderContext) => void;
+  /** Called when the zoom bucket or text resolution changes. */
+  resolution?: (container: Container, item: BoardSceneItem, context: BoardRenderContext) => void;
   /** Runs on every zoom step; only update transforms and visibility. */
   zoom?: (container: Container, zoom: number) => void;
   renderFar?: (graphics: Graphics, item: BoardSceneItem, context: BoardRenderContext) => void;

package/dist/board/render/renderers/custom-card-renderer.js

@@ -1,5 +1,5 @@
 import { BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
-import { getBoardResolution, syncTextResolution } from "../text-resolution.js";
+import { syncTextResolution } from "../text-resolution.js";
 import { positionShell } from "./base-card-renderer.js";
 import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Sprite, Text, Texture } from "pixi.js";
@@ -13,10 +13,8 @@ function sync(container, item, context) {
 		parts.id = item.id;
 	}
 	positionShell(parts.root, item);
-	syncTextResolution(parts.label, parts.label, context.zoom);
 	const { width, height } = item.frame;
-	const resolution = Math.min(4, Math.max(.25, context.zoom * getBoardResolution()));
-	const texture = context.scripts?.frame(item, context.time, resolution) ?? null;
+	const texture = context.scripts?.frame(item, context.time) ?? null;
 	const error = context.scripts?.error(item.id) ?? null;
 	parts.sprite.visible = Boolean(texture);
 	const display = texture ?? Texture.EMPTY;
@@ -32,19 +30,21 @@ function sync(container, item, context) {
 		message,
 		context.themeKey
 	].join("|");
-	if (sig === parts.sig) return;
-	parts.sig = sig;
-	parts.placeholder.clear();
-	if (!ready || error) parts.placeholder.rect(0, 0, width, height).stroke({
-		color: context.palette.border,
-		width: 1,
-		alpha: .8
-	});
-	parts.label.visible = !ready || Boolean(error);
-	parts.label.text = message;
-	parts.label.style.fill = error ? context.colors.rose.stroke : context.palette.muted;
-	parts.label.style.wordWrapWidth = Math.max(40, width - 16);
-	parts.label.position.set(width / 2, height / 2);
+	if (sig !== parts.sig) {
+		parts.sig = sig;
+		parts.placeholder.clear();
+		if (!ready || error) parts.placeholder.rect(0, 0, width, height).stroke({
+			color: context.palette.border,
+			width: 1,
+			alpha: .8
+		});
+		parts.label.visible = !ready || Boolean(error);
+		parts.label.text = message;
+		parts.label.style.fill = error ? context.colors.rose.stroke : context.palette.muted;
+		parts.label.style.wordWrapWidth = Math.max(40, width - 16);
+		parts.label.position.set(width / 2, height / 2);
+	}
+	syncTextResolution(parts.label, context.textResolution);
 }
 const customCardRenderer = {
 	id: "custom-card",
@@ -63,7 +63,8 @@ const customCardRenderer = {
 				wordWrap: true,
 				breakWords: true
 			},
-			resolution: getBoardResolution()
+			resolution: context.textResolution,
+			roundPixels: true
 		});
 		label.anchor.set(.5);
 		root.addChild(sprite, placeholder, label);
@@ -81,6 +82,10 @@ const customCardRenderer = {
 	update: (container, item, context) => {
 		if (item.type === "custom") sync(container, item, context);
 	},
+	resolution: (container, _item, context) => {
+		const parts = partsByContainer.get(container);
+		if (parts) syncTextResolution(parts.label, context.textResolution);
+	},
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
 			fill: context.palette.muted,

package/dist/board/render/renderers/file-card-renderer.js

@@ -47,6 +47,14 @@ function syncClip(parts, rect, style) {
 function sync(container, item, context) {
 	const parts = partsByContainer.get(container);
 	if (!parts) return;
+	syncContent(parts, item, context);
+	for (const text of [
+		parts.title,
+		parts.excerpt,
+		parts.typeMark
+	]) syncTextResolution(text, context.textResolution);
+}
+function syncContent(parts, item, context) {
 	positionShell(parts.root, item);
 	const { width, height } = item.frame;
 	const detail = detailFor(context.zoom);
@@ -64,16 +72,13 @@ function sync(container, item, context) {
 	const kind = filePreviewKind(item.props.snapshot);
 	const category = fileCategory(item.props.src, item.props.snapshot?.mimeType);
 	const accent = fileCategoryAccent(category, context.palette);
-	syncTextResolution(parts.title, parts.titleRes, context.zoom);
-	syncTextResolution(parts.excerpt, parts.excerptRes, context.zoom);
-	syncTextResolution(parts.typeMark, parts.typeMarkRes, context.zoom);
 	const visualSig = [
 		key ?? "",
 		width,
 		height,
 		detail,
 		elevation,
-		texture ? `${texture.width}x${texture.height}` : "none",
+		texture?.uid ?? "none",
 		coverFailed,
 		fileState,
 		kind,
@@ -190,7 +195,7 @@ const fileCardRenderer = {
 		const cover = new Sprite(Texture.EMPTY);
 		const coverMask = new Graphics();
 		cover.mask = coverMask;
-		const resolution = 1;
+		const resolution = context.textResolution;
 		const title = new Text({
 			text: "",
 			style: {
@@ -247,10 +252,7 @@ const fileCardRenderer = {
 			title,
 			excerpt,
 			visualSig: "",
-			textSig: "",
-			titleRes: { resolution },
-			excerptRes: { resolution },
-			typeMarkRes: { resolution }
+			textSig: ""
 		});
 		if (item.type === "file") sync(root, item, context);
 		return root;
@@ -258,6 +260,9 @@ const fileCardRenderer = {
 	update: (container, item, context) => {
 		if (item.type === "file") sync(container, item, context);
 	},
+	resolution: (container, item, context) => {
+		if (item.type === "file") sync(container, item, context);
+	},
 	zoom: (container, zoom) => {
 		const tag = partsByContainer.get(container)?.tag;
 		if (tag) zoomCardTag(tag, zoom);