@vosjs/cli 0.13.0 → 0.14.0

package/dist/chunk-NHKHTIDR.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+
+// src/args.ts
+var UsageError = class extends Error {
+};
+function parseArgs(argv, booleanFlags) {
+  const positionals = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--") {
+      positionals.push(...argv.slice(i + 1));
+      break;
+    }
+    if (arg.startsWith("--")) {
+      const eq = arg.indexOf("=");
+      if (eq !== -1) {
+        flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+        continue;
+      }
+      const name = arg.slice(2);
+      if (booleanFlags.has(name)) {
+        flags[name] = true;
+        continue;
+      }
+      const next = argv[i + 1];
+      if (next === void 0 || next.startsWith("--")) {
+        throw new UsageError(`--${name} expects a value`);
+      }
+      flags[name] = next;
+      i++;
+      continue;
+    }
+    positionals.push(arg);
+  }
+  return { positionals, flags };
+}
+function numFlag(flags, name, fallback) {
+  const v = flags[name];
+  if (v === void 0) return fallback;
+  const n = Number(v);
+  if (!Number.isFinite(n))
+    throw new UsageError(`--${name} expects a number, got "${String(v)}"`);
+  return n;
+}
+
+// src/loadConfig.ts
+import { readFile } from "fs/promises";
+import { existsSync, readFileSync, statSync } from "fs";
+import { join } from "path";
+import {
+  CURRENT_CONFIG_VERSION,
+  migrateConfig,
+  vosConfigJsonSchema
+} from "@vosjs/core";
+function directoryKind(target) {
+  try {
+    if (!statSync(target).isDirectory()) return "none";
+  } catch {
+    return "none";
+  }
+  const docPath = join(target, "doc.json");
+  if (existsSync(docPath)) {
+    try {
+      const doc = JSON.parse(readFileSync(docPath, "utf8"));
+      if (typeof doc === "object" && doc !== null && "source" in doc)
+        return "take";
+    } catch {
+      return "take";
+    }
+  }
+  return existsSync(join(target, "config.json")) ? "program" : "none";
+}
+async function loadProgramDirectory(dir, warnings) {
+  const config = JSON.parse(
+    await readFile(join(dir, "config.json"), "utf8")
+  );
+  const docPath = join(dir, "doc.json");
+  if (!existsSync(docPath)) return config;
+  const doc = JSON.parse(await readFile(docPath, "utf8"));
+  if (typeof doc !== "object" || doc === null || "source" in doc) return config;
+  if (typeof config !== "object" || config === null) {
+    throw new UsageError(`${dir}/config.json does not contain a JSON object`);
+  }
+  const raw = doc;
+  const program = raw.program && typeof raw.program === "object" ? raw.program : {};
+  const { lowerProgramDoc } = await import("@vosjs/studio-core");
+  const composed = lowerProgramDoc(
+    { ...raw, program: { ...program, config } },
+    { bake: true }
+  ).config;
+  warnings.push(
+    "composed config.json with doc.json (a program document: its layers and tween edits ride the render)"
+  );
+  return composed;
+}
+async function readSourceText(source) {
+  if (/^https?:\/\//.test(source)) {
+    const res = await fetch(source);
+    if (!res.ok) throw new Error(`fetch ${source} \u2192 ${res.status}`);
+    return await res.text();
+  }
+  let isDir = false;
+  try {
+    isDir = statSync(source).isDirectory();
+  } catch {
+  }
+  if (isDir) {
+    throw new UsageError(
+      `${source} is a directory with no config.json and no doc.json \u2014 pass a config file, a URL, a program directory or a take`
+    );
+  }
+  return await readFile(source, "utf8");
+}
+async function loadVosConfig(source) {
+  const warnings = [];
+  let parsed;
+  const kind = /^https?:\/\//.test(source) ? "none" : directoryKind(source);
+  if (kind === "take") {
+    throw new UsageError(
+      `${source} is a take (its doc.json is a recording document). Render it through the take pipeline: vos render ${source} [out]; vos frames ${source} for stills.`
+    );
+  }
+  if (kind === "program") {
+    parsed = await loadProgramDirectory(source, warnings);
+    return finish(source, parsed, warnings);
+  }
+  const raw = await readSourceText(source);
+  try {
+    parsed = JSON.parse(raw);
+  } catch (e) {
+    throw new UsageError(`${source} is not valid JSON: ${e.message}`);
+  }
+  return finish(source, parsed, warnings);
+}
+function finish(source, parsed, warnings) {
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new UsageError(`${source} does not contain a JSON object`);
+  }
+  let obj = parsed;
+  if (typeof obj.config === "object" && obj.config !== null && !("createTimeline" in obj)) {
+    obj = obj.config;
+    warnings.push("unwrapped { config } envelope");
+  }
+  const version = obj.version;
+  const migrated = migrateConfig(obj);
+  if (version === void 0) {
+    warnings.push(
+      `config declares no "version". Add "version": ${CURRENT_CONFIG_VERSION} before pushing it.`
+    );
+  } else if (version !== CURRENT_CONFIG_VERSION) {
+    warnings.push(
+      `migrated config v${String(version)} to v${CURRENT_CONFIG_VERSION}`
+    );
+  }
+  const check = vosConfigJsonSchema.safeParse(migrated);
+  if (!check.success) {
+    const issues = check.error.issues.slice(0, 5).map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`).join("\n");
+    throw new UsageError(`invalid vos config:
+${issues}`);
+  }
+  return { config: migrated, warnings };
+}
+function configDuration(config) {
+  const d = config.duration;
+  return typeof d === "number" && Number.isFinite(d) && d > 0 ? d : void 0;
+}
+
+// src/browser.ts
+import { chromium } from "playwright";
+var BrowserUnavailableError = class extends Error {
+  constructor(cause) {
+    super(
+      `Could not launch a Chromium-family browser (${cause}).
+Fixes, in order of preference:
+  1. Install Google Chrome (used automatically), or
+  2. npx playwright install chromium, or
+  3. Set VOS_BROWSER_PATH to a Chrome/Chromium executable.`
+    );
+  }
+};
+async function launchBrowser() {
+  const explicit = process.env.VOS_BROWSER_PATH;
+  if (explicit) {
+    return chromium.launch({ executablePath: explicit }).catch((e) => {
+      throw new BrowserUnavailableError(
+        `VOS_BROWSER_PATH failed: ${e.message}`
+      );
+    });
+  }
+  try {
+    return await chromium.launch({ channel: "chrome" });
+  } catch {
+    try {
+      return await chromium.launch();
+    } catch (e) {
+      throw new BrowserUnavailableError(
+        e.message.split("\n")[0] ?? "unknown"
+      );
+    }
+  }
+}
+
+export {
+  UsageError,
+  parseArgs,
+  numFlag,
+  directoryKind,
+  loadProgramDirectory,
+  readSourceText,
+  loadVosConfig,
+  configDuration,
+  BrowserUnavailableError,
+  launchBrowser
+};
+//# sourceMappingURL=chunk-NHKHTIDR.js.map

package/dist/chunk-NHKHTIDR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/args.ts","../src/loadConfig.ts","../src/browser.ts"],"sourcesContent":["/**\n * Minimal argv parser — positionals + `--flag value` / `--flag=value` /\n * boolean flags. Deliberately tiny: the CLI has a small, stable surface and\n * agents benefit from predictable, dependency-free parsing.\n */\nexport interface ParsedArgs {\n  positionals: string[]\n  flags: Record<string, string | true>\n}\n\nexport class UsageError extends Error {}\n\nexport function parseArgs(\n  argv: string[],\n  booleanFlags: ReadonlySet<string>,\n): ParsedArgs {\n  const positionals: string[] = []\n  const flags: Record<string, string | true> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === '--') {\n      positionals.push(...argv.slice(i + 1))\n      break\n    }\n    if (arg.startsWith('--')) {\n      const eq = arg.indexOf('=')\n      if (eq !== -1) {\n        flags[arg.slice(2, eq)] = arg.slice(eq + 1)\n        continue\n      }\n      const name = arg.slice(2)\n      if (booleanFlags.has(name)) {\n        flags[name] = true\n        continue\n      }\n      const next = argv[i + 1]\n      if (next === undefined || next.startsWith('--')) {\n        throw new UsageError(`--${name} expects a value`)\n      }\n      flags[name] = next\n      i++\n      continue\n    }\n    positionals.push(arg)\n  }\n  return { positionals, flags }\n}\n\nexport function numFlag(\n  flags: ParsedArgs['flags'],\n  name: string,\n  fallback: number,\n): number {\n  const v = flags[name]\n  if (v === undefined) return fallback\n  const n = Number(v)\n  if (!Number.isFinite(n))\n    throw new UsageError(`--${name} expects a number, got \"${String(v)}\"`)\n  return n\n}\n","import { readFile } from 'node:fs/promises'\nimport { existsSync, readFileSync, statSync } from 'node:fs'\nimport { join } from 'node:path'\nimport {\n  CURRENT_CONFIG_VERSION,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport { UsageError } from './args'\n\nexport interface LoadedConfig {\n  config: Record<string, unknown>\n  warnings: string[]\n}\n\n/**\n * What a directory holds, by one deterministic sniff and never a flag:\n * a TAKE carries a recording document (`doc.json` with `source`); a PROGRAM\n * directory carries `config.json`, optionally beside a program document\n * (`doc.json` without `source`: the shared layers, the tween overlay, the\n * program's own length, with `program.config` omitted on disk). An unparsable\n * doc.json counts as a take so the take path reports the real error.\n */\nexport type DirectoryKind = 'take' | 'program' | 'none'\n\nexport function directoryKind(target: string): DirectoryKind {\n  try {\n    if (!statSync(target).isDirectory()) return 'none'\n  } catch {\n    return 'none'\n  }\n  const docPath = join(target, 'doc.json')\n  if (existsSync(docPath)) {\n    try {\n      const doc: unknown = JSON.parse(readFileSync(docPath, 'utf8'))\n      if (typeof doc === 'object' && doc !== null && 'source' in doc)\n        return 'take'\n    } catch {\n      return 'take'\n    }\n  }\n  return existsSync(join(target, 'config.json')) ? 'program' : 'none'\n}\n\n/**\n * A program directory's config: `config.json`, composed with the program\n * document beside it when there is one (the layers ride as the studio stack\n * entry, the tween overlay is baked into `createTimeline`), so a render of\n * the directory is a render of what the studio and vos.so play.\n */\nexport async function loadProgramDirectory(\n  dir: string,\n  warnings: string[],\n): Promise<unknown> {\n  const config: unknown = JSON.parse(\n    await readFile(join(dir, 'config.json'), 'utf8'),\n  )\n  const docPath = join(dir, 'doc.json')\n  if (!existsSync(docPath)) return config\n  const doc: unknown = JSON.parse(await readFile(docPath, 'utf8'))\n  if (typeof doc !== 'object' || doc === null || 'source' in doc) return config\n  if (typeof config !== 'object' || config === null) {\n    throw new UsageError(`${dir}/config.json does not contain a JSON object`)\n  }\n  const raw = doc as Record<string, unknown>\n  const program =\n    raw.program && typeof raw.program === 'object'\n      ? (raw.program as Record<string, unknown>)\n      : {}\n  const { lowerProgramDoc } = await import('@vosjs/studio-core')\n  const composed = lowerProgramDoc(\n    { ...raw, program: { ...program, config } } as never,\n    { bake: true },\n  ).config\n  warnings.push(\n    'composed config.json with doc.json (a program document: its layers and tween edits ride the render)',\n  )\n  return composed\n}\n\n/**\n * The text of a config source: an http(s) URL or a file. A directory that is\n * neither a take nor a program directory is refused in words, since the raw\n * read would report a bare EISDIR.\n */\nexport async function readSourceText(source: string): Promise<string> {\n  if (/^https?:\\/\\//.test(source)) {\n    const res = await fetch(source)\n    if (!res.ok) throw new Error(`fetch ${source} → ${res.status}`)\n    return await res.text()\n  }\n  let isDir = false\n  try {\n    isDir = statSync(source).isDirectory()\n  } catch {\n    /* a missing path reads below and reports itself */\n  }\n  if (isDir) {\n    throw new UsageError(\n      `${source} is a directory with no config.json and no doc.json — pass a config file, a URL, a program directory or a take`,\n    )\n  }\n  return await readFile(source, 'utf8')\n}\n\n/**\n * Load a VosConfigJson from a file path, an http(s) URL, or a program\n * directory (config.json, composed with a program document when one sits\n * beside it); unwrap API `{ config }` envelopes, migrate old versions, and\n * validate against the schema. A take directory is refused here in words:\n * takes render through the take pipeline (`vos render <take>`).\n */\nexport async function loadVosConfig(source: string): Promise<LoadedConfig> {\n  const warnings: string[] = []\n  let parsed: unknown\n  const kind = /^https?:\\/\\//.test(source) ? 'none' : directoryKind(source)\n  if (kind === 'take') {\n    throw new UsageError(\n      `${source} is a take (its doc.json is a recording document). Render it through the take pipeline: vos render ${source} [out]; vos frames ${source} for stills.`,\n    )\n  }\n  if (kind === 'program') {\n    parsed = await loadProgramDirectory(source, warnings)\n    return finish(source, parsed, warnings)\n  }\n  const raw = await readSourceText(source)\n\n  try {\n    parsed = JSON.parse(raw)\n  } catch (e) {\n    throw new UsageError(`${source} is not valid JSON: ${(e as Error).message}`)\n  }\n  return finish(source, parsed, warnings)\n}\n\nfunction finish(\n  source: string,\n  parsed: unknown,\n  warnings: string[],\n): LoadedConfig {\n  if (typeof parsed !== 'object' || parsed === null) {\n    throw new UsageError(`${source} does not contain a JSON object`)\n  }\n\n  // API endpoints wrap the config: { config: {...} }.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n    warnings.push('unwrapped { config } envelope')\n  }\n\n  const version = obj.version\n  const migrated = migrateConfig(obj)\n  if (version === undefined) {\n    // Plays fine (the stamp happens above), but a storer refuses it.\n    warnings.push(\n      `config declares no \"version\". Add \"version\": ${CURRENT_CONFIG_VERSION} before pushing it.`,\n    )\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    warnings.push(\n      `migrated config v${String(version)} to v${CURRENT_CONFIG_VERSION}`,\n    )\n  }\n\n  const check = vosConfigJsonSchema.safeParse(migrated)\n  if (!check.success) {\n    const issues = check.error.issues\n      .slice(0, 5)\n      .map((i) => `  ${i.path.join('.') || '(root)'}: ${i.message}`)\n      .join('\\n')\n    throw new UsageError(`invalid vos config:\\n${issues}`)\n  }\n\n  return { config: migrated, warnings }\n}\n\n/** Best-effort duration from the config (seconds). */\nexport function configDuration(\n  config: Record<string, unknown>,\n): number | undefined {\n  const d = config.duration\n  return typeof d === 'number' && Number.isFinite(d) && d > 0 ? d : undefined\n}\n","import { chromium } from 'playwright'\nimport type { Browser } from 'playwright'\n\nexport class BrowserUnavailableError extends Error {\n  constructor(cause: string) {\n    super(\n      `Could not launch a Chromium-family browser (${cause}).\\n` +\n        `Fixes, in order of preference:\\n` +\n        `  1. Install Google Chrome (used automatically), or\\n` +\n        `  2. npx playwright install chromium, or\\n` +\n        `  3. Set VOS_BROWSER_PATH to a Chrome/Chromium executable.`,\n    )\n  }\n}\n\n/**\n * Launch headless Chromium: explicit VOS_BROWSER_PATH → system Chrome\n * (no download needed) → Playwright's bundled Chromium.\n */\nexport async function launchBrowser(): Promise<Browser> {\n  const explicit = process.env.VOS_BROWSER_PATH\n  if (explicit) {\n    return chromium.launch({ executablePath: explicit }).catch((e) => {\n      throw new BrowserUnavailableError(\n        `VOS_BROWSER_PATH failed: ${(e as Error).message}`,\n      )\n    })\n  }\n  try {\n    return await chromium.launch({ channel: 'chrome' })\n  } catch {\n    try {\n      return await chromium.launch()\n    } catch (e) {\n      throw new BrowserUnavailableError(\n        (e as Error).message.split('\\n')[0] ?? 'unknown',\n      )\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -1,22 +1,25 @@
 #!/usr/bin/env node
 import {
-  UsageError,
-  configDuration,
-  loadVosConfig,
-  numFlag,
-  parseArgs,
   previewPages,
   renderStill,
   renderVideo
-} from "./chunk-X2BKHZ56.js";
+} from "./chunk-GCWE75OA.js";
 import {
   BrowserUnavailableError,
-  launchBrowser
-} from "./chunk-A2VSDK3C.js";
+  UsageError,
+  configDuration,
+  directoryKind,
+  launchBrowser,
+  loadProgramDirectory,
+  loadVosConfig,
+  numFlag,
+  parseArgs,
+  readSourceText
+} from "./chunk-NHKHTIDR.js";
 
 // src/cli.ts
-import { readFile, writeFile } from "fs/promises";
-import { existsSync, readFileSync } from "fs";
+import { writeFile } from "fs/promises";
+import { readFileSync } from "fs";
 import { basename, dirname, join } from "path";
 import { createServer } from "http";
 import { createRequire } from "module";
@@ -212,7 +215,7 @@ function outName(source, ext) {
 }
 async function cmdRender(argv) {
   const first = argv.find((a) => !a.startsWith("-"));
-  if (first && existsSync(join(first, "doc.json"))) {
+  if (first && directoryKind(first) === "take") {
     return delegate(["render", ...argv]);
   }
   const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS);
@@ -431,18 +434,26 @@ async function cmdCheck(argv) {
   const source = positionals[0];
   if (!source) throw new UsageError("vos check <config.json>");
   const r = createReporter(flags.json === true);
-  let raw;
-  if (/^https?:\/\//.test(source)) {
-    const res = await fetch(source);
-    if (!res.ok) throw new Error(`fetch ${source} \u2192 ${res.status}`);
-    raw = await res.text();
-  } else {
-    raw = await readFile(source, "utf8");
+  const kind = /^https?:\/\//.test(source) ? "none" : directoryKind(source);
+  if (kind === "take") {
+    throw new UsageError(
+      `${source} is a take (its doc.json is a recording document). vos validate ${source} lints it; vos render ${source} renders it.`
+    );
   }
+  let raw;
   let parsed;
   try {
-    parsed = JSON.parse(raw);
+    if (kind === "program") {
+      const notes = [];
+      parsed = await loadProgramDirectory(source, notes);
+      for (const n of notes) r.log(`note: ${n}`);
+      raw = "";
+    } else {
+      raw = await readSourceText(source);
+      parsed = JSON.parse(raw);
+    }
   } catch (e) {
+    if (!(e instanceof SyntaxError)) throw e;
     parsed = void 0;
     if (!r.json) process.stdout.write(`error [json] ${e.message}
 `);
@@ -484,7 +495,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-VU6B3CXC.js");
+  const { run } = await import("./run-R5P44XNR.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".
@@ -495,7 +506,7 @@ async function delegate(argv, viaAlias = false) {
 }
 async function printHelp() {
   process.stdout.write(HELP_ENGINE);
-  const { manifest } = await import("./manifest-3LIL5M3F.js");
+  const { manifest } = await import("./manifest-UCS6OVWZ.js");
   process.stdout.write("\nTake pipeline + vos.so verbs\n");
   for (const v of manifest.verbs) {
     if (v.name === "render") continue;

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/output.ts","../src/check.ts"],"sourcesContent":["import { readFile, writeFile } from 'node:fs/promises'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { basename, dirname, join } from 'node:path'\nimport { createServer } from 'node:http'\nimport { createRequire } from 'node:module'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs, numFlag, UsageError } from './args'\nimport {\n  createReporter,\n  EXIT_ERROR,\n  EXIT_NO_BROWSER,\n  EXIT_OK,\n  EXIT_USAGE,\n} from './output'\nimport { loadVosConfig, configDuration } from './loadConfig'\nimport { launchBrowser, BrowserUnavailableError } from './browser'\nimport { renderVideo, renderStill, previewPages } from './render'\nimport { runCheck } from './check'\n\nconst BOOLEAN_FLAGS = new Set(['json', 'help', 'version'])\n\nconst HELP_ENGINE = `vos — command line for the vos programmatic video engine (https://vos.so/engine)\n\nEngine verbs (local, no account, no network beyond the render page's CDN deps)\n  vos render <config.json|url|take> [out] [--width 1920] [--height 1080] [--fps 30]\n                               [--duration <s>] [--format webm|mp4] [--json]\n  vos still  <config.json|url> [out.webp] [--time 0] [--width] [--height] [--json]\n  vos info   <config.json|url> [--json]\n  vos check  <config.json|url> [--json]\n             migrate → schema → syntax → compile → determinism/dialect lints, all local\n  vos preview <config.json|url> [--port 0]\n  vos versions [--json]\n`\n\nconst HELP_CONVENTIONS = `\nConventions\n  Results go to stdout; logs go to stderr. --json switches stdout to NDJSON\n  events ending with {\"event\":\"done\",…}. Exit codes: 0 ok, 1 error, 2 usage,\n  3 no browser available.\n`\n\nfunction outName(source: string, ext: string): string {\n  const base = basename(source).replace(/\\.[a-z0-9]+$/i, '') || 'vos'\n  return `${base}.${ext}`\n}\n\nasync function cmdRender(argv: string[]): Promise<number> {\n  // Polymorphic render: a take DIRECTORY (detected by its doc.json — the take\n  // pipeline's editable document) renders through the plugin; anything else\n  // is an engine config render. A deterministic sniff, never a flag.\n  const first = argv.find((a) => !a.startsWith('-'))\n  if (first && existsSync(join(first, 'doc.json'))) {\n    return delegate(['render', ...argv])\n  }\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos render <config.json|url|take> [out]')\n  const r = createReporter(flags.json === true)\n  const format = (flags.format as string) ?? 'webm'\n  if (format !== 'webm' && format !== 'mp4')\n    throw new UsageError('--format must be webm or mp4')\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const duration = numFlag(flags, 'duration', configDuration(config) ?? 5)\n  const width = numFlag(flags, 'width', 1920)\n  const height = numFlag(flags, 'height', 1080)\n  const fps = numFlag(flags, 'fps', 30)\n  const out = positionals[1] ?? outName(source, format)\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderVideo(browser, {\n      config,\n      width,\n      height,\n      fps,\n      duration,\n      format,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      { out, bytes: result.bytes.length, width, height, fps, duration, format },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height}@${fps}, ${duration}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdStill(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos still <config.json|url> [out.webp]')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const time = numFlag(flags, 'time', 0)\n  const width = numFlag(flags, 'width', 1280)\n  const height = numFlag(flags, 'height', 720)\n  const out = positionals[1] ?? outName(source, 'webp')\n  // The capture template encodes WebP; a .png/.jpg name would ship WebP\n  // bytes under a lying extension (stores refuse a mislabelled image), so\n  // refuse in words instead of writing it.\n  if (/\\.(png|jpe?g)$/i.test(out))\n    throw new UsageError(\n      `vos still writes WebP (the engine's capture format): name the output .webp, or convert afterwards (ffmpeg -i out.webp out.png)`,\n    )\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderStill(browser, {\n      config,\n      width,\n      height,\n      time,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      {\n        out,\n        bytes: result.bytes.length,\n        width,\n        height,\n        time,\n        mimeType: result.mimeType,\n      },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height} @ t=${time}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdInfo(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos info <config.json|url>')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  const elements = Array.isArray(config.elements) ? config.elements.length : 0\n  const data =\n    typeof config.data === 'object' && config.data !== null\n      ? Object.keys(config.data)\n      : []\n  const fns = ['setup', 'createContent', 'createTimeline', 'onFrame'].filter(\n    (k) => typeof config[k] === 'string',\n  )\n  const info = {\n    version: config.version,\n    duration: configDuration(config) ?? null,\n    camera:\n      (config.camera as Record<string, unknown> | undefined)?.preset ?? null,\n    elements,\n    dataKeys: data,\n    functions: fns,\n    warnings,\n  }\n  if (r.json) r.done(info, '')\n  else {\n    for (const w of warnings) r.log(`note: ${w}`)\n    process.stdout.write(\n      `version:   v${String(info.version)}\\n` +\n        `duration:  ${info.duration === null ? '(none)' : `${info.duration}s`}\\n` +\n        `camera:    ${String(info.camera ?? '(default)')}\\n` +\n        `elements:  ${elements}\\n` +\n        `data keys: ${data.length ? data.join(', ') : '(none)'}\\n` +\n        `functions: ${fns.join(', ')}\\n`,\n    )\n  }\n  return EXIT_OK\n}\n\nfunction packageVersion(name: string): string | null {\n  const require = createRequire(import.meta.url)\n  // Fast path — packages that export ./package.json (e.g. playwright).\n  try {\n    return (require(`${name}/package.json`) as { version: string }).version\n  } catch {\n    // Strict `exports` maps (the @vosjs packages) hide package.json — resolve\n    // the entry module instead and walk up to the owning package.json.\n  }\n  let entry: string | null = null\n  try {\n    entry = fileURLToPath(import.meta.resolve(name))\n  } catch {\n    try {\n      entry = require.resolve(name)\n    } catch {\n      return null\n    }\n  }\n  let dir = dirname(entry)\n  for (let i = 0; i < 6; i++) {\n    try {\n      const pkg = JSON.parse(\n        readFileSync(join(dir, 'package.json'), 'utf8'),\n      ) as {\n        name?: string\n        version?: string\n      }\n      if (pkg.name === name && pkg.version) return pkg.version\n    } catch {\n      // keep walking\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n  return null\n}\n\nfunction ownVersion(): string {\n  try {\n    const own = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL('../package.json', import.meta.url)),\n        'utf8',\n      ),\n    ) as { version: string }\n    return own.version\n  } catch {\n    return '(unknown)'\n  }\n}\n\nasync function cmdVersions(argv: string[]): Promise<number> {\n  const { flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const r = createReporter(flags.json === true)\n  const versions: Record<string, string> = {}\n  versions['@vosjs/cli'] = ownVersion()\n  for (const name of [\n    '@vosjs/core',\n    '@vosjs/elements',\n    '@vosjs/tween',\n    '@vosjs/editor',\n    '@vosjs/timeline',\n    '@vosjs/studio-core',\n    '@vosjs/render-core',\n    '@vosjs/shared',\n    'mediabunny',\n    'playwright',\n  ]) {\n    versions[name] = packageVersion(name) ?? '(not found)'\n  }\n  if (r.json) r.done({ versions }, '')\n  else\n    for (const [k, v] of Object.entries(versions))\n      process.stdout.write(`${k} ${v}\\n`)\n  return EXIT_OK\n}\n\nasync function cmdPreview(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos preview <config.json|url> [--port 0]')\n  const r = createReporter(false)\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const { hostHtml, playerHtml } = previewPages(config)\n  const server = createServer((req, res) => {\n    const path = new URL(req.url ?? '/', 'http://x').pathname\n    res.writeHead(200, { 'content-type': 'text/html' })\n    res.end(path === '/player' ? playerHtml : hostHtml)\n  })\n  const port = numFlag(flags, 'port', 0)\n  await new Promise<void>((resolve) => server.listen(port, resolve))\n  const addr = server.address()\n  const url = `http://localhost:${typeof addr === 'object' && addr ? addr.port : port}/`\n  process.stdout.write(`${url}\\n`)\n  r.log('Serving playback preview — Ctrl-C to stop.')\n  await new Promise(() => {}) // keep alive until interrupted\n  return EXIT_OK\n}\n\nasync function cmdCheck(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos check <config.json>')\n  const r = createReporter(flags.json === true)\n\n  let raw: string\n  if (/^https?:\\/\\//.test(source)) {\n    const res = await fetch(source)\n    if (!res.ok) throw new Error(`fetch ${source} → ${res.status}`)\n    raw = await res.text()\n  } else {\n    raw = await readFile(source, 'utf8')\n  }\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(raw)\n  } catch (e) {\n    parsed = undefined\n    if (!r.json) process.stdout.write(`error [json] ${(e as Error).message}\\n`)\n    r.done(\n      {\n        ok: false,\n        errors: 1,\n        warnings: 0,\n        issues: [\n          { level: 'error', source: 'json', message: (e as Error).message },\n        ],\n      },\n      `${source}: 1 error`,\n    )\n    return EXIT_ERROR\n  }\n\n  const result = runCheck(parsed)\n  if (r.json) {\n    r.done(\n      {\n        ok: result.ok,\n        errors: result.errors,\n        warnings: result.warnings,\n        issues: result.issues,\n      },\n      '',\n    )\n  } else {\n    for (const i of result.issues) {\n      process.stdout.write(`${i.level} [${i.source}] ${i.message}\\n`)\n    }\n    process.stdout.write(\n      result.ok\n        ? `${source}: ok (${result.warnings} warning${result.warnings === 1 ? '' : 's'})\\n`\n        : `${source}: ${result.errors} error${result.errors === 1 ? '' : 's'}, ${result.warnings} warning${result.warnings === 1 ? '' : 's'}\\n`,\n    )\n  }\n  return result.ok ? EXIT_OK : EXIT_ERROR\n}\n\n// ---------------------------------------------------------------------------\n// Every verb this file does not own is a take-pipeline or vos.so verb from\n// `./plugin` (what used to ship separately as @vosso/vos-plugin). It loads on\n// demand, so the engine verbs never pay for the recorder's imports, and the\n// old names (`@vosso/cli`, `@vosso/voila-cli`, the `vos voila` alias) keep\n// resolving here for scripts that still use them.\n// ---------------------------------------------------------------------------\n\nasync function delegate(argv: string[], viaAlias = false): Promise<number> {\n  const { run } = await import('./plugin/run')\n  if (viaAlias && argv[0]) {\n    process.stderr.write(\n      `note: \"vos voila ${argv[0]}\" is now \"vos ${argv[0]}\".\\n`,\n    )\n  }\n  return await run(argv)\n}\n\nasync function printHelp(): Promise<void> {\n  process.stdout.write(HELP_ENGINE)\n  const { manifest } = await import('./plugin/manifest')\n  process.stdout.write('\\nTake pipeline + vos.so verbs\\n')\n  for (const v of manifest.verbs) {\n    if (v.name === 'render') continue // polymorphic — already listed above\n    process.stdout.write(`  vos ${v.name.padEnd(8)} ${v.summary}\\n`)\n  }\n  process.stdout.write(HELP_CONVENTIONS)\n}\n\nconst ENGINE_VERBS = new Set([\n  'render',\n  'still',\n  'info',\n  'versions',\n  'preview',\n  'check',\n])\n\nasync function main(): Promise<number> {\n  const [cmd, ...rest] = process.argv.slice(2)\n  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {\n    await printHelp()\n    return cmd ? EXIT_OK : EXIT_USAGE\n  }\n  if (cmd === '--version') return cmdVersions(['--json'])\n  if (!ENGINE_VERBS.has(cmd) && cmd !== 'voila') return delegate([cmd, ...rest])\n  switch (cmd) {\n    case 'render':\n      return cmdRender(rest)\n    case 'still':\n      return cmdStill(rest)\n    case 'info':\n      return cmdInfo(rest)\n    case 'versions':\n      return cmdVersions(rest)\n    case 'preview':\n      return cmdPreview(rest)\n    case 'check':\n      return cmdCheck(rest)\n    // Hidden alias for existing scripts; not in HELP. Same code path as the\n    // promoted verbs, plus a one-line pointer at the new spelling.\n    case 'voila':\n      return delegate(rest, true)\n    default:\n      throw new UsageError(`unknown command \"${cmd}\" — run vos help`)\n  }\n}\n\nmain()\n  .then((code) => process.exit(code))\n  .catch((e) => {\n    if (e instanceof UsageError) {\n      process.stderr.write(`usage error: ${e.message}\\n`)\n      process.exit(EXIT_USAGE)\n    }\n    if (e instanceof BrowserUnavailableError) {\n      process.stderr.write(`${e.message}\\n`)\n      process.exit(EXIT_NO_BROWSER)\n    }\n    process.stderr.write(\n      `error: ${e instanceof Error ? e.message : String(e)}\\n`,\n    )\n    process.exit(EXIT_ERROR)\n  })\n","/**\n * Output conventions (agent-safe by construction):\n * - logs/progress → stderr (human readable)\n * - results → stdout; with --json, NDJSON events (`{\"event\":\"phase\"...}` then\n *   `{\"event\":\"done\"...}`) so scripts and agents never parse prose\n * - exit codes: 0 ok · 1 failure · 2 usage · 3 browser unavailable\n */\nexport const EXIT_OK = 0\nexport const EXIT_ERROR = 1\nexport const EXIT_USAGE = 2\nexport const EXIT_NO_BROWSER = 3\n\nexport interface Reporter {\n  json: boolean\n  /** Human log line (stderr; suppressed in --json mode). */\n  log: (msg: string) => void\n  /** Machine event (stdout NDJSON in --json mode; no-op otherwise). */\n  event: (obj: Record<string, unknown>) => void\n  /** Final result: NDJSON `done` event in --json mode, plain line otherwise. */\n  done: (obj: Record<string, unknown>, humanLine: string) => void\n}\n\nexport function createReporter(json: boolean): Reporter {\n  return {\n    json,\n    log: (msg) => {\n      if (!json) process.stderr.write(`${msg}\\n`)\n    },\n    event: (obj) => {\n      if (json) process.stdout.write(`${JSON.stringify(obj)}\\n`)\n    },\n    done: (obj, humanLine) => {\n      if (json)\n        process.stdout.write(`${JSON.stringify({ event: 'done', ...obj })}\\n`)\n      else process.stdout.write(`${humanLine}\\n`)\n    },\n  }\n}\n","/**\n * `vos check` — the local validation pipeline, pure so it can be unit-tested:\n * envelope unwrap → migrate → schema → compile → determinism + dialect lints.\n * Everything runs locally (no network, no browser). The platform runs the\n * same compiler server-side, so a clean check is a push that will compile.\n */\nimport {\n  CURRENT_CONFIG_VERSION,\n  compileVosConfig,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport { lintVosConfig, lintVosDialect, lintVosFonts } from '@vosjs/core/lint'\n\nexport interface CheckIssue {\n  level: 'error' | 'warn'\n  source:\n    | 'schema'\n    | 'syntax'\n    | 'compile'\n    | 'determinism'\n    | 'dialect'\n    | 'shape'\n    | 'fonts'\n  message: string\n}\n\nexport interface CheckResult {\n  ok: boolean\n  errors: number\n  warnings: number\n  issues: CheckIssue[]\n  /** The migrated config (params/presets untouched) — what a push should send. */\n  config: Record<string, unknown> | null\n}\n\n// Top-level keys the schema does not know but the platform preserves on push.\nconst PLATFORM_EXTRA_KEYS = new Set(['params', 'presets'])\n\nexport function runCheck(parsed: unknown): CheckResult {\n  const issues: CheckIssue[] = []\n  const finish = (config: Record<string, unknown> | null): CheckResult => {\n    const errors = issues.filter((i) => i.level === 'error').length\n    return {\n      ok: errors === 0,\n      errors,\n      warnings: issues.length - errors,\n      issues,\n      config,\n    }\n  }\n\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: 'not a JSON object',\n    })\n    return finish(null)\n  }\n\n  // API endpoints wrap the config: { config: {...} } — accept both shapes.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n  }\n\n  const version = obj.version\n  let migrated: Record<string, unknown>\n  try {\n    migrated = migrateConfig(obj) as Record<string, unknown>\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: `migration failed: ${e instanceof Error ? e.message : String(e)}`,\n    })\n    return finish(null)\n  }\n  if (version === undefined) {\n    // It compiles (the engine reads an absent version as the current one),\n    // but a push is refused: a stored config must say which schema era it was\n    // written against, and nobody can tell that from the file later.\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config declares no \"version\". It plays here, but a push is refused without one. Add \"version\": ${CURRENT_CONFIG_VERSION}.`,\n    })\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config is v${String(version)}, migrated to v${CURRENT_CONFIG_VERSION}. Save the migrated form.`,\n    })\n  }\n\n  const schema = vosConfigJsonSchema.safeParse(migrated)\n  if (!schema.success) {\n    for (const i of schema.error.issues.slice(0, 10)) {\n      issues.push({\n        level: 'error',\n        source: 'schema',\n        message: `${i.path.join('.') || '(root)'}: ${i.message}`,\n      })\n    }\n    return finish(null)\n  }\n\n  // Keys the platform's schema will silently drop on push (params/presets\n  // excepted — those are re-attached by contract).\n  const known = new Set([\n    ...Object.keys(vosConfigJsonSchema.shape),\n    ...PLATFORM_EXTRA_KEYS,\n  ])\n  for (const key of Object.keys(migrated)) {\n    if (!known.has(key)) {\n      issues.push({\n        level: 'warn',\n        source: 'shape',\n        message: `unknown top-level key \"${key}\" — the platform drops it on push`,\n      })\n    }\n  }\n\n  // Function strings are pasted into the template as text, so the compiler\n  // cannot see a syntax error — parse each one here (construction only,\n  // nothing executes).\n  let syntaxErrors = 0\n  for (const key of [\n    'setup',\n    'createContent',\n    'createTimeline',\n    'onFrame',\n  ] as const) {\n    const src = migrated[key]\n    if (typeof src !== 'string' || !src.length) continue\n    try {\n      new Function(`\"use strict\"; return (${src}\\n)`)\n    } catch (e) {\n      syntaxErrors++\n      issues.push({\n        level: 'error',\n        source: 'syntax',\n        message: `${key}: ${e instanceof Error ? e.message : String(e)}`,\n      })\n    }\n  }\n  if (syntaxErrors) return finish(migrated)\n\n  try {\n    // Same options as `vos render` — a clean check is a config the CLI's own\n    // render path will accept.\n    compileVosConfig(migrated as never, { tweenEngine: 'vos' })\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'compile',\n      message: e instanceof Error ? e.message : String(e),\n    })\n    return finish(migrated)\n  }\n\n  for (const i of lintVosConfig(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'determinism',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosDialect(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'dialect',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosFonts(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'fonts',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n\n  return finish(migrated)\n}\n"],"mappings":"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","names":["require"]}
+{"version":3,"sources":["../src/cli.ts","../src/output.ts","../src/check.ts"],"sourcesContent":["import { writeFile } from 'node:fs/promises'\nimport { readFileSync } from 'node:fs'\nimport { basename, dirname, join } from 'node:path'\nimport { createServer } from 'node:http'\nimport { createRequire } from 'node:module'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs, numFlag, UsageError } from './args'\nimport {\n  createReporter,\n  EXIT_ERROR,\n  EXIT_NO_BROWSER,\n  EXIT_OK,\n  EXIT_USAGE,\n} from './output'\nimport {\n  loadVosConfig,\n  configDuration,\n  directoryKind,\n  loadProgramDirectory,\n  readSourceText,\n} from './loadConfig'\nimport { launchBrowser, BrowserUnavailableError } from './browser'\nimport { renderVideo, renderStill, previewPages } from './render'\nimport { runCheck } from './check'\n\nconst BOOLEAN_FLAGS = new Set(['json', 'help', 'version'])\n\nconst HELP_ENGINE = `vos — command line for the vos programmatic video engine (https://vos.so/engine)\n\nEngine verbs (local, no account, no network beyond the render page's CDN deps)\n  vos render <config.json|url|take> [out] [--width 1920] [--height 1080] [--fps 30]\n                               [--duration <s>] [--format webm|mp4] [--json]\n  vos still  <config.json|url> [out.webp] [--time 0] [--width] [--height] [--json]\n  vos info   <config.json|url> [--json]\n  vos check  <config.json|url> [--json]\n             migrate → schema → syntax → compile → determinism/dialect lints, all local\n  vos preview <config.json|url> [--port 0]\n  vos versions [--json]\n`\n\nconst HELP_CONVENTIONS = `\nConventions\n  Results go to stdout; logs go to stderr. --json switches stdout to NDJSON\n  events ending with {\"event\":\"done\",…}. Exit codes: 0 ok, 1 error, 2 usage,\n  3 no browser available.\n`\n\nfunction outName(source: string, ext: string): string {\n  const base = basename(source).replace(/\\.[a-z0-9]+$/i, '') || 'vos'\n  return `${base}.${ext}`\n}\n\nasync function cmdRender(argv: string[]): Promise<number> {\n  // Polymorphic render: a take DIRECTORY (its doc.json is a recording\n  // document) renders through the plugin; a program directory (config.json,\n  // composed with a program document when one sits beside it) and every\n  // other source are engine config renders. A deterministic sniff, never a\n  // flag — and the sniff reads the document, because a program directory\n  // carries a doc.json too.\n  const first = argv.find((a) => !a.startsWith('-'))\n  if (first && directoryKind(first) === 'take') {\n    return delegate(['render', ...argv])\n  }\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos render <config.json|url|take> [out]')\n  const r = createReporter(flags.json === true)\n  const format = (flags.format as string) ?? 'webm'\n  if (format !== 'webm' && format !== 'mp4')\n    throw new UsageError('--format must be webm or mp4')\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const duration = numFlag(flags, 'duration', configDuration(config) ?? 5)\n  const width = numFlag(flags, 'width', 1920)\n  const height = numFlag(flags, 'height', 1080)\n  const fps = numFlag(flags, 'fps', 30)\n  const out = positionals[1] ?? outName(source, format)\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderVideo(browser, {\n      config,\n      width,\n      height,\n      fps,\n      duration,\n      format,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      { out, bytes: result.bytes.length, width, height, fps, duration, format },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height}@${fps}, ${duration}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdStill(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos still <config.json|url> [out.webp]')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const time = numFlag(flags, 'time', 0)\n  const width = numFlag(flags, 'width', 1280)\n  const height = numFlag(flags, 'height', 720)\n  const out = positionals[1] ?? outName(source, 'webp')\n  // The capture template encodes WebP; a .png/.jpg name would ship WebP\n  // bytes under a lying extension (stores refuse a mislabelled image), so\n  // refuse in words instead of writing it.\n  if (/\\.(png|jpe?g)$/i.test(out))\n    throw new UsageError(\n      `vos still writes WebP (the engine's capture format): name the output .webp, or convert afterwards (ffmpeg -i out.webp out.png)`,\n    )\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderStill(browser, {\n      config,\n      width,\n      height,\n      time,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      {\n        out,\n        bytes: result.bytes.length,\n        width,\n        height,\n        time,\n        mimeType: result.mimeType,\n      },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height} @ t=${time}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdInfo(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos info <config.json|url>')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  const elements = Array.isArray(config.elements) ? config.elements.length : 0\n  const data =\n    typeof config.data === 'object' && config.data !== null\n      ? Object.keys(config.data)\n      : []\n  const fns = ['setup', 'createContent', 'createTimeline', 'onFrame'].filter(\n    (k) => typeof config[k] === 'string',\n  )\n  const info = {\n    version: config.version,\n    duration: configDuration(config) ?? null,\n    camera:\n      (config.camera as Record<string, unknown> | undefined)?.preset ?? null,\n    elements,\n    dataKeys: data,\n    functions: fns,\n    warnings,\n  }\n  if (r.json) r.done(info, '')\n  else {\n    for (const w of warnings) r.log(`note: ${w}`)\n    process.stdout.write(\n      `version:   v${String(info.version)}\\n` +\n        `duration:  ${info.duration === null ? '(none)' : `${info.duration}s`}\\n` +\n        `camera:    ${String(info.camera ?? '(default)')}\\n` +\n        `elements:  ${elements}\\n` +\n        `data keys: ${data.length ? data.join(', ') : '(none)'}\\n` +\n        `functions: ${fns.join(', ')}\\n`,\n    )\n  }\n  return EXIT_OK\n}\n\nfunction packageVersion(name: string): string | null {\n  const require = createRequire(import.meta.url)\n  // Fast path — packages that export ./package.json (e.g. playwright).\n  try {\n    return (require(`${name}/package.json`) as { version: string }).version\n  } catch {\n    // Strict `exports` maps (the @vosjs packages) hide package.json — resolve\n    // the entry module instead and walk up to the owning package.json.\n  }\n  let entry: string | null = null\n  try {\n    entry = fileURLToPath(import.meta.resolve(name))\n  } catch {\n    try {\n      entry = require.resolve(name)\n    } catch {\n      return null\n    }\n  }\n  let dir = dirname(entry)\n  for (let i = 0; i < 6; i++) {\n    try {\n      const pkg = JSON.parse(\n        readFileSync(join(dir, 'package.json'), 'utf8'),\n      ) as {\n        name?: string\n        version?: string\n      }\n      if (pkg.name === name && pkg.version) return pkg.version\n    } catch {\n      // keep walking\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n  return null\n}\n\nfunction ownVersion(): string {\n  try {\n    const own = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL('../package.json', import.meta.url)),\n        'utf8',\n      ),\n    ) as { version: string }\n    return own.version\n  } catch {\n    return '(unknown)'\n  }\n}\n\nasync function cmdVersions(argv: string[]): Promise<number> {\n  const { flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const r = createReporter(flags.json === true)\n  const versions: Record<string, string> = {}\n  versions['@vosjs/cli'] = ownVersion()\n  for (const name of [\n    '@vosjs/core',\n    '@vosjs/elements',\n    '@vosjs/tween',\n    '@vosjs/editor',\n    '@vosjs/timeline',\n    '@vosjs/studio-core',\n    '@vosjs/render-core',\n    '@vosjs/shared',\n    'mediabunny',\n    'playwright',\n  ]) {\n    versions[name] = packageVersion(name) ?? '(not found)'\n  }\n  if (r.json) r.done({ versions }, '')\n  else\n    for (const [k, v] of Object.entries(versions))\n      process.stdout.write(`${k} ${v}\\n`)\n  return EXIT_OK\n}\n\nasync function cmdPreview(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos preview <config.json|url> [--port 0]')\n  const r = createReporter(false)\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const { hostHtml, playerHtml } = previewPages(config)\n  const server = createServer((req, res) => {\n    const path = new URL(req.url ?? '/', 'http://x').pathname\n    res.writeHead(200, { 'content-type': 'text/html' })\n    res.end(path === '/player' ? playerHtml : hostHtml)\n  })\n  const port = numFlag(flags, 'port', 0)\n  await new Promise<void>((resolve) => server.listen(port, resolve))\n  const addr = server.address()\n  const url = `http://localhost:${typeof addr === 'object' && addr ? addr.port : port}/`\n  process.stdout.write(`${url}\\n`)\n  r.log('Serving playback preview — Ctrl-C to stop.')\n  await new Promise(() => {}) // keep alive until interrupted\n  return EXIT_OK\n}\n\nasync function cmdCheck(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos check <config.json>')\n  const r = createReporter(flags.json === true)\n\n  // A directory is a take (refused here: its document is `vos validate`'s\n  // job) or a program directory (config.json, composed with the program\n  // document beside it so the ladder reads the layers' strings too).\n  const kind = /^https?:\\/\\//.test(source) ? 'none' : directoryKind(source)\n  if (kind === 'take') {\n    throw new UsageError(\n      `${source} is a take (its doc.json is a recording document). vos validate ${source} lints it; vos render ${source} renders it.`,\n    )\n  }\n  let raw: string\n  let parsed: unknown\n  try {\n    if (kind === 'program') {\n      const notes: string[] = []\n      parsed = await loadProgramDirectory(source, notes)\n      for (const n of notes) r.log(`note: ${n}`)\n      raw = ''\n    } else {\n      raw = await readSourceText(source)\n      parsed = JSON.parse(raw)\n    }\n  } catch (e) {\n    if (!(e instanceof SyntaxError)) throw e\n    parsed = undefined\n    if (!r.json) process.stdout.write(`error [json] ${(e as Error).message}\\n`)\n    r.done(\n      {\n        ok: false,\n        errors: 1,\n        warnings: 0,\n        issues: [\n          { level: 'error', source: 'json', message: (e as Error).message },\n        ],\n      },\n      `${source}: 1 error`,\n    )\n    return EXIT_ERROR\n  }\n\n  const result = runCheck(parsed)\n  if (r.json) {\n    r.done(\n      {\n        ok: result.ok,\n        errors: result.errors,\n        warnings: result.warnings,\n        issues: result.issues,\n      },\n      '',\n    )\n  } else {\n    for (const i of result.issues) {\n      process.stdout.write(`${i.level} [${i.source}] ${i.message}\\n`)\n    }\n    process.stdout.write(\n      result.ok\n        ? `${source}: ok (${result.warnings} warning${result.warnings === 1 ? '' : 's'})\\n`\n        : `${source}: ${result.errors} error${result.errors === 1 ? '' : 's'}, ${result.warnings} warning${result.warnings === 1 ? '' : 's'}\\n`,\n    )\n  }\n  return result.ok ? EXIT_OK : EXIT_ERROR\n}\n\n// ---------------------------------------------------------------------------\n// Every verb this file does not own is a take-pipeline or vos.so verb from\n// `./plugin` (what used to ship separately as @vosso/vos-plugin). It loads on\n// demand, so the engine verbs never pay for the recorder's imports, and the\n// old names (`@vosso/cli`, `@vosso/voila-cli`, the `vos voila` alias) keep\n// resolving here for scripts that still use them.\n// ---------------------------------------------------------------------------\n\nasync function delegate(argv: string[], viaAlias = false): Promise<number> {\n  const { run } = await import('./plugin/run')\n  if (viaAlias && argv[0]) {\n    process.stderr.write(\n      `note: \"vos voila ${argv[0]}\" is now \"vos ${argv[0]}\".\\n`,\n    )\n  }\n  return await run(argv)\n}\n\nasync function printHelp(): Promise<void> {\n  process.stdout.write(HELP_ENGINE)\n  const { manifest } = await import('./plugin/manifest')\n  process.stdout.write('\\nTake pipeline + vos.so verbs\\n')\n  for (const v of manifest.verbs) {\n    if (v.name === 'render') continue // polymorphic — already listed above\n    process.stdout.write(`  vos ${v.name.padEnd(8)} ${v.summary}\\n`)\n  }\n  process.stdout.write(HELP_CONVENTIONS)\n}\n\nconst ENGINE_VERBS = new Set([\n  'render',\n  'still',\n  'info',\n  'versions',\n  'preview',\n  'check',\n])\n\nasync function main(): Promise<number> {\n  const [cmd, ...rest] = process.argv.slice(2)\n  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {\n    await printHelp()\n    return cmd ? EXIT_OK : EXIT_USAGE\n  }\n  if (cmd === '--version') return cmdVersions(['--json'])\n  if (!ENGINE_VERBS.has(cmd) && cmd !== 'voila') return delegate([cmd, ...rest])\n  switch (cmd) {\n    case 'render':\n      return cmdRender(rest)\n    case 'still':\n      return cmdStill(rest)\n    case 'info':\n      return cmdInfo(rest)\n    case 'versions':\n      return cmdVersions(rest)\n    case 'preview':\n      return cmdPreview(rest)\n    case 'check':\n      return cmdCheck(rest)\n    // Hidden alias for existing scripts; not in HELP. Same code path as the\n    // promoted verbs, plus a one-line pointer at the new spelling.\n    case 'voila':\n      return delegate(rest, true)\n    default:\n      throw new UsageError(`unknown command \"${cmd}\" — run vos help`)\n  }\n}\n\nmain()\n  .then((code) => process.exit(code))\n  .catch((e) => {\n    if (e instanceof UsageError) {\n      process.stderr.write(`usage error: ${e.message}\\n`)\n      process.exit(EXIT_USAGE)\n    }\n    if (e instanceof BrowserUnavailableError) {\n      process.stderr.write(`${e.message}\\n`)\n      process.exit(EXIT_NO_BROWSER)\n    }\n    process.stderr.write(\n      `error: ${e instanceof Error ? e.message : String(e)}\\n`,\n    )\n    process.exit(EXIT_ERROR)\n  })\n","/**\n * Output conventions (agent-safe by construction):\n * - logs/progress → stderr (human readable)\n * - results → stdout; with --json, NDJSON events (`{\"event\":\"phase\"...}` then\n *   `{\"event\":\"done\"...}`) so scripts and agents never parse prose\n * - exit codes: 0 ok · 1 failure · 2 usage · 3 browser unavailable\n */\nexport const EXIT_OK = 0\nexport const EXIT_ERROR = 1\nexport const EXIT_USAGE = 2\nexport const EXIT_NO_BROWSER = 3\n\nexport interface Reporter {\n  json: boolean\n  /** Human log line (stderr; suppressed in --json mode). */\n  log: (msg: string) => void\n  /** Machine event (stdout NDJSON in --json mode; no-op otherwise). */\n  event: (obj: Record<string, unknown>) => void\n  /** Final result: NDJSON `done` event in --json mode, plain line otherwise. */\n  done: (obj: Record<string, unknown>, humanLine: string) => void\n}\n\nexport function createReporter(json: boolean): Reporter {\n  return {\n    json,\n    log: (msg) => {\n      if (!json) process.stderr.write(`${msg}\\n`)\n    },\n    event: (obj) => {\n      if (json) process.stdout.write(`${JSON.stringify(obj)}\\n`)\n    },\n    done: (obj, humanLine) => {\n      if (json)\n        process.stdout.write(`${JSON.stringify({ event: 'done', ...obj })}\\n`)\n      else process.stdout.write(`${humanLine}\\n`)\n    },\n  }\n}\n","/**\n * `vos check` — the local validation pipeline, pure so it can be unit-tested:\n * envelope unwrap → migrate → schema → compile → determinism + dialect lints.\n * Everything runs locally (no network, no browser). The platform runs the\n * same compiler server-side, so a clean check is a push that will compile.\n */\nimport {\n  CURRENT_CONFIG_VERSION,\n  compileVosConfig,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport { lintVosConfig, lintVosDialect, lintVosFonts } from '@vosjs/core/lint'\n\nexport interface CheckIssue {\n  level: 'error' | 'warn'\n  source:\n    | 'schema'\n    | 'syntax'\n    | 'compile'\n    | 'determinism'\n    | 'dialect'\n    | 'shape'\n    | 'fonts'\n  message: string\n}\n\nexport interface CheckResult {\n  ok: boolean\n  errors: number\n  warnings: number\n  issues: CheckIssue[]\n  /** The migrated config (params/presets untouched) — what a push should send. */\n  config: Record<string, unknown> | null\n}\n\n// Top-level keys the schema does not know but the platform preserves on push.\nconst PLATFORM_EXTRA_KEYS = new Set(['params', 'presets'])\n\nexport function runCheck(parsed: unknown): CheckResult {\n  const issues: CheckIssue[] = []\n  const finish = (config: Record<string, unknown> | null): CheckResult => {\n    const errors = issues.filter((i) => i.level === 'error').length\n    return {\n      ok: errors === 0,\n      errors,\n      warnings: issues.length - errors,\n      issues,\n      config,\n    }\n  }\n\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: 'not a JSON object',\n    })\n    return finish(null)\n  }\n\n  // API endpoints wrap the config: { config: {...} } — accept both shapes.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n  }\n\n  const version = obj.version\n  let migrated: Record<string, unknown>\n  try {\n    migrated = migrateConfig(obj) as Record<string, unknown>\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: `migration failed: ${e instanceof Error ? e.message : String(e)}`,\n    })\n    return finish(null)\n  }\n  if (version === undefined) {\n    // It compiles (the engine reads an absent version as the current one),\n    // but a push is refused: a stored config must say which schema era it was\n    // written against, and nobody can tell that from the file later.\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config declares no \"version\". It plays here, but a push is refused without one. Add \"version\": ${CURRENT_CONFIG_VERSION}.`,\n    })\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config is v${String(version)}, migrated to v${CURRENT_CONFIG_VERSION}. Save the migrated form.`,\n    })\n  }\n\n  const schema = vosConfigJsonSchema.safeParse(migrated)\n  if (!schema.success) {\n    for (const i of schema.error.issues.slice(0, 10)) {\n      issues.push({\n        level: 'error',\n        source: 'schema',\n        message: `${i.path.join('.') || '(root)'}: ${i.message}`,\n      })\n    }\n    return finish(null)\n  }\n\n  // Keys the platform's schema will silently drop on push (params/presets\n  // excepted — those are re-attached by contract).\n  const known = new Set([\n    ...Object.keys(vosConfigJsonSchema.shape),\n    ...PLATFORM_EXTRA_KEYS,\n  ])\n  for (const key of Object.keys(migrated)) {\n    if (!known.has(key)) {\n      issues.push({\n        level: 'warn',\n        source: 'shape',\n        message: `unknown top-level key \"${key}\" — the platform drops it on push`,\n      })\n    }\n  }\n\n  // Function strings are pasted into the template as text, so the compiler\n  // cannot see a syntax error — parse each one here (construction only,\n  // nothing executes).\n  let syntaxErrors = 0\n  for (const key of [\n    'setup',\n    'createContent',\n    'createTimeline',\n    'onFrame',\n  ] as const) {\n    const src = migrated[key]\n    if (typeof src !== 'string' || !src.length) continue\n    try {\n      new Function(`\"use strict\"; return (${src}\\n)`)\n    } catch (e) {\n      syntaxErrors++\n      issues.push({\n        level: 'error',\n        source: 'syntax',\n        message: `${key}: ${e instanceof Error ? e.message : String(e)}`,\n      })\n    }\n  }\n  if (syntaxErrors) return finish(migrated)\n\n  try {\n    // Same options as `vos render` — a clean check is a config the CLI's own\n    // render path will accept.\n    compileVosConfig(migrated as never, { tweenEngine: 'vos' })\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'compile',\n      message: e instanceof Error ? e.message : String(e),\n    })\n    return finish(migrated)\n  }\n\n  for (const i of lintVosConfig(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'determinism',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosDialect(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'dialect',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosFonts(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'fonts',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n\n  return finish(migrated)\n}\n"],"mappings":"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","names":["require"]}

package/dist/index.d.ts

@@ -46,8 +46,11 @@ interface LoadedConfig {
     warnings: string[];
 }
 /**
- * Load a VosConfigJson from a file path or http(s) URL, unwrap API `{ config }`
- * envelopes, migrate old versions, and validate against the schema.
+ * Load a VosConfigJson from a file path, an http(s) URL, or a program
+ * directory (config.json, composed with a program document when one sits
+ * beside it); unwrap API `{ config }` envelopes, migrate old versions, and
+ * validate against the schema. A take directory is refused here in words:
+ * takes render through the take pipeline (`vos render <take>`).
  */
 declare function loadVosConfig(source: string): Promise<LoadedConfig>;
 /** Best-effort duration from the config (seconds). */

package/dist/index.js

@@ -1,11 +1,9 @@
 #!/usr/bin/env node
 import {
-  configDuration,
-  loadVosConfig,
   previewPages,
   renderStill,
   renderVideo
-} from "./chunk-X2BKHZ56.js";
+} from "./chunk-GCWE75OA.js";
 import {
   RECORDING_NAME,
   apiError,
@@ -32,14 +30,16 @@ import {
   validateActions,
   waitForPageDone,
   writeSyncState
-} from "./chunk-6TFKMNSG.js";
+} from "./chunk-MMKDYE57.js";
 import {
   BrowserUnavailableError,
-  launchBrowser
-} from "./chunk-A2VSDK3C.js";
+  configDuration,
+  launchBrowser,
+  loadVosConfig
+} from "./chunk-NHKHTIDR.js";
 import {
   manifest
-} from "./chunk-5BFGODBI.js";
+} from "./chunk-EFI3WUQB.js";
 export {
   BrowserUnavailableError,
   RECORDING_NAME,

package/dist/manifest-UCS6OVWZ.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  manifest
+} from "./chunk-EFI3WUQB.js";
+export {
+  manifest
+};
+//# sourceMappingURL=manifest-UCS6OVWZ.js.map

package/dist/run-R5P44XNR.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  run
+} from "./chunk-MMKDYE57.js";
+import "./chunk-NHKHTIDR.js";
+export {
+  run
+};
+//# sourceMappingURL=run-R5P44XNR.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "The vos CLI: record the real product from a scripted browser flow, auto-zoom from the cursor track, cut as data in doc.json, render deterministic video and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -48,14 +48,14 @@
   "dependencies": {
     "mediabunny": "^1.27.3",
     "playwright": "^1.49.0",
-    "@vosjs/core": "^0.23.1",
-    "@vosjs/editor": "^1.3.0",
-    "@vosjs/elements": "^0.8.0",
-    "@vosjs/render-core": "^0.2.0",
-    "@vosjs/shared": "^0.4.0",
-    "@vosjs/tween": "^0.8.1",
-    "@vosjs/studio-core": "^0.4.0",
-    "@vosjs/timeline": "^0.4.0"
+    "@vosjs/core": "^0.23.2",
+    "@vosjs/editor": "^1.3.1",
+    "@vosjs/elements": "^0.8.1",
+    "@vosjs/shared": "^0.4.1",
+    "@vosjs/render-core": "^0.2.1",
+    "@vosjs/studio-core": "^0.5.0",
+    "@vosjs/tween": "^0.8.2",
+    "@vosjs/timeline": "^0.4.1"
   },
   "devDependencies": {
     "@types/node": "^22",