@neta-art/cohub 11.3.0 → 11.3.2

package/dist/board/export/index.js

@@ -6,7 +6,7 @@ import { defaultBoardPalette } from "../render/palette.js";
 import { createBoardRenderSampler } from "../render/sampling.js";
 import { ensureBoardTextMeasurement } from "../render/text-measurement.js";
 import { createBoardExportScene } from "./scene.js";
-import { Rectangle } from "pixi.js";
+import { Rectangle, RendererType } from "pixi.js";
 //#region src/board/export/index.ts
 function resolveBackground(background, palette, document, colorScheme) {
 	if (background === "transparent") return null;
@@ -85,13 +85,24 @@ function renderBoardExport(renderer, input, options = {}) {
 		backgroundImage: options.backgroundImage
 	});
 	try {
-		const canvas = renderer.extract.canvas({
+		const texture = renderer.textureGenerator.generateTexture({
 			target: exportScene.root,
 			frame: new Rectangle(0, 0, plan.width, plan.height),
 			resolution: 1,
 			antialias: true,
 			clearColor: options.background === "transparent" ? void 0 : palette.bg
 		});
+		let canvas;
+		const surface = renderer.type === RendererType.CANVAS ? texture.source.resource : void 0;
+		try {
+			canvas = renderer.texture.generateCanvas(texture);
+		} finally {
+			texture.destroy(true);
+			if (surface) {
+				surface.width = 1;
+				surface.height = 1;
+			}
+		}
 		const warnings = [];
 		if (plan.clamped) warnings.push({
 			kind: "scale-clamped",

package/dist/board/export/node/fonts.d.ts

@@ -0,0 +1,13 @@
+//#region src/board/export/node/fonts.d.ts
+type BoardNodeFont = {
+  path: string;
+  family?: string;
+};
+type BoardFontRegistry = {
+  registerFromPath(path: string, family?: string): unknown;
+  has(family: string): boolean;
+  setAlias?: (family: string, alias: string) => boolean;
+};
+declare function initializeBoardFonts(registry: BoardFontRegistry, fonts: readonly BoardNodeFont[]): void;
+//#endregion
+export { BoardFontRegistry, BoardNodeFont, initializeBoardFonts };

package/dist/board/export/node/fonts.js

@@ -0,0 +1,44 @@
+//#region src/board/export/node/fonts.ts
+function initializeBoardFonts(registry, fonts) {
+	for (const font of fonts) registry.registerFromPath(font.path, font.family);
+	if (!registry.setAlias) return;
+	for (const [alias, candidates] of Object.entries({
+		"system-ui": [
+			"Noto Sans",
+			"DejaVu Sans",
+			"Liberation Sans",
+			"FreeSans",
+			"Helvetica Neue",
+			"Arial",
+			"Segoe UI"
+		],
+		"sans-serif": [
+			"Geist",
+			"Noto Sans",
+			"DejaVu Sans",
+			"Liberation Sans",
+			"FreeSans",
+			"Arial"
+		],
+		serif: [
+			"Noto Serif",
+			"DejaVu Serif",
+			"Liberation Serif",
+			"FreeSerif",
+			"Times New Roman"
+		],
+		monospace: [
+			"Geist Mono",
+			"DejaVu Sans Mono",
+			"Liberation Mono",
+			"FreeMono",
+			"Courier New"
+		]
+	})) {
+		if (registry.has(alias)) continue;
+		const family = candidates.find((name) => registry.has(name));
+		if (family) registry.setAlias(family, alias);
+	}
+}
+//#endregion
+export { initializeBoardFonts };

package/dist/board/export/node/index.d.ts

@@ -2,21 +2,14 @@ import { BoardDocument } from "../../../protocol/dist/board-model.js";
 import "../../../protocol/dist/index.js";
 import { BoardScriptHost } from "../../render/renderers/board-renderer-registry.js";
 import { BoardExportOptions, BoardExportResult } from "../index.js";
+import { BoardFontRegistry, BoardNodeFont } from "./fonts.js";
 import { createNodeBoardScriptHost } from "./scripts.js";
 import { Renderer } from "pixi.js";
 //#region src/board/export/node/index.d.ts
 type NodeCanvasModule = {
   createCanvas: (width: number, height: number) => unknown;
   Image: new () => unknown;
-  GlobalFonts: {
-    registerFromPath: (path: string, name?: string) => unknown;
-    has: (name: string) => boolean;
-    setAlias?: (fontName: string, alias: string) => boolean;
-  };
-};
-type BoardNodeFont = {
-  path: string;
-  family?: string;
+  GlobalFonts: BoardFontRegistry;
 };
 type BoardNodeRendererOptions = {
   fonts?: BoardNodeFont[];
@@ -29,6 +22,7 @@ type BoardNodeTexture = {
 type BoardNodeRenderer = {
   renderer: Renderer;
   canvasModule: NodeCanvasModule;
+  fonts?: readonly BoardNodeFont[];
   decodeImage: (bytes: Uint8Array, mimeType?: string) => Promise<BoardNodeTexture>;
   destroy: () => void;
 };
@@ -53,4 +47,4 @@ type BoardNodeExportResult = Omit<BoardExportResult, "canvas"> & {
 declare function boardImageMimeType(format: BoardNodeExportFormat): string;
 declare function exportBoardImageBytes(renderer: BoardNodeRenderer, document: BoardDocument, options?: BoardNodeExportOptions): BoardNodeExportResult | null;
 //#endregion
-export { BoardNodeExportFormat, BoardNodeExportOptions, BoardNodeExportResult, BoardNodeFont, BoardNodeRenderer, BoardNodeRendererOptions, BoardNodeTexture, NodeCanvasModule, boardImageMimeType, createNodeBoardRenderer, createNodeBoardScriptHost, exportBoardImageBytes };
+export { BoardNodeExportFormat, BoardNodeExportOptions, BoardNodeExportResult, type BoardNodeFont, BoardNodeRenderer, BoardNodeRendererOptions, BoardNodeTexture, NodeCanvasModule, boardImageMimeType, createNodeBoardRenderer, createNodeBoardScriptHost, exportBoardImageBytes };

package/dist/board/export/node/index.js

@@ -1,23 +1,10 @@
 import "../../../protocol/dist/board-constants.js";
 import { installBoardTextMeasurement } from "../../render/text-measurement.js";
 import { renderBoardExport } from "../index.js";
+import { initializeBoardFonts } from "./fonts.js";
 import { createNodeBoardScriptHost } from "./scripts.js";
 import { CanvasGraphicsContextSystem, CanvasGraphicsPipe, CanvasRenderer, CanvasRendererTextSystem, CanvasTextPipe, CanvasTextSystem, DOMAdapter, GraphicsContextSystem, GraphicsPipe, ImageSource, Texture, extensions } from "pixi.js";
 //#region src/board/export/node/index.ts
-const SYSTEM_UI_FAMILIES = [
-	"Noto Sans",
-	"DejaVu Sans",
-	"Liberation Sans",
-	"FreeSans",
-	"Helvetica Neue",
-	"Arial",
-	"Segoe UI"
-];
-function aliasSystemUi(fonts) {
-	if (!fonts.setAlias || fonts.has("system-ui")) return;
-	const family = SYSTEM_UI_FAMILIES.find((name) => fonts.has(name));
-	if (family) fonts.setAlias(family, "system-ui");
-}
 const WEBGL_PROBE_STUB = {
 	getShaderPrecisionFormat: () => ({
 		precision: 1,
@@ -64,8 +51,11 @@ function installAnimationFrameShim() {
 async function createNodeBoardRenderer(options = {}) {
 	const canvasModule = options.canvasModule ?? await loadCanvasModule();
 	extensions.add(CanvasGraphicsPipe, GraphicsPipe, CanvasGraphicsContextSystem, GraphicsContextSystem, CanvasRendererTextSystem, CanvasTextSystem, CanvasTextPipe);
-	for (const font of options.fonts ?? []) canvasModule.GlobalFonts.registerFromPath(font.path, font.family ?? "Geist");
-	aliasSystemUi(canvasModule.GlobalFonts);
+	const fonts = (options.fonts ?? []).map((font) => ({
+		...font,
+		family: font.family ?? "Geist"
+	}));
+	initializeBoardFonts(canvasModule.GlobalFonts, fonts);
 	function createCanvas(width = 1, height = 1) {
 		const canvas = canvasModule.createCanvas(Math.max(1, Math.ceil(width)), Math.max(1, Math.ceil(height)));
 		const nativeGetContext = canvas.getContext.bind(canvas);
@@ -102,14 +92,16 @@ async function createNodeBoardRenderer(options = {}) {
 	return {
 		renderer,
 		canvasModule,
-		decodeImage: async (bytes, mimeType = "image/png") => {
+		fonts,
+		decodeImage: async (bytes) => {
 			const image = new canvasModule.Image();
-			const base64 = Buffer.from(bytes).toString("base64");
 			await new Promise((resolve, reject) => {
 				image.onload = () => resolve();
 				image.onerror = (error) => reject(error);
-				image.src = `data:${mimeType};base64,${base64}`;
+				image.src = bytes;
 			});
+			image.onload = void 0;
+			image.onerror = void 0;
 			return new Texture({ source: new ImageSource({
 				resource: image,
 				width: image.width,
@@ -146,7 +138,7 @@ function exportBoardImageBytes(renderer, document, options = {}) {
 	try {
 		const bytes = format === "png" ? canvas.toBuffer(MIME.png) : canvas.toBuffer(MIME[format], Math.round(quality * 100));
 		return {
-			bytes: new Uint8Array(bytes),
+			bytes: new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength),
 			plan: result.plan,
 			warnings: result.warnings,
 			format

package/dist/board/export/node/scripts.d.ts

@@ -4,6 +4,7 @@ import { BoardNodeRenderer } from "./index.js";
 //#region src/board/export/node/scripts.d.ts
 type BoardNodeScriptOptions = {
   readModule(src: string): Promise<string>;
+  concurrency?: number;
   timeoutMs?: number;
   readTimeoutMs?: number;
 };

package/dist/board/export/node/scripts.js

@@ -2,13 +2,15 @@ import { boardScriptScope, composeBoardScriptItems } from "../../model/script-sc
 import { buildBoardScene } from "../../model/scene.js";
 import { createBoardScriptModuleReader, loadBoardScriptSources } from "../../../protocol/dist/board-script-modules.js";
 import { createScriptRuntime } from "../../render/script-runtime.js";
+import { initializeBoardFonts } from "./fonts.js";
 import { Worker } from "node:worker_threads";
 import { fileURLToPath } from "node:url";
 //#region src/board/export/node/scripts.ts
 const WORKER = `
 const {parentPort, workerData} = require('node:worker_threads');
 const {createContext, Script, SourceTextModule} = require('node:vm');
-const {createCanvas} = require(workerData.canvasModule);
+const {createCanvas, GlobalFonts} = require(workerData.canvasModule);
+(${initializeBoardFonts.toString()})(GlobalFonts, workerData.fonts);
 const instances = new Map();
 const graphs = new Map();
 const update = new Script('__runtime.update(JSON.parse(__inputJson)); __runtime.step(__time)');
@@ -17,7 +19,10 @@ const output = new Script('JSON.stringify(__runtime.output())');
 const dispose = new Script('__runtime.destroy()');
 function release(id) {
  const entry=instances.get(id);instances.delete(id);
- if(entry) {try {dispose.runInContext(entry.context,{timeout:workerData.timeout});} catch {}}
+ if(entry) {
+  try {dispose.runInContext(entry.context,{timeout:workerData.timeout});} catch {}
+  if(entry.canvas) {entry.canvas.width=1;entry.canvas.height=1;}
+ }
 }
 async function create(data) {
  const context = createContext({console:{log(){},warn(){},error(){}},structuredClone},{codeGeneration:{strings:false,wasm:false}});
@@ -67,22 +72,29 @@ parentPort.on('message',async data=>{
    const width=Math.max(1,Math.round(data.input.width*data.scale));
    const height=Math.max(1,Math.round(data.input.height*data.scale));
    const canvas=entry.canvas??=createCanvas(width,height);
-   canvas.width=width;canvas.height=height;
-   const drawing=canvas.getContext('2d');drawing.scale(data.scale,data.scale);
-   context.__drawing=drawing;draw.runInContext(context,{timeout:workerData.timeout});
-   png=canvas.toBuffer('image/png');delete context.__drawing;
+   if(canvas.width!==width || canvas.height!==height) {canvas.width=width;canvas.height=height;}
+   const drawing=canvas.getContext('2d');drawing.reset();drawing.scale(data.scale,data.scale);
+   context.__drawing=drawing;
+   try {
+    draw.runInContext(context,{timeout:workerData.timeout});
+    png=canvas.toBuffer('image/png');
+   } finally {
+    delete context.__drawing;canvas.width=1;canvas.height=1;
+   }
   }
   parentPort.postMessage({png,output:JSON.parse(output.runInContext(context,{timeout:workerData.timeout}))});
- } catch(error) { instances.delete(data.input?.id);parentPort.postMessage({error:String(error.stack||error)}); }
+ } catch(error) { release(data.input?.id);parentPort.postMessage({error:String(error.stack||error)}); }
 });
 `;
 function createNodeBoardScriptHost(renderer, options) {
+	const concurrency = options.concurrency ?? 4;
+	if (!Number.isSafeInteger(concurrency) || concurrency < 1 || concurrency > 4) throw new Error("Script concurrency must be an integer between 1 and 4.");
 	const textures = /* @__PURE__ */ new Map();
 	const outputs = /* @__PURE__ */ new Map();
 	const errors = /* @__PURE__ */ new Map();
 	const sources = /* @__PURE__ */ new Map();
 	const modules = createBoardScriptModuleReader(options.readModule, options.readTimeoutMs);
-	const lanes = Array.from({ length: 4 }, () => ({
+	const lanes = Array.from({ length: concurrency }, () => ({
 		worker: null,
 		tail: Promise.resolve(),
 		graphs: /* @__PURE__ */ new Set()
@@ -123,6 +135,7 @@ function createNodeBoardScriptHost(renderer, options) {
 				workerData: {
 					runtime: createScriptRuntime.toString(),
 					timeout,
+					fonts: renderer.fonts ?? [],
 					canvasModule: fileURLToPath(import.meta.resolve("@napi-rs/canvas"))
 				}
 			});

package/dist/board/model/authoring.js

@@ -47,7 +47,6 @@ function boardSequence(document, chapters) {
 		const chapterIndex = String(index).padStart(String(chapters.length).length, "0");
 		for (const [id, track] of Object.entries(animation.tracks)) {
 			if (document.animations[track.target]) throw new Error(`Chapter ${chapter.animation} contains nested clocks; compose its leaf animations instead.`);
-			if (chapter.frame && track.target === "camera" && track.property === "focus") continue;
 			tracks[`chapter-${chapterIndex}-${ranks.get(id)}`] = {
 				...track,
 				keyframes: track.keyframes.map((keyframe) => ({
@@ -78,7 +77,7 @@ function boardSequence(document, chapters) {
 					}] : []
 				]
 			};
-			tracks[`camera-${index}`] = {
+			tracks[`chapter-${chapterIndex}--camera`] = {
 				target: "camera",
 				property: "focus",
 				composite: "replace",

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

@@ -38,7 +38,7 @@ import { BoardAppMetadata, BoardItemEntry, BoardMediaItemKind, boardItemOrigin,
 import { createBoardEntityId, createBoardItemId } from "./items/id.js";
 import { BoardItemInput, BoardRegistry, createBoardRegistry, defaultBoardRegistry } from "./items/registry.js";
 import "./items/index.js";
-import { BoardMediaKind, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind } from "./media.js";
+import { BoardMediaKind, boardModelFormat, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind, isBoardModelItem } from "./media.js";
 import { BoardAssetSource, BoardPlayableMedia, playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl } from "./media-playback.js";
 import { BoardReplayActorKind, BoardReplayEntry, BoardReplayPlayer, boardReplayActorKind, createBoardReplayPlayer } from "./replay.js";
-export { ARROW_BINDING_GAP, ArrowFrameLookup, BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLORS, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_PRESET_NAMES, BOARD_SCHEMA_TARGETS, BOARD_SCRIPT_API, BOARD_SCRIPT_DRAWING_EXAMPLE, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSampler, BoardAnimationSchema, BoardAppMetadata, BoardApplyOptions, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAssetSource, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardCameraFit, BoardCameraFocus, BoardCameraOverride, BoardCameraState, BoardChapter, BoardColor, BoardColorEntry, BoardColorId, BoardColorResolver, BoardColorSchema, BoardColorToken, BoardColorValue, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawInputSample, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseFunction, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardEvaluateOptions, BoardEvaluation, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, type BoardFileSnapshotFacts, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemCapabilities, BoardItemDefinition, BoardItemEntry, BoardItemInput, BoardItemLookup, BoardItemOf, BoardItemResizeMode, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaItemKind, BoardMediaKind, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardNestedAnimationOptions, BoardNormalizedPoint, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlacement, BoardPlayMode, BoardPlayableMedia, BoardPresetName, BoardPresetOptions, BoardPropertySpec, BoardRect, BoardRegistry, BoardReplayActorKind, BoardReplayEntry, BoardReplayPlayer, BoardScene, BoardSceneItem, BoardScreenOffset, BoardScreenPoint, BoardScript, BoardScriptAnchor, BoardScriptContext, BoardScriptEvent, BoardScriptEventOf, BoardScriptFrame, BoardScriptHit, BoardScriptHostEvents, BoardScriptItemPatch, BoardScriptModule, BoardScriptOutput, BoardScriptParameter, BoardScriptSceneOptions, BoardScriptSchema, BoardScriptSnapshot, BoardScriptView, BoardSettings, BoardSettingsSchema, BoardShapeColors, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardStyledToolId, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, type BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardToolStyleMap, BoardToolStylePatch, BoardTrack, BoardTrackSchema, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardWorldOffset, BoardWorldPoint, BoardWorldRect, type BuildSnapshotInput, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompiledAnimation, CompiledBoardAnimations, CompiledTrack, CornerResizeHandle, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_TOOL_STYLES, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, type FileCategory, FilePreviewKind, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, IDENTITY_MATRIX, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, ResizeHandle, ResolvedArrow, ResolvedArrowEnd, type ResolvedCover, SHAPE_KINDS, SceneItem, ScreenPoint, ShapeKind, Size, StrokeRibbonBuilder, StrokeRibbonGeometry, StrokeRibbonMesh, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, VIEWPORT_MARGIN_RATIO, WorldPoint, anchorPoint, angleFromCenter, appendBoardDrawSamples, applyBoardDelta, applyBoardEvaluation, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, arrowHitRadius, arrowPathBounds, autoAnchorSide, availabilityFromError, bendControl, boardAnimationTime, boardColorCssVar, boardDocumentAt, boardEase, boardFontFamily, boardImageKeySource, boardItemOrigin, boardItemSchema, boardJsonSchema, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskSource, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, compileBoardAnimations, composeBoardScriptItems, computeDrawBounds, createAppBoardItem, createArrowBoardItem, createBoardAnimationSampler, createBoardEntityId, createBoardItemId, createBoardLayout, createBoardRegistry, createBoardReplayPlayer, createBoardToolStyles, createDocumentLayout, createDocumentState, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createStrokeRibbonBuilder, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, degToRad, diffBoardDocuments, diffMergePatch, distanceToArrow, distanceToStroke, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, framePoint, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, handlePosition, hasAuthoredSize, hasBoardScripts, imageAssetKey, inferBoardMediaKind, invertMatrix, isArrowBinding, isBoardColorId, isBoardColorString, isBoardEase, isBoardPath, isBoardPresetName, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isFileSnapshotFresh, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, isShapeKind, isStrokeCorner, itemBounds, layoutBoardText, listBoardPresets, listBoardProperties, mediaFrameSize, mergeFileSnapshot, mergePatch, multiplyMatrix, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, orderBoardItems, panBy, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, parseHexColor, pathMidpoint, pathPointAt, pickBoardColor, placeBoardOverlay, placeItem, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, pointsRect, prepareBoardScriptOutput, pruneBoardTrack, quantizeDrawCoordinate, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, refreshBoardScene, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resolveAnchor, resolveArrow, resolveBoardAnimationCamera, resolveBoardColor, resolveBoardMediaUrl, resolveBoardProperty, resolveBoardScriptHit, resolveCoverRef, resolveFileTitle, resolveItemColor, resolveSceneArrow, resolveSpacePath, rotateAround, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleBoardTrack, sampleRadius, scaleFrames, scaleVector, sceneItemToItem, sceneItemsToRecord, screenOffset, screenPoint, screenToWorld, scriptTemporaryPrefix, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shouldFetchFileExcerpt, sideAnchor, simplifyDrawIndices, splitFrontmatter, stableCullRect, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, titleForBoardItem, toSceneItem, trackReferences, trimDrawPoints, unionRects, validateBoardScriptCommit, validateBoardScriptOutput, visibleWorldRect, withObservedArtifactFacts, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround };
+export { ARROW_BINDING_GAP, ArrowFrameLookup, BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLORS, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_PRESET_NAMES, BOARD_SCHEMA_TARGETS, BOARD_SCRIPT_API, BOARD_SCRIPT_DRAWING_EXAMPLE, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSampler, BoardAnimationSchema, BoardAppMetadata, BoardApplyOptions, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAssetSource, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardCameraFit, BoardCameraFocus, BoardCameraOverride, BoardCameraState, BoardChapter, BoardColor, BoardColorEntry, BoardColorId, BoardColorResolver, BoardColorSchema, BoardColorToken, BoardColorValue, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawInputSample, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseFunction, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardEvaluateOptions, BoardEvaluation, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, type BoardFileSnapshotFacts, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemCapabilities, BoardItemDefinition, BoardItemEntry, BoardItemInput, BoardItemLookup, BoardItemOf, BoardItemResizeMode, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaItemKind, BoardMediaKind, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardNestedAnimationOptions, BoardNormalizedPoint, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlacement, BoardPlayMode, BoardPlayableMedia, BoardPresetName, BoardPresetOptions, BoardPropertySpec, BoardRect, BoardRegistry, BoardReplayActorKind, BoardReplayEntry, BoardReplayPlayer, BoardScene, BoardSceneItem, BoardScreenOffset, BoardScreenPoint, BoardScript, BoardScriptAnchor, BoardScriptContext, BoardScriptEvent, BoardScriptEventOf, BoardScriptFrame, BoardScriptHit, BoardScriptHostEvents, BoardScriptItemPatch, BoardScriptModule, BoardScriptOutput, BoardScriptParameter, BoardScriptSceneOptions, BoardScriptSchema, BoardScriptSnapshot, BoardScriptView, BoardSettings, BoardSettingsSchema, BoardShapeColors, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardStyledToolId, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, type BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardToolStyleMap, BoardToolStylePatch, BoardTrack, BoardTrackSchema, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardWorldOffset, BoardWorldPoint, BoardWorldRect, type BuildSnapshotInput, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompiledAnimation, CompiledBoardAnimations, CompiledTrack, CornerResizeHandle, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_TOOL_STYLES, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, type FileCategory, FilePreviewKind, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, IDENTITY_MATRIX, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, ResizeHandle, ResolvedArrow, ResolvedArrowEnd, type ResolvedCover, SHAPE_KINDS, SceneItem, ScreenPoint, ShapeKind, Size, StrokeRibbonBuilder, StrokeRibbonGeometry, StrokeRibbonMesh, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, VIEWPORT_MARGIN_RATIO, WorldPoint, anchorPoint, angleFromCenter, appendBoardDrawSamples, applyBoardDelta, applyBoardEvaluation, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, arrowHitRadius, arrowPathBounds, autoAnchorSide, availabilityFromError, bendControl, boardAnimationTime, boardColorCssVar, boardDocumentAt, boardEase, boardFontFamily, boardImageKeySource, boardItemOrigin, boardItemSchema, boardJsonSchema, boardModelFormat, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskSource, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, compileBoardAnimations, composeBoardScriptItems, computeDrawBounds, createAppBoardItem, createArrowBoardItem, createBoardAnimationSampler, createBoardEntityId, createBoardItemId, createBoardLayout, createBoardRegistry, createBoardReplayPlayer, createBoardToolStyles, createDocumentLayout, createDocumentState, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createStrokeRibbonBuilder, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, degToRad, diffBoardDocuments, diffMergePatch, distanceToArrow, distanceToStroke, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, framePoint, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, handlePosition, hasAuthoredSize, hasBoardScripts, imageAssetKey, inferBoardMediaKind, invertMatrix, isArrowBinding, isBoardColorId, isBoardColorString, isBoardEase, isBoardModelItem, isBoardPath, isBoardPresetName, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isFileSnapshotFresh, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, isShapeKind, isStrokeCorner, itemBounds, layoutBoardText, listBoardPresets, listBoardProperties, mediaFrameSize, mergeFileSnapshot, mergePatch, multiplyMatrix, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, orderBoardItems, panBy, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, parseHexColor, pathMidpoint, pathPointAt, pickBoardColor, placeBoardOverlay, placeItem, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, pointsRect, prepareBoardScriptOutput, pruneBoardTrack, quantizeDrawCoordinate, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, refreshBoardScene, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resolveAnchor, resolveArrow, resolveBoardAnimationCamera, resolveBoardColor, resolveBoardMediaUrl, resolveBoardProperty, resolveBoardScriptHit, resolveCoverRef, resolveFileTitle, resolveItemColor, resolveSceneArrow, resolveSpacePath, rotateAround, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleBoardTrack, sampleRadius, scaleFrames, scaleVector, sceneItemToItem, sceneItemsToRecord, screenOffset, screenPoint, screenToWorld, scriptTemporaryPrefix, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shouldFetchFileExcerpt, sideAnchor, simplifyDrawIndices, splitFrontmatter, stableCullRect, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, titleForBoardItem, toSceneItem, trackReferences, trimDrawPoints, unionRects, validateBoardScriptCommit, validateBoardScriptOutput, visibleWorldRect, withObservedArtifactFacts, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround };

package/dist/board/model/index.js

@@ -23,7 +23,7 @@ import { buildStrokeOutline, buildStrokeRibbonGeometry, computeDrawBounds, creat
 import { appendBoardDrawSamples, quantizeDrawCoordinate } from "./draw-input.js";
 import { BOARD_EXPORT_MAX_TEXTURES, selectBoardExportAssets } from "./export-assets.js";
 import { BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, exportItemBounds, normalizeBoardDocument, planBoardExport } from "./export-plan.js";
-import { getMediaExtension, getMediaResourceTitle, inferBoardMediaKind } from "./media.js";
+import { boardModelFormat, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind, isBoardModelItem } from "./media.js";
 import { FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, buildCodeExcerpt, buildFileExcerpt, buildFileSnapshot, fileBaseName, fileCategory, fileStem, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, resolveCoverRef, resolveFileTitle, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./file-snapshot.js";
 import { availabilityFromError, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot } from "./file-preview.js";
 import { BOARD_COLORS, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor, resolveItemColor } from "./palette.js";
@@ -38,4 +38,4 @@ import { boardItemOrigin, boardOriginKey, createAppBoardItem, createArrowBoardIt
 import { createBoardRegistry, defaultBoardRegistry } from "./items/registry.js";
 import { playableBoardMedia, playableBoardMediaList, resetBoardPlaybackUrlCache, resolveBoardMediaUrl } from "./media-playback.js";
 import { boardReplayActorKind, createBoardReplayPlayer } from "./replay.js";
-export { ARROW_BINDING_GAP, BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLORS, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_PRESET_NAMES, BOARD_SCHEMA_TARGETS, BOARD_SCRIPT_API, BOARD_SCRIPT_DRAWING_EXAMPLE, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_TOOL_STYLES, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, IDENTITY_MATRIX, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SHAPE_KINDS, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, VIEWPORT_MARGIN_RATIO, anchorPoint, angleFromCenter, appendBoardDrawSamples, applyBoardDelta, applyBoardEvaluation, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, arrowHitRadius, arrowPathBounds, autoAnchorSide, availabilityFromError, bendControl, boardAnimationTime, boardColorCssVar, boardDocumentAt, boardEase, boardFontFamily, boardImageKeySource, boardItemOrigin, boardItemSchema, boardJsonSchema, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskSource, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, compileBoardAnimations, composeBoardScriptItems, computeDrawBounds, createAppBoardItem, createArrowBoardItem, createBoardAnimationSampler, createBoardEntityId, createBoardItemId, createBoardLayout, createBoardRegistry, createBoardReplayPlayer, createBoardToolStyles, createDocumentLayout, createDocumentState, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createStrokeRibbonBuilder, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, degToRad, diffBoardDocuments, diffMergePatch, distanceToArrow, distanceToStroke, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, framePoint, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, handlePosition, hasAuthoredSize, hasBoardScripts, imageAssetKey, inferBoardMediaKind, invertMatrix, isArrowBinding, isBoardColorId, isBoardColorString, isBoardEase, isBoardPath, isBoardPresetName, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isFileSnapshotFresh, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, isShapeKind, isStrokeCorner, itemBounds, layoutBoardText, listBoardPresets, listBoardProperties, mediaFrameSize, mergeFileSnapshot, mergePatch, multiplyMatrix, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, orderBoardItems, panBy, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, parseHexColor, pathMidpoint, pathPointAt, pickBoardColor, placeBoardOverlay, placeItem, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, pointsRect, prepareBoardScriptOutput, pruneBoardTrack, quantizeDrawCoordinate, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, refreshBoardScene, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resolveAnchor, resolveArrow, resolveBoardAnimationCamera, resolveBoardColor, resolveBoardMediaUrl, resolveBoardProperty, resolveBoardScriptHit, resolveCoverRef, resolveFileTitle, resolveItemColor, resolveSceneArrow, resolveSpacePath, rotateAround, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleBoardTrack, sampleRadius, scaleFrames, scaleVector, sceneItemToItem, sceneItemsToRecord, screenOffset, screenPoint, screenToWorld, scriptTemporaryPrefix, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shouldFetchFileExcerpt, sideAnchor, simplifyDrawIndices, splitFrontmatter, stableCullRect, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, titleForBoardItem, toSceneItem, trackReferences, trimDrawPoints, unionRects, validateBoardScriptCommit, validateBoardScriptOutput, visibleWorldRect, withObservedArtifactFacts, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround };
+export { ARROW_BINDING_GAP, BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLORS, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_PRESET_NAMES, BOARD_SCHEMA_TARGETS, BOARD_SCRIPT_API, BOARD_SCRIPT_DRAWING_EXAMPLE, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_TOOL_STYLES, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, IDENTITY_MATRIX, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SHAPE_KINDS, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, VIEWPORT_MARGIN_RATIO, anchorPoint, angleFromCenter, appendBoardDrawSamples, applyBoardDelta, applyBoardEvaluation, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, arrowHitRadius, arrowPathBounds, autoAnchorSide, availabilityFromError, bendControl, boardAnimationTime, boardColorCssVar, boardDocumentAt, boardEase, boardFontFamily, boardImageKeySource, boardItemOrigin, boardItemSchema, boardJsonSchema, boardModelFormat, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskSource, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, compileBoardAnimations, composeBoardScriptItems, computeDrawBounds, createAppBoardItem, createArrowBoardItem, createBoardAnimationSampler, createBoardEntityId, createBoardItemId, createBoardLayout, createBoardRegistry, createBoardReplayPlayer, createBoardToolStyles, createDocumentLayout, createDocumentState, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createStrokeRibbonBuilder, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, degToRad, diffBoardDocuments, diffMergePatch, distanceToArrow, distanceToStroke, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, framePoint, frameRayIntersection, frameRect, getMediaExtension, getMediaResourceTitle, handlePosition, hasAuthoredSize, hasBoardScripts, imageAssetKey, inferBoardMediaKind, invertMatrix, isArrowBinding, isBoardColorId, isBoardColorString, isBoardEase, isBoardModelItem, isBoardPath, isBoardPresetName, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isFileSnapshotFresh, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, isShapeKind, isStrokeCorner, itemBounds, layoutBoardText, listBoardPresets, listBoardProperties, mediaFrameSize, mergeFileSnapshot, mergePatch, multiplyMatrix, normalizeBoardDocument, normalizeBoardRemoteUrl, normalizeRotation, normalizeViewport, normalizedPoint, orderBoardItems, panBy, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, parseHexColor, pathMidpoint, pathPointAt, pickBoardColor, placeBoardOverlay, placeItem, planBoardExport, playableBoardMedia, playableBoardMediaList, pointToWorld, pointsBounds, pointsRect, prepareBoardScriptOutput, pruneBoardTrack, quantizeDrawCoordinate, radToDeg, rankedTaskArtifacts, readCoverFromFrontmatter, readFrontmatterScalars, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, refreshBoardScene, resetBoardPlaybackUrlCache, resizeFrame, resizeFrameToSize, resolveAnchor, resolveArrow, resolveBoardAnimationCamera, resolveBoardColor, resolveBoardMediaUrl, resolveBoardProperty, resolveBoardScriptHit, resolveCoverRef, resolveFileTitle, resolveItemColor, resolveSceneArrow, resolveSpacePath, rotateAround, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleBoardTrack, sampleRadius, scaleFrames, scaleVector, sceneItemToItem, sceneItemsToRecord, screenOffset, screenPoint, screenToWorld, scriptTemporaryPrefix, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shouldFetchFileExcerpt, sideAnchor, simplifyDrawIndices, splitFrontmatter, stableCullRect, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, titleForBoardItem, toSceneItem, trackReferences, trimDrawPoints, unionRects, validateBoardScriptCommit, validateBoardScriptOutput, visibleWorldRect, withObservedArtifactFacts, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround };

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

@@ -2,7 +2,7 @@ import { BoardMediaOriginSchema, parseBoardItem } from "../../../protocol/dist/b
 import { pointsRect } from "../../../protocol/dist/board-layout.js";
 import { featuredTaskArtifact } from "../../../protocol/dist/board-task.js";
 import { quantizeDrawCoordinate } from "../draw-input.js";
-import { getMediaResourceTitle, inferBoardMediaKind } from "../media.js";
+import { boardModelFormat, getMediaResourceTitle, inferBoardMediaKind } from "../media.js";
 import { fileStem } from "../file-snapshot.js";
 import { filePreviewKind } from "../file-preview.js";
 import { DEFAULT_BOARD_TOOL_STYLES } from "../tool-styles.js";
@@ -32,6 +32,10 @@ const DEFAULT_FILE_SIZE = {
 	width: 260,
 	height: 132
 };
+const DEFAULT_MODEL_SIZE = {
+	width: 264,
+	height: 264
+};
 const DEFAULT_FILE_COVER_SIZE = {
 	width: 260,
 	height: 208
@@ -110,7 +114,7 @@ function createMediaBoardItem(path, x, y, snapshot = {}, id = createBoardItemId(
 		id,
 		item: item({
 			type: "file",
-			...centered(x, y, filePreviewKind(snapshot) === "cover" ? DEFAULT_FILE_COVER_SIZE : DEFAULT_FILE_SIZE),
+			...centered(x, y, boardModelFormat(path, snapshot.mimeType) ? DEFAULT_MODEL_SIZE : filePreviewKind(snapshot) === "cover" ? DEFAULT_FILE_COVER_SIZE : DEFAULT_FILE_SIZE),
 			props: {
 				src: path,
 				snapshot: cleanSnapshot({

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

@@ -1,7 +1,11 @@
+import { ModelFormat } from "../../protocol/dist/fs/mime.js";
+import { BoardSceneItem } from "./scene.js";
 //#region src/board/model/media.d.ts
 type BoardMediaKind = "image" | "video" | "audio" | "text" | "file";
 declare function getMediaExtension(value: string): string;
 declare function inferBoardMediaKind(value: string, mimeType?: string | null): BoardMediaKind;
 declare function getMediaResourceTitle(value: string): string;
+declare function boardModelFormat(src: string, mimeType?: string | null): ModelFormat | null;
+declare function isBoardModelItem(item: BoardSceneItem | null | undefined): boolean;
 //#endregion
-export { BoardMediaKind, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind };
+export { BoardMediaKind, boardModelFormat, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind, isBoardModelItem };

package/dist/board/model/media.js

@@ -1,3 +1,5 @@
+import { parseBoardMediaSource } from "../../protocol/dist/board-model.js";
+import { modelFormatForPath } from "../../protocol/dist/fs/mime.js";
 //#region src/board/model/media.ts
 const IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
 	"png",
@@ -72,5 +74,14 @@ function getMediaResourceTitle(value) {
 		return value.split("/").filter(Boolean).pop() || value;
 	}
 }
+function boardModelFormat(src, mimeType) {
+	const source = parseBoardMediaSource(src);
+	if (!source) return null;
+	const path = source.kind === "url" ? source.value.split(/[?#]/, 1)[0] ?? "" : source.value;
+	return modelFormatForPath(path, mimeType);
+}
+function isBoardModelItem(item) {
+	return item?.type === "file" && boardModelFormat(item.props.src, item.props.snapshot?.mimeType) !== null;
+}
 //#endregion
-export { getMediaExtension, getMediaResourceTitle, inferBoardMediaKind };
+export { boardModelFormat, getMediaExtension, getMediaResourceTitle, inferBoardMediaKind, isBoardModelItem };

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

@@ -1,9 +1,10 @@
 import { BoardRenderContext } from "./renderers/board-renderer-registry.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/card-tag.d.ts
-type CardGlyph = "image" | "video" | "audio" | "file" | "task";
+type CardGlyph = "image" | "video" | "audio" | "model" | "file" | "task";
 declare const CARD_TAG_SIZE = 11;
 declare function formatBoardDuration(ms: number): string;
+declare function traceCube(graphics: Graphics, cx: number, cy: number, radius: number): Graphics;
 declare function drawCardGlyph(graphics: Graphics, glyph: CardGlyph, color: number, pixel: boolean): void;
 type CardTag = {
   root: Container;
@@ -21,4 +22,4 @@ declare function syncCardTag(tag: CardTag, input: {
   width: number;
 }, context: BoardRenderContext): void;
 //#endregion
-export { CARD_TAG_SIZE, CardGlyph, CardTag, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, zoomCardTag };
+export { CARD_TAG_SIZE, CardGlyph, CardTag, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, traceCube, zoomCardTag };

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

@@ -40,6 +40,14 @@ const PIXEL_GLYPHS = {
 		".###..",
 		".###.."
 	],
+	model: [
+		"..#...",
+		".###..",
+		"#####.",
+		"#####.",
+		".###..",
+		"..#..."
+	],
 	file: [
 		"####..",
 		"#..##.",
@@ -90,6 +98,9 @@ function drawLineGlyph(graphics, glyph, color) {
 			]) graphics.moveTo(x, 6 - height / 2).lineTo(x, 6 + height / 2);
 			graphics.stroke(line);
 			return;
+		case "model":
+			traceCube(graphics, 6, 6, 4.5).stroke(line);
+			return;
 		case "file":
 			graphics.poly([
 				2.5,
@@ -127,6 +138,25 @@ function drawLineGlyph(graphics, glyph, color) {
 			return;
 	}
 }
+function traceCube(graphics, cx, cy, radius) {
+	const dx = radius * .866;
+	const dy = radius / 2;
+	graphics.poly([
+		cx,
+		cy - radius,
+		cx + dx,
+		cy - dy,
+		cx + dx,
+		cy + dy,
+		cx,
+		cy + radius,
+		cx - dx,
+		cy + dy,
+		cx - dx,
+		cy - dy
+	]).moveTo(cx - dx, cy - dy).lineTo(cx, cy).lineTo(cx + dx, cy - dy).moveTo(cx, cy).lineTo(cx, cy + radius);
+	return graphics;
+}
 function drawCardGlyph(graphics, glyph, color, pixel) {
 	if (!pixel) {
 		drawLineGlyph(graphics, glyph, color);
@@ -202,4 +232,4 @@ function syncCardTag(tag, input, context) {
 	zoomCardTag(tag, context.zoom);
 }
 //#endregion
-export { CARD_TAG_SIZE, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, zoomCardTag };
+export { CARD_TAG_SIZE, createCardTag, drawCardGlyph, formatBoardDuration, syncCardTag, traceCube, zoomCardTag };

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

@@ -1,5 +1,7 @@
 import { BoardTextItem } from "../../protocol/dist/board-model.js";
+import { BoardFrame } from "../../protocol/dist/board-layout.js";
 import "../../protocol/dist/index.js";
+import { Rect } from "../model/geometry.js";
 import { BoardScene } from "../model/scene.js";
 //#region src/board/render/diagnostics.d.ts
 type BoardRenderDiagnostic = {
@@ -15,6 +17,22 @@ declare function measureBoardText(props: BoardTextItem["props"]): {
   lineHeight: number;
   missingCharacters: string;
 };
-declare function inspectBoardScene(scene: BoardScene, limit?: number): BoardRenderDiagnostic[];
+declare function inspectBoardItems(scene: BoardScene, ids?: ReadonlySet<string>): {
+  diagnostics: BoardRenderDiagnostic[];
+  items: {
+    id: string;
+    bounds: BoardFrame;
+    worldBounds: Rect;
+    opacity: number;
+    text?: {
+      width: number;
+      height: number;
+      lines: string[];
+      lineHeight: number;
+      missingCharacters: string;
+    } | undefined;
+  }[];
+};
+declare function inspectBoardScene(scene: BoardScene, limit?: number, ids?: ReadonlySet<string>): BoardRenderDiagnostic[];
 //#endregion
-export { BoardRenderDiagnostic, inspectBoardScene, measureBoardText };
+export { BoardRenderDiagnostic, inspectBoardItems, inspectBoardScene, measureBoardText };

package/dist/board/render/diagnostics.js

@@ -46,12 +46,24 @@ function measureBoardText(props) {
 		missingCharacters: characters
 	};
 }
-function inspectBoardScene(scene, limit = 100) {
+function inspectBoardItems(scene, ids) {
+	return {
+		diagnostics: inspectBoardScene(scene, 100, ids),
+		items: scene.items.filter((item) => !ids || ids.has(item.id)).map((item) => ({
+			id: item.id,
+			bounds: item.frame,
+			worldBounds: itemBounds(item.frame),
+			opacity: scene.opacity(item.id),
+			...item.type === "text" ? { text: measureBoardText(item.props) } : {}
+		}))
+	};
+}
+function inspectBoardScene(scene, limit = 100, ids) {
 	ensureBoardTextMeasurement();
 	const diagnostics = [];
 	const texts = scene.items.filter((item) => item.type === "text" && scene.opacity(item.id) > .01);
 	const push = (entry) => {
-		if (diagnostics.length < limit) diagnostics.push(entry);
+		if (diagnostics.length < limit && (!ids || ids.has(entry.item) || Boolean(entry.related && ids.has(entry.related)))) diagnostics.push(entry);
 	};
 	for (const item of scene.items) {
 		if (diagnostics.length >= limit) break;
@@ -63,7 +75,7 @@ function inspectBoardScene(scene, limit = 100) {
 	let glyphBudget = 256;
 	for (const item of texts) {
 		if (diagnostics.length >= limit || item.type !== "text") break;
-		if (glyphBudget-- > 0) {
+		if ((!ids || ids.has(item.id)) && glyphBudget-- > 0) {
 			const measured = measureBoardText(item.props);
 			if (measured.missingCharacters) push({
 				code: "glyph-unavailable",
@@ -102,6 +114,7 @@ function inspectBoardScene(scene, limit = 100) {
 			const b = sorted[j];
 			if (!b) continue;
 			if (b.rect.x >= a.rect.x + a.rect.width) break;
+			if (ids && !ids.has(a.item.id) && !ids.has(b.item.id)) continue;
 			if (++comparisons > 1e4) return diagnostics;
 			if (a.item.parent === b.item.parent && rectsIntersect(a.rect, b.rect)) push({
 				code: "text-overlap",
@@ -114,4 +127,4 @@ function inspectBoardScene(scene, limit = 100) {
 	return diagnostics;
 }
 //#endregion
-export { inspectBoardScene, measureBoardText };
+export { inspectBoardItems, inspectBoardScene, measureBoardText };