reframe-video 0.6.23 → 0.6.25

package/dist/labels.js

@@ -325,7 +325,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",
@@ -457,6 +517,26 @@ function validateScene(ir) {
     );
   }
   const labels = /* @__PURE__ */ new Set();
+  const checkEase = (path3, ease) => {
+    if (ease === void 0) return;
+    if (typeof ease === "string") {
+      if (!EASE_SET.has(ease)) {
+        problems.push(`${path3}: 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(`${path3}: ease cubicBezier must be [x1, y1, x2, y2]`);
+        }
+        return;
+      }
+    }
+    problems.push(`${path3}: invalid ease \u2014 use a name, { spring }, or { cubicBezier: [x1,y1,x2,y2] }`);
+  };
   const checkTimeline = (tl, path3) => {
     if ("label" in tl && tl.label !== void 0) {
       if (labels.has(tl.label)) {
@@ -484,6 +564,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path3}: to("${tl.state}") duration must be > 0`);
         }
+        checkEase(path3, tl.ease);
         for (const id of tl.filter ?? []) {
           if (!nodeById.has(id)) problems.push(`${path3}: filter contains unknown node "${id}"`);
         }
@@ -493,6 +574,7 @@ function validateScene(ir) {
         if (tl.duration !== void 0 && tl.duration <= 0) {
           problems.push(`${path3}: tween duration must be > 0`);
         }
+        checkEase(path3, tl.ease);
         break;
       case "motionPath": {
         const node = nodeById.get(tl.target);
@@ -513,6 +595,7 @@ function validateScene(ir) {
         if (tl.curviness !== void 0 && tl.curviness < 0) {
           problems.push(`${path3}: motionPath "${tl.target}" curviness must be >= 0`);
         }
+        checkEase(path3, tl.ease);
         break;
       }
       case "wait":
@@ -609,65 +692,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/trace-cli.js

@@ -5,37 +5,6 @@ import { writeFile as writeFile2 } from "node:fs/promises";
 import { resolve as resolve2 } from "node:path";
 import { pathToFileURL } from "node:url";
 
-// ../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/dsl.ts
-function seq(...children) {
-  return { kind: "seq", children };
-}
-function par(...children) {
-  return { kind: "par", children };
-}
-function tween(target, props, opts = {}) {
-  return { kind: "tween", target, props, ...opts };
-}
-function wait(duration, label) {
-  return { kind: "wait", duration, ...label !== void 0 && { label } };
-}
-
-// ../core/src/presets.ts
-var SET = 1 / 120;
-
 // ../core/src/interpolate.ts
 var BACK_C1 = 1.70158;
 var BACK_C2 = BACK_C1 * 1.525;
@@ -95,6 +64,38 @@ var EASE_TABLE = {
 };
 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 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/dsl.ts
+function seq(...children) {
+  return { kind: "seq", children };
+}
+function par(...children) {
+  return { kind: "par", children };
+}
+function tween(target, props, opts = {}) {
+  return { kind: "tween", target, props, ...opts };
+}
+function wait(duration, label) {
+  return { kind: "wait", duration, ...label !== void 0 && { label } };
+}
+
+// ../core/src/presets.ts
+var SET = 1 / 120;
+
 // ../core/src/evaluate.ts
 var DEG = Math.PI / 180;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reframe-video",
-  "version": "0.6.23",
+  "version": "0.6.25",
   "description": "Declarative motion graphics that AI can write and humans can tweak — human edits survive AI regeneration. Deterministic mp4 renders from a plain-data scene format.",
   "keywords": [
     "motion-graphics",

package/skills/reframe/SKILL.md

@@ -11,9 +11,12 @@ runtime needs ffmpeg on PATH and a one-time `npx playwright install chromium`
 
 ## Creating a scene
 
-1. **Read the guide first** — it is the complete, current syntax (~1,700
-   tokens) and one read is enough to write valid scenes:
-   `npx -y reframe-video guide`
+1. **Read the guide first** — `npx -y reframe-video guide` is the complete,
+   current syntax. It's sectioned and sizable: read the core (Nodes, States,
+   Timeline) closely, and **skim the specialized sections by heading**
+   (perspective, track mattes, group effects, video, montage, character rig,
+   device frames, cursor, audio) — read one in full only when your scene uses
+   it. You don't need to re-read it for follow-up edits; it's already in context.
 2. Write a single self-contained `<name>.ts` in the user's directory
    (`npx -y reframe-video new <name>` scaffolds a documented starter).
    Scenes must be pure functions of time: no `Math.random()`/`Date` — use