@hyperframes/parsers 0.8.126 → 0.8.128

package/dist/gsapParserExports.d.ts

@@ -1,5 +1,19 @@
-export { A as ArcPathConfig, a as ArcPathSegment, G as GsapAnimation, b as GsapKeyframesData, c as GsapMethod, d as GsapPercentageKeyframe, e as GsapProvenance, f as GsapProvenanceKind, K as KeyframeEditability, P as PROPERTY_GROUPS, g as ParsedGsap, h as PropertyGroupName, S as SUPPORTED_EASES, i as SUPPORTED_PROPS, j as SourcedGsapPercentageKeyframe, k as SplitAnimationsOptions, l as SplitAnimationsResult, m as classifyPropertyGroup, n as classifyTweenPropertyGroup, o as editabilityForProvenance, p as getAnimationsForElementId, q as gsapAnimationsToKeyframes, r as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-CVwsMItk.js';
+export { A as ArcPathConfig, b as ArcPathSegment, u as GSAP_DEFAULT_DURATION, a as GsapAnimation, h as GsapKeyframesData, G as GsapMethod, i as GsapPercentageKeyframe, c as GsapProvenance, d as GsapProvenanceKind, K as KeyframeEditability, j as PROPERTY_GROUPS, P as ParsedGsap, k as PropertyGroupName, S as SUPPORTED_EASES, l as SUPPORTED_PROPS, w as SourcedGsapPercentageKeyframe, r as SplitAnimationsOptions, t as SplitAnimationsResult, m as classifyPropertyGroup, n as classifyTweenPropertyGroup, f as editabilityForProvenance, o as getAnimationsForElementId, p as gsapAnimationsToKeyframes, q as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-CfSXM_Ez.js';
 export { isStudioHoldSet } from './gsapParser.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
 export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
 import './types-Ejqndkej.js';
+
+interface ObjectArrayKeyframeTiming {
+    percentages: number[];
+    totalDuration: number;
+}
+/**
+ * Resolve GSAP object-array keyframe positions exactly once for parsers and writers.
+ * Each step's keyframe sits at its cumulative end; a step without a duration plays
+ * GSAP's default. A non-positive or unresolved duration leaves the timing unresolved:
+ * callers must preserve the source rather than silently invent different timing.
+ */
+declare function getObjectArrayKeyframeTiming(durations: ReadonlyArray<unknown>): ObjectArrayKeyframeTiming | null;
+
+export { getObjectArrayKeyframeTiming };

package/dist/gsapParserExports.js

@@ -1,4 +1,5 @@
 // src/gsapConstants.ts
+var GSAP_DEFAULT_DURATION = 0.5;
 var SUPPORTED_PROPS = [
   // 2D Transforms
   "x",
@@ -39,6 +40,22 @@ var SUPPORTED_PROPS = [
   // DOM content (number counters, text roll-ups)
   "innerText"
 ];
+var BUILTIN_VAR_KEYS = /* @__PURE__ */ new Set(["duration", "ease", "delay"]);
+var DROPPED_VAR_KEYS = /* @__PURE__ */ new Set([
+  "onComplete",
+  "onStart",
+  "onUpdate",
+  "onRepeat"
+]);
+var EXTRAS_KEYS = /* @__PURE__ */ new Set([
+  "stagger",
+  "yoyo",
+  "repeat",
+  "repeatDelay",
+  "snap",
+  "overwrite",
+  "immediateRender"
+]);
 var PROPERTY_GROUPS = {
   position: /* @__PURE__ */ new Set(["x", "y", "xPercent", "yPercent"]),
   scale: /* @__PURE__ */ new Set(["scale", "scaleX", "scaleY"]),
@@ -329,28 +346,20 @@ import { parse as babelParse } from "@babel/parser";
 // src/gsapObjectArrayTiming.ts
 var roundPercentage = (percentage) => Math.round(percentage * 10) / 10;
 function getObjectArrayKeyframeTiming(durations) {
-  const hasAuthoredDuration = durations.some((duration) => duration !== void 0);
-  if (hasAuthoredDuration) {
-    if (!durations.every(
-      (duration) => typeof duration === "number" && Number.isFinite(duration) && duration > 0
-    )) {
-      return null;
-    }
-    const totalDuration = durations.reduce((sum, duration) => sum + duration, 0);
-    let cumulative = 0;
-    return {
-      percentages: durations.map((duration) => {
-        cumulative += duration;
-        return roundPercentage(cumulative / totalDuration * 100);
-      }),
-      totalDuration
-    };
+  const steps = durations.map((duration) => duration ?? GSAP_DEFAULT_DURATION);
+  if (!steps.every(
+    (duration) => typeof duration === "number" && Number.isFinite(duration) && duration > 0
+  )) {
+    return null;
   }
-  const lastIndex = durations.length - 1;
+  const totalDuration = steps.reduce((sum, duration) => sum + duration, 0);
+  let cumulative = 0;
   return {
-    percentages: durations.map(
-      (_, index) => lastIndex > 0 ? roundPercentage(index / lastIndex * 100) : 0
-    )
+    percentages: steps.map((duration) => {
+      cumulative += duration;
+      return roundPercentage(cumulative / totalDuration * 100);
+    }),
+    totalDuration
   };
 }
 
@@ -1445,17 +1454,6 @@ function findTimelineVar(ast, scope) {
   });
   return { timelineVar, ref, timelineCount, defaults };
 }
-var BUILTIN_VAR_KEYS = /* @__PURE__ */ new Set(["duration", "ease", "delay"]);
-var DROPPED_VAR_KEYS = /* @__PURE__ */ new Set(["onComplete", "onStart", "onUpdate", "onRepeat"]);
-var EXTRAS_KEYS = /* @__PURE__ */ new Set([
-  "stagger",
-  "yoyo",
-  "repeat",
-  "repeatDelay",
-  "snap",
-  "overwrite",
-  "immediateRender"
-]);
 function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;
   while (obj?.type === "CallExpression") {
@@ -1534,6 +1532,7 @@ function parsePercentageKeyframes(node, scope, source) {
     if (typeof key !== "string") continue;
     const pctMatch = PERCENTAGE_KEY_RE.exec(key);
     if (pctMatch) {
+      if (!isPlainStep(prop.value)) return void 0;
       const percentage = Number.parseFloat(pctMatch[1] ?? "0");
       const record = objectExpressionToRecord(prop.value, scope, source);
       const properties = {};
@@ -1552,6 +1551,8 @@ function parsePercentageKeyframes(node, scope, source) {
       ease = tryResolveStringProp(prop.value, scope, source) ?? ease;
     } else if (key === "easeEach") {
       easeEach = tryResolveStringProp(prop.value, scope, source) ?? easeEach;
+    } else {
+      return void 0;
     }
   }
   keyframes.sort((a, b) => a.percentage - b.percentage);
@@ -1575,11 +1576,19 @@ function computeKeyframesTotalDuration(varsNode, scope, source) {
   }
   return getObjectArrayKeyframeTiming(durations)?.totalDuration;
 }
+function staticKeyName(prop) {
+  if (prop.type !== "ObjectProperty" && prop.type !== "Property") return void 0;
+  if (prop.method || prop.kind && prop.kind !== "init") return void 0;
+  const key = prop.computed ? prop.key?.type === "Literal" && prop.key.value : prop.key?.name ?? prop.key?.value;
+  return typeof key === "string" ? key : void 0;
+}
+var isPlainObject = (node) => node?.type === "ObjectExpression" && (node.properties ?? []).every((p) => staticKeyName(p) !== void 0);
+var isPlainStep = (node) => node?.type === "Literal" || isPlainObject(node);
 function parseObjectArrayKeyframes(node, scope, source) {
   const elements = node.elements ?? [];
   const raw = [];
   for (const el of elements) {
-    if (!el || el.type !== "ObjectExpression") continue;
+    if (!isPlainObject(el)) return void 0;
     const record = objectExpressionToRecord(el, scope, source);
     const properties = {};
     let duration;
@@ -1591,6 +1600,8 @@ function parseObjectArrayKeyframes(node, scope, source) {
         ease = v;
       } else if (typeof v === "number" || typeof v === "string") {
         properties[k] = v;
+      } else {
+        return void 0;
       }
     }
     raw.push({ properties, duration, ease });
@@ -1616,9 +1627,8 @@ function parseSimpleArrayKeyframes(node, scope) {
       const values = [];
       for (const el of prop.value.elements ?? []) {
         const val = resolveNode(el, scope);
-        if (typeof val === "number" || typeof val === "string") {
-          values.push(val);
-        }
+        if (typeof val !== "number" && typeof val !== "string") return void 0;
+        values.push(val);
       }
       if (values.length > 0) arrayProps.set(key, values);
     } else if (key === "ease") {
@@ -1651,6 +1661,7 @@ function parseKeyframesNode(node, scope, source) {
   }
   if (node.type !== "ObjectExpression") return void 0;
   const props = node.properties ?? [];
+  if (!props.every((p) => staticKeyName(p) !== void 0)) return void 0;
   let hasPercentageKey = false;
   let hasArrayValue = false;
   for (const prop of props) {
@@ -1751,7 +1762,7 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
         percentage: waypoints.length > 1 ? Math.round(i / (waypoints.length - 1) * 100) : 0,
         properties: { x: wp.x, y: wp.y }
       }));
-      keyframesData = { format: "percentage", keyframes: kf };
+      keyframesData = { format: "percentage", keyframes: kf, fromMotionPath: true };
     } else {
       const kfs = keyframesData.keyframes;
       if (kfs.length === waypoints.length) {
@@ -1781,10 +1792,10 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
   const position = typeof posVal === "number" ? posVal : typeof posVal === "string" ? posVal : hasPositionArg ? `__raw:${source.slice(call.positionArg.start, call.positionArg.end)}` : 0;
   let duration = typeof vars.duration === "number" ? vars.duration : void 0;
   const ease = typeof vars.ease === "string" ? vars.ease : void 0;
-  if (duration === void 0 && keyframesData) {
+  const durationUnresolved = call.method !== "set" && duration === void 0 && hasUnknownDuration(call.varsArg, scope);
+  if (duration === void 0 && keyframesData && !durationUnresolved) {
     duration = computeKeyframesTotalDuration(call.varsArg, scope, source);
   }
-  const durationUnresolved = call.method !== "set" && duration === void 0 && hasUnknownDuration(call.varsArg, scope);
   let selector = call.selector;
   let targetIdentity;
   if (selector === "__unresolved__") {
@@ -1879,7 +1890,6 @@ function annotateStaggeredCollections(anims) {
     anim.keyframes = { format: "percentage", keyframes: staggeredKeyframes(anim, each) };
   }
 }
-var GSAP_DEFAULT_DURATION = 0.5;
 function resolvePositionString(pos, cursor, prevStart) {
   const trimmed = pos.trim();
   if (trimmed === "") return cursor;
@@ -1961,7 +1971,7 @@ function applyTimelineDefaults(anims, defaults) {
       if (defaults.duration !== void 0) anim.duration = defaults.duration;
       else if (defaults.durationUnresolved) anim.durationUnresolved = true;
     }
-    if (anim.ease === void 0 && defaults.ease !== void 0 && !anim.keyframes) {
+    if (anim.ease === void 0 && defaults.ease !== void 0 && (!anim.keyframes || anim.keyframes.fromMotionPath)) {
       anim.ease = defaults.ease;
     }
   }
@@ -2152,6 +2162,7 @@ function parseGsapScriptAcornUncached(script) {
   }
 }
 export {
+  GSAP_DEFAULT_DURATION,
   PROPERTY_GROUPS,
   SPRING_PRESETS,
   SUPPORTED_EASES,
@@ -2161,6 +2172,7 @@ export {
   editabilityForProvenance,
   generateSpringEaseData,
   getAnimationsForElementId,
+  getObjectArrayKeyframeTiming,
   gsapAnimationsToKeyframes,
   isStudioHoldSet,
   keyframesToGsapAnimations,