@anvpx/motion-cli 0.0.0-stage → 0.1.0

package/dist/workflow/still.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "../types.ts";
+export declare const STILLS_DIR = "stills";
+/** The `hyperframes snapshot` argv for one `--at` timestamp; shared by every command that captures a still. */
+export declare const stillSnapshotArgs: (at: string) => readonly string[];
+export declare const stillCommand: Command;

package/dist/workflow/still.js

@@ -0,0 +1,62 @@
+import { join } from "node:path";
+import { textFlag, usageError } from "../args.js";
+import { EXIT } from "../exit-codes.js";
+import { runInProject } from "../tooling/session.js";
+import { parseBuildArgs, prepareProject } from "./project.js";
+const USAGE = `mk still <storyboard.json> (--at 1,5,9 | --review) [--out <dir>] [--assets <dir>] [--ledger <assets.json>]
+
+Build, then capture PNGs with \`hyperframes snapshot\`.
+--at: one PNG per timestamp (seconds) with \`--no-end\`.
+--review: the upstream review set instead (scene starts, middles, cut
+seams plus phone-width beats); use either --at or --review, not both.
+PNGs go to <out>/stills; the paths are printed. Output of hyperframes: <out>/render-log.txt.
+`;
+export const STILLS_DIR = "stills";
+const TIMES = /^\d+(\.\d+)?(,\d+(\.\d+)?)*$/;
+/** The `hyperframes snapshot` argv for one `--at` timestamp; shared by every command that captures a still. */
+export const stillSnapshotArgs = (at) => [
+    "snapshot",
+    ".",
+    "--at",
+    at,
+    "--no-end",
+    "-o",
+    STILLS_DIR,
+];
+async function printStills(dir, io) {
+    const names = await io.host.listDir(dir).catch(() => []);
+    const shots = names.filter((name) => /\.(png|jpg|jpeg)$/.test(name)).sort();
+    if (shots.length === 0) {
+        io.stderr(`mk: no stills were written to ${dir}\n`);
+        return EXIT.ERROR;
+    }
+    io.stdout(shots.map((name) => `${join(dir, name)}\n`).join(""));
+    return EXIT.OK;
+}
+export const stillCommand = {
+    name: "still",
+    summary: "build, then capture PNG stills at --at timestamps or --review the upstream set",
+    async run(args, io) {
+        const parsed = parseBuildArgs("still", USAGE, args, { at: { type: "string" }, review: { type: "boolean" } }, io);
+        if (parsed.kind === "exit")
+            return parsed.code;
+        const at = textFlag(parsed.flags, "at");
+        const review = parsed.flags.review === true;
+        if (review && at !== undefined) {
+            return usageError("still", USAGE, "use either --at or --review, not both", io).code;
+        }
+        if (!review && (at === undefined || !TIMES.test(at))) {
+            return usageError("still", USAGE, "--at needs seconds like 1,5,9", io).code;
+        }
+        const prepared = await prepareProject(parsed.request, io);
+        if (!prepared.ok)
+            return prepared.code;
+        const snapArgs = review
+            ? ["snapshot", ".", "--review", "-o", STILLS_DIR]
+            : stillSnapshotArgs(at);
+        const code = await runInProject(io, prepared.outDir, async (session) => {
+            await session.hf([...snapArgs]);
+        });
+        return code === 0 ? printStills(join(prepared.outDir, STILLS_DIR), io) : code;
+    },
+};

package/dist/workflow/validate.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "../types.ts";
+export declare const validateCommand: Command;

package/dist/workflow/validate.js

@@ -0,0 +1,49 @@
+import { parseFlags, requireStoryboard } from "../args.js";
+import { EXIT } from "../exit-codes.js";
+import { checkStoryboard, rootError } from "../storyboard/check.js";
+import { readCustomScenes } from "../storyboard/custom.js";
+import { readJsonFile } from "../storyboard/load.js";
+import { formatFindings, summaryLine } from "../storyboard/report.js";
+import { platformLookup } from "../verify/platform.js";
+const USAGE = `mk validate <storyboard.json> [--json]
+
+Validate a storyboard: schema, scene props, timing and lint.
+Exit 0 when there are no errors (warnings allowed); 2 on validation errors, bad usage or unreadable files.
+  --json   one JSON document {ok, errors, warnings}
+`;
+const printText = (report, io) => {
+    io.stdout(formatFindings([...report.errors, ...report.warnings]));
+    io.stdout(summaryLine(report.errors.length, report.warnings.length));
+};
+const printJson = (report, io) => {
+    const { errors, warnings } = report;
+    io.stdout(`${JSON.stringify({ ok: errors.length === 0, errors, warnings }, null, 2)}\n`);
+};
+export const validateCommand = {
+    name: "validate",
+    summary: "check a storyboard: schema, scene props, timing, lint",
+    async run(args, io) {
+        const parsed = parseFlags("validate", USAGE, args, { json: { type: "boolean" } }, io);
+        if (parsed.kind === "exit")
+            return parsed.code;
+        const path = requireStoryboard("validate", USAGE, parsed.positionals, io);
+        if (typeof path !== "string")
+            return path.code;
+        const loaded = await readJsonFile(path, io.host);
+        if (!loaded.ok && loaded.kind === "io") {
+            io.stderr(`mk validate: ${loaded.message}\n`);
+            return EXIT.USAGE;
+        }
+        const report = loaded.ok
+            ? checkStoryboard(loaded.value, { platforms: await platformLookup(io.host) })
+            : { errors: [rootError(loaded.message)], warnings: [] };
+        if (loaded.ok && report.errors.length === 0) {
+            const custom = await readCustomScenes(loaded.value, path, io.host);
+            for (const finding of custom.findings) {
+                (finding.severity === "error" ? report.errors : report.warnings).push(finding);
+            }
+        }
+        (parsed.flags.json ? printJson : printText)(report, io);
+        return report.errors.length === 0 ? EXIT.OK : EXIT.USAGE;
+    },
+};

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@anvpx/motion-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "The mk CLI for @anvpx/motion: validate, preview, approve and render storyboards.",
+  "license": "MIT",
+  "author": "anvpx",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "motion-kit",
+    "cli",
+    "video",
+    "storyboard",
+    "animation"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "mk": "./dist/main.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "dependencies": {
+    "@anvpx/motion-audio": "0.1.0",
+    "@anvpx/motion-build": "0.1.0",
+    "@anvpx/motion-schema": "0.1.0",
+    "@anvpx/motion-templates": "0.1.0"
+  },
+  "scripts": {
+    "test:integration": "vitest run --config vitest.integration.config.ts"
+  }
 }