@vosjs/cli 0.26.0 → 0.27.0

package/README.md

@@ -89,7 +89,7 @@ vos plan take --reuse                                   # re-time that cut onto
 
 **Digest first.** `vos digest <take>` is how an agent sees a recording without reading the video. It writes `digest/digest.json`: one moment per thing the cursor track says mattered (click clusters, typing sessions, scroll runs, dwells, idle gaps, head, tail, and frame-diff scene changes), each with source and output extents, a normalized `focus` and `rect` you can copy into a zoom span, per-second `activity`, and the planners' `proposed` span ids; plus one footage frame and a crop around the target per moment, and `sheet.png`, the contact sheet. Read the JSON, then the sheet, then a crop only where you must decide. `vos validate` then warns when a zoom does not contain what was clicked under it, and `vos frames --at-moments` renders the composed output at every moment so a still and its footage crop share an id.
 
-**Many media in one take (concat).** `doc.json` may carry `media: [{ id, videoKey, cursor, meta, … }]`, the take's OTHER recordings or uploads, each the `source` shape with an `id`; a segment on one (`{ in, out, media: "m1" }`) plays it, and a zoom, tilt, speed, freeze or cam-move span names the media its source seconds belong to (absent = the primary, `source`). The Video row shows the clips in order, a span is drawn where its media plays, `vos plan` proposes zoom and speed spans on every media from its own cursor track, `vos validate` measures each span against its own media's length, and `vos push` and `vos pull --media` carry every media through the recording door. A media wears its OWN card: `media[].frame` carries the card-owned fields (its placement and size as `inset`, the browser bar, the corner, the shadow, the border, the cover fit and its focus) over the take's frame while it plays; the bar names that media's recorded page, an upload with no page wears none, and the frame-wide fields (the aspect, the padding, the ground, the backdrop, the card's animation) stay the take's. Sound: the primary's tracks play at the primary's moments; another media's own audio is not spliced into the cut yet.
+**Many media in one take (concat).** `doc.json` may carry `media: [{ id, videoKey, cursor, meta, … }]`, the take's OTHER recordings or uploads, each the `source` shape with an `id`; a segment on one (`{ in, out, media: "m1" }`) plays it, and a zoom, tilt, speed, freeze or cam-move span names the media its source seconds belong to (absent = the primary, `source`). The Video row shows the clips in order, a span is drawn where its media plays, `vos plan` proposes zoom and speed spans on every media from its own cursor track, `vos validate` measures each span against its own media's length, and `vos push` and `vos pull --media` carry every media through the recording door. A media wears its OWN card: `media[].frame` carries the card-owned fields (its placement and size as `inset`, the browser bar, the corner, the shadow, the border, the cover fit and its focus) over the take's frame while it plays; the bar names that media's recorded page, an upload with no page wears none, and the frame-wide fields (the aspect, the padding, the ground, the backdrop, the card's animation) stay the take's. Sound: the primary's tracks play at the primary's moments; another media's own audio is not spliced into the cut yet. **Many cards**: an image or video overlay may show a document media by reference (`key: "media:<id>"`, `media:` alone the primary; its cursor track and recorded page come with it) and wear a card (`frame`: `browserBar`, a `lean` `{rx, ry}` in degrees, `shadow`, `shadowContact`, `shadowColor`, `cursor`), drawn by the card painter on its own plane above the primary card with the media's cursor dot and click rings inside it; a layer without `frame` stays the flat picture. The primary card stays primary: the sequence, the camera and the cut are its.
 
 **A series shares its look by data.** `vos plan <take> --style <seed doc.json | vosId>` copies the seed's `zoomStyle`, `zoomParams`, `speedParams`, `tiltStyle`, `frame`, `cursor`, `cam` and `export` onto a new take (never its spans, overlays or audio) and re-plans the automatic spans under them. A seed that is a POSTER carries its layout too: its card placement, its `stage-*` clips by id (with the release's words from LAUNCH.md's `headline` and `kicker` roles, BRAND.md's `wordmark`, or `--headline` and `--kicker` patched in; the brand's mark from BRAND.md `logoUrl` fetched into `<take>/brand/` for `stage-mark`), its rest lean, its trailing freeze. What could not follow is said in words.
 

package/dist/{chunk-I3UUIBSH.js → chunk-IJ5A4TL3.js}

@@ -988,6 +988,39 @@ function lintDoc(docIn) {
       if (o.fx !== void 0) {
         problems.push(`${name}.fx is text-only (media clips have enter/exit)`);
       }
+      if (typeof o.key === "string" && o.key.startsWith("media:")) {
+        const ref = o.key.slice("media:".length);
+        const ids = new Set(
+          (Array.isArray(doc.media) ? doc.media : []).map((m) => typeof m.id === "string" ? m.id : "")
+        );
+        if (ref !== "" && !ids.has(ref))
+          problems.push(
+            `${name}.key names media "${ref}", which is not one of media[].id (media: alone is the primary)`
+          );
+      }
+      const lcf = o.frame;
+      if (lcf !== void 0) {
+        if (!isObj(lcf)) {
+          problems.push(`${name}.frame must be an object (the layer's card)`);
+        } else {
+          const LCF = [
+            "browserBar",
+            "lean",
+            "shadow",
+            "shadowContact",
+            "shadowColor",
+            "cursor"
+          ];
+          for (const k of Object.keys(lcf))
+            if (!LCF.includes(k))
+              problems.push(
+                `${name}.frame.${k}: not a layer card field (${LCF.join(", ")})`
+              );
+          const lean = lcf.lean;
+          if (lean !== void 0 && (!isObj(lean) || !isNum(lean.rx) || !isNum(lean.ry)))
+            problems.push(`${name}.frame.lean must be { rx, ry } in degrees`);
+        }
+      }
       if (typeof o.key !== "string" || o.key.length === 0) {
         problems.push(
           `${name}.key must be a non-empty media URL or take-dir file (e.g. "/logo.png")`
@@ -6381,7 +6414,7 @@ var KEYS = [
   { key: "camKey", file: CAM_NAME }
 ];
 function isTakeRelativeKey(key) {
-  return !!key && !/^(https?:|blob:|data:|\/\/)/.test(key) && !key.startsWith("/api/");
+  return !!key && !/^(https?:|blob:|data:|media:|\/\/)/.test(key) && !key.startsWith("/api/");
 }
 var takeRelativeFile = (key) => key.replace(/^\/+/, "");
 function docMediaRefs(doc, keep = isTakeRelativeKey) {
@@ -10388,4 +10421,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-I3UUIBSH.js.map
+//# sourceMappingURL=chunk-IJ5A4TL3.js.map