@vosjs/cli 0.19.0 → 0.21.0

package/dist/cli.js

@@ -495,7 +495,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-PJOOKJE2.js");
+  const { run } = await import("./run-7AOC4JUE.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Browser, Page } from 'playwright';
-import { CursorTrack, RecordingMeta, ProjectDoc, CursorEvent, Backdrop, LayoutParts, TranscriptSegment, Digest } from '@vosjs/studio-core';
+import { CursorTrack, RecordingMeta, ProjectDoc, CursorEvent, TemplateAnchor, Backdrop, LayoutParts, TranscriptSegment, Digest } from '@vosjs/studio-core';
 export { Digest } from '@vosjs/studio-core';
 
 interface RenderCommonOptions {
@@ -270,25 +270,20 @@ interface MotionProposalInput {
         caption: string;
     }[];
     catalog: MusicCatalog | null;
+    /** The templates the recipe or the flags named, resolved, in order. */
+    templates?: MotionTemplate[];
+}
+/** Where a template lands: the studio-core anchor, or a recorded step's settle. */
+type MotionAnchor = TemplateAnchor | {
+    step: string;
+};
+/** A template the recipe or a flag named, resolved to its document. */
+interface MotionTemplate {
+    /** What its clips say they came from (the vos id or the path it was read from). */
+    from: string;
+    doc: ProjectDoc;
+    at: MotionAnchor;
 }
-
-/**
- * Reuse: re-time a previous cut onto a NEW recording of the same
- * script. The recorder's `meta.steps` say when each actions.json step ran
- * in BOTH takes, so the old timeline maps onto the new one piecewise —
- * matched step edges are the control points, and any source time in
- * between interpolates. Explicit `anchor`s on camera spans resolve
- * directly against the new steps and win over the map.
- *
- * Report, never guess: every span that
- * could not re-anchor cleanly is NAMED in `flagged` with the reason in
- * words — a vanished step, a skipped selector, a span clamped or dropped
- * at the new take's edge. The agent fixes actions.json and re-runs; the
- * verb never silently invents a cut.
- *
- * Pure functions, no I/O — reuse.test.ts drives them with synthetic
- * step timelines; the browser gate is smoke-recut.ts.
- */
 
 interface ReuseReport {
     /** spans re-timed through an explicit anchor. */
@@ -368,9 +363,10 @@ interface PlanOptions {
         aspect: number;
     } | null;
     /**
-     * Propose the cut's motion (entrance, end card, captions, bed, clicks)
-     * from these roles. Applied on a fresh plan; `again` re-proposes onto an
-     * existing document (replacing only the proposals' own ids and fields).
+     * Propose the cut's motion (the card's enter, the templates the recipe
+     * names, the end card, captions, bed, clicks) from these roles. Applied
+     * on a fresh plan; `again` re-proposes onto an existing document
+     * (replacing only the proposals' own ids and `from`s).
      */
     motion?: MotionProposalInput & {
         again?: boolean;

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   validateActions,
   waitForPageDone,
   writeSyncState
-} from "./chunk-4LLBPFCW.js";
+} from "./chunk-4IWHZBIY.js";
 import {
   BrowserUnavailableError,
   configDuration,

package/dist/{run-PJOOKJE2.js → run-7AOC4JUE.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-4LLBPFCW.js";
+} from "./chunk-4IWHZBIY.js";
 import "./chunk-NHKHTIDR.js";
 export {
   run
 };
-//# sourceMappingURL=run-PJOOKJE2.js.map
+//# sourceMappingURL=run-7AOC4JUE.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description": "The vos CLI: record the real product from a scripted browser flow, auto-zoom from the cursor track, cut as data in doc.json, render deterministic video and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -51,11 +51,11 @@
     "@vosjs/core": "^0.23.6",
     "@vosjs/editor": "^1.3.1",
     "@vosjs/render-core": "^0.2.4",
-    "@vosjs/shared": "^0.4.1",
     "@vosjs/elements": "^0.8.1",
-    "@vosjs/studio-core": "^0.11.0",
-    "@vosjs/timeline": "^0.4.1",
-    "@vosjs/tween": "^0.8.2"
+    "@vosjs/shared": "^0.4.1",
+    "@vosjs/studio-core": "^0.12.0",
+    "@vosjs/tween": "^0.8.2",
+    "@vosjs/timeline": "^0.4.1"
   },
   "devDependencies": {
     "@types/node": "^22",

package/schema/doc.schema.json

@@ -45,8 +45,8 @@
               "hold": {
                 "type": "number",
                 "minimum": 0,
-                "maximum": 10,
-                "description": "freeze on this segment's last frame for these OUTPUT seconds (the beat before a cut, the ground for the end card)"
+                "maximum": 30,
+                "description": "LEGACY spelling of a freeze at this segment's end, read into `freeze` on every path; write `freeze` instead"
               }
             },
             "additionalProperties": true
@@ -55,6 +55,9 @@
         "speed": {
           "$ref": "#/definitions/speed"
         },
+        "freeze": {
+          "$ref": "#/definitions/freeze"
+        },
         "zoom": {
           "type": "array",
           "description": "Zoom regions (SOURCE time, footage-anchored, non-overlapping). The camera ramps in around `in`, holds until `out`, ramps out — or pans straight to the next span when the gap is short. Planner-made spans have source:'auto' (replaced on re-plan); set source:'manual' on any span you add or edit so it survives.",
@@ -1283,6 +1286,52 @@
       },
       "additionalProperties": true
     },
+    "freeze": {
+      "type": "array",
+      "description": "Freezes (SOURCE moments, footage-anchored): the footage frozen on the frame just before `at` for `seconds` of output, anywhere in the take (a pause on a state while a caption reads, a beat before a cut, the rest a poster ends on). The retime primitive beside `speed`: a speed span is a source range with a rate, a freeze a source point with a length. A freeze whose frame is trimmed away has no effect and comes back when the trim does. The still every still-taking surface takes (the thumbnail, a poster's render, the stills export's first moment) is where the LAST freeze begins. Absent = none. The output ending past the footage needs no freeze: the card holds its last frame under the clips that outlast it.",
+      "items": {
+        "type": "object",
+        "required": ["id", "at", "seconds"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "stable identity (f0, f1, …)"
+          },
+          "at": {
+            "type": "number",
+            "minimum": 0,
+            "description": "SOURCE seconds: the frame just before this moment freezes"
+          },
+          "seconds": {
+            "type": "number",
+            "minimum": 0.25,
+            "maximum": 30,
+            "description": "OUTPUT seconds the frame holds"
+          },
+          "anchor": {
+            "type": "object",
+            "required": ["step"],
+            "additionalProperties": false,
+            "properties": {
+              "step": {
+                "type": ["string", "integer"],
+                "description": "the actions.json step: its `id` when it has one, else its record-time index (meta.steps)"
+              },
+              "at": {
+                "enum": ["start", "end"],
+                "description": "which edge of the step the freeze's `at` is measured from (default start)"
+              },
+              "offset": {
+                "type": "number",
+                "description": "seconds from that edge to the freeze's `at` (negative = before it)"
+              }
+            },
+            "description": "re-record tie to a step (vos plan --reuse resolves it against the new take's steps and it wins over the step map); `at` stays the truth"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
     "speed": {
       "type": "array",
       "description": "Speed-change spans (SOURCE time, footage-anchored, non-overlapping). Absent = all 1×. The planner proposes source:'auto' spans for typing passages, scroll runs and idle gaps (ids s0…); set source:'manual' on spans you add or edit so they survive a re-plan (absent source also counts as manual).",