@neta-art/cohub 5.10.0 → 7.0.0

package/dist/protocol/dist/board.js

@@ -1,12 +1,14 @@
-import "./board-constants.js";
+import { BOARD_BUILTIN_CAPABILITIES, DEFAULT_BOARD_RENDER_LIMITS } from "./board-constants.js";
 import { BoardConnectionSchema } from "./board-connection.js";
+import { BoardCompositionInputSchema } from "./board-composition.js";
+import { BoardEffectInputSchema } from "./board-effect.js";
+import { BoardAuthoringItemSchema, BoardItemPatchSchema, BoardSemanticMutationSchema } from "./board-authoring.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.js
 const BOARD_EXTENSION = ".board";
 const BOARD_DOCUMENT_KIND = "cohub.board";
 const BOARD_MANIFEST_KIND = "cohub.board.manifest";
 const idSchema = z.string().min(1).max(160);
-const extensionIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
 const jsonObjectSchema = z.record(z.string(), z.unknown());
 const finiteSchema = z.number().finite();
 const BoardManifestSchema = z.object({
@@ -36,18 +38,6 @@ function parseBoardManifest(input) {
 function serializeBoardManifest(manifest) {
 	return `${JSON.stringify(BoardManifestSchema.parse(manifest), null, 2)}\n`;
 }
-const BoardTargetSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}),
-	z.object({
-		type: z.literal("effect"),
-		effectId: idSchema
-	}),
-	z.object({ type: z.literal("board") }),
-	z.object({ type: z.literal("camera") })
-]);
 const BoardCameraStateSchema = z.object({
 	centerX: finiteSchema,
 	centerY: finiteSchema,
@@ -64,12 +54,12 @@ const BoardCameraFocusSchema = z.discriminatedUnion("type", [
 		})
 	}),
 	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
+		type: z.literal("item"),
+		itemId: idSchema
 	}),
 	z.object({
-		type: z.literal("nodes"),
-		nodeIds: z.array(idSchema).min(1).max(1e3)
+		type: z.literal("items"),
+		itemIds: z.array(idSchema).min(1).max(1e3)
 	}),
 	z.object({
 		type: z.literal("frame"),
@@ -89,85 +79,7 @@ const BoardCameraFocusParamsSchema = z.object({
 		path: ["minZoom"]
 	});
 });
-const BoardAssetRefSchema = z.object({
-	type: z.enum(["space-file", "extension"]),
-	ref: z.string().min(1).max(4096),
-	digest: z.string().min(16).max(160).optional()
-});
-const BoardKeyframeSchema = z.object({
-	at: finiteSchema.nonnegative(),
-	value: z.unknown(),
-	easing: z.string().min(1).max(80).optional()
-});
-const BoardClipSchema = z.object({
-	id: idSchema,
-	sequenceId: idSchema,
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	target: BoardTargetSchema,
-	start: finiteSchema.nonnegative(),
-	duration: finiteSchema.positive(),
-	layer: z.enum([
-		"behind",
-		"content",
-		"front",
-		"screen"
-	]).default("content"),
-	fill: z.enum([
-		"none",
-		"backwards",
-		"forwards",
-		"both"
-	]).default("none"),
-	easing: z.string().min(1).max(80).default("linear"),
-	params: jsonObjectSchema.default({}),
-	keyframes: z.array(BoardKeyframeSchema).default([]),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	seed: z.string().min(1).max(160),
-	metadata: jsonObjectSchema.default({})
-});
-const BoardEffectSchema = z.object({
-	id: idSchema,
-	boardId: z.string().uuid(),
-	target: z.discriminatedUnion("type", [z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}), z.object({ type: z.literal("board") })]),
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	enabled: z.boolean().default(true),
-	lifecycle: z.enum([
-		"persistent",
-		"when-visible",
-		"manual"
-	]),
-	timeOrigin: z.enum([
-		"board",
-		"visible",
-		"activation"
-	]),
-	layer: z.enum([
-		"behind",
-		"front",
-		"screen"
-	]).default("front"),
-	seed: z.string().min(1).max(160),
-	params: jsonObjectSchema.default({}),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardSequenceSchema = z.object({
-	id: idSchema,
-	boardId: z.string().uuid(),
-	name: z.string().min(1).max(255),
-	duration: finiteSchema.nonnegative(),
-	seed: z.string().min(1).max(160),
-	restPose: jsonObjectSchema.default({}),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardNodeInputSchema = z.object({
+z.object({
 	nodeId: idSchema,
 	type: z.string().min(1).max(40),
 	parentId: idSchema.nullable(),
@@ -184,35 +96,63 @@ const BoardNodeInputSchema = z.object({
 	style: jsonObjectSchema,
 	data: jsonObjectSchema
 });
-z.object({
+const stripBoardServerFields = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return value;
+	const { boardId: _boardId, revision: _revision, ...input } = value;
+	return input;
+};
+const BoardCreateEffectInputSchema = z.preprocess(stripBoardServerFields, BoardEffectInputSchema);
+const BoardCreateCompositionInputSchema = z.preprocess(stripBoardServerFields, BoardCompositionInputSchema);
+const BoardCreateInputSchema = z.object({
 	path: z.string().min(1),
 	/** Reused by clients when board creation is interrupted and retried. */
 	mutationId: z.string().max(128).optional(),
 	title: z.string().min(1).max(255).optional(),
 	metadata: jsonObjectSchema.optional(),
-	nodes: z.array(BoardNodeInputSchema).max(5e4).optional(),
+	items: z.array(BoardAuthoringItemSchema).max(5e4).optional(),
 	connections: z.array(BoardConnectionSchema).max(5e4).optional(),
-	effects: z.array(BoardEffectSchema.omit({
-		boardId: true,
-		revision: true
-	})).optional(),
-	sequences: z.array(z.object({
-		sequence: BoardSequenceSchema.omit({
-			boardId: true,
-			revision: true
-		}),
-		clips: z.array(BoardClipSchema.omit({ sequenceId: true }))
-	})).optional()
+	effects: z.array(BoardCreateEffectInputSchema).max(5e4).optional(),
+	compositions: z.array(BoardCreateCompositionInputSchema).max(5e4).optional()
 });
+const jsonSchema = (schema) => z.toJSONSchema(schema);
+const authoringSchemaFactories = {
+	item: () => jsonSchema(BoardAuthoringItemSchema),
+	itemPatch: () => jsonSchema(BoardItemPatchSchema),
+	mutation: () => jsonSchema(BoardSemanticMutationSchema),
+	composition: () => jsonSchema(BoardCompositionInputSchema),
+	effect: () => jsonSchema(BoardEffectInputSchema),
+	create: () => jsonSchema(BoardCreateInputSchema)
+};
+/**
+* JSON Schemas for the semantic authoring surface. Each property is enumerable
+* for Object.keys/JSON.stringify, but generated only when that property is
+* requested. This keeps protocol imports cheap while capabilities still returns
+* the complete machine-readable schema object.
+*/
+const BOARD_AUTHORING_SCHEMAS = {};
+for (const key of Object.keys(authoringSchemaFactories)) {
+	let cached;
+	Object.defineProperty(BOARD_AUTHORING_SCHEMAS, key, {
+		enumerable: true,
+		configurable: false,
+		get() {
+			cached ??= authoringSchemaFactories[key]();
+			return cached;
+		}
+	});
+}
 z.object({
 	include: z.array(z.enum([
 		"nodes",
 		"connections",
 		"effects",
-		"sequences",
-		"clips",
+		"compositions",
 		"playback"
 	])).optional(),
+	nodeIds: z.array(idSchema).max(5e4).optional(),
+	connectionIds: z.array(idSchema).max(5e4).optional(),
+	effectIds: z.array(idSchema).max(5e4).optional(),
+	compositionIds: z.array(idSchema).max(5e4).optional(),
 	viewport: z.object({
 		x: finiteSchema,
 		y: finiteSchema,
@@ -221,16 +161,15 @@ z.object({
 	}).optional()
 });
 z.object({
-	sequenceId: idSchema,
+	compositionId: idSchema,
 	/** Delay before the first local playback after opening the Board, in milliseconds. */
-	delayMs: finiteSchema.nonnegative().default(0),
-	loop: z.boolean().default(false)
+	delayMs: finiteSchema.nonnegative().default(0)
 });
 z.discriminatedUnion("type", [
 	z.object({
 		commandId: idSchema,
 		type: z.literal("play"),
-		sequenceId: idSchema,
+		compositionId: idSchema,
 		position: finiteSchema.nonnegative().optional(),
 		timeScale: finiteSchema.positive().max(4).optional(),
 		shared: z.boolean().optional(),
@@ -257,4 +196,4 @@ function isBoardPath(path) {
 	return path.toLowerCase().endsWith(BOARD_EXTENSION);
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_AUTHORING_SCHEMAS, BOARD_BUILTIN_CAPABILITIES, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardCreateInputSchema, BoardManifestSchema, DEFAULT_BOARD_RENDER_LIMITS, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/index.d.ts

@@ -1,9 +1,14 @@
 import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
-import { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle } from "./board-connection.js";
-import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind, BoardNodeValidationDiagnostic } from "./board-node.js";
-import { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardClip, BoardClipSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle } from "./board-connection.js";
+import { BoardAnimationTarget, BoardAnimationTargetSchema, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardEasing, BoardEasingSchema, BoardProceduralClip, BoardProceduralClipSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema } from "./board-composition.js";
+import { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema } from "./board-effect.js";
+import { BoardAuthoringItem, BoardAuthoringItemSchema, BoardAuthoringSnapshot, BoardSemanticCommand, BoardSemanticCommandSchema } from "./board-authoring.js";
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardDiagnostic, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import "./board-capability-registry.js";
+import "./board-codec.js";
 import "./board-content.js";
+import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind } from "./board-node.js";
 import "./realtime/board-awareness.js";
 import "./work.js";
 import "./realtime/types.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardClip, BoardClipSchema, BoardColorId, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardNodeValidationDiagnostic, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, BoardRelationSchema, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, InvalidBoardFileError, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BoardAnimationTarget, BoardAnimationTargetSchema, type BoardAssetRef, BoardAuthoringItem, BoardAuthoringItemSchema, BoardAuthoringSnapshot, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardColorId, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDiagnostic, BoardEasing, BoardEasingSchema, type BoardEffect, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardProceduralClip, BoardProceduralClipSchema, BoardRelationSchema, type BoardRenderCost, BoardSemanticCommand, BoardSemanticCommandSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };

package/dist/types.d.ts

@@ -1,5 +1,8 @@
 import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./protocol/dist/board-constants.js";
-import { BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardClip, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardManifest, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardRecord, BoardSequence, BoardTarget, BoardValidationResult } from "./protocol/dist/board.js";
+import { BoardAnimationTarget, BoardComposition, BoardEasing, BoardProceduralClip, BoardTimelineMarker, BoardTrack } from "./protocol/dist/board-composition.js";
+import { BoardAssetRef, BoardEffect, BoardEffectInput } from "./protocol/dist/board-effect.js";
+import { BoardAuthoringItem, BoardAuthoringSnapshot, BoardSemanticCommand } from "./protocol/dist/board-authoring.js";
+import { BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardDiagnostic, BoardManifest, BoardMutationReceipt, BoardPlaybackSnapshot, BoardValidationResult } from "./protocol/dist/board.js";
 import "./protocol/dist/index.js";
 //#region src/types.d.ts
 type UserProfile = {

package/docs/work-runtime-guide.md

@@ -83,10 +83,24 @@ The Work runs inside a Cohub-hosted iframe (`window.parent !== window`). The
 SDK communicates with the parent window via `postMessage` to request tokens
 and context. This is the normal case when a viewer opens a Work through Cohub.
 
-- `client.context()` returns the **real** `space.id`, `work.id`, and current
-  permission scopes from the host.
+- `client.context()` returns the **real** `space.id`, `work.id`, current viewer,
+  and permission scopes from the host.
+- A Work opened through `cohub ui preview` also receives an `invocation`
+  snapshot with the originating `spaceId`, `sessionId`, `turnId`, and
+  `toolCallId` when available. The invocation Space may differ from the Work's
+  own `space.id`.
 - `client.auth.request()` triggers an in-shell consent flow (no popup window).
 
+```js
+const ctx = await client.context();
+console.log(ctx.viewer?.userUuid ?? null);
+console.log(ctx.invocation?.sessionId ?? null);
+```
+
+Invocation fields describe where the preview came from. They are identifiers,
+not authorization: API access remains controlled by the Work session token and
+its scopes.
+
 ### Broker mode (standalone deployment)
 
 The Work is accessed as a standalone page (`window.parent === window`), e.g.
@@ -183,6 +197,7 @@ but **not active** until the viewer approves them through a consent dialog
 triggered by `client.auth.request()`. These are **action** permissions.
 
 ```
+taskrun.view              — read Task Runs the viewer can already access
 session.prompt.readonly   — send read-only prompts (no side effects)
 session.prompt.fullaccess — send prompts with full access (write, create sessions)
 generation.create         — create generation tasks (image/video/audio)
@@ -199,7 +214,8 @@ user.usage.read           — read the viewer's aggregated usage
 `session.prompt.fullaccess` lets you **send** a prompt, but does **not** let
 you **read** the result — that needs `session.view` (a work scope).
 `generation.create` lets you **create** a generation task, but reading its
-result needs `taskrun.view` (a work scope).
+result needs `taskrun.view`, either from the publishing Space's work scopes or
+from viewer authorization checked against the requested Space or Session.
 
 ### Complete API → scope mapping
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "5.10.0",
+  "version": "7.0.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
@@ -100,7 +100,7 @@
     "build": "tsdown",
     "lint": "biome lint .",
     "lint:fix": "biome lint --write .",
-    "test": "node ../../scripts/test/run.mjs 'src/**/*.test.ts' 'tests/**/*.test.ts'",
+    "test": "node ../../scripts/test/run.mjs --test-concurrency=2 'src/**/*.test.ts' 'tests/**/*.test.ts'",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }

package/dist/board/codec.d.ts

@@ -1,27 +0,0 @@
-import { BoardConnectionRecord } from "../protocol/dist/board-connection.js";
-import { BoardManifest, BoardNodeInput, BoardNodeRecord, BoardRecord, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
-import "../protocol/dist/index.js";
-import { BoardAppearance, BoardDocument, BoardItem } from "../protocol/dist/board-document.js";
-//#region src/board/codec.d.ts
-declare const DEFAULT_BOARD_APPEARANCE: BoardAppearance;
-declare const ITEM_BASE_KEYS: readonly ["id", "type", "frame", "locked", "style", "metadata"];
-/**
- * Original wire data follows an item through immutable object spreads while
- * remaining invisible to JSON serialization. Codecs can then patch only the
- * fields this client understands instead of rebuilding and truncating a node.
- */
-declare const BOARD_NODE_SOURCE: unique symbol;
-type WireBackedBoardItem = BoardItem & {
-  [BOARD_NODE_SOURCE]?: BoardNodeInput;
-};
-declare function nodeInputFromRecord(node: BoardNodeRecord): BoardNodeInput;
-declare function sourceForItem(item: BoardItem): BoardNodeInput | undefined;
-declare function isRecord(value: unknown): value is Record<string, unknown>;
-declare function boardNodeToItem(node: BoardNodeRecord): BoardItem;
-declare function boardBootstrapToDocument(input: {
-  board: BoardRecord;
-  nodes: BoardNodeRecord[];
-  connections?: BoardConnectionRecord[];
-}): BoardDocument;
-//#endregion
-export { BOARD_NODE_SOURCE, type BoardManifest, type BoardNodeRecord, type BoardRecord, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, InvalidBoardFileError, WireBackedBoardItem, boardBootstrapToDocument, boardNodeToItem, isBoardPath, isRecord, nodeInputFromRecord, parseBoardManifest, serializeBoardManifest, sourceForItem };

package/dist/board/codec.js

@@ -1,277 +0,0 @@
-import { BOARD_DOCUMENT_KIND, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
-import { BoardAppearanceSchema, BoardFileSnapshotSchema, BoardTaskSnapshotSchema, UNKNOWN_BOARD_ITEM_TYPE, parseBoardDocument } from "../protocol/dist/board-document.js";
-import "../protocol/dist/index.js";
-import { TEXT_FONT_SIZE, clampBoardTextFontSize } from "./core/text-metrics.js";
-//#region src/board/codec.ts
-const DEFAULT_BOARD_APPEARANCE = BoardAppearanceSchema.parse({
-	theme: "clean",
-	background: { kind: "solid" },
-	grid: {
-		visible: false,
-		size: 24,
-		opacity: .12
-	},
-	mood: "clean"
-});
-const ITEM_BASE_KEYS = [
-	"id",
-	"type",
-	"frame",
-	"locked",
-	"style",
-	"metadata"
-];
-/**
-* Original wire data follows an item through immutable object spreads while
-* remaining invisible to JSON serialization. Codecs can then patch only the
-* fields this client understands instead of rebuilding and truncating a node.
-*/
-const BOARD_NODE_SOURCE = Symbol("board-node-source");
-function nodeInputFromRecord(node) {
-	return {
-		nodeId: node.nodeId,
-		type: node.type,
-		parentId: node.parentId ?? null,
-		orderKey: node.orderKey ?? null,
-		x: node.x,
-		y: node.y,
-		width: node.width,
-		height: node.height,
-		rotation: node.rotation,
-		refKind: node.refKind ?? null,
-		refPath: node.refPath ?? null,
-		refUrl: node.refUrl ?? null,
-		view: node.view ?? {},
-		style: node.style ?? {},
-		data: node.data ?? {}
-	};
-}
-function sourceForItem(item) {
-	return item[BOARD_NODE_SOURCE];
-}
-function isRecord(value) {
-	return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-function frameFromNode(node) {
-	return {
-		x: node.x,
-		y: node.y,
-		width: node.width,
-		height: node.height,
-		rotation: node.rotation
-	};
-}
-function lockedFromData(data) {
-	return data.locked === true ? true : void 0;
-}
-function styleFromNode(node) {
-	return Object.keys(node.style ?? {}).length ? node.style : void 0;
-}
-function spaceFilePathFromNode(node) {
-	if (node.refKind === "space_file" && node.refPath) return node.refPath;
-	if (typeof node.refPath === "string" && node.refPath) return node.refPath;
-	return null;
-}
-/** Read a stored world point, defaulting to the origin when absent. */
-function pointFromData(value) {
-	if (isRecord(value) && typeof value.x === "number" && typeof value.y === "number") return {
-		x: value.x,
-		y: value.y
-	};
-	return {
-		x: 0,
-		y: 0
-	};
-}
-function unknownItemFromNode(node, frame, style, locked, data) {
-	const raw = {
-		...data,
-		id: node.nodeId,
-		type: node.type,
-		frame
-	};
-	if (style) raw.style = style;
-	if (locked) raw.locked = true;
-	return {
-		id: node.nodeId,
-		type: UNKNOWN_BOARD_ITEM_TYPE,
-		frame,
-		...locked ? { locked } : {},
-		style,
-		raw
-	};
-}
-function boardNodeToItemValue(node) {
-	const frame = frameFromNode(node);
-	const style = styleFromNode(node);
-	const data = node.data ?? {};
-	const locked = lockedFromData(data);
-	switch (node.type) {
-		case "text": return {
-			id: node.nodeId,
-			type: "text",
-			text: typeof data.text === "string" ? data.text : "",
-			color: typeof data.color === "string" ? data.color : "neutral",
-			fontSize: clampBoardTextFontSize(typeof data.fontSize === "number" ? data.fontSize : TEXT_FONT_SIZE),
-			frame,
-			...locked ? { locked } : {},
-			style
-		};
-		case "geo": return {
-			id: node.nodeId,
-			type: "geo",
-			geo: typeof data.geo === "string" ? data.geo : "rectangle",
-			text: typeof data.text === "string" ? data.text : "",
-			color: typeof data.color === "string" ? data.color : "brand",
-			fillOpacity: typeof data.fillOpacity === "number" ? data.fillOpacity : 0,
-			frame,
-			...locked ? { locked } : {},
-			style
-		};
-		case "draw": return {
-			id: node.nodeId,
-			type: "draw",
-			points: Array.isArray(data.points) ? data.points : [],
-			color: typeof data.color === "string" ? data.color : "brand",
-			size: typeof data.size === "number" ? data.size : 4,
-			frame,
-			...locked ? { locked } : {},
-			style
-		};
-		case "arrow": return {
-			id: node.nodeId,
-			type: "arrow",
-			start: pointFromData(data.start),
-			end: pointFromData(data.end),
-			bend: typeof data.bend === "number" ? data.bend : 0,
-			color: typeof data.color === "string" ? data.color : "brand",
-			size: typeof data.size === "number" ? data.size : 2.5,
-			arrowStart: Boolean(data.arrowStart),
-			arrowEnd: data.arrowEnd === void 0 ? true : Boolean(data.arrowEnd),
-			label: typeof data.label === "string" ? data.label : "",
-			frame,
-			...locked ? { locked } : {},
-			style
-		};
-		case "frame": return {
-			id: node.nodeId,
-			type: "frame",
-			label: typeof data.label === "string" ? data.label : "Frame",
-			color: typeof data.color === "string" ? data.color : "neutral",
-			frame,
-			...locked ? { locked } : {},
-			style
-		};
-		case "image": {
-			const path = spaceFilePathFromNode(node) ?? "missing";
-			return {
-				id: node.nodeId,
-				type: "image",
-				ref: {
-					kind: "space-file",
-					path
-				},
-				snapshot: node.view,
-				...data.crop && typeof data.crop === "object" ? { crop: data.crop } : {},
-				frame,
-				...locked ? { locked } : {},
-				style
-			};
-		}
-		case "video": {
-			const path = spaceFilePathFromNode(node) ?? "missing";
-			return {
-				id: node.nodeId,
-				type: "video",
-				ref: {
-					kind: "space-file",
-					path
-				},
-				snapshot: node.view,
-				frame,
-				...locked ? { locked } : {},
-				style
-			};
-		}
-		case "audio": {
-			const path = spaceFilePathFromNode(node) ?? "missing";
-			return {
-				id: node.nodeId,
-				type: "audio",
-				ref: {
-					kind: "space-file",
-					path
-				},
-				snapshot: node.view,
-				frame,
-				...locked ? { locked } : {},
-				style
-			};
-		}
-		case "file": {
-			const path = spaceFilePathFromNode(node) ?? "missing";
-			const parsed = BoardFileSnapshotSchema.safeParse(node.view ?? {});
-			return {
-				id: node.nodeId,
-				type: "file",
-				ref: {
-					kind: "space-file",
-					path
-				},
-				...parsed.success ? { snapshot: parsed.data } : {},
-				frame,
-				...locked ? { locked } : {},
-				style
-			};
-		}
-		case "task": {
-			const parsed = BoardTaskSnapshotSchema.safeParse(node.view ?? {});
-			if (parsed.success && typeof data.taskRunId === "string") return {
-				id: node.nodeId,
-				type: "task",
-				taskRunId: data.taskRunId,
-				snapshot: parsed.data,
-				frame,
-				...locked ? { locked } : {},
-				style
-			};
-			return unknownItemFromNode(node, frame, style, locked, data);
-		}
-		default: return unknownItemFromNode(node, frame, style, locked, data);
-	}
-}
-function boardNodeToItem(node) {
-	const item = boardNodeToItemValue(node);
-	const metadata = isRecord(node.data?.metadata) ? node.data.metadata : void 0;
-	return {
-		...item,
-		...metadata ? { metadata } : {},
-		[BOARD_NODE_SOURCE]: nodeInputFromRecord(node)
-	};
-}
-function boardBootstrapToDocument(input) {
-	const appearance = BoardAppearanceSchema.safeParse(input.board.metadata.appearance);
-	const connections = (input.connections ?? []).map(({ boardId: _boardId, revision: _revision, createdAt: _createdAt, updatedAt: _updatedAt, ...connection }) => connection);
-	const document = parseBoardDocument({
-		kind: BOARD_DOCUMENT_KIND,
-		version: 1,
-		appearance: appearance.success ? appearance.data : DEFAULT_BOARD_APPEARANCE,
-		viewport: {
-			x: 0,
-			y: 0,
-			zoom: 1
-		},
-		items: input.nodes.map(boardNodeToItem),
-		connections
-	});
-	const sources = new Map(input.nodes.map((node) => [node.nodeId, nodeInputFromRecord(node)]));
-	return {
-		...document,
-		items: document.items.map((item) => ({
-			...item,
-			[BOARD_NODE_SOURCE]: sources.get(item.id)
-		}))
-	};
-}
-//#endregion
-export { BOARD_NODE_SOURCE, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, InvalidBoardFileError, boardBootstrapToDocument, boardNodeToItem, isBoardPath, isRecord, nodeInputFromRecord, parseBoardManifest, serializeBoardManifest, sourceForItem };