@hyperframes/parsers 0.9.28-alpha.0 → 0.9.28

package/dist/gsapParserAcorn.d.ts

@@ -1,3 +1,4 @@
+import * as acorn from 'acorn';
 import { P as ParsedGsap, d as GsapMethod, G as GsapAnimation } from './gsapSerialize-BXsRZWdm.js';
 export { A as ArcPathConfig, a as ArcPathSegment, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, M as MotionPathShape, p as buildArcPath, q as editabilityForProvenance } from './gsapSerialize-BXsRZWdm.js';
 import './types-C1bWHQbs.js';
@@ -8,6 +9,37 @@ import './types-C1bWHQbs.js';
  */
 declare function scriptShape(code: string, maskNumbers?: boolean): string | null;
 
+/**
+ * Browser-safe GSAP read path — acorn + acorn-walk.
+ *
+ * T6b oracle: produces identical ParsedGsap output to gsapParser.ts (recast).
+ * Replaces recast as the shared implementation once T6d passes.
+ *
+ * Write path (T6c) will add magic-string splice once read parity is confirmed.
+ * No Node globals, no fs, no require — safe to bundle for browser use.
+ */
+
+interface TimelineDefaults {
+    ease?: string;
+    duration?: number;
+    durationUnresolved?: boolean;
+}
+type TimelineRef = {
+    kind: "identifier";
+    name: string;
+} | {
+    kind: "member";
+    node: any;
+};
+interface TimelineDetection {
+    /** Identifier name for the canonical form, else null for member/none. */
+    timelineVar: string | null;
+    /** Structural reference: identifier or member expression. Null when none found. */
+    ref: TimelineRef | null;
+    timelineCount: number;
+    defaults?: TimelineDefaults;
+    declaration?: Pick<acorn.Node, "start" | "end">;
+}
 interface TweenCallInfo {
     node: any;
     /** acorn-walk ancestor array at the call site (root→call, call is last). */
@@ -25,6 +57,7 @@ interface ParsedGsapAcornForWrite {
     ast: any;
     timelineVar: string;
     hasTimeline: boolean;
+    timelineDeclaration?: TimelineDetection["declaration"];
     located: Array<{
         id: string;
         call: TweenCallInfo;

package/dist/gsapParserAcorn.js

@@ -1170,6 +1170,7 @@ function findTimelineVar(ast, scope) {
   let ref = null;
   let timelineCount = 0;
   let defaults;
+  let declaration;
   const emptyScope = scope ?? /* @__PURE__ */ new Map();
   acornWalk.simple(ast, {
     VariableDeclarator(node) {
@@ -1179,6 +1180,7 @@ function findTimelineVar(ast, scope) {
           timelineVar = node.id.name;
           ref = { kind: "identifier", name: node.id.name };
           defaults = extractTimelineDefaults(node.init, emptyScope);
+          declaration = { start: node.start, end: node.end };
         }
       }
     },
@@ -1195,11 +1197,12 @@ function findTimelineVar(ast, scope) {
             ref = { kind: "member", node: left };
             defaults = extractTimelineDefaults(node.right, emptyScope);
           }
+          if (ref) declaration = { start: node.start, end: node.end };
         }
       }
     }
   });
-  return { timelineVar, ref, timelineCount, defaults };
+  return { timelineVar, ref, timelineCount, defaults, declaration };
 }
 function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;
@@ -1903,7 +1906,13 @@ function parseGsapScriptAcornForWrite(script) {
       call,
       animation: animations[i]
     }));
-    return { ast, timelineVar, hasTimeline: detection.ref !== null, located };
+    return {
+      ast,
+      timelineVar,
+      hasTimeline: detection.ref !== null,
+      timelineDeclaration: detection.declaration,
+      located
+    };
   } catch {
     return null;
   }

package/dist/gsapParserExports.d.ts

@@ -3,6 +3,7 @@ export { isStudioHoldSet } from './gsapParser.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
 export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
 import './types-C1bWHQbs.js';
+import 'acorn';
 
 interface ObjectArrayKeyframeTiming {
     percentages: number[];

package/dist/gsapParserExports.js

@@ -1461,6 +1461,7 @@ function findTimelineVar(ast, scope) {
   let ref = null;
   let timelineCount = 0;
   let defaults;
+  let declaration;
   const emptyScope = scope ?? /* @__PURE__ */ new Map();
   acornWalk.simple(ast, {
     VariableDeclarator(node) {
@@ -1470,6 +1471,7 @@ function findTimelineVar(ast, scope) {
           timelineVar = node.id.name;
           ref = { kind: "identifier", name: node.id.name };
           defaults = extractTimelineDefaults(node.init, emptyScope);
+          declaration = { start: node.start, end: node.end };
         }
       }
     },
@@ -1486,11 +1488,12 @@ function findTimelineVar(ast, scope) {
             ref = { kind: "member", node: left };
             defaults = extractTimelineDefaults(node.right, emptyScope);
           }
+          if (ref) declaration = { start: node.start, end: node.end };
         }
       }
     }
   });
-  return { timelineVar, ref, timelineCount, defaults };
+  return { timelineVar, ref, timelineCount, defaults, declaration };
 }
 function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;

package/dist/gsapWriterAcorn.d.ts

@@ -55,6 +55,7 @@ declare function addAnimationToScript(script: string, animation: Omit<GsapAnimat
     script: string;
     id: string;
 };
+declare function removeAnimationsForSelectors(script: string, selectors: ReadonlySet<string>): string;
 declare function removeAnimationFromScript(script: string, animationId: string): string;
 /**
  * Enforce "exactly one position write per element". Position commits (drag, add
@@ -200,4 +201,4 @@ type UnrollElement = {
  */
 declare function unrollDynamicAnimations(script: string, animationId: string, elements: UnrollElement[]): string;
 
-export { type ClipTweenRetime, type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, addMotionPathPointInScript, addMotionPathToScript, clipQueryRoot, clipTweenMatcher, convertToKeyframesFromScript, copyAnimationsInScript, dedupePositionWritesInScript, hasExplicitTime, materializeKeyframesFromScript, moveKeyframeInScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removeMotionPathPointInScript, removePropertyFromAnimation, replaceTweenWithKeyframesInScript, resizeKeyframedTweenInScript, retimeClipTweensInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, trimTrailingKeyframeSpans, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };
+export { type ClipTweenRetime, type UnrollElement, addAnimationToScript, addAnimationWithKeyframesToScript, addKeyframeToScript, addLabelToScript, addMotionPathPointInScript, addMotionPathToScript, clipQueryRoot, clipTweenMatcher, convertToKeyframesFromScript, copyAnimationsInScript, dedupePositionWritesInScript, hasExplicitTime, materializeKeyframesFromScript, moveKeyframeInScript, removeAllKeyframesFromScript, removeAnimationFromScript, removeAnimationsForSelectors, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removeMotionPathPointInScript, removePropertyFromAnimation, replaceTweenWithKeyframesInScript, resizeKeyframedTweenInScript, retimeClipTweensInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, trimTrailingKeyframeSpans, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };

package/dist/gsapWriterAcorn.js

@@ -784,6 +784,7 @@ function findTimelineVar(ast, scope) {
   let ref = null;
   let timelineCount = 0;
   let defaults;
+  let declaration;
   const emptyScope = scope ?? /* @__PURE__ */ new Map();
   acornWalk.simple(ast, {
     VariableDeclarator(node) {
@@ -793,6 +794,7 @@ function findTimelineVar(ast, scope) {
           timelineVar = node.id.name;
           ref = { kind: "identifier", name: node.id.name };
           defaults = extractTimelineDefaults(node.init, emptyScope);
+          declaration = { start: node.start, end: node.end };
         }
       }
     },
@@ -809,11 +811,12 @@ function findTimelineVar(ast, scope) {
             ref = { kind: "member", node: left };
             defaults = extractTimelineDefaults(node.right, emptyScope);
           }
+          if (ref) declaration = { start: node.start, end: node.end };
         }
       }
     }
   });
-  return { timelineVar, ref, timelineCount, defaults };
+  return { timelineVar, ref, timelineCount, defaults, declaration };
 }
 function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;
@@ -1420,7 +1423,13 @@ function parseGsapScriptAcornForWrite(script) {
       call,
       animation: animations[i]
     }));
-    return { ast, timelineVar, hasTimeline: detection.ref !== null, located };
+    return {
+      ast,
+      timelineVar,
+      hasTimeline: detection.ref !== null,
+      timelineDeclaration: detection.declaration,
+      located
+    };
   } catch {
     return null;
   }
@@ -1873,12 +1882,62 @@ function removeCallFromMagicString(ms, call, script) {
   const N = call.node;
   const exprStmt = findEnclosingExpressionStatement(call.ancestors);
   if (N.callee?.object?.type !== "CallExpression" && exprStmt?.expression === N) {
-    const end = exprStmt.end < script.length && script[exprStmt.end] === "\n" ? exprStmt.end + 1 : exprStmt.end;
-    ms.remove(exprStmt.start, end);
+    removeStatementFromMagicString(ms, exprStmt, script);
   } else {
     ms.remove(N.callee.object.end, N.end);
   }
 }
+function removeStatementFromMagicString(ms, statement, script) {
+  const end = statement.end + (script[statement.end] === "\n" ? 1 : 0);
+  ms.remove(statement.start, end);
+}
+function removeAnimationsForSelectors(script, selectors) {
+  let current = script;
+  for (; ; ) {
+    const parsed = parseGsapScriptAcornForWrite(current);
+    if (!parsed) return current;
+    const selected = parsed.located.filter(
+      ({ animation }) => selectors.has(animation.targetSelector)
+    );
+    const first = selected[0];
+    if (!first) return current;
+    const declaration = parsed.timelineDeclaration;
+    if (declaration && selected.some(
+      ({ call }) => call.node.start <= declaration.start && call.node.end >= declaration.end
+    )) {
+      const updated = removeAnimationFromScript(current, first.id);
+      if (updated === current) return current;
+      current = updated;
+      continue;
+    }
+    return removeCallsFromScript(
+      current,
+      selected.map(({ call }) => call)
+    );
+  }
+}
+function removeCallsFromScript(script, calls) {
+  const removedNodes = new Set(calls.map(({ node }) => node));
+  const statements = /* @__PURE__ */ new Set();
+  for (const call of calls) {
+    const statement = fullyRemovedStatement(call, removedNodes);
+    if (statement) statements.add(statement);
+  }
+  const ms = new MagicString(script);
+  for (const statement of statements) removeStatementFromMagicString(ms, statement, script);
+  for (const call of calls) {
+    if (statements.has(findEnclosingExpressionStatement(call.ancestors))) continue;
+    removeCallFromMagicString(ms, call, script);
+  }
+  return ms.toString();
+}
+function fullyRemovedStatement(call, removedNodes) {
+  const statement = findEnclosingExpressionStatement(call.ancestors);
+  if (statement?.expression !== call.node) return null;
+  let root = call.node;
+  while (root?.type === "CallExpression" && removedNodes.has(root)) root = root.callee.object;
+  return root && root.type !== "CallExpression" ? statement : null;
+}
 function removeAnimationFromScript(script, animationId) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
@@ -3368,6 +3427,7 @@ export {
   moveKeyframeInScript,
   removeAllKeyframesFromScript,
   removeAnimationFromScript,
+  removeAnimationsForSelectors,
   removeArcPathFromScript,
   removeKeyframeFromScript,
   removeLabelFromScript,

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { AttrReader, DEFAULT_IMAGE_TIMELINE_DURATION_SECONDS, MAX_PLAYBACK_RATE,
 export { CompositionDurationResult, CompositionDurationSource, ResolveCompositionDurationInput, TIMING_TOLERANCE_SECONDS, resolveCompositionDuration } from './compositionDuration.js';
 export { d as decodeUrlPathVariants, c as decodedUrlPath, e as encodeUrlPath } from './urlPath-CYK47t9W.js';
 export { HTML_ATTRIBUTE_ENTITIES, HtmlAttributeSpan, HtmlOpeningTagSpan, decodeAuthoredAttribute, scanHtmlOpeningTags } from './htmlAttributeSpans.js';
+import 'acorn';
 
 /**
  * Thrown by htmlParser functions when the input HTML is empty or does not

package/dist/index.js

@@ -1578,6 +1578,7 @@ function findTimelineVar(ast, scope) {
   let ref = null;
   let timelineCount = 0;
   let defaults;
+  let declaration;
   const emptyScope = scope ?? /* @__PURE__ */ new Map();
   acornWalk.simple(ast, {
     VariableDeclarator(node) {
@@ -1587,6 +1588,7 @@ function findTimelineVar(ast, scope) {
           timelineVar = node.id.name;
           ref = { kind: "identifier", name: node.id.name };
           defaults = extractTimelineDefaults(node.init, emptyScope);
+          declaration = { start: node.start, end: node.end };
         }
       }
     },
@@ -1603,11 +1605,12 @@ function findTimelineVar(ast, scope) {
             ref = { kind: "member", node: left };
             defaults = extractTimelineDefaults(node.right, emptyScope);
           }
+          if (ref) declaration = { start: node.start, end: node.end };
         }
       }
     }
   });
-  return { timelineVar, ref, timelineCount, defaults };
+  return { timelineVar, ref, timelineCount, defaults, declaration };
 }
 function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;
@@ -2311,7 +2314,13 @@ function parseGsapScriptAcornForWrite(script) {
       call,
       animation: animations[i]
     }));
-    return { ast, timelineVar, hasTimeline: detection.ref !== null, located };
+    return {
+      ast,
+      timelineVar,
+      hasTimeline: detection.ref !== null,
+      timelineDeclaration: detection.declaration,
+      located
+    };
   } catch {
     return null;
   }
@@ -2708,12 +2717,62 @@ function removeCallFromMagicString(ms, call, script) {
   const N = call.node;
   const exprStmt = findEnclosingExpressionStatement(call.ancestors);
   if (N.callee?.object?.type !== "CallExpression" && exprStmt?.expression === N) {
-    const end = exprStmt.end < script.length && script[exprStmt.end] === "\n" ? exprStmt.end + 1 : exprStmt.end;
-    ms.remove(exprStmt.start, end);
+    removeStatementFromMagicString(ms, exprStmt, script);
   } else {
     ms.remove(N.callee.object.end, N.end);
   }
 }
+function removeStatementFromMagicString(ms, statement, script) {
+  const end = statement.end + (script[statement.end] === "\n" ? 1 : 0);
+  ms.remove(statement.start, end);
+}
+function removeAnimationsForSelectors(script, selectors) {
+  let current = script;
+  for (; ; ) {
+    const parsed = parseGsapScriptAcornForWrite(current);
+    if (!parsed) return current;
+    const selected = parsed.located.filter(
+      ({ animation }) => selectors.has(animation.targetSelector)
+    );
+    const first = selected[0];
+    if (!first) return current;
+    const declaration = parsed.timelineDeclaration;
+    if (declaration && selected.some(
+      ({ call }) => call.node.start <= declaration.start && call.node.end >= declaration.end
+    )) {
+      const updated = removeAnimationFromScript(current, first.id);
+      if (updated === current) return current;
+      current = updated;
+      continue;
+    }
+    return removeCallsFromScript(
+      current,
+      selected.map(({ call }) => call)
+    );
+  }
+}
+function removeCallsFromScript(script, calls) {
+  const removedNodes = new Set(calls.map(({ node }) => node));
+  const statements = /* @__PURE__ */ new Set();
+  for (const call of calls) {
+    const statement = fullyRemovedStatement(call, removedNodes);
+    if (statement) statements.add(statement);
+  }
+  const ms = new MagicString(script);
+  for (const statement of statements) removeStatementFromMagicString(ms, statement, script);
+  for (const call of calls) {
+    if (statements.has(findEnclosingExpressionStatement(call.ancestors))) continue;
+    removeCallFromMagicString(ms, call, script);
+  }
+  return ms.toString();
+}
+function fullyRemovedStatement(call, removedNodes) {
+  const statement = findEnclosingExpressionStatement(call.ancestors);
+  if (statement?.expression !== call.node) return null;
+  let root = call.node;
+  while (root?.type === "CallExpression" && removedNodes.has(root)) root = root.callee.object;
+  return root && root.type !== "CallExpression" ? statement : null;
+}
 function removeAnimationFromScript(script, animationId) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
@@ -3542,19 +3601,10 @@ function removeElementWithGsapCascade(doc, element) {
   });
   if (removedSelectors.size === 0) return;
   for (const script of findScriptElementsDeep(doc)) {
-    let current = script.textContent ?? "";
+    const current = script.textContent ?? "";
     if (!current.includes("gsap") && !current.includes("ScrollTrigger")) continue;
-    for (; ; ) {
-      const parsed = parseGsapScriptAcornForWrite(current);
-      const match = parsed?.located.find(
-        (located) => removedSelectors.has(located.animation.targetSelector)
-      );
-      if (!match) break;
-      const updated = removeAnimationFromScript(current, match.id);
-      if (updated === current) break;
-      current = updated;
-    }
-    if (current !== script.textContent) script.textContent = current;
+    const updated = removeAnimationsForSelectors(current, removedSelectors);
+    if (updated !== current) script.textContent = updated;
   }
 }
 function removeElementFromHtml(html, elementId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.9.28-alpha.0",
+  "version": "0.9.28",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -139,7 +139,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.11",
-    "@hyperframes/core": "0.9.28-alpha.0"
+    "@hyperframes/core": "0.9.28"
   },
   "scripts": {
     "build": "tsup",