@hyperframes/parsers 0.8.98 → 0.8.100

package/dist/{gsapSerialize-b8lNzSbI.d.ts → gsapSerialize-D92cSJOu.d.ts}

@@ -62,6 +62,7 @@ interface GsapAnimation {
     hasUnresolvedKeyframes?: boolean;
     /** True when the tween's target selector couldn't be statically resolved (dynamic). */
     hasUnresolvedSelector?: boolean;
+    hasPartialSelector?: boolean;
     /** Absolute start time computed by walking the timeline chain (handles +=, -=, <, >, labels). */
     resolvedStart?: number;
     /** True when no position arg was authored — the tween is sequentially placed by GSAP. */

package/dist/gsapWriterAcorn.d.ts

@@ -1,27 +1,37 @@
-import { G as GsapAnimation, A as ArcPathConfig, g as SplitAnimationsOptions, h as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-b8lNzSbI.js';
+import { G as GsapAnimation, A as ArcPathConfig, g as SplitAnimationsOptions, h as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-D92cSJOu.js';
 import './types-Y0NXTiVo.js';
 import './gsapConstants.js';
 
+type TweenTarget = Pick<GsapAnimation, "targetSelector" | "hasPartialSelector">;
+type TweenTime = Pick<GsapAnimation, "position" | "implicitPosition">;
+declare function clipTweenMatcher(clipSelectors: string | readonly string[], root?: ParentNode): (tween: TweenTarget) => boolean;
+/** Where a GSAP script's clips live: linkedom keeps a `<template>`'s children under it, out of document queries. */
+declare function clipQueryRoot(script: Element): ParentNode;
+/** A written position; an implicit one follows the tween before it and must stay unwritten. */
+declare function hasExplicitTime<T extends TweenTime>(animation: T): animation is T & {
+    position: number;
+};
+
 declare function updateAnimationInScript(script: string, animationId: string, updates: Partial<GsapAnimation> & {
     easeEach?: string;
     resetKeyframeEases?: boolean;
 }): string;
 /**
- * Shift every tween targeting `targetSelector` by `delta` seconds (clamped ≥0),
+ * Shift every tween the clip at `targetSelector` carries by `delta` seconds (clamped ≥0),
  * rewriting each call's position argument. Mirrors recast's shiftPositionsInScript
  * (used by timeline clip-move to keep GSAP positions in sync with the clip start).
  */
-declare function shiftPositionsInScript(script: string, targetSelector: string, delta: number): string;
+declare function shiftPositionsInScript(script: string, targetSelector: string, delta: number, root?: ParentNode): string;
 /** Copies each tween on `fromSelector` for `toSelector`, `delta` seconds later, in its own argument text. Exact or
  *  absent: only a tween at a number, written straight in the timeline's own block, is copied. */
 declare function copyAnimationsInScript(script: string, fromSelector: string, toSelector: string, delta: number): string;
 /**
- * Linearly remap every tween targeting `targetSelector` from the old clip
+ * Linearly remap every tween the clip at `targetSelector` carries from the old clip
  * [oldStart, oldDuration] onto the new [newStart, newDuration] (position and,
  * when present, duration scaled by the duration ratio). Mirrors recast's
  * scalePositionsInScript (used by timeline clip-resize).
  */
-declare function scalePositionsInScript(script: string, targetSelector: string, oldStart: number, oldDuration: number, newStart: number, newDuration: number): string;
+declare function scalePositionsInScript(script: string, targetSelector: string, oldStart: number, oldDuration: number, newStart: number, newDuration: number, root?: ParentNode): string;
 declare function addAnimationToScript(script: string, animation: Omit<GsapAnimation, "id">): {
     script: string;
     id: string;
@@ -151,4 +161,4 @@ type UnrollElement = {
  */
 declare function unrollDynamicAnimations(script: string, animationId: string, elements: UnrollElement[]): string;
 
-export { type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, addMotionPathPointInScript, addMotionPathToScript, convertToKeyframesFromScript, copyAnimationsInScript, dedupePositionWritesInScript, materializeKeyframesFromScript, moveKeyframeInScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removeMotionPathPointInScript, removePropertyFromAnimation, resizeKeyframedTweenInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };
+export { type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, addMotionPathPointInScript, addMotionPathToScript, clipQueryRoot, clipTweenMatcher, convertToKeyframesFromScript, copyAnimationsInScript, dedupePositionWritesInScript, hasExplicitTime, 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

@@ -568,6 +568,11 @@ function resolveTargetSelector(node, ancestors, scope, bindings) {
   }
   return null;
 }
+function hasUnresolvedArrayPart(node, ancestors, scope, bindings) {
+  return node?.type === "ArrayExpression" && node.elements.some(
+    (el) => !resolveTargetSelector(el, ancestors, scope, bindings) || hasUnresolvedArrayPart(el, ancestors, scope, bindings)
+  );
+}
 function describeProxyTarget(targetNode, varsNode, scope) {
   const objNode = targetNode?.type === "ObjectExpression" ? targetNode : targetNode?.type === "Identifier" ? resolveConstNode(targetNode, scope) : void 0;
   if (objNode?.type !== "ObjectExpression") return null;
@@ -752,12 +757,14 @@ function findAllTweenCalls(ast, ref, scope, targetBindings) {
         const method = callee.property.name;
         const args = node.arguments;
         const selectorValue = args.length >= 1 ? resolveTargetSelector(args[0], nodeAncestors, scope, targetBindings) ?? "__unresolved__" : "__unresolved__";
+        const partial = hasUnresolvedArrayPart(args[0], nodeAncestors, scope, targetBindings) ? { selectorPartial: true } : {};
         if (method === "fromTo" && args.length >= 3) {
           results.push({
             node,
             ancestors: nodeAncestors,
             method: "fromTo",
             selector: selectorValue,
+            ...partial,
             fromArg: args[1],
             varsArg: args[2],
             positionArg: args[3]
@@ -768,6 +775,7 @@ function findAllTweenCalls(ast, ref, scope, targetBindings) {
             ancestors: nodeAncestors,
             method,
             selector: selectorValue,
+            ...partial,
             varsArg: args[1],
             positionArg: args[2],
             ...isGlobalSet ? { global: true } : {}
@@ -1105,6 +1113,7 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
   if (hasUnresolvedKeyframes) anim.hasUnresolvedKeyframes = true;
   if (durationUnresolved) anim.durationUnresolved = true;
   if (selector === "__unresolved__") anim.hasUnresolvedSelector = true;
+  if (call.selectorPartial) anim.hasPartialSelector = true;
   if (provenance) anim.provenance = provenance;
   return anim;
 }
@@ -1273,6 +1282,37 @@ function parseGsapScriptAcornForWrite(script) {
 
 // src/gsapWriterAcorn.ts
 import * as acornWalk2 from "acorn-walk";
+
+// src/clipTweens.ts
+function clipTweenMatcher(clipSelectors, root) {
+  const own = typeof clipSelectors === "string" ? [clipSelectors] : clipSelectors;
+  const clips = root ? own.flatMap((selector) => queryAll(root, selector)) : [];
+  return ({ targetSelector, hasPartialSelector }) => {
+    if (hasPartialSelector) return false;
+    if (own.includes(targetSelector)) return true;
+    if (!root || clips.length === 0) return false;
+    const targets = queryAll(root, targetSelector);
+    return targets.length > 0 && targets.every((target) => {
+      const owner = target.closest("[data-start]");
+      return clips.includes(target) || owner !== null && clips.includes(owner);
+    });
+  };
+}
+function clipQueryRoot(script) {
+  return script.closest("template") ?? script.ownerDocument;
+}
+function hasExplicitTime(animation) {
+  return typeof animation.position === "number" && !animation.implicitPosition;
+}
+function queryAll(root, selector) {
+  try {
+    return Array.from(root.querySelectorAll(selector));
+  } catch {
+    return [];
+  }
+}
+
+// src/gsapWriterAcorn.ts
 function valueToCode(value) {
   if (typeof value === "string" && value.startsWith("__raw:")) return value.slice(6);
   if (typeof value === "string") return JSON.stringify(value);
@@ -1518,14 +1558,14 @@ function overwritePosition(ms, call, position) {
     ms.appendLeft(call.node.end - 1, `, ${valueToCode(position)}`);
   }
 }
-function shiftPositionsInScript(script, targetSelector, delta) {
+function shiftPositionsInScript(script, targetSelector, delta, root) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
+  const carries = clipTweenMatcher(targetSelector, root);
   const ms = new MagicString(script);
   let changed = false;
   for (const entry of parsed.located) {
-    if (entry.animation.targetSelector !== targetSelector) continue;
-    if (typeof entry.animation.position !== "number") continue;
+    if (!carries(entry.animation) || !hasExplicitTime(entry.animation)) continue;
     overwritePosition(ms, entry.call, shiftedPosition(entry.animation.position, delta));
     changed = true;
   }
@@ -1600,21 +1640,23 @@ function timelineBlock(parsed) {
 function isLoopOrForEach(node) {
   return isLoopNode(node) || isForEachStatement(node) || node?.type === "DoWhileStatement";
 }
-function scalePositionsInScript(script, targetSelector, oldStart, oldDuration, newStart, newDuration) {
+function scalePositionsInScript(script, targetSelector, oldStart, oldDuration, newStart, newDuration, root) {
   if (oldDuration <= 0 || newDuration <= 0) return script;
   const ratio = newDuration / oldDuration;
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
+  const carries = clipTweenMatcher(targetSelector, root);
   const ms = new MagicString(script);
   let changed = false;
   for (const entry of parsed.located) {
-    if (entry.animation.targetSelector !== targetSelector) continue;
-    if (typeof entry.animation.position !== "number") continue;
-    const newPos = Math.max(
-      0,
-      Math.round((newStart + (entry.animation.position - oldStart) * ratio) * 1e3) / 1e3
-    );
-    overwritePosition(ms, entry.call, newPos);
+    if (!carries(entry.animation) || typeof entry.animation.position !== "number") continue;
+    if (hasExplicitTime(entry.animation)) {
+      const newPos = Math.max(
+        0,
+        Math.round((newStart + (entry.animation.position - oldStart) * ratio) * 1e3) / 1e3
+      );
+      overwritePosition(ms, entry.call, newPos);
+    }
     if (typeof entry.animation.duration === "number" && entry.animation.duration > 0) {
       const newDur = Math.max(1e-3, Math.round(entry.animation.duration * ratio * 1e3) / 1e3);
       upsertProp(ms, entry.call.varsArg, "duration", newDur);
@@ -3054,9 +3096,12 @@ export {
   addLabelToScript,
   addMotionPathPointInScript,
   addMotionPathToScript,
+  clipQueryRoot,
+  clipTweenMatcher,
   convertToKeyframesFromScript,
   copyAnimationsInScript,
   dedupePositionWritesInScript,
+  hasExplicitTime,
   materializeKeyframesFromScript,
   moveKeyframeInScript,
   removeAllKeyframesFromScript,