@vosjs/cli 0.24.0 → 0.25.1

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. 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.
 
 **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-NOR522G5.js → chunk-GHJ2BFQG.js}

@@ -186,16 +186,17 @@ import {
   CAM_SPAN_MIN,
   CARD_ENTER_KINDS,
   CARD_EXIT_KINDS,
-  IDLE_KINDS,
-  MEDIA_ENTER_KINDS,
-  MEDIA_EXIT_KINDS,
-  TEXT_ENTER_KINDS,
-  TEXT_EXIT_KINDS,
   EXPORT_RESOLUTION_OPTIONS,
   FREEZE_SECONDS_MAX,
   FREEZE_SECONDS_MIN,
+  IDLE_KINDS,
+  MEDIA_ENTER_KINDS,
+  MEDIA_EXIT_KINDS,
+  MEDIA_FRAME_KEYS,
   SPEED_RATE_MAX,
   SPEED_RATE_MIN,
+  TEXT_ENTER_KINDS,
+  TEXT_EXIT_KINDS,
   TILT_DEG_MAX,
   TILT_SPAN_MIN,
   ZOOM_LEVEL_MAX,
@@ -366,6 +367,21 @@ function lintDoc(docIn) {
       if (!id) problems.push(`media[${i}]: id must be a string`);
       else if (mediaLen.has(id))
         problems.push(`media[${i}] (${id}): duplicate id`);
+      const mf = m.frame;
+      if (mf !== void 0) {
+        if (!isObj(mf)) {
+          problems.push(
+            `media[${i}]${id ? ` (${id})` : ""}: frame must be an object`
+          );
+        } else {
+          for (const k of Object.keys(mf)) {
+            if (!MEDIA_FRAME_KEYS.includes(k))
+              problems.push(
+                `media[${i}]${id ? ` (${id})` : ""}.frame.${k}: not a card field (a media's frame carries ${MEDIA_FRAME_KEYS.join(", ")}; the rest is the take's frame)`
+              );
+          }
+        }
+      }
       if (typeof m.videoKey !== "string")
         problems.push(
           `media[${i}]${id ? ` (${id})` : ""}: videoKey must be a string`
@@ -3482,6 +3498,7 @@ import {
   endCardClips,
   migrateMotion,
   ratedSegments as ratedSegments4,
+  sameMedia,
   spanOutputExtent as spanOutputExtent4
 } from "@vosjs/studio-core";
 var SOUND_DESTINATIONS = /* @__PURE__ */ new Set([
@@ -3609,7 +3626,7 @@ function proposeMotion(input, opts) {
       const lastSeg = doc.segments.at(-1);
       if (lastSeg) {
         const own = (doc.freeze ?? []).filter(
-          (f) => Math.abs(f.at - lastSeg.out) > 1e-9
+          (f) => Math.abs(f.at - lastSeg.out) > 1e-9 || !sameMedia(f.media, lastSeg.media)
         );
         const taken = new Set(own.map((f) => f.id));
         let n = 0;
@@ -3620,7 +3637,8 @@ function proposeMotion(input, opts) {
             id: `f${n}`,
             at: lastSeg.out,
             seconds: END_CARD_SECONDS,
-            from: END_CARD_FROM
+            from: END_CARD_FROM,
+            ...lastSeg.media ? { media: lastSeg.media } : {}
           }
         ].sort((a, b) => a.at - b.at);
       }
@@ -10343,4 +10361,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-NOR522G5.js.map
+//# sourceMappingURL=chunk-GHJ2BFQG.js.map