@neta-art/cohub 11.3.0 → 11.3.2

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

@@ -1,9 +1,9 @@
 import { BoardRenderStyle, BoardSelectionStyle, BoardShadowStyle, defaultBoardRenderStyle, resolveBoardRenderStyle } from "./style.js";
 import { BoardCardRenderer, BoardCardRendererResolver, BoardRenderContext, BoardRenderLabels, BoardRenderPalette, BoardScriptHost, DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { createBoardRenderSampler } from "./sampling.js";
-import { BoardRenderDiagnostic, inspectBoardScene, measureBoardText } from "./diagnostics.js";
+import { BoardRenderDiagnostic, inspectBoardItems, inspectBoardScene, measureBoardText } from "./diagnostics.js";
 import { BoardBackgroundContext, createBoardBackground, updateBoardBackground } from "./board-background.js";
-import { CARD_TAG_SIZE, CardGlyph, CardTag, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, zoomCardTag } from "./card-tag.js";
+import { CARD_TAG_SIZE, CardGlyph, CardTag, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, traceCube, zoomCardTag } from "./card-tag.js";
 import { ClipGroup, clippingAncestor, isClippingFrame, syncClipGroup, traceFrameOutline } from "./clip.js";
 import { BoardCssPaint, parseBoardCssColor, parseBoardCssPaint } from "./css-color.js";
 import { BoardMediaAction, boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter } from "./media-interaction.js";
@@ -17,4 +17,4 @@ import { ellipsizeWrappedLines, fitLineWithEllipsis, fitTextToLines, fitTextToWi
 import { BOARD_FONT_STACKS, ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
 import { boardCardDetailed, getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, 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, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceCardOutline, 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, 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 };

package/dist/board/render/index.js

@@ -2,11 +2,11 @@ import { parseBoardCssColor, parseBoardCssPaint } from "./css-color.js";
 import { defaultBoardPalette, itemAlpha, itemColor } from "./palette.js";
 import { createBoardRenderSampler } from "./sampling.js";
 import { BOARD_FONT_STACKS, ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
-import { inspectBoardScene, measureBoardText } from "./diagnostics.js";
+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 { CARD_TAG_SIZE, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, zoomCardTag } from "./card-tag.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";
@@ -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, inspectBoardScene, installBoardTextMeasurement, isBoardCard, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, mediaPlayKeyCenter, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, resolveBoardRenderStyle, roundRectPoints, syncCardTag, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceCardOutline, 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, 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 };

package/dist/board/render/media-interaction.js

@@ -1,25 +1,34 @@
 import { featuredTaskArtifact } from "../../protocol/dist/board-task.js";
 import { degToRad, rotatePointAround, worldPoint } from "../model/geometry.js";
+import { isBoardModelItem } from "../model/media.js";
 import { boardCardDetailed } from "./text-resolution.js";
 import { audioKeyCenter } from "./renderers/audio-card-renderer.js";
+import { modelKeyCenter } from "./renderers/model-card-renderer.js";
 //#region src/board/render/media-interaction.ts
 function mediaPlayBadgeVisible(item, zoom, options) {
 	if (!options.materialized) return false;
 	if (item.type === "video" || item.type === "audio") return true;
+	if (isBoardModelItem(item)) return boardCardDetailed(zoom);
 	if (item.type !== "task" || !boardCardDetailed(zoom)) return false;
 	const artifact = featuredTaskArtifact(item.props.snapshot.artifacts);
 	if (artifact?.type === "audio") return true;
 	return artifact?.type === "video" && (Boolean(artifact.previewUrl) || options.hasVideoPreview);
 }
+function cornerKey(item) {
+	const { width, height } = item.frame;
+	if (item.type === "audio") return audioKeyCenter(width, height);
+	return isBoardModelItem(item) ? modelKeyCenter(width, height) : null;
+}
 function mediaPlayKeyCenter(item) {
 	const { x, y, width, height, rotation } = item.frame;
 	const center = worldPoint(x + width / 2, y + height / 2);
-	if (item.type !== "audio") return center;
-	const key = audioKeyCenter(width, height);
+	const key = cornerKey(item);
+	if (!key) return center;
 	return rotatePointAround(worldPoint(x + key.x, y + key.y), center, degToRad(rotation || 0));
 }
 function mediaPlayBadgeHit(item, point, zoom) {
-	const radius = 28 / Math.max(zoom, .05);
+	const scale = Math.max(zoom, .05);
+	const radius = isBoardModelItem(item) ? Math.max(cornerKey(item)?.radius ?? 0, 16 / scale) : 28 / scale;
 	const center = mediaPlayKeyCenter(item);
 	return Math.hypot(point.x - center.x, point.y - center.y) <= radius;
 }

package/dist/board/render/renderers/board-renderer-registry.js

@@ -1,5 +1,6 @@
 import { ensureBoardTextMeasurement } from "../text-measurement.js";
 import { audioCardRenderer } from "./audio-card-renderer.js";
+import { modelCardRenderer } from "./model-card-renderer.js";
 import { arrowCardRenderer } from "./arrow-card-renderer.js";
 import { drawCardRenderer } from "./draw-card-renderer.js";
 import { effectCardRenderer } from "./effect-card-renderer.js";
@@ -25,6 +26,7 @@ const builtinCardRenderers = [
 	imageCardRenderer,
 	videoCardRenderer,
 	audioCardRenderer,
+	modelCardRenderer,
 	fileCardRenderer,
 	taskCardRenderer,
 	shapeCardRenderer,

package/dist/board/render/renderers/media-key.d.ts

@@ -2,5 +2,6 @@ import { BoardRenderContext } from "./board-renderer-registry.js";
 import { Graphics } from "pixi.js";
 //#region src/board/render/renderers/media-key.d.ts
 declare function drawMediaPlayKey(graphics: Graphics, cx: number, cy: number, radius: number, context: BoardRenderContext, solid?: boolean): void;
+declare function drawModelKey(graphics: Graphics, cx: number, cy: number, radius: number, context: BoardRenderContext): void;
 //#endregion
-export { drawMediaPlayKey };
+export { drawMediaPlayKey, drawModelKey };

package/dist/board/render/renderers/media-key.js

@@ -1,3 +1,4 @@
+import { traceCube } from "../card-tag.js";
 import { tracePixelRect } from "../surface.js";
 //#region src/board/render/renderers/media-key.ts
 const MEDIA_SCRIM = 0;
@@ -35,5 +36,24 @@ function drawMediaPlayKey(graphics, cx, cy, radius, context, solid = false) {
 		alpha: .96
 	});
 }
+function drawModelKey(graphics, cx, cy, radius, context) {
+	if (context.style.corner === "pixel") {
+		const size = Math.round(radius * 1.6);
+		tracePixelRect(graphics, Math.round(cx - size / 2), Math.round(cy - size / 2), size, size, 2).fill({
+			color: MEDIA_SCRIM,
+			alpha: .62
+		});
+	} else graphics.circle(cx, cy, radius).fill({
+		color: MEDIA_SCRIM,
+		alpha: .45
+	});
+	traceCube(graphics, cx, cy, radius * .5).stroke({
+		color: MEDIA_INK,
+		width: Math.max(1, radius / 10),
+		alpha: .96,
+		join: "round",
+		cap: "round"
+	});
+}
 //#endregion
-export { drawMediaPlayKey };
+export { drawMediaPlayKey, drawModelKey };

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

@@ -0,0 +1,10 @@
+import { BoardCardRenderer } from "./board-renderer-registry.js";
+//#region src/board/render/renderers/model-card-renderer.d.ts
+declare function modelKeyCenter(width: number, height: number): {
+  x: number;
+  y: number;
+  radius: number;
+};
+declare const modelCardRenderer: BoardCardRenderer;
+//#endregion
+export { modelCardRenderer, modelKeyCenter };

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

@@ -0,0 +1,132 @@
+import { isBoardModelItem } from "../../model/media.js";
+import { fileStem } from "../../model/file-snapshot.js";
+import { fileMetaLine } from "../../model/file-preview.js";
+import { boardCardDetailed } from "../text-resolution.js";
+import { createCardTag, syncCardTag, traceCube, zoomCardTag } from "../card-tag.js";
+import { cardElevation, containRect, drawCardSurface } from "../surface.js";
+import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
+import { drawModelKey } from "./media-key.js";
+import { Container, Graphics, Sprite, Texture } from "pixi.js";
+//#region src/board/render/renderers/model-card-renderer.ts
+const partsByContainer = /* @__PURE__ */ new WeakMap();
+const INSET_RATIO = .06;
+const KEY_RADIUS = 14;
+const KEY_MARGIN = 10;
+function modelKeyCenter(width, height) {
+	const radius = Math.max(8, Math.min(KEY_RADIUS, Math.min(width, height) * .12));
+	const margin = Math.min(KEY_MARGIN, radius * .7);
+	return {
+		x: width - margin - radius,
+		y: height - margin - radius,
+		radius
+	};
+}
+function sync(container, item, context) {
+	const parts = partsByContainer.get(container);
+	if (!parts) return;
+	positionShell(parts.root, item);
+	const { width, height } = item.frame;
+	const { src, snapshot } = item.props;
+	const meta = fileMetaLine(src, snapshot?.size);
+	const title = snapshot?.title || fileStem(src);
+	syncCardTag(parts.tag, {
+		glyph: "model",
+		text: `${title} · ${meta}`,
+		width
+	}, context);
+	const key = context.assetKey(item);
+	const texture = key ? context.getTexture(key) : null;
+	const failed = Boolean(key && !texture && context.hasError(key));
+	const detailed = boardCardDetailed(context.zoom);
+	const elevation = cardElevation(context, item.id);
+	const sig = [
+		key ?? "",
+		texture ? `${texture.width}x${texture.height}` : "none",
+		failed,
+		width,
+		height,
+		elevation,
+		detailed,
+		context.themeKey
+	].join("|");
+	if (sig === parts.sig) return;
+	parts.sig = sig;
+	drawCardSurface(parts.plate.clear(), {
+		x: 0,
+		y: 0,
+		width,
+		height
+	}, context.style, {
+		fill: context.palette.surface,
+		border: context.palette.border,
+		borderAlpha: .85,
+		elevation
+	});
+	if (texture && parts.sprite.texture !== texture) parts.sprite.texture = texture;
+	parts.sprite.visible = Boolean(texture);
+	if (texture) {
+		const inset = Math.min(width, height) * INSET_RATIO;
+		const fitted = containRect(width - inset * 2, height - inset * 2, texture.width, texture.height);
+		parts.sprite.position.set(inset + fitted.x, inset + fitted.y);
+		parts.sprite.width = fitted.width;
+		parts.sprite.height = fitted.height;
+	} else {
+		const radius = Math.max(6, Math.min(28, Math.min(width, height) * .14));
+		traceCube(parts.plate, width / 2, height / 2, radius).stroke({
+			color: context.palette.muted,
+			width: 1.5,
+			alpha: failed ? .35 : .6,
+			join: "round",
+			cap: "round"
+		});
+	}
+	parts.chrome.clear();
+	if (detailed) {
+		const center = modelKeyCenter(width, height);
+		drawModelKey(parts.chrome, center.x, center.y, center.radius, context);
+	}
+}
+const modelCardRenderer = {
+	id: "model-card",
+	canRender: (item) => isBoardModelItem(item),
+	create: (item, context) => {
+		const root = new Container();
+		const plate = new Graphics();
+		const sprite = new Sprite(Texture.EMPTY);
+		const chrome = new Graphics();
+		const tag = createCardTag();
+		root.addChild(plate, sprite, chrome, tag.root);
+		partsByContainer.set(root, {
+			root,
+			plate,
+			sprite,
+			chrome,
+			tag,
+			sig: ""
+		});
+		if (item.type === "file") sync(root, item, context);
+		return root;
+	},
+	update: (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);
+	},
+	renderFar: (graphics, item, context) => {
+		drawFarPlate(graphics, item.frame, {
+			fill: context.palette.surface,
+			fillAlpha: .96,
+			accent: context.palette.legendary,
+			accentAlpha: .45
+		});
+	},
+	destroy: (container) => {
+		partsByContainer.get(container)?.root.destroy({ children: true });
+		partsByContainer.delete(container);
+	}
+};
+//#endregion
+export { modelCardRenderer, modelKeyCenter };

package/dist/board/stage/assets.d.ts

@@ -1,11 +1,23 @@
+import { ModelFormat } from "../../protocol/dist/fs/mime.js";
 import { BoardSceneItem } from "../model/scene.js";
 import "../model/index.js";
 import { LruBudget } from "./lru.js";
 import { BoardImageTexturePool } from "./texture-pool.js";
 import { Texture } from "pixi.js";
 //#region src/board/stage/assets.d.ts
-type BoardAssetMedia = "image" | "video";
+type BoardUrlMedia = "image" | "video";
+type BoardAssetMedia = BoardUrlMedia | "model";
 declare function boardAssetKey(item: BoardSceneItem): string | null;
+type BoardModelPreviewRequest = {
+  key: string;
+  src: string;
+  format: ModelFormat;
+  size?: number;
+};
+type BoardModelPreviews = {
+  load: (request: BoardModelPreviewRequest) => Promise<ImageBitmap>;
+  maxBytes?: number;
+};
 type BoardAssetManager = {
   assetKey: (item: BoardSceneItem) => string | null;
   invalidatePath: (path: string) => void;
@@ -30,12 +42,13 @@ type BoardAssetManagerOptions = {
   concurrency?: number;
   videoConcurrency?: number;
   loadVideoPreviews?: boolean;
+  modelPreviews?: BoardModelPreviews;
   lruBudget?: LruBudget;
   imageTexturePool?: BoardImageTexturePool;
-  loadTexture?: (url: string, media: BoardAssetMedia) => Promise<Texture | null>;
+  loadTexture?: (url: string, media: BoardUrlMedia) => Promise<Texture | null>;
   unloadTexture?: (url: string, texture: Texture | null, media: BoardAssetMedia) => Promise<void>;
   now?: () => number;
 };
 declare function createBoardAssetManager(options: BoardAssetManagerOptions): BoardAssetManager;
 //#endregion
-export { BoardAssetManager, BoardAssetManagerOptions, boardAssetKey, createBoardAssetManager };
+export { BoardAssetManager, BoardAssetManagerOptions, BoardModelPreviewRequest, BoardModelPreviews, boardAssetKey, createBoardAssetManager };

package/dist/board/stage/assets.js

@@ -1,10 +1,12 @@
 import { mediaPreviewCandidates } from "../../media.js";
 import { parseBoardMediaSource } from "../../protocol/dist/board-model.js";
 import { featuredTaskArtifact } from "../../protocol/dist/board-task.js";
+import { boardModelFormat, isBoardModelItem } from "../model/media.js";
 import { boardImageKeySource, imageAssetKey } from "../model/image-key.js";
 import { loadVideoThumbnailTexture, videoTextureNaturalSize } from "../render/video-thumbnail.js";
 import { DEFAULT_LRU_BUDGET, selectLruEvictions } from "./lru.js";
 import { boardImageTexturePool, loadBoardImageTexture, unloadBoardImageTexture } from "./texture-pool.js";
+import { Texture } from "pixi.js";
 //#region src/board/stage/assets.ts
 const TASK_TEXTURE_SIZE = 1536;
 function taskPreviewKey(artifact) {
@@ -13,13 +15,16 @@ function taskPreviewKey(artifact) {
 	if (still) return `url:${still}`;
 	return artifact.type === "video" ? `video-url:${encodeURIComponent(artifact.url)}` : null;
 }
+const STILL_MEDIA = ["video", "model"];
+function stillKey(media, src, mtimeMs) {
+	const source = parseBoardMediaSource(src);
+	if (!source) return null;
+	return source.kind === "url" ? `${media}-url:${encodeURIComponent(source.value)}` : `${media}:${encodeURIComponent(source.value)}:${mtimeMs ?? "unknown"}`;
+}
 function boardAssetKey(item) {
 	if (item.type === "task") return taskPreviewKey(featuredTaskArtifact(item.props.snapshot.artifacts));
-	if (item.type === "video") {
-		const source = parseBoardMediaSource(item.props.src);
-		if (!source) return null;
-		return source.kind === "url" ? `video-url:${encodeURIComponent(source.value)}` : `video:${encodeURIComponent(source.value)}:${item.props.snapshot?.mtimeMs ?? "unknown"}`;
-	}
+	if (item.type === "video") return stillKey("video", item.props.src, item.props.snapshot?.mtimeMs);
+	if (item.type === "file" && isBoardModelItem(item)) return stillKey("model", item.props.src, item.props.snapshot?.mtimeMs);
 	return imageAssetKey(item);
 }
 function keySource(key) {
@@ -29,27 +34,29 @@ function keySource(key) {
 		if (separator < 0) return null;
 		baseKey = key.slice(separator + 1);
 	}
-	if (baseKey.startsWith("video-url:")) try {
-		return {
-			kind: "url",
-			media: "video",
-			value: decodeURIComponent(baseKey.slice(10))
-		};
-	} catch {
-		return null;
-	}
-	if (baseKey.startsWith("video:")) {
-		const separator = baseKey.lastIndexOf(":");
-		if (separator <= 6) return null;
-		try {
+	for (const media of STILL_MEDIA) {
+		if (baseKey.startsWith(`${media}-url:`)) try {
 			return {
-				kind: "file",
-				media: "video",
-				value: decodeURIComponent(baseKey.slice(6, separator))
+				kind: "url",
+				media,
+				value: decodeURIComponent(baseKey.slice(media.length + 5))
 			};
 		} catch {
 			return null;
 		}
+		if (baseKey.startsWith(`${media}:`)) {
+			const separator = baseKey.lastIndexOf(":");
+			if (separator <= media.length) return null;
+			try {
+				return {
+					kind: "file",
+					media,
+					value: decodeURIComponent(baseKey.slice(media.length + 1, separator))
+				};
+			} catch {
+				return null;
+			}
+		}
 	}
 	const image = boardImageKeySource(baseKey);
 	return image ? {
@@ -64,7 +71,11 @@ function footprintOf(texture) {
 }
 function createBoardAssetManager(options) {
 	const concurrency = Math.max(1, options.concurrency ?? 4);
-	const videoConcurrency = Math.max(1, Math.min(options.videoConcurrency ?? 2, concurrency));
+	const limits = {
+		image: concurrency,
+		video: Math.max(1, Math.min(options.videoConcurrency ?? 2, concurrency)),
+		model: 1
+	};
 	const budget = options.lruBudget ?? DEFAULT_LRU_BUDGET;
 	const now = options.now ?? (() => Date.now());
 	const imagePool = options.imageTexturePool ?? boardImageTexturePool;
@@ -72,8 +83,10 @@ function createBoardAssetManager(options) {
 	const loadTexture = options.loadTexture ?? ((url, media) => media === "video" ? loadVideoThumbnailTexture(url) : useSharedImagePool ? imagePool.acquire(url) : loadBoardImageTexture(url));
 	const pendingUnloads = /* @__PURE__ */ new Map();
 	const unloadTexture = options.unloadTexture ?? (async (url, texture, media) => {
-		if (media === "video" || !url) {
+		if (media !== "image" || !url) {
+			const resource = texture?.source.resource;
 			texture?.destroy(true);
+			resource?.close?.();
 			return;
 		}
 		if (useSharedImagePool) {
@@ -93,12 +106,17 @@ function createBoardAssetManager(options) {
 	const resolveFileUrl = options.resolveFileUrl;
 	const entries = /* @__PURE__ */ new Map();
 	const pathVersions = /* @__PURE__ */ new Map();
-	const resolvers = /* @__PURE__ */ new Map();
+	const loaders = /* @__PURE__ */ new Map();
+	const failedModels = /* @__PURE__ */ new Set();
 	const inflight = /* @__PURE__ */ new Set();
 	const queue = [];
 	const listeners = /* @__PURE__ */ new Set();
 	let active = 0;
-	let activeVideos = 0;
+	const activeByMedia = {
+		image: 0,
+		video: 0,
+		model: 0
+	};
 	let disposed = false;
 	function notify() {
 		for (const listener of listeners) listener();
@@ -108,6 +126,7 @@ function createBoardAssetManager(options) {
 		if (!key) return null;
 		const source = keySource(key);
 		if (source?.media === "video" && options.loadVideoPreviews === false) return null;
+		if (source?.media === "model" && !modelPreviewable(item)) return null;
 		if (source?.kind !== "file") return key;
 		const version = pathVersions.get(source.value) ?? 0;
 		return version > 0 ? `local:${version}:${key}` : key;
@@ -143,13 +162,13 @@ function createBoardAssetManager(options) {
 			entry.retryTimer = null;
 			if (disposed || entries.get(key) !== entry) return;
 			if (entry.refs <= 0 || entry.texture || entry.loading) return;
-			const getUrl = resolvers.get(key);
-			if (!getUrl) return;
+			const load = loaders.get(key);
+			if (!load) return;
 			entry.error = false;
 			if (!queue.some((task) => task.key === key)) {
 				queue.push({
 					key,
-					getUrl
+					load
 				});
 				pump();
 			}
@@ -157,7 +176,7 @@ function createBoardAssetManager(options) {
 	}
 	function evict(key, entry) {
 		clearRetry(entry);
-		resolvers.delete(key);
+		loaders.delete(key);
 		if (entry.url || entry.texture) releaseTexture(key, entry.url ?? "", entry.texture);
 		entries.delete(key);
 	}
@@ -178,7 +197,8 @@ function createBoardAssetManager(options) {
 		entry.loading = false;
 		inflight.delete(key);
 		active -= 1;
-		if (keySource(key)?.media === "video") activeVideos -= 1;
+		const media = keySource(key)?.media;
+		if (media) activeByMedia[media] -= 1;
 		if (entries.get(key) !== entry) {
 			if (texture) releaseTexture(key, entry.url ?? "", texture);
 			if (!disposed) pump();
@@ -196,9 +216,10 @@ function createBoardAssetManager(options) {
 			entry.attempts += 1;
 			entry.retryAt = now() + Math.min(1e3 * 2 ** entry.attempts, MAX_RETRY_DELAY);
 			console.warn(`[board] failed to load preview for ${key}`, error);
+			if (media === "model") failedModels.add(key);
 			if (entry.refs <= 0) evict(key, entry);
 			else {
-				scheduleRetry(key, entry);
+				if (media !== "model") scheduleRetry(key, entry);
 				notify();
 			}
 		}
@@ -207,7 +228,8 @@ function createBoardAssetManager(options) {
 	function pump() {
 		while (!disposed && active < concurrency && queue.length > 0) {
 			const taskIndex = queue.findIndex(({ key }) => {
-				return keySource(key)?.media !== "video" || activeVideos < videoConcurrency;
+				const media = keySource(key)?.media;
+				return !media || activeByMedia[media] < limits[media];
 			});
 			if (taskIndex < 0) return;
 			const [task] = queue.splice(taskIndex, 1);
@@ -218,18 +240,42 @@ function createBoardAssetManager(options) {
 			entry.loading = true;
 			inflight.add(task.key);
 			active += 1;
-			if (source.media === "video") activeVideos += 1;
-			task.getUrl().then(async (url) => {
-				if (!url || disposed) return null;
-				entry.url = url;
-				const pendingKey = `${source.media}:${url}`;
-				const pending = pendingUnloads.get(pendingKey);
-				if (pending) await pending;
-				if (disposed) return null;
-				return loadTexture(url, source.media);
-			}).then((texture) => settle(task.key, entry, texture ?? null), (error) => settle(task.key, entry, null, error));
+			activeByMedia[source.media] += 1;
+			task.load(entry).then((texture) => settle(task.key, entry, texture), (error) => settle(task.key, entry, null, error));
 		}
 	}
+	function urlLoader(source) {
+		const getUrl = source.kind === "url" ? () => Promise.resolve(source.value) : () => resolveFileUrl(source.value);
+		return async (entry) => {
+			const url = await getUrl();
+			if (!url || disposed) return null;
+			entry.url = url;
+			const pending = pendingUnloads.get(`${source.media}:${url}`);
+			if (pending) await pending;
+			if (disposed) return null;
+			return loadTexture(url, source.media);
+		};
+	}
+	function modelPreviewable(item) {
+		const previews = options.modelPreviews;
+		if (!previews) return false;
+		const size = item.type === "file" ? item.props.snapshot?.size : void 0;
+		return size === void 0 || size <= (previews.maxBytes ?? Number.POSITIVE_INFINITY);
+	}
+	function modelLoader(item, key) {
+		const previews = options.modelPreviews;
+		if (!previews || item.type !== "file") return null;
+		const { src, snapshot } = item.props;
+		const format = boardModelFormat(src, snapshot?.mimeType);
+		if (!format) return null;
+		const request = {
+			key,
+			src,
+			format,
+			size: snapshot?.size
+		};
+		return async () => Texture.from(await previews.load(request));
+	}
 	const manager = {
 		assetKey: managedAssetKey,
 		invalidatePath(path) {
@@ -244,7 +290,7 @@ function createBoardAssetManager(options) {
 		requestItem(item) {
 			if (disposed) return;
 			const key = managedAssetKey(item);
-			if (!key) return;
+			if (!key || failedModels.has(key)) return;
 			const source = keySource(key);
 			if (!source) return;
 			const entry = ensureEntry(key);
@@ -254,11 +300,15 @@ function createBoardAssetManager(options) {
 			entry.error = false;
 			clearRetry(entry);
 			if (queue.some((queued) => queued.key === key)) return;
-			const getUrl = source.kind === "url" ? () => Promise.resolve(source.value) : () => resolveFileUrl(source.value);
-			resolvers.set(key, getUrl);
+			const load = source.media === "model" ? modelLoader(item, key) : urlLoader({
+				...source,
+				media: source.media
+			});
+			if (!load) return;
+			loaders.set(key, load);
 			queue.push({
 				key,
-				getUrl
+				load
 			});
 			pump();
 		},
@@ -344,7 +394,8 @@ function createBoardAssetManager(options) {
 			queue.length = 0;
 			listeners.clear();
 			pathVersions.clear();
-			resolvers.clear();
+			loaders.clear();
+			failedModels.clear();
 			for (const [key, entry] of entries) evict(key, entry);
 			entries.clear();
 		}

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

@@ -1,9 +1,9 @@
 import { DEFAULT_LRU_BUDGET, LruBudget, LruEntry, selectLruEvictions } from "./lru.js";
 import { BoardImageTexturePool, boardImageTexturePool, createBoardImageTexturePool, loadBoardImageTexture, unloadBoardImageTexture } from "./texture-pool.js";
-import { BoardAssetManager, BoardAssetManagerOptions, boardAssetKey, createBoardAssetManager } from "./assets.js";
+import { BoardAssetManager, BoardAssetManagerOptions, BoardModelPreviewRequest, BoardModelPreviews, boardAssetKey, createBoardAssetManager } from "./assets.js";
 import { toBoardPointerEvent } from "./pointer.js";
 import { BoardLiveStroke, BoardScene, BoardSceneNode, SceneSyncInput, createBoardScene } from "./scene.js";
 import { BoardItemView, BoardItemViewContext, BoardItemViewInstance, BoardItemViewLayer, createBoardItemViewLayer } from "./views.js";
 import { BoardStage, BoardStageOptions, BoardStagePointerPhase, BoardStageTheme, mountBoardStage } from "./stage.js";
 import { BoardOverlayInput, drawBoardOverlay, expandFrame } from "./overlay.js";
-export { BoardAssetManager, BoardAssetManagerOptions, BoardImageTexturePool, BoardItemView, BoardItemViewContext, BoardItemViewInstance, BoardItemViewLayer, BoardLiveStroke, BoardOverlayInput, BoardScene, BoardSceneNode, BoardStage, BoardStageOptions, BoardStagePointerPhase, BoardStageTheme, DEFAULT_LRU_BUDGET, LruBudget, LruEntry, SceneSyncInput, boardAssetKey, boardImageTexturePool, createBoardAssetManager, createBoardImageTexturePool, createBoardItemViewLayer, createBoardScene, drawBoardOverlay, expandFrame, loadBoardImageTexture, mountBoardStage, selectLruEvictions, toBoardPointerEvent, unloadBoardImageTexture };
+export { BoardAssetManager, BoardAssetManagerOptions, BoardImageTexturePool, BoardItemView, BoardItemViewContext, BoardItemViewInstance, BoardItemViewLayer, BoardLiveStroke, BoardModelPreviewRequest, BoardModelPreviews, BoardOverlayInput, BoardScene, BoardSceneNode, BoardStage, BoardStageOptions, BoardStagePointerPhase, BoardStageTheme, DEFAULT_LRU_BUDGET, LruBudget, LruEntry, SceneSyncInput, boardAssetKey, boardImageTexturePool, createBoardAssetManager, createBoardImageTexturePool, createBoardItemViewLayer, createBoardScene, drawBoardOverlay, expandFrame, loadBoardImageTexture, mountBoardStage, selectLruEvictions, toBoardPointerEvent, unloadBoardImageTexture };