@neta-art/cohub-cli 6.3.0 → 6.4.0

package/dist/board-export.d.ts

@@ -1,8 +1,9 @@
 /**
  * Board image export for the CLI.
  *
- * Rendering runs through the same PixiJS card renderers the web editor uses (see
- * `@neta-art/cohub/board`), on a Canvas2D backend. Everything platform-specific
+ * The CLI and web editor share canonical Board geometry and card semantics. Each
+ * host selects the renderer primitive suited to its backend; this path uses
+ * Canvas2D. Everything platform-specific
  * lives here: fetching the document over HTTP, pulling image bytes out of the
  * space, and locating fonts on disk.
  */

package/dist/board-export.js

@@ -1,8 +1,9 @@
 /**
  * Board image export for the CLI.
  *
- * Rendering runs through the same PixiJS card renderers the web editor uses (see
- * `@neta-art/cohub/board`), on a Canvas2D backend. Everything platform-specific
+ * The CLI and web editor share canonical Board geometry and card semantics. Each
+ * host selects the renderer primitive suited to its backend; this path uses
+ * Canvas2D. Everything platform-specific
  * lives here: fetching the document over HTTP, pulling image bytes out of the
  * space, and locating fonts on disk.
  */

package/dist/commands/boards/examples.js

@@ -1,5 +1,4 @@
 import { json } from "../../output.js";
-const frame = { x: 120, y: 80, width: 320, height: 48, rotation: 0 };
 const templates = {
     "batch:basic": {
         commands: [
@@ -11,7 +10,9 @@ const templates = {
         items: [{
                 id: "title",
                 type: "text",
-                frame,
+                position: { x: 120, y: 80 },
+                size: { width: 320, height: 48 },
+                rotation: 0,
                 props: { text: "Launch plan", fontSize: 32 },
                 style: { color: "brand" },
             }],
@@ -24,21 +25,27 @@ const templates = {
             {
                 id: "request",
                 type: "text",
-                frame: { x: 80, y: 190, width: 180, height: 48, rotation: 0 },
+                position: { x: 80, y: 190 },
+                size: { width: 180, height: 48 },
+                rotation: 0,
                 props: { text: "Request", fontSize: 28 },
                 style: { color: "brand" },
             },
             {
                 id: "agent",
                 type: "geo",
-                frame: { x: 360, y: 150, width: 240, height: 120, rotation: 0 },
+                position: { x: 360, y: 150 },
+                size: { width: 240, height: 120 },
+                rotation: 0,
                 props: { shape: "rounded", text: "Agent" },
                 style: { color: "blue", fillOpacity: 0.08 },
             },
             {
                 id: "result",
                 type: "geo",
-                frame: { x: 700, y: 150, width: 240, height: 120, rotation: 0 },
+                position: { x: 700, y: 150 },
+                size: { width: 240, height: 120 },
+                rotation: 0,
                 props: { shape: "rounded", text: "Result" },
                 style: { color: "green", fillOpacity: 0.08 },
             },
@@ -55,28 +62,36 @@ const templates = {
             {
                 id: "hero",
                 type: "image",
-                frame: { x: 80, y: 100, width: 640, height: 360, rotation: 0 },
+                position: { x: 80, y: 100 },
+                size: { width: 640, height: 360 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/hero.webp" },
                 props: {},
             },
             {
                 id: "demo-video",
                 type: "video",
-                frame: { x: 760, y: 100, width: 480, height: 270, rotation: 0 },
+                position: { x: 760, y: 100 },
+                size: { width: 480, height: 270 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/demo.mp4" },
                 props: {},
             },
             {
                 id: "soundtrack",
                 type: "audio",
-                frame: { x: 80, y: 500, width: 400, height: 96, rotation: 0 },
+                position: { x: 80, y: 500 },
+                size: { width: 400, height: 96 },
+                rotation: 0,
                 source: { kind: "space-file", path: "assets/soundtrack.mp3" },
                 props: {},
             },
             {
                 id: "brief",
                 type: "file",
-                frame: { x: 520, y: 500, width: 320, height: 180, rotation: 0 },
+                position: { x: 520, y: 500 },
+                size: { width: 320, height: 180 },
+                rotation: 0,
                 source: { kind: "space-file", path: "docs/brief.md" },
                 props: {},
             },
@@ -90,14 +105,16 @@ const templates = {
             {
                 id: "title",
                 type: "text",
-                frame: { x: 120, y: 80, width: 320, height: 48, rotation: 0 },
+                position: { x: 120, y: 80 },
+                size: { width: 320, height: 48 },
+                rotation: 0,
                 props: { text: "Launch", fontSize: 32 },
                 style: { color: "brand" },
             },
             {
                 id: "stroke",
                 type: "draw",
-                frame: { x: 120, y: 180, width: 180, height: 100, rotation: 0 },
+                rotation: 0,
                 props: { points: [{ x: 2, y: 98, p: 0.5 }, { x: 90, y: 2, p: 0.5 }, { x: 178, y: 98, p: 0.5 }] },
                 style: { color: "violet", strokeWidth: 4 },
             },
@@ -150,70 +167,86 @@ const templates = {
     "item:text": {
         id: "title",
         type: "text",
-        frame,
+        position: { x: 120, y: 80 },
+        size: { width: 320, height: 48 },
+        rotation: 0,
         props: { text: "Launch plan", fontSize: 32 },
         style: { color: "brand" },
     },
     "item:image": {
         id: "hero",
         type: "image",
-        frame: { x: 120, y: 160, width: 640, height: 360, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 640, height: 360 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/hero.webp" },
         props: {},
     },
     "item:geo": {
         id: "goal",
         type: "geo",
-        frame: { x: 120, y: 160, width: 280, height: 140, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 280, height: 140 },
+        rotation: 0,
         props: { shape: "rounded", text: "Ship" },
         style: { color: "green", fillOpacity: 0.12 },
     },
     "item:frame": {
         id: "scene",
         type: "frame",
-        frame: { x: 80, y: 60, width: 960, height: 540, rotation: 0 },
+        position: { x: 80, y: 60 },
+        size: { width: 960, height: 540 },
+        rotation: 0,
         props: { label: "Scene 1" },
         style: { color: "neutral" },
     },
     "item:draw": {
         id: "stroke",
         type: "draw",
-        frame: { x: 100, y: 100, width: 180, height: 100, rotation: 0 },
-        props: { points: [{ x: 2, y: 98, p: 0.5 }, { x: 90, y: 2, p: 0.5 }, { x: 178, y: 98, p: 0.5 }] },
+        rotation: 0,
+        props: { points: [{ x: 102, y: 198, p: 0.5 }, { x: 190, y: 102, p: 0.5 }, { x: 278, y: 198, p: 0.5 }] },
         style: { color: "violet", strokeWidth: 4 },
     },
     "item:arrow": {
         id: "arrow",
         type: "arrow",
-        frame: { x: 100, y: 100, width: 260, height: 100, rotation: 0 },
+        rotation: 0,
         props: { start: { x: 116, y: 150 }, end: { x: 344, y: 150 }, bend: 0, arrowStart: false, arrowEnd: true, label: "next" },
         style: { color: "brand", strokeWidth: 2.5 },
     },
     "item:video": {
         id: "demo-video",
         type: "video",
-        frame: { x: 120, y: 160, width: 640, height: 360, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 640, height: 360 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/demo.mp4" },
         props: {},
     },
     "item:audio": {
         id: "soundtrack",
         type: "audio",
-        frame: { x: 120, y: 540, width: 480, height: 96, rotation: 0 },
+        position: { x: 120, y: 540 },
+        size: { width: 480, height: 96 },
+        rotation: 0,
         source: { kind: "space-file", path: "assets/soundtrack.mp3" },
         props: {},
     },
     "item:file": {
         id: "brief",
         type: "file",
-        frame: { x: 120, y: 160, width: 360, height: 220, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 360, height: 220 },
+        rotation: 0,
         source: { kind: "space-file", path: "docs/brief.md" },
         props: {},
     },
     "item:task": {
         id: "task",
         type: "task",
-        frame: { x: 120, y: 160, width: 420, height: 240, rotation: 0 },
+        position: { x: 120, y: 160 },
+        size: { width: 420, height: 240 },
+        rotation: 0,
         props: { taskRunId: "task-run-id", snapshot: { taskType: "generation", status: "running", title: "Generate concept", artifactCount: 0, artifacts: [] } },
     },
     "effect:pulse": {

package/dist/commands/boards/items.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { BoardAuthoringItemSchema, BoardItemPatchSchema, } from "@neta-art/cohub";
+import { computeArrowFrame, computeDrawBounds } from "@neta-art/cohub/board";
 import { BOARD_DOMAIN_INPUT_MAX_BYTES, readBoardJsonObject, } from "../../board-command-support.js";
 import { handleHttp, json, jsonRequested, ok, table } from "../../output.js";
 import { readInput, readOptions, resolvedBoard, withJson, } from "./context.js";
@@ -38,6 +39,25 @@ function mutationOptions(command) {
         .option("--mutation-id <id>", "Stable id for safe retries")
         .option("--dry-run", "Validate on the server (references, version, cascade) without writing");
 }
+function itemLayout(item) {
+    if ("position" in item) {
+        const size = "size" in item ? item.size : undefined;
+        return { x: item.position.x, y: item.position.y, width: size?.width ?? "", height: size?.height ?? "" };
+    }
+    if (item.type === "draw") {
+        const points = item.props.points;
+        const strokeWidth = item.style?.strokeWidth ?? 4;
+        const bounds = computeDrawBounds(points, strokeWidth);
+        return { x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height };
+    }
+    const bounds = computeArrowFrame({
+        start: item.props.start,
+        end: item.props.end,
+        bend: item.props.bend,
+        size: item.style?.strokeWidth ?? 2.5,
+    });
+    return { x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height };
+}
 export function registerBoardItemCommands(boards) {
     const items = boards.command("items").description("Author Board items with semantic JSON");
     readOptions(withJson(items.command("list <board>").alias("ls").description("List semantic Board items")))
@@ -51,10 +71,7 @@ export function registerBoardItemCommands(boards) {
             table(items.map((item) => ({
                 id: item.id,
                 type: item.type,
-                x: item.frame.x,
-                y: item.frame.y,
-                width: item.frame.width,
-                height: item.frame.height,
+                ...itemLayout(item),
             })), [
                 { key: "id", label: "ID" },
                 { key: "type", label: "TYPE" },
@@ -81,10 +98,7 @@ export function registerBoardItemCommands(boards) {
             table([{
                     id: item.id,
                     type: item.type,
-                    x: item.frame.x,
-                    y: item.frame.y,
-                    width: item.frame.width,
-                    height: item.frame.height,
+                    ...itemLayout(item),
                 }], [
                 { key: "id", label: "ID" },
                 { key: "type", label: "TYPE" },
@@ -103,7 +117,7 @@ export function registerBoardItemCommands(boards) {
         .requiredOption("-i, --input <file>", "Board Item JSON; use - for stdin")
         .addHelpText("after", `
 Minimal text item:
-  {"id":"title","type":"text","frame":{"x":120,"y":80,"width":320,"height":48,"rotation":0},"props":{"text":"Launch plan","fontSize":32},"style":{"color":"brand"}}`))
+  {"id":"title","type":"text","position":{"x":120,"y":80},"size":{"width":320,"height":48},"props":{"text":"Launch plan","fontSize":32},"style":{"color":"brand"}}`))
         .action(async (target, options) => {
         try {
             const value = await readBoardJsonObject(options.input, BOARD_DOMAIN_INPUT_MAX_BYTES);
@@ -122,7 +136,7 @@ Minimal text item:
         .addHelpText("after", `
 Objects merge recursively, arrays replace, and null clears optional fields.
 Move and rename a text item without replacing its size or font:
-  {"frame":{"x":160,"y":120},"props":{"text":"Updated"}}`))
+  {"position":{"x":160,"y":120},"props":{"text":"Updated"}}`))
         .action(async (target, itemId, options) => {
         try {
             const value = await readBoardJsonObject(options.input, BOARD_DOMAIN_INPUT_MAX_BYTES);

package/dist/commands/boards.d.ts

@@ -7,4 +7,11 @@ export declare function parseViewport(value?: string): {
     width: number;
     height: number;
 } | undefined;
+export declare function showCreated(result: {
+    board: {
+        id: string;
+        title: string;
+        version: number;
+    };
+}, path: string): void;
 export declare function registerBoards(program: Command): Command;

package/dist/commands/boards.js

@@ -38,8 +38,9 @@ export function parseViewport(value) {
         throw new Error("viewport width and height must be greater than zero");
     return { x, y, width, height };
 }
-function showCreated(result) {
-    table([result.board], [
+export function showCreated(result, path) {
+    table([{ path, ...result.board }], [
+        { key: "path", label: "Path" },
         { key: "id", label: "ID" },
         { key: "title", label: "Title" },
         { key: "version", label: "Version" },
@@ -240,9 +241,9 @@ Generate an editable seed:
             };
             const result = await createClient().space(resolveSpace(boards)).boards.create(input);
             if (jsonRequested(options))
-                return outJson(result);
-            ok(`Board created: ${result.board.id}`);
-            showCreated(result);
+                return outJson({ ...result, path });
+            ok(`Board created: ${path}`);
+            showCreated(result, path);
         }
         catch (cause) {
             handleHttp(cause);
@@ -276,6 +277,9 @@ Apply multiple changes atomically:
         .description("Show authoring schemas and runtime capabilities")
         .addHelpText("after", `
 Use --json for complete Item, patch, mutation, effect, Composition, and create JSON Schemas.
+Coordinates:
+  draw points and arrow start/end points are world-space.
+  Position and size are optional; Board geometry derives the persisted frame automatically.
 Use boards examples for editable starter JSON.`))
         .action(async (target, options) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "6.3.0",
+  "version": "6.4.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,7 +19,7 @@
     "commander": "^15.0.0",
     "pixi.js": "^8.20.1",
     "sharp": "^0.35.4",
-    "@neta-art/cohub": "8.6.0"
+    "@neta-art/cohub": "8.7.0"
   },
   "publishConfig": {
     "access": "public"