reframe-video 0.6.23 → 0.6.25

package/dist/compile-api.js

@@ -4,7 +4,67 @@ import { readFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// ../core/src/interpolate.ts
+var BACK_C1 = 1.70158;
+var BACK_C2 = BACK_C1 * 1.525;
+var BACK_C3 = BACK_C1 + 1;
+var ELASTIC_C4 = 2 * Math.PI / 3;
+var ELASTIC_C5 = 2 * Math.PI / 4.5;
+function springEase(stiffness, damping, velocity) {
+  const K = 5;
+  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
+  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
+  const coef = (K - velocity) / wd;
+  return (u) => {
+    if (u <= 0) return 0;
+    if (u >= 1) return 1;
+    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
+  };
+}
+function easeOutBounce(u) {
+  const n1 = 7.5625;
+  const d1 = 2.75;
+  if (u < 1 / d1) return n1 * u * u;
+  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
+  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
+  return n1 * (u -= 2.625 / d1) * u + 0.984375;
+}
+var EASE_TABLE = {
+  linear: (u) => u,
+  easeInQuad: (u) => u * u,
+  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
+  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
+  easeInCubic: (u) => u ** 3,
+  easeOutCubic: (u) => 1 - (1 - u) ** 3,
+  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
+  easeInQuart: (u) => u ** 4,
+  easeOutQuart: (u) => 1 - (1 - u) ** 4,
+  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
+  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
+  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
+  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
+  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
+  // back: overshoots past the target then settles (pop / snap)
+  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
+  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
+  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
+  // elastic: rings around the target before settling (playful spring)
+  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
+  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
+  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
+  // bounce: drops and bounces to rest (lands without overshoot)
+  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
+  easeOutBounce,
+  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
+  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
+  spring: springEase(100, 10, 0),
+  springBouncy: springEase(180, 8, 0),
+  springStiff: springEase(210, 26, 0)
+};
+var EASE_NAMES = Object.keys(EASE_TABLE);
+
 // ../core/src/validate.ts
+var EASE_SET = new Set(EASE_NAMES);
 var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
 var BLEND_MODES = /* @__PURE__ */ new Set([
   "normal",
@@ -136,6 +196,26 @@ function validateScene(ir) {
     );
   }
   const labels = /* @__PURE__ */ new Set();
+  const checkEase = (path2, ease) => {
+    if (ease === void 0) return;
+    if (typeof ease === "string") {
+      if (!EASE_SET.has(ease)) {
+        problems.push(`${path2}: unknown ease "${ease}" \u2014 valid: ${EASE_NAMES.join(", ")} (note: there are no *Sine eases)`);
+      }
+      return;
+    }
+    if (typeof ease === "object" && ease !== null) {
+      const o = ease;
+      if ("spring" in o) return;
+      if ("cubicBezier" in o) {
+        if (!Array.isArray(o.cubicBezier) || o.cubicBezier.length !== 4) {
+          problems.push(`${path2}: ease cubicBezier must be [x1, y1, x2, y2]`);
+        }
+        return;
+      }
+    }
+    problems.push(`${path2}: invalid ease \u2014 use a name, { spring }, or { cubicBezier: [x1,y1,x2,y2] }`);
+  };
   const checkTimeline = (tl, path2) => {
     if ("label" in tl && tl.label !== void 0) {
       if (labels.has(tl.label)) {
@@ -163,6 +243,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: to("${tl.state}") duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         for (const id of tl.filter ?? []) {
           if (!nodeById.has(id)) problems.push(`${path2}: filter contains unknown node "${id}"`);
         }
@@ -172,6 +253,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: tween duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       case "motionPath": {
         const node = nodeById.get(tl.target);
@@ -192,6 +274,7 @@ function validateScene(ir) {
         if (tl.curviness !== void 0 && tl.curviness < 0) {
           problems.push(`${path2}: motionPath "${tl.target}" curviness must be >= 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       }
       case "wait":
@@ -318,65 +401,6 @@ function validateComposition(comp) {
 // ../core/src/presets.ts
 var SET = 1 / 120;
 
-// ../core/src/interpolate.ts
-var BACK_C1 = 1.70158;
-var BACK_C2 = BACK_C1 * 1.525;
-var BACK_C3 = BACK_C1 + 1;
-var ELASTIC_C4 = 2 * Math.PI / 3;
-var ELASTIC_C5 = 2 * Math.PI / 4.5;
-function springEase(stiffness, damping, velocity) {
-  const K = 5;
-  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
-  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
-  const coef = (K - velocity) / wd;
-  return (u) => {
-    if (u <= 0) return 0;
-    if (u >= 1) return 1;
-    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
-  };
-}
-function easeOutBounce(u) {
-  const n1 = 7.5625;
-  const d1 = 2.75;
-  if (u < 1 / d1) return n1 * u * u;
-  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
-  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
-  return n1 * (u -= 2.625 / d1) * u + 0.984375;
-}
-var EASE_TABLE = {
-  linear: (u) => u,
-  easeInQuad: (u) => u * u,
-  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
-  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
-  easeInCubic: (u) => u ** 3,
-  easeOutCubic: (u) => 1 - (1 - u) ** 3,
-  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
-  easeInQuart: (u) => u ** 4,
-  easeOutQuart: (u) => 1 - (1 - u) ** 4,
-  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
-  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
-  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
-  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
-  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
-  // back: overshoots past the target then settles (pop / snap)
-  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
-  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
-  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
-  // elastic: rings around the target before settling (playful spring)
-  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
-  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
-  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
-  // bounce: drops and bounces to rest (lands without overshoot)
-  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
-  easeOutBounce,
-  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
-  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
-  spring: springEase(100, 10, 0),
-  springBouncy: springEase(180, 8, 0),
-  springStiff: springEase(210, 26, 0)
-};
-var EASE_NAMES = Object.keys(EASE_TABLE);
-
 // ../core/src/evaluate.ts
 var DEG = Math.PI / 180;
 

package/dist/compile.js

@@ -9,7 +9,67 @@ import { readFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// ../core/src/interpolate.ts
+var BACK_C1 = 1.70158;
+var BACK_C2 = BACK_C1 * 1.525;
+var BACK_C3 = BACK_C1 + 1;
+var ELASTIC_C4 = 2 * Math.PI / 3;
+var ELASTIC_C5 = 2 * Math.PI / 4.5;
+function springEase(stiffness, damping, velocity) {
+  const K = 5;
+  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
+  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
+  const coef = (K - velocity) / wd;
+  return (u) => {
+    if (u <= 0) return 0;
+    if (u >= 1) return 1;
+    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
+  };
+}
+function easeOutBounce(u) {
+  const n1 = 7.5625;
+  const d1 = 2.75;
+  if (u < 1 / d1) return n1 * u * u;
+  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
+  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
+  return n1 * (u -= 2.625 / d1) * u + 0.984375;
+}
+var EASE_TABLE = {
+  linear: (u) => u,
+  easeInQuad: (u) => u * u,
+  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
+  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
+  easeInCubic: (u) => u ** 3,
+  easeOutCubic: (u) => 1 - (1 - u) ** 3,
+  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
+  easeInQuart: (u) => u ** 4,
+  easeOutQuart: (u) => 1 - (1 - u) ** 4,
+  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
+  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
+  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
+  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
+  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
+  // back: overshoots past the target then settles (pop / snap)
+  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
+  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
+  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
+  // elastic: rings around the target before settling (playful spring)
+  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
+  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
+  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
+  // bounce: drops and bounces to rest (lands without overshoot)
+  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
+  easeOutBounce,
+  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
+  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
+  spring: springEase(100, 10, 0),
+  springBouncy: springEase(180, 8, 0),
+  springStiff: springEase(210, 26, 0)
+};
+var EASE_NAMES = Object.keys(EASE_TABLE);
+
 // ../core/src/validate.ts
+var EASE_SET = new Set(EASE_NAMES);
 var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
 var BLEND_MODES = /* @__PURE__ */ new Set([
   "normal",
@@ -141,6 +201,26 @@ function validateScene(ir) {
     );
   }
   const labels = /* @__PURE__ */ new Set();
+  const checkEase = (path2, ease) => {
+    if (ease === void 0) return;
+    if (typeof ease === "string") {
+      if (!EASE_SET.has(ease)) {
+        problems.push(`${path2}: unknown ease "${ease}" \u2014 valid: ${EASE_NAMES.join(", ")} (note: there are no *Sine eases)`);
+      }
+      return;
+    }
+    if (typeof ease === "object" && ease !== null) {
+      const o = ease;
+      if ("spring" in o) return;
+      if ("cubicBezier" in o) {
+        if (!Array.isArray(o.cubicBezier) || o.cubicBezier.length !== 4) {
+          problems.push(`${path2}: ease cubicBezier must be [x1, y1, x2, y2]`);
+        }
+        return;
+      }
+    }
+    problems.push(`${path2}: invalid ease \u2014 use a name, { spring }, or { cubicBezier: [x1,y1,x2,y2] }`);
+  };
   const checkTimeline = (tl, path2) => {
     if ("label" in tl && tl.label !== void 0) {
       if (labels.has(tl.label)) {
@@ -168,6 +248,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: to("${tl.state}") duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         for (const id of tl.filter ?? []) {
           if (!nodeById.has(id)) problems.push(`${path2}: filter contains unknown node "${id}"`);
         }
@@ -177,6 +258,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: tween duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       case "motionPath": {
         const node = nodeById.get(tl.target);
@@ -197,6 +279,7 @@ function validateScene(ir) {
         if (tl.curviness !== void 0 && tl.curviness < 0) {
           problems.push(`${path2}: motionPath "${tl.target}" curviness must be >= 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       }
       case "wait":
@@ -293,65 +376,6 @@ function validateScene(ir) {
 // ../core/src/presets.ts
 var SET = 1 / 120;
 
-// ../core/src/interpolate.ts
-var BACK_C1 = 1.70158;
-var BACK_C2 = BACK_C1 * 1.525;
-var BACK_C3 = BACK_C1 + 1;
-var ELASTIC_C4 = 2 * Math.PI / 3;
-var ELASTIC_C5 = 2 * Math.PI / 4.5;
-function springEase(stiffness, damping, velocity) {
-  const K = 5;
-  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
-  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
-  const coef = (K - velocity) / wd;
-  return (u) => {
-    if (u <= 0) return 0;
-    if (u >= 1) return 1;
-    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
-  };
-}
-function easeOutBounce(u) {
-  const n1 = 7.5625;
-  const d1 = 2.75;
-  if (u < 1 / d1) return n1 * u * u;
-  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
-  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
-  return n1 * (u -= 2.625 / d1) * u + 0.984375;
-}
-var EASE_TABLE = {
-  linear: (u) => u,
-  easeInQuad: (u) => u * u,
-  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
-  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
-  easeInCubic: (u) => u ** 3,
-  easeOutCubic: (u) => 1 - (1 - u) ** 3,
-  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
-  easeInQuart: (u) => u ** 4,
-  easeOutQuart: (u) => 1 - (1 - u) ** 4,
-  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
-  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
-  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
-  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
-  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
-  // back: overshoots past the target then settles (pop / snap)
-  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
-  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
-  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
-  // elastic: rings around the target before settling (playful spring)
-  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
-  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
-  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
-  // bounce: drops and bounces to rest (lands without overshoot)
-  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
-  easeOutBounce,
-  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
-  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
-  spring: springEase(100, 10, 0),
-  springBouncy: springEase(180, 8, 0),
-  springStiff: springEase(210, 26, 0)
-};
-var EASE_NAMES = Object.keys(EASE_TABLE);
-
 // ../core/src/evaluate.ts
 var DEG = Math.PI / 180;
 

package/dist/diff.js

@@ -337,7 +337,67 @@ function compileScene(ir) {
   };
 }
 
+// ../core/src/interpolate.ts
+var BACK_C1 = 1.70158;
+var BACK_C2 = BACK_C1 * 1.525;
+var BACK_C3 = BACK_C1 + 1;
+var ELASTIC_C4 = 2 * Math.PI / 3;
+var ELASTIC_C5 = 2 * Math.PI / 4.5;
+function springEase(stiffness, damping, velocity) {
+  const K = 5;
+  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
+  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
+  const coef = (K - velocity) / wd;
+  return (u) => {
+    if (u <= 0) return 0;
+    if (u >= 1) return 1;
+    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
+  };
+}
+function easeOutBounce(u) {
+  const n1 = 7.5625;
+  const d1 = 2.75;
+  if (u < 1 / d1) return n1 * u * u;
+  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
+  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
+  return n1 * (u -= 2.625 / d1) * u + 0.984375;
+}
+var EASE_TABLE = {
+  linear: (u) => u,
+  easeInQuad: (u) => u * u,
+  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
+  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
+  easeInCubic: (u) => u ** 3,
+  easeOutCubic: (u) => 1 - (1 - u) ** 3,
+  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
+  easeInQuart: (u) => u ** 4,
+  easeOutQuart: (u) => 1 - (1 - u) ** 4,
+  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
+  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
+  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
+  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
+  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
+  // back: overshoots past the target then settles (pop / snap)
+  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
+  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
+  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
+  // elastic: rings around the target before settling (playful spring)
+  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
+  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
+  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
+  // bounce: drops and bounces to rest (lands without overshoot)
+  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
+  easeOutBounce,
+  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
+  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
+  spring: springEase(100, 10, 0),
+  springBouncy: springEase(180, 8, 0),
+  springStiff: springEase(210, 26, 0)
+};
+var EASE_NAMES = Object.keys(EASE_TABLE);
+
 // ../core/src/validate.ts
+var EASE_SET = new Set(EASE_NAMES);
 var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
 var BLEND_MODES = /* @__PURE__ */ new Set([
   "normal",
@@ -469,6 +529,26 @@ function validateScene(ir) {
     );
   }
   const labels = /* @__PURE__ */ new Set();
+  const checkEase = (path2, ease) => {
+    if (ease === void 0) return;
+    if (typeof ease === "string") {
+      if (!EASE_SET.has(ease)) {
+        problems.push(`${path2}: unknown ease "${ease}" \u2014 valid: ${EASE_NAMES.join(", ")} (note: there are no *Sine eases)`);
+      }
+      return;
+    }
+    if (typeof ease === "object" && ease !== null) {
+      const o = ease;
+      if ("spring" in o) return;
+      if ("cubicBezier" in o) {
+        if (!Array.isArray(o.cubicBezier) || o.cubicBezier.length !== 4) {
+          problems.push(`${path2}: ease cubicBezier must be [x1, y1, x2, y2]`);
+        }
+        return;
+      }
+    }
+    problems.push(`${path2}: invalid ease \u2014 use a name, { spring }, or { cubicBezier: [x1,y1,x2,y2] }`);
+  };
   const checkTimeline = (tl, path2) => {
     if ("label" in tl && tl.label !== void 0) {
       if (labels.has(tl.label)) {
@@ -496,6 +576,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: to("${tl.state}") duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         for (const id of tl.filter ?? []) {
           if (!nodeById.has(id)) problems.push(`${path2}: filter contains unknown node "${id}"`);
         }
@@ -505,6 +586,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path2}: tween duration must be > 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       case "motionPath": {
         const node = nodeById.get(tl.target);
@@ -525,6 +607,7 @@ function validateScene(ir) {
         if (tl.curviness !== void 0 && tl.curviness < 0) {
           problems.push(`${path2}: motionPath "${tl.target}" curviness must be >= 0`);
         }
+        checkEase(path2, tl.ease);
         break;
       }
       case "wait":
@@ -651,65 +734,6 @@ function validateComposition(comp) {
 // ../core/src/presets.ts
 var SET = 1 / 120;
 
-// ../core/src/interpolate.ts
-var BACK_C1 = 1.70158;
-var BACK_C2 = BACK_C1 * 1.525;
-var BACK_C3 = BACK_C1 + 1;
-var ELASTIC_C4 = 2 * Math.PI / 3;
-var ELASTIC_C5 = 2 * Math.PI / 4.5;
-function springEase(stiffness, damping, velocity) {
-  const K = 5;
-  const zeta = Math.min(0.999, Math.max(0.05, damping / (2 * Math.sqrt(Math.max(1e-6, stiffness)))));
-  const wd = K / zeta * Math.sqrt(1 - zeta * zeta);
-  const coef = (K - velocity) / wd;
-  return (u) => {
-    if (u <= 0) return 0;
-    if (u >= 1) return 1;
-    return 1 - Math.exp(-K * u) * (Math.cos(wd * u) + coef * Math.sin(wd * u));
-  };
-}
-function easeOutBounce(u) {
-  const n1 = 7.5625;
-  const d1 = 2.75;
-  if (u < 1 / d1) return n1 * u * u;
-  if (u < 2 / d1) return n1 * (u -= 1.5 / d1) * u + 0.75;
-  if (u < 2.5 / d1) return n1 * (u -= 2.25 / d1) * u + 0.9375;
-  return n1 * (u -= 2.625 / d1) * u + 0.984375;
-}
-var EASE_TABLE = {
-  linear: (u) => u,
-  easeInQuad: (u) => u * u,
-  easeOutQuad: (u) => 1 - (1 - u) * (1 - u),
-  easeInOutQuad: (u) => u < 0.5 ? 2 * u * u : 1 - (-2 * u + 2) ** 2 / 2,
-  easeInCubic: (u) => u ** 3,
-  easeOutCubic: (u) => 1 - (1 - u) ** 3,
-  easeInOutCubic: (u) => u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2,
-  easeInQuart: (u) => u ** 4,
-  easeOutQuart: (u) => 1 - (1 - u) ** 4,
-  easeInOutQuart: (u) => u < 0.5 ? 8 * u ** 4 : 1 - (-2 * u + 2) ** 4 / 2,
-  easeInExpo: (u) => u === 0 ? 0 : 2 ** (10 * u - 10),
-  easeOutExpo: (u) => u === 1 ? 1 : 1 - 2 ** (-10 * u),
-  easeInOutExpo: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? 2 ** (20 * u - 10) / 2 : (2 - 2 ** (-20 * u + 10)) / 2,
-  // --- expressive eases (GSAP's signature feel) — standard Penner equations ---
-  // back: overshoots past the target then settles (pop / snap)
-  easeInBack: (u) => BACK_C3 * u ** 3 - BACK_C1 * u * u,
-  easeOutBack: (u) => 1 + BACK_C3 * (u - 1) ** 3 + BACK_C1 * (u - 1) ** 2,
-  easeInOutBack: (u) => u < 0.5 ? (2 * u) ** 2 * ((BACK_C2 + 1) * 2 * u - BACK_C2) / 2 : ((2 * u - 2) ** 2 * ((BACK_C2 + 1) * (2 * u - 2) + BACK_C2) + 2) / 2,
-  // elastic: rings around the target before settling (playful spring)
-  easeInElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : -(2 ** (10 * u - 10)) * Math.sin((u * 10 - 10.75) * ELASTIC_C4),
-  easeOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : 2 ** (-10 * u) * Math.sin((u * 10 - 0.75) * ELASTIC_C4) + 1,
-  easeInOutElastic: (u) => u === 0 ? 0 : u === 1 ? 1 : u < 0.5 ? -(2 ** (20 * u - 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5)) / 2 : 2 ** (-20 * u + 10) * Math.sin((20 * u - 11.125) * ELASTIC_C5) / 2 + 1,
-  // bounce: drops and bounces to rest (lands without overshoot)
-  easeInBounce: (u) => 1 - easeOutBounce(1 - u),
-  easeOutBounce,
-  easeInOutBounce: (u) => u < 0.5 ? (1 - easeOutBounce(1 - 2 * u)) / 2 : (1 + easeOutBounce(2 * u - 1)) / 2,
-  // damped-spring presets (ζ from damping/(2√stiffness)): 0.5 / 0.30 / 0.90
-  spring: springEase(100, 10, 0),
-  springBouncy: springEase(180, 8, 0),
-  springStiff: springEase(210, 26, 0)
-};
-var EASE_NAMES = Object.keys(EASE_TABLE);
-
 // ../core/src/evaluate.ts
 var DEG = Math.PI / 180;