@vosjs/cli 0.18.0 → 0.19.0

package/dist/{chunk-HYUVNBEM.js → chunk-4LLBPFCW.js}

@@ -181,6 +181,13 @@ import {
   CAM_SIZE_MAX,
   CAM_SIZE_MIN,
   CAM_SPAN_MIN,
+  CARD_ENTER_KINDS,
+  CARD_EXIT_KINDS,
+  IDLE_KINDS,
+  MEDIA_ENTER_KINDS,
+  MEDIA_EXIT_KINDS,
+  TEXT_ENTER_KINDS,
+  TEXT_EXIT_KINDS,
   EXPORT_RESOLUTION_OPTIONS,
   SPEED_RATE_MAX,
   SPEED_RATE_MIN,
@@ -196,6 +203,79 @@ import {
   zoomCoversRect
 } from "@vosjs/studio-core";
 import { TYPEFACE_CATALOG, findFontFamily, findTypeface } from "@vosjs/shared";
+var STEP_KINDS_ALL = [
+  "none",
+  "fade",
+  "rise",
+  "pop",
+  "blur",
+  "typewriter",
+  "tilt-in",
+  "pull-out",
+  "recede"
+];
+var STEP_UNITS = ["block", "line", "word", "char"];
+var STEP_DIRS = ["forward", "reverse", "center"];
+function lintAnim(name, anim, kinds, problems) {
+  if (anim === void 0) return;
+  if (typeof anim !== "object" || anim === null || Array.isArray(anim)) {
+    problems.push(`${name}.anim must be { enter?, exit?, idle? }`);
+    return;
+  }
+  const a = anim;
+  for (const side of ["enter", "exit"]) {
+    const step = a[side];
+    if (step === void 0) continue;
+    const allowed = kinds[side];
+    const spelled = typeof step === "string" ? step : null;
+    const obj = typeof step === "object" && step !== null && !Array.isArray(step) ? step : null;
+    const kind = spelled ?? (obj ? obj.kind : void 0);
+    if (typeof kind !== "string" || !STEP_KINDS_ALL.includes(kind)) {
+      problems.push(
+        `${name}.anim.${side} must be a kind or { kind, seconds?${kinds.words ? ", unit?, direction?, stagger?" : ""} } (got ${JSON.stringify(step)})`
+      );
+      continue;
+    }
+    if (!allowed.includes(kind)) {
+      problems.push(
+        `${name}.anim.${side} cannot be "${kind}" here; one of ${allowed.join(" | ")}`
+      );
+    }
+    if (!obj) continue;
+    const secs = obj.seconds;
+    if (secs !== void 0 && (typeof secs !== "number" || !Number.isFinite(secs) || secs < 0.05 || secs > 3)) {
+      problems.push(`${name}.anim.${side}.seconds must be 0.05..3`);
+    }
+    for (const key of ["unit", "direction", "stagger"]) {
+      if (obj[key] === void 0) continue;
+      if (!kinds.words) {
+        problems.push(`${name}.anim.${side}.${key} is for words only`);
+        continue;
+      }
+      if (key === "unit" && (typeof obj.unit !== "string" || !STEP_UNITS.includes(obj.unit)))
+        problems.push(
+          `${name}.anim.${side}.unit must be ${STEP_UNITS.join("|")}`
+        );
+      if (key === "direction" && (typeof obj.direction !== "string" || !STEP_DIRS.includes(obj.direction)))
+        problems.push(
+          `${name}.anim.${side}.direction must be ${STEP_DIRS.join("|")}`
+        );
+      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 (a.idle !== void 0 && a.idle !== null) {
+    if (!kinds.idle) problems.push(`${name}.anim.idle is for props only`);
+    else if (typeof a.idle !== "string" || !kinds.idle.includes(a.idle))
+      problems.push(
+        `${name}.anim.idle must be ${kinds.idle.join(" | ")} | null`
+      );
+  }
+}
+function lintFrom(name, from, problems) {
+  if (from !== void 0 && (typeof from !== "string" || !from.length))
+    problems.push(`${name}.from must be the id of the template that placed it`);
+}
 var EPS = 1e-3;
 var isNum = (v) => typeof v === "number" && Number.isFinite(v);
 var isObj = (v) => typeof v === "object" && v !== null;
@@ -328,19 +408,27 @@ function lintDoc(docIn) {
     const endCard = doc.endCard;
     if (endCard !== void 0) {
       if (typeof endCard !== "object" || endCard === null) {
-        problems.push("endCard must be an object: {seconds?, headline?, sub?, wordmark?}");
+        problems.push(
+          "endCard must be an object: {seconds?, headline?, sub?, wordmark?}"
+        );
       } else {
         const ec = endCard;
         if (ec.seconds !== void 0 && (!isNum(ec.seconds) || ec.seconds < 1 || ec.seconds > 8)) {
-          problems.push(`endCard.seconds must be 1..8 (got ${String(ec.seconds)}); absent = 2.5`);
+          problems.push(
+            `endCard.seconds must be 1..8 (got ${String(ec.seconds)}); absent = 2.5`
+          );
         }
         for (const k of ["headline", "sub", "wordmark"]) {
           if (ec[k] !== void 0 && typeof ec[k] !== "string") {
             problems.push(`endCard.${k} must be a string`);
           }
         }
-        if (!["headline", "sub", "wordmark"].some((k) => typeof ec[k] === "string" && ec[k].trim())) {
-          warnings.push("endCard carries no words: it holds the last frame and recedes the card over nothing");
+        if (!["headline", "sub", "wordmark"].some(
+          (k) => typeof ec[k] === "string" && ec[k].trim()
+        )) {
+          warnings.push(
+            "endCard carries no words: it holds the last frame and recedes the card over nothing"
+          );
         }
       }
     }
@@ -579,6 +667,17 @@ function lintDoc(docIn) {
           }
         }
       }
+      lintAnim(
+        "frame",
+        frame.anim,
+        {
+          enter: CARD_ENTER_KINDS,
+          exit: CARD_EXIT_KINDS,
+          idle: null,
+          words: false
+        },
+        problems
+      );
       if (frame.focusFollow !== void 0 && frame.focusFollow !== "camera") {
         problems.push(
           `frame.focusFollow must be "camera" (got ${String(frame.focusFollow)}); it reads under fit: cover only`
@@ -826,6 +925,23 @@ function lintDoc(docIn) {
         problems.push(`${name}.${key} must be one of ${TRANSITIONS.join("|")}`);
       }
     }
+    lintAnim(
+      name,
+      o.anim,
+      o.kind === "text" ? {
+        enter: TEXT_ENTER_KINDS,
+        exit: TEXT_EXIT_KINDS,
+        idle: null,
+        words: true
+      } : {
+        enter: MEDIA_ENTER_KINDS,
+        exit: MEDIA_EXIT_KINDS,
+        idle: null,
+        words: false
+      },
+      problems
+    );
+    lintFrom(name, o.from, problems);
     if (o.motion !== void 0) {
       if (!Array.isArray(o.motion)) {
         problems.push(`${name}.motion must be an array of poses`);
@@ -956,6 +1072,18 @@ function lintDoc(docIn) {
     if (o.animation !== void 0 && o.animation !== null && o.animation !== "spin" && o.animation !== "float") {
       problems.push(`${name}.animation must be "spin" | "float" | null`);
     }
+    lintAnim(
+      name,
+      o.anim,
+      {
+        enter: MEDIA_ENTER_KINDS,
+        exit: MEDIA_EXIT_KINDS,
+        idle: IDLE_KINDS,
+        words: false
+      },
+      problems
+    );
+    lintFrom(name, o.from, problems);
     if (o.motion !== void 0) {
       if (!Array.isArray(o.motion)) {
         problems.push(`${name}.motion must be an array of poses`);
@@ -9832,4 +9960,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-HYUVNBEM.js.map
+//# sourceMappingURL=chunk-4LLBPFCW.js.map