@vosjs/cli 0.21.0 → 0.22.0

package/README.md

@@ -91,7 +91,7 @@ vos plan take --reuse                                   # re-time that cut onto
 
 **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.
 
-**The cut's motion is the document's, in one vocabulary.** Every visual thing carries `anim` (`enter`, `exit`, `idle`; a kind, or a step with its seconds and, for words, `unit`, `direction`, `stagger`): the card (`frame.anim`, entering by `tilt-in`, `pull-out`, `rise` or `fade` and leaving by `recede` or `fade`), a text, image or video clip, a prop. The output lasts until the last clip ends; past its footage the card holds its last frame at the pose its exit settled into. A FREEZE (`freeze: [{id, at, seconds}]`, a source moment held for output seconds, beside the speed spans on the retime lane) freezes the footage anywhere, the middle of the take included; a segment's older `hold` is read as a freeze at its end. There is no end-card field and no entrance field. A COMPONENT is a TEMPLATE: a plain take on a shelf whose clips carry stable ids, laid onto a take at an anchor and stamped `from` with where its clips came from. A fresh `vos plan` proposes the card's enter, the templates the recipe names (`LAUNCH.md` `with: <ref>[@end|@start|@step:<id>|@<seconds>], …` or `--with`, repeatable; `endCard: <ref>` names one at the end), the house end card when `endCard` is on or absent (the headline, the release line, the wordmark and BRAND.md's mark as clips after the footage over a receding card, `from: endcard`), a caption per `actions.json` step, a music bed and click sounds, from LAUNCH.md's `entrance`, `endCard`, `with`, `captions`, `music` and `clicks` roles (or the flags), as data in doc.json with stable ids (`bed`, `click-<n>`, `caption-<step>`), so the studio shows what the kit will render; a refresh never re-proposes (a deleted clip stays deleted) and `--motion` re-proposes on purpose, replacing only its own work. A document written in the older spellings (`frame.entrance`, `endCard`, a clip's `enter`/`exit`/`fx`, a prop's `animation`) is read into the vocabulary and `vos validate` says so.
+**The cut's motion is the document's, in one vocabulary.** Every visual thing carries `anim` (`enter`, `exit`, `idle`; a kind, or a step with its seconds and, for words, `unit`, `direction`, `stagger`): the card (`frame.anim`, entering by `tilt-in`, `pull-out`, `rise` or `fade` and leaving by `recede` or `fade`), a text, image or video clip, a prop. The output lasts until the last clip ends; the card is on screen exactly while its clip runs (the footage, freezes included) and leaves at its end, so its `exit` plays over the clip's last seconds like every clip's; past the footage the clips play over the ground alone. A FREEZE (`freeze: [{id, at, seconds}]`, a source moment held for output seconds, beside the speed spans on the retime lane) freezes the footage anywhere, the middle of the take included; a segment's older `hold` is read as a freeze at its end. There is no end-card field and no entrance field. A COMPONENT is a TEMPLATE: a plain take on a shelf whose clips carry stable ids, laid onto a take at an anchor and stamped `from` with where its clips came from. A fresh `vos plan` proposes the card's enter, the templates the recipe names (`LAUNCH.md` `with: <ref>[@end|@start|@step:<id>|@<seconds>], …` or `--with`, repeatable; `endCard: <ref>` names one at the end), the house end card when `endCard` is on or absent (a freeze of the last frame for the card's seconds, the card receding over it, and the headline, the release line, the wordmark and BRAND.md's mark as clips over the freeze, every one `from: endcard`), a caption per `actions.json` step, a music bed and click sounds, from LAUNCH.md's `entrance`, `endCard`, `with`, `captions`, `music` and `clicks` roles (or the flags), as data in doc.json with stable ids (`bed`, `click-<n>`, `caption-<step>`), so the studio shows what the kit will render; a refresh never re-proposes (a deleted clip stays deleted) and `--motion` re-proposes on purpose, replacing only its own work. A document written in the older spellings (`frame.entrance`, `endCard`, a clip's `enter`/`exit`/`fx`, a prop's `animation`) is read into the vocabulary and `vos validate` says so.
 
 **A fresh take opens on a backdrop.** `create`, `record` and `plan` put the first ready loop from `GET /api/backdrops` behind the card (its ground colour as `frame.background`); `--background <slug|url|none>` overrides it, and offline the frame stays bare with a note.
 

package/dist/{chunk-4IWHZBIY.js → chunk-CRZTGWF3.js}

@@ -3429,7 +3429,6 @@ function pickMoments(measured, opts = {}) {
 // src/plugin/motionPlan.ts
 import {
   END_CARD_FROM,
-  END_CARD_RECEDE,
   END_CARD_SECONDS,
   applyTemplate,
   docOutputDuration,
@@ -3556,13 +3555,32 @@ function proposeMotion(input, opts) {
       if (sub && sub !== headline) card.sub = sub;
       if (brand) card.wordmark = brand;
       if (opts.mark) card.mark = opts.mark;
+      const endStart = outputLength(doc);
+      const lastSeg = doc.segments.at(-1);
+      if (lastSeg) {
+        const own = (doc.freeze ?? []).filter(
+          (f) => Math.abs(f.at - lastSeg.out) > 1e-9
+        );
+        const taken = new Set(own.map((f) => f.id));
+        let n = 0;
+        while (taken.has(`f${n}`)) n++;
+        doc.freeze = [
+          ...own,
+          {
+            id: `f${n}`,
+            at: lastSeg.out,
+            seconds: END_CARD_SECONDS,
+            from: END_CARD_FROM
+          }
+        ].sort((a, b) => a.at - b.at);
+      }
       doc.overlays = [
         ...doc.overlays ?? [],
-        ...endCardClips(card, doc, outputLength(doc))
+        ...endCardClips(card, doc, endStart)
       ];
       doc.frame.anim = {
         ...doc.frame.anim ?? {},
-        exit: { kind: "recede", seconds: END_CARD_RECEDE }
+        exit: { kind: "recede", seconds: END_CARD_SECONDS }
       };
       notes.push("end card");
     } else {
@@ -3623,7 +3641,7 @@ function proposeMotion(input, opts) {
       fadeIn: 0.6,
       fadeOut,
       loop: track.duration < length,
-      loopLen: track.duration < length ? length : void 0,
+      loopLen: track.duration < length ? Math.round(length * 1e3) / 1e3 : void 0,
       duck: hasMic
     });
     notes.push(`bed ${track.slug}`);
@@ -3679,6 +3697,11 @@ function destinationMechanics(d, doc) {
       notes.push(loop ? "no template clips, no captions" : "no captions");
     }
   }
+  if (loop) {
+    const keptFreezes = (doc.freeze ?? []).filter((f) => !f.from);
+    if (keptFreezes.length !== (doc.freeze ?? []).length)
+      set.push(`freeze=${JSON.stringify(keptFreezes)}`);
+  }
   if (portrait) {
     set.push("frame.fit=cover");
     set.push('frame.inset={"left":0.06,"right":0.06,"top":0.17,"bottom":0.17}');
@@ -3709,11 +3732,13 @@ function isLightHexGround(hex2) {
 import { existsSync as existsSync5 } from "fs";
 import { readFile as readFile5 } from "fs/promises";
 import { isAbsolute, join as join6, resolve as resolve3 } from "path";
+import { totalDuration } from "@vosjs/timeline";
 import {
   computeCardLayout,
   docRestTime,
   migrateHostedDoc,
   overlayRect,
+  ratedSegments as ratedSegments5,
   resolveOverlayStyle
 } from "@vosjs/studio-core";
 
@@ -3955,7 +3980,9 @@ async function findPosterDocs(takeDir, launchRoles) {
 function posterStillTime(doc, duration) {
   const rest = docRestTime(doc);
   if (rest != null) return rest;
-  return Math.max(0, duration - 1 / 30);
+  const footage = totalDuration(ratedSegments5(doc));
+  const end = footage > 0 ? Math.min(duration, footage) : duration;
+  return Math.max(0, end - 1 / 30);
 }
 var DESIGN_H = 1080;
 function designFrame(px) {
@@ -10137,4 +10164,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-4IWHZBIY.js.map
+//# sourceMappingURL=chunk-CRZTGWF3.js.map