@odori/cli 0.0.4 → 0.0.6

package/bin/odori.mjs

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import {existsSync} from "node:fs";
-import {createRequire} from "node:module";
 import {dirname, resolve} from "node:path";
 import {fileURLToPath, pathToFileURL} from "node:url";
 
@@ -19,21 +18,44 @@ import {fileURLToPath, pathToFileURL} from "node:url";
 const here = dirname(fileURLToPath(import.meta.url));
 const built = resolve(here, "..", "dist", "cli.js");
 
+/*
+ * import.meta.resolve, not createRequire().resolve.
+ *
+ * The published runtime is ESM only: its exports declare `import` and no
+ * `require`, so a CommonJS resolver cannot see it at all and throws
+ * ERR_PACKAGE_PATH_NOT_EXPORTED. The catch below then answered "yes, source",
+ * which meant every installed copy took the transform branch. Not just the
+ * pause this was written to avoid, but a real failure: the CLI would run its
+ * TypeScript through tsx while Node was already stripping types itself, and
+ * loading a project's odori.config.ts landed in a require(esm) cycle that
+ * Node refuses outright. odori doctor could not run in a new project.
+ *
+ * import.meta.resolve honours the same conditions the CLI's own imports use,
+ * so it answers the question that was actually being asked.
+ */
 const runtimeIsSource = () => {
   try {
-    return /\.tsx?$/.test(createRequire(import.meta.url).resolve("odori"));
+    return /\.tsx?$/.test(import.meta.resolve("odori"));
   } catch {
     // Unresolvable from here: let the transform handle whatever it is.
     return true;
   }
 };
 
-if (existsSync(built) && !runtimeIsSource()) {
-  const {run} = await import(pathToFileURL(built).href);
-  process.exitCode = await run(process.argv.slice(2));
-} else {
-  const {register} = await import("tsx/esm/api");
-  register();
-  const {run} = await import("../src/cli.ts");
-  process.exitCode = await run(process.argv.slice(2));
-}
+/*
+ * The transform is registered either way, because it is not there for the
+ * CLI. A project's videos are .tsx, and Node's own type stripping erases
+ * types without understanding JSX, so `odori list` on a real project fails
+ * with "Unknown file extension .tsx" the moment nothing is registered.
+ *
+ * What the branch decides is only where the CLI's own code comes from: its
+ * build when there is one, its source inside this repository, where `odori`
+ * resolves to a .tsx the build could not have linked against.
+ */
+const {register} = await import("tsx/esm/api");
+register();
+
+const {run} = await import(
+  existsSync(built) && !runtimeIsSource() ? pathToFileURL(built).href : "../src/cli.ts"
+);
+process.exitCode = await run(process.argv.slice(2));

package/dist/{chunk-NYXWEZU2.js → chunk-6CE7U5KB.js}

@@ -317,7 +317,7 @@ var toComponent = (item) => ({
 });
 var snapshotItems = async () => {
   try {
-    const loaded = await import("./registry-snapshot-MSH2EA36.js");
+    const loaded = await import("./registry-snapshot-ADKSTGDR.js");
     return loaded.default.items;
   } catch {
     throw new Error(
@@ -465,8 +465,9 @@ var installAsset = async (config, component, options = {}) => {
 };
 
 // src/commands/update.ts
-import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile5 } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile5, rm as rm2, writeFile as writeFile5 } from "fs/promises";
 import { existsSync as existsSync6 } from "fs";
+import { readdir as readdir2 } from "fs/promises";
 import { relative as relative4, resolve as resolve6 } from "path";
 import { hashString } from "odori";
 
@@ -530,16 +531,24 @@ var formatDiff = (lines, context = 2) => {
 };
 
 // src/commands/update.ts
-var provenanceFile = (config) => resolve6(config.root, config.outDir, "components.json");
+var LOCKFILE = "odori.lock.json";
+var provenanceFile = (config) => resolve6(config.root, LOCKFILE);
+var legacyProvenanceFile = (config) => resolve6(config.root, config.outDir, "components.json");
 var readProvenance = async (config) => {
-  const file = provenanceFile(config);
+  const file = existsSync6(provenanceFile(config)) ? provenanceFile(config) : legacyProvenanceFile(config);
   if (!existsSync6(file)) return {};
-  return JSON.parse(await readFile5(file, "utf8"));
+  try {
+    return JSON.parse(await readFile5(file, "utf8"));
+  } catch {
+    log.warn(`${relative4(config.root, file)} is not readable JSON. Ignoring it.`);
+    return {};
+  }
 };
 var writeProvenance = async (config, provenance) => {
-  await mkdir4(resolve6(config.root, config.outDir), { recursive: true });
+  await mkdir4(config.root, { recursive: true });
   await writeFile5(provenanceFile(config), `${JSON.stringify(provenance, null, 2)}
 `, "utf8");
+  await rm2(legacyProvenanceFile(config), { force: true });
 };
 var componentStatus = async (config, only) => {
   const { items: registry } = await resolveRegistry(config);
@@ -583,11 +592,25 @@ var LABELS = {
   diverged: "modified locally and updated upstream",
   missing: "files missing"
 };
+var explainEmpty = async (config, named) => {
+  if (named.length > 0) {
+    log.detail(`${named.join(", ")} ${named.length === 1 ? "is" : "are"} not recorded in ${LOCKFILE}.`);
+    return;
+  }
+  const components = resolve6(config.root, config.componentsDir);
+  const installed = existsSync6(components) ? (await readdir2(components)).filter((e) => !e.startsWith(".")) : [];
+  if (installed.length === 0) {
+    log.detail("No registry components are installed yet. Run odori add first.");
+    return;
+  }
+  log.warn(`${installed.length} components are in ${config.componentsDir} but none are recorded in ${LOCKFILE}.`);
+  log.detail("Run odori add <name> to re-record them, or commit the lockfile if a teammate has one.");
+};
 var diffCommand = async (names, options = {}) => {
   const config = await loadConfig(process.cwd());
   const statuses = await componentStatus(config, names.length > 0 ? names : void 0);
   if (statuses.length === 0) {
-    log.detail("No registry components are installed yet. Run odori add first.");
+    await explainEmpty(config, names);
     return;
   }
   for (const status of statuses) {
@@ -613,7 +636,7 @@ var updateCommand = async (names, options = {}) => {
   const config = await loadConfig(process.cwd());
   const statuses = await componentStatus(config, names.length > 0 ? names : void 0);
   if (statuses.length === 0) {
-    log.detail("No registry components are installed yet. Run odori add first.");
+    await explainEmpty(config, names);
     return;
   }
   const provenance = await readProvenance(config);
@@ -662,6 +685,7 @@ var addCommand = async (names, options = {}) => {
   else log.warn(`registry: the copy built into this CLI. It may be older than ${registryUrl(config)}.`);
   const queue = [...names.map(normalizeComponentName)];
   const installed = [];
+  const kept = [];
   while (queue.length > 0) {
     const name = queue.shift();
     if (installed.includes(name)) continue;
@@ -717,7 +741,8 @@ var addCommand = async (names, options = {}) => {
         const current = hashString2(await readFile6(destination, "utf8"));
         const recorded = provenance[component.name]?.hashes[name2];
         if (current !== recorded) {
-          log.warn(`${relative5(config.root, destination)} was modified locally. Keeping your version. Use --force to replace it.`);
+          log.warn(`${relative5(config.root, destination)} was modified locally. Keeping your version.`);
+          kept.push(relative5(config.root, destination));
           continue;
         }
       }
@@ -757,6 +782,11 @@ var addCommand = async (names, options = {}) => {
     return;
   }
   await writeProvenance(config, provenance);
+  if (kept.length > 0) {
+    log.warn(`Kept ${kept.length} locally modified ${kept.length === 1 ? "file" : "files"}:`);
+    for (const file of kept) log.detail(`  ${file}`);
+    log.detail(`Run odori diff to see what upstream changed, or odori add <name> --force to replace them.`);
+  }
   log.detail("Run odori dev to preview the installed component fixtures.");
 };
 var registryCommand = async () => {
@@ -785,7 +815,7 @@ import { existsSync as existsSync16 } from "fs";
 import { readFile as readFile13 } from "fs/promises";
 
 // src/jobs.ts
-import { mkdir as mkdir6, readFile as readFile7, readdir as readdir2, rename, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir6, readFile as readFile7, readdir as readdir3, rename, writeFile as writeFile7 } from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
 import { join as join2, resolve as resolve8 } from "path";
 var buildsDir = (config) => resolve8(config.root, config.outDir, "builds");
@@ -872,7 +902,7 @@ var reconcileJobs = async (config) => {
 var listJobs = async (config, options = {}) => {
   if (!existsSync8(buildsDir(config))) return [];
   if (options.reconcile !== false) await reconcileJobs(config);
-  const files = (await readdir2(buildsDir(config))).filter((file) => file.endsWith(".json"));
+  const files = (await readdir3(buildsDir(config))).filter((file) => file.endsWith(".json"));
   const jobs = [];
   for (const file of files) {
     try {
@@ -894,13 +924,13 @@ var JobQueue = class {
 };
 
 // src/discovery.ts
-import { mkdir as mkdir7, readdir as readdir3, readFile as readFile8, stat, writeFile as writeFile8 } from "fs/promises";
+import { mkdir as mkdir7, readdir as readdir4, readFile as readFile8, stat, writeFile as writeFile8 } from "fs/promises";
 import { existsSync as existsSync9 } from "fs";
 import { join as join3, relative as relative6, resolve as resolve9, sep as sep2 } from "path";
 import { hashString as hashString3 } from "odori";
 var IGNORED = /* @__PURE__ */ new Set(["node_modules", ".git", ".odori", "out", "dist", ".next"]);
 var walk = async (directory2, files = []) => {
-  const entries = await readdir3(directory2, { withFileTypes: true });
+  const entries = await readdir4(directory2, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.name.startsWith(".") || IGNORED.has(entry.name)) continue;
     const full = join3(directory2, entry.name);
@@ -1167,7 +1197,7 @@ var createIntegrityResolver = async (config) => {
 
 // src/prepare-cache.ts
 import { existsSync as existsSync11 } from "fs";
-import { mkdir as mkdir9, readFile as readFile10, readdir as readdir4, rm as rm2, writeFile as writeFile10 } from "fs/promises";
+import { mkdir as mkdir9, readFile as readFile10, readdir as readdir5, rm as rm3, writeFile as writeFile10 } from "fs/promises";
 import { join as join4, resolve as resolve11 } from "path";
 import { hashValue } from "odori";
 
@@ -1199,9 +1229,9 @@ var writePrepareCache = async (config, key, value) => {
 var clearPrepareCache = async (config, videoId) => {
   const target = directory(config);
   if (!existsSync11(target)) return 0;
-  const files = await readdir4(target);
+  const files = await readdir5(target);
   const matches = files.filter((file) => videoId ? file.startsWith(`${fileKey(videoId)}__`) : file.endsWith(".json"));
-  await Promise.all(matches.map((file) => rm2(join4(target, file), { force: true })));
+  await Promise.all(matches.map((file) => rm3(join4(target, file), { force: true })));
   return matches.length;
 };
 
@@ -1442,7 +1472,7 @@ var alphaWarning = (format, transparent) => transparent && !format.alpha ? `${fo
 
 // src/render.ts
 import { spawn as spawn2 } from "child_process";
-import { copyFile as copyFile2, mkdir as mkdir12, rm as rm3, writeFile as writeFile13 } from "fs/promises";
+import { copyFile as copyFile2, mkdir as mkdir12, rm as rm4, writeFile as writeFile13 } from "fs/promises";
 import { cpus } from "os";
 import { dirname as dirname5, join as join6, resolve as resolve16 } from "path";
 import { chromium } from "playwright-core";
@@ -2065,7 +2095,7 @@ var renderMovie = async (origin, target, output, config, onProgress, options = {
     );
     const captureMs = performance.now() - captureStart;
     onProgress?.(1, "encoding");
-    const mixInputs = (target.audio ?? []).map((cue) => {
+    const mixInputs = (options.audio === false ? [] : target.audio ?? []).map((cue) => {
       const file = resolveCueFile(config, cue.src);
       if (!file) log.warn(`Skipping audio cue ${cue.src}: only project-local files can be encoded.`);
       return file ? { file, cue } : null;
@@ -2136,7 +2166,7 @@ var renderMovie = async (origin, target, output, config, onProgress, options = {
     succeeded = true;
     return output;
   } finally {
-    if (succeeded && !options.workDir) await rm3(work, { recursive: true, force: true });
+    if (succeeded && !options.workDir) await rm4(work, { recursive: true, force: true });
     else if (!succeeded) log.detail(`Chunks left for inspection in ${work}`);
   }
 };
@@ -2534,6 +2564,7 @@ var runJob = async (config, origin, record, video, options = {}) => exportQueue.
         quality: options.quality ?? record.render?.quality,
         scale: options.scale ?? record.render?.scale,
         format: options.format ?? (record.render?.format ? resolveFormat(record.render.format, record.output) : void 0),
+        audio: options.audio ?? record.render?.audio,
         skipUnchangedFrames: options.skipUnchangedFrames,
         signal: controller.signal,
         onTimings: (timings) => {
@@ -2596,6 +2627,7 @@ var exportCommand = async (id, options = {}) => {
         format: format.name,
         quality,
         scale,
+        audio: options.audio !== false,
         ...options.preset ? { preset: options.preset } : {}
       });
     })();
@@ -2612,6 +2644,7 @@ var exportCommand = async (id, options = {}) => {
       quality: options.retry && options.quality === void 0 ? void 0 : quality,
       scale: options.retry && options.scale === void 0 ? void 0 : scale,
       format: options.retry ? void 0 : format,
+      audio: options.audio,
       skipUnchangedFrames: options.skipUnchangedFrames,
       onProgress: (next) => {
         if (next.status === "rendering" || next.status === "encoding") {
@@ -2756,7 +2789,8 @@ var devCommand = async (options = {}) => {
                 exportDestination(config),
                 `${outputName(video.entry.metadata.id)}${format.extension}`
               );
-              const record = await createJob(config, manifest, output, { format: format.name, quality, scale });
+              const audio = body.audio !== false;
+              const record = await createJob(config, manifest, output, { format: format.name, quality, scale, audio });
               json(response, 202, record.job);
               void runJob(config, origin, record, video).catch((error) => {
                 log.error(`Export failed: ${error instanceof Error ? error.message : String(error)}`);
@@ -2827,7 +2861,7 @@ var devCommand = async (options = {}) => {
 
 // src/commands/doctor.ts
 import { constants } from "fs";
-import { access, mkdir as mkdir13, readFile as readFile14, rm as rm4, writeFile as writeFile14 } from "fs/promises";
+import { access, mkdir as mkdir13, readFile as readFile14, rm as rm5, writeFile as writeFile14 } from "fs/promises";
 import { existsSync as existsSync17 } from "fs";
 import { createRequire as createRequire3 } from "module";
 import { relative as relative8, resolve as resolve20 } from "path";
@@ -2901,7 +2935,7 @@ var runChecks = async (root) => {
     const probe = resolve20(generated, ".doctor");
     await writeFile14(probe, "", "utf8");
     await access(probe, constants.W_OK);
-    await rm4(probe, { force: true });
+    await rm5(probe, { force: true });
     writable = true;
   } catch {
     writable = false;
@@ -2909,10 +2943,10 @@ var runChecks = async (root) => {
   const componentsRoot = resolve20(root, config.componentsDir);
   const orphans = [];
   if (existsSync17(componentsRoot)) {
-    const { readdir: readdir8 } = await import("fs/promises");
-    for (const entry of await readdir8(componentsRoot, { withFileTypes: true })) {
+    const { readdir: readdir9 } = await import("fs/promises");
+    for (const entry of await readdir9(componentsRoot, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
-      const files = await readdir8(resolve20(componentsRoot, entry.name));
+      const files = await readdir9(resolve20(componentsRoot, entry.name));
       const source = files.some((file) => /\.tsx$/.test(file) && !file.endsWith(".preview.tsx"));
       const fixture = files.some((file) => file.endsWith(".preview.tsx"));
       if (source && !fixture) orphans.push(entry.name);
@@ -2956,12 +2990,12 @@ var doctorCommand = async (root = process.cwd()) => {
 };
 
 // src/commands/init.ts
-import { mkdir as mkdir15, writeFile as writeFile16 } from "fs/promises";
+import { mkdir as mkdir15, readFile as readFile15, writeFile as writeFile16 } from "fs/promises";
 import { existsSync as existsSync19 } from "fs";
 import { relative as relative10, resolve as resolve22 } from "path";
 
 // src/commands/new.ts
-import { mkdir as mkdir14, readdir as readdir5, writeFile as writeFile15 } from "fs/promises";
+import { mkdir as mkdir14, readdir as readdir6, writeFile as writeFile15 } from "fs/promises";
 import { existsSync as existsSync18 } from "fs";
 import { relative as relative9, resolve as resolve21 } from "path";
 var titleCase = (value) => value.split(/[-_\s]+/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
@@ -3023,7 +3057,7 @@ ${closing}
 var installedParts = async (config) => {
   const componentsDir = resolve21(config.root, config.componentsDir);
   if (!existsSync18(componentsDir)) return { title: false, end: false };
-  const entries = (await readdir5(componentsDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  const entries = (await readdir6(componentsDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   return { title: entries.includes("title-reveal"), end: entries.includes("end-card") };
 };
 var newCommand = async (name, options = {}) => {
@@ -3091,8 +3125,28 @@ var initCommand = async (root = process.cwd()) => {
     await writeFile16(file, contents, "utf8");
     log.success(`Created ${relative10(root, file)}`);
   }
+  await ensureModuleType(root);
   log.detail("Next: odori doctor, then odori add title-reveal end-card, then odori dev.");
 };
+var ensureModuleType = async (root) => {
+  const file = resolve22(root, "package.json");
+  if (!existsSync19(file)) {
+    log.warn('No package.json here. Odori needs an ESM package: run npm init, then add "type": "module".');
+    return;
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse(await readFile15(file, "utf8"));
+  } catch {
+    log.warn('package.json is not readable JSON, so "type": "module" was not set. Odori needs it.');
+    return;
+  }
+  if (manifest.type === "module") return;
+  manifest.type = "module";
+  await writeFile16(file, `${JSON.stringify(manifest, null, 2)}
+`, "utf8");
+  log.success('Set "type": "module" in package.json');
+};
 
 // src/commands/inspect.ts
 import { isOdoriSchema, resolveEntryLayout as resolveEntryLayout5 } from "odori";
@@ -3215,7 +3269,7 @@ import { isOdoriSchema as isOdoriSchema2, resolveEntryLayout as resolveEntryLayo
 
 // src/contracts.ts
 import { existsSync as existsSync20 } from "fs";
-import { readdir as readdir6 } from "fs/promises";
+import { readdir as readdir7 } from "fs/promises";
 import { resolve as resolve24 } from "path";
 import { cueUrl as cueUrl2, isCueDefinition as isCueDefinition2, resolveEntryLayout as resolveEntryLayout8 } from "odori";
 var primaryFamily = (stack) => (stack.split(",")[0] ?? "").trim().replace(/^["']|["']$/g, "");
@@ -3284,7 +3338,7 @@ var checkAudioWindows = (cues, brand, videoId) => {
 };
 var checkInstalledContracts = async (config, videos) => {
   const componentsDir = resolve24(config.root, config.componentsDir);
-  const onDisk = existsSync20(componentsDir) ? (await readdir6(componentsDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name) : [];
+  const onDisk = existsSync20(componentsDir) ? (await readdir7(componentsDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name) : [];
   const names = /* @__PURE__ */ new Set([...Object.keys(await readProvenance(config)), ...onDisk]);
   if (names.size === 0) return [];
   const { items } = await resolveRegistry(config, { allowNetwork: false });
@@ -3305,7 +3359,7 @@ var checkInstalledContracts = async (config, videos) => {
 };
 
 // src/determinism.ts
-import { readdir as readdir7, readFile as readFile15 } from "fs/promises";
+import { readdir as readdir8, readFile as readFile16 } from "fs/promises";
 import { existsSync as existsSync21 } from "fs";
 import { join as join7, relative as relative11, resolve as resolve25 } from "path";
 var FORBIDDEN = [
@@ -3339,7 +3393,7 @@ var scanSource = (source, file) => {
   return findings;
 };
 var walk2 = async (directory2, files = []) => {
-  for (const entry of await readdir7(directory2, { withFileTypes: true })) {
+  for (const entry of await readdir8(directory2, { withFileTypes: true })) {
     if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
     const full = join7(directory2, entry.name);
     if (entry.isDirectory()) await walk2(full, files);
@@ -3352,7 +3406,7 @@ var checkDeterminism = async (config) => {
   if (!existsSync21(root)) return [];
   const files = await walk2(root);
   const findings = await Promise.all(
-    files.map(async (file) => scanSource(await readFile15(file, "utf8"), relative11(config.root, file)))
+    files.map(async (file) => scanSource(await readFile16(file, "utf8"), relative11(config.root, file)))
   );
   return findings.flat();
 };
@@ -3428,6 +3482,18 @@ var FRAME_SCRIPT = `(() => {
     if (!media && text.length === 0) continue;
 
     var label = text.length > 0 ? '"' + text.slice(0, 32) + '"' : "<" + node.tagName.toLowerCase() + ">";
+
+    /*
+     * Chrome is exempt from the readability floor.
+     *
+     * A component that recreates somebody else's app is right to draw that
+     * app's sidebar at the size that app draws it. Slack's rail really is
+     * 16px, and enlarging it until this check is happy produces a Slack that
+     * does not look like Slack. That text is furniture: it says "this is
+     * Slack", and nobody is meant to read it. What has to be legible is the
+     * content the video is actually about, which is what stays checked.
+     */
+    var chrome = node.closest("[data-odori-chrome]") !== null;
     if (
       box.right > bounds.right + 1 ||
       box.left < bounds.left - 1 ||
@@ -3440,8 +3506,18 @@ var FRAME_SCRIPT = `(() => {
     // Normalize against the shorter side, the same reference useDesignScale
     // uses, so a vertical cut is not judged as if it were letterboxed.
     var reference = Math.min(bounds.width, bounds.height);
-    var relative = (parseFloat(style.fontSize) / reference) * 1080;
-    if (text.length > 0 && relative > 0 && relative < 20) {
+    /*
+     * What the glyphs actually measure on screen, not what the stylesheet
+     * asked for. A scene that pushes in on a surface makes its text bigger,
+     * and reading font-size alone called that a violation while the viewer
+     * was looking at type half again as large. The ratio of the painted box
+     * to the laid-out box is every ancestor transform multiplied together,
+     * which is exactly the correction wanted, and it cancels the root's own
+     * fit scale because the reference is measured through it too.
+     */
+    var zoom = node.offsetHeight > 0 ? box.height / node.offsetHeight : 1;
+    var relative = ((parseFloat(style.fontSize) * zoom) / reference) * 1080;
+    if (!chrome && text.length > 0 && relative > 0 && relative < 20) {
       var note = label + " at " + Math.round(relative) + "px";
       if (small.indexOf(note) < 0) small.push(note);
     }
@@ -3560,6 +3636,8 @@ var testCommand = async (id, options = {}) => {
 };
 
 // src/cli.ts
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["force", "dry-run", "json", "no-audio", "no-frame-skip", "no-open", "open", "help", "version"]);
+var RENAMED = { still: "frame" };
 var parseArgs = (argv) => {
   const [command2 = "help", ...rest] = argv;
   const positionals = [];
@@ -3574,7 +3652,7 @@ var parseArgs = (argv) => {
       }
       const name = token.slice(2);
       const next = rest[index + 1];
-      if (next === void 0 || next.startsWith("--")) flags[name] = true;
+      if (BOOLEAN_FLAGS.has(name) || next === void 0 || next.startsWith("--")) flags[name] = true;
       else {
         flags[name] = next;
         index += 1;
@@ -3618,7 +3696,7 @@ var COMMAND_FLAGS = {
   inspect: ["json", "input"],
   frame: ["at", "output", "input"],
   test: ["json"],
-  export: ["output", "input", "concurrency", "preset", "format", "quality", "scale", "no-frame-skip", "retry"],
+  export: ["output", "input", "concurrency", "preset", "format", "quality", "scale", "no-audio", "no-frame-skip", "retry"],
   jobs: [],
   help: []
 };
@@ -3687,11 +3765,12 @@ var USAGE = {
   check, for CI.`,
   export: `odori export <id> [--output <path>] [--input <json>] [--concurrency <n>]
              [--preset <name>] [--format <name>] [--quality <tier>] [--scale <n>]
-             [--no-frame-skip] [--retry <job>]
+             [--no-audio] [--no-frame-skip] [--retry <job>]
   Render and encode a distributable file. --format is mp4, webm, prores, gif,
   or png; without it the output's extension decides, and mp4 is the default.
   --quality is studio, social, or web. --scale multiplies the output size,
-  0.25 to 2. A retry keeps the settings its job was created with.`,
+  0.25 to 2. --no-audio writes the picture with no sound. A retry keeps the
+  settings its job was created with.`,
   jobs: `odori jobs
   List export jobs and their status.`
 };
@@ -3814,6 +3893,7 @@ var run2 = async (argv) => {
           quality: typeof flags.quality === "string" ? flags.quality : void 0,
           scale: numberFlag(flags, "scale"),
           format: typeof flags.format === "string" ? flags.format : void 0,
+          audio: flags["no-audio"] === true ? false : void 0,
           skipUnchangedFrames: flags["no-frame-skip"] === true ? false : void 0,
           retry: typeof flags.retry === "string" ? flags.retry : void 0
         });
@@ -3827,6 +3907,11 @@ var run2 = async (argv) => {
         log.info(HELP);
         return 0;
       default: {
+        const renamed = RENAMED[command2];
+        if (renamed) {
+          log.error(`"odori ${command2}" is now "odori ${renamed}".`);
+          return 1;
+        }
         const commands = Object.keys(COMMAND_FLAGS).filter((name) => name !== "help");
         const suggestion = nearest(command2, commands);
         log.error(`Unknown command "${command2}".${suggestion ? ` Did you mean "odori ${suggestion}"?` : ""}`);

package/dist/cli.js

@@ -2,7 +2,7 @@ import {
   checkFlags,
   parseArgs,
   run
-} from "./chunk-NYXWEZU2.js";
+} from "./chunk-6CE7U5KB.js";
 export {
   checkFlags,
   parseArgs,

package/dist/index.d.ts

@@ -290,6 +290,13 @@ type RenderOptions = {
     /** Container and codec. Defaults to H.264 in MP4. */
     format?: VideoFormat;
     skipUnchangedFrames?: boolean;
+    /**
+     * Mix the composition's cues into the file. Defaults to true, because the
+     * score is part of the video. Set false for a silent cut: a loop for a
+     * landing page, a clip going into an editor that has its own audio, or a
+     * reviewer who just wants the picture.
+     */
+    audio?: boolean;
     /** Reuse encoded chunks whose frames still look identical. */
     cache?: boolean;
     signal?: AbortSignal;
@@ -337,6 +344,7 @@ type JobRender = {
     quality?: string;
     scale?: number;
     preset?: string;
+    audio?: boolean;
 };
 type JobRecord = {
     job: ExportJob;
@@ -538,6 +546,7 @@ declare const runJob: (config: ResolvedConfig, origin: string, record: JobRecord
     quality?: Quality;
     scale?: number;
     format?: VideoFormat;
+    audio?: boolean;
     skipUnchangedFrames?: boolean;
     signal?: AbortSignal;
     onProgress?: (job: ExportJob) => void;
@@ -550,6 +559,8 @@ declare const exportCommand: (id: string, options?: {
     quality?: string;
     scale?: number;
     format?: string;
+    /** False writes the picture with no audio track. */
+    audio?: boolean;
     skipUnchangedFrames?: boolean;
     retry?: string;
 }) => Promise<ExportJob>;

package/dist/index.js

@@ -75,7 +75,7 @@ import {
   withServer,
   writeGenerated,
   writePrepareCache
-} from "./chunk-NYXWEZU2.js";
+} from "./chunk-6CE7U5KB.js";
 export {
   CHROME_BUILD,
   FORMATS,