@hyperframes/parsers 0.7.68 → 0.7.70

package/dist/gsapParserAcorn.d.ts

@@ -35,6 +35,10 @@ declare function parseGsapScriptAcornForWrite(script: string): ParsedGsapAcornFo
  * Uses acorn + acorn-walk instead of recast + @babel/parser.
  */
 declare function parseGsapScriptAcorn(script: string): ParsedGsap;
+/** Source offset of the first timeline or standalone GSAP MotionPathPlugin tween. */
+declare function gsapScriptMotionPathFirstUseIndex(script: string): number | null;
+/** True when a timeline or standalone GSAP tween authors a MotionPathPlugin property. */
+declare function gsapScriptUsesMotionPath(script: string): boolean;
 interface GsapLabelEntry {
     name: string;
     position: number;
@@ -49,4 +53,4 @@ interface GsapLabelEntry {
  */
 declare function extractGsapLabels(script: string): GsapLabelEntry[];
 
-export { type GsapLabelEntry, type ParsedGsapAcornForWrite, type TweenCallInfo, extractGsapLabels, parseGsapScriptAcorn, parseGsapScriptAcornForWrite };
+export { type GsapLabelEntry, type ParsedGsapAcornForWrite, type TweenCallInfo, extractGsapLabels, gsapScriptMotionPathFirstUseIndex, gsapScriptUsesMotionPath, parseGsapScriptAcorn, parseGsapScriptAcornForWrite };

package/dist/gsapParserAcorn.js

@@ -470,6 +470,21 @@ var SCOPE_NODE_TYPES = /* @__PURE__ */ new Set([
   "FunctionExpression",
   "ArrowFunctionExpression"
 ]);
+function parseProgram(script) {
+  try {
+    return acorn.parse(script, {
+      ecmaVersion: "latest",
+      sourceType: "script",
+      locations: true
+    });
+  } catch {
+    return acorn.parse(script, {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      locations: true
+    });
+  }
+}
 var CONST_NODES = /* @__PURE__ */ Symbol("hf.constNodes");
 function constNodesOf(scope) {
   return scope[CONST_NODES];
@@ -1615,11 +1630,7 @@ function parseGsapScriptAcornForWrite(script) {
 }
 function parseGsapScriptAcorn(script) {
   try {
-    const ast = acorn.parse(script, {
-      ecmaVersion: "latest",
-      sourceType: "script",
-      locations: true
-    });
+    const ast = parseProgram(script);
     const scope = collectScopeBindings(ast);
     const detection = findTimelineVar(ast, scope);
     const ref = detection.ref ?? { kind: "identifier", name: "tl" };
@@ -1665,6 +1676,71 @@ function parseGsapScriptAcorn(script) {
     return { animations: [], timelineVar: "tl", preamble: "", postamble: "" };
   }
 }
+function gsapScriptMotionPathFirstUseIndex(script) {
+  try {
+    const ast = parseProgram(script);
+    const scope = collectScopeBindings(ast);
+    const identifierBindings = collectIdentifierBindingIndex(ast);
+    const timelineRef = findTimelineVar(ast, scope).ref;
+    const timelineDeclarations = /* @__PURE__ */ new Set();
+    let firstUseIndex = null;
+    acornWalk.ancestor(ast, {
+      VariableDeclarator(node) {
+        if (node.id?.type === "Identifier" && isGsapTimelineCall(node.init)) {
+          timelineDeclarations.add(node);
+        }
+      },
+      AssignmentExpression(node, _, ancestors) {
+        if (node.left?.type === "Identifier" && isGsapTimelineCall(node.right)) {
+          const declaration = findVisibleIdentifierDeclaration(
+            node.left.name,
+            ancestors,
+            identifierBindings,
+            node.start
+          );
+          if (declaration) timelineDeclarations.add(declaration.node);
+        }
+      }
+    });
+    acornWalk.ancestor(ast, {
+      CallExpression(node, _, ancestors) {
+        const callee = node.callee;
+        const method = callee?.property?.name;
+        if (callee?.type !== "MemberExpression" || !GSAP_METHODS2.has(method)) return;
+        let rootObject = callee.object;
+        while (rootObject?.type === "CallExpression") rootObject = rootObject.callee?.object;
+        const isGsapRooted = rootObject?.type === "Identifier" && rootObject.name === "gsap";
+        const visibleTimelineDeclaration = rootObject?.type === "Identifier" ? findVisibleIdentifierDeclaration(
+          rootObject.name,
+          ancestors,
+          identifierBindings,
+          node.start
+        ) : void 0;
+        const isTimelineTween = (timelineRef?.kind === "member" ? isTimelineRootedCall(node, timelineRef) : false) || !!visibleTimelineDeclaration && timelineDeclarations.has(visibleTimelineDeclaration.node);
+        if (!isGsapRooted && !isTimelineTween) return;
+        const varsArgs = method === "fromTo" ? [node.arguments?.[1], node.arguments?.[2]] : [node.arguments?.[1]];
+        if (varsArgs.some((varsArg) => {
+          if (findPropertyNode(varsArg, "motionPath")) return true;
+          if (varsArg?.type !== "Identifier") return false;
+          const declaration = findVisibleIdentifierDeclaration(
+            varsArg.name,
+            ancestors,
+            identifierBindings,
+            node.start
+          );
+          return !!findPropertyNode(declaration?.node.init, "motionPath");
+        }))
+          firstUseIndex = firstUseIndex === null ? node.start : Math.min(firstUseIndex, node.start);
+      }
+    });
+    return firstUseIndex;
+  } catch {
+    return null;
+  }
+}
+function gsapScriptUsesMotionPath(script) {
+  return gsapScriptMotionPathFirstUseIndex(script) !== null;
+}
 function extractGsapLabels(script) {
   try {
     const ast = acorn.parse(script, {
@@ -1704,6 +1780,8 @@ export {
   buildArcPath,
   editabilityForProvenance,
   extractGsapLabels,
+  gsapScriptMotionPathFirstUseIndex,
+  gsapScriptUsesMotionPath,
   parseGsapScriptAcorn,
   parseGsapScriptAcornForWrite
 };