@vosjs/cli 0.58.0 → 0.58.1

package/dist/{chunk-K6PE735V.js → chunk-RZZUR2IF.js}

@@ -185,6 +185,37 @@ import {
   unionFitLevel
 } from "@vosjs/studio-core";
 import { TYPEFACE_CATALOG, findFontFamily, findTypeface } from "@vosjs/shared";
+var PIN_NEAR_FRACTION = 0.08;
+var PIN_SURFACE_AREA = 0.25;
+var LABEL_STOPWORDS = /* @__PURE__ */ new Set([
+  "the",
+  "and",
+  "for",
+  "with",
+  "your",
+  "you",
+  "this",
+  "that",
+  "from",
+  "into",
+  "button",
+  "link"
+]);
+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 : "";
+  return new Set(wordsOf(src));
+}
+function selectorLabelWords(selector) {
+  const out = [];
+  const re = /(?:has-text\(|text=|(?:aria-label|title|alt|placeholder|name)\s*[*^$~|]?=\s*)['"]([^'"]+)['"]/g;
+  for (let m = re.exec(selector); m; m = re.exec(selector)) {
+    out.push(...wordsOf(m[1]));
+  }
+  return [...new Set(out)];
+}
 var STEP_KINDS_ALL = [
   "none",
   "fade",
@@ -248,6 +279,20 @@ function lintAnim(name, anim, kinds, problems) {
       if (key === "stagger" && (typeof obj.stagger !== "number" || obj.stagger < 0 || obj.stagger > 2))
         problems.push(`${name}.anim.${side}.stagger must be seconds in 0..2`);
     }
+    if (obj.at !== void 0) {
+      if (!kinds.card || side !== "enter")
+        problems.push(
+          `${name}.anim.${side}.at is the card's own: frame.anim.enter.at delays the card's entrance; a clip already starts at its own start`
+        );
+      else if (typeof obj.at !== "number" || !Number.isFinite(obj.at) || obj.at < 0 || obj.at > 30)
+        problems.push(
+          `${name}.anim.enter.at must be OUTPUT seconds in 0..30 (when the card arrives; the ground plays alone until then)`
+        );
+      else if (kind === "none")
+        problems.push(
+          `${name}.anim.enter.at has nothing to delay: the enter is "none", so the card is on screen from the first frame`
+        );
+    }
     if (obj.side !== void 0) {
       if (kind !== "slide")
         problems.push(`${name}.anim.${side}.side is for a slide`);
@@ -599,6 +644,7 @@ function lintDoc(docIn) {
     }
     const tilt = entries(doc.tilt);
     checkByMedia(tilt, "tilt");
+    const dramatic = [];
     for (const t of tilt) {
       const name = spanName("tilt", t);
       for (const ax of ["rx", "ry"]) {
@@ -611,8 +657,8 @@ function lintDoc(docIn) {
       }
       checkTransition(t, name, problems);
       if (isNum(t.rx) && isNum(t.ry) && Math.abs(t.rx) + Math.abs(t.ry) > 25) {
-        warnings.push(
-          `${name}: combined lean ${(Math.abs(t.rx) + Math.abs(t.ry)).toFixed(0)}\xB0 reads dramatic \u2014 the premium band is \xB15..18\xB0 per axis`
+        dramatic.push(
+          `${name} ${(Math.abs(t.rx) + Math.abs(t.ry)).toFixed(0)}\xB0`
         );
       }
       if (t.source !== void 0 && t.source !== "manual" && t.source !== "auto") {
@@ -624,6 +670,11 @@ function lintDoc(docIn) {
         );
       }
     }
+    if (dramatic.length) {
+      warnings.push(
+        `tilt: ${dramatic.length === 1 ? "a span leans" : `${dramatic.length} spans lean`} past 25\xB0 combined (${dramatic.join(", ")}) and read${dramatic.length === 1 ? "s" : ""} dramatic \u2014 the premium band is \xB15..18\xB0 per axis; keep it if the piece means it`
+      );
+    }
     if (typeof doc.zoomStyle === "string" && doc.zoomStyle in RETIRED_ZOOM_STYLES) {
       const r = RETIRED_ZOOM_STYLES[doc.zoomStyle];
       warnings.push(
@@ -836,7 +887,8 @@ function lintDoc(docIn) {
           enter: CARD_ENTER_KINDS,
           exit: CARD_EXIT_KINDS,
           idle: null,
-          words: false
+          words: false,
+          card: true
         },
         problems
       );
@@ -930,9 +982,12 @@ function lintDoc(docIn) {
     }
     if (footageEnd !== null && footageEnd > 0 && isNum(o.start) && isNum(o.duration)) {
       const over = o.start + o.duration - footageEnd;
-      if (over > 0.05) {
+      const frameAnim = isObj(docIn) && isObj(docIn.frame) && isObj(docIn.frame.anim) ? docIn.frame.anim : null;
+      const exit = frameAnim ? isObj(frameAnim.exit) ? frameAnim.exit.kind : frameAnim.exit : void 0;
+      const cardLeaves = exit !== void 0 && exit !== "none";
+      if (over > 0.05 && !cardLeaves) {
         warnings.push(
-          o.start >= footageEnd ? `${name} starts at ${o.start.toFixed(2)}s, after the footage ends (${footageEnd.toFixed(2)}s): it plays on bare backdrop and lengthens the output by ${over.toFixed(2)}s. A trim moves the footage, never an OUTPUT-anchored layer: re-place it (vos callout with the same --id), or put a freeze under it` : `${name} ends ${over.toFixed(2)}s after the footage (${footageEnd.toFixed(2)}s): the output extends over bare backdrop. Shorten it, or put a freeze under it`
+          o.start >= footageEnd ? `${name} starts at ${o.start.toFixed(2)}s, after the footage ends (${footageEnd.toFixed(2)}s): it plays over the card's held last frame and lengthens the output by ${over.toFixed(2)}s. A trim moves the footage, never an OUTPUT-anchored layer: re-place it (vos callout with the same --id), put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')` : `${name} ends ${over.toFixed(2)}s after the footage (${footageEnd.toFixed(2)}s): the card holds its last frame under it. Shorten it, put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')`
         );
       }
     }
@@ -1604,13 +1659,67 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
       if (!tf || !isNum(tf.x) || !isNum(tf.y)) return;
       const pinned = pins.get(String(o.id));
       if (!pinned && o.pin === void 0 && (o.kind === "html" || o.kind === "image" || o.kind === "video")) {
-        const cands = pinCandidates(docIn, {
+        const words = layerWords(o);
+        let layerBox = null;
+        try {
+          const b = pinBox(o, layout);
+          layerBox = {
+            x: tf.x * layout.W - b.w / 2,
+            y: tf.y * layout.H - b.h / 2,
+            w: b.w,
+            h: b.h
+          };
+        } catch {
+          layerBox = null;
+        }
+        const about = [];
+        for (const c of pinCandidates(docIn, {
           start: o.start,
           duration: o.duration
-        });
-        if (cands.length) {
+        })) {
+          const named = c.selector ? selectorLabelWords(c.selector).filter((x) => words.has(x)) : [];
+          if (named.length) {
+            about.push({
+              step: String(c.step),
+              why: `its words name ${c.step}'s element ("${named.join(" ")}")`
+            });
+            continue;
+          }
+          if (!layerBox) continue;
+          let ref;
+          try {
+            ref = pinReferent(docIn, { step: c.step });
+          } catch {
+            ref = null;
+          }
+          if (!ref || ref.rect.w * ref.rect.h > PIN_SURFACE_AREA) continue;
+          const target = pinRectOnScreen(
+            ref.rect,
+            c.output.start,
+            layout,
+            camera,
+            zoomTrack
+          );
+          const dx = Math.max(
+            0,
+            target.x - (layerBox.x + layerBox.w),
+            layerBox.x - (target.x + target.w)
+          );
+          const dy = Math.max(
+            0,
+            target.y - (layerBox.y + layerBox.h),
+            layerBox.y - (target.y + target.h)
+          );
+          if (Math.hypot(dx, dy) <= PIN_NEAR_FRACTION * layout.H) {
+            about.push({
+              step: String(c.step),
+              why: `it sits beside ${c.step}'s element`
+            });
+          }
+        }
+        if (about.length) {
           warnings.push(
-            `overlays[${i}] is not pinned, and ${cands.length === 1 ? "a step with an element sits" : "steps with an element sit"} inside its window: ${cands.map((c) => `${String(c.step)} (${c.do}${c.selector ? ` ${c.selector}` : ""})`).join(", ")} \u2014 a callout about one of them says so: pin: { step: "${String(cands[0].step)}" }`
+            `overlays[${i}] is not pinned, but ${about[0].why} \u2014 a callout about it says so, and follows it through the camera: pin: { step: "${about[0].step}" }`
           );
         }
       }
@@ -14700,4 +14809,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-K6PE735V.js.map
+//# sourceMappingURL=chunk-RZZUR2IF.js.map