@neta-art/cohub 3.1.0 → 3.2.0

package/dist/board/image-key.js

@@ -0,0 +1,34 @@
+//#region src/board/image-key.ts
+/**
+* Stable cache key for an item's image resource, or null when it has none.
+*
+* Space files and remote URLs are namespaced so they can never collide, and file
+* cards contribute their cover image — which means covers ride the exact same
+* reference counting, LRU cooling pool and viewport preloading as image nodes,
+* with no second loader to keep in step. The exporter resolves the same keys, so
+* an exported card shows the same picture the editor does.
+*/
+function imageAssetKey(item) {
+	if (item.type === "image") return `file:${item.ref.path}`;
+	if (item.type === "file") {
+		const snapshot = item.snapshot;
+		if (snapshot?.coverPath) return `file:${snapshot.coverPath}`;
+		if (snapshot?.coverUrl) return `url:${snapshot.coverUrl}`;
+		return null;
+	}
+	return null;
+}
+/** The source a key resolves from, recovered from its namespace prefix. */
+function boardImageKeySource(key) {
+	if (key.startsWith("file:")) return {
+		kind: "file",
+		value: key.slice(5)
+	};
+	if (key.startsWith("url:")) return {
+		kind: "url",
+		value: key.slice(4)
+	};
+	return null;
+}
+//#endregion
+export { boardImageKeySource, imageAssetKey };

package/dist/board/index.d.ts

@@ -0,0 +1,16 @@
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardManifest, BoardNodeRecord, BoardRecord, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
+import { BoardExtensionDefinition, BoardExtensionRegistry, BoardPresetDefinition, CompiledSequence, DEFAULT_BOARD_LIMITS, QualityProfile, RenderBounds, TimelineClipInput, TimelineInput, clip, compileSequence, createBoardExtensionRegistry, timeline } from "./animation.js";
+import { ArrowEndpoint, ArrowEndpointSchema, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardNoteItem, BoardNoteItemSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardItemLoose, unknownRealType } from "../protocol/dist/board-document.js";
+import { BOARD_NODE_SOURCE, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, WireBackedBoardItem, boardBootstrapToDocument, boardNodeToItem, isRecord, nodeInputFromRecord, sourceForItem } from "./codec.js";
+import { CORNER_RESIZE_HANDLES, EDGE_RESIZE_HANDLES, FIT_PADDING, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, ResizeHandle, ScreenPoint, Size, VIEWPORT_MARGIN_RATIO, WorldPoint, angleFromCenter, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, panBy, pointToWorld, radToDeg, rectCenter, rectContainsPoint, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenPoint, screenToWorld, selectionBounds, unionRects, visibleWorldRect, worldPoint, worldToScreen, zoomAround } from "./geometry.js";
+import { FrameLookup, ResolvedArrow, anchorToWorld, arrowBounds, bindEndpointAt, distanceToArrow, resolveArrow, resolveEndpoint, sampleQuadratic, translateArrow, worldToAnchor } from "./core/bindings.js";
+import { buildStrokeOutline, computeDrawBounds, distanceToStroke, sampleRadius, simplifyDrawIndices } from "./core/draw-geometry.js";
+import { BOARD_EXPORT_MAX_TEXTURES, BoardExportAssetSelection, selectBoardExportAssets } from "./core/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, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, boardFrameLookup, exportItemBounds, normalizeBoardDocument, planBoardExport } from "./core/export-plan.js";
+import { BoardFileSnapshotFacts, BuildSnapshotInput, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FileAvailability, FilePreviewKind, ResolvedCover, availabilityFromError, buildFileExcerpt, buildFileSnapshot, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot, readCoverFromFrontmatter, resolveCoverRef, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-preview.js";
+import { BOARD_COLORS, BoardColorEntry, BoardColorId, BoardColorValue, BoardShapeColors, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor } from "./core/palette.js";
+import { ArrowShapeProps, DrawShapeProps, FULL_CAPABILITIES, GEO_KINDS, GeoKind, GeoShapeProps, HandleDragResult, ImageShapeProps, NoteShapeProps, ShapeCapabilities, ShapeGeometry, ShapeHandle, ShapeHandleId, ShapeResizeMode, TextShapeProps, VideoShapeProps, isGeoKind, resizeModeForCapabilities } from "./core/shape-types.js";
+import { ShapeDefinition, definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition } from "./core/shape-definition.js";
+import { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardTextLineHeight, clampBoardTextFontSize, measureBoardText, setBoardTextMeasurer } from "./core/text-metrics.js";
+import { boardImageKeySource, imageAssetKey } from "./image-key.js";
+export { ArrowEndpoint, ArrowEndpointSchema, type ArrowShapeProps, BOARD_COLORS, BOARD_DOCUMENT_KIND, 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, BOARD_NODE_SOURCE, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardColorEntry, BoardColorId, BoardColorValue, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionDefinition, BoardExtensionRegistry, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotFacts, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, type BoardManifest, BoardMediaSnapshot, BoardMediaSnapshotSchema, type BoardNodeRecord, BoardNoteItem, BoardNoteItemSchema, BoardPresetDefinition, type BoardRecord, BoardShapeColors, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BuildSnapshotInput, CORNER_RESIZE_HANDLES, CompiledSequence, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_LIMITS, DrawPoint, DrawPointSchema, type DrawShapeProps, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, FilePreviewKind, FrameLookup, GEO_KINDS, type GeoKind, type GeoShapeProps, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, type HandleDragResult, ITEM_BASE_KEYS, type ImageShapeProps, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, type NoteShapeProps, Point, QualityProfile, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, RenderBounds, ResizeHandle, ResolvedArrow, ResolvedCover, ScreenPoint, type ShapeCapabilities, ShapeDefinition, type ShapeGeometry, type ShapeHandle, type ShapeHandleId, type ShapeResizeMode, Size, SpaceFileRef, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, type TextShapeProps, TimelineClipInput, TimelineInput, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, type VideoShapeProps, WireBackedBoardItem, WorldPoint, anchorToWorld, angleFromCenter, arrowBounds, availabilityFromError, bindEndpointAt, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, createBoardExtensionRegistry, definitionForItem, degToRad, distanceToArrow, distanceToStroke, expandRect, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardDocument, normalizeRotation, normalizeViewport, panBy, parseBoardItemLoose, parseBoardManifest, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveCoverRef, resolveEndpoint, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleQuadratic, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, worldPoint, worldToAnchor, worldToScreen, zoomAround };

package/dist/board/index.js

@@ -0,0 +1,16 @@
+import { BoardExtensionRegistry, DEFAULT_BOARD_LIMITS, clip, compileSequence, createBoardExtensionRegistry, timeline } from "./animation.js";
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
+import { ArrowEndpointSchema, BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardNoteItemSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardItemLoose, unknownRealType } from "../protocol/dist/board-document.js";
+import { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardTextLineHeight, clampBoardTextFontSize, measureBoardText, setBoardTextMeasurer } from "./core/text-metrics.js";
+import { BOARD_NODE_SOURCE, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, boardBootstrapToDocument, boardNodeToItem, isRecord, nodeInputFromRecord, sourceForItem } from "./codec.js";
+import { CORNER_RESIZE_HANDLES, 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, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, panBy, pointToWorld, radToDeg, rectCenter, rectContainsPoint, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenPoint, screenToWorld, selectionBounds, unionRects, visibleWorldRect, worldPoint, worldToScreen, zoomAround } from "./geometry.js";
+import { boardImageKeySource, imageAssetKey } from "./image-key.js";
+import { anchorToWorld, arrowBounds, bindEndpointAt, distanceToArrow, resolveArrow, resolveEndpoint, sampleQuadratic, translateArrow, worldToAnchor } from "./core/bindings.js";
+import { buildStrokeOutline, computeDrawBounds, distanceToStroke, sampleRadius, simplifyDrawIndices } from "./core/draw-geometry.js";
+import { BOARD_EXPORT_MAX_TEXTURES, selectBoardExportAssets } from "./core/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, boardFrameLookup, exportItemBounds, normalizeBoardDocument, planBoardExport } from "./core/export-plan.js";
+import { FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, availabilityFromError, buildFileExcerpt, buildFileSnapshot, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, formatFileSize, isFileSnapshotFresh, mergeFileSnapshot, readCoverFromFrontmatter, resolveCoverRef, resolveSpacePath, shouldFetchFileExcerpt, splitFrontmatter } from "./core/file-preview.js";
+import { BOARD_COLORS, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShapeColors, isBoardColorId, pickBoardColor, resolveBoardColor } from "./core/palette.js";
+import { FULL_CAPABILITIES, GEO_KINDS, isGeoKind, resizeModeForCapabilities } from "./core/shape-types.js";
+import { definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition } from "./core/shape-definition.js";
+export { ArrowEndpointSchema, BOARD_COLORS, BOARD_DOCUMENT_KIND, 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, BOARD_NODE_SOURCE, BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardNoteItemSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CORNER_RESIZE_HANDLES, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_LIMITS, DrawPointSchema, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, GEO_KINDS, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, ITEM_BASE_KEYS, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, anchorToWorld, angleFromCenter, arrowBounds, availabilityFromError, bindEndpointAt, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, createBoardExtensionRegistry, definitionForItem, degToRad, distanceToArrow, distanceToStroke, expandRect, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardDocument, normalizeRotation, normalizeViewport, panBy, parseBoardItemLoose, parseBoardManifest, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveCoverRef, resolveEndpoint, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleQuadratic, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, worldPoint, worldToAnchor, worldToScreen, zoomAround };

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

@@ -0,0 +1,6 @@
+import { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
+import { defaultBoardPalette } from "./palette.js";
+import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
+import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
+import { BoardThemeContext, BoardThemeRenderer, getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
+export { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, boardCardRenderersForTest, defaultBoardPalette, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };

package/dist/board/render/index.js

@@ -0,0 +1,6 @@
+import { defaultBoardPalette } from "./palette.js";
+import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
+import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
+import { boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
+import { getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
+export { boardCardRenderersForTest, defaultBoardPalette, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };

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

@@ -0,0 +1,5 @@
+import { BoardRenderPalette } from "./renderers/board-renderer-registry.js";
+//#region src/board/render/palette.d.ts
+declare function defaultBoardPalette(mode: "dark" | "light"): BoardRenderPalette;
+//#endregion
+export { defaultBoardPalette };

package/dist/board/render/palette.js

@@ -0,0 +1,30 @@
+//#region src/board/render/palette.ts
+const DARK = {
+	bg: 1315860,
+	surface: 2105376,
+	hover: 2763306,
+	border: 3815994,
+	brand: 16734751,
+	text: 16053492,
+	muted: 9211020,
+	rare: 3718648,
+	epic: 10980346,
+	legendary: 16096779
+};
+const LIGHT = {
+	bg: 16777215,
+	surface: 16053493,
+	hover: 15329772,
+	border: 14079706,
+	brand: 15222030,
+	text: 1579035,
+	muted: 7041664,
+	rare: 2450411,
+	epic: 8141549,
+	legendary: 11817737
+};
+function defaultBoardPalette(mode) {
+	return { ...mode === "light" ? LIGHT : DARK };
+}
+//#endregion
+export { defaultBoardPalette };

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

@@ -0,0 +1,5 @@
+import { BoardCardRenderer } from "./board-renderer-registry.js";
+//#region src/board/render/renderers/arrow-card-renderer.d.ts
+declare const arrowCardRenderer: BoardCardRenderer;
+//#endregion
+export { arrowCardRenderer };

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

@@ -0,0 +1,157 @@
+import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
+import { resolveArrow, sampleQuadratic } from "../../core/bindings.js";
+import { pickBoardColor } from "../../core/palette.js";
+import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { drawFarStroke } from "./far-plate.js";
+import { Container, Graphics, Text } from "pixi.js";
+//#region src/board/render/renderers/arrow-card-renderer.ts
+const partsByContainer = /* @__PURE__ */ new WeakMap();
+/**
+* Frame lookup for resolving bindings.
+*
+* Routed through the context's id index rather than scanning the document: an
+* arrow re-resolves its endpoints on every sync, and a per-arrow O(items) scan
+* would make a board with many arrows quadratic per frame.
+*/
+function frameLookup(context) {
+	return (id) => context.getItem(id)?.frame;
+}
+/** Open chevron arrowhead — clearly directional, not a tiny filled nub. */
+function drawArrowhead(graphics, tip, angle, size, color, strokeWidth) {
+	const spread = Math.PI / 6;
+	const left = {
+		x: tip.x - size * Math.cos(angle - spread),
+		y: tip.y - size * Math.sin(angle - spread)
+	};
+	const right = {
+		x: tip.x - size * Math.cos(angle + spread),
+		y: tip.y - size * Math.sin(angle + spread)
+	};
+	graphics.moveTo(left.x, left.y).lineTo(tip.x, tip.y).lineTo(right.x, right.y).stroke({
+		color,
+		width: Math.max(1.5, strokeWidth),
+		alpha: 1,
+		cap: "round",
+		join: "round"
+	});
+}
+function sync(container, item, context) {
+	const parts = partsByContainer.get(container);
+	if (!parts) return;
+	parts.root.position.set(0, 0);
+	parts.root.rotation = 0;
+	const selected = context.selectedIds.has(item.id);
+	const hovered = context.hoveredId === item.id;
+	const color = pickBoardColor(context.colors, item.color, context.colorScheme);
+	syncTextResolution(parts.label, parts, context.zoom);
+	const resolved = resolveArrow(item, frameLookup(context));
+	const lineSig = resolved ? [
+		resolved.start.x,
+		resolved.start.y,
+		resolved.end.x,
+		resolved.end.y,
+		resolved.control.x,
+		resolved.control.y,
+		selected,
+		hovered,
+		color.stroke,
+		item.size,
+		item.arrowStart,
+		item.arrowEnd
+	].join("|") : `empty|${item.id}`;
+	if (lineSig !== parts.lineSig) {
+		parts.lineSig = lineSig;
+		parts.line.clear();
+		if (resolved) {
+			const strokeColor = color.stroke;
+			const width = selected ? item.size + 1 : item.size;
+			const samples = sampleQuadratic(resolved, 24);
+			const head = samples[0];
+			const tail = samples[samples.length - 1];
+			if (head && tail) {
+				parts.line.moveTo(head.x, head.y);
+				for (let i = 1; i < samples.length; i += 1) {
+					const point = samples[i];
+					if (point) parts.line.lineTo(point.x, point.y);
+				}
+				parts.line.stroke({
+					color: strokeColor,
+					width,
+					alpha: selected || hovered ? 1 : .92,
+					cap: "round",
+					join: "round"
+				});
+				const span = Math.hypot(tail.x - head.x, tail.y - head.y);
+				const headSize = Math.min(Math.max(14, item.size * 5.5), Math.max(10, span * .28));
+				if (item.arrowEnd) {
+					const prev = samples[samples.length - 2];
+					if (prev) drawArrowhead(parts.line, tail, Math.atan2(tail.y - prev.y, tail.x - prev.x), headSize, strokeColor, width);
+				}
+				if (item.arrowStart) {
+					const next = samples[1];
+					if (next) drawArrowhead(parts.line, head, Math.atan2(head.y - next.y, head.x - next.x), headSize, strokeColor, width);
+				}
+			}
+		}
+	}
+	const labelSig = [item.label, color.label].join("|");
+	if (labelSig !== parts.labelSig) {
+		parts.labelSig = labelSig;
+		parts.label.text = item.label;
+		parts.label.style.fill = color.label;
+	}
+	parts.label.visible = Boolean(resolved && item.label.length > 0);
+	if (resolved) parts.label.position.copyFrom(resolved.control);
+}
+const arrowCardRenderer = {
+	id: "arrow-card",
+	canRender: (item) => item.type === "arrow",
+	create: (item, context) => {
+		const root = new Container();
+		const line = new Graphics();
+		const resolution = textResolutionForZoom(context.zoom);
+		const label = new Text({
+			text: "",
+			style: {
+				fill: 16777215,
+				fontFamily: BOARD_FONT_STACK,
+				fontSize: 12,
+				fontWeight: "500"
+			},
+			resolution,
+			roundPixels: true
+		});
+		label.anchor.set(.5);
+		root.addChild(line, label);
+		partsByContainer.set(root, {
+			root,
+			line,
+			label,
+			lineSig: "",
+			labelSig: "",
+			resolution
+		});
+		if (item.type === "arrow") sync(root, item, context);
+		return root;
+	},
+	update: (container, item, context) => {
+		if (item.type === "arrow") sync(container, item, context);
+	},
+	renderFar: (graphics, item, context) => {
+		if (item.type !== "arrow") return;
+		const resolved = resolveArrow(item, frameLookup(context));
+		if (!resolved) return;
+		const color = pickBoardColor(context.colors, item.color, context.colorScheme);
+		drawFarStroke(graphics, sampleQuadratic(resolved, 12), {
+			color: color.stroke,
+			width: item.size,
+			alpha: .85
+		});
+	},
+	destroy: (container) => {
+		partsByContainer.get(container)?.root.destroy({ children: true });
+		partsByContainer.delete(container);
+	}
+};
+//#endregion
+export { arrowCardRenderer };

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

@@ -0,0 +1,46 @@
+import { BoardItem } from "../../../protocol/dist/board-document.js";
+import { BoardRenderPalette } from "./board-renderer-registry.js";
+import { Container, Text } from "pixi.js";
+//#region src/board/render/renderers/base-card-renderer.d.ts
+declare const CARD_RADIUS = 10;
+declare const CARD_PADDING = 12;
+declare const FOOTER_HEIGHT = 34;
+declare function emphasisColor(item: BoardItem, palette: BoardRenderPalette): number;
+declare function createLabel(text: string, style: Record<string, unknown>): Text;
+type CardShellState = {
+  width: number;
+  height: number;
+  selected: boolean;
+  hovered: boolean;
+  accent: number;
+  title: string;
+};
+type CardShell = {
+  /** Root container positioned by the item frame. */
+  root: Container;
+  /** Masked container for renderer-specific content. */
+  content: Container;
+  /** Rectangle (local coords) available for content. */
+  contentRect: () => {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  update: (state: CardShellState, palette: BoardRenderPalette, footer: boolean) => void;
+  destroy: () => void;
+};
+/**
+ * Shared card chrome: rounded background, selection/hover border, optional
+ * footer with title, and a masked content region. Tracks the last rendered
+ * state so unchanged attributes are not redrawn.
+ */
+declare function createCardShell(): CardShell;
+/**
+ * Position a shell root at an item frame. The container pivots around its
+ * center so that Pixi's rotation matches the geometry model (which treats
+ * `frame.rotation` as a rotation about the frame center).
+ */
+declare function positionShell(root: Container, item: BoardItem): void;
+//#endregion
+export { CARD_PADDING, CARD_RADIUS, CardShell, CardShellState, FOOTER_HEIGHT, createCardShell, createLabel, emphasisColor, positionShell };

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

@@ -0,0 +1,153 @@
+import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
+import { getBoardResolution } from "../text-resolution.js";
+import { Container, DOMAdapter, Graphics, Text } from "pixi.js";
+//#region src/board/render/renderers/base-card-renderer.ts
+const CARD_RADIUS = 10;
+const CARD_PADDING = 12;
+const FOOTER_HEIGHT = 34;
+const TEXT_OPTIONS = {
+	resolution: getBoardResolution(),
+	roundPixels: true
+};
+function emphasisColor(item, palette) {
+	if (item.style?.accentColor) {
+		const normalized = parseCssColor(item.style.accentColor);
+		if (normalized != null) return normalized;
+	}
+	switch (item.style?.emphasis) {
+		case "rare": return palette.rare;
+		case "epic": return palette.epic;
+		case "legendary": return palette.legendary;
+		default: return palette.brand;
+	}
+}
+/**
+* Normalise any CSS color to a number by letting a 2D context parse it.
+*
+* Goes through `DOMAdapter` rather than `document` so a headless export resolves
+* accent colors exactly as the browser does; without it, custom accents would
+* silently fall back to the emphasis palette only when exporting.
+*/
+function parseCssColor(value) {
+	try {
+		const context = DOMAdapter.get().createCanvas(1, 1).getContext("2d");
+		if (!context) return null;
+		context.fillStyle = value;
+		const match = /^#([0-9a-f]{6})$/i.exec(String(context.fillStyle));
+		return match?.[1] ? Number.parseInt(match[1], 16) : null;
+	} catch {
+		return null;
+	}
+}
+function createLabel(text, style) {
+	return new Text({
+		...TEXT_OPTIONS,
+		text,
+		style
+	});
+}
+/**
+* Shared card chrome: rounded background, selection/hover border, optional
+* footer with title, and a masked content region. Tracks the last rendered
+* state so unchanged attributes are not redrawn.
+*/
+function createCardShell() {
+	const root = new Container();
+	const background = new Graphics();
+	const content = new Container();
+	const mask = new Graphics();
+	const footerBg = new Graphics();
+	const title = createLabel("", {
+		fill: 16777215,
+		fontFamily: BOARD_FONT_STACK,
+		fontSize: 12,
+		fontWeight: "500",
+		wordWrap: true
+	});
+	content.mask = mask;
+	root.addChild(background, mask, content, footerBg, title);
+	let last = null;
+	function paletteKeyOf(palette) {
+		return `${palette.surface}|${palette.border}|${palette.hover}|${palette.text}|${palette.muted}`;
+	}
+	function contentRectFor(width, height, footer) {
+		const bottom = footer ? 34 : 12;
+		return {
+			x: 12,
+			y: 12,
+			width: Math.max(1, width - 24),
+			height: Math.max(1, height - 12 - bottom)
+		};
+	}
+	function draw(state, palette, footer) {
+		const { width, height, selected, hovered, accent } = state;
+		background.clear();
+		background.roundRect(0, 0, width, height, 10).fill({
+			color: palette.surface,
+			alpha: .98
+		});
+		const borderColor = selected ? accent : hovered ? palette.muted : palette.border;
+		background.roundRect(0, 0, width, height, 10).stroke({
+			color: borderColor,
+			width: selected ? 2 : 1,
+			alpha: selected ? .95 : hovered ? .9 : .8
+		});
+		mask.clear();
+		const rect = contentRectFor(width, height, footer);
+		mask.roundRect(rect.x, rect.y, rect.width, rect.height, 4).fill({ color: 16777215 });
+		footerBg.clear();
+		footerBg.visible = footer;
+		title.visible = footer;
+		if (footer) {
+			const fx = 1;
+			const fy = height - 34;
+			const fw = width - 2;
+			const fh = 33;
+			const r = 9;
+			footerBg.moveTo(fx, fy).lineTo(fx + fw, fy).lineTo(fx + fw, fy + fh - r).arcTo(fx + fw, fy + fh, fx + fw - r, fy + fh, r).lineTo(10, fy + fh).arcTo(fx, fy + fh, fx, fy + fh - r, r).lineTo(fx, fy).fill({
+				color: palette.hover,
+				alpha: .55
+			});
+			title.text = state.title;
+			title.style.fill = palette.text;
+			title.style.wordWrapWidth = width - 24;
+			title.x = 12;
+			title.y = height - 34 + (34 - title.height) / 2;
+		}
+	}
+	function update(state, palette, footer) {
+		const paletteKey = paletteKeyOf(palette);
+		if (!last || last.width !== state.width || last.height !== state.height || last.selected !== state.selected || last.hovered !== state.hovered || last.accent !== state.accent || last.title !== state.title || last.footer !== footer || last.paletteKey !== paletteKey) {
+			draw(state, palette, footer);
+			last = {
+				...state,
+				footer,
+				paletteKey
+			};
+		}
+	}
+	function destroy() {
+		root.destroy({ children: true });
+	}
+	return {
+		root,
+		content,
+		contentRect: () => contentRectFor(last?.width ?? 0, last?.height ?? 0, last?.footer ?? true),
+		update,
+		destroy
+	};
+}
+/**
+* Position a shell root at an item frame. The container pivots around its
+* center so that Pixi's rotation matches the geometry model (which treats
+* `frame.rotation` as a rotation about the frame center).
+*/
+function positionShell(root, item) {
+	const { x, y, width, height, rotation } = item.frame;
+	root.pivot.set(width / 2, height / 2);
+	root.x = x + width / 2;
+	root.y = y + height / 2;
+	root.rotation = (rotation || 0) * Math.PI / 180;
+}
+//#endregion
+export { CARD_PADDING, CARD_RADIUS, FOOTER_HEIGHT, createCardShell, createLabel, emphasisColor, positionShell };

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

@@ -0,0 +1,85 @@
+import { BoardDocument, BoardItem } from "../../../protocol/dist/board-document.js";
+import { BoardShapeColors } from "../../core/palette.js";
+import { Container, Graphics, Texture } from "pixi.js";
+//#region src/board/render/renderers/board-renderer-registry.d.ts
+type BoardRenderPalette = {
+  bg: number;
+  surface: number;
+  hover: number;
+  border: number;
+  brand: number;
+  text: number;
+  muted: number;
+  rare: number;
+  epic: number;
+  legendary: number;
+};
+type BoardRenderContext = {
+  document: BoardDocument;
+  /**
+   * O(1) item lookup by id. Renderers that need to resolve references (arrow
+   * bindings) must use this rather than scanning `document.items`, which would
+   * be O(items) per card per frame.
+   */
+  getItem: (id: string) => BoardItem | null;
+  selectedIds: Set<string>;
+  hoveredId: string | null;
+  /** Nodes currently receiving a live resize preview. */
+  resizingIds: Set<string>;
+  palette: BoardRenderPalette;
+  /**
+   * Live shape colors resolved from CSS tokens (theme + space theme.css).
+   * Prefer this over hard-coded light/dark tables at render time.
+   */
+  colors: BoardShapeColors;
+  /** Resolved color mode, for fallback mapping when colors are unavailable. */
+  colorScheme: "dark" | "light";
+  /** Current camera zoom — used for text re-rasterisation buckets. */
+  zoom: number;
+  /** Stable preview texture key for an item, or null when it has no preview. */
+  assetKey: (item: BoardItem) => string | null;
+  /** Currently loaded texture for a key (null while loading). */
+  getTexture: (key: string) => Texture | null;
+  /** Whether the preview for a key failed to load (for a failure placeholder). */
+  hasError: (key: string) => boolean;
+  /**
+   * Whether a referenced workspace file could not be read, and why. Transient,
+   * client-local state — never part of the document — so one client's outage is
+   * not shown to everyone.
+   */
+  fileState: (path: string) => "ok" | "missing" | "unavailable";
+  /** Reference-counted texture acquisition and release. */
+  acquireTexture: (key: string) => void;
+  releaseTexture: (key: string) => void;
+};
+type BoardCardRenderer = {
+  id: string;
+  canRender: (item: BoardItem, context: BoardRenderContext) => boolean;
+  create: (item: BoardItem, context: BoardRenderContext) => Container;
+  /** Efficiently sync an existing container to a (possibly changed) item. */
+  update: (container: Container, item: BoardItem, context: BoardRenderContext) => void;
+  /**
+   * Draw the item as flat batched geometry into a shared `Graphics`, for the
+   * far LOD used when too many cards are on screen to afford a container each.
+   *
+   * Implementing this opts the shape into the far layer: past the scene's
+   * visible-card threshold it is drawn here instead of being materialised, so
+   * cost stops scaling with node count. Omit it for shapes whose whole point is
+   * their vector detail (strokes, arrows, frames) — those keep real containers.
+   *
+   * Must draw in world space and must not allocate per call beyond the path
+   * itself; this runs once per far-capable item on every far-layer rebuild.
+   */
+  renderFar?: (graphics: Graphics, item: BoardItem, context: BoardRenderContext) => void;
+  destroy?: (container: Container, context: BoardRenderContext) => void;
+};
+/**
+ * Every registered renderer, for invariants that must hold across all of them —
+ * notably that each can draw itself at far LOD, which is what keeps the far
+ * layer's z-order correct (see board-scene).
+ */
+declare function boardCardRenderersForTest(): readonly BoardCardRenderer[];
+declare function getBoardCardRenderer(item: BoardItem, context: BoardRenderContext): BoardCardRenderer;
+declare function registerBoardCardRenderer(renderer: BoardCardRenderer): void;
+//#endregion
+export { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer };

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

@@ -0,0 +1,43 @@
+import { ensureBoardTextMeasurement } from "../text-measurement.js";
+import { arrowCardRenderer } from "./arrow-card-renderer.js";
+import { drawCardRenderer } from "./draw-card-renderer.js";
+import { fileCardRenderer } from "./file-card-renderer.js";
+import { frameCardRenderer } from "./frame-card-renderer.js";
+import { geoCardRenderer } from "./geo-card-renderer.js";
+import { imageCardRenderer } from "./image-card-renderer.js";
+import { noteCardRenderer } from "./note-card-renderer.js";
+import { textCardRenderer } from "./text-card-renderer.js";
+import { unknownCardRenderer } from "./unknown-card-renderer.js";
+import { videoCardRenderer } from "./video-card-renderer.js";
+//#region src/board/render/renderers/board-renderer-registry.ts
+const boardCardRenderers = [
+	textCardRenderer,
+	noteCardRenderer,
+	imageCardRenderer,
+	videoCardRenderer,
+	fileCardRenderer,
+	geoCardRenderer,
+	drawCardRenderer,
+	arrowCardRenderer,
+	frameCardRenderer,
+	unknownCardRenderer
+];
+/**
+* Every registered renderer, for invariants that must hold across all of them —
+* notably that each can draw itself at far LOD, which is what keeps the far
+* layer's z-order correct (see board-scene).
+*/
+function boardCardRenderersForTest() {
+	return boardCardRenderers;
+}
+function getBoardCardRenderer(item, context) {
+	ensureBoardTextMeasurement();
+	return boardCardRenderers.find((renderer) => renderer.canRender(item, context)) ?? unknownCardRenderer;
+}
+function registerBoardCardRenderer(renderer) {
+	const existingIndex = boardCardRenderers.findIndex((candidate) => candidate.id === renderer.id);
+	if (existingIndex >= 0) boardCardRenderers.splice(existingIndex, 1, renderer);
+	else boardCardRenderers.unshift(renderer);
+}
+//#endregion
+export { boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer };

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

@@ -0,0 +1,5 @@
+import { BoardCardRenderer } from "./board-renderer-registry.js";
+//#region src/board/render/renderers/draw-card-renderer.d.ts
+declare const drawCardRenderer: BoardCardRenderer;
+//#endregion
+export { drawCardRenderer };