@vosjs/cli 0.17.4 → 0.19.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-AE3NXEZ4.js");
+  const { run } = await import("./run-PJOOKJE2.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, TranscriptSegment, Digest } from '@vosjs/studio-core';
+import { CursorTrack, RecordingMeta, ProjectDoc, CursorEvent, Backdrop, LayoutParts, TranscriptSegment, Digest } from '@vosjs/studio-core';
 export { Digest } from '@vosjs/studio-core';
 
 interface RenderCommonOptions {
@@ -230,6 +230,48 @@ declare function encodeRecording(browser: Browser, takeDir: string, onProgress:
     bytes: number;
 }>;
 
+interface ReleaseWords {
+    headline?: string | null;
+    kicker?: string | null;
+    brand?: string | null;
+    release?: string | null;
+}
+
+interface MusicCatalog {
+    tracks: {
+        slug: string;
+        title: string;
+        mood?: string;
+        duration: number;
+        url: string;
+    }[];
+    sfx: {
+        slug: string;
+        title: string;
+        duration: number;
+        url: string;
+    }[];
+}
+interface MotionProposalInput {
+    words: ReleaseWords;
+    /** LAUNCH.md roles: music (a slug or mood), entrance, endCard, captions, clicks. */
+    launch: Record<string, string>;
+    /** The end card's ink: the brand's ink over a light ground, white over a dark one. */
+    ink?: string | null;
+    /** The brand's mark for the end card (a take-dir key and its aspect), or none. */
+    mark?: {
+        key: string;
+        aspect: number;
+    } | null;
+    /** actions.json steps with their optional captions, by index. */
+    captions: {
+        step: number;
+        id?: string;
+        caption: string;
+    }[];
+    catalog: MusicCatalog | null;
+}
+
 /**
  * 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
@@ -268,6 +310,15 @@ interface PlanSummary {
     /** The style fields copied from `--style`'s reference, when given. */
     styleFrom?: string;
     styleFields?: readonly string[];
+    /** The layout the reference carried and what the copy left alone. */
+    layout?: LayoutParts & {
+        notes: string[];
+    };
+    /** The motion proposed onto the document, and what could not be. */
+    motion?: {
+        notes: string[];
+        skipped: string[];
+    };
     /** `--reuse`: what the re-anchor did and what it could not. */
     reuse?: ReuseReport & {
         from: string;
@@ -280,6 +331,8 @@ interface PlanOptions {
      * copied onto this take BEFORE the planners run, so the auto spans are
      * proposed under the series' camera. The cut (spans, overlays, audio) is
      * never touched; a field absent on the reference is removed here too.
+     * A reference that is a POSTER carries its layout too: the stage clips
+     * by id, the rest lean where this take has no spans, the trailing hold.
      */
     style?: {
         from: string;
@@ -303,6 +356,25 @@ interface PlanOptions {
      * frame, which still wins. Null or absent: the bare frame.
      */
     backdrop?: Backdrop | null;
+    /**
+     * The release's words, patched into the stage clips a layout carries
+     * (`stage-title` ← headline, `stage-kicker` ← kicker, `stage-brand` ←
+     * the wordmark) and read by the end card.
+     */
+    words?: ReleaseWords;
+    /** The brand's mark (a take-dir key + aspect): the layout's `stage-mark` and the end card's mark. */
+    mark?: {
+        key: string;
+        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).
+     */
+    motion?: MotionProposalInput & {
+        again?: boolean;
+    };
 }
 declare function planTake(dir: string, opts?: PlanOptions): Promise<PlanSummary>;
 
@@ -346,6 +418,8 @@ declare function pullMedia(ctx: {
 interface DocOverrides {
     /** raw `path=value` expressions from repeated --set. */
     set?: string[];
+    /** Top-level or nested paths to REMOVE after the sets (a destination's mechanics drop a field a null could not express). */
+    unset?: string[];
     /** --frame alias → frame.browserBar.kind. */
     frame?: string;
     /** --background alias → frame.backgroundMedia (kind inferred from the URL,

package/dist/index.js

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

package/dist/{run-AE3NXEZ4.js → run-PJOOKJE2.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.17.4",
+  "version": "0.19.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",
@@ -48,12 +48,12 @@
   "dependencies": {
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
-    "@vosjs/core": "^0.23.5",
+    "@vosjs/core": "^0.23.6",
     "@vosjs/editor": "^1.3.1",
-    "@vosjs/elements": "^0.8.1",
-    "@vosjs/render-core": "^0.2.3",
+    "@vosjs/render-core": "^0.2.4",
     "@vosjs/shared": "^0.4.1",
-    "@vosjs/studio-core": "^0.9.1",
+    "@vosjs/elements": "^0.8.1",
+    "@vosjs/studio-core": "^0.11.0",
     "@vosjs/timeline": "^0.4.1",
     "@vosjs/tween": "^0.8.2"
   },