@neta-art/cohub 5.8.2 → 5.10.0

package/dist/board/render/css-color.d.ts

@@ -0,0 +1,4 @@
+//#region src/board/render/css-color.d.ts
+declare function parseBoardCssColor(value: string): number | null;
+//#endregion
+export { parseBoardCssColor };

package/dist/board/render/css-color.js

@@ -0,0 +1,36 @@
+import { DOMAdapter } from "pixi.js";
+//#region src/board/render/css-color.ts
+const CACHE_LIMIT = 256;
+const cache = /* @__PURE__ */ new Map();
+let canvas = null;
+function parseBoardCssColor(value) {
+	const key = value.trim();
+	if (!key) return null;
+	const cached = cache.get(key);
+	if (cached !== void 0 || cache.has(key)) return cached ?? null;
+	let result = null;
+	try {
+		const direct = /^#([0-9a-f]{6})$/i.exec(key);
+		if (direct?.[1]) result = Number.parseInt(direct[1], 16);
+		else {
+			canvas ??= DOMAdapter.get().createCanvas(1, 1);
+			const context = canvas.getContext("2d");
+			if (context) {
+				context.fillStyle = "#010203";
+				context.fillStyle = key;
+				const first = String(context.fillStyle);
+				context.fillStyle = "#040506";
+				context.fillStyle = key;
+				const match = first === String(context.fillStyle) ? /^#([0-9a-f]{6})$/i.exec(first) : null;
+				if (match?.[1]) result = Number.parseInt(match[1], 16);
+			}
+		}
+	} catch {
+		result = null;
+	}
+	if (cache.size >= CACHE_LIMIT) cache.clear();
+	cache.set(key, result);
+	return result;
+}
+//#endregion
+export { parseBoardCssColor };

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

@@ -1,4 +1,5 @@
 import { ConnectionLayer, ConnectionRenderInput, createConnectionLayer, framesFromItems } from "./connection-layer.js";
+import { parseBoardCssColor } from "./css-color.js";
 import { BoardMediaAction, boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible } from "./media-interaction.js";
 import { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { defaultBoardPalette } from "./palette.js";
@@ -7,4 +8,4 @@ import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { BoardThemeContext, BoardThemeRenderer, getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { BoardCardRenderer, BoardMediaAction, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, ConnectionLayer, ConnectionRenderInput, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };
+export { BoardCardRenderer, BoardMediaAction, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, ConnectionLayer, ConnectionRenderInput, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/index.js

@@ -1,3 +1,4 @@
+import { parseBoardCssColor } from "./css-color.js";
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { createConnectionLayer, framesFromItems } from "./connection-layer.js";
 import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
@@ -7,4 +8,4 @@ import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-
 import { boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };
+export { TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };

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

@@ -1,6 +1,7 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
+import { parseBoardCssColor } from "../css-color.js";
 import { getBoardResolution } from "../text-resolution.js";
-import { Container, DOMAdapter, Graphics, Text } from "pixi.js";
+import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/base-card-renderer.ts
 const CARD_RADIUS = 10;
 const CARD_PADDING = 12;
@@ -11,7 +12,7 @@ const TEXT_OPTIONS = {
 };
 function emphasisColor(item, palette) {
 	if (item.style?.accentColor) {
-		const normalized = parseCssColor(item.style.accentColor);
+		const normalized = parseBoardCssColor(item.style.accentColor);
 		if (normalized != null) return normalized;
 	}
 	switch (item.style?.emphasis) {
@@ -21,24 +22,6 @@ function emphasisColor(item, palette) {
 		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,

package/dist/board/render/themes/clean-theme.js

@@ -1,3 +1,4 @@
+import { parseBoardCssColor } from "../css-color.js";
 import { Container, Graphics, RenderTexture, TilingSprite } from "pixi.js";
 //#region src/board/render/themes/clean-theme.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();
@@ -31,16 +32,18 @@ function sync(parts, context) {
 	const { app, document, viewport, palette } = context;
 	const width = app.screen.width;
 	const height = app.screen.height;
+	const declaredBackground = document.appearance.background;
+	const bgColor = declaredBackground.color ? parseBoardCssColor(declaredBackground.color) ?? palette.bg : palette.bg;
 	const bgAlpha = context.hasImageBackground ? 0 : 1;
-	if (parts.lastWidth !== width || parts.lastHeight !== height || parts.lastBg !== palette.bg || parts.lastBgAlpha !== bgAlpha) {
+	if (parts.lastWidth !== width || parts.lastHeight !== height || parts.lastBg !== bgColor || parts.lastBgAlpha !== bgAlpha) {
 		parts.fill.clear();
 		parts.fill.rect(0, 0, width, height).fill({
-			color: palette.bg,
+			color: bgColor,
 			alpha: bgAlpha
 		});
 		parts.lastWidth = width;
 		parts.lastHeight = height;
-		parts.lastBg = palette.bg;
+		parts.lastBg = bgColor;
 		parts.lastBgAlpha = bgAlpha;
 	}
 	const appearance = document.appearance;

package/dist/chunks/http.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateInvitationInput, $n as SpaceFsPreparingFile, Ar as SpaceTurnAuthorFilter, At as MeResponse, Ba as BoardConnectionRecord, Bn as SpaceDefaultResponse, Cr as SpacePublicProfile, Ct as LabelItemsResponse, Dn as SpaceCommerceBenefit, Dt as LabelResourceType, Ea as BoardValidationResult, Ei as SessionTurnPatchEvent, En as SpaceCheckpointDetailResponse, G as CheckpointDiffFileResponse, Ga as SessionForkRecord, Gn as SpaceFsCreateUploadInput, Gt as ReferenceAggregateResponse, H as Channel, Hn as SpaceFsCompleteUploadInput, Hr as UserProfile, In as SpaceConfigInput, Ir as TaskRunDetailResponse, Ja as SessionTurnRecord, Ji as UiCommandError, Jr as ChannelHealth, Jt as ReferenceQueryResponse, Ki as UiCommand, Kn as SpaceFsCreateUploadResponse, Kr as UserSessionsResponse, Kt as ReferenceDirection, Ln as SpaceConfigResponse, Lr as TaskRunRecord, Lt as PromptTemplateCatalogResponse, Mi as WorkArtifactDescriptor, Mn as SpaceCommerceProduct, Mt as PatchResourceLabelsInput, Nn as SpaceCommerceProductBenefitBinding, Nt as PatchResourceLabelsResponse, On as SpaceCommerceBuyerProfile, Pr as SpaceUsageResponse, Pt as Permission, Q as ClaimReferralResponse, Qn as SpaceFsMoveInput, Qt as ReferralDashboard, Ra as BoardConnection, Ri as WorkContentKind, Rn as SpaceConfigUpdateResponse, Rr as UserActivityQuery, Rt as PublicReferral, St as LabelAssignmentRecord, Ta as BoardTransaction, Tr as SpaceRole, Tt as LabelListItem, Ua as SpacePublicEndpoints, Un as SpaceFsCompleteUploadResponse, Ur as UserRulesResponse, Vn as SpaceEnvInput, Vr as UserActivityResponse, Wa as MessageRecord, Wt as ReferenceAggregateGroupBy, X as CheckpointDiffSummary, Xi as UiCommandStatus, Ya as SpaceTurnsResponse, Yi as UiCommandRecord, Yt as ReferenceQueryableType, Z as CheckpointRecord, Zn as SpaceFsFileResponse, _n as SkillCatalogResponse, a as WebsocketClientOptions, aa as BoardBootstrap, ao as Usage, at as CreateSpaceSessionInput, bn as SpaceAccessPolicy, br as SpacePendingDiffSummary, ca as BoardCreateInput, cn as SessionMessagesResponse, ct as CronJobUpdatePatch, d as BatchUserProfilesResponse, di as GenerationContentBlock, dn as SessionTurnResponse, do as RequestSource, dr as SpaceFsWriteFileInput, et as CreateInvitationResponse, fa as BoardInspectInput, fi as GenerationModelDeclaration, fn as SessionTurnSignedUrlsResponse, gi as BoardTransactionAppliedEvent$1, gr as SpaceMember, gt as InvitationDetail, hi as BoardPlaybackChangedEvent$1, hn as SessionTurnsPaginatedResponse, ht as GlobalSearchType, io as SpaceCompletionStreamEvent, it as CreateSpacePromptResponse, ji as BoardAwarenessUpdate, jn as SpaceCommerceOrder, jt as ModelCatalogEntry, kr as SpaceSessionsResponse, l as AcceptInvitationResponse, ln as SessionRecord, lt as CursorPageInfo, mi as BoardAwarenessUpdatedEvent$1, mn as SessionTurnWindowResponse, nr as SpaceFsReadFilesResponse, oa as BoardCapabilities, on as SessionMessageResponse, oo as BillingPayload, pn as SessionTurnStreamSnapshotResponse, pr as SpaceInvitationListResponse, pt as GlobalSearchResponse, qr as ChannelConfig, qt as ReferenceKind, r as WebsocketClient, ro as SpaceCompletionResult, rr as SpaceFsTreeResponse, rt as CreateSpacePromptInput, s as WebsocketEventPayload, sn as SessionMessagesPaginatedResponse, so as ContentBlock, st as CronJobRecord, to as CreateSpaceCompletionInput, tt as CreateSpaceInput, un as SessionTurnIndexResponse, ur as SpaceFsUploadResponse, va as BoardPlaybackCommand, vr as SpaceModListItem, wr as SpaceRecord, xa as BoardPlaybackSnapshot, xr as SpacePresenceSnapshot, yi as RealtimePatchOperation, yr as SpacePendingDiffFileResponse, za as BoardConnectionDirection, zn as SpaceCreateResponse, zt as PublicUserPageResponse } from "./websocket.js";
+import { $ as CreateInvitationInput, $n as SpaceFsPreparingFile, Aa as BoardTransaction, Ar as SpaceTurnAuthorFilter, At as MeResponse, Bn as SpaceDefaultResponse, Cr as SpacePublicProfile, Ct as LabelItemsResponse, Dn as SpaceCommerceBenefit, Dt as LabelResourceType, Ei as SessionTurnPatchEvent, En as SpaceCheckpointDetailResponse, G as CheckpointDiffFileResponse, Ga as BoardConnectionRecord, Gn as SpaceFsCreateUploadInput, Gt as ReferenceAggregateResponse, H as Channel, Hn as SpaceFsCompleteUploadInput, Hr as UserProfile, In as SpaceConfigInput, Ir as TaskRunDetailResponse, Ji as UiCommandError, Jr as ChannelHealth, Jt as ReferenceQueryResponse, Ki as UiCommand, Kn as SpaceFsCreateUploadResponse, Kr as UserSessionsResponse, Kt as ReferenceDirection, Ln as SpaceConfigResponse, Lr as TaskRunRecord, Lt as PromptTemplateCatalogResponse, Mi as WorkArtifactDescriptor, Mn as SpaceCommerceProduct, Mt as PatchResourceLabelsInput, Nn as SpaceCommerceProductBenefitBinding, Nt as PatchResourceLabelsResponse, Oa as BoardSummary, On as SpaceCommerceBuyerProfile, Pr as SpaceUsageResponse, Pt as Permission, Q as ClaimReferralResponse, Qn as SpaceFsMoveInput, Qt as ReferralDashboard, Ri as WorkContentKind, Rn as SpaceConfigUpdateResponse, Rr as UserActivityQuery, Rt as PublicReferral, Sa as BoardPlaybackCommand, St as LabelAssignmentRecord, Ta as BoardPlaybackSnapshot, Tr as SpaceRole, Tt as LabelListItem, Ua as BoardConnection, Un as SpaceFsCompleteUploadResponse, Ur as UserRulesResponse, Vn as SpaceEnvInput, Vr as UserActivityResponse, Wa as BoardConnectionDirection, Wt as ReferenceAggregateGroupBy, X as CheckpointDiffSummary, Xa as MessageRecord, Xi as UiCommandStatus, Ya as SpacePublicEndpoints, Yi as UiCommandRecord, Yt as ReferenceQueryableType, Z as CheckpointRecord, Za as SessionForkRecord, Zn as SpaceFsFileResponse, _n as SkillCatalogResponse, _o as RequestSource, a as WebsocketClientOptions, at as CreateSpaceSessionInput, bn as SpaceAccessPolicy, br as SpacePendingDiffSummary, cn as SessionMessagesResponse, ct as CronJobUpdatePatch, d as BatchUserProfilesResponse, di as GenerationContentBlock, dn as SessionTurnResponse, do as Usage, dr as SpaceFsWriteFileInput, eo as SessionTurnRecord, et as CreateInvitationResponse, fa as BoardCreateInput, fi as GenerationModelDeclaration, fn as SessionTurnSignedUrlsResponse, fo as BillingPayload, ga as BoardInspectInput, gi as BoardTransactionAppliedEvent$1, gr as SpaceMember, gt as InvitationDetail, hi as BoardPlaybackChangedEvent$1, hn as SessionTurnsPaginatedResponse, ht as GlobalSearchType, it as CreateSpacePromptResponse, ja as BoardValidationResult, ji as BoardAwarenessUpdate, jn as SpaceCommerceOrder, jt as ModelCatalogEntry, kr as SpaceSessionsResponse, l as AcceptInvitationResponse, ln as SessionRecord, lo as SpaceCompletionResult, lt as CursorPageInfo, mi as BoardAwarenessUpdatedEvent$1, mn as SessionTurnWindowResponse, nr as SpaceFsReadFilesResponse, oa as BoardBootstrap, on as SessionMessageResponse, pn as SessionTurnStreamSnapshotResponse, po as ContentBlock, pr as SpaceInvitationListResponse, pt as GlobalSearchResponse, qr as ChannelConfig, qt as ReferenceKind, r as WebsocketClient, rr as SpaceFsTreeResponse, rt as CreateSpacePromptInput, s as WebsocketEventPayload, sn as SessionMessagesPaginatedResponse, so as CreateSpaceCompletionInput, st as CronJobRecord, to as SpaceTurnsResponse, tt as CreateSpaceInput, ua as BoardCapabilities, un as SessionTurnIndexResponse, uo as SpaceCompletionStreamEvent, ur as SpaceFsUploadResponse, vr as SpaceModListItem, wr as SpaceRecord, xa as BoardOperation, xr as SpacePresenceSnapshot, yi as RealtimePatchOperation, yr as SpacePendingDiffFileResponse, zn as SpaceCreateResponse, zt as PublicUserPageResponse } from "./websocket.js";
 import { n as CohubEnvironment } from "./environment.js";
 import { a as VoiceInputCreateOptions } from "./voice-input.js";
 //#region ../protocol/dist/model/status.d.ts
@@ -969,6 +969,11 @@ declare class BoardTransactionError extends Error {
   get isVersionConflict(): boolean;
 }
 type BoardTransactionInput = Omit<BoardTransaction, "boardId">;
+type BoardMutationInput = {
+  include?: BoardInspectInput["include"];
+  retries?: number;
+  build: (current: BoardBootstrap) => BoardOperation[] | Promise<BoardOperation[]>;
+};
 type BoardTransactionAppliedEvent = BoardTransactionAppliedEvent$1;
 type BoardAwarenessUpdatedEvent = BoardAwarenessUpdatedEvent$1;
 type BoardPlaybackChangedEvent = BoardPlaybackChangedEvent$1;
@@ -1511,8 +1516,12 @@ declare class BoardClient {
   constructor(spaceId: string, id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
   inspect(input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
   capabilities(customFetch?: Fetch): Promise<BoardCapabilities>;
+  summary(customFetch?: Fetch): Promise<BoardSummary>;
+  mutate(input: BoardMutationInput): Promise<BoardBootstrap>;
   validate(transaction: BoardTransactionInput): Promise<BoardValidationResult>;
-  apply(transaction: BoardTransactionInput): Promise<BoardBootstrap>;
+  apply(transaction: BoardTransactionInput, options?: {
+    compact?: boolean;
+  }): Promise<BoardBootstrap>;
   updateAwareness(seq: number, update: BoardAwarenessUpdate): Promise<void>;
   playback(command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
   /**
@@ -1596,9 +1605,12 @@ declare class SpaceBoardsApi {
   byId(boardId: string): BoardClient;
   create(input: BoardCreateInput): Promise<BoardBootstrap>;
   inspect(boardId: string, input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
+  summary(boardId: string, customFetch?: Fetch): Promise<BoardSummary>;
   capabilities(boardId: string, customFetch?: Fetch): Promise<BoardCapabilities>;
   validate(transaction: BoardTransaction): Promise<BoardValidationResult>;
-  apply(transaction: BoardTransaction): Promise<BoardBootstrap>;
+  apply(transaction: BoardTransaction, options?: {
+    compact?: boolean;
+  }): Promise<BoardBootstrap>;
   playback(boardId: string, command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
   play(boardId: string, command: Omit<Extract<BoardPlaybackCommand, {
     type: "play";
@@ -2246,4 +2258,4 @@ declare class CohubHttpClient {
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { BoardTransactionError as $, GenerationsApi as $t, WorkResolveResponse as A, PublicFileUploadPlanEntry as An, SessionPatchApplyInput as At, ReferralsApi as B, ModelStatusResponse as Bn, CreatePublicAssetUploadInput as Bt, WorkPromotionProvider as C, createWorkRuntime as Cn, GenerationStreamStateEvent as Ct, WorkPublicOwnerRecord as D, PublicFileListEntry as Dn, SessionGenerationStreamClient as Dt, WorkPromotionStatsResponse as E, PublicFileCreateUploadResponse as En, GenerationStreamTurnUpdatedEvent as Et, WorkVersionRecord as F, GenerationTaskResult as Fn, createSessionPatchReducer as Ft, WaitForUiCommandOptions as G, PublicAssetUploadProtocol as Gt, UserApi as H, PublicAssetMimeType as Ht, WorkViewSource as I, GenerationUsageBilling as In, SessionAccessApi as It, BoardClient as J, UploadChatImageAttachmentInput as Jt, TasksApi as K, PublicAssetsApi as Kt, WorkViewStatsResponse as L, ListGenerationModelsResponse as Ln, ReferenceResourceSelector as Lt, WorkStatus as M, SpaceStartupResponse as Mn, SessionPatchReducer as Mt, WorkTargetType as N, CreateGenerationTaskRequest as Nn, SessionPatchState as Nt, WorkPublicSpaceRecord as O, PublicFileListResponse as On, createSessionGenerationStreamClient as Ot, WorkUpdateInput as P, CreateGenerationTaskResponse as Pn, SessionPatchStatus as Pt, BoardTransactionAppliedEvent as Q, ModelsApi as Qt, WorkVisibility as R, PublicGenerationDeclaration as Rn, ReferencesApi as Rt, WorkPromotionEventResponse as S, createSlugWorkIdResolver as Sn, GenerationStreamOutOfSyncEvent as St, WorkPromotionRecord as T, PublicFileCreateUploadInput as Tn, GenerationStreamSubscriptionHandlers as Tt, CreateUiCommandInput as U, PublicAssetPurpose as Ut, UsersApi as V, CreatePublicAssetUploadResponse as Vt, UiCommandsApi as W, PublicAssetUploadProgress as Wt, BoardPlaybackChangedEvent as X, SkillsApi as Xt, BoardEventName as Y, UploadPublicAssetInput as Yt, BoardSubscriptionHandlers as Z, PromptsApi as Zt, WorkExtractedPageMeta as _, WorkRuntimeCheckoutStatus as _n, GenerationStreamErrorEvent as _t, WorkCommerceCreditConsumeResponse as a, HttpTraceContext as an, SpaceEventName as at, WorkPresentationMeta as b, WorkRuntimeRequestOptions as bn, GenerationStreamIntermediateMessage as bt, WorkCommerceEntitlementsResponse as c, UnauthorizedContext as cn, SpacesApi as ct, WorkCommercePurchaseResponse as d, sanitizeAccessToken as dn, BuildSpacePathInput as dt, CronJobsApi as en, BoardTransactionInput as et, WorkAuthorizeResponse as f, ParentBridgeTransport as fn, PublicInviteApi as ft, WorkDetailResponse as g, WorkRuntimeCheckoutState as gn, GenerationStreamCommitEvent as gt, WorkCreateInput as h, WorkRuntimeApi as hn, AssistantMessageCommit as ht, WorkCommerceCheckoutStatus as i, HttpError as in, SpaceClient as it, WorkSessionResponse as j, PublicFileUrlResponse as jn, SessionPatchApplyResult as jt, WorkRecord as k, PublicFileUploadEntryInput as kn, parseAssistantMessageCommit as kt, WorkCommerceOrder as l, joinApiUrl as ln, WebSocketConnectionState as lt, WorkContentDownload as m, WorkIdResolver as mn, buildSpacePath as mt, createHttpClient as n, CohubClientOptions as nn, SessionSubscriptionHandlers as nt, WorkCommerceCreditConsumeStatus as o, HttpTransport as on, SpacePublicFilesApi as ot, WorkContent as p, PopupBrokerTransport as pn, buildSpaceInvitePath as pt, BoardAwarenessUpdatedEvent as q, UploadChatAttachmentInput as qt, WorkCommerceApi as r, Fetch as rn, SpaceChannelBindingRecord as rt, WorkCommerceEntitlement as s, RawHttpResponse as sn, SpaceTurnListOptions as st, CohubHttpClient as t, ChannelsApi as tn, SessionEventName as tt, WorkCommerceProductResolveResponse as u, matchesUnauthorizedErrorToken as un, BuildSpaceInvitePathInput as ut, WorkGetResponse as v, WorkRuntimeContext as vn, GenerationStreamEvent as vt, WorkPromotionProviderStatus as w, resolveWorkTransport as wn, GenerationStreamSubscribeOptions as wt, WorkPromotionCreateInput as x, WorkRuntimeTransport as xn, GenerationStreamLifecycleEvent as xt, WorkMeta as y, WorkRuntimeModeConfig as yn, GenerationStreamFinalizedEvent as yt, WorksApi as z, ModelStatusEntry as zn, SearchApi as zt };
+export { BoardTransactionAppliedEvent as $, ModelsApi as $t, WorkResolveResponse as A, PublicFileUploadEntryInput as An, parseAssistantMessageCommit as At, ReferralsApi as B, ModelStatusEntry as Bn, SearchApi as Bt, WorkPromotionProvider as C, createSlugWorkIdResolver as Cn, GenerationStreamOutOfSyncEvent as Ct, WorkPublicOwnerRecord as D, PublicFileCreateUploadResponse as Dn, GenerationStreamTurnUpdatedEvent as Dt, WorkPromotionStatsResponse as E, PublicFileCreateUploadInput as En, GenerationStreamSubscriptionHandlers as Et, WorkVersionRecord as F, CreateGenerationTaskResponse as Fn, SessionPatchStatus as Ft, WaitForUiCommandOptions as G, PublicAssetUploadProgress as Gt, UserApi as H, CreatePublicAssetUploadResponse as Ht, WorkViewSource as I, GenerationTaskResult as In, createSessionPatchReducer as It, BoardClient as J, UploadChatAttachmentInput as Jt, TasksApi as K, PublicAssetUploadProtocol as Kt, WorkViewStatsResponse as L, GenerationUsageBilling as Ln, SessionAccessApi as Lt, WorkStatus as M, PublicFileUrlResponse as Mn, SessionPatchApplyResult as Mt, WorkTargetType as N, SpaceStartupResponse as Nn, SessionPatchReducer as Nt, WorkPublicSpaceRecord as O, PublicFileListEntry as On, SessionGenerationStreamClient as Ot, WorkUpdateInput as P, CreateGenerationTaskRequest as Pn, SessionPatchState as Pt, BoardSubscriptionHandlers as Q, PromptsApi as Qt, WorkVisibility as R, ListGenerationModelsResponse as Rn, ReferenceResourceSelector as Rt, WorkPromotionEventResponse as S, WorkRuntimeTransport as Sn, GenerationStreamLifecycleEvent as St, WorkPromotionRecord as T, resolveWorkTransport as Tn, GenerationStreamSubscribeOptions as Tt, CreateUiCommandInput as U, PublicAssetMimeType as Ut, UsersApi as V, ModelStatusResponse as Vn, CreatePublicAssetUploadInput as Vt, UiCommandsApi as W, PublicAssetPurpose as Wt, BoardMutationInput as X, UploadPublicAssetInput as Xt, BoardEventName as Y, UploadChatImageAttachmentInput as Yt, BoardPlaybackChangedEvent as Z, SkillsApi as Zt, WorkExtractedPageMeta as _, WorkRuntimeCheckoutState as _n, GenerationStreamCommitEvent as _t, WorkCommerceCreditConsumeResponse as a, HttpError as an, SpaceClient as at, WorkPresentationMeta as b, WorkRuntimeModeConfig as bn, GenerationStreamFinalizedEvent as bt, WorkCommerceEntitlementsResponse as c, RawHttpResponse as cn, SpaceTurnListOptions as ct, WorkCommercePurchaseResponse as d, matchesUnauthorizedErrorToken as dn, BuildSpaceInvitePathInput as dt, GenerationsApi as en, BoardTransactionError as et, WorkAuthorizeResponse as f, sanitizeAccessToken as fn, BuildSpacePathInput as ft, WorkDetailResponse as g, WorkRuntimeApi as gn, AssistantMessageCommit as gt, WorkCreateInput as h, WorkIdResolver as hn, buildSpacePath as ht, WorkCommerceCheckoutStatus as i, Fetch as in, SpaceChannelBindingRecord as it, WorkSessionResponse as j, PublicFileUploadPlanEntry as jn, SessionPatchApplyInput as jt, WorkRecord as k, PublicFileListResponse as kn, createSessionGenerationStreamClient as kt, WorkCommerceOrder as l, UnauthorizedContext as ln, SpacesApi as lt, WorkContentDownload as m, PopupBrokerTransport as mn, buildSpaceInvitePath as mt, createHttpClient as n, ChannelsApi as nn, SessionEventName as nt, WorkCommerceCreditConsumeStatus as o, HttpTraceContext as on, SpaceEventName as ot, WorkContent as p, ParentBridgeTransport as pn, PublicInviteApi as pt, BoardAwarenessUpdatedEvent as q, PublicAssetsApi as qt, WorkCommerceApi as r, CohubClientOptions as rn, SessionSubscriptionHandlers as rt, WorkCommerceEntitlement as s, HttpTransport as sn, SpacePublicFilesApi as st, CohubHttpClient as t, CronJobsApi as tn, BoardTransactionInput as tt, WorkCommerceProductResolveResponse as u, joinApiUrl as un, WebSocketConnectionState as ut, WorkGetResponse as v, WorkRuntimeCheckoutStatus as vn, GenerationStreamErrorEvent as vt, WorkPromotionProviderStatus as w, createWorkRuntime as wn, GenerationStreamStateEvent as wt, WorkPromotionCreateInput as x, WorkRuntimeRequestOptions as xn, GenerationStreamIntermediateMessage as xt, WorkMeta as y, WorkRuntimeContext as yn, GenerationStreamEvent as yt, WorksApi as z, PublicGenerationDeclaration as zn, ReferencesApi as zt };

package/dist/chunks/http.js

@@ -466,6 +466,7 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 	"effects.color",
 	"camera.pan",
 	"camera.zoom",
+	"camera.focus",
 	"camera.shake"
 ];
 const BOARD_BUILTIN_EFFECT_KINDS = ["effects.pulse", "effects.float"];
@@ -475,12 +476,66 @@ function clampBoardStrokeSize(size) {
 	if (!Number.isFinite(size)) return BOARD_CONNECTION_STROKE_SIZE;
 	return Math.min(64, Math.max(1, size));
 }
-const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => ({
-	kind: "clip",
-	id,
-	version: 1,
-	renderers: ["webgpu", "webgl"]
-})), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => ({
+function clipSchema(id) {
+	switch (id) {
+		case "motion.keyframes": return { params: {
+			x: {
+				coordinateSpace: "world-offset",
+				unit: "board"
+			},
+			y: {
+				coordinateSpace: "world-offset",
+				unit: "board"
+			}
+		} };
+		case "motion.path": return { params: { points: {
+			coordinateSpace: "world-offset",
+			unit: "board"
+		} } };
+		case "effects.particles": return { params: { bounds: {
+			coordinateSpace: "world",
+			unit: "board"
+		} } };
+		case "camera.pan": return { params: {
+			x: {
+				coordinateSpace: "screen-offset",
+				unit: "css-px"
+			},
+			y: {
+				coordinateSpace: "screen-offset",
+				unit: "css-px"
+			}
+		} };
+		case "camera.zoom": return { params: { scale: { unit: "ratio" } } };
+		case "camera.focus": return { params: {
+			focus: {
+				coordinateSpace: "world",
+				unit: "board"
+			},
+			padding: {
+				coordinateSpace: "screen",
+				unit: "css-px"
+			},
+			minZoom: { unit: "ratio" },
+			maxZoom: { unit: "ratio" }
+		} };
+		case "camera.shake": return { params: { amount: {
+			coordinateSpace: "screen-offset",
+			unit: "css-px"
+		} } };
+		default: return;
+	}
+}
+const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => {
+	const schema = clipSchema(id);
+	return {
+		kind: "clip",
+		id,
+		version: 1,
+		renderers: ["webgpu", "webgl"],
+		...schema ? { schema } : {}
+	};
+}), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => ({
 	kind: "effect",
 	id,
 	version: 1,
@@ -671,6 +726,47 @@ const BoardTargetSchema = z.discriminatedUnion("type", [
 	z.object({ type: z.literal("board") }),
 	z.object({ type: z.literal("camera") })
 ]);
+z.object({
+	centerX: finiteSchema$1,
+	centerY: finiteSchema$1,
+	zoom: finiteSchema$1.positive()
+});
+const BoardCameraFocusSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("rect"),
+		rect: z.object({
+			x: finiteSchema$1,
+			y: finiteSchema$1,
+			width: finiteSchema$1.positive(),
+			height: finiteSchema$1.positive()
+		})
+	}),
+	z.object({
+		type: z.literal("node"),
+		nodeId: idSchema$1
+	}),
+	z.object({
+		type: z.literal("nodes"),
+		nodeIds: z.array(idSchema$1).min(1).max(1e3)
+	}),
+	z.object({
+		type: z.literal("frame"),
+		frameId: idSchema$1
+	})
+]);
+const BoardCameraFocusParamsSchema = z.object({
+	focus: BoardCameraFocusSchema,
+	fit: z.enum(["contain", "cover"]).default("contain"),
+	padding: finiteSchema$1.nonnegative().default(32),
+	minZoom: finiteSchema$1.positive().optional(),
+	maxZoom: finiteSchema$1.positive().optional()
+}).superRefine((value, context) => {
+	if (value.minZoom !== void 0 && value.maxZoom !== void 0 && value.minZoom > value.maxZoom) context.addIssue({
+		code: "custom",
+		message: "minZoom must not exceed maxZoom",
+		path: ["minZoom"]
+	});
+});
 const BoardAssetRefSchema = z.object({
 	type: z.enum(["space-file", "extension"]),
 	ref: z.string().min(1).max(4096),
@@ -916,11 +1012,16 @@ function isBlockedIpv6(host) {
 	if ((first & 65280) === 65280) return true;
 	return parts[0] === "2001" && parts[1] === "0db8";
 }
+function isPublicBoardRemoteAddress(value) {
+	const address = value.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
+	if (parseIpv4(address)) return !isBlockedIpv4(address);
+	return address.includes(":") && !isBlockedIpv6(address);
+}
 function isBlockedHost(hostname) {
 	const host = hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
 	if (host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal")) return true;
-	if (parseIpv4(host)) return isBlockedIpv4(host);
-	return host.includes(":") && isBlockedIpv6(host);
+	if (parseIpv4(host) || host.includes(":")) return !isPublicBoardRemoteAddress(host);
+	return false;
 }
 /**
 * Normalize a browser-loadable public HTTP(S) URL. This blocks explicit local
@@ -974,7 +1075,20 @@ const BoardAppearanceSchema = z.object({
 			"custom"
 		]).default("dots"),
 		color: z.string().optional(),
-		imageUrl: z.string().url().optional()
+		imageUrl: BoardRemoteUrlSchema.optional(),
+		fit: z.enum([
+			"cover",
+			"contain",
+			"repeat"
+		]).optional(),
+		position: z.enum([
+			"center",
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]).optional(),
+		opacity: z.number().finite().min(0).max(1).optional()
 	}).default({ kind: "solid" }),
 	grid: z.object({
 		visible: z.boolean().default(false),
@@ -1811,10 +1925,36 @@ const parseUiCommand = (input) => {
 		command: null,
 		error: "command.preview is required"
 	};
-	if (preview.kind !== "work") return {
+	if (preview.kind !== "work" && preview.kind !== "file") return {
 		command: null,
-		error: "command.preview.kind must be one of: work"
+		error: "command.preview.kind must be one of: work, file"
 	};
+	if (preview.kind === "file") {
+		const path = asTrimmed(preview.path);
+		if (!path) return {
+			command: null,
+			error: "command.preview.path is required"
+		};
+		if (path.length > 2048 || path.startsWith("/") || path.includes("\0") || path.includes("\\") || path.split("/").some((segment) => segment === "..")) return {
+			command: null,
+			error: "command.preview.path must be a relative Space file path"
+		};
+		const command = {
+			type: "preview.show",
+			preview: {
+				kind: "file",
+				path
+			}
+		};
+		if (input.request !== void 0 && input.request !== null) return {
+			command: null,
+			error: "command.request is only supported for Work previews"
+		};
+		return {
+			command,
+			error: null
+		};
+	}
 	const workId = asTrimmed(preview.workId);
 	if (!workId) return {
 		command: null,
@@ -4239,17 +4379,38 @@ var BoardClient = class {
 	capabilities(customFetch) {
 		return this.boards.capabilities(this.id, customFetch);
 	}
+	summary(customFetch) {
+		return this.boards.summary(this.id, customFetch);
+	}
+	async mutate(input) {
+		const retries = input.retries ?? 1;
+		if (!Number.isSafeInteger(retries) || retries < 0 || retries > 3) throw new RangeError("Board mutation retries must be an integer from 0 to 3");
+		for (let attempt = 0;; attempt += 1) {
+			const current = await this.inspect({ include: input.include ?? [] });
+			const operations = await input.build(current);
+			if (operations.length === 0) return current;
+			try {
+				return await this.apply({
+					txId: randomBoardId(),
+					baseVersion: current.board.version,
+					operations
+				}, { compact: true });
+			} catch (cause) {
+				if (!(cause instanceof BoardTransactionError) || !cause.isVersionConflict || attempt >= retries) throw cause;
+			}
+		}
+	}
 	validate(transaction) {
 		return this.boards.validate({
 			...transaction,
 			boardId: this.id
 		});
 	}
-	apply(transaction) {
+	apply(transaction, options) {
 		return this.boards.apply({
 			...transaction,
 			boardId: this.id
-		});
+		}, options);
 	}
 	updateAwareness(seq, update) {
 		if (!this.websocketClient) return Promise.resolve();
@@ -4393,6 +4554,9 @@ var SpaceBoardsApi = class {
 		const query = params.toString();
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}${query ? `?${query}` : ""}`, { fetch: customFetch });
 	}
+	summary(boardId, customFetch) {
+		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/summary`, { fetch: customFetch });
+	}
 	capabilities(boardId, customFetch) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/capabilities`, { fetch: customFetch });
 	}
@@ -4403,10 +4567,10 @@ var SpaceBoardsApi = class {
 			body: JSON.stringify(transaction)
 		});
 	}
-	async apply(transaction) {
+	async apply(transaction, options) {
 		assertBoardTransactionNodeCreates(transaction.operations);
 		try {
-			return await this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/transactions`, {
+			return await this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/transactions${options?.compact ? "?compact=1" : ""}`, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify(transaction)
@@ -5195,4 +5359,4 @@ var CohubHttpClient = class {
 };
 const createHttpClient = (options) => new CohubHttpClient(options);
 //#endregion
-export { parseUsername as $, WORK_SURFACE_READY_TIMEOUT_MS as A, parseWorkSurfaceRequest as B, BoardInputError as C, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES as D, validateBoardNodes as E, buildWorkSurfaceRequest as F, UI_COMMAND_PENDING_TTL_SECONDS as G, UI_COMMAND_DEFAULT_TIMEOUT_MS as H, buildWorkSurfaceResponse as I, UI_COMMAND_VERSION as J, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as K, parseWorkComposerChipClear as L, buildWorkComposerChipClear as M, buildWorkComposerChipSet as N, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH as O, buildWorkSurfaceReady as P, parseSpaceSlug as Q, parseWorkComposerChipSet as R, createSessionPatchReducer as S, createBoardNode as T, UI_COMMAND_MAX_TIMEOUT_MS as U, parseWorkSurfaceResponse as V, UI_COMMAND_PAYLOAD_MAX_BYTES as W, isUiSurfaceMethod as X, isTerminalUiCommandStatus as Y, parseUiCommand as Z, buildSpacePath as _, ModelsApi as _t, ReferralsApi as a, validateBoardNodeInput as at, parseAssistantMessageCommit as b, ChannelsApi as bt, UiCommandsApi as c, ensureRealtimeConnected as ct, BoardTransactionError as d, SessionAccessApi as dt, BoardAwarenessClientPayloadSchema as et, SpaceClient as f, ReferencesApi as ft, buildSpaceInvitePath as g, PromptsApi as gt, PublicInviteApi as h, SkillsApi as ht, WorksApi as i, BOARD_NODE_CONTRACT as it, WORK_SURFACE_REQUEST_TIMEOUT_MS as j, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH as k, TasksApi as l, BOARD_BUILTIN_CAPABILITIES as lt, SpacesApi as m, PublicAssetsApi as mt, createHttpClient as n, BOARD_GEO_KINDS as nt, UsersApi as o, BoardPlaybackPolicySchema as ot, SpacePublicFilesApi as p, SearchApi as pt, UI_COMMAND_TERMINAL_TTL_SECONDS as q, WorkCommerceApi as r, BOARD_NATIVE_NODE_TYPES as rt, UserApi as s, parseBoardPlaybackPolicy as st, CohubHttpClient as t, BOARD_COLOR_IDS as tt, BoardClient as u, DEFAULT_BOARD_RENDER_LIMITS as ut, SessionGenerationStreamClient as v, GenerationsApi as vt, assertBoardNodes as w, SessionPatchReducer as x, createSessionGenerationStreamClient as y, CronJobsApi as yt, parseWorkSurfaceReady as z };
+export { parseUsername as $, WORK_SURFACE_READY_TIMEOUT_MS as A, parseWorkSurfaceRequest as B, BoardInputError as C, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES as D, validateBoardNodes as E, buildWorkSurfaceRequest as F, UI_COMMAND_PENDING_TTL_SECONDS as G, UI_COMMAND_DEFAULT_TIMEOUT_MS as H, buildWorkSurfaceResponse as I, UI_COMMAND_VERSION as J, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as K, parseWorkComposerChipClear as L, buildWorkComposerChipClear as M, buildWorkComposerChipSet as N, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH as O, buildWorkSurfaceReady as P, parseSpaceSlug as Q, parseWorkComposerChipSet as R, createSessionPatchReducer as S, createBoardNode as T, UI_COMMAND_MAX_TIMEOUT_MS as U, parseWorkSurfaceResponse as V, UI_COMMAND_PAYLOAD_MAX_BYTES as W, isUiSurfaceMethod as X, isTerminalUiCommandStatus as Y, parseUiCommand as Z, buildSpacePath as _, PromptsApi as _t, ReferralsApi as a, validateBoardNodeInput as at, parseAssistantMessageCommit as b, CronJobsApi as bt, UiCommandsApi as c, parseBoardPlaybackPolicy as ct, BoardTransactionError as d, DEFAULT_BOARD_RENDER_LIMITS as dt, BoardAwarenessClientPayloadSchema as et, SpaceClient as f, SessionAccessApi as ft, buildSpaceInvitePath as g, SkillsApi as gt, PublicInviteApi as h, PublicAssetsApi as ht, WorksApi as i, BOARD_NODE_CONTRACT as it, WORK_SURFACE_REQUEST_TIMEOUT_MS as j, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH as k, TasksApi as l, ensureRealtimeConnected as lt, SpacesApi as m, SearchApi as mt, createHttpClient as n, BOARD_GEO_KINDS as nt, UsersApi as o, BoardCameraFocusParamsSchema as ot, SpacePublicFilesApi as p, ReferencesApi as pt, UI_COMMAND_TERMINAL_TTL_SECONDS as q, WorkCommerceApi as r, BOARD_NATIVE_NODE_TYPES as rt, UserApi as s, BoardPlaybackPolicySchema as st, CohubHttpClient as t, BOARD_COLOR_IDS as tt, BoardClient as u, BOARD_BUILTIN_CAPABILITIES as ut, SessionGenerationStreamClient as v, ModelsApi as vt, assertBoardNodes as w, SessionPatchReducer as x, ChannelsApi as xt, createSessionGenerationStreamClient as y, GenerationsApi as yt, parseWorkSurfaceReady as z };