reframe-video 0.6.23 → 0.6.25

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "reframe",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Create and iterate motion-graphics videos as addressable data: deterministic mp4 renders, human edits that survive AI regeneration, label-anchored audio, data-driven batch rendering.",
   "author": {
     "name": "Kiyeon Jeon",

package/dist/bin.js

@@ -353,6 +353,71 @@ var init_compile = __esm({
   }
 });
 
+// ../core/src/interpolate.ts
+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 BACK_C1, BACK_C2, BACK_C3, ELASTIC_C4, ELASTIC_C5, EASE_TABLE, EASE_NAMES;
+var init_interpolate = __esm({
+  "../core/src/interpolate.ts"() {
+    "use strict";
+    BACK_C1 = 1.70158;
+    BACK_C2 = BACK_C1 * 1.525;
+    BACK_C3 = BACK_C1 + 1;
+    ELASTIC_C4 = 2 * Math.PI / 3;
+    ELASTIC_C5 = 2 * Math.PI / 4.5;
+    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)
+    };
+    EASE_NAMES = Object.keys(EASE_TABLE);
+  }
+});
+
 // ../core/src/validate.ts
 function validateScene(ir) {
   const problems = [];
@@ -449,6 +514,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)) {
@@ -476,6 +561,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}"`);
         }
@@ -485,6 +571,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);
@@ -505,6 +592,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":
@@ -626,10 +714,12 @@ function validateComposition(comp) {
   }
   if (problems.length > 0) throw new SceneValidationError(problems);
 }
-var FX_PROPS, BLEND_MODES, IMAGE_FITS, COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
+var EASE_SET, FX_PROPS, BLEND_MODES, IMAGE_FITS, COMMON_PROPS, CAMERA_PROPS, PROPS_BY_TYPE, SceneValidationError, TRANSITIONS;
 var init_validate = __esm({
   "../core/src/validate.ts"() {
     "use strict";
+    init_interpolate();
+    EASE_SET = new Set(EASE_NAMES);
     FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
     BLEND_MODES = /* @__PURE__ */ new Set([
       "normal",
@@ -1366,71 +1456,6 @@ var init_behaviors = __esm({
   }
 });
 
-// ../core/src/interpolate.ts
-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 BACK_C1, BACK_C2, BACK_C3, ELASTIC_C4, ELASTIC_C5, EASE_TABLE, EASE_NAMES;
-var init_interpolate = __esm({
-  "../core/src/interpolate.ts"() {
-    "use strict";
-    BACK_C1 = 1.70158;
-    BACK_C2 = BACK_C1 * 1.525;
-    BACK_C3 = BACK_C1 + 1;
-    ELASTIC_C4 = 2 * Math.PI / 3;
-    ELASTIC_C5 = 2 * Math.PI / 4.5;
-    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)
-    };
-    EASE_NAMES = Object.keys(EASE_TABLE);
-  }
-});
-
 // ../core/src/evaluate.ts
 var DEG;
 var init_evaluate = __esm({

package/dist/browserEntry.js

@@ -341,72 +341,6 @@
     };
   }
 
-  // ../core/src/validate.ts
-  var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
-  var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "z", "rotateX", "rotateY", "anchor", "fixed", ...FX_PROPS];
-  var PROPS_BY_TYPE = {
-    rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
-    ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
-    line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
-    text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "prefix", "suffix", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
-    image: [...COMMON_PROPS, "src", "width", "height", "fit"],
-    video: [...COMMON_PROPS, "src", "width", "height", "fit", "start", "rate", "clipStart", "volume", "fadeIn", "pan"],
-    path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
-    group: COMMON_PROPS
-  };
-
-  // ../core/src/camera.ts
-  function cameraMatrix(cam, size) {
-    const W = size.width;
-    const H = size.height;
-    const x = cam.x ?? W / 2;
-    const y = cam.y ?? H / 2;
-    const zoom = cam.zoom ?? 1;
-    const r = (cam.rotation ?? 0) * Math.PI / 180;
-    const a = Math.cos(r) * zoom;
-    const b = Math.sin(r) * zoom;
-    const c = b === 0 ? 0 : -b;
-    const d = Math.cos(r) * zoom;
-    return [a, b, c, d, W / 2 - a * x - c * y, H / 2 - b * x - d * y];
-  }
-
-  // ../core/src/gradient.ts
-  function isGradient(p) {
-    return typeof p === "object" && p !== null && (p.kind === "linear" || p.kind === "radial" || p.kind === "conic");
-  }
-
-  // ../core/src/presets.ts
-  var SET = 1 / 120;
-
-  // ../core/src/behaviors.ts
-  function sampleBehavior(b, t) {
-    switch (b.name) {
-      case "oscillate": {
-        const { amplitude, frequency, phase = 0 } = b.params;
-        return amplitude * Math.sin(2 * Math.PI * frequency * t + phase);
-      }
-      case "wiggle": {
-        const { amplitude, frequency, seed } = b.params;
-        return amplitude * valueNoise(t * frequency, seed);
-      }
-    }
-  }
-  function valueNoise(x, seed) {
-    const i = Math.floor(x);
-    const f = x - i;
-    const u = f * f * (3 - 2 * f);
-    const a = hash01(i, seed) * 2 - 1;
-    const b = hash01(i + 1, seed) * 2 - 1;
-    return a + (b - a) * u;
-  }
-  function hash01(n, seed) {
-    let h = n * 374761393 + seed * 668265263 | 0;
-    h = h ^ h >>> 13 | 0;
-    h = Math.imul(h, 1274126177);
-    h = (h ^ h >>> 16) >>> 0;
-    return h / 4294967295;
-  }
-
   // ../core/src/interpolate.ts
   var BACK_C1 = 1.70158;
   var BACK_C2 = BACK_C1 * 1.525;
@@ -585,6 +519,73 @@
     return s;
   }
 
+  // ../core/src/validate.ts
+  var EASE_SET = new Set(EASE_NAMES);
+  var FX_PROPS = ["blur", "shadowColor", "shadowBlur", "shadowX", "shadowY", "blend"];
+  var COMMON_PROPS = ["x", "y", "opacity", "rotation", "scale", "scaleX", "scaleY", "skewX", "skewY", "z", "rotateX", "rotateY", "anchor", "fixed", ...FX_PROPS];
+  var PROPS_BY_TYPE = {
+    rect: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth", "radius"],
+    ellipse: [...COMMON_PROPS, "width", "height", "fill", "stroke", "strokeWidth"],
+    line: ["x1", "y1", "x2", "y2", "stroke", "strokeWidth", "opacity", "progress", ...FX_PROPS],
+    text: [...COMMON_PROPS, "content", "contentDecimals", "contentThousands", "prefix", "suffix", "fontFamily", "fontSize", "fontWeight", "fill", "letterSpacing"],
+    image: [...COMMON_PROPS, "src", "width", "height", "fit"],
+    video: [...COMMON_PROPS, "src", "width", "height", "fit", "start", "rate", "clipStart", "volume", "fadeIn", "pan"],
+    path: [...COMMON_PROPS, "d", "fill", "stroke", "strokeWidth", "progress", "originX", "originY"],
+    group: COMMON_PROPS
+  };
+
+  // ../core/src/camera.ts
+  function cameraMatrix(cam, size) {
+    const W = size.width;
+    const H = size.height;
+    const x = cam.x ?? W / 2;
+    const y = cam.y ?? H / 2;
+    const zoom = cam.zoom ?? 1;
+    const r = (cam.rotation ?? 0) * Math.PI / 180;
+    const a = Math.cos(r) * zoom;
+    const b = Math.sin(r) * zoom;
+    const c = b === 0 ? 0 : -b;
+    const d = Math.cos(r) * zoom;
+    return [a, b, c, d, W / 2 - a * x - c * y, H / 2 - b * x - d * y];
+  }
+
+  // ../core/src/gradient.ts
+  function isGradient(p) {
+    return typeof p === "object" && p !== null && (p.kind === "linear" || p.kind === "radial" || p.kind === "conic");
+  }
+
+  // ../core/src/presets.ts
+  var SET = 1 / 120;
+
+  // ../core/src/behaviors.ts
+  function sampleBehavior(b, t) {
+    switch (b.name) {
+      case "oscillate": {
+        const { amplitude, frequency, phase = 0 } = b.params;
+        return amplitude * Math.sin(2 * Math.PI * frequency * t + phase);
+      }
+      case "wiggle": {
+        const { amplitude, frequency, seed } = b.params;
+        return amplitude * valueNoise(t * frequency, seed);
+      }
+    }
+  }
+  function valueNoise(x, seed) {
+    const i = Math.floor(x);
+    const f = x - i;
+    const u = f * f * (3 - 2 * f);
+    const a = hash01(i, seed) * 2 - 1;
+    const b = hash01(i + 1, seed) * 2 - 1;
+    return a + (b - a) * u;
+  }
+  function hash01(n, seed) {
+    let h = n * 374761393 + seed * 668265263 | 0;
+    h = h ^ h >>> 13 | 0;
+    h = Math.imul(h, 1274126177);
+    h = (h ^ h >>> 16) >>> 0;
+    return h / 4294967295;
+  }
+
   // ../core/src/evaluate.ts
   var IDENTITY = [1, 0, 0, 1, 0, 0];
   function multiply(m, n) {

package/dist/cli.js

@@ -331,7 +331,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",
@@ -463,6 +523,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)) {
@@ -490,6 +570,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}"`);
         }
@@ -499,6 +580,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);
@@ -519,6 +601,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":
@@ -1068,65 +1151,6 @@ function resolveCompositionAudioPlan(comp) {
   };
 }
 
-// ../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;