@vosjs/cli 0.29.0 → 0.30.0

package/README.md

@@ -161,7 +161,7 @@ Verified the flow in agent-browser already? `vos actions from-agent-browser step
 
 **Image and video overlays.** Media kinds on the same lane: `{ "id": "m0", "kind": "image" | "video", "start": 2, "duration": 4, "key": "/logo.png", "width": 0.35, "radius": 12, "opacity": 1, "loop": false, "transform": { … } }`. `key` is a file inside the take directory (`"/logo.png"`) or a URL; `width` is a fraction of the frame width, height follows the media's aspect; corners in design px. Video time is clip-local and muted by design; soundtracks belong to `doc.audio`.
 
-**HTML layers.** A UI component authored as DOM on the same lane, sharp at any export size because it is rasterized from source, not magnified from the footage: `{ "id": "h0", "kind": "html", "start": 2, "duration": 4, "html": "<div class=\"card\">Open Code</div>", "css": ".card{font-family:'Inter';background:#0b0b0d;border-radius:16px;box-shadow:0 24px 60px rgba(0,0,0,.45)}", "box": { "width": 452, "height": 132 }, "transform": { … } }`. The markup is well-formed XML (`<br />`, `&amp;`, quoted attributes; `vos validate` refuses the rest in words, because a malformed layer decodes to nothing and says nothing). `box` is the design box in 1080p px; `width` defaults to the design size. The CSS is the chrome (shadow, radius, border; `bleed` is derived from the shadows, or stated), a `font-family` it names resolves against the hosted catalog at every `font-weight` it names (a face outside the catalog rides `fonts: [{ family, url }]`), an image inside must be a `data:` URI, and an `animation` runs on the wall clock rather than the timeline, so animate the layer with `anim` and `motion`. It is never re-hosted and never an upload.
+**HTML layers.** A UI component authored as DOM on the same lane, sharp at any export size because it is rasterized from source, not magnified from the footage: `{ "id": "h0", "kind": "html", "start": 2, "duration": 4, "html": "<div class=\"card\">Open Code</div>", "css": ".card{font-family:'Inter';background:#0b0b0d;border-radius:16px;box-shadow:0 24px 60px rgba(0,0,0,.45)}", "box": { "width": 452, "height": 132 }, "transform": { … } }`. The markup is well-formed XML (`<br />`, `&amp;`, quoted attributes; `vos validate` refuses the rest in words, because a malformed layer decodes to nothing and says nothing). `box` is the design box in 1080p px; `width` defaults to the design size. The CSS is the chrome (shadow, radius, border; `bleed` is derived from the shadows, or stated), a `font-family` it names resolves against the hosted catalog at every `font-weight` it names (a face outside the catalog rides `fonts: [{ family, url }]`), and an image inside is inlined for you when its URL is on `https://assets.vos.so/` (`vos asset upload` puts it there; any other host paints blank, so inline it as a `data:` URI). A still layer's `animation` runs on the wall clock rather than the timeline, so animate the layer with `anim` and `motion`; a LIVE layer (`"live": true`) is re-rasterized per frame at clip-local time: its `@keyframes` are scrubbed to `t` (paused, delayed by `-t`; fold any `animation-delay` into the keyframes) and `{{t}}` / `{{data.<name>}}` placeholders in the markup and CSS fill from the clock and the clip's `data`, so a counter, a progress bar or a typed line come out on the timeline's clock in the preview and in every export chunk alike. It is never re-hosted and never an upload.
 
 **3D props.** `doc.objects`: world-space props between the card and the overlays. `{ "id": "p0", "asset": { "kind": "primitive", "shape": "knot", "color": "#ffb03a" }, "span": { "start": 1, "duration": 3 }, "transform3d": { "x": 0.8, "y": 0.28, "z": 0.5, "rx": 0, "ry": 40, "rz": 0, "scale": 0.18 }, "animation": "spin" }`. Shapes `cube`, `sphere`, `torus`, `knot`; `kind: "gltf"` with `key` loads a GLB (bounding-box normalized so `scale` means the same for every model; a bad model fails open). `x`/`y` are frame fractions, `z` world units toward the camera from the card plane, `scale` a fraction of the frame height; `animation` is `spin` or `float`, deterministic.
 

package/dist/{chunk-GSRCASV2.js → chunk-N5CNC3B7.js}

@@ -1143,6 +1143,20 @@ function lintDoc(docIn) {
           `${name}.width must be a fraction of the frame width in (0..1] (got ${String(o.width)}; absent = the design size)`
         );
       }
+      if (o.live !== void 0 && typeof o.live !== "boolean") {
+        problems.push(
+          `${name}.live must be true or absent: a live layer is re-rasterized per frame at clip-local t (its @keyframes scrubbed, its {{t}} and {{data.\u2026}} filled)`
+        );
+      }
+      if (o.data !== void 0) {
+        const bad = !isObj(o.data) || Object.values(o.data).some(
+          (v) => !["string", "number", "boolean"].includes(typeof v)
+        );
+        if (bad)
+          problems.push(
+            `${name}.data must be a map of strings, numbers or booleans: the values a live layer's {{data.<name>}} placeholders read`
+          );
+      }
       if (o.opacity !== void 0 && (!isNum(o.opacity) || o.opacity < 0 || o.opacity > 1)) {
         problems.push(`${name}.opacity must be 0..1`);
       }
@@ -7406,7 +7420,7 @@ import {
   migrateConfig,
   vosConfigJsonSchema
 } from "@vosjs/core";
-import { migrateHostedDoc as migrateHostedDoc4 } from "@vosjs/studio-core";
+import { lowerProgramDoc, migrateHostedDoc as migrateHostedDoc4 } from "@vosjs/studio-core";
 
 // src/plugin/login.ts
 import { hostname } from "os";
@@ -7704,6 +7718,7 @@ async function createProgramVos(opts) {
     if (opts.remixOfId) body.remixOfId = opts.remixOfId;
     if (opts.label) body.label = opts.label;
     if (opts.note) body.note = opts.note;
+    if (opts.doc) body.doc = opts.doc;
     const res = await apiJson(opts.origin, "/api/vos", {
       method: "POST",
       key: opts.key,
@@ -7804,7 +7819,10 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
   }
   if (vosId) {
     const trackedBase = state && state.vosId === vosId && state.versionId ? state.versionId : void 0;
-    const body = { config, client: clientId() };
+    const body = {
+      config: storedProgramConfig(config, programDoc),
+      client: clientId()
+    };
     if (programDoc) body.doc = programDoc;
     const base = strFlag(flags, "base") ?? trackedBase;
     if (base) body.baseVersionId = base;
@@ -7869,7 +7887,12 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
   const created = await createProgramVos({
     origin,
     key,
-    config,
+    config: storedProgramConfig(config, programDoc),
+    // The document rode the version path and not the create path, so a
+    // fresh push of a program directory silently dropped its doc.json
+    // (found seeding one-layer members: `--with` then said the vos carried
+    // no doc).
+    doc: programDoc ?? void 0,
     title,
     slug: strFlag(flags, "slug"),
     description: desc,
@@ -8066,6 +8089,11 @@ async function storeKey(key, origin, r) {
 function isTakeDir(target) {
   return directoryKind(target) === "take";
 }
+function storedProgramConfig(config, programDoc) {
+  if (!programDoc) return config;
+  const doc = { audio: [], ...programDoc };
+  return lowerProgramDoc(doc).config;
+}
 async function readProgramDoc(dir, config) {
   const docPath = join16(dir, "doc.json");
   if (!existsSync13(docPath)) return null;
@@ -10587,4 +10615,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-GSRCASV2.js.map
+//# sourceMappingURL=chunk-N5CNC3B7.js.map