@hyperframes/parsers 0.7.62 → 0.7.64

package/dist/gsapWriterAcorn.d.ts

@@ -113,7 +113,25 @@ declare function addLabelToScript(script: string, name: string, position: number
 declare function removeLabelFromScript(script: string, name: string): string;
 declare function setArcPathInScript(script: string, animationId: string, config: ArcPathConfig): string;
 declare function updateArcSegmentInScript(script: string, animationId: string, segmentIndex: number, update: Partial<ArcPathSegment>): string;
+declare function updateMotionPathPointInScript(script: string, animationId: string, pointIndex: number, point: {
+    x: number;
+    y: number;
+}): string;
+declare function addMotionPathPointInScript(script: string, animationId: string, index: number, point: {
+    x: number;
+    y: number;
+}): string;
+declare function removeMotionPathPointInScript(script: string, animationId: string, index: number): string;
+declare function addMotionPathToScript(script: string, targetSelector: string, position: number, duration: number, point: {
+    x: number;
+    y: number;
+}, ease?: string): {
+    script: string;
+    id: string | null;
+};
 declare function removeArcPathFromScript(script: string, animationId: string): string;
+/** Acorn-native, byte-preserving hold synchronization used after mutations. */
+declare function syncPositionHoldsBeforeKeyframes(script: string): string;
 declare function splitAnimationsInScript(script: string, opts: SplitAnimationsOptions): SplitAnimationsResult;
 type UnrollElement = {
     selector: string;
@@ -131,4 +149,4 @@ type UnrollElement = {
  */
 declare function unrollDynamicAnimations(script: string, animationId: string, elements: UnrollElement[]): string;
 
-export { type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, convertToKeyframesFromScript, dedupePositionWritesInScript, materializeKeyframesFromScript, moveKeyframeInScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removePropertyFromAnimation, resizeKeyframedTweenInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript };
+export { type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, addMotionPathPointInScript, addMotionPathToScript, convertToKeyframesFromScript, dedupePositionWritesInScript, materializeKeyframesFromScript, moveKeyframeInScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removeMotionPathPointInScript, removePropertyFromAnimation, resizeKeyframedTweenInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };

package/dist/gsapWriterAcorn.js

@@ -2418,6 +2418,72 @@ function updateArcSegmentInScript(script, animationId, segmentIndex, update) {
   ms.overwrite(mpProp.value.start, mpProp.value.end, motionPathCode);
   return ms.toString();
 }
+function hasCubicSegments(segments) {
+  return segments.some((segment) => segment.cp1 != null || segment.cp2 != null);
+}
+function writeMotionPathValue(script, target, waypoints, segments, autoRotate) {
+  const motionPath = findPropertyNode2(target.call.varsArg, "motionPath");
+  if (!motionPath) return script;
+  const code = buildMotionPathObjectCode({ waypoints, segments, autoRotate });
+  const ms = new MagicString(script);
+  ms.overwrite(motionPath.value.start, motionPath.value.end, code);
+  return ms.toString();
+}
+function updateMotionPathPointInScript(script, animationId, pointIndex, point) {
+  const parsed = parseGsapScriptAcornForWrite(script);
+  const target = parsed?.located.find((entry) => entry.id === animationId);
+  if (!target?.animation.arcPath?.enabled) return script;
+  const waypoints = extractArcWaypoints(target.animation);
+  if (waypoints.length < 2 || pointIndex < 0 || pointIndex >= waypoints.length) return script;
+  const next = waypoints.map((waypoint, index) => index === pointIndex ? { ...point } : waypoint);
+  return writeMotionPathValue(
+    script,
+    target,
+    next,
+    target.animation.arcPath.segments,
+    target.animation.arcPath.autoRotate
+  );
+}
+function addMotionPathPointInScript(script, animationId, index, point) {
+  const parsed = parseGsapScriptAcornForWrite(script);
+  const target = parsed?.located.find((entry) => entry.id === animationId);
+  const arc = target?.animation.arcPath;
+  if (!target || !arc?.enabled || hasCubicSegments(arc.segments)) return script;
+  const waypoints = extractArcWaypoints(target.animation);
+  if (index < 1 || index > waypoints.length - 1) return script;
+  const segments = [...arc.segments];
+  waypoints.splice(index, 0, { ...point });
+  segments.splice(index - 1, 0, { curviness: segments[index - 1]?.curviness ?? 1 });
+  return writeMotionPathValue(script, target, waypoints, segments, arc.autoRotate);
+}
+function removeMotionPathPointInScript(script, animationId, index) {
+  const parsed = parseGsapScriptAcornForWrite(script);
+  const target = parsed?.located.find((entry) => entry.id === animationId);
+  const arc = target?.animation.arcPath;
+  if (!target || !arc?.enabled || hasCubicSegments(arc.segments)) return script;
+  const waypoints = extractArcWaypoints(target.animation);
+  if (waypoints.length <= 2 || index < 0 || index >= waypoints.length) return script;
+  const segments = [...arc.segments];
+  waypoints.splice(index, 1);
+  segments.splice(Math.min(index, segments.length - 1), 1);
+  return writeMotionPathValue(script, target, waypoints, segments, arc.autoRotate);
+}
+function addMotionPathToScript(script, targetSelector, position, duration, point, ease = "power1.inOut") {
+  const motionPath = buildMotionPathObjectCode({
+    waypoints: [{ x: 0, y: 0 }, { ...point }],
+    segments: [{ curviness: 1 }],
+    autoRotate: false
+  });
+  const result = addAnimationToScript(script, {
+    targetSelector,
+    method: "to",
+    position,
+    duration,
+    ease,
+    properties: { motionPath: `__raw:${motionPath}` }
+  });
+  return { script: result.script, id: result.id || null };
+}
 function removeArcPathFromScript(script, animationId) {
   return setArcPathInScript(script, animationId, {
     enabled: false,
@@ -2456,6 +2522,57 @@ function insertInheritedStateSetInScript(script, selector, position, properties)
   }
   return ms.toString();
 }
+var STUDIO_HOLD_MARKER = "hf-hold";
+function isStudioHoldSet(animation) {
+  return animation.method === "set" && animation.properties.data === STUDIO_HOLD_MARKER;
+}
+function removeStudioHoldSets(script, parsed) {
+  const staleHolds = parsed.located.filter((entry) => isStudioHoldSet(entry.animation));
+  if (staleHolds.length === 0) return script;
+  const ms = new MagicString(script);
+  for (const hold of staleHolds) removeCallFromMagicString(ms, hold.call, script);
+  return ms.toString();
+}
+function animationStart(animation) {
+  if (animation.resolvedStart !== void 0) return animation.resolvedStart;
+  return typeof animation.position === "number" ? animation.position : 0;
+}
+function positionProperties(properties) {
+  const position = {};
+  for (const [property, value] of Object.entries(properties)) {
+    if (classifyPropertyGroup(property) === "position" && typeof value === "number") {
+      position[property] = value;
+    }
+  }
+  return position;
+}
+function positionHoldForAnimation(animation) {
+  if (!animation.keyframes) return null;
+  if (!(animationStart(animation) > 1e-3)) return null;
+  const first = [...animation.keyframes.keyframes].sort(
+    (left, right) => left.percentage - right.percentage
+  )[0];
+  if (!first) return null;
+  const position = positionProperties(first.properties);
+  return Object.keys(position).length > 0 ? position : null;
+}
+function syncPositionHoldsBeforeKeyframes(script) {
+  const parsed = parseGsapScriptAcornForWrite(script);
+  if (!parsed) return script;
+  let result = removeStudioHoldSets(script, parsed);
+  const current = parseGsapScriptAcornForWrite(result);
+  if (!current) return result;
+  for (const entry of current.located) {
+    const animation = entry.animation;
+    const position = positionHoldForAnimation(animation);
+    if (!position) continue;
+    result = insertInheritedStateSetInScript(result, animation.targetSelector, 0, {
+      ...position,
+      data: STUDIO_HOLD_MARKER
+    });
+  }
+  return result;
+}
 function computeForwardBaselines(matching, splitTime) {
   const before = [];
   const acc = {};
@@ -2746,6 +2863,8 @@ export {
   addAnimationWithKeyframesToScript,
   addKeyframeToScript,
   addLabelToScript,
+  addMotionPathPointInScript,
+  addMotionPathToScript,
   convertToKeyframesFromScript,
   dedupePositionWritesInScript,
   materializeKeyframesFromScript,
@@ -2755,6 +2874,7 @@ export {
   removeArcPathFromScript,
   removeKeyframeFromScript,
   removeLabelFromScript,
+  removeMotionPathPointInScript,
   removePropertyFromAnimation,
   resizeKeyframedTweenInScript,
   scalePositionsInScript,
@@ -2762,9 +2882,11 @@ export {
   shiftPositionsInScript,
   splitAnimationsInScript,
   splitIntoPropertyGroupsFromScript,
+  syncPositionHoldsBeforeKeyframes,
   unrollDynamicAnimations,
   updateAnimationInScript,
   updateArcSegmentInScript,
-  updateKeyframeInScript
+  updateKeyframeInScript,
+  updateMotionPathPointInScript
 };
 //# sourceMappingURL=gsapWriterAcorn.js.map