@vosjs/cli 0.10.1 → 0.11.0

package/dist/{chunk-CJPWZVHQ.js → chunk-3W3XD6HL.js}

@@ -1609,30 +1609,107 @@ async function renderAnimation(browser, opts) {
   }
 }
 
-// src/plugin/docOverride.ts
+// src/plugin/backdrops.ts
+async function fetchBackdropSet(origin) {
+  const base = origin.replace(/\/+$/, "");
+  const res = await fetch(`${base}/api/backdrops`);
+  if (!res.ok)
+    throw new Error(`GET ${base}/api/backdrops answered ${res.status}`);
+  const body = await res.json();
+  return Array.isArray(body.backdrops) ? body.backdrops : [];
+}
+function rowBackdrop(row) {
+  const key = row.urls["1080p"];
+  if (!key) return null;
+  return {
+    slug: row.slug,
+    key,
+    kind: "video",
+    duration: row.duration,
+    ...row.urls.poster ? { poster: row.urls.poster } : {},
+    ...row.ground ? { ground: row.ground } : {}
+  };
+}
+function houseBackdrop(rows) {
+  for (const row of rows) {
+    const b = rowBackdrop(row);
+    if (b) return b;
+  }
+  return null;
+}
+function backdropBySlug(rows, slug) {
+  const row = rows.find((r) => r.slug === slug);
+  return row ? rowBackdrop(row) : null;
+}
 function isBackdropSlug(value) {
   return /^[a-z0-9][a-z0-9-]{0,49}$/.test(value) && value !== "none";
 }
+var VIDEO_EXT = /\.(webm|mp4|mov|m4v)(\?|#|$)/i;
+var IMAGE_EXT = /\.(jpe?g|png|webp|gif|avif)(\?|#|$)/i;
+function inferBackgroundKind(url) {
+  if (IMAGE_EXT.test(url)) return "image";
+  if (VIDEO_EXT.test(url)) return "video";
+  return "video";
+}
+var BACKGROUND_DEFAULT_DURATION = 10;
+function backdropFromKey(key, duration) {
+  const kind = inferBackgroundKind(key);
+  return kind === "video" ? { key, kind, duration: duration ?? BACKGROUND_DEFAULT_DURATION } : { key, kind };
+}
+async function openingBackdrop(background, origin) {
+  if (background === "none" || background === "") return { backdrop: null };
+  if (background !== void 0 && !isBackdropSlug(background)) {
+    return { backdrop: backdropFromKey(background) };
+  }
+  let rows;
+  try {
+    rows = await fetchBackdropSet(origin);
+  } catch (err) {
+    if (background !== void 0) {
+      throw new UsageError(
+        `--background "${background}" \u2014 could not read the backdrop set from ${origin}/api/backdrops (${err.message}); pass a URL instead`
+      );
+    }
+    return {
+      backdrop: null,
+      note: `could not read the backdrop set from ${origin}/api/backdrops; the take opens on a flat ground (--background <slug|url> picks one later)`
+    };
+  }
+  if (background !== void 0) {
+    const hit = backdropBySlug(rows, background);
+    if (!hit) {
+      throw new UsageError(
+        `--background "${background}" is not in the set (${rows.map((b) => b.slug).join(" | ") || "empty"}); GET ${origin}/api/backdrops lists it, or pass a URL`
+      );
+    }
+    return { backdrop: hit };
+  }
+  const house = houseBackdrop(rows);
+  return house ? { backdrop: house } : {
+    backdrop: null,
+    note: `the backdrop set at ${origin}/api/backdrops has no ready loop; the take opens on a flat ground`
+  };
+}
+
+// src/plugin/docOverride.ts
 async function resolveBackdropSlug(o) {
   if (!o.background || !isBackdropSlug(o.background)) return;
   const origin = (o.origin ?? "https://vos.so").replace(/\/+$/, "");
-  let list = [];
+  let list;
   try {
-    const res = await fetch(`${origin}/api/backdrops`);
-    if (res.ok)
-      list = (await res.json()).backdrops;
+    list = await fetchBackdropSet(origin);
   } catch {
     throw new UsageError(
       `--background "${o.background}" \u2014 could not read the backdrop set from ${origin}/api/backdrops; pass a URL instead`
     );
   }
-  const hit = list.find((b) => b.slug === o.background && b.urls["1080p"]);
-  if (!hit?.urls["1080p"]) {
+  const hit = backdropBySlug(list, o.background);
+  if (!hit) {
     throw new UsageError(
       `--background "${o.background}" is not in the set (${list.map((b) => b.slug).join(" | ") || "empty"}); GET ${origin}/api/backdrops lists it, or pass a URL`
     );
   }
-  o.background = hit.urls["1080p"];
+  o.background = hit.key;
   o.backgroundDuration = hit.duration;
 }
 function hasOverrides(o) {
@@ -1650,9 +1727,6 @@ var FRAME_KINDS = {
   none: "none",
   hidden: "none"
 };
-var BACKGROUND_DEFAULT_DURATION = 10;
-var VIDEO_EXT = /\.(webm|mp4|mov|m4v)(\?|#|$)/i;
-var IMAGE_EXT = /\.(jpe?g|png|webp|gif|avif)(\?|#|$)/i;
 function coerceValue(raw) {
   try {
     return JSON.parse(raw);
@@ -1712,11 +1786,6 @@ function setPath(root, path, value) {
   ;
   node[segs[segs.length - 1].key] = value;
 }
-function inferBackgroundKind(url) {
-  if (IMAGE_EXT.test(url)) return "image";
-  if (VIDEO_EXT.test(url)) return "video";
-  return "video";
-}
 function applyDocOverrides(doc, o) {
   const applied = [];
   const d = doc;
@@ -3673,12 +3742,14 @@ import { existsSync as existsSync6 } from "fs";
 import { readFile as readFile6 } from "fs/promises";
 import { join as join9 } from "path";
 import {
+  DEFAULT_FRAME_STYLE,
   STYLE_FIELDS,
   copyStyle,
   isRejected,
   planAutoSpeed,
   planAutoZoom,
-  projectFromArtifact
+  projectFromArtifact,
+  withBackdrop
 } from "@vosjs/studio-core";
 
 // src/plugin/reuse.ts
@@ -3875,6 +3946,7 @@ async function planTake(dir, opts = {}) {
   const take = await loadTake(dir);
   const { meta, cursor } = take;
   const activity = await readDigestActivity(dir);
+  const ingest = opts.backdrop ? { frame: withBackdrop(DEFAULT_FRAME_STYLE, opts.backdrop) } : {};
   let doc;
   let fresh;
   if (opts.reuse) {
@@ -3884,7 +3956,7 @@ async function planTake(dir, opts = {}) {
       cursor,
       meta
     };
-    doc = projectFromArtifact(artifact, RECORDING_NAME).doc;
+    doc = projectFromArtifact(artifact, RECORDING_NAME, ingest).doc;
     doc = copyStyle(prev, doc);
     const rt = retimeCut(prev, meta.steps ?? [], meta.durationMs);
     doc.segments = rt.segments;
@@ -3943,7 +4015,7 @@ async function planTake(dir, opts = {}) {
       cursor,
       meta
     };
-    doc = projectFromArtifact(artifact, RECORDING_NAME).doc;
+    doc = projectFromArtifact(artifact, RECORDING_NAME, ingest).doc;
     if (opts.style) doc = copyStyle(opts.style.doc, doc);
     doc.zoom = planAutoZoom(doc.source.cursor, {
       width: doc.source.meta.width,
@@ -3965,6 +4037,7 @@ async function planTake(dir, opts = {}) {
     zoomManual: doc.zoom.filter((z) => z.source === "manual").length,
     cursorKept: doc.source.cursor.length > 0,
     fresh,
+    ...opts.backdrop ? { backdrop: doc.frame.backgroundMedia?.key ?? "none" } : {},
     ...opts.style ? {
       styleFrom: opts.style.from,
       styleFields: STYLE_FIELDS.filter(
@@ -6394,9 +6467,9 @@ var MULTI_FLAGS2 = /* @__PURE__ */ new Set(["set", "override"]);
 var HELP = `vos \u2014 record a browser flow, plan effects, render a product video; sync with vos.so
 
 Take pipeline
-  vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--max-duration <s>] [render flags] [--json]
-  vos record --actions actions.json [--url <url>] [--out take] [--strict] [--max-duration <s>] [--json]
-  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--json]
+  vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--max-duration <s>] [--background <slug|url|none>] [render flags] [--json]
+  vos record --actions actions.json [--url <url>] [--out take] [--strict] [--max-duration <s>] [--background <slug|url|none>] [--json]
+  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--background <slug|url|none>] [--json]
   vos render <take> [out.webm] [--width] [--height] [--fps] [--format webm|mp4] [--parallel N] [--range a..b] [--draft] [--frame <kind>] [--background <url|slug>] [--set <path=value>]... [--json]
   vos frames <take> [--times 0,25%,50%,75%,100%] [--frame <t>] [--at-zooms] [--at-moments] [--size WxH] [--out dir] [--background <url|slug>] [--set <path=value>]... [--json]
   vos deliver <take> --to cws,producthunt,x,linkedin,og,github,youtube (or all) [--poster <config.json|vosId>] [--shot-time <t>] [--poster-time <t>] [--composed] [--set path=value] [--release v2.1] [--out dir] [--times a,b] [--range a..b] [--parallel N] [--json]
@@ -6563,7 +6636,9 @@ lint-gated, so a bad override fails like a bad doc.json):
                        --set frame.padding=120 --set frame.browserBar.kind=mac-light)
   --frame <kind>       (render) browser frame: macos|mac-dark|windows|windows-dark|minimal|none
   --background <url|slug>  background media: a URL (kind inferred), or a backdrop slug from GET /api/backdrops
-                       (.webm/.mp4 = video @10s loop, image otherwise); "none" clears
+                       (.webm/.mp4 = video @10s loop, image otherwise); "none" clears.
+                       On create/record/plan it is the frame a FRESH take opens on; absent, the set's
+                       first ready loop (the house backdrop the studio opens on), or a flat ground offline
 `;
 async function loadActions(file) {
   const raw = JSON.parse(await readFile9(file, "utf8"));
@@ -6584,6 +6659,17 @@ function strictReason(rec) {
   if (rec.capped) parts.push("stopped at --max-duration");
   return parts.join(" + ");
 }
+async function takeBackdrop(flags, r) {
+  const { backdrop, note } = await openingBackdrop(
+    strFlag(flags, "background"),
+    platformOrigin({
+      origin: strFlag(flags, "origin"),
+      api: strFlag(flags, "api")
+    })
+  );
+  if (note) r.log(`note: ${note}`);
+  return backdrop;
+}
 async function cmdRecord(argv) {
   const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS5);
   const actionsPath = strFlag(flags, "actions") ?? positionals[0];
@@ -6597,6 +6683,7 @@ async function cmdRecord(argv) {
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
   const outDir = resolve6(strFlag(flags, "out") ?? "take");
+  const backdrop = await takeBackdrop(flags, r);
   if (existsSync10(join14(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
@@ -6620,7 +6707,7 @@ async function cmdRecord(argv) {
       (p) => r.event({ event: "progress", phase: "encode", fraction: p })
     );
     r.event({ event: "phase", phase: "plan" });
-    const plan = await planTake(outDir);
+    const plan = await planTake(outDir, { backdrop });
     const clicks = rec.events.filter((e) => e.type === "down").length;
     const strict = flags.strict === true;
     const strictFail = strict && (rec.skipped.length > 0 || rec.navTimeout || rec.capped);
@@ -6678,6 +6765,7 @@ async function cmdCreate2(argv) {
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
   }
+  const backdrop = await takeBackdrop(flags, r);
   if (existsSync10(join14(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
@@ -6701,7 +6789,7 @@ async function cmdCreate2(argv) {
       (p) => r.event({ event: "progress", phase: "encode", fraction: p })
     );
     r.event({ event: "phase", phase: "plan" });
-    await planTake(outDir);
+    await planTake(outDir, { backdrop });
     if (flags.strict === true && (rec.skipped.length > 0 || rec.navTimeout || rec.capped)) {
       r.done(
         {
@@ -6782,9 +6870,11 @@ async function cmdPlan(argv) {
     };
   }
   const style = await resolveStyleRef(flags);
+  const backdrop = existsSync10(join14(dir, "doc.json")) ? null : await takeBackdrop(flags, r);
   const s = await planTake(dir, {
     ...style ? { style } : {},
-    ...reuse ? { reuse } : {}
+    ...reuse ? { reuse } : {},
+    backdrop
   });
   const reuseLines = s.reuse ? `
   reused ${s.reuse.from}: ${s.reuse.anchored} anchored + ${s.reuse.mapped} mapped span(s)` + (s.reuse.flagged.length ? `
@@ -6798,6 +6888,7 @@ async function cmdPlan(argv) {
       zoomAuto: s.zoomAuto,
       zoomManual: s.zoomManual,
       duration: s.doc.source.meta.durationMs / 1e3,
+      ...s.backdrop !== void 0 ? { backdrop: s.backdrop } : {},
       ...s.styleFrom ? { styleFrom: s.styleFrom, styleFields: s.styleFields } : {},
       ...s.reuse ? { reuse: s.reuse } : {}
     },
@@ -7474,4 +7565,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-CJPWZVHQ.js.map
+//# sourceMappingURL=chunk-3W3XD6HL.js.map