@hyperframes/parsers 0.7.58 → 0.7.60

package/dist/{gsapSerialize-B8jHFdp3.d.ts → gsapSerialize-CTPaxKTV.d.ts}

@@ -42,6 +42,8 @@ declare function editabilityForProvenance(provenance?: GsapProvenance): Keyframe
 interface GsapAnimation {
     id: string;
     targetSelector: string;
+    /** Stable parser-only identity for non-DOM targets whose display label is not unique. */
+    targetIdentity?: string;
     method: GsapMethod;
     position: number | string;
     properties: Record<string, number | string>;

package/dist/gsapWriterAcorn.d.ts

@@ -1,4 +1,4 @@
-import { G as GsapAnimation, A as ArcPathConfig, S as SplitAnimationsOptions, g as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-B8jHFdp3.js';
+import { G as GsapAnimation, A as ArcPathConfig, S as SplitAnimationsOptions, g as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-CTPaxKTV.js';
 import './types-CaeOJXdW.js';
 import './gsapConstants.js';
 

package/dist/gsapWriterAcorn.js

@@ -165,6 +165,7 @@ var QUERY_METHODS = /* @__PURE__ */ new Set(["querySelector", "querySelectorAll"
 var ITERATION_METHODS = /* @__PURE__ */ new Set(["forEach", "map"]);
 var SCOPE_NODE_TYPES = /* @__PURE__ */ new Set([
   "Program",
+  "BlockStatement",
   "FunctionDeclaration",
   "FunctionExpression",
   "ArrowFunctionExpression"
@@ -273,10 +274,12 @@ function selectorFromQueryCall(node, scope) {
   if (method === "getElementById") return `#${argValue}`;
   return null;
 }
-function enclosingScopeNodeFromAncestors(ancestors) {
+function enclosingScopeNodeFromAncestors(ancestors, includeBlocks = true) {
   for (let i = ancestors.length - 2; i >= 0; i--) {
     const node = ancestors[i];
-    if (node && SCOPE_NODE_TYPES.has(node.type)) return node;
+    if (node && SCOPE_NODE_TYPES.has(node.type) && (includeBlocks || node.type !== "BlockStatement")) {
+      return node;
+    }
   }
   return null;
 }
@@ -288,6 +291,64 @@ function scopeChainFromAncestors(ancestors) {
   }
   return chain;
 }
+function nearestExpandedScopeFromAncestors(ancestors) {
+  for (let index = ancestors.length - 2; index >= 0; index--) {
+    const candidate = ancestors[index];
+    if (candidate?.type === "BlockStatement" && readProvenance(candidate)) return candidate;
+  }
+  return void 0;
+}
+function findVisibleIdentifierDeclaration(name, ancestors, index, usageStart = Number.POSITIVE_INFINITY) {
+  const declarations = index.declarationsByName.get(name) ?? [];
+  const expandedScopeNode = nearestExpandedScopeFromAncestors(ancestors);
+  for (const scopeNode of scopeChainFromAncestors(ancestors)) {
+    const candidates = declarations.filter(
+      (declaration) => declaration.scopeNode === scopeNode && (!declaration.expandedScopeNode || declaration.expandedScopeNode === expandedScopeNode) && (declaration.kind === "var" || declaration.kind === "param" || declaration.node.start < usageStart)
+    ).sort((left, right) => right.node.start - left.node.start);
+    if (candidates[0]) return candidates[0];
+  }
+  return void 0;
+}
+function collectIdentifierBindingIndex(ast) {
+  const declarationsByName = /* @__PURE__ */ new Map();
+  const reassignedDeclarations = /* @__PURE__ */ new Set();
+  acornWalk.ancestor(ast, {
+    VariableDeclarator(node, _, ancestors) {
+      const name = node.id?.name;
+      if (!name) return;
+      const declaration = ancestors.at(-2);
+      const kind = declaration?.kind;
+      if (!kind) return;
+      const includeBlocks = declaration?.type !== "VariableDeclaration" || kind !== "var";
+      const scopeNode = enclosingScopeNodeFromAncestors(ancestors, includeBlocks);
+      const expandedScopeNode = nearestExpandedScopeFromAncestors(ancestors);
+      const entries = declarationsByName.get(name) ?? [];
+      entries.push({ node, scopeNode, expandedScopeNode, name, kind });
+      declarationsByName.set(name, entries);
+    },
+    FunctionDeclaration: indexFunctionParameters,
+    FunctionExpression: indexFunctionParameters,
+    ArrowFunctionExpression: indexFunctionParameters
+  });
+  const index = { declarationsByName, reassignedDeclarations };
+  acornWalk.ancestor(ast, {
+    AssignmentExpression(node, _, ancestors) {
+      const name = node.left?.type === "Identifier" ? node.left.name : void 0;
+      if (!name) return;
+      const declaration = findVisibleIdentifierDeclaration(name, ancestors, index, node.start);
+      if (declaration) reassignedDeclarations.add(declaration.node);
+    }
+  });
+  return index;
+  function indexFunctionParameters(node) {
+    for (const parameter of node.params ?? []) {
+      if (parameter?.type !== "Identifier") continue;
+      const entries = declarationsByName.get(parameter.name) ?? [];
+      entries.push({ node: parameter, scopeNode: node, name: parameter.name, kind: "param" });
+      declarationsByName.set(parameter.name, entries);
+    }
+  }
+}
 function addBinding(bindings, scopeNode, name, selector) {
   let scoped = bindings.get(scopeNode);
   if (!scoped) {
@@ -339,21 +400,39 @@ function collectScopeBindings(ast) {
   });
   return bindings;
 }
-function collectTargetBindings(ast, scope) {
+function collectTargetBindings(ast, scope, identifierBindings) {
   const bindings = /* @__PURE__ */ new Map();
   acornWalk.ancestor(ast, {
     VariableDeclarator(node, _, ancestors) {
       const name = node.id?.name;
       const selector = selectorFromQueryCall(node.init, scope);
       if (name && selector !== null) {
-        addBinding(bindings, enclosingScopeNodeFromAncestors(ancestors), name, selector);
+        const declaration = ancestors.at(-2);
+        const includeBlocks = declaration?.type !== "VariableDeclaration" || declaration.kind !== "var";
+        addBinding(
+          bindings,
+          enclosingScopeNodeFromAncestors(ancestors, includeBlocks),
+          name,
+          selector
+        );
       }
     },
     AssignmentExpression(node, _, ancestors) {
       const left = node.left;
       const selector = selectorFromQueryCall(node.right, scope);
       if (left?.type === "Identifier" && selector !== null) {
-        addBinding(bindings, enclosingScopeNodeFromAncestors(ancestors), left.name, selector);
+        const declaration = findVisibleIdentifierDeclaration(
+          left.name,
+          ancestors,
+          identifierBindings,
+          node.start
+        );
+        addBinding(
+          bindings,
+          declaration?.scopeNode ?? nearestExpandedScopeFromAncestors(ancestors) ?? enclosingScopeNodeFromAncestors(ancestors),
+          left.name,
+          selector
+        );
       }
     }
   });
@@ -830,7 +909,8 @@ function parseMotionPathNode(node, scope, source) {
   }
   return buildArcPath(coords, curviness, autoRotate, isCubic);
 }
-function tweenCallToAnimation(call, scope, source) {
+function tweenCallToAnimation(call, scope, source, identifierBindings) {
+  const provenance = readProvenance(call.node);
   const vars = objectExpressionToRecord(call.varsArg, scope, source);
   const properties = {};
   const extras = {};
@@ -909,9 +989,26 @@ function tweenCallToAnimation(call, scope, source) {
     duration = computeKeyframesTotalDuration(call.varsArg, scope, source);
   }
   let selector = call.selector;
+  let targetIdentity;
   if (selector === "__unresolved__") {
-    const proxyLabel = describeProxyTarget(call.node.arguments?.[0], call.varsArg, scope);
-    if (proxyLabel) selector = proxyLabel;
+    const targetNode = call.node.arguments?.[0];
+    const proxyLabel = describeProxyTarget(targetNode, call.varsArg, scope);
+    if (proxyLabel) {
+      selector = proxyLabel;
+      if (targetNode?.type === "Identifier") {
+        const declaration = findVisibleIdentifierDeclaration(
+          targetNode.name,
+          call.ancestors,
+          identifierBindings,
+          call.node.start
+        );
+        if (declaration?.node.init?.type === "ObjectExpression" && !identifierBindings.reassignedDeclarations.has(declaration.node)) {
+          const declarationProvenance = readProvenance(declaration.scopeNode) ?? readProvenance(declaration.expandedScopeNode);
+          const instanceIdentity = declarationProvenance && (declarationProvenance.kind === "helper" || declarationProvenance.kind === "loop") ? `:${declarationProvenance.kind}:${declarationProvenance.callSite ?? ""}:${declarationProvenance.iteration ?? ""}` : "";
+          targetIdentity = `proxy:${targetNode.name}@${declaration.node.start}${instanceIdentity}`;
+        }
+      }
+    }
   }
   const anim = {
     targetSelector: selector,
@@ -922,6 +1019,7 @@ function tweenCallToAnimation(call, scope, source) {
     duration,
     ease
   };
+  if (targetIdentity) anim.targetIdentity = targetIdentity;
   if (!hasPositionArg) anim.implicitPosition = true;
   let group = classifyTweenPropertyGroup(properties);
   if (!group && keyframesData) {
@@ -938,7 +1036,6 @@ function tweenCallToAnimation(call, scope, source) {
   if (motionPathResult) anim.arcPath = motionPathResult.arcPath;
   if (hasUnresolvedKeyframes) anim.hasUnresolvedKeyframes = true;
   if (selector === "__unresolved__") anim.hasUnresolvedSelector = true;
-  const provenance = readProvenance(call.node);
   if (provenance) anim.provenance = provenance;
   return anim;
 }
@@ -1072,13 +1169,16 @@ function parseGsapScriptAcornForWrite(script) {
       locations: true
     });
     const scope = collectScopeBindings(ast);
-    const targetBindings = collectTargetBindings(ast, scope);
+    const identifierBindings = collectIdentifierBindingIndex(ast);
+    const targetBindings = collectTargetBindings(ast, scope, identifierBindings);
     const detection = findTimelineVar(ast, scope);
     const ref = detection.ref ?? { kind: "identifier", name: "tl" };
     const timelineVar = timelineRootSource(ref, script);
     const calls = findAllTweenCalls(ast, ref, scope, targetBindings);
     sortBySourcePosition(calls);
-    const rawAnims = calls.map((call) => tweenCallToAnimation(call, scope, script));
+    const rawAnims = calls.map(
+      (call) => tweenCallToAnimation(call, scope, script, identifierBindings)
+    );
     applyTimelineDefaults(rawAnims, detection.defaults);
     resolveTimelinePositions(rawAnims);
     const animations = assignStableIds(rawAnims);