@vosjs/cli 0.65.4 → 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/{chunk-IDPTF5PP.js → chunk-SFU4U3GM.js}

@@ -214,7 +214,12 @@ import {
   pinCandidates,
   pinRectOnScreen,
   pinReferent,
-  parseEmphasis,
+  marksEmphasis,
+  migrateTextClip,
+  plainText,
+  resolveOverlayStyle,
+  snapRunWeight,
+  RUN_STYLE_KEYS,
   ratedSegments,
   recommendedExportResolution,
   resolvePins,
@@ -244,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) {
@@ -1063,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}.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 *marked* words but no emphasis, so the asterisks show as typed; add emphasis: {} to set them bold (\\* keeps one literal)`
+          `${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)) {
@@ -4333,8 +4385,9 @@ import {
   computeCardLayout,
   docStillTime as docStillTime2,
   migrateHostedDoc,
+  overlayPlainText,
   overlayRect,
-  resolveOverlayStyle
+  resolveOverlayStyle as resolveOverlayStyle2
 } from "@vosjs/studio-core";
 var POSTER_CLASSES = [
   "landscape",
@@ -4453,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),
@@ -4461,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 } : {}
     });
   }
@@ -15093,4 +15146,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-IDPTF5PP.js.map
+//# sourceMappingURL=chunk-SFU4U3GM.js.map