hyperframes 0.8.111 → 0.8.113

package/dist/cli.js

@@ -8,6 +8,9 @@ var __dirname = __hf_dirname(__filename);
 import {
   registerRunningCli
 } from "./chunk-NXMYHJAL.js";
+import {
+  isTextFile
+} from "./chunk-K4WKGXRC.js";
 import {
   isRenderSucceeded
 } from "./chunk-L3YOGIPG.js";
@@ -31,7 +34,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-YLOSZHA2.js";
+} from "./chunk-3XPZJUKM.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/cli.ts
@@ -39,6 +42,66 @@ import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { existsSync } from "fs";
 
+// src/utils/reject-extra-positionals.ts
+var ACCEPTS_EXTRA_POSITIONALS = /* @__PURE__ */ new Set([
+  "compare",
+  "figma asset",
+  "skills update",
+  "timeline set"
+]);
+var JOINS_EXTRA_POSITIONALS = /* @__PURE__ */ new Set(["catalog", "tts"]);
+var EXTRA_POSITIONAL_HINTS = {
+  add: "Run add once per item, or pass a single tag to install every item tagged with it."
+};
+function wantsJson(value) {
+  return value === true || typeof value === "string" && value !== "false" && value !== "0";
+}
+function declaredArgs(cmd) {
+  const raw = cmd.args;
+  return raw && typeof raw === "object" ? raw : {};
+}
+function usageLine(path, args) {
+  const parts = ["hyperframes", path];
+  let hasOptions = false;
+  for (const [name, def] of Object.entries(args)) {
+    if (def.type !== "positional") {
+      hasOptions = true;
+      continue;
+    }
+    const optional = def.required === false || def.default !== void 0;
+    parts.push(optional ? `[${name.toUpperCase()}]` : `<${name.toUpperCase()}>`);
+  }
+  if (hasOptions) parts.push("[OPTIONS]");
+  return parts.join(" ");
+}
+function resolveExtraPositionals(cmd, path, parsed) {
+  if (ACCEPTS_EXTRA_POSITIONALS.has(path)) return;
+  const args = declaredArgs(cmd);
+  const positionals = Object.entries(args).filter(([, def]) => def.type === "positional");
+  const given = (Array.isArray(parsed?._) ? parsed._ : []).map(String);
+  const extra = given.slice(positionals.length);
+  if (extra.length === 0) return;
+  const last = positionals.at(-1)?.[0];
+  const words = given.slice(positionals.length - 1);
+  const ttsFile = path === "tts" && isTextFile(words[0]);
+  if (parsed && last && JOINS_EXTRA_POSITIONALS.has(path) && !ttsFile) {
+    parsed[last] = words.join(" ");
+    return;
+  }
+  const plural = extra.length === 1 ? "" : "s";
+  const message = `Unexpected extra argument${plural} for hyperframes ${path}: ${extra.join(", ")}
+Usage: ${usageLine(path, args)}` + (EXTRA_POSITIONAL_HINTS[path] ? `
+${EXTRA_POSITIONAL_HINTS[path]}` : "");
+  if (wantsJson(parsed?.json)) console.log(JSON.stringify({ ok: false, error: message }));
+  else console.error(message);
+  throw new CliUsageError(
+    `${extra.length} unexpected extra argument${plural} for hyperframes ${path}`,
+    {
+      presented: true
+    }
+  );
+}
+
 // src/utils/reject-unknown-flags.ts
 var ALWAYS_KNOWN = /* @__PURE__ */ new Set(["help", "h", "version", "v", "json"]);
 function nameVariants(name) {
@@ -85,9 +148,13 @@ function assertKnownFlags(cmd, rawArgs) {
 
 // src/utils/command-failure-tracking.ts
 function trackCommandFailures(load) {
-  return () => load().then((cmd) => wrapCommand(cmd));
+  return () => load().then((cmd) => wrapCommand(cmd, commandName(cmd)));
+}
+function commandName(cmd) {
+  const name = cmd.meta?.name;
+  return typeof name === "string" ? name : "";
 }
-function wrapCommand(cmd) {
+function wrapCommand(cmd, path) {
   const run = cmd.run;
   if (typeof run !== "function" && !cmd.subCommands) return cmd;
   const wrapped = { ...cmd };
@@ -97,6 +164,7 @@ function wrapCommand(cmd) {
       const firstPositional = rawArgs.find((tok) => tok && !tok.startsWith("-"));
       const delegatesToSub = cmd.subCommands != null && firstPositional != null && Object.prototype.hasOwnProperty.call(cmd.subCommands, firstPositional);
       if (!delegatesToSub) assertKnownFlags(cmd, rawArgs);
+      if (!cmd.subCommands) resolveExtraPositionals(cmd, path, ctx?.args);
       return await run(ctx);
     };
   }
@@ -104,7 +172,7 @@ function wrapCommand(cmd) {
     const wrappedSubs = {};
     for (const [name, sub] of Object.entries(cmd.subCommands)) {
       wrappedSubs[name] = () => Promise.resolve(typeof sub === "function" ? sub() : sub).then(
-        (c) => wrapCommand(c)
+        (c) => wrapCommand(c, `${path} ${name}`)
       );
     }
     wrapped.subCommands = wrappedSubs;
@@ -113,7 +181,7 @@ function wrapCommand(cmd) {
 }
 async function reportCommandFailure(command2, err) {
   try {
-    const { trackCommandFailure } = await import("./events-NP666TF4.js");
+    const { trackCommandFailure } = await import("./events-3HUO73ZE.js");
     trackCommandFailure(command2, err);
   } catch {
   }
@@ -203,51 +271,51 @@ async function assertStudioWorkspaceBuilt() {
   });
 }
 var commandLoaders = {
-  init: () => import("./init-IGW4DTVC.js").then((m) => m.default),
-  add: () => import("./add-M5WN2AM2.js").then((m) => m.default),
-  catalog: () => import("./catalog-23DP7KCW.js").then((m) => m.default),
+  init: () => import("./init-RXA6NI73.js").then((m) => m.default),
+  add: () => import("./add-ILIGSLV4.js").then((m) => m.default),
+  catalog: () => import("./catalog-3QDMTDK2.js").then((m) => m.default),
   "media-use": () => import("./media-use-4XXGABIL.js").then((m) => m.default),
-  play: () => import("./play-D4AHRZQD.js").then((m) => m.default),
-  present: () => import("./present-VUH7PLOO.js").then((m) => m.default),
-  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-NCFC65VR.js").then((m) => m.default)),
-  publish: () => import("./publish-257VZMWI.js").then((m) => m.default),
-  render: () => import("./render-DKXGFQVW.js").then((m) => m.default),
-  lint: () => import("./lint-LLGMCVZ5.js").then((m) => m.default),
-  check: () => import("./check-5X6BJA2P.js").then((m) => m.default),
-  beats: () => import("./beats-GXY5ZBPB.js").then((m) => m.default),
-  "normalize-audio": () => import("./normalize-audio-4LHYKFON.js").then((m) => m.default),
-  inspect: () => import("./inspect-D4GUGDW7.js").then((m) => m.default),
-  keyframes: () => import("./keyframes-CXZLEC3R.js").then((m) => m.default),
-  layout: () => import("./layout-XEDEOLAH.js").then((m) => m.default),
-  info: () => import("./info-FO7VR5NC.js").then((m) => m.default),
-  compositions: () => import("./compositions-OPU6U6GM.js").then((m) => m.default),
-  timeline: () => import("./timeline-7C4KM3KD.js").then((m) => m.default),
-  history: () => import("./history-FNRU3TL4.js").then((m) => m.default),
-  benchmark: () => import("./benchmark-MJFVBVNW.js").then((m) => m.default),
-  browser: () => import("./browser-ZDI7IX6H.js").then((m) => m.default),
-  "remove-background": () => import("./remove-background-EV6XVADN.js").then((m) => m.default),
-  transcribe: () => import("./transcribe-TGR5CTA7.js").then((m) => m.default),
-  models: () => import("./models-RILNQV3Z.js").then((m) => m.default),
-  tts: () => import("./tts-DO2W6NLB.js").then((m) => m.default),
+  play: () => import("./play-PHHXYCQI.js").then((m) => m.default),
+  present: () => import("./present-KBFK2YVB.js").then((m) => m.default),
+  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-T3E5TFDC.js").then((m) => m.default)),
+  publish: () => import("./publish-ZGKT7KED.js").then((m) => m.default),
+  render: () => import("./render-OKNPNMFS.js").then((m) => m.default),
+  lint: () => import("./lint-ATVNZ6FG.js").then((m) => m.default),
+  check: () => import("./check-O3RR4NWI.js").then((m) => m.default),
+  beats: () => import("./beats-YEYVQMX6.js").then((m) => m.default),
+  "normalize-audio": () => import("./normalize-audio-K33FKGAF.js").then((m) => m.default),
+  inspect: () => import("./inspect-2S5GAZYC.js").then((m) => m.default),
+  keyframes: () => import("./keyframes-WBMAX7XZ.js").then((m) => m.default),
+  layout: () => import("./layout-ZRU7PXBG.js").then((m) => m.default),
+  info: () => import("./info-26GTDTKN.js").then((m) => m.default),
+  compositions: () => import("./compositions-5UA33RSG.js").then((m) => m.default),
+  timeline: () => import("./timeline-N5UKVS2S.js").then((m) => m.default),
+  history: () => import("./history-DFJNDM2T.js").then((m) => m.default),
+  benchmark: () => import("./benchmark-J2V46VWI.js").then((m) => m.default),
+  browser: () => import("./browser-XBWASLD2.js").then((m) => m.default),
+  "remove-background": () => import("./remove-background-4LRTT6YL.js").then((m) => m.default),
+  transcribe: () => import("./transcribe-IP74EZLM.js").then((m) => m.default),
+  models: () => import("./models-JF5OOZ5A.js").then((m) => m.default),
+  tts: () => import("./tts-P3LIPIL5.js").then((m) => m.default),
   docs: () => import("./docs-QAPJEGLS.js").then((m) => m.default),
-  doctor: () => import("./doctor-EIVBJJAF.js").then((m) => m.default),
-  clean: () => import("./clean-ATMEGSGP.js").then((m) => m.default),
-  upgrade: () => import("./upgrade-V6E5P53C.js").then((m) => m.default),
-  skills: () => import("./skills-2BGFBUR6.js").then((m) => m.default),
-  feedback: () => import("./feedback-4OSLMKBW.js").then((m) => m.default),
+  doctor: () => import("./doctor-TSAQGYP4.js").then((m) => m.default),
+  clean: () => import("./clean-RPB34TT6.js").then((m) => m.default),
+  upgrade: () => import("./upgrade-A4M3O2F2.js").then((m) => m.default),
+  skills: () => import("./skills-O25ZTFTO.js").then((m) => m.default),
+  feedback: () => import("./feedback-42OTOFC6.js").then((m) => m.default),
   telemetry: () => import("./telemetry-2YC4SGQU.js").then((m) => m.default),
-  events: () => import("./events-ISMT4RDW.js").then((m) => m.default),
-  validate: () => import("./validate-INP7WJAK.js").then((m) => m.default),
-  snapshot: () => import("./snapshot-Z37DZL4T.js").then((m) => m.default),
-  "media-treatment": () => import("./media-treatment-OYTNU6PX.js").then((m) => m.mediaTreatmentCommand),
-  "grade-compare": () => import("./grade-compare-B2EHEOLR.js").then((m) => m.default),
-  compare: () => import("./compare-55LEUY7M.js").then((m) => m.default),
-  capture: () => import("./capture-OG6532RA.js").then((m) => m.default),
-  lambda: () => import("./lambda-BFHJMMCG.js").then((m) => m.default),
-  cloudrun: () => import("./cloudrun-LVZ4OPPC.js").then((m) => m.default),
-  cloud: () => import("./cloud-ZFGUHACY.js").then((m) => m.default),
-  auth: () => import("./auth-3YMEVUKJ.js").then((m) => m.default),
-  figma: () => import("./figma-Y7ZHFCOU.js").then((m) => m.default)
+  events: () => import("./events-SZ5NWYWD.js").then((m) => m.default),
+  validate: () => import("./validate-DV75GM6J.js").then((m) => m.default),
+  snapshot: () => import("./snapshot-KGM2HZIC.js").then((m) => m.default),
+  "media-treatment": () => import("./media-treatment-L43MVH2V.js").then((m) => m.mediaTreatmentCommand),
+  "grade-compare": () => import("./grade-compare-KGJP5HV7.js").then((m) => m.default),
+  compare: () => import("./compare-PF6WHQ4T.js").then((m) => m.default),
+  capture: () => import("./capture-GLHK4ST7.js").then((m) => m.default),
+  lambda: () => import("./lambda-OQBFCEFA.js").then((m) => m.default),
+  cloudrun: () => import("./cloudrun-BML6ZG7K.js").then((m) => m.default),
+  cloud: () => import("./cloud-QECFFPKC.js").then((m) => m.default),
+  auth: () => import("./auth-5JDDEX2M.js").then((m) => m.default),
+  figma: () => import("./figma-RYNFCYXB.js").then((m) => m.default)
 };
 var subCommands = Object.fromEntries(
   Object.entries(commandLoaders).map(([name, load]) => [name, trackCommandFailures(load)])
@@ -271,7 +339,7 @@ var _printStalePinNotice;
 var _printSkillsUpdateNotice;
 var telemetryReady = Promise.resolve();
 if (!isHelp && command !== "telemetry" && command !== "events" && command !== "unknown") {
-  telemetryReady = import("./telemetry-NLEEMXO2.js").then((mod) => {
+  telemetryReady = import("./telemetry-R3BPD6VK.js").then((mod) => {
     _flushSync = mod.flushSync;
     _trackCliError = mod.trackCliError;
     _trackCommandResult = mod.trackCommandResult;
@@ -281,23 +349,23 @@ if (!isHelp && command !== "telemetry" && command !== "events" && command !== "u
   });
 }
 if (!isHelp && !hasJsonFlag && command !== "upgrade" && command !== "events" && command !== "telemetry" && command !== "skills") {
-  import("./autoUpdate-FYCGHBPC.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
+  import("./autoUpdate-JXVZVJCV.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
   });
-  import("./updateCheck-73JM5QR3.js").then(async (mod) => {
+  import("./updateCheck-EXHNAPKI.js").then(async (mod) => {
     _printUpdateNotice = mod.printUpdateNotice;
     _printStalePinNotice = mod.printStalePinNotice;
     const result = mod.cachedUpdateCheck();
     if (result.updateAvailable) {
-      const auto = await import("./autoUpdate-FYCGHBPC.js").catch(() => null);
+      const auto = await import("./autoUpdate-JXVZVJCV.js").catch(() => null);
       auto?.scheduleBackgroundInstall(result.latest, result.current);
     }
   }).catch(() => {
   });
-  import("./skillsUpdateCheck-5LYFYHUF.js").then((mod) => {
+  import("./skillsUpdateCheck-Y2V4OMMT.js").then((mod) => {
     _printSkillsUpdateNotice = mod.printSkillsUpdateNotice;
   }).catch(() => {
   });
-  import("./backgroundChecks-ZLYIRMTS.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
+  import("./backgroundChecks-BBWGY3V6.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
   });
 }
 var commandStart = Date.now();
@@ -406,7 +474,7 @@ process.on("unhandledRejection", (reason) => {
   emitCliErrorEvent("unhandled_rejection", error);
 });
 async function showUsage(cmd, parent) {
-  const { showUsage: impl } = await import("./help-ISGUWGOR.js");
+  const { showUsage: impl } = await import("./help-C5HS56RZ.js");
   return impl(cmd, parent);
 }
 async function showRequestedUsage() {

package/dist/{cloud-ZFGUHACY.js → cloud-QECFFPKC.js}

@@ -55,10 +55,10 @@ ${c.bold("AUTH:")}
 var cloud_default = defineCommand({
   meta: { name: "cloud", description: "Render HyperFrames compositions on the HeyGen cloud" },
   subCommands: {
-    render: () => import("./render-DHCMWKFV.js").then((m) => m.default),
-    list: () => import("./list-LUCWSLK6.js").then((m) => m.default),
-    get: () => import("./get-E4GBRHQK.js").then((m) => m.default),
-    delete: () => import("./delete-PJE4P3HH.js").then((m) => m.default)
+    render: () => import("./render-H6RSJF2V.js").then((m) => m.default),
+    list: () => import("./list-E2GHYPCQ.js").then((m) => m.default),
+    get: () => import("./get-IRHLG5OQ.js").then((m) => m.default),
+    delete: () => import("./delete-SARS5LIK.js").then((m) => m.default)
   },
   async run({ args }) {
     if (!args._?.[0]) console.log(HELP);

package/dist/{cloudrun-LVZ4OPPC.js → cloudrun-BML6ZG7K.js}

@@ -11,7 +11,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-CFC3EEDQ.js";
+} from "./chunk-ZMMSMDCA.js";
 import {
   readAllowedCompositionFpsFromDir
 } from "./chunk-YEIFI443.js";
@@ -26,10 +26,10 @@ import {
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-B25H4M4V.js";
+import "./chunk-FCEFKWPM.js";
 import "./chunk-UUDQD62L.js";
 import "./chunk-DPVXBVLL.js";
-import "./chunk-YLVI7VL5.js";
+import "./chunk-C6AIZOQN.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-TQFG7HTI.js";