@neta-art/cohub 3.1.0 → 4.0.0

package/dist/board/headless/index.js

@@ -0,0 +1,150 @@
+import "../../protocol/dist/board-constants.js";
+import { installBoardTextMeasurement } from "../render/text-measurement.js";
+import { renderBoardExport } from "../export/index.js";
+//#region src/board/headless/index.ts
+/**
+* A minimal WebGL stand-in.
+*
+* `ParticleContainerPipe` builds a `GlProgram` when the renderer registers its
+* pipes, and that probes shader precision through a throwaway context — even
+* though the Canvas2D backend never draws with it. Returning a stub keeps
+* registration working; nothing here is ever used to render.
+*/
+const WEBGL_PROBE_STUB = {
+	getShaderPrecisionFormat: () => ({
+		precision: 1,
+		rangeMin: 1,
+		rangeMax: 1
+	}),
+	getExtension: () => null,
+	getParameter: () => 0
+};
+function isWebGLContext(kind) {
+	return kind.startsWith("webgl") || kind === "experimental-webgl";
+}
+async function loadCanvasModule() {
+	try {
+		return await import("@napi-rs/canvas");
+	} catch (cause) {
+		throw new Error("Board image export needs the optional '@napi-rs/canvas' package. Install it with: npm i @napi-rs/canvas", { cause });
+	}
+}
+/** Node has no rAF; Pixi's scheduler only needs a callback pump. */
+function installAnimationFrameShim() {
+	const globals = globalThis;
+	if (globals.requestAnimationFrame) return () => {};
+	const timers = /* @__PURE__ */ new Set();
+	globals.requestAnimationFrame = (cb) => {
+		const timer = setTimeout(() => {
+			timers.delete(timer);
+			cb(Date.now());
+		}, 16);
+		timer.unref?.();
+		timers.add(timer);
+		return timer;
+	};
+	globals.cancelAnimationFrame = (id) => {
+		clearTimeout(id);
+		timers.delete(id);
+	};
+	return () => {
+		for (const timer of timers) clearTimeout(timer);
+		timers.clear();
+		globals.requestAnimationFrame = void 0;
+		globals.cancelAnimationFrame = void 0;
+	};
+}
+/**
+* Create a Canvas2D renderer backed by Skia.
+*
+* `skipExtensionImports` is essential: it stops Pixi from auto-loading its
+* browser environment bundle, which would pull in DOM-only pipes.
+*/
+async function createBoardHeadlessRenderer(options = {}) {
+	const canvasModule = options.canvasModule ?? await loadCanvasModule();
+	const { CanvasGraphicsContextSystem, CanvasGraphicsPipe, CanvasRenderer, CanvasRendererTextSystem, CanvasTextPipe, CanvasTextSystem, DOMAdapter, extensions, GraphicsContextSystem, GraphicsPipe, ImageSource, Texture } = await import("pixi.js");
+	extensions.add(CanvasGraphicsPipe, GraphicsPipe, CanvasGraphicsContextSystem, GraphicsContextSystem, CanvasRendererTextSystem, CanvasTextSystem, CanvasTextPipe);
+	for (const font of options.fonts ?? []) canvasModule.GlobalFonts.registerFromPath(font.path, font.family ?? "Geist");
+	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);
+		canvas.getContext = (kind, ...rest) => isWebGLContext(String(kind)) ? WEBGL_PROBE_STUB : nativeGetContext(kind, ...rest);
+		return canvas;
+	}
+	DOMAdapter.set({
+		createCanvas: (width, height) => createCanvas(width, height),
+		createImage: () => new canvasModule.Image(),
+		getCanvasRenderingContext2D: () => createCanvas(1, 1).getContext("2d").constructor,
+		getWebGLRenderingContext: () => WEBGL_PROBE_STUB,
+		getNavigator: () => ({
+			userAgent: "cohub-board-headless",
+			gpu: null
+		}),
+		getBaseUrl: () => "file://",
+		getFontFaceSet: () => null,
+		fetch: (url, init) => fetch(url, init),
+		parseXML: () => {
+			throw new Error("XML parsing is not available in headless board export.");
+		}
+	});
+	installBoardTextMeasurement();
+	const restoreAnimationFrame = installAnimationFrameShim();
+	const renderer = new CanvasRenderer();
+	await renderer.init({
+		width: 1,
+		height: 1,
+		backgroundAlpha: 0,
+		antialias: true,
+		resolution: 1,
+		skipExtensionImports: true
+	});
+	return {
+		renderer,
+		canvasModule,
+		decodeImage: async (bytes, mimeType = "image/png") => {
+			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}`;
+			});
+			return new Texture({ source: new ImageSource({
+				resource: image,
+				width: image.width,
+				height: image.height
+			}) });
+		},
+		destroy: () => {
+			renderer.destroy();
+			restoreAnimationFrame();
+		}
+	};
+}
+const MIME = {
+	png: "image/png",
+	jpeg: "image/jpeg",
+	webp: "image/webp"
+};
+function boardHeadlessMimeType(format) {
+	return MIME[format];
+}
+/** Render a document to encoded image bytes. Returns null for an empty region. */
+function exportBoardImageBytes(headless, document, options = {}) {
+	const { format = "png", quality = .92, textures, ...rest } = options;
+	const result = renderBoardExport(headless.renderer, document, {
+		...rest,
+		...textures ? { textures } : {}
+	});
+	if (!result) return null;
+	const canvas = result.canvas;
+	const bytes = format === "png" ? canvas.toBuffer(MIME.png) : canvas.toBuffer(MIME[format], Math.round(quality * 100));
+	return {
+		bytes: new Uint8Array(bytes),
+		plan: result.plan,
+		warnings: result.warnings,
+		format
+	};
+}
+//#endregion
+export { boardHeadlessMimeType, createBoardHeadlessRenderer, exportBoardImageBytes };

package/dist/board/image-key.d.ts

@@ -0,0 +1,19 @@
+import { BoardItem } from "../protocol/dist/board-document.js";
+//#region src/board/image-key.d.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.
+ */
+declare function imageAssetKey(item: BoardItem): string | null;
+/** The source a key resolves from, recovered from its namespace prefix. */
+declare function boardImageKeySource(key: string): {
+  kind: "file" | "url";
+  value: string;
+} | null;
+//#endregion
+export { boardImageKeySource, imageAssetKey };

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,17 @@
+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, 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, CORNER_ROTATION_ZONE_WIDTH, CornerResizeHandle, 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, frameCornerRotationHandleAt, 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, readTitleFromFrontmatter, 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, 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 { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardStyledToolId, BoardToolStyleMap, BoardToolStylePatch, DEFAULT_BOARD_TOOL_STYLES, clampBoardStrokeSize, createBoardToolStyles } from "./core/tool-styles.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, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, 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, BoardPresetDefinition, type BoardRecord, BoardShapeColors, BoardStyledToolId, BoardTextItem, BoardTextItemSchema, BoardToolStyleMap, BoardToolStylePatch, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BuildSnapshotInput, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompiledSequence, CornerResizeHandle, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_TOOL_STYLES, 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, 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, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, createBoardExtensionRegistry, createBoardToolStyles, definitionForItem, degToRad, distanceToArrow, distanceToStroke, expandRect, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, 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, readTitleFromFrontmatter, 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,17 @@
+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, 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, 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, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCornerRotationHandleAt, 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, readTitleFromFrontmatter, 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";
+import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, DEFAULT_BOARD_TOOL_STYLES, clampBoardStrokeSize, createBoardToolStyles } from "./core/tool-styles.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, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_TOOL_STYLES, 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, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, createBoardExtensionRegistry, createBoardToolStyles, definitionForItem, degToRad, distanceToArrow, distanceToStroke, expandRect, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, 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, readTitleFromFrontmatter, 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 };