@vosjs/cli 0.31.1 → 0.33.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-ULH2OMJM.js");
+  const { run } = await import("./run-X6XJCMIZ.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   validateActions,
   waitForPageDone,
   writeSyncState
-} from "./chunk-APVJ4MDJ.js";
+} from "./chunk-6O55OD6D.js";
 import {
   BrowserUnavailableError,
   configDuration,

package/dist/{run-ULH2OMJM.js → run-X6XJCMIZ.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-APVJ4MDJ.js";
+} from "./chunk-6O55OD6D.js";
 import "./chunk-NHKHTIDR.js";
 export {
   run
 };
-//# sourceMappingURL=run-ULH2OMJM.js.map
+//# sourceMappingURL=run-X6XJCMIZ.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.31.1",
+  "version": "0.33.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,14 +48,14 @@
   "dependencies": {
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
-    "@vosjs/editor": "^1.3.1",
     "@vosjs/core": "^0.24.1",
-    "@vosjs/elements": "^0.8.1",
+    "@vosjs/editor": "^1.3.1",
     "@vosjs/render-core": "^0.2.8",
+    "@vosjs/studio-core": "^0.25.0",
     "@vosjs/shared": "^0.4.1",
-    "@vosjs/studio-core": "^0.23.0",
-    "@vosjs/tween": "^0.8.2",
-    "@vosjs/timeline": "^0.4.1"
+    "@vosjs/elements": "^0.8.1",
+    "@vosjs/timeline": "^0.4.1",
+    "@vosjs/tween": "^0.8.2"
   },
   "devDependencies": {
     "@types/node": "^22",

package/schema/doc.schema.json

@@ -824,7 +824,7 @@
     },
     "overlays": {
       "type": "array",
-      "description": "Compositor v2 (V1): screen-space text clips drawn ABOVE the card, outside the zoom transform. OUTPUT-anchored (start is final-cut seconds \u2014 trims/speed never retime a title). Optional; absent = none.",
+      "description": "Screen-space layers drawn ABOVE the card, outside the zoom transform. OUTPUT-anchored (start is final-cut seconds \u2014 trims/speed never retime a title). A layer about something on the page names it with `pin` and is placed beside it, following it as the camera moves; a layer with no referent is a caption and sits in the margin. Optional; absent = none.",
       "items": {
         "type": "object",
         "required": ["id", "kind", "start", "duration", "transform"],
@@ -836,6 +836,54 @@
           "kind": {
             "enum": ["text", "image", "video", "html"]
           },
+          "pin": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "The layer's REFERENT: the thing on the page it is about. Exactly one of step, press or rect names it. The lowering places the layer a gap off one side of the referent and carries it with the referent through the camera (the layer keeps its screen size), so the statement and its subject stay bound; transform.x/y stay the fallback when the pin cannot resolve (validate says why). Not the re-record `anchor` on spans.",
+            "properties": {
+              "step": {
+                "type": ["string", "integer"],
+                "description": "a recorder step (actions.json `id`, else its index in meta.steps) whose element rect is the referent \u2014 hover, click, type and drag steps carry one; an older take resolves it from the presses inside the step's window"
+              },
+              "press": {
+                "type": "number",
+                "description": "SOURCE seconds: the press nearest this moment (within 0.5 s) names the referent \u2014 for a human recording, which has no steps"
+              },
+              "rect": {
+                "type": "object",
+                "required": ["x", "y", "w", "h"],
+                "additionalProperties": false,
+                "properties": {
+                  "x": { "type": "number" },
+                  "y": { "type": "number" },
+                  "w": { "type": "number", "exclusiveMinimum": 0 },
+                  "h": { "type": "number", "exclusiveMinimum": 0 }
+                },
+                "description": "the referent itself, in FRACTIONS of the video frame [0..1] (the zoom cx/cy convention; NOT pixels)"
+              },
+              "side": {
+                "enum": ["auto", "right", "left", "below", "above"],
+                "description": "which side of the referent the layer sits on; auto (the default) takes the first of right, left, below, above whose box fits inside the frame through the layer's life, else the roomiest"
+              },
+              "gap": {
+                "type": "number",
+                "minimum": 0,
+                "description": "design px between the referent and the layer's visible box (default 24)"
+              },
+              "mark": {
+                "enum": ["none", "ring", "underline"],
+                "description": "a standing mark on the referent for the layer's life: a rounded ring around it, or a bar under it (default none)"
+              },
+              "leader": {
+                "type": "boolean",
+                "description": "a hairline from the layer's near edge to the referent, with a dot at the referent"
+              },
+              "color": {
+                "type": "string",
+                "description": "the mark's and the leader's ink (CSS colour; default white over a dark rim, legible on any ground)"
+              }
+            }
+          },
           "html": {
             "type": "string",
             "description": "html kind: the layer's MARKUP, well-formed XML (foreignObject is XML, not HTML: <br />, &amp;, quoted attributes). A UI component authored as DOM, laid out and painted by the browser and composited over the footage sharp at any export size. Required for html. No script runs. An image it names by URL is inlined for you when the URL is on https://assets.vos.so/ (upload it with vos asset upload); any other host paints blank, so inline it as a data: URI. Faces are found from the CSS"