@neta-art/cohub-cli 8.4.0 → 9.0.0

package/dist/board-time.d.ts

@@ -0,0 +1,3 @@
+export declare function parseBoardTime(value: string, name?: string): number;
+export declare function parseBoardTimes(value: string, name?: string, limit?: number): number[];
+export declare function formatBoardTime(ms: number): string;

package/dist/board-time.js

@@ -0,0 +1,28 @@
+const UNITS = { "": 1, ms: 1, s: 1000, m: 60_000 };
+export function parseBoardTime(value, name = "time") {
+    const match = /^\s*(\d+(?:\.\d+)?|\.\d+)\s*(ms|s|m)?\s*$/i.exec(value);
+    if (!match?.[1])
+        throw new Error(`${name}: expected a time such as 1500, 500ms, 12.5s or 2m`);
+    return Math.round(Number(match[1]) * (UNITS[(match[2] ?? "").toLowerCase()] ?? 1) * 1000) / 1000;
+}
+export function parseBoardTimes(value, name = "--at", limit = 10_000) {
+    const parts = value.split(":");
+    if (parts.length === 1)
+        return [parseBoardTime(value, name)];
+    if (parts.length !== 3)
+        throw new Error(`${name}: expected a time or start:end:step`);
+    const [start, end, step] = parts.map((part) => parseBoardTime(part, name));
+    if (step <= 0)
+        throw new Error(`${name}: step must be greater than zero`);
+    if (end < start)
+        throw new Error(`${name}: end must not be before start`);
+    const count = Math.floor((end - start) / step + 1e-9) + 1;
+    if (count > limit)
+        throw new Error(`${name}: ${count} frames exceed the limit of ${limit}`);
+    return Array.from({ length: count }, (_, index) => Math.round((start + index * step) * 1000) / 1000);
+}
+export function formatBoardTime(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${Number((ms / 1000).toFixed(3))}s`;
+}

package/dist/commands/apps.js

@@ -275,7 +275,7 @@ export function registerApps(program) {
         .description("List apps in the target space")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = await resolveSpace(appsCmd);
+        const spaceId = await resolveSpace(appsCmd, { home: true });
         const client = createClient();
         try {
             const result = await client.apps.listBySpace(spaceId);
@@ -421,7 +421,7 @@ export function registerApps(program) {
         const source = opts.source ? parseChoice(opts.source, "source", ["workspace", "local"]) : resolveDefaultAppSource();
         if (target.targetType === "port" && opts.source)
             return error("Invalid source", "--source applies only to --file and --dir.");
-        const spaceId = await resolveSpace(appsCmd);
+        const spaceId = await resolveSpace(appsCmd, { home: true });
         const client = createClient();
         let { targetType, targetRef } = target;
         let sourceRef = null;

package/dist/commands/auth.js

@@ -1,5 +1,5 @@
 import { authSource, loginWithDeviceFlow, readAuthSession, refreshAccessToken, requestDeviceCode, revokeAndClearAuthSession, verifyDeviceCode } from "../auth.js";
-import { clearDefaultSpaceCache } from "../space.js";
+import { clearHomeSpaceCache } from "../space.js";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, ok, error, spinner, handleHttp } from "../output.js";
 export function registerAuth(program) {
@@ -68,7 +68,7 @@ export function registerAuth(program) {
         .description("Clear stored Logto session")
         .action(async () => {
         await revokeAndClearAuthSession();
-        clearDefaultSpaceCache();
+        clearHomeSpaceCache();
         if (process.env.COHUB_EXECUTION_TOKEN?.trim()) {
             ok("Local session cleared. COHUB_EXECUTION_TOKEN is still set.");
         }

package/dist/commands/boards/examples.d.ts

@@ -1,4 +1,10 @@
 import type { Command } from "commander";
-export declare const BOARD_EXAMPLE_KEYS: string[];
-export declare function boardExample(kind: string, type?: string): unknown;
+/**
+ * Starter documents for `boards create -i` and patches for `boards apply -i`.
+ * Every example is a valid Board patch; `boards.test.ts` checks that.
+ */
+export declare const BOARD_EXAMPLES: Record<string, {
+    description: string;
+    value: Record<string, unknown>;
+}>;
 export declare function registerBoardExampleCommands(boards: Command): void;

package/dist/commands/boards/examples.js

@@ -1,429 +1,97 @@
 import { json } from "../../output.js";
-const templates = {
-    "batch:basic": {
-        commands: [
-            { type: "board.patch", patch: { title: "Updated title" } },
-            { type: "item.patch", itemId: "title", patch: { props: { text: "Updated text" } } },
-        ],
-    },
-    "create": {
-        items: [{
-                id: "title",
-                type: "text",
-                position: { x: 120, y: 80 },
-                size: { width: 320, height: 48 },
-                rotation: 0,
-                props: { text: "Launch plan", fontSize: 32 },
-                style: { color: "brand" },
-            }],
-        connections: [],
-        effects: [],
-        compositions: [],
-    },
-    "create:workflow": {
-        items: [
-            {
-                id: "request",
-                type: "text",
-                position: { x: 80, y: 190 },
-                size: { width: 180, height: 48 },
-                rotation: 0,
-                props: { text: "Request", fontSize: 28 },
-                style: { color: "brand" },
-            },
-            {
-                id: "agent",
-                type: "geo",
-                position: { x: 360, y: 150 },
-                size: { width: 240, height: 120 },
-                rotation: 0,
-                props: { shape: "rounded", text: "Agent" },
-                style: { color: "blue", fillOpacity: 0.08 },
+/**
+ * Starter documents for `boards create -i` and patches for `boards apply -i`.
+ * Every example is a valid Board patch; `boards.test.ts` checks that.
+ */
+export const BOARD_EXAMPLES = {
+    basic: {
+        description: "A title, a note and a shape.",
+        value: {
+            board: { title: "Launch plan" },
+            items: {
+                title: { type: "text", position: { x: 80, y: 60 }, props: { text: "Launch plan", fontSize: 48, fontWeight: 700 } },
+                note: { type: "text", position: { x: 80, y: 140 }, props: { text: "Ship the beta to ten design partners, then widen.", fontSize: 20, width: 420 } },
+                goal: { type: "shape", position: { x: 600, y: 60 }, size: { width: 240, height: 140 }, style: { stroke: "green", fill: "green", fillOpacity: 0.12, radius: 16 }, props: { text: "Beta in March" } },
             },
-            {
-                id: "result",
-                type: "geo",
-                position: { x: 700, y: 150 },
-                size: { width: 240, height: 120 },
-                rotation: 0,
-                props: { shape: "rounded", text: "Result" },
-                style: { color: "green", fillOpacity: 0.08 },
-            },
-        ],
-        connections: [
-            { id: "request-agent", source: { itemId: "request" }, target: { itemId: "agent" }, relation: "triggers", label: "invoke" },
-            { id: "agent-result", source: { itemId: "agent" }, target: { itemId: "result" }, relation: "produces", label: "output" },
-        ],
-        effects: [],
-        compositions: [],
+        },
     },
-    "create:media": {
-        items: [
-            {
-                id: "hero",
-                type: "image",
-                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",
-                position: { x: 760, y: 100 },
-                size: { width: 480, height: 270 },
-                rotation: 0,
-                source: { kind: "space-file", path: "assets/demo.mp4" },
-                props: {},
+    workflow: {
+        description: "Steps joined by bound arrows with relations.",
+        value: {
+            items: {
+                request: { type: "shape", position: { x: 80, y: 160 }, size: { width: 200, height: 110 }, style: { stroke: "brand" }, props: { geometry: "rounded", text: "Request" } },
+                agent: { type: "shape", position: { x: 400, y: 160 }, size: { width: 200, height: 110 }, style: { stroke: "blue", fill: "blue", fillOpacity: 0.08 }, props: { geometry: "rounded", text: "Agent" } },
+                result: { type: "shape", position: { x: 720, y: 160 }, size: { width: 200, height: 110 }, style: { stroke: "green", fill: "green", fillOpacity: 0.08 }, props: { geometry: "rounded", text: "Result" } },
+                "request-agent": { type: "arrow", props: { start: { item: "request" }, end: { item: "agent" }, relation: "triggers", label: "invoke" } },
+                "agent-result": { type: "arrow", props: { start: { item: "agent" }, end: { item: "result" }, relation: "produces", label: "output" } },
             },
-            {
-                id: "soundtrack",
-                type: "audio",
-                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",
-                position: { x: 520, y: 500 },
-                size: { width: 320, height: 180 },
-                rotation: 0,
-                source: { kind: "space-file", path: "docs/brief.md" },
-                props: {},
-            },
-        ],
-        connections: [],
-        effects: [],
-        compositions: [],
+        },
     },
-    "create:animation": {
-        items: [
-            {
-                id: "title",
-                type: "text",
-                position: { x: 120, y: 80 },
-                size: { width: 320, height: 48 },
-                rotation: 0,
-                props: { text: "Launch", fontSize: 32 },
-                style: { color: "brand" },
+    slides: {
+        description: "Frames as slides; children move and clip with their frame.",
+        value: {
+            items: {
+                s1: { type: "frame", position: { x: 0, y: 0 }, size: { width: 1600, height: 900 }, props: { label: "Intro" } },
+                "s1-title": { type: "text", parent: "s1", position: { x: 120, y: 120 }, props: { text: "Special relativity", fontSize: 96, fontWeight: 700 } },
+                "s1-sub": { type: "text", parent: "s1", position: { x: 120, y: 260 }, props: { text: "Nothing outruns light", fontSize: 40 } },
+                s2: { type: "frame", position: { x: 1800, y: 0 }, size: { width: 1600, height: 900 }, props: { label: "Time dilation" } },
+                "s2-title": { type: "text", parent: "s2", position: { x: 120, y: 120 }, props: { text: "Moving clocks run slow", fontSize: 72, fontWeight: 700 } },
             },
-            {
-                id: "stroke",
-                type: "draw",
-                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 },
-            },
-        ],
-        connections: [],
-        effects: [{
-                id: "pulse-title",
-                target: { type: "item", itemId: "title" },
-                kind: "effects.pulse",
-                kindVersion: 1,
-                lifecycle: "when-visible",
-                timeOrigin: "visible",
-                seed: "pulse-title",
-                params: { amount: 0.04, period: 1600 },
-            }],
-        compositions: [
-            {
-                id: "intro",
-                name: "Intro",
-                timeline: {
-                    duration: 800,
-                    tracks: [{
-                            id: "title-opacity",
-                            target: { type: "item", itemId: "title" },
-                            channel: "style.opacity",
-                            fill: "both",
-                            keyframes: [{ time: 0, value: 0 }, { time: 800, value: 1, easing: "ease-out-cubic" }],
-                        }],
-                },
+        },
+    },
+    lesson: {
+        description: "An animated lesson: entrances, a drawn arrow, typed text and camera moves with pause markers.",
+        value: {
+            items: {
+                s1: { type: "frame", size: { width: 1600, height: 900 }, props: { label: "Length contraction" } },
+                title: { type: "text", parent: "s1", position: { x: 120, y: 100 }, props: { text: "Moving rulers get shorter", fontSize: 72, fontWeight: 700 } },
+                ruler: { type: "shape", parent: "s1", position: { x: 200, y: 420 }, size: { width: 800, height: 60 }, style: { stroke: "blue", fill: "blue", fillOpacity: 0.15 }, props: { text: "1 m" } },
+                caption: { type: "text", parent: "s1", position: { x: 200, y: 560 }, props: { text: "L = L₀ √(1 − v²/c²)", fontSize: 44, font: "serif", reveal: 1 } },
+                motion: { type: "arrow", parent: "s1", style: { stroke: "rose", strokeWidth: 4 }, props: { start: { x: 200, y: 360 }, end: { x: 1000, y: 360 }, label: "v → c" } },
+                glow: { type: "effect", parent: "s1", position: { x: 1050, y: 380 }, size: { width: 160, height: 160 }, style: { fill: "amber" }, props: { kind: "glow" } },
             },
-            {
-                id: "draw-stroke",
-                name: "Draw stroke",
-                timeline: {
-                    duration: 900,
-                    clips: [{
-                            id: "reveal-stroke",
-                            kind: "draw.reveal",
-                            kindVersion: 1,
-                            target: { type: "item", itemId: "stroke" },
-                            start: 0,
-                            duration: 900,
-                            easing: "ease-out-cubic",
-                            seed: "reveal-stroke",
-                        }],
+            animations: {
+                lecture: {
+                    markers: [{ at: 1500, label: "Ruler", pause: true }, { at: 5000, label: "Formula", pause: true }],
+                    tracks: {
+                        "title-in": { target: "title", property: "opacity", composite: "add", keyframes: [{ at: 0, value: 0 }, { at: 600, value: 1, ease: "ease-out" }] },
+                        "arrow-draw": { target: "motion", property: "style.trim", keyframes: [{ at: 800, value: 0 }, { at: 1800, value: 1, ease: "ease-in-out" }] },
+                        "ruler-shrink": { target: "ruler", property: "scale", keyframes: [{ at: 2000, value: 1 }, { at: 4000, value: { x: 0.45, y: 1 }, ease: "ease-in-out" }] },
+                        "caption-type": { target: "caption", property: "props.reveal", keyframes: [{ at: 4200, value: 0 }, { at: 6000, value: 1 }] },
+                        "camera-focus": { target: "camera", property: "focus", keyframes: [{ at: 0, value: "s1" }, { at: 2000, value: "ruler" }, { at: 4500, value: "s1" }] },
+                    },
                 },
             },
-        ],
-    },
-    "item:text": {
-        id: "title",
-        type: "text",
-        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",
-        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",
-        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",
-        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",
-        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",
-        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",
-        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",
-        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",
-        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",
-        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": {
-        id: "pulse-title",
-        target: { type: "item", itemId: "title" },
-        kind: "effects.pulse",
-        kindVersion: 1,
-        lifecycle: "when-visible",
-        timeOrigin: "visible",
-        seed: "pulse-title",
-        params: { amount: 0.04, period: 1600 },
-    },
-    "effect:float": {
-        id: "float-hero",
-        target: { type: "item", itemId: "hero" },
-        kind: "effects.float",
-        kindVersion: 1,
-        lifecycle: "when-visible",
-        timeOrigin: "visible",
-        seed: "float-hero",
-        params: { distance: 8, period: 2200 },
-    },
-    "effect:deal": {
-        id: "deal-title",
-        target: { type: "item", itemId: "title" },
-        kind: "effects.deal",
-        kindVersion: 1,
-        lifecycle: "on-enter",
-        timeOrigin: "activation",
-        seed: "deal-title",
-        params: {},
-    },
-    "motion:enter-deal": {
-        enter: {
-            kind: "effects.deal",
-            kindVersion: 1,
-            params: {},
-        },
-    },
-    "composition:fade": {
-        id: "intro",
-        name: "Intro",
-        timeline: {
-            duration: 800,
-            tracks: [{
-                    id: "title-opacity",
-                    target: { type: "item", itemId: "title" },
-                    channel: "style.opacity",
-                    fill: "both",
-                    keyframes: [
-                        { time: 0, value: 0 },
-                        { time: 800, value: 1, easing: "ease-out-cubic" },
-                    ],
-                }],
-        },
-    },
-    "composition:reveal": {
-        id: "reveal",
-        name: "Reveal",
-        timeline: {
-            duration: 600,
-            clips: [{ id: "reveal-title", kind: "text.reveal", kindVersion: 1, target: { type: "item", itemId: "title" }, start: 0, duration: 600, fill: "both", easing: "ease-out-cubic", params: { mode: "words" }, seed: "reveal-title" }],
-        },
-    },
-    "composition:motion-path": {
-        id: "motion",
-        name: "Motion path",
-        timeline: {
-            duration: 1200,
-            clips: [{ id: "move-hero", kind: "motion.path", kindVersion: 1, target: { type: "item", itemId: "hero" }, start: 0, duration: 1200, fill: "both", easing: "ease-in-out-cubic", params: { points: [{ x: 0, y: 0 }, { x: 160, y: -40 }, { x: 320, y: 0 }], orient: true }, seed: "move-hero" }],
-        },
-    },
-    "composition:draw-reveal": {
-        id: "draw-stroke",
-        name: "Draw stroke",
-        timeline: {
-            duration: 900,
-            clips: [{ id: "reveal-stroke", kind: "draw.reveal", kindVersion: 1, target: { type: "item", itemId: "stroke" }, start: 0, duration: 900, easing: "ease-out-cubic", seed: "reveal-stroke" }],
-        },
-    },
-    "composition:trail": {
-        id: "move-with-trail",
-        name: "Move with trail",
-        timeline: {
-            duration: 1200,
-            clips: [
-                { id: "move-hero", kind: "motion.path", kindVersion: 1, target: { type: "item", itemId: "hero" }, start: 0, duration: 1200, easing: "ease-in-out-cubic", fill: "both", params: { points: [{ x: 0, y: 0 }, { x: 320, y: 0 }] }, seed: "move-hero" },
-                { id: "trail-hero", kind: "effects.trail", kindVersion: 1, target: { type: "item", itemId: "hero" }, start: 0, duration: 1200, params: { alpha: 0.48 }, seed: "trail-hero" },
-            ],
-        },
-    },
-    "composition:impact": {
-        id: "impact",
-        name: "Impact",
-        timeline: {
-            duration: 500,
-            clips: [{ id: "impact-ring", kind: "effects.impact", kindVersion: 1, target: { type: "board" }, start: 0, duration: 500, layer: "front", params: { center: { x: 400, y: 300 }, radius: 120 }, seed: "impact-ring" }],
-        },
-    },
-    "composition:flash": {
-        id: "flash",
-        name: "Flash",
-        timeline: {
-            duration: 300,
-            clips: [{ id: "screen-flash", kind: "effects.flash", kindVersion: 1, target: { type: "board" }, start: 0, duration: 300, layer: "screen", params: { alpha: 0.3 }, seed: "screen-flash" }],
-        },
-    },
-    "composition:particles": {
-        id: "celebrate",
-        name: "Celebrate",
-        timeline: {
-            duration: 1000,
-            clips: [{ id: "particles", kind: "effects.particles", kindVersion: 1, target: { type: "board" }, start: 0, duration: 1000, layer: "front", params: { count: 420, bounds: { x: 0, y: 0, width: 800, height: 600 } }, seed: "particles" }],
-        },
-        playback: { endBehavior: "reset" },
-    },
-    "composition:camera-shake": {
-        id: "shake",
-        name: "Camera shake",
-        timeline: {
-            duration: 500,
-            clips: [{ id: "shake-camera", kind: "camera.shake", kindVersion: 1, target: { type: "camera" }, start: 0, duration: 500, layer: "screen", params: { amount: 8, frequency: 28 }, seed: "shake-camera" }],
         },
     },
-    "composition:camera-focus": {
-        id: "tour",
-        name: "Tour",
-        timeline: {
-            duration: 1000,
-            clips: [{
-                    id: "focus-title",
-                    kind: "camera.focus",
-                    kindVersion: 1,
-                    target: { type: "camera" },
-                    start: 0,
-                    duration: 700,
-                    layer: "screen",
-                    fill: "forwards",
-                    easing: "ease-out-cubic",
-                    params: { focus: { type: "item", itemId: "title" }, fit: "contain", padding: 32 },
-                    seed: "focus-title",
-                }],
+    sketch: {
+        description: "A code-drawn item; `src` is a module in the Space exporting draw(ctx, frame).",
+        value: {
+            items: {
+                wave: { type: "sketch", position: { x: 0, y: 0 }, size: { width: 640, height: 360 }, props: { src: "sketches/wave.js", params: { amplitude: 60 } } },
+            },
+            animations: {
+                loop: { duration: 4000, play: "always", tracks: {} },
+            },
         },
     },
 };
-export const BOARD_EXAMPLE_KEYS = Object.keys(templates);
-export function boardExample(kind, type) {
-    const key = type ? `${kind}:${type}` : kind;
-    const template = templates[key];
-    if (!template)
-        throw new Error(`Unknown Board example: ${key}`);
-    return template;
-}
 export function registerBoardExampleCommands(boards) {
-    boards.command("examples [kind] [type]")
-        .description("Print editable semantic JSON templates")
-        .option("--list", "List available examples")
+    boards.command("examples [name]")
+        .description("Print a starter Board document or list the examples")
         .addHelpText("after", `
-Kinds:
-  create [workflow|media|animation]
-  batch basic
-  item text|image|video|audio|file|task|geo|frame|draw|arrow
-  effect pulse|float|deal
-  motion enter-deal
-  composition fade|reveal|draw-reveal|motion-path|trail|impact|flash|particles|camera-shake|camera-focus
-
-Examples:
-  cohub boards examples --list
-  cohub boards examples create workflow > board.json
-  cohub boards examples batch basic > changes.json
-  cohub boards examples item text > item.json
-  cohub boards examples composition fade > intro.json`)
-        .action((kind, type, options) => {
-        if (options.list)
-            return json(BOARD_EXAMPLE_KEYS);
-        if (!kind)
-            throw new Error("Example kind is required. Use --list to see available examples.");
-        json(boardExample(kind, type));
+Examples are valid input for create and apply:
+  cohub boards examples lesson > lesson.json
+  cohub boards create lesson.board -i lesson.json`)
+        .action((name) => {
+        if (!name) {
+            for (const [key, example] of Object.entries(BOARD_EXAMPLES))
+                console.log(`${key.padEnd(10)} ${example.description}`);
+            return;
+        }
+        const example = BOARD_EXAMPLES[name];
+        if (!example)
+            throw new Error(`Unknown example ${name}; expected ${Object.keys(BOARD_EXAMPLES).join(", ")}`);
+        json(example.value);
     });
 }

package/dist/commands/boards.d.ts

@@ -1,17 +1,12 @@
 import type { Command } from "commander";
 import { parseBoardJsonObject } from "../board-command-support.js";
 export declare const parseJsonObject: typeof parseBoardJsonObject;
-export declare function parseViewport(value?: string): {
+export declare function parseRect(value: string, name?: string): {
     x: number;
     y: number;
     width: number;
     height: number;
-} | undefined;
-export declare function showCreated(result: {
-    board: {
-        id: string;
-        title: string;
-        version: number;
-    };
-}, path: string): void;
+};
+/** `frames/%04d.png` → `frames/0012.png`; a sequence needs a `%d` placeholder. */
+export declare function framePath(pattern: string, index: number): string;
 export declare function registerBoards(program: Command): Command;