@vosjs/cli 0.65.3 → 0.66.0

package/README.md

@@ -263,7 +263,7 @@ Verified the flow in agent-browser already? `vos actions from-agent-browser step
 
 **Tilt.** `doc.tilt`: source-anchored, non-overlapping spans where the card leans to a pose and returns to rest: `[{ "id": "u0", "in": 4, "out": 8, "rx": 6, "ry": -9, "source": "manual" }]`. `rx`/`ry` are degrees (±45 hard limit; ±5..18 reads well); `+rx` brings the top edge toward the camera, `+ry` the left edge, so a lean toward a right-side focus is a negative `ry`. Rest is flat. `doc.tiltStyle` (`off`, `subtle`, `medium`, `strong`) is the intensity the planner derives automatic spans from.
 
-**Text overlays.** `doc.overlays`: screen-space clips above the card, outside the zoom, output-anchored. `{ "id": "t0", "kind": "text", "start": 1, "duration": 3, "text": "Ship it", "preset": "title", "transform": { "x": 0.5, "y": 0.82, "scale": 1, "rotation": 0 }, "enter": "rise", "exit": "fade" }`. Presets `title`, `caption`, `label`, overridable with `size` (12..200 design px) and `color`; `\n` breaks lines; a caption (a layer with no referent) is a lower third at `y` ≈ 0.82. Enter and exit: `rise`, `fade`, `none`. Fonts load at render start, fail-open to system stacks.
+**Text overlays.** `doc.overlays`: screen-space clips above the card, outside the zoom, output-anchored. `{ "id": "t0", "kind": "text", "start": 1, "duration": 3, "text": "Ship it", "preset": "title", "transform": { "x": 0.5, "y": 0.82, "scale": 1, "rotation": 0 }, "enter": "rise", "exit": "fade" }`. Presets `title`, `caption`, `label`, overridable with `size` (12..200 design px) and `color`; `\n` breaks lines; a caption (a layer with no referent) is a lower third at `y` ≈ 0.82. Enter and exit: `rise`, `fade`, `none`. Fonts load at render start, fail-open to system stacks. **Styled words are runs.** `text` is a string, or a list of runs when parts of it are set differently: `"text": [{ "text": "Ship " }, { "text": "faster", "weight": 700, "underline": true }]`. A run is a piece of text plus the fields in which it departs from the layer: `weight` (700 is bold; snapped to what the family hosts), `italic`, `color`, `underline`, `strike`, `highlight` (a colour behind it). There is no markup in the words (an asterisk is an asterisk), a style may start and end anywhere, a run may hold `\n`, and a per-word or per-character entrance keeps every unit in its own style. `vos validate` names a run field it does not know and prints the runs to write for a layer still using the retired `emphasis`.
 
 **Callouts in the grammar.** `vos callout <take> note --step copy --kicker "index.css" --title "Every token you tuned, as CSS variables." --mark ring` writes a callout in the house grammar (three shapes a viewer learns once: `note`, a kicker, a title and a line; `tag`, one label on the accent; `code`, the payload block) from the product's REGISTER: `BRAND.md` beside the take (`bgA` the ground, `accent`, `fontBody`; a kit whose accent is RESERVED, a recorder's red that marks time and nothing else, names a `callout` role and the notes speak in that hue instead) or `--ground #hex --accent #hex --font "…"`. The card inverts the app's value in the product's hue (a light app gets a dark card, a dark app a light one), keeps the accent for the kicker, sets its title at 1.35× the app's body AS SEEN ON SCREEN at the layer's start (the camera's level is read from the document; `--body-px <n>` instead sets the body size on the DELIVERED frame and is never rescaled, which is the flag a rich capture needs, since a 2560-wide take on a padded frame sits near scale 0.6 and lands every default on the grammar's floor; the verb prints the three sizes and the scale it measured), lifts on a real shadow and a hairline, rises in and fades out, opens a beat after the step's press lands and closes before the next scroll or navigation, and is pinned to the step (`--side`, `--mark`, `--leader`, `--color` refine the pin; `--color` paints the mark and the leader, never the kicker, which is the accent). `--at <s> --seconds <n>` places one without a step; `--print` prints the clip instead of writing it. `vos validate <take> --picture` renders the footage under every html layer at its start and reports the ΔE between the card's ground and what it covers: under 8 is a problem (the card reads as one more panel), under 16 a warning. An unpinned html or media layer whose window holds a step with an element gets the pin named in a warning.
 

package/dist/{assetManifest-RQYJYQ7Q.js → assetManifest-RDHHKAAM.js}

@@ -4,12 +4,12 @@ import {
   localManifestRefs,
   pullManifest,
   uploadManifest
-} from "./chunk-7CIAU4QP.js";
-import "./chunk-WVQAZTYU.js";
+} from "./chunk-63KINQOJ.js";
+import "./chunk-UQLC4BEZ.js";
 export {
   hostedLiteralWarnings,
   localManifestRefs,
   pullManifest,
   uploadManifest
 };
-//# sourceMappingURL=assetManifest-RQYJYQ7Q.js.map
+//# sourceMappingURL=assetManifest-RDHHKAAM.js.map

package/dist/{chunk-7CIAU4QP.js → chunk-63KINQOJ.js}

@@ -9,7 +9,7 @@ import {
   manifestRefs,
   nameForType,
   resolveMediaType
-} from "./chunk-WVQAZTYU.js";
+} from "./chunk-UQLC4BEZ.js";
 
 // src/plugin/assetManifest.ts
 import {
@@ -700,4 +700,4 @@ export {
   pullManifest,
   hostedLiteralWarnings
 };
-//# sourceMappingURL=chunk-7CIAU4QP.js.map
+//# sourceMappingURL=chunk-63KINQOJ.js.map

package/dist/{chunk-CODEEH2Z.js → chunk-SFU4U3GM.js}

@@ -9,7 +9,7 @@ import {
   reencodeStill,
   renderStill,
   videoFormat
-} from "./chunk-DU3ANWU4.js";
+} from "./chunk-TYGDQEEI.js";
 import {
   PREV_DOC_NAME,
   RECORDING_NAME,
@@ -33,7 +33,7 @@ import {
   uploadDocRefs,
   uploadManifest,
   writeJson
-} from "./chunk-7CIAU4QP.js";
+} from "./chunk-63KINQOJ.js";
 import {
   CREDENTIALS_PATH,
   MEDIA_HEAD_BYTES,
@@ -44,6 +44,7 @@ import {
   clientId,
   containerMismatch,
   deriveSlug,
+  detailLine,
   formatChanges,
   hasFlag,
   hostedAssetId,
@@ -64,7 +65,7 @@ import {
   strFlag,
   writeCredential,
   writeSyncState
-} from "./chunk-WVQAZTYU.js";
+} from "./chunk-UQLC4BEZ.js";
 import {
   deadLine,
   deadWarns
@@ -213,7 +214,12 @@ import {
   pinCandidates,
   pinRectOnScreen,
   pinReferent,
-  parseEmphasis,
+  marksEmphasis,
+  migrateTextClip,
+  plainText,
+  resolveOverlayStyle,
+  snapRunWeight,
+  RUN_STYLE_KEYS,
   ratedSegments,
   recommendedExportResolution,
   resolvePins,
@@ -243,7 +249,7 @@ function wordsOf(text) {
   return text.toLowerCase().split(/[^a-z0-9]+/).filter((x) => x.length >= 3 && !LABEL_STOPWORDS.has(x));
 }
 function layerWords(o) {
-  const src = typeof o.html === "string" ? o.html.replace(/<[^>]*>/g, " ") : typeof o.text === "string" ? o.text : "";
+  const src = typeof o.html === "string" ? o.html.replace(/<[^>]*>/g, " ") : typeof o.text === "string" || Array.isArray(o.text) ? plainText(o.text) : "";
   return new Set(wordsOf(src));
 }
 function selectorLabelWords(selector) {
@@ -1062,28 +1068,75 @@ function lintDoc(docIn) {
     }
     checkPin(o, name, docIn, recording, problems, warnings);
     if (o.kind === "text") {
-      if (typeof o.text !== "string")
-        problems.push(`${name}.text must be a string`);
+      if (Array.isArray(o.text)) {
+        const HINTS = {
+          bold: "weight: 700",
+          fontWeight: "weight",
+          strikethrough: "strike: true",
+          background: "highlight",
+          colour: "color"
+        };
+        o.text.forEach((run2, ri) => {
+          const at2 = `${name}.text[${ri}]`;
+          if (!run2 || typeof run2 !== "object" || Array.isArray(run2)) {
+            problems.push(
+              `${at2} must be a run: { text, weight?, italic?, color?, underline?, strike?, highlight? }`
+            );
+            return;
+          }
+          const r = run2;
+          if (typeof r.text !== "string")
+            problems.push(`${at2}.text must be a string`);
+          else if (!r.text)
+            warnings.push(`${at2} has no text and paints nothing; drop it`);
+          for (const k of Object.keys(r)) {
+            if (k === "text" || RUN_STYLE_KEYS.includes(k))
+              continue;
+            problems.push(
+              `${at2}.${k} is not a run field (${RUN_STYLE_KEYS.join(", ")})${HINTS[k] ? `: write ${HINTS[k]}` : ""}`
+            );
+          }
+          if (r.weight !== void 0 && (!isNum(r.weight) || r.weight < 100 || r.weight > 900))
+            problems.push(`${at2}.weight must be 100..900`);
+          for (const k of ["italic", "underline", "strike"]) {
+            if (r[k] !== void 0 && typeof r[k] !== "boolean")
+              problems.push(`${at2}.${k} must be true or false`);
+          }
+          for (const k of ["color", "highlight"]) {
+            if (r[k] !== void 0 && typeof r[k] !== "string")
+              problems.push(`${at2}.${k} must be a CSS colour`);
+          }
+          if (isNum(r.weight) && r.weight >= 100 && r.weight <= 900) {
+            const layer = o;
+            const own = resolveOverlayStyle({ ...layer, text: "" }).weight;
+            if (r.weight !== own && snapRunWeight(layer, r.weight) === own)
+              warnings.push(
+                `${at2}.weight ${r.weight} paints no differently: the layer's family hosts no weight nearer to it than the layer's own ${own}`
+              );
+          }
+        });
+      } else if (typeof o.text !== "string") {
+        problems.push(
+          `${name}.text must be a string, or a list of runs ([{ text, weight?, italic?, color?, underline?, strike?, highlight? }])`
+        );
+      }
       if (typeof o.preset === "string" && !PRESETS.includes(o.preset)) {
         warnings.push(
           `${name}.preset "${String(o.preset)}" is not a known preset (${PRESETS.join("|")}) \u2014 falls back to "title"`
         );
       }
-      if (o.emphasis !== void 0) {
-        const em = o.emphasis;
-        if (!em || typeof em !== "object" || Array.isArray(em)) {
-          problems.push(
-            `${name}.emphasis must be { weight?, color? } ({} turns *markers* on)`
-          );
-        } else {
-          if (em.weight !== void 0 && (!isNum(em.weight) || em.weight < 100 || em.weight > 900))
-            problems.push(`${name}.emphasis.weight must be 100..900`);
-          if (em.color !== void 0 && typeof em.color !== "string")
-            problems.push(`${name}.emphasis.color must be a CSS colour`);
-        }
-      } else if (typeof o.text === "string" && parseEmphasis(o.text) !== null) {
+      if (o.emphasis !== void 0 && typeof o.text === "string") {
+        const runs = migrateTextClip(o).text;
         warnings.push(
-          `${name}.text has *marked* words but no emphasis, so the asterisks show as typed; add emphasis: {} to set them bold (\\* keeps one literal)`
+          `${name}.emphasis is retired (styled words are runs now, with no markers in the text). It is still read, but write it as: "text": ${JSON.stringify(runs)} and drop "emphasis"`
+        );
+      } else if (typeof o.text === "string" && marksEmphasis(o.text)) {
+        const runs = migrateTextClip({
+          ...o,
+          emphasis: {}
+        }).text;
+        warnings.push(
+          `${name}.text has words between asterisks, which show as typed. To set them bold write runs: "text": ${JSON.stringify(runs)}`
         );
       }
       if (o.size !== void 0 && (!isNum(o.size) || o.size < 12 || o.size > 200)) {
@@ -4332,8 +4385,9 @@ import {
   computeCardLayout,
   docStillTime as docStillTime2,
   migrateHostedDoc,
+  overlayPlainText,
   overlayRect,
-  resolveOverlayStyle
+  resolveOverlayStyle as resolveOverlayStyle2
 } from "@vosjs/studio-core";
 var POSTER_CLASSES = [
   "landscape",
@@ -4452,7 +4506,7 @@ function posterTextBoxes(doc, px, time) {
     if (clip.kind !== "text") continue;
     if (time < clip.start || time > clip.start + clip.duration) continue;
     const rect = overlayRect(clip, estimateWidth, W, H);
-    const style = resolveOverlayStyle(clip);
+    const style = resolveOverlayStyle2(clip);
     const r3 = (v) => Math.round(v * 1e3) / 1e3;
     out.push({
       x: r3((rect.cx - rect.w / 2) / W),
@@ -4460,7 +4514,7 @@ function posterTextBoxes(doc, px, time) {
       w: r3(rect.w / W),
       h: r3(rect.h / H),
       role: clip.preset === "title" ? "headline" : "body",
-      label: clip.text.split("\n")[0].slice(0, 40),
+      label: overlayPlainText(clip).split("\n")[0].slice(0, 40),
       .../^#[0-9a-f]{6}$/i.test(style.color) ? { color: style.color } : {}
     });
   }
@@ -7128,16 +7182,6 @@ async function api(ctx, path, init) {
   const r = await apiJson(ctx.origin, `/api${path}`, { ...init, key: ctx.key });
   return { status: r.status, json: r.body };
 }
-function detailLine(body) {
-  const details = body.details;
-  if (!Array.isArray(details) || !details.length) return "";
-  const lines = details.map((d) => {
-    const path = Array.isArray(d.path) ? d.path.join(".") : "";
-    return `${path ? `${path}: ` : ""}${String(d.message ?? JSON.stringify(d))}`;
-  });
-  return `
-  ${lines.join("\n  ")}`;
-}
 function printChanges(r, changes, protectedIds) {
   if (Array.isArray(changes)) {
     for (const entry of changes) {
@@ -7641,6 +7685,7 @@ import { existsSync as existsSync13, realpathSync } from "fs";
 function isLocalName(value) {
   if (/^(https?:|data:|blob:|asset:|media:)/.test(value)) return false;
   if (value.startsWith("$")) return false;
+  if (value.startsWith("<svg") || value.startsWith("<?xml")) return false;
   if (value.startsWith("/")) return existsSync13(value);
   return true;
 }
@@ -9154,14 +9199,15 @@ async function cmdDelete(argv) {
   });
   if (res.status !== 200 && res.status !== 204)
     throw new Error(apiError(`delete ${vosId}`, res));
+  const tracking = dir ?? trackingCwd(vosId);
   let unlinked = false;
-  if (dir) {
-    rmSync2(join16(dir, SYNC_STATE_NAME), { force: true });
+  if (tracking) {
+    rmSync2(join16(tracking, SYNC_STATE_NAME), { force: true });
     unlinked = true;
   }
   const trashed = res.body.trashed === true;
   const restoreUntil = typeof res.body.restoreUntil === "string" ? res.body.restoreUntil : null;
-  const tail = unlinked ? `; ${dir} no longer tracks it` : "";
+  const tail = unlinked ? `; ${dir ?? "this directory"} no longer tracks it` : "";
   r.done(
     {
       id: vosId,
@@ -9179,6 +9225,11 @@ async function cmdDelete(argv) {
   );
   return EXIT_OK;
 }
+function trackingCwd(vosId) {
+  const cwd = process.cwd();
+  if (!existsSync15(join16(cwd, SYNC_STATE_NAME))) return null;
+  return readSyncState(cwd)?.vosId === vosId ? cwd : null;
+}
 
 // src/plugin/buildProgram.ts
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
@@ -15095,4 +15146,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-CODEEH2Z.js.map
+//# sourceMappingURL=chunk-SFU4U3GM.js.map