@hyperframes/parsers 0.8.127 → 0.8.129

package/dist/{gsapSerialize-CFUDcLqX.d.ts → gsapSerialize-CfSXM_Ez.d.ts}

@@ -7,6 +7,7 @@ import { K as Keyframe, V as ValidationResult } from './types-Ejqndkej.js';
  * without pulling in gsapParser (which depends on recast / @babel/parser).
  */
 
+declare const GSAP_DEFAULT_DURATION = 0.5;
 declare const SUPPORTED_PROPS: string[];
 /** Keys stored on dedicated GsapAnimation fields (not in properties/extras). */
 declare const BUILTIN_VAR_KEYS: ReadonlySet<string>;
@@ -22,7 +23,7 @@ declare function isXYPositionWrite(a: PositionWrite): boolean;
 declare function classifyPropertyGroup(prop: string): PropertyGroupName;
 declare function classifyTweenPropertyGroup(properties: Record<string, unknown>): PropertyGroupName | undefined;
 /**
- * What a Studio hold pins from t=0 before a later keyframed tween: its first keyframe's position props,
+ * What a Studio hold pins from t=0 before a later keyframed tween: its 0% keyframe's position props,
  * minus those an earlier timeline tween on the target writes (a global `gsap.set` is a base value).
  */
 declare function positionHoldForAnimation(animation: GsapAnimation, animations: readonly GsapAnimation[]): Record<string, number> | null;
@@ -129,6 +130,7 @@ interface GsapKeyframesData<K extends GsapPercentageKeyframe = GsapPercentageKey
     keyframes: K[];
     ease?: string;
     easeEach?: string;
+    fromMotionPath?: true;
 }
 interface ArcPathSegment {
     curviness: number;
@@ -214,4 +216,4 @@ declare function gsapAnimationsToKeyframes(animations: GsapAnimation[], elementS
     skipBaseSet?: boolean;
 }): Keyframe[];
 
-export { type ArcPathConfig as A, BUILTIN_VAR_KEYS as B, DROPPED_VAR_KEYS as D, EXTRAS_KEYS as E, type GsapAnimation as G, type KeyframeEditability as K, type MotionPathShape as M, PROPERTY_GROUPS as P, SUPPORTED_EASES as S, type ArcPathSegment as a, type GsapKeyframesData as b, type GsapMethod as c, type GsapPercentageKeyframe as d, type GsapProvenance as e, type GsapProvenanceKind as f, type ParsedGsap as g, type PropertyGroupName as h, SUPPORTED_PROPS as i, type SourcedGsapPercentageKeyframe as j, type SplitAnimationsOptions as k, type SplitAnimationsResult as l, classifyPropertyGroup as m, classifyTweenPropertyGroup as n, editabilityForProvenance as o, getAnimationsForElementId as p, gsapAnimationsToKeyframes as q, keyframesToGsapAnimations as r, serializeGsapAnimations as s, buildArcPath as t, type GsapKeyframeFormat as u, validateCompositionGsap as v, isTweenConfigKey as w, isXYPositionWrite as x, positionHoldForAnimation as y };
+export { type ArcPathConfig as A, BUILTIN_VAR_KEYS as B, DROPPED_VAR_KEYS as D, EXTRAS_KEYS as E, type GsapMethod as G, type KeyframeEditability as K, type MotionPathShape as M, type ParsedGsap as P, SUPPORTED_EASES as S, type GsapAnimation as a, type ArcPathSegment as b, type GsapProvenance as c, type GsapProvenanceKind as d, buildArcPath as e, editabilityForProvenance as f, type GsapKeyframeFormat as g, type GsapKeyframesData as h, type GsapPercentageKeyframe as i, PROPERTY_GROUPS as j, type PropertyGroupName as k, SUPPORTED_PROPS as l, classifyPropertyGroup as m, classifyTweenPropertyGroup as n, getAnimationsForElementId as o, gsapAnimationsToKeyframes as p, keyframesToGsapAnimations as q, type SplitAnimationsOptions as r, serializeGsapAnimations as s, type SplitAnimationsResult as t, GSAP_DEFAULT_DURATION as u, validateCompositionGsap as v, type SourcedGsapPercentageKeyframe as w, isTweenConfigKey as x, isXYPositionWrite as y, positionHoldForAnimation as z };

package/dist/gsapWriterAcorn.d.ts

@@ -1,9 +1,9 @@
-import { G as GsapAnimation, A as ArcPathConfig, k as SplitAnimationsOptions, l as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-CFUDcLqX.js';
+import { a as GsapAnimation, A as ArcPathConfig, r as SplitAnimationsOptions, t as SplitAnimationsResult, b as ArcPathSegment } from './gsapSerialize-CfSXM_Ez.js';
 import './types-Ejqndkej.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;
+declare function clipTweenMatcher(clipSelectors: string | readonly string[], root?: ParentNode, queries?: Map<string, Element[]>): (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. */
@@ -21,6 +21,26 @@ declare function updateAnimationInScript(script: string, animationId: string, up
  * (used by timeline clip-move to keep GSAP positions in sync with the clip start).
  */
 declare function shiftPositionsInScript(script: string, targetSelector: string, delta: number, root?: ParentNode): string;
+type ClipTweenRetime = {
+    kind: "shift";
+    targetSelector: string;
+    delta: number;
+} | {
+    kind: "scale";
+    targetSelector: string;
+    oldStart: number;
+    oldDuration: number;
+    newStart: number;
+    newDuration: number;
+};
+/**
+ * Applies `retimes` in order with one parse: the bytes equal running shift/scalePositionsInScript once
+ * per retime. `changed[i]` says whether retime i moved a value.
+ */
+declare function retimeClipTweensInScript(script: string, retimes: readonly ClipTweenRetime[], root?: ParentNode): {
+    script: string;
+    changed: boolean[];
+};
 /** 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;
@@ -177,4 +197,4 @@ type UnrollElement = {
  */
 declare function unrollDynamicAnimations(script: string, animationId: string, elements: UnrollElement[]): string;
 
-export { 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, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, 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, removeArcPathFromScript, removeKeyframeFromScript, removeLabelFromScript, removeMotionPathPointInScript, removePropertyFromAnimation, replaceTweenWithKeyframesInScript, resizeKeyframedTweenInScript, retimeClipTweensInScript, scalePositionsInScript, setArcPathInScript, shiftPositionsInScript, splitAnimationsInScript, splitIntoPropertyGroupsFromScript, syncPositionHoldsBeforeKeyframes, unrollDynamicAnimations, updateAnimationInScript, updateArcSegmentInScript, updateKeyframeInScript, updateMotionPathPointInScript };

package/dist/gsapWriterAcorn.js

@@ -2,6 +2,7 @@
 import MagicString from "magic-string";
 
 // src/gsapConstants.ts
+var GSAP_DEFAULT_DURATION = 0.5;
 var BUILTIN_VAR_KEYS = /* @__PURE__ */ new Set(["duration", "ease", "delay"]);
 var DROPPED_VAR_KEYS = /* @__PURE__ */ new Set([
   "onComplete",
@@ -60,16 +61,14 @@ function positionHoldForAnimation(animation, animations) {
   if (!animation.keyframes) return null;
   const start = knownStart(animation) ?? 0;
   if (!(start > 1e-3)) return null;
-  const first = [...animation.keyframes.keyframes].sort(
-    (left, right) => left.percentage - right.percentage
-  )[0];
-  if (!first) return null;
+  const atStart = animation.keyframes.keyframes.find((keyframe) => keyframe.percentage === 0);
+  if (!atStart) return null;
   const earlier = animations.filter((other) => {
     const otherStart = knownStart(other);
     return other !== animation && !other.global && other.targetSelector === animation.targetSelector && otherStart !== void 0 && otherStart < start - 1e-3;
   });
   const position = {};
-  for (const [property, value] of Object.entries(first.properties)) {
+  for (const [property, value] of Object.entries(atStart.properties)) {
     if (classifyPropertyGroup(property) !== "position" || typeof value !== "number") continue;
     if (earlier.some((other) => writesProperty(other, property))) continue;
     position[property] = value;
@@ -78,6 +77,9 @@ function positionHoldForAnimation(animation, animations) {
 }
 
 // src/gsapSerialize.ts
+function authorsKeyframes(anim) {
+  return anim.keyframes !== void 0 || anim.hasUnresolvedKeyframes === true;
+}
 function mergePercentageKeyframes(keyframes) {
   const byPercentage = /* @__PURE__ */ new Map();
   for (const keyframe of keyframes) {
@@ -229,34 +231,27 @@ function readProvenance(node) {
 var roundPercentage = (percentage) => Math.round(percentage * 10) / 10;
 var OBJECT_ARRAY_PERCENTAGE_TOLERANCE = 2;
 function getObjectArrayKeyframeTiming(durations) {
-  const hasAuthoredDuration = durations.some((duration) => duration !== void 0);
-  if (hasAuthoredDuration) {
-    if (!durations.every(
-      (duration) => typeof duration === "number" && Number.isFinite(duration) && duration > 0
-    )) {
-      return null;
-    }
-    const totalDuration = durations.reduce((sum, duration) => sum + duration, 0);
-    let cumulative = 0;
-    return {
-      percentages: durations.map((duration) => {
-        cumulative += duration;
-        return roundPercentage(cumulative / totalDuration * 100);
-      }),
-      totalDuration
-    };
+  const steps = durations.map((duration) => duration ?? GSAP_DEFAULT_DURATION);
+  if (!steps.every(
+    (duration) => typeof duration === "number" && Number.isFinite(duration) && duration > 0
+  )) {
+    return null;
   }
-  const lastIndex = durations.length - 1;
+  const totalDuration = steps.reduce((sum, duration) => sum + duration, 0);
+  let cumulative = 0;
   return {
-    percentages: durations.map(
-      (_, index) => lastIndex > 0 ? roundPercentage(index / lastIndex * 100) : 0
-    )
+    percentages: steps.map((duration) => {
+      cumulative += duration;
+      return roundPercentage(cumulative / totalDuration * 100);
+    }),
+    totalDuration
   };
 }
 function getCompatibleObjectArrayKeyframeTiming(durations, outerDuration) {
   const timing = getObjectArrayKeyframeTiming(durations);
   if (!timing) return null;
-  if (timing.totalDuration === void 0 || outerDuration === void 0) return timing;
+  const stepsAuthorDuration = durations.some((duration) => duration !== void 0);
+  if (!stepsAuthorDuration || outerDuration === void 0) return timing;
   if (typeof outerDuration === "number" && Math.abs(outerDuration - timing.totalDuration) <= Number.EPSILON) {
     return timing;
   }
@@ -852,6 +847,7 @@ function parsePercentageKeyframes(node, scope, source) {
     if (typeof key !== "string") continue;
     const pctMatch = PERCENTAGE_KEY_RE.exec(key);
     if (pctMatch) {
+      if (!isPlainStep(prop.value)) return void 0;
       const percentage = Number.parseFloat(pctMatch[1] ?? "0");
       const record = objectExpressionToRecord(prop.value, scope, source);
       const properties = {};
@@ -870,6 +866,8 @@ function parsePercentageKeyframes(node, scope, source) {
       ease = tryResolveStringProp(prop.value, scope, source) ?? ease;
     } else if (key === "easeEach") {
       easeEach = tryResolveStringProp(prop.value, scope, source) ?? easeEach;
+    } else {
+      return void 0;
     }
   }
   keyframes.sort((a, b) => a.percentage - b.percentage);
@@ -893,12 +891,19 @@ function computeKeyframesTotalDuration(varsNode, scope, source) {
   }
   return getObjectArrayKeyframeTiming(durations)?.totalDuration;
 }
-var isFullyReadableStep = (el) => el?.type === "ObjectExpression" && !el.properties.some((p) => p.type === "SpreadElement");
+function staticKeyName(prop) {
+  if (prop.type !== "ObjectProperty" && prop.type !== "Property") return void 0;
+  if (prop.method || prop.kind && prop.kind !== "init") return void 0;
+  const key = prop.computed ? prop.key?.type === "Literal" && prop.key.value : prop.key?.name ?? prop.key?.value;
+  return typeof key === "string" ? key : void 0;
+}
+var isPlainObject = (node) => node?.type === "ObjectExpression" && (node.properties ?? []).every((p) => staticKeyName(p) !== void 0);
+var isPlainStep = (node) => node?.type === "Literal" || isPlainObject(node);
 function parseObjectArrayKeyframes(node, scope, source) {
   const elements = node.elements ?? [];
   const raw = [];
   for (const el of elements) {
-    if (!isFullyReadableStep(el)) return void 0;
+    if (!isPlainObject(el)) return void 0;
     const record = objectExpressionToRecord(el, scope, source);
     const properties = {};
     let duration;
@@ -937,9 +942,8 @@ function parseSimpleArrayKeyframes(node, scope) {
       const values = [];
       for (const el of prop.value.elements ?? []) {
         const val = resolveNode(el, scope);
-        if (typeof val === "number" || typeof val === "string") {
-          values.push(val);
-        }
+        if (typeof val !== "number" && typeof val !== "string") return void 0;
+        values.push(val);
       }
       if (values.length > 0) arrayProps.set(key, values);
     } else if (key === "ease") {
@@ -972,6 +976,7 @@ function parseKeyframesNode(node, scope, source) {
   }
   if (node.type !== "ObjectExpression") return void 0;
   const props = node.properties ?? [];
+  if (!props.every((p) => staticKeyName(p) !== void 0)) return void 0;
   let hasPercentageKey = false;
   let hasArrayValue = false;
   for (const prop of props) {
@@ -1072,7 +1077,7 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
         percentage: waypoints.length > 1 ? Math.round(i / (waypoints.length - 1) * 100) : 0,
         properties: { x: wp.x, y: wp.y }
       }));
-      keyframesData = { format: "percentage", keyframes: kf };
+      keyframesData = { format: "percentage", keyframes: kf, fromMotionPath: true };
     } else {
       const kfs = keyframesData.keyframes;
       if (kfs.length === waypoints.length) {
@@ -1102,10 +1107,10 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
   const position = typeof posVal === "number" ? posVal : typeof posVal === "string" ? posVal : hasPositionArg ? `__raw:${source.slice(call.positionArg.start, call.positionArg.end)}` : 0;
   let duration = typeof vars.duration === "number" ? vars.duration : void 0;
   const ease = typeof vars.ease === "string" ? vars.ease : void 0;
-  if (duration === void 0 && keyframesData) {
+  const durationUnresolved = call.method !== "set" && duration === void 0 && hasUnknownDuration(call.varsArg, scope);
+  if (duration === void 0 && keyframesData && !durationUnresolved) {
     duration = computeKeyframesTotalDuration(call.varsArg, scope, source);
   }
-  const durationUnresolved = call.method !== "set" && duration === void 0 && hasUnknownDuration(call.varsArg, scope);
   let selector = call.selector;
   let targetIdentity;
   if (selector === "__unresolved__") {
@@ -1159,7 +1164,6 @@ function tweenCallToAnimation(call, scope, source, identifierBindings) {
   if (provenance) anim.provenance = provenance;
   return anim;
 }
-var GSAP_DEFAULT_DURATION = 0.5;
 function resolvePositionString(pos, cursor, prevStart) {
   const trimmed = pos.trim();
   if (trimmed === "") return cursor;
@@ -1192,7 +1196,7 @@ function applyTimelineDefaults(anims, defaults) {
       if (defaults.duration !== void 0) anim.duration = defaults.duration;
       else if (defaults.durationUnresolved) anim.durationUnresolved = true;
     }
-    if (anim.ease === void 0 && defaults.ease !== void 0 && !anim.keyframes) {
+    if (anim.ease === void 0 && defaults.ease !== void 0 && (!anim.keyframes || anim.keyframes.fromMotionPath)) {
       anim.ease = defaults.ease;
     }
   }
@@ -1361,14 +1365,25 @@ function parseGsapScriptAcornForWrite(script) {
 import * as acornWalk2 from "acorn-walk";
 
 // src/clipTweens.ts
-function clipTweenMatcher(clipSelectors, root) {
+function clipTweenMatcher(clipSelectors, root, queries = /* @__PURE__ */ new Map()) {
   const own = typeof clipSelectors === "string" ? [clipSelectors] : clipSelectors;
-  const clips = root ? own.flatMap((selector) => queryAll(root, selector)) : [];
+  if (!root)
+    return ({ targetSelector, hasPartialSelector }) => !hasPartialSelector && own.includes(targetSelector);
+  const queryAll = (selector) => {
+    if (ID_SELECTOR.test(selector)) {
+      if (!queries.has(ALL_IDS)) indexIds(root, queries);
+      return queries.get(selector) ?? [];
+    }
+    let found = queries.get(selector);
+    if (!found) queries.set(selector, found = queryRoot(root, selector));
+    return found;
+  };
+  const clips = own.flatMap((selector) => queryAll(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);
+    if (clips.length === 0) return false;
+    const targets = queryAll(targetSelector);
     return targets.length > 0 && targets.every((target) => {
       const owner = target.closest("[data-start]");
       return clips.includes(target) || owner !== null && clips.includes(owner);
@@ -1381,7 +1396,20 @@ function clipQueryRoot(script) {
 function hasExplicitTime(animation) {
   return typeof animation.position === "number" && !animation.implicitPosition;
 }
-function queryAll(root, selector) {
+var ID_SELECTOR = /^#-?[A-Za-z_][\w-]*$/;
+var ALL_IDS = "[id]";
+function indexIds(root, queries) {
+  const all = queryRoot(root, ALL_IDS);
+  queries.set(ALL_IDS, all);
+  for (const el of all) {
+    const key = `#${el.id}`;
+    if (!ID_SELECTOR.test(key)) continue;
+    const list = queries.get(key);
+    if (list) list.push(el);
+    else queries.set(key, [el]);
+  }
+}
+function queryRoot(root, selector) {
   try {
     return Array.from(root.querySelectorAll(selector));
   } catch {
@@ -1557,7 +1585,7 @@ function updateAnimationInScript(script, animationId, updates) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
   const target = parsed.located.find((l) => l.id === animationId);
-  if (!target) return script;
+  if (!target || updates.properties && target.animation.hasUnresolvedKeyframes) return script;
   const ms = new MagicString(script);
   const { call } = target;
   if (updates.properties) {
@@ -1621,17 +1649,54 @@ function overwritePosition(ms, call, position) {
   }
 }
 function shiftPositionsInScript(script, targetSelector, delta, root) {
-  const parsed = parseGsapScriptAcornForWrite(script);
-  if (!parsed) return script;
-  const carries = clipTweenMatcher(targetSelector, root);
+  return retimeClipTweensInScript(script, [{ kind: "shift", targetSelector, delta }], root).script;
+}
+var isLiveRetime = (r) => r.kind === "shift" || r.oldDuration > 0 && r.newDuration > 0;
+function applyRetime(animation, retime) {
+  if (retime.kind === "shift") {
+    if (!hasExplicitTime(animation)) return { position: false, duration: false };
+    animation.position = shiftedPosition(animation.position, retime.delta);
+    return { position: true, duration: false };
+  }
+  const touched = { position: false, duration: false };
+  if (!isLiveRetime(retime) || typeof animation.position !== "number") return touched;
+  const ratio = retime.newDuration / retime.oldDuration;
+  if (hasExplicitTime(animation)) {
+    const scaled = retime.newStart + (animation.position - retime.oldStart) * ratio;
+    animation.position = Math.max(0, Math.round(scaled * 1e3) / 1e3);
+    touched.position = true;
+  }
+  if (typeof animation.duration === "number" && animation.duration > 0) {
+    animation.duration = Math.max(1e-3, Math.round(animation.duration * ratio * 1e3) / 1e3);
+    touched.duration = true;
+  }
+  return touched;
+}
+function retimeClipTweensInScript(script, retimes, root) {
+  const changed = retimes.map(() => false);
+  const parsed = retimes.some(isLiveRetime) ? parseGsapScriptAcornForWrite(script) : null;
+  if (!parsed) return { script, changed };
+  const queries = /* @__PURE__ */ new Map();
+  const matchers = retimes.map((r) => clipTweenMatcher(r.targetSelector, root, queries));
   const ms = new MagicString(script);
-  let changed = false;
+  let wrote = false;
   for (const entry of parsed.located) {
-    if (!carries(entry.animation) || !hasExplicitTime(entry.animation)) continue;
-    overwritePosition(ms, entry.call, shiftedPosition(entry.animation.position, delta));
-    changed = true;
+    const animation = { ...entry.animation };
+    let position = false;
+    let duration = false;
+    retimes.forEach((retime, i) => {
+      if (!matchers[i](animation)) return;
+      const before = [animation.position, animation.duration];
+      const touched = applyRetime(animation, retime);
+      position ||= touched.position;
+      duration ||= touched.duration;
+      if (before[0] !== animation.position || before[1] !== animation.duration) changed[i] = true;
+    });
+    if (position) overwritePosition(ms, entry.call, animation.position);
+    if (duration) upsertProp(ms, entry.call.varsArg, "duration", animation.duration);
+    wrote ||= position || duration;
   }
-  return changed ? ms.toString() : script;
+  return { script: wrote ? ms.toString() : script, changed };
 }
 function copyAnimationsInScript(script, fromSelector, toSelector, delta) {
   const parsed = parseGsapScriptAcornForWrite(script);
@@ -1703,29 +1768,11 @@ function isLoopOrForEach(node) {
   return isLoopNode(node) || isForEachStatement(node) || node?.type === "DoWhileStatement";
 }
 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 (!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);
-    }
-    changed = true;
-  }
-  return changed ? ms.toString() : script;
+  return retimeClipTweensInScript(
+    script,
+    [{ kind: "scale", targetSelector, oldStart, oldDuration, newStart, newDuration }],
+    root
+  ).script;
 }
 function addAnimationToScript(script, animation) {
   const parsed = parseGsapScriptAcornForWrite(script);
@@ -1999,7 +2046,7 @@ function updateKeyframeInScript(script, animationId, percentage, properties, eas
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
   const target = parsed.located.find((l) => l.id === animationId);
-  if (!target) return script;
+  if (!target || target.animation.hasUnresolvedKeyframes) return script;
   const kfPropNode = findPropertyNode2(target.call.varsArg, "keyframes");
   if (!kfPropNode) {
     return updateMotionPathKeyframe(script, target, percentage, properties, ease) ?? script;
@@ -2067,7 +2114,7 @@ function locateWithKeyframes(script, animationId) {
   if (!parsed) return null;
   const convertedId = animationId.replace(/-from-|-fromTo-/, "-to-");
   const target = parsed.located.find((l) => l.id === animationId) ?? parsed.located.find((l) => l.id === convertedId);
-  if (!target) return null;
+  if (!target || target.animation.hasUnresolvedKeyframes) return null;
   const kfPropNode = findPropertyNode2(target.call.varsArg, "keyframes");
   if (!kfPropNode || kfPropNode.value?.type !== "ObjectExpression") return null;
   return { script, parsed, target, kfNode: kfPropNode.value };
@@ -2091,8 +2138,12 @@ function convertArrayKeyframesToObject(script, target) {
     return `${JSON.stringify(`${timing.percentages[i]}%`)}: ${recordToCode(record)}`;
   });
   const ms = new MagicString(script);
-  ms.overwrite(kfPropNode.value.start, kfPropNode.value.end, `{ ${entries.join(", ")} }`);
-  if (timing.totalDuration !== void 0 && findPropertyNode2(target.call.varsArg, "duration") === void 0) {
+  ms.overwrite(
+    kfPropNode.value.start,
+    kfPropNode.value.end,
+    `{ ${entries.join(", ")}, easeEach: "none" }`
+  );
+  if (findPropertyNode2(target.call.varsArg, "duration") === void 0) {
     upsertProp(ms, target.call.varsArg, "duration", timing.totalDuration);
   }
   return ms.toString();
@@ -2102,7 +2153,7 @@ function ensureKeyframesNode(script, animationId) {
   if (direct) return direct;
   const parsed = parseGsapScriptAcornForWrite(script);
   const target = parsed?.located.find((l) => l.id === animationId);
-  if (!target) return null;
+  if (!target || target.animation.hasUnresolvedKeyframes) return null;
   const kfProp = findPropertyNode2(target.call.varsArg, "keyframes");
   if (kfProp?.value?.type === "ArrayExpression") {
     const normalized = convertArrayKeyframesToObject(script, target);
@@ -2204,7 +2255,7 @@ function removeKeyframeFromScript(script, animationId, percentage) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return script;
   const target = parsed.located.find((l) => l.id === animationId);
-  if (!target) return script;
+  if (!target || target.animation.hasUnresolvedKeyframes) return script;
   const kfPropNode = findPropertyNode2(target.call.varsArg, "keyframes");
   if (!kfPropNode) return script;
   if (kfPropNode.value?.type === "ArrayExpression") {
@@ -2343,7 +2394,7 @@ function convertToKeyframesFromScript(script, animationId, resolvedFromValues, s
   const target = parsed.located.find((l) => l.id === animationId);
   if (!target) return script;
   const { animation, call } = target;
-  if (animation.keyframes) return script;
+  if (authorsKeyframes(animation)) return script;
   const isSet = call.method === "set";
   const { fromProps, toProps } = resolveConversionProps(animation, resolvedFromValues);
   const ms = new MagicString(script);
@@ -2559,6 +2610,7 @@ function splitIntoPropertyGroupsFromScript(script, animationId) {
   const target = parsed.located.find((l) => l.id === animationId);
   if (!target) return { script, ids: [animationId] };
   const { animation } = target;
+  if (animation.hasUnresolvedKeyframes) return { script, ids: [animationId] };
   const allPropKeys = collectPropertyKeys(animation);
   const groupProps = partitionPropertyGroups(allPropKeys);
   if (groupProps.size <= 1) return { script, ids: [animationId] };
@@ -2879,8 +2931,8 @@ function computeForwardBaselines(matching, splitTime) {
     const pos = typeof anim.position === "number" ? anim.position : 0;
     const dur = anim.duration ?? 0;
     const animEnd = pos + dur;
-    if (anim.keyframes) {
-      const kfs = anim.keyframes.keyframes;
+    if (authorsKeyframes(anim)) {
+      const kfs = anim.keyframes?.keyframes ?? [];
       if (pos >= splitTime) {
       } else if (animEnd > splitTime) {
         for (const kf of kfs) {
@@ -2941,17 +2993,22 @@ function buildSpanningSplit(result, anim, pos, dur, fromSource, ctx) {
     extras: anim.extras
   }).script;
 }
+function applyKeyframedTweenSplit(result, anim, pos, animEnd, ctx, skippedSelectors) {
+  if (pos >= ctx.splitTime)
+    return updateAnimationSelectorInScript(result, anim.id, ctx.newSelector);
+  if (animEnd > ctx.splitTime) {
+    skippedSelectors.push(`${ctx.originalSelector} (keyframes spanning split)`);
+  } else if (anim.hasUnresolvedKeyframes) {
+    skippedSelectors.push(`${ctx.originalSelector} (unreadable keyframes before split)`);
+  }
+  return result;
+}
 function applyTweenSplit(result, anim, baselineBefore, ctx, skippedSelectors) {
   const pos = typeof anim.position === "number" ? anim.position : 0;
   const dur = anim.duration ?? 0;
   const animEnd = pos + dur;
-  if (anim.keyframes) {
-    if (pos >= ctx.splitTime)
-      return updateAnimationSelectorInScript(result, anim.id, ctx.newSelector);
-    if (animEnd > ctx.splitTime) {
-      skippedSelectors.push(`${ctx.originalSelector} (keyframes spanning split)`);
-    }
-    return result;
+  if (authorsKeyframes(anim)) {
+    return applyKeyframedTweenSplit(result, anim, pos, animEnd, ctx, skippedSelectors);
   }
   if (animEnd <= ctx.splitTime) return result;
   if (pos >= ctx.splitTime)
@@ -3180,6 +3237,7 @@ export {
   removePropertyFromAnimation,
   replaceTweenWithKeyframesInScript,
   resizeKeyframedTweenInScript,
+  retimeClipTweensInScript,
   scalePositionsInScript,
   setArcPathInScript,
   shiftPositionsInScript,