@neta-art/cohub 11.0.0 → 11.1.0

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

@@ -1,6 +1,29 @@
 import { BoardItem, BoardPatch, BoardScript, BoardVec2 } from "../../protocol/dist/board-model.js";
 import "../../protocol/dist/index.js";
 //#region src/board/model/script.d.ts
+type BoardScriptView = {
+  camera: {
+    x: number;
+    y: number;
+    zoom: number;
+  };
+  width: number;
+  height: number;
+  safeRect: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+};
+type BoardScriptAnchor = {
+  item: string;
+  point?: BoardVec2;
+};
+type BoardScriptSceneOptions = {
+  space?: "world" | "screen";
+  anchor?: BoardScriptAnchor;
+};
 type BoardScriptEvent = {
   type: string;
   target?: string;
@@ -17,6 +40,22 @@ type BoardScriptEvent = {
   metaKey?: boolean;
   data?: unknown;
 };
+type BoardScriptHostEvents = {
+  viewchange: BoardScriptView;
+  selectionchange: {
+    ids: string[];
+  };
+  transformend: {
+    ids: string[];
+    operation: "move" | "resize" | "rotate" | "arrow";
+    cancelled: boolean;
+  };
+};
+type BoardScriptEventOf<Type extends string> = BoardScriptEvent & {
+  type: Type;
+} & (Type extends keyof BoardScriptHostEvents ? {
+  data: BoardScriptHostEvents[Type];
+} : unknown);
 type BoardScriptFrame = {
   t: number;
   dt: number;
@@ -33,11 +72,16 @@ type BoardScriptItemPatch = Partial<Pick<BoardItem, "position" | "scale" | "rota
   };
   props?: Record<string, unknown>;
 };
-type BoardScriptHit = {
+type BoardScriptHit = ({
   x: number;
   y: number;
   width: number;
   height: number;
+} | {
+  target: "self";
+} | {
+  item: string;
+}) & {
   label?: string;
   cursor?: string;
 };
@@ -46,7 +90,7 @@ type BoardScriptSnapshot = {
   time: number;
   random: number;
   configuration?: string;
-  effects?: Pick<BoardScriptOutput, "patches" | "items" | "hits" | "space">;
+  effects?: Pick<BoardScriptOutput, "patches" | "items" | "hits" | "space" | "anchor">;
 };
 type BoardScriptParameter = {
   type: "number" | "boolean" | "string" | "color";
@@ -59,6 +103,7 @@ type BoardScriptParameter = {
 type BoardScriptOutput = {
   parameters?: Record<string, BoardScriptParameter>;
   space?: "world" | "screen";
+  anchor?: BoardScriptAnchor;
   patches: Record<string, Record<string, unknown>>;
   items: Record<string, unknown>;
   hits: Record<string, BoardScriptHit>;
@@ -78,16 +123,15 @@ type BoardScriptContext = {
   emit(target: string, type: string, data?: unknown): Promise<void>;
   readonly state: Record<string, unknown>;
   readonly frame: BoardScriptFrame;
+  readonly view: BoardScriptView | null;
   random(): number;
-  on(type: string, handler: (event: BoardScriptEvent) => void): () => void;
+  on<Type extends string>(type: Type, handler: (event: BoardScriptEventOf<Type>) => void): () => void;
   onFrame(handler: (frame: BoardScriptFrame) => void): () => void;
   onDispose(handler: () => void): void;
   invalidate(): void;
   get(id: string): BoardItem | undefined;
   present(id: string, patch: BoardScriptItemPatch | null): void;
-  scene(items: Record<string, unknown>, options?: {
-    space?: "world" | "screen";
-  }): void;
+  scene(items: Record<string, unknown>, options?: BoardScriptSceneOptions): void;
   hitRegions(hits: Record<string, BoardScriptHit>): void;
   commit(patch: BoardPatch): Promise<void>;
   capabilities: {
@@ -102,4 +146,4 @@ type BoardScriptModule = {
   animated?: boolean;
 };
 //#endregion
-export { BoardScriptContext, BoardScriptEvent, BoardScriptFrame, BoardScriptHit, BoardScriptItemPatch, BoardScriptModule, BoardScriptOutput, BoardScriptParameter, BoardScriptSnapshot };
+export { BoardScriptAnchor, BoardScriptContext, BoardScriptEvent, BoardScriptEventOf, BoardScriptFrame, BoardScriptHit, BoardScriptHostEvents, BoardScriptItemPatch, BoardScriptModule, BoardScriptOutput, BoardScriptParameter, BoardScriptSceneOptions, BoardScriptSnapshot, BoardScriptView };

package/dist/board/render/board-background.js

@@ -12,7 +12,7 @@ function buildGridTexture(context, size, color, opacity, kind) {
 		width: 1,
 		alpha: opacity
 	});
-	else graphics.circle(.5, .5, .9).fill({
+	else graphics.circle(size / 2, size / 2, 1.1).fill({
 		color,
 		alpha: opacity
 	});
@@ -49,8 +49,9 @@ function sync(parts, context) {
 	const kind = settings.background.kind === "grid" ? "grid" : "dots";
 	const visible = settings.grid?.visible === true;
 	const size = Math.max(4, settings.grid?.size ?? 24);
-	const opacity = .12;
-	const key = `${kind}|${size}|${palette.border}|${opacity}`;
+	const color = kind === "grid" ? palette.border : palette.muted;
+	const opacity = kind === "grid" ? .9 : .4;
+	const key = `${kind}|${size}|${color}|${opacity}`;
 	if (!visible) {
 		if (parts.sprite) parts.sprite.visible = false;
 		return;
@@ -61,7 +62,7 @@ function sync(parts, context) {
 			parts.sprite.destroy();
 			previousTexture.destroy(true);
 		}
-		const texture = buildGridTexture(context, size, palette.border, opacity, kind);
+		const texture = buildGridTexture(context, size, color, opacity, kind);
 		parts.sprite = new TilingSprite({
 			texture,
 			width,

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

@@ -1,4 +1,4 @@
-import { BoardCardRenderer, BoardCardRendererResolver, BoardRenderContext, BoardRenderPalette, BoardScriptHost, createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
+import { BoardCardRenderer, BoardCardRendererResolver, BoardRenderContext, BoardRenderLabels, BoardRenderPalette, BoardScriptHost, DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { createBoardRenderSampler } from "./sampling.js";
 import { BoardRenderDiagnostic, inspectBoardScene, measureBoardText } from "./diagnostics.js";
 import { BoardBackgroundContext, createBoardBackground, updateBoardBackground } from "./board-background.js";
@@ -14,4 +14,4 @@ import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
 import { BOARD_FONT_STACKS, ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, BoardBackgroundContext, BoardCardRenderer, BoardCardRendererResolver, BoardCssPaint, BoardMediaAction, BoardRenderContext, BoardRenderDiagnostic, BoardRenderPalette, BoardScriptHost, BoardScriptHostOptions, BrowserBoardScriptHost, ClipGroup, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardMediaActionAt, clippingAncestor, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, dashPattern, defaultBoardPalette, endAngle, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, inspectBoardScene, installBoardTextMeasurement, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, roundRectPoints, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceFrameOutline, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize };
+export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, BoardBackgroundContext, BoardCardRenderer, BoardCardRendererResolver, BoardCssPaint, BoardMediaAction, BoardRenderContext, BoardRenderDiagnostic, BoardRenderLabels, BoardRenderPalette, BoardScriptHost, BoardScriptHostOptions, BrowserBoardScriptHost, ClipGroup, DEFAULT_BOARD_RENDER_LABELS, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardMediaActionAt, clippingAncestor, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, dashPattern, defaultBoardPalette, endAngle, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, inspectBoardScene, installBoardTextMeasurement, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, roundRectPoints, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceFrameOutline, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/index.js

@@ -10,8 +10,8 @@ import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
 import { boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible } from "./media-interaction.js";
 import { dashPattern, endAngle, roundRectPoints, traceArrowhead, tracePolyline, trimPolyline } from "./stroke.js";
 import { BOARD_EFFECT_MAX_PARTICLES } from "./renderers/effect-card-renderer.js";
-import { createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
+import { DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { createBoardScriptHost } from "./script-host.js";
 import { prepareBrowserBoardScripts } from "./script-export.js";
 import { VIDEO_THUMBNAIL_MAX_EDGE, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
-export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, boardMediaActionAt, clippingAncestor, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, dashPattern, defaultBoardPalette, endAngle, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, inspectBoardScene, installBoardTextMeasurement, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, roundRectPoints, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceFrameOutline, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize };
+export { BOARD_EFFECT_MAX_PARTICLES, BOARD_FONT_STACKS, DEFAULT_BOARD_RENDER_LABELS, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, boardMediaActionAt, clippingAncestor, createBoardBackground, createBoardCardRendererResolver, createBoardRenderSampler, createBoardScriptHost, dashPattern, defaultBoardPalette, endAngle, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, inspectBoardScene, installBoardTextMeasurement, isClippingFrame, itemAlpha, itemColor, loadVideoThumbnailTexture, measureBoardText, mediaPlayBadgeHit, mediaPlayBadgeVisible, parseBoardCssColor, parseBoardCssPaint, prepareBrowserBoardScripts, roundRectPoints, syncClipGroup, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, traceArrowhead, traceFrameOutline, tracePolyline, trimPolyline, updateBoardBackground, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/media-interaction.js

@@ -1,4 +1,4 @@
-import { featuredTaskArtifact } from "../model/task.js";
+import { featuredTaskArtifact } from "../../protocol/dist/board-task.js";
 import "./renderers/task-card-renderer.js";
 //#region src/board/render/media-interaction.ts
 function mediaPlayBadgeVisible(item, zoom, options) {

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

@@ -1,4 +1,4 @@
-import { BoardCustomItem, BoardDocument, BoardSettings } from "../../../protocol/dist/board-model.js";
+import { BoardCustomItem, BoardDocument, BoardSettings, BoardTaskItem } from "../../../protocol/dist/board-model.js";
 import { BoardFrame } from "../../../protocol/dist/board-layout.js";
 import "../../../protocol/dist/index.js";
 import { BoardScene, BoardSceneItem, SceneItem } from "../../model/scene.js";
@@ -25,6 +25,14 @@ type BoardScriptHost = {
   error: (id: string) => string | null;
   release: (id: string) => void;
 };
+type BoardRenderLabels = {
+  queued: string;
+  generating: string;
+  failed: string;
+  previewUnavailable: string;
+  noPreview: string;
+};
+declare const DEFAULT_BOARD_RENDER_LABELS: BoardRenderLabels;
 type BoardRenderContext = {
   settings: BoardSettings;
   scene: BoardScene;
@@ -37,6 +45,12 @@ type BoardRenderContext = {
   rendererType: "gpu" | "canvas";
   zoom: number;
   time: number;
+  reducedMotion: boolean;
+  labels: BoardRenderLabels;
+  taskRun: (taskRunId: string) => {
+    status: BoardTaskItem["props"]["snapshot"]["status"];
+    startedAt?: string;
+  } | null;
   frameAt?: (id: string, time: number) => BoardFrame | undefined;
   scripts?: BoardScriptHost;
   assetKey: (item: BoardSceneItem) => string | null;
@@ -50,6 +64,7 @@ type BoardCardRenderer = {
   id: string;
   canRender: (item: BoardSceneItem, context: BoardRenderContext) => boolean;
   animated?: boolean;
+  tick?: (container: Container, clock: number) => number | null;
   create: (item: BoardSceneItem, context: BoardRenderContext) => Container;
   update: (container: Container, item: BoardSceneItem, context: BoardRenderContext) => void;
   renderFar?: (graphics: Graphics, item: BoardSceneItem, context: BoardRenderContext) => void;
@@ -64,4 +79,4 @@ declare function createBoardCardRendererResolver(renderers?: Iterable<BoardCardR
 /** The built-in renderers alone. */
 declare const getBoardCardRenderer: BoardCardRendererResolver;
 //#endregion
-export { BoardCardRenderer, BoardCardRendererResolver, BoardRenderContext, BoardRenderPalette, BoardScriptHost, createBoardCardRendererResolver, getBoardCardRenderer };
+export { BoardCardRenderer, BoardCardRendererResolver, BoardRenderContext, BoardRenderLabels, BoardRenderPalette, BoardScriptHost, DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer };

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

@@ -13,6 +13,13 @@ import { textCardRenderer } from "./text-card-renderer.js";
 import { unknownCardRenderer } from "./unknown-card-renderer.js";
 import { videoCardRenderer } from "./video-card-renderer.js";
 //#region src/board/render/renderers/board-renderer-registry.ts
+const DEFAULT_BOARD_RENDER_LABELS = {
+	queued: "Queued",
+	generating: "Generating",
+	failed: "Failed",
+	previewUnavailable: "Preview unavailable",
+	noPreview: "No preview"
+};
 const builtinCardRenderers = [
 	textCardRenderer,
 	imageCardRenderer,
@@ -41,4 +48,4 @@ function createBoardCardRendererResolver(renderers = []) {
 /** The built-in renderers alone. */
 const getBoardCardRenderer = createBoardCardRendererResolver();
 //#endregion
-export { createBoardCardRendererResolver, getBoardCardRenderer };
+export { DEFAULT_BOARD_RENDER_LABELS, createBoardCardRendererResolver, getBoardCardRenderer };

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

@@ -18,7 +18,8 @@ function sync(container, item, context) {
 	const texture = context.scripts?.frame(item, context.time, resolution) ?? null;
 	const error = context.scripts?.error(item.id) ?? null;
 	parts.sprite.visible = Boolean(texture);
-	if (texture && parts.sprite.texture !== texture) parts.sprite.texture = texture;
+	const display = texture ?? Texture.EMPTY;
+	if (parts.sprite.texture !== display) parts.sprite.texture = display;
 	parts.sprite.width = width;
 	parts.sprite.height = height;
 	const selected = context.selectedIds.has(item.id);

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

@@ -1,6 +1,7 @@
 import { BoardCardRenderer } from "./board-renderer-registry.js";
 //#region src/board/render/renderers/task-card-renderer.d.ts
 declare const TASK_CARD_FULL_DETAIL_ZOOM = 0.55;
+declare function formatTaskElapsed(ms: number): string;
 declare function containTaskPreviewRect(width: number, height: number, imageWidth: number, imageHeight: number): {
   x: number;
   y: number;
@@ -9,4 +10,4 @@ declare function containTaskPreviewRect(width: number, height: number, imageWidt
 };
 declare const taskCardRenderer: BoardCardRenderer;
 //#endregion
-export { TASK_CARD_FULL_DETAIL_ZOOM, containTaskPreviewRect, taskCardRenderer };
+export { TASK_CARD_FULL_DETAIL_ZOOM, containTaskPreviewRect, formatTaskElapsed, taskCardRenderer };