@hyperframes/core 0.7.78 → 0.7.80

package/dist/runtime/customEase.d.ts

@@ -0,0 +1,9 @@
+type RuntimeEase = (progress: number) => number;
+type GsapEaseApi = {
+    parseEase?: (ease: string | RuntimeEase, ...args: unknown[]) => RuntimeEase | null;
+    registerEase?: (name: string, ease: RuntimeEase) => void;
+    __hfCustomEaseInstalled?: boolean;
+};
+export declare function installStudioCustomEase(gsap: GsapEaseApi): boolean;
+export {};
+//# sourceMappingURL=customEase.d.ts.map

package/dist/runtime/customEase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEase.d.ts","sourceRoot":"","sources":["../../src/runtime/customEase.ts"],"names":[],"mappings":"AAIA,KAAK,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAIhD,KAAK,WAAW,GAAG;IACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,WAAW,GAAG,IAAI,CAAC;IACnF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACzD,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AA8EF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CA8DlE"}

package/dist/runtime/customEase.js

@@ -0,0 +1,128 @@
+import { evaluateSpringEase, parseSpringBounce } from "../parsers/springEase.js";
+import { emitAnalyticsEvent } from "./analytics.js";
+import { resolveWiggleEase } from "./wiggleEase.js";
+const BISECTION_STEPS = 24;
+const HOLD_EASE = (progress) => (progress >= 1 ? 1 : 0);
+const IDENTITY_EASE = (progress) => progress;
+const NUMBER_SOURCE = String.raw `([+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?)`;
+// Studio authors one cubic-bezier segment with fixed (0,0) and (1,1)
+// endpoints. Anticipation/overshoot is represented by Y controls outside
+// [0,1]; X controls stay in [0,1] so progress remains a function of time.
+const CUSTOM_CUBIC_PATH = new RegExp(String.raw `^\s*M\s*0\s*,\s*0\s+C\s*${NUMBER_SOURCE}\s*,\s*${NUMBER_SOURCE}\s+${NUMBER_SOURCE}\s*,\s*${NUMBER_SOURCE}\s+1\s*,\s*1\s*$`, "i");
+function cubicCoordinate(t, point1, point2) {
+    const inverse = 1 - t;
+    return 3 * inverse * inverse * t * point1 + 3 * inverse * t * t * point2 + t * t * t;
+}
+function evaluateCubicBezier(progress, x1, y1, x2, y2) {
+    if (!Number.isFinite(progress))
+        return progress;
+    if (progress <= 0)
+        return 0;
+    if (progress >= 1)
+        return 1;
+    let low = 0;
+    let high = 1;
+    for (let step = 0; step < BISECTION_STEPS; step += 1) {
+        const t = (low + high) / 2;
+        if (cubicCoordinate(t, x1, x2) < progress)
+            low = t;
+        else
+            high = t;
+    }
+    return cubicCoordinate((low + high) / 2, y1, y2);
+}
+function createCubicBezierEase(path) {
+    const match = CUSTOM_CUBIC_PATH.exec(path);
+    if (!match)
+        return null;
+    const x1 = Number(match[1]);
+    const y1 = Number(match[2]);
+    const x2 = Number(match[3]);
+    const y2 = Number(match[4]);
+    if (Math.min(x1, x2) < 0 || Math.max(x1, x2) > 1)
+        return null;
+    return (progress) => evaluateCubicBezier(progress, x1, y1, x2, y2);
+}
+function resolveSpringEase(ease, springEaseCache) {
+    if (!ease.startsWith("spring("))
+        return null;
+    const bounce = parseSpringBounce(ease);
+    if (bounce === null)
+        return null;
+    const cached = springEaseCache.get(bounce);
+    if (cached)
+        return cached;
+    const springEase = (progress) => evaluateSpringEase(progress, bounce);
+    springEaseCache.set(bounce, springEase);
+    return springEase;
+}
+function resolveCustomEase(ease, customEaseCache) {
+    if (!ease.startsWith("custom(") || !ease.endsWith(")"))
+        return null;
+    const path = ease.slice(7, -1);
+    const cached = customEaseCache.get(path);
+    if (cached)
+        return cached;
+    const customEase = createCubicBezierEase(path);
+    if (customEase)
+        customEaseCache.set(path, customEase);
+    return customEase;
+}
+export function installStudioCustomEase(gsap) {
+    if (gsap.__hfCustomEaseInstalled)
+        return true;
+    const originalParseEase = gsap.parseEase;
+    if (!originalParseEase)
+        return false;
+    const customEaseCache = new Map();
+    const springEaseCache = new Map();
+    const wiggleEaseCache = new Map();
+    // Single source of truth for "hyperframes ease string -> function". Both the
+    // public parseEase override and the internal registerEase configs below route
+    // through this, so the resolution rules live in exactly one place.
+    const resolveHyperframesEase = (ease) => {
+        if (typeof ease !== "string")
+            return null;
+        if (ease === "hold")
+            return HOLD_EASE;
+        return (resolveWiggleEase(ease, wiggleEaseCache) ??
+            resolveSpringEase(ease, springEaseCache) ??
+            resolveCustomEase(ease, customEaseCache));
+    };
+    const parseEaseWithFallback = (ease, context, args = []) => {
+        const resolved = resolveHyperframesEase(ease);
+        if (resolved)
+            return resolved;
+        if (typeof ease === "string" && /^(?:hold|spring|wiggle|custom)(?:\(|$)/.test(ease.trim())) {
+            emitAnalyticsEvent("custom_ease_parse_failed", { ease });
+        }
+        return originalParseEase.call(context, ease, ...args) ?? IDENTITY_EASE;
+    };
+    // Public parseEase: direct callers (studio ease UI, adapters) resolve
+    // synchronously; anything else falls through to GSAP's own parser.
+    gsap.parseEase = function parseHyperframesEase(ease, ...args) {
+        return parseEaseWithFallback(ease, this, args);
+    };
+    // GSAP resolves a keyframe SEGMENT's ease through its INTERNAL _parseEase /
+    // _easeMap, never the public parseEase above — so a custom ease used inside
+    // `keyframes:{...}` resolves to undefined and throws "_ease is not a function"
+    // on the first render. Register the eases in the internal map too. GSAP calls
+    // a configurable ease's `.config(...params)` with the parenthesized string
+    // comma-split, so `params.join(",")` losslessly reconstructs the original
+    // (including custom() bezier paths, whose commas survive the round-trip).
+    const registerEase = gsap.registerEase;
+    if (typeof registerEase === "function") {
+        registerEase("hold", HOLD_EASE);
+        const registerConfigurable = (name) => {
+            const base = (progress) => progress;
+            base.config = (...params) => parseEaseWithFallback(`${name}(${params.join(",")})`, gsap);
+            registerEase(name, base);
+        };
+        registerConfigurable("spring");
+        registerConfigurable("wiggle");
+        registerConfigurable("custom");
+    }
+    gsap.__hfCustomEaseInstalled = true;
+    return true;
+}
+//# sourceMappingURL=customEase.js.map

package/dist/runtime/customEase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customEase.js","sourceRoot":"","sources":["../../src/runtime/customEase.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.78",
+  "version": "0.7.80",
   "description": "",
   "repository": {
     "type": "git",
@@ -87,6 +87,10 @@
       "import": "./dist/runtime/clipTree.js",
       "types": "./dist/runtime/clipTree.d.ts"
     },
+    "./runtime/custom-ease": {
+      "import": "./dist/runtime/customEase.js",
+      "types": "./dist/runtime/customEase.d.ts"
+    },
     "./runtime/start-expression": {
       "import": "./dist/runtime/startExpression.js",
       "types": "./dist/runtime/startExpression.d.ts"
@@ -206,9 +210,9 @@
     "bpm-detective": "^2.0.5",
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
-    "@hyperframes/lint": "0.7.78",
-    "@hyperframes/parsers": "0.7.78",
-    "@hyperframes/studio-server": "0.7.78"
+    "@hyperframes/lint": "0.7.80",
+    "@hyperframes/studio-server": "0.7.80",
+    "@hyperframes/parsers": "0.7.80"
   },
   "devDependencies": {
     "@types/jsdom": "^28.0.0",