@hyperframes/parsers 0.7.18 → 0.7.19

package/dist/gsapParser.d.ts

@@ -25,6 +25,15 @@ declare function addAnimationWithKeyframesToScript(script: string, targetSelecto
     id: string;
 };
 declare function removeAnimationFromScript(script: string, animationId: string): string;
+/**
+ * Recast twin of {@link dedupePositionWritesInScript} (acorn). Enforce "exactly
+ * one position write per element": keep `keepId` (or the LAST position write in
+ * source order if stale), remove every OTHER pure-position write
+ * (`propertyGroup === "position"` — tl.to/from/fromTo flat-or-keyframed, tl.set,
+ * standalone gsap.set, incl. degenerate duration:0 tweens). Non-position writes
+ * for the selector are left untouched.
+ */
+declare function dedupePositionWritesInScript(script: string, selector: string, keepId?: string): string;
 /** True for a `tl.set(...)` this module emitted to hold a keyframe before its tween.
  * The Studio filters these out so they never appear as user keyframes/diamonds. */
 declare function isStudioHoldSet(anim: GsapAnimation): boolean;
@@ -65,6 +74,29 @@ declare function addKeyframeToScript(script: string, animationId: string, percen
  * remaining keyframe's properties.
  */
 declare function removeKeyframeFromScript(script: string, animationId: string, percentage: number): string;
+/**
+ * Retime a keyframe: move the keyframe at `fromPercentage` to `toPercentage`,
+ * PRESERVING its properties and per-keyframe ease (the Studio "Move to Playhead"
+ * gesture). Re-sorts keyframes by percentage. If a keyframe already exists at
+ * `toPercentage`, it is overwritten by the moved one (no duplicate). No-op when
+ * the animation/keyframe isn't found, the tween has no object-form keyframes, or
+ * the move resolves onto the same keyframe. Acorn twin: moveKeyframeInScript.
+ */
+declare function moveKeyframeInScript(script: string, animationId: string, fromPercentage: number, toPercentage: number): string;
+/**
+ * Resize a keyframed tween's window (boundary drag-to-retime): set the tween's
+ * `position` + `duration` and RE-KEY each existing keyframe to its new percentage
+ * via `pctRemap` (each `{ from, to }` matches an existing keyframe by its current
+ * tween-% and re-keys it to `to`).
+ *
+ * Re-keys the percentage KEY in place, leaving every value node (so `_auto` +
+ * per-keyframe `ease` survive), the keyframes-object `easeEach`, and the OUTER
+ * tween `ease` untouched. Acorn twin: resizeKeyframedTweenInScript.
+ */
+declare function resizeKeyframedTweenInScript(script: string, animationId: string, newPosition: number, newDuration: number, pctRemap: ReadonlyArray<{
+    from: number;
+    to: number;
+}>): string;
 /**
  * Replace the properties (and optionally ease) at an existing keyframe percentage.
  */
@@ -155,4 +187,4 @@ declare function unrollDynamicAnimations(script: string, animationId: string, el
     easeEach?: string;
 }>): string;
 
-export { ArcPathConfig, ArcPathSegment, GsapAnimation, ParsedGsap, type SplitAnimationsOptions, type SplitAnimationsResult, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addMotionPathPointInScript, addMotionPathToScript, convertToKeyframesInScript, isStudioHoldSet, materializeKeyframesInScript, parseGsapScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeMotionPathPointInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroups, syncPositionHoldsBeforeKeyframes, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };
+export { ArcPathConfig, ArcPathSegment, GsapAnimation, ParsedGsap, type SplitAnimationsOptions, type SplitAnimationsResult, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addMotionPathPointInScript, addMotionPathToScript, convertToKeyframesInScript, dedupePositionWritesInScript, isStudioHoldSet, materializeKeyframesInScript, moveKeyframeInScript, parseGsapScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeMotionPathPointInScript, resizeKeyframedTweenInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroups, syncPositionHoldsBeforeKeyframes, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };

package/dist/gsapParser.js

@@ -1470,9 +1470,13 @@ function removeAnimationFromScript(script, animationId) {
     target = parsed.located.find((l) => l.id === convertedId);
   }
   if (!target) return script;
-  const node = target.call.node;
-  const stmtPath = findStatementPath(target.call.path);
-  if (!stmtPath) return script;
+  removeCallFromAst(target.call);
+  return recast.print(parsed.ast).code;
+}
+function removeCallFromAst(call) {
+  const node = call.node;
+  const stmtPath = findStatementPath(call.path);
+  if (!stmtPath) return;
   const parentCall = findChainParentCall(stmtPath.node, node);
   if (parentCall) {
     parentCall.callee.object = node.callee.object;
@@ -1481,6 +1485,23 @@ function removeAnimationFromScript(script, animationId) {
   } else {
     stmtPath.prune();
   }
+}
+function dedupePositionWritesInScript(script, selector, keepId) {
+  let parsed;
+  try {
+    parsed = parseGsapAst(script);
+  } catch {
+    return script;
+  }
+  const posWrites = parsed.located.filter(
+    (l) => l.animation.targetSelector === selector && l.animation.propertyGroup === "position"
+  );
+  if (posWrites.length <= 1) return script;
+  const keeper = posWrites.find((l) => l.id === keepId) ?? posWrites[posWrites.length - 1];
+  for (const l of posWrites) {
+    if (l === keeper) continue;
+    removeCallFromAst(l.call);
+  }
   return recast.print(parsed.ast).code;
 }
 function insertInheritedStateSet(script, selector, position, properties) {
@@ -1667,6 +1688,7 @@ function percentageFromKey(key) {
   return m ? Number.parseFloat(m[1]) : Number.NaN;
 }
 var PCT_TOLERANCE = 2;
+var MOVE_NOOP_EPSILON_PCT = 0.05;
 function findKeyframePropByPct(kfNode, percentage) {
   const props = kfNode.properties;
   for (let i = 0; i < props.length; i++) {
@@ -1897,6 +1919,49 @@ function removeKeyframeFromScript(script, animationId, percentage) {
   }
   return recast.print(loc.parsed.ast).code;
 }
+function moveKeyframeInScript(script, animationId, fromPercentage, toPercentage) {
+  const loc = locateAnimationWithFallback(script, animationId);
+  if (!loc) return script;
+  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg);
+  if (!kfNode) return script;
+  const match = findKeyframePropByPct(kfNode, fromPercentage);
+  if (!match) return script;
+  if (Math.abs(fromPercentage - toPercentage) < MOVE_NOOP_EPSILON_PCT) return script;
+  const dest = findKeyframePropByPct(kfNode, toPercentage);
+  const collision = dest && dest.prop !== match.prop ? dest : null;
+  const movedValue = match.prop.value;
+  const entries = [];
+  for (const prop of filterPercentageProps(kfNode)) {
+    if (prop === match.prop) continue;
+    if (collision && prop === collision.prop) continue;
+    const pct = percentageFromKey(propKeyName(prop) ?? "");
+    if (Number.isNaN(pct)) continue;
+    entries.push({ pct, value: prop.value });
+  }
+  entries.push({ pct: toPercentage, value: movedValue });
+  entries.sort((a, b) => a.pct - b.pct);
+  kfNode.properties = entries.map((e) => {
+    const p = parseExpr(`{ ${JSON.stringify(`${e.pct}%`)}: {} }`).properties[0];
+    p.value = e.value;
+    return p;
+  });
+  return recast.print(loc.parsed.ast).code;
+}
+function resizeKeyframedTweenInScript(script, animationId, newPosition, newDuration, pctRemap) {
+  const loc = locateAnimationWithFallback(script, animationId);
+  if (!loc) return script;
+  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg);
+  if (!kfNode) return script;
+  const seen = /* @__PURE__ */ new Set();
+  for (const { from, to } of pctRemap) {
+    const match = findKeyframePropByPct(kfNode, from);
+    if (!match || seen.has(match.prop)) continue;
+    seen.add(match.prop);
+    match.prop.key = parseExpr(`{ ${JSON.stringify(`${to}%`)}: 0 }`).properties[0].key;
+  }
+  applyUpdatesToCall(loc.target.call, { position: newPosition, duration: newDuration });
+  return recast.print(loc.parsed.ast).code;
+}
 function updateKeyframeInScript(script, animationId, percentage, properties, ease) {
   const arrLoc = locateAnimationWithFallback(script, animationId);
   const arrVal = arrLoc && findPropertyNode(arrLoc.target.call.varsArg, "keyframes");
@@ -2019,6 +2084,17 @@ function removeAllKeyframesFromScript(script, animationId) {
   const collapseEntry = method === "from" ? kfEntries[0] : kfEntries[kfEntries.length - 1];
   const record = objectExpressionToRecord(collapseEntry.prop.value, loc.parsed.scope);
   collapseKeyframesToFlat(loc.target.call.varsArg, record);
+  removeVarsKey(loc.target.call.varsArg, "ease");
+  setVarsKey(loc.target.call.varsArg, "duration", 0);
+  setVarsKey(loc.target.call.varsArg, "immediateRender", true);
+  if (loc.target.animation.propertyGroup === "position") {
+    for (const l of loc.parsed.located) {
+      if (l === loc.target) continue;
+      if (l.animation.targetSelector === loc.target.animation.targetSelector && l.animation.propertyGroup === "position") {
+        removeCallFromAst(l.call);
+      }
+    }
+  }
   return recast.print(loc.parsed.ast).code;
 }
 function materializeKeyframesInScript(script, animationId, keyframes, easeEach, resolvedSelector) {
@@ -2453,18 +2529,21 @@ export {
   classifyPropertyGroup,
   classifyTweenPropertyGroup,
   convertToKeyframesInScript,
+  dedupePositionWritesInScript,
   generateSpringEaseData,
   getAnimationsForElementId,
   gsapAnimationsToKeyframes,
   isStudioHoldSet,
   keyframesToGsapAnimations,
   materializeKeyframesInScript,
+  moveKeyframeInScript,
   parseGsapScript,
   removeAllKeyframesFromScript,
   removeAnimationFromScript,
   removeArcPathFromScript,
   removeKeyframeFromScript,
   removeMotionPathPointInScript,
+  resizeKeyframedTweenInScript,
   scalePositionsInScript,
   serializeGsapAnimations,
   setArcPathInScript,