@neta-art/cohub 12.1.1 → 12.3.0

package/dist/board/model/index.js

@@ -1,37 +1,39 @@
 import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } from "../../protocol/dist/board-constants.js";
 import { isPublicBoardRemoteAddress, normalizeBoardRemoteUrl } from "../../protocol/dist/board-url.js";
-import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "../../protocol/dist/board-model.js";
-import { IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor } from "../../protocol/dist/board-layout.js";
-import { applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "../../protocol/dist/board-patch.js";
+import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardItemPreviewSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemPreview, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "../../protocol/dist/board-model.js";
 import { isBoardPath, parseBoardManifest, serializeBoardManifest } from "../../protocol/dist/board.js";
-import { BOARD_SCHEMA_TARGETS, boardJsonSchema, boardSchemaOverview } from "../../protocol/dist/board-schema.js";
 import { BOARD_TASK_SOURCE_PREFIX, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts } from "../../protocol/dist/board-task.js";
-import { placeBoardOverlay } from "./overlay-placement.js";
-import { boardScriptItems, hasBoardScripts } from "./script-index.js";
-import { CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, EDGE_RESIZE_HANDLES, FIT_PADDING, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, VIEWPORT_MARGIN_RATIO, angleFromCenter, cameraForFocus, cameraForRect, cameraForState, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, normalizedPoint, panBy, pointToWorld, pointsBounds, radToDeg, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenOffset, screenPoint, screenToWorld, selectionBounds, stableCullRect, unionRects, visibleWorldRect, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround } from "./geometry.js";
-import { boardScriptScope, composeBoardScriptItems, prepareBoardScriptOutput, scriptTemporaryPrefix, validateBoardScriptCommit, validateBoardScriptOutput } from "./script-scene.js";
-import { boardScriptHitVisible, boardScriptTarget, resolveBoardScriptHit } from "./script-hit.js";
-import { BOARD_SCRIPT_API } from "./script-api.js";
-import { BOARD_SCRIPT_DRAWING_EXAMPLE } from "./script-example.js";
+import { IDENTITY_MATRIX, adoptBoardNaturalSize, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, fitBoardMediaSize, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextLayouter, sideAnchor } from "../../protocol/dist/board-layout.js";
+import { applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "../../protocol/dist/board-patch.js";
+import { BOARD_SCHEMA_TARGETS, boardJsonSchema, boardSchemaOverview } from "../../protocol/dist/board-schema.js";
 import { applyBoardEvaluation, boardAnimationTime, boardDocumentAt, boardEase, compileBoardAnimations, evaluateBoardAnimations, parseHexColor, sampleBoardTrack } from "./animation.js";
 import { buildBoardScene, orderBoardItems, placeItem, refreshBoardScene, sceneItemToItem, sceneItemsToRecord, toSceneItem } from "./scene.js";
+import { CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, EDGE_RESIZE_HANDLES, FIT_PADDING, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, VIEWPORT_MARGIN_RATIO, angleFromCenter, cameraForFocus, cameraForRect, cameraForState, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, normalizedPoint, panBy, pointToWorld, pointsBounds, radToDeg, rectCenter, rectContainsPoint, rectForCameraFocus, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenOffset, screenPoint, screenToWorld, selectionBounds, stableCullRect, unionRects, visibleWorldRect, worldOffset, worldPoint, worldRect, worldToScreen, zoomAround } from "./geometry.js";
 import { createBoardAnimationSampler, resolveBoardAnimationCamera } from "./sampling.js";
-import { boardPathTrack, boardSequence, boardSequencePatch } from "./authoring.js";
-import { BOARD_PRESET_NAMES, boardNestedAnimation, boardNestedAnimationTrack, boardPresetTracks, isBoardPresetName, listBoardPresets } from "./presets.js";
+import { BOARD_THEME_IDS } from "./themes.js";
+import { BOARD_COLORS, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor, resolveItemColor } from "./palette.js";
 import { ARROW_BINDING_GAP, arrowHitRadius, arrowPathBounds, distanceToArrow, pathMidpoint, pathPointAt, resolveAnchor, resolveArrow, resolveSceneArrow } from "./arrow-geometry.js";
-import { buildStrokeOutline, buildStrokeRibbonGeometry, computeDrawBounds, createStrokeRibbonBuilder, distanceToStroke, isStrokeCorner, sampleRadius, simplifyDrawIndices, trimDrawPoints } from "./draw-geometry.js";
-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 { BOARD_FRAME_LABEL_LINE_HEIGHT, BOARD_FRAME_LABEL_SIZE, SHAPE_LABEL_PADDING, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardEditableText, boardFontFamily, frameLabelHitRect, frameLabelOffset, layoutShapeLabel } from "./text-metrics.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";
+import { buildStrokeOutline, buildStrokeRibbonGeometry, computeDrawBounds, createStrokeRibbonBuilder, distanceToStroke, isStrokeCorner, sampleRadius, simplifyDrawIndices, trimDrawPoints } from "./draw-geometry.js";
+import { boardScriptItems, hasBoardScripts } from "./script-index.js";
+import { boardScriptScope, composeBoardScriptItems, prepareBoardScriptOutput, scriptTemporaryPrefix, validateBoardScriptCommit, validateBoardScriptOutput } from "./script-scene.js";
+import { boardScriptHitVisible, boardScriptTarget, resolveBoardScriptHit } from "./script-hit.js";
+import { BOARD_THUMBNAIL_EDGE, boardAssetKey, boardAssetKeySource, boardAssetRefKey, boardTextureEdge, boardTexturePixels, imageAssetKey } from "./asset-key.js";
+import { placeBoardOverlay } from "./overlay-placement.js";
+import { BOARD_SCRIPT_API } from "./script-api.js";
+import { BOARD_SCRIPT_DRAWING_EXAMPLE } from "./script-example.js";
+import { boardPathTrack, boardSequence, boardSequencePatch } from "./authoring.js";
+import { BOARD_PRESET_NAMES, boardNestedAnimation, boardNestedAnimationTrack, boardPresetTracks, isBoardPresetName, listBoardPresets } from "./presets.js";
+import { appendBoardDrawSamples, quantizeDrawCoordinate } from "./draw-input.js";
+import { BOARD_EXPORT_TEXTURE_BYTES, boardTextureBytes, selectBoardExportAssets } from "./export-assets.js";
 import { SHAPE_KINDS, isShapeKind } from "./shape-types.js";
-import { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardFontFamily } from "./text-metrics.js";
 import { DEFAULT_BOARD_TOOL_STYLES, createBoardToolStyles } from "./tool-styles.js";
 import { clientToLocal, elementClientToLocal } from "./client-geometry.js";
-import { boardImageKeySource, imageAssetKey } from "./image-key.js";
+import { boardMediaTarget, probeBoardMediaSize, settleBoardMediaSizes } from "./media-sizes.js";
 import { FULL_CAPABILITIES, defineBoardItem } from "./items/definition.js";
 import { builtinBoardItems } from "./items/builtin.js";
 import { createBoardEntityId, createBoardItemId } from "./items/id.js";
@@ -39,4 +41,4 @@ import { boardItemOrigin, boardOriginKey, boardTaskCardSize, createAppBoardItem,
 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, boardModelFormat, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskCardSize, boardTaskSource, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, clientToLocal, 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, elementClientToLocal, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitBoardMediaSize, 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 };
+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_TEXTURE_BYTES, BOARD_EXTENSION_TYPE_PATTERN, BOARD_FRAME_LABEL_LINE_HEIGHT, BOARD_FRAME_LABEL_SIZE, 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, BOARD_THEME_IDS, BOARD_THUMBNAIL_EDGE, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardItemPreviewSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, 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, SHAPE_LABEL_PADDING, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, VIEWPORT_MARGIN_RATIO, adoptBoardNaturalSize, anchorPoint, angleFromCenter, appendBoardDrawSamples, applyBoardDelta, applyBoardEvaluation, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, arrowHitRadius, arrowPathBounds, autoAnchorSide, availabilityFromError, bendControl, boardAnimationTime, boardAssetKey, boardAssetKeySource, boardAssetRefKey, boardColorCssVar, boardDocumentAt, boardEase, boardEditableText, boardFontFamily, boardItemOrigin, boardItemPreview, boardItemSchema, boardJsonSchema, boardMediaTarget, boardModelFormat, boardNestedAnimation, boardNestedAnimationTrack, boardOriginKey, boardPatchTouches, boardPathTrack, boardPresetTracks, boardReplayActorKind, boardSchemaOverview, boardScriptHitVisible, boardScriptItems, boardScriptScope, boardScriptTarget, boardSequence, boardSequencePatch, boardTaskCardSize, boardTaskSource, boardTextureBytes, boardTextureEdge, boardTexturePixels, buildBoardScene, buildCodeExcerpt, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, buildStrokeRibbonGeometry, builtinBoardItems, cameraForFocus, cameraForRect, cameraForState, clamp, clampBoardFontSize, clampBoardStrokeSize, clampBoardFontSize as clampBoardTextFontSize, clampZoom, clientToLocal, 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, elementClientToLocal, emptyBoardDocument, estimateTextWidth, evaluateBoardAnimations, expandRect, exportItemBounds, featuredTaskArtifact, fileBaseName, fileCategory, fileCategoryAccent, fileMetaLine, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileStem, fileTypeLabel, fitBoardMediaSize, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameLabelHitRect, frameLabelOffset, 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, layoutShapeLabel, 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, probeBoardMediaSize, 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, setBoardTextLayouter, settleBoardMediaSizes, 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

@@ -1,12 +1,12 @@
 import { BOARD_DEFAULT_SIZES } from "../../../protocol/dist/board-constants.js";
 import { BoardMediaOriginSchema, parseBoardItem } from "../../../protocol/dist/board-model.js";
-import { fitBoardMediaSize, pointsRect } from "../../../protocol/dist/board-layout.js";
 import { featuredTaskArtifact } from "../../../protocol/dist/board-task.js";
+import { fitBoardMediaSize, pointsRect } from "../../../protocol/dist/board-layout.js";
 import "../geometry.js";
-import { quantizeDrawCoordinate } from "../draw-input.js";
 import { boardModelFormat, getMediaResourceTitle, inferBoardMediaKind } from "../media.js";
 import { fileStem } from "../file-snapshot.js";
 import { filePreviewKind } from "../file-preview.js";
+import { quantizeDrawCoordinate } from "../draw-input.js";
 import { DEFAULT_BOARD_TOOL_STYLES } from "../tool-styles.js";
 import { createBoardItemId } from "./id.js";
 //#region src/board/model/items/create.ts
@@ -249,7 +249,7 @@ function titleForBoardItem(value) {
 		case "task": return value.props.snapshot.title;
 		case "effect": return value.props.kind;
 		case "custom": return value.script.src.split("/").pop() ?? "Custom";
-		default: return value.type;
+		default: return value.preview?.title || value.type;
 	}
 }
 const RESULT_GAP = 24;

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

@@ -15,10 +15,18 @@ type BoardItemCapabilities = {
   canLock: boolean;
 };
 type BoardItemResizeMode = "none" | "uniform" | "free";
+/**
+ * What a plain press on an unselected item does. `select` selects it, like any
+ * item. `tap` opens it: a quick press reports an activation instead of selecting,
+ * a drag moves it (or pans, with the hand tool or read-only) without selecting,
+ * and hovering shows a pointer instead of connection ports.
+ */
+type BoardItemActivation = "select" | "tap";
 declare const FULL_CAPABILITIES: BoardItemCapabilities;
 type BoardItemDefinition<Props extends Record<string, unknown> = Record<string, unknown>> = {
   type: BoardItemType;
   capabilities?: Partial<BoardItemCapabilities>;
+  activation?: BoardItemActivation;
   size?: {
     width: number;
     height: number;
@@ -32,4 +40,4 @@ type BoardItemOf<Definition> = Definition extends BoardItemDefinition<infer Prop
 } : never;
 declare function defineBoardItem<Props extends Record<string, unknown>>(definition: BoardItemDefinition<Props>): BoardItemDefinition<Props>;
 //#endregion
-export { BoardItemCapabilities, BoardItemDefinition, BoardItemOf, BoardItemResizeMode, FULL_CAPABILITIES, defineBoardItem };
+export { BoardItemActivation, BoardItemCapabilities, BoardItemDefinition, BoardItemOf, BoardItemResizeMode, FULL_CAPABILITIES, defineBoardItem };

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

@@ -1,6 +1,6 @@
-import { BoardItemCapabilities, BoardItemDefinition, BoardItemOf, BoardItemResizeMode, FULL_CAPABILITIES, defineBoardItem } from "./definition.js";
+import { BoardItemActivation, BoardItemCapabilities, BoardItemDefinition, BoardItemOf, BoardItemResizeMode, FULL_CAPABILITIES, defineBoardItem } from "./definition.js";
 import { builtinBoardItems } from "./builtin.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, boardTaskCardSize, builtinBoardItems, createAppBoardItem, createArrowBoardItem, createBoardEntityId, createBoardItemId, createBoardRegistry, createDrawBoardItem, createFileNodeForPath, createFrameBoardItem, createMediaBoardItem, createShapeBoardItem, createTaskBoardItem, createTaskResultItems, createTextBoardItem, defaultBoardRegistry, defineBoardItem, mediaFrameSize, titleForBoardItem };
+export { BoardAppMetadata, BoardItemActivation, 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/registry.d.ts

@@ -2,7 +2,7 @@ import { BoardItem } from "../../../protocol/dist/board-model.js";
 import "../../../protocol/dist/index.js";
 import { Rect, WorldPoint } from "../geometry.js";
 import { BoardSceneItem } from "../scene.js";
-import { BoardItemCapabilities, BoardItemDefinition, BoardItemResizeMode } from "./definition.js";
+import { BoardItemActivation, BoardItemCapabilities, BoardItemDefinition, BoardItemResizeMode } from "./definition.js";
 import { BoardItemEntry } from "./create.js";
 //#region src/board/model/items/registry.d.ts
 type BoardItemInput = {
@@ -18,6 +18,7 @@ type BoardRegistry = {
   readonly definitions: readonly BoardItemDefinition[];
   get(type: string): BoardItemDefinition | undefined;
   capabilities(item: Pick<BoardItem, "type">): BoardItemCapabilities;
+  activation(item: Pick<BoardItem, "type">): BoardItemActivation;
   resizeMode(item: Pick<BoardItem, "type">): BoardItemResizeMode;
   bounds(item: BoardSceneItem): Rect;
   hitTest(item: BoardSceneItem, point: WorldPoint): boolean;

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

@@ -35,6 +35,7 @@ function createBoardRegistry(definitions = []) {
 		definitions: [...byType.values()],
 		get: (type) => byType.get(type),
 		capabilities: (item) => capabilitiesOf(item.type),
+		activation: (item) => byType.get(item.type)?.activation ?? "select",
 		resizeMode(item) {
 			const value = capabilitiesOf(item.type);
 			if (!value.canResize) return "none";

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

@@ -0,0 +1,28 @@
+import { BoardItem } from "../../protocol/dist/board-model.js";
+import "../../protocol/dist/index.js";
+//#region src/board/model/media-sizes.d.ts
+type BoardMediaSize = {
+  width: number;
+  height: number;
+};
+type BoardMediaTarget = {
+  id: string;
+  type: "image" | "video";
+  source: {
+    kind: "file" | "url";
+    value: string;
+  };
+};
+type BoardMediaFileResolver = (path: string, type: BoardMediaTarget["type"], signal?: AbortSignal) => Promise<BoardMediaSize | string | null>;
+type BoardMediaSizeOptions = {
+  resolveFile?: BoardMediaFileResolver;
+  signal?: AbortSignal;
+};
+declare function boardMediaTarget(id: string, item: BoardItem): BoardMediaTarget | null;
+declare function probeBoardMediaSize(target: Omit<BoardMediaTarget, "id">, options?: BoardMediaSizeOptions): Promise<BoardMediaSize | null>;
+/** Probes each unique media source once; unresolved items are left as is. */
+declare function settleBoardMediaSizes(items: Readonly<Record<string, BoardItem>>, options?: Omit<BoardMediaSizeOptions, "signal"> & {
+  timeoutMs?: number;
+}): Promise<Record<string, BoardItem>>;
+//#endregion
+export { BoardMediaFileResolver, BoardMediaSize, BoardMediaSizeOptions, BoardMediaTarget, boardMediaTarget, probeBoardMediaSize, settleBoardMediaSizes };

package/dist/board/model/media-sizes.js

@@ -0,0 +1,64 @@
+import { probeMediaSize } from "../../protocol/dist/core/media.js";
+import { parseBoardMediaSource } from "../../protocol/dist/board-model.js";
+import { featuredTaskArtifact } from "../../protocol/dist/board-task.js";
+import { adoptBoardNaturalSize } from "../../protocol/dist/board-layout.js";
+//#region src/board/model/media-sizes.ts
+function boardMediaTarget(id, item) {
+	if (item.type === "image" || item.type === "video") {
+		if (item.props.snapshot?.naturalWidth && item.props.snapshot.naturalHeight) return null;
+		const source = parseBoardMediaSource(item.props.src);
+		return source ? {
+			id,
+			type: item.type,
+			source
+		} : null;
+	}
+	if (item.type !== "task") return null;
+	const artifact = featuredTaskArtifact(item.props.snapshot.artifacts);
+	if (artifact?.type !== "image" && artifact?.type !== "video" || artifact.naturalWidth && artifact.naturalHeight) return null;
+	return {
+		id,
+		type: artifact.type,
+		source: {
+			kind: "url",
+			value: artifact.url
+		}
+	};
+}
+async function probeBoardMediaSize(target, options = {}) {
+	const { type, source } = target;
+	try {
+		const resolved = source.kind === "url" ? source.value : await options.resolveFile?.(source.value, type, options.signal);
+		if (typeof resolved !== "string") return resolved ?? null;
+		return await probeMediaSize(resolved, type, { signal: options.signal });
+	} catch {
+		return null;
+	}
+}
+const CONCURRENCY = 8;
+/** Probes each unique media source once; unresolved items are left as is. */
+async function settleBoardMediaSizes(items, options = {}) {
+	const targets = Object.entries(items).flatMap(([id, item]) => boardMediaTarget(id, item) ?? []);
+	const signal = AbortSignal.timeout(options.timeoutMs ?? 5e3);
+	const probes = /* @__PURE__ */ new Map();
+	const settled = {};
+	let next = 0;
+	const work = async () => {
+		for (let target = targets[next++]; target; target = targets[next++]) {
+			const key = `${target.type}:${target.source.kind}:${target.source.value}`;
+			const probe = probes.get(key) ?? probeBoardMediaSize(target, {
+				...options,
+				signal
+			});
+			probes.set(key, probe);
+			const size = await probe;
+			const item = items[target.id];
+			const adopted = size && item && adoptBoardNaturalSize(item, size);
+			if (adopted) settled[target.id] = adopted;
+		}
+	};
+	await Promise.all(Array.from({ length: CONCURRENCY }, work));
+	return settled;
+}
+//#endregion
+export { boardMediaTarget, probeBoardMediaSize, settleBoardMediaSizes };

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

@@ -13,6 +13,7 @@ type BoardColorEntry = {
   dark: BoardColorValue;
   light: BoardColorValue;
 };
+/** Swatches with the colors of the default dark and light themes. */
 declare const BOARD_COLORS: readonly BoardColorEntry[];
 declare const DEFAULT_BOARD_COLOR: BoardColorId;
 declare function isBoardColorId(value: unknown): value is BoardColorId;

package/dist/board/model/palette.js

@@ -1,134 +1,24 @@
+import { BOARD_COLOR_TOKENS } from "../../protocol/dist/board-model.js";
+import { BOARD_THEME_DATA } from "./themes.js";
 //#region src/board/model/palette.ts
-const LABEL_DARK = 16053492;
-const LABEL_LIGHT = 1579035;
-const BOARD_COLORS = [
-	{
-		id: "brand",
-		label: "Brand",
-		dark: {
-			stroke: 16734751,
-			fill: 16734751,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 15222030,
-			fill: 15222030,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "neutral",
-		label: "Neutral",
-		dark: {
-			stroke: 10133670,
-			fill: 10133670,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 6251368,
-			fill: 6251368,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "black",
-		label: "Black",
-		dark: {
-			stroke: 0,
-			fill: 0,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 0,
-			fill: 0,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "white",
-		label: "White",
-		dark: {
-			stroke: 16777215,
-			fill: 16777215,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 16777215,
-			fill: 16777215,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "blue",
-		label: "Blue",
-		dark: {
-			stroke: 3718648,
-			fill: 3718648,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 2450411,
-			fill: 2450411,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "green",
-		label: "Green",
-		dark: {
-			stroke: 3462041,
-			fill: 3462041,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 1483594,
-			fill: 1483594,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "amber",
-		label: "Amber",
-		dark: {
-			stroke: 16096779,
-			fill: 16096779,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 14251782,
-			fill: 14251782,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "violet",
-		label: "Violet",
-		dark: {
-			stroke: 10980346,
-			fill: 10980346,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 8141549,
-			fill: 8141549,
-			label: LABEL_LIGHT
-		}
-	},
-	{
-		id: "rose",
-		label: "Rose",
-		dark: {
-			stroke: 16478597,
-			fill: 16478597,
-			label: LABEL_DARK
-		},
-		light: {
-			stroke: 14753096,
-			fill: 14753096,
-			label: LABEL_LIGHT
-		}
-	}
-];
+const COLOR_LABELS = {
+	brand: "Brand",
+	neutral: "Neutral",
+	black: "Black",
+	white: "White",
+	blue: "Blue",
+	green: "Green",
+	amber: "Amber",
+	violet: "Violet",
+	rose: "Rose"
+};
+/** Swatches with the colors of the default dark and light themes. */
+const BOARD_COLORS = BOARD_COLOR_TOKENS.map((id) => ({
+	id,
+	label: COLOR_LABELS[id],
+	dark: { ...BOARD_THEME_DATA.dark.colors[id] },
+	light: { ...BOARD_THEME_DATA.light.colors[id] }
+}));
 const DEFAULT_BOARD_COLOR = "brand";
 const COLOR_INDEX = new Map(BOARD_COLORS.map((entry) => [entry.id, entry]));
 function isBoardColorId(value) {

package/dist/board/model/sampling.js

@@ -1,7 +1,7 @@
 import { arrowBindings } from "../../protocol/dist/board-layout.js";
-import { cameraForFocus, cameraForState } from "./geometry.js";
 import { applyBoardEvaluation, boardAnimationTime, compileBoardAnimations, evaluateBoardAnimations } from "./animation.js";
 import { buildBoardScene } from "./scene.js";
+import { cameraForFocus, cameraForState } from "./geometry.js";
 //#region src/board/model/sampling.ts
 function createBoardAnimationSampler(document, animation, options = {}) {
 	const selected = animation ? document.animations[animation] : void 0;

package/dist/board/model/text-metrics.d.ts

@@ -1,7 +1,7 @@
-import { clampBoardFontSize } from "../../protocol/dist/board-layout.js";
+import { BoardTextLayout, clampBoardFontSize } from "../../protocol/dist/board-layout.js";
 import "../../protocol/dist/index.js";
 //#region src/board/model/text-metrics.d.ts
-declare const TEXT_FONT_FAMILY = "Geist";
+declare const TEXT_FONT_FAMILY = "Geist Variable";
 declare const TEXT_FONT_SIZE = 24;
 declare const TEXT_LINE_HEIGHT = 32;
 declare const TEXT_MIN_FONT_SIZE = 2;
@@ -11,5 +11,30 @@ declare function boardFontFamily(font: string, stacks: {
   serif: string;
   mono: string;
 }): string;
+declare const SHAPE_LABEL_PADDING = 8;
+declare function layoutShapeLabel(props: {
+  text: string;
+  fontSize: number;
+}, width: number): BoardTextLayout;
+declare const BOARD_FRAME_LABEL_SIZE = 12;
+declare const BOARD_FRAME_LABEL_LINE_HEIGHT = 1.25;
+declare function frameLabelOffset(size: number): {
+  x: number;
+  y: number;
+};
+declare function frameLabelHitRect(frame: {
+  x: number;
+  y: number;
+  width: number;
+}, size: number): {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+declare function boardEditableText(item: {
+  type: string;
+  props: unknown;
+}): string | null;
 //#endregion
-export { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardFontFamily, clampBoardFontSize as clampBoardTextFontSize };
+export { BOARD_FRAME_LABEL_LINE_HEIGHT, BOARD_FRAME_LABEL_SIZE, SHAPE_LABEL_PADDING, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardEditableText, boardFontFamily, clampBoardFontSize as clampBoardTextFontSize, frameLabelHitRect, frameLabelOffset, layoutShapeLabel };

package/dist/board/model/text-metrics.js

@@ -1,5 +1,5 @@
 import { BOARD_TEXT_FONT_FAMILY } from "../../protocol/dist/board-constants.js";
-import { clampBoardFontSize } from "../../protocol/dist/board-layout.js";
+import { clampBoardFontSize, layoutBoardText } from "../../protocol/dist/board-layout.js";
 //#region src/board/model/text-metrics.ts
 const TEXT_FONT_FAMILY = BOARD_TEXT_FONT_FAMILY;
 const TEXT_FONT_SIZE = 24;
@@ -10,5 +10,39 @@ function boardFontFamily(font, stacks) {
 	if (font === "sans" || font === "serif" || font === "mono") return stacks[font];
 	return `"${font.replaceAll("\"", "")}", ${stacks.sans}`;
 }
+const SHAPE_LABEL_PADDING = 8;
+function layoutShapeLabel(props, width) {
+	return layoutBoardText({
+		text: props.text,
+		fontSize: props.fontSize,
+		fontWeight: 500,
+		font: "sans",
+		lineHeight: 1.4,
+		width: Math.max(1, width - 16)
+	});
+}
+const BOARD_FRAME_LABEL_SIZE = 12;
+const BOARD_FRAME_LABEL_LINE_HEIGHT = 1.25;
+function frameLabelOffset(size) {
+	return {
+		x: 4,
+		y: -(size + 6)
+	};
+}
+function frameLabelHitRect(frame, size) {
+	const above = size + 10;
+	return {
+		x: frame.x,
+		y: frame.y - above,
+		width: Math.max(48, frame.width * .5),
+		height: above + 2
+	};
+}
+function boardEditableText(item) {
+	const props = item.props;
+	if (item.type === "text" || item.type === "shape") return props.text ?? "";
+	if (item.type === "arrow" || item.type === "frame") return props.label ?? "";
+	return null;
+}
 //#endregion
-export { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardFontFamily, clampBoardFontSize as clampBoardTextFontSize };
+export { BOARD_FRAME_LABEL_LINE_HEIGHT, BOARD_FRAME_LABEL_SIZE, SHAPE_LABEL_PADDING, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardEditableText, boardFontFamily, clampBoardFontSize as clampBoardTextFontSize, frameLabelHitRect, frameLabelOffset, layoutShapeLabel };