@editframe/elements 0.30.2-beta.0 → 0.31.0-beta.1

package/dist/elements/updateAnimations.js

@@ -8,6 +8,125 @@ const DURATION_PROPERTY = "--ef-duration";
 const TRANSITION_DURATION_PROPERTY = "--ef-transition-duration";
 const TRANSITION_OUT_START_PROPERTY = "--ef-transition-out-start";
 /**
+* Tracks animations per element to prevent them from being lost when they complete.
+* Once an animation reaches 100% completion, it's removed from getAnimations(),
+* but we keep a reference to it so we can continue controlling it.
+*/
+const animationTracker = /* @__PURE__ */ new WeakMap();
+/**
+* Tracks whether DOM structure has changed for an element, requiring animation rediscovery.
+* For render clones (static DOM), this stays false after initial discovery.
+* For prime timeline (interactive), this is set to true when mutations occur.
+*/
+const domStructureChanged = /* @__PURE__ */ new WeakMap();
+/**
+* Tracks the last known animation count for an element to detect new animations.
+* Used as a lightweight check before calling expensive getAnimations().
+*/
+const lastAnimationCount = /* @__PURE__ */ new WeakMap();
+/**
+* Checks if an element is in a render clone (static DOM context).
+* Render clones are in containers with class "ef-render-clone-container".
+*/
+const isRenderClone = (element) => {
+	return element.closest(".ef-render-clone-container") !== null;
+};
+/**
+* Validates that an animation is still valid and controllable.
+* Animations become invalid when:
+* - They've been cancelled (idle state and not in getAnimations())
+* - Their effect is null (animation was removed)
+* - Their target is no longer in the DOM
+*/
+const isAnimationValid = (animation, currentAnimations) => {
+	if (animation.playState === "idle" && !currentAnimations.includes(animation)) return false;
+	const effect = animation.effect;
+	if (!effect) return false;
+	if (effect instanceof KeyframeEffect) {
+		const target = effect.target;
+		if (target && target instanceof Element) {
+			if (!target.isConnected) return false;
+		}
+	}
+	return true;
+};
+/**
+* Discovers and tracks animations on an element and its subtree.
+* This ensures we have references to animations even after they complete.
+*
+* Tracks animations per element where they exist, not just on the root element.
+* This allows us to find animations on any element in the subtree.
+*
+* OPTIMIZATION: For render clones (static DOM), discovery happens once at creation.
+* For prime timeline (interactive), discovery is responsive to DOM changes.
+*
+* Also cleans up invalid animations (cancelled, removed from DOM, etc.)
+*/
+const discoverAndTrackAnimations = (element) => {
+	const isClone = isRenderClone(element);
+	const hasTrackedAnimations = animationTracker.has(element);
+	const structureChanged = domStructureChanged.get(element) ?? true;
+	if (isClone && hasTrackedAnimations && !structureChanged) {
+		const rootTracked$1 = animationTracker.get(element);
+		const currentAnimations$1 = [];
+		const rootDirectAnimations = element.getAnimations();
+		for (const animation of rootTracked$1) if (isAnimationValid(animation, rootDirectAnimations)) currentAnimations$1.push(animation);
+		return {
+			tracked: rootTracked$1,
+			current: currentAnimations$1
+		};
+	}
+	const currentAnimations = element.getAnimations({ subtree: true });
+	if (isClone) domStructureChanged.set(element, false);
+	lastAnimationCount.set(element, currentAnimations.length);
+	for (const animation of currentAnimations) {
+		const effect = animation.effect;
+		const target = effect && effect instanceof KeyframeEffect ? effect.target : null;
+		if (target && target instanceof Element) {
+			let tracked = animationTracker.get(target);
+			if (!tracked) {
+				tracked = /* @__PURE__ */ new Set();
+				animationTracker.set(target, tracked);
+			}
+			tracked.add(animation);
+		}
+	}
+	let rootTracked = animationTracker.get(element);
+	if (!rootTracked) {
+		rootTracked = /* @__PURE__ */ new Set();
+		animationTracker.set(element, rootTracked);
+	}
+	for (const animation of currentAnimations) rootTracked.add(animation);
+	for (const animation of rootTracked) if (!isAnimationValid(animation, currentAnimations)) rootTracked.delete(animation);
+	const allTargets = /* @__PURE__ */ new Set();
+	for (const animation of currentAnimations) {
+		const effect = animation.effect;
+		const target = effect && effect instanceof KeyframeEffect ? effect.target : null;
+		if (target && target instanceof Element) allTargets.add(target);
+	}
+	const subtreeElements = element.querySelectorAll("*");
+	for (const el of subtreeElements) {
+		const tracked = animationTracker.get(el);
+		if (tracked) {
+			for (const animation of tracked) if (!isAnimationValid(animation, Array.from(el.getAnimations()))) tracked.delete(animation);
+			if (tracked.size === 0) animationTracker.delete(el);
+		}
+	}
+	return {
+		tracked: rootTracked,
+		current: currentAnimations
+	};
+};
+/**
+* Cleans up tracked animations when an element is disconnected.
+* This prevents memory leaks.
+*/
+const cleanupTrackedAnimations = (element) => {
+	animationTracker.delete(element);
+	domStructureChanged.delete(element);
+	lastAnimationCount.delete(element);
+};
+/**
 * Determines what phase an element is in relative to the timeline.
 *
 * WHY: Phase is the primary concept that drives all decisions. By explicitly
@@ -26,7 +145,9 @@ const TRANSITION_OUT_START_PROPERTY = "--ef-transition-out-start";
 */
 const determineElementPhase = (element, timelineTimeMs) => {
 	const endTimeMs = element.endTimeMs;
-	if (timelineTimeMs < element.startTimeMs) return "before-start";
+	const startTimeMs = element.startTimeMs;
+	if (endTimeMs <= startTimeMs) return "active";
+	if (timelineTimeMs < startTimeMs) return "before-start";
 	const epsilon = .001;
 	const diff = timelineTimeMs - endTimeMs;
 	if (diff > epsilon) return "after-end";
@@ -133,7 +254,22 @@ const supportsStaggerOffset = (element) => {
 * This enables staggered animation effects within a single timegroup.
 */
 const calculateEffectiveDelay = (delay, element) => {
-	if (supportsStaggerOffset(element) && element.staggerOffsetMs !== void 0) return delay + element.staggerOffsetMs;
+	if (supportsStaggerOffset(element)) {
+		const segment = element;
+		if (segment.staggerOffsetMs !== void 0 && segment.staggerOffsetMs !== null) return delay + segment.staggerOffsetMs;
+		let cssValue = element.style.getPropertyValue("--ef-stagger-offset").trim();
+		if (!cssValue) cssValue = window.getComputedStyle(element).getPropertyValue("--ef-stagger-offset").trim();
+		if (cssValue) {
+			const match = cssValue.match(/(\d+(?:\.\d+)?)\s*ms?/);
+			if (match) {
+				const staggerOffset = parseFloat(match[1]);
+				if (!isNaN(staggerOffset)) return delay + staggerOffset;
+			} else {
+				const numValue = parseFloat(cssValue);
+				if (!isNaN(numValue)) return delay + numValue;
+			}
+		}
+	}
 	return delay;
 };
 /**
@@ -252,21 +388,8 @@ const extractAnimationTiming = (effect) => {
 * Prepares animation for manual control by ensuring it's paused
 */
 const prepareAnimation = (animation) => {
-	if (animation.playState === "finished") {
-		animation.cancel();
-		animation.play();
-		animation.pause();
-	} else if (animation.playState === "running") animation.pause();
-	else {
-		if (animation.currentTime === null) {
-			animation.play();
-			animation.pause();
-		}
-		if (animation.playState === "idle") {
-			animation.currentTime = 0;
-			animation.pause();
-		}
-	}
+	if (animation.playState === "finished") animation.cancel();
+	else if (animation.playState === "running") animation.pause();
 };
 /**
 * Maps element time to animation currentTime and sets it on the animation.
@@ -279,17 +402,22 @@ const mapAndSetAnimationTime = (animation, element, timing, effectiveDelay) => {
 	if (animation.playState === "running") animation.pause();
 	const adjustedTime = elementTime - effectiveDelay;
 	if (adjustedTime < 0) {
-		animation.currentTime = elementTime;
+		if (timing.delay > 0) animation.currentTime = elementTime;
+		else animation.currentTime = 0;
 		return;
 	}
 	const { duration, iterations } = timing;
 	const currentIteration = Math.floor(adjustedTime / duration);
-	if (currentIteration >= iterations) animation.currentTime = effectiveDelay + getCompletedAnimationTime(timing, calculateMaxSafeAnimationTime(duration, iterations));
-	else {
+	if (currentIteration >= iterations) {
+		const completedAnimationTime = getCompletedAnimationTime(timing, calculateMaxSafeAnimationTime(duration, iterations));
+		if (timing.delay > 0) animation.currentTime = effectiveDelay + completedAnimationTime;
+		else animation.currentTime = completedAnimationTime;
+	} else {
 		const animationTime = mapElementTimeToAnimationTime(elementTime, timing, effectiveDelay);
-		const { direction } = timing;
-		if ((direction === "alternate" || direction === "alternate-reverse") && effectiveDelay > 0 && currentIteration === 0) animation.currentTime = elementTime;
+		const { direction, delay } = timing;
+		if (delay > 0) if ((direction === "alternate" || direction === "alternate-reverse") && effectiveDelay > 0 && currentIteration === 0) animation.currentTime = elementTime;
 		else animation.currentTime = effectiveDelay + animationTime;
+		else animation.currentTime = animationTime;
 	}
 };
 /**
@@ -312,18 +440,33 @@ const synchronizeAnimation = (animation, element) => {
 		const nearestTimegroup = target.closest("ef-timegroup");
 		if (nearestTimegroup && isEFTemporal(nearestTimegroup)) timeSource = nearestTimegroup;
 	}
-	const effectiveDelay = calculateEffectiveDelay(timing.delay, timeSource);
+	let staggerElement = timeSource;
+	if (target && target instanceof HTMLElement) {
+		const targetAsAnimatable = target;
+		if (supportsStaggerOffset(targetAsAnimatable)) staggerElement = targetAsAnimatable;
+		else {
+			const parentSegment = target.closest("ef-text-segment");
+			if (parentSegment && supportsStaggerOffset(parentSegment)) staggerElement = parentSegment;
+		}
+	}
+	const effectiveDelay = calculateEffectiveDelay(timing.delay, staggerElement);
 	mapAndSetAnimationTime(animation, timeSource, timing, effectiveDelay);
 };
 /**
 * Coordinates animations for a single element and its subtree, using the element as the time source.
 *
-* Gets animations on the element itself and its subtree.
+* Uses tracked animations to ensure we can control animations even after they complete.
 * Both CSS animations (created via the 'animation' property) and WAAPI animations are included.
+*
+* CRITICAL: CSS animations are created asynchronously when classes are added. This function
+* discovers new animations on each call and tracks them in memory. Once animations complete,
+* they're removed from getAnimations(), but we keep references to them so we can continue
+* controlling them.
 */
 const coordinateElementAnimations = (element) => {
-	const animations = element.getAnimations({ subtree: true });
-	for (const animation of animations) {
+	const { tracked: trackedAnimations, current: currentAnimations } = discoverAndTrackAnimations(element);
+	for (const animation of trackedAnimations) {
+		if (!isAnimationValid(animation, currentAnimations)) continue;
 		prepareAnimation(animation);
 		synchronizeAnimation(animation, element);
 	}
@@ -335,7 +478,7 @@ const coordinateElementAnimations = (element) => {
 * Phase determines what should be visible, and this function applies that decision.
 */
 const applyVisualState = (element, state) => {
-	element.style.setProperty(PROGRESS_PROPERTY, `${state.progress * 100}%`);
+	element.style.setProperty(PROGRESS_PROPERTY, `${state.progress}`);
 	if (!state.isVisible) {
 		element.style.setProperty("display", "none");
 		return;
@@ -387,5 +530,5 @@ const updateAnimations = (element) => {
 };
 
 //#endregion
-export { evaluateAnimationVisibilityState, updateAnimations };
+export { cleanupTrackedAnimations, evaluateAnimationVisibilityState, updateAnimations };
 //# sourceMappingURL=updateAnimations.js.map

package/dist/elements/updateAnimations.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateAnimations.js","names":["timeSource: AnimatableElement"],"sources":["../../src/elements/updateAnimations.ts"],"sourcesContent":["import {\n  deepGetTemporalElements,\n  isEFTemporal,\n  type TemporalMixinInterface,\n} from \"./EFTemporal.ts\";\n\n// All animatable elements are temporal elements with HTMLElement interface\nexport type AnimatableElement = TemporalMixinInterface & HTMLElement;\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst ANIMATION_PRECISION_OFFSET = 0.1; // Use 0.1ms to safely avoid completion threshold\nconst DEFAULT_ANIMATION_ITERATIONS = 1;\nconst PROGRESS_PROPERTY = \"--ef-progress\";\nconst DURATION_PROPERTY = \"--ef-duration\";\nconst TRANSITION_DURATION_PROPERTY = \"--ef-transition-duration\";\nconst TRANSITION_OUT_START_PROPERTY = \"--ef-transition-out-start\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Represents the phase an element is in relative to the timeline.\n * This is the primary concept that drives all visibility and animation decisions.\n */\nexport type ElementPhase =\n  | \"before-start\"\n  | \"active\"\n  | \"at-end-boundary\"\n  | \"after-end\";\n\n/**\n * Represents the temporal state of an element relative to the timeline\n */\ninterface TemporalState {\n  progress: number;\n  isVisible: boolean;\n  timelineTimeMs: number;\n  phase: ElementPhase;\n}\n\n/**\n * Context object that holds all evaluated state for an element update.\n * This groups related state together, reducing parameter passing and making\n * the data flow clearer.\n */\ninterface ElementUpdateContext {\n  element: AnimatableElement;\n  state: TemporalState;\n}\n\n/**\n * Animation timing information extracted from an animation effect.\n * Groups related timing properties together.\n */\ninterface AnimationTiming {\n  duration: number;\n  delay: number;\n  iterations: number;\n  direction: string;\n}\n\n/**\n * Capability interface for elements that support stagger offset.\n * This encapsulates the stagger behavior behind a capability check rather than\n * leaking tag name checks throughout the codebase.\n */\ninterface StaggerableElement extends AnimatableElement {\n  staggerOffsetMs?: number;\n}\n\n// ============================================================================\n// Phase Determination\n// ============================================================================\n\n/**\n * Determines what phase an element is in relative to the timeline.\n *\n * WHY: Phase is the primary concept that drives all decisions. By explicitly\n * enumerating phases, we make the code's logic clear: phase determines visibility,\n * animation coordination, and visual state.\n *\n * Phases:\n * - before-start: Timeline is before element's start time\n * - active: Timeline is within element's active range (start to end, exclusive of end)\n * - at-end-boundary: Timeline is exactly at element's end time\n * - after-end: Timeline is after element's end time\n *\n * Note: We detect \"at-end-boundary\" by checking if timeline equals end time.\n * The boundary policy will then determine if this should be treated as visible/active\n * or not based on element characteristics.\n */\nconst determineElementPhase = (\n  element: AnimatableElement,\n  timelineTimeMs: number,\n): ElementPhase => {\n  // Read endTimeMs once to avoid recalculation issues\n  const endTimeMs = element.endTimeMs;\n  const startTimeMs = element.startTimeMs;\n\n  if (timelineTimeMs < startTimeMs) {\n    return \"before-start\";\n  }\n  // Use epsilon to handle floating point precision issues\n  const epsilon = 0.001;\n  const diff = timelineTimeMs - endTimeMs;\n\n  // If clearly after end (difference > epsilon), return 'after-end'\n  if (diff > epsilon) {\n    return \"after-end\";\n  }\n  // If at or very close to end boundary (within epsilon), return 'at-end-boundary'\n  if (Math.abs(diff) <= epsilon) {\n    return \"at-end-boundary\";\n  }\n  // Otherwise, we're before the end, so check if we're active\n  return \"active\";\n};\n\n// ============================================================================\n// Boundary Policies\n// ============================================================================\n\n/**\n * Policy interface for determining behavior at boundaries.\n * Different policies apply different rules for when elements should be visible\n * or have animations coordinated at exact boundary times.\n */\ninterface BoundaryPolicy {\n  /**\n   * Determines if an element should be considered visible/active at the end boundary\n   * based on the element's characteristics.\n   */\n  shouldIncludeEndBoundary(element: AnimatableElement): boolean;\n}\n\n/**\n * Visibility policy: determines when elements should be visible for display purposes.\n *\n * WHY: Root elements, elements aligned with composition end, and text segments\n * should remain visible at exact end time to prevent flicker and show final frames.\n * Other elements use exclusive end for clean transitions between elements.\n */\nclass VisibilityPolicy implements BoundaryPolicy {\n  shouldIncludeEndBoundary(element: AnimatableElement): boolean {\n    // Root elements should remain visible at exact end time to prevent flicker\n    const isRootElement = !element.parentTimegroup;\n    if (isRootElement) {\n      return true;\n    }\n\n    // Elements aligned with composition end should remain visible at exact end time\n    const isLastElementInComposition =\n      element.endTimeMs === element.rootTimegroup?.endTimeMs;\n    if (isLastElementInComposition) {\n      return true;\n    }\n\n    // Text segments use inclusive end since they're meant to be visible for full duration\n    if (this.isTextSegment(element)) {\n      return true;\n    }\n\n    // Other elements use exclusive end for clean transitions\n    return false;\n  }\n\n  /**\n   * Checks if element is a text segment.\n   * Encapsulates the tag name check to hide implementation detail.\n   */\n  protected isTextSegment(element: AnimatableElement): boolean {\n    return element.tagName === \"EF-TEXT-SEGMENT\";\n  }\n}\n\n/**\n * Animation policy: determines when animations should be coordinated.\n *\n * WHY: When an animation reaches exactly the end time of an element, using exclusive\n * end would make the element invisible, causing the animation to be removed from the\n * DOM and creating a visual jump. By using inclusive end, we ensure animations remain\n * coordinated even at exact boundary times, providing smooth visual transitions.\n */\nclass AnimationPolicy implements BoundaryPolicy {\n  shouldIncludeEndBoundary(_element: AnimatableElement): boolean {\n    return true;\n  }\n}\n\n// Policy instances (singleton pattern for stateless policies)\nconst visibilityPolicy = new VisibilityPolicy();\nconst animationPolicy = new AnimationPolicy();\n\n/**\n * Determines if an element should be visible based on its phase and visibility policy.\n */\nconst shouldBeVisible = (\n  phase: ElementPhase,\n  element: AnimatableElement,\n): boolean => {\n  if (phase === \"before-start\" || phase === \"after-end\") {\n    return false;\n  }\n  if (phase === \"active\") {\n    return true;\n  }\n  // phase === \"at-end-boundary\"\n  return visibilityPolicy.shouldIncludeEndBoundary(element);\n};\n\n/**\n * Determines if animations should be coordinated based on element phase and animation policy.\n */\nconst shouldCoordinateAnimations = (\n  phase: ElementPhase,\n  element: AnimatableElement,\n): boolean => {\n  if (phase === \"before-start\" || phase === \"after-end\") {\n    return false;\n  }\n  if (phase === \"active\") {\n    return true;\n  }\n  // phase === \"at-end-boundary\"\n  return animationPolicy.shouldIncludeEndBoundary(element);\n};\n\n// ============================================================================\n// Temporal State Evaluation\n// ============================================================================\n\n/**\n * Evaluates what the element's state should be based on the timeline.\n *\n * WHY: This function determines the complete temporal state including phase,\n * which becomes the primary driver for all subsequent decisions.\n */\nexport const evaluateTemporalState = (\n  element: AnimatableElement,\n): TemporalState => {\n  // Get timeline time from root timegroup, or use element's own time if it IS a timegroup\n  const timelineTimeMs = (element.rootTimegroup ?? element).currentTimeMs;\n\n  const progress =\n    element.durationMs <= 0\n      ? 1\n      : Math.max(0, Math.min(1, element.currentTimeMs / element.durationMs));\n\n  const phase = determineElementPhase(element, timelineTimeMs);\n  const isVisible = shouldBeVisible(phase, element);\n\n  return { progress, isVisible, timelineTimeMs, phase };\n};\n\n/**\n * Evaluates element visibility state specifically for animation coordination.\n * Uses inclusive end boundaries to prevent animation jumps at exact boundaries.\n *\n * This is exported for external use cases that need animation-specific visibility\n * evaluation without the full ElementUpdateContext.\n */\nexport const evaluateAnimationVisibilityState = (\n  element: AnimatableElement,\n): TemporalState => {\n  const state = evaluateTemporalState(element);\n  // Override visibility based on animation policy\n  const shouldCoordinate = shouldCoordinateAnimations(state.phase, element);\n  return { ...state, isVisible: shouldCoordinate };\n};\n\n// ============================================================================\n// Animation Time Mapping\n// ============================================================================\n\n/**\n * Capability check: determines if an element supports stagger offset.\n * Encapsulates the knowledge of which element types support this feature.\n */\nconst supportsStaggerOffset = (\n  element: AnimatableElement,\n): element is StaggerableElement => {\n  // Currently only text segments support stagger offset\n  return element.tagName === \"EF-TEXT-SEGMENT\";\n};\n\n/**\n * Calculates effective delay including stagger offset if applicable.\n *\n * Stagger offset allows elements (like text segments) to have their animations\n * start at different times while keeping their visibility timing unchanged.\n * This enables staggered animation effects within a single timegroup.\n */\nconst calculateEffectiveDelay = (\n  delay: number,\n  element: AnimatableElement,\n): number => {\n  if (supportsStaggerOffset(element) && element.staggerOffsetMs !== undefined) {\n    // Apply stagger offset for animation timing\n    // We ADD the stagger offset to the delay, so animations start later for later segments\n    return delay + element.staggerOffsetMs;\n  }\n  return delay;\n};\n\n/**\n * Calculates maximum safe animation time to prevent completion.\n *\n * WHY: Once an animation reaches \"finished\" state, it can no longer be manually controlled\n * via currentTime. By clamping to just before completion (using ANIMATION_PRECISION_OFFSET),\n * we ensure the animation remains in a controllable state, allowing us to synchronize it\n * with the timeline even when it would naturally be complete.\n */\nconst calculateMaxSafeAnimationTime = (\n  duration: number,\n  iterations: number,\n): number => {\n  return duration * iterations - ANIMATION_PRECISION_OFFSET;\n};\n\n/**\n * Determines if the current iteration should be reversed based on direction\n */\nconst shouldReverseIteration = (\n  direction: string,\n  currentIteration: number,\n): boolean => {\n  return (\n    direction === \"reverse\" ||\n    (direction === \"alternate\" && currentIteration % 2 === 1) ||\n    (direction === \"alternate-reverse\" && currentIteration % 2 === 0)\n  );\n};\n\n/**\n * Applies direction to iteration time (reverses if needed)\n */\nconst applyDirectionToIterationTime = (\n  currentIterationTime: number,\n  duration: number,\n  direction: string,\n  currentIteration: number,\n): number => {\n  if (shouldReverseIteration(direction, currentIteration)) {\n    return duration - currentIterationTime;\n  }\n  return currentIterationTime;\n};\n\n/**\n * Maps element time to animation time for normal direction.\n * Uses cumulative time throughout the animation.\n * Note: elementTime should already be adjusted (elementTime - effectiveDelay).\n */\nconst mapNormalDirectionTime = (\n  elementTime: number,\n  duration: number,\n  maxSafeTime: number,\n): number => {\n  const currentIteration = Math.floor(elementTime / duration);\n  const iterationTime = elementTime % duration;\n  const cumulativeTime = currentIteration * duration + iterationTime;\n  return Math.min(cumulativeTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time for reverse direction.\n * Uses cumulative time with reversed iterations.\n * Note: elementTime should already be adjusted (elementTime - effectiveDelay).\n */\nconst mapReverseDirectionTime = (\n  elementTime: number,\n  duration: number,\n  maxSafeTime: number,\n): number => {\n  const currentIteration = Math.floor(elementTime / duration);\n  const rawIterationTime = elementTime % duration;\n  const reversedIterationTime = duration - rawIterationTime;\n  const cumulativeTime = currentIteration * duration + reversedIterationTime;\n  return Math.min(cumulativeTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time for alternate/alternate-reverse directions.\n *\n * WHY SPECIAL HANDLING: Alternate directions oscillate between forward and reverse iterations.\n * Without delay, we use iteration time (0 to duration) because the animation naturally\n * resets each iteration. However, with delay, iteration 0 needs to account for the delay\n * offset (using ownCurrentTimeMs), and later iterations need cumulative time to properly\n * track progress across multiple iterations. This complexity requires a dedicated mapper\n * rather than trying to handle it in the general case.\n */\nconst mapAlternateDirectionTime = (\n  elementTime: number,\n  effectiveDelay: number,\n  duration: number,\n  direction: string,\n  maxSafeTime: number,\n): number => {\n  const adjustedTime = elementTime - effectiveDelay;\n\n  if (effectiveDelay > 0) {\n    // With delay: iteration 0 uses elementTime to include delay offset,\n    // later iterations use cumulative time to track progress across iterations\n    const currentIteration = Math.floor(adjustedTime / duration);\n    if (currentIteration === 0) {\n      return Math.min(elementTime, maxSafeTime);\n    }\n    return Math.min(adjustedTime, maxSafeTime);\n  }\n\n  // Without delay: use iteration time (after direction applied) since animation\n  // naturally resets each iteration\n  const currentIteration = Math.floor(elementTime / duration);\n  const rawIterationTime = elementTime % duration;\n  const iterationTime = applyDirectionToIterationTime(\n    rawIterationTime,\n    duration,\n    direction,\n    currentIteration,\n  );\n  return Math.min(iterationTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time based on direction.\n *\n * WHY: This function explicitly transforms element time to animation time, making\n * the time mapping concept clear. Different directions require different transformations\n * to achieve the desired visual effect.\n */\nconst mapElementTimeToAnimationTime = (\n  elementTime: number,\n  timing: AnimationTiming,\n  effectiveDelay: number,\n): number => {\n  const { duration, iterations, direction } = timing;\n  const maxSafeTime = calculateMaxSafeAnimationTime(duration, iterations);\n  // Calculate adjusted time (element time minus delay) for normal/reverse directions\n  const adjustedTime = elementTime - effectiveDelay;\n\n  if (direction === \"reverse\") {\n    return mapReverseDirectionTime(adjustedTime, duration, maxSafeTime);\n  }\n  if (direction === \"alternate\" || direction === \"alternate-reverse\") {\n    return mapAlternateDirectionTime(\n      elementTime,\n      effectiveDelay,\n      duration,\n      direction,\n      maxSafeTime,\n    );\n  }\n  // normal direction - use adjustedTime to account for delay\n  return mapNormalDirectionTime(adjustedTime, duration, maxSafeTime);\n};\n\n/**\n * Determines the animation time for a completed animation based on direction.\n */\nconst getCompletedAnimationTime = (\n  timing: AnimationTiming,\n  maxSafeTime: number,\n): number => {\n  const { direction, iterations, duration } = timing;\n\n  if (direction === \"alternate\" || direction === \"alternate-reverse\") {\n    // For alternate directions, determine if final iteration is reversed\n    const finalIteration = iterations - 1;\n    const isFinalIterationReversed =\n      (direction === \"alternate\" && finalIteration % 2 === 1) ||\n      (direction === \"alternate-reverse\" && finalIteration % 2 === 0);\n\n    if (isFinalIterationReversed) {\n      // At end of reversed iteration, currentTime should be near 0 (but clamped)\n      return Math.min(duration - ANIMATION_PRECISION_OFFSET, maxSafeTime);\n    }\n  }\n\n  // For normal, reverse, or forward final iteration of alternate: use max safe time\n  return maxSafeTime;\n};\n\n/**\n * Validates that animation effect is a KeyframeEffect with a target\n */\nconst validateAnimationEffect = (\n  effect: AnimationEffect | null,\n): effect is KeyframeEffect & { target: Element } => {\n  return (\n    effect !== null &&\n    effect instanceof KeyframeEffect &&\n    effect.target !== null\n  );\n};\n\n/**\n * Extracts timing information from an animation effect.\n * Duration and delay from getTiming() are already in milliseconds.\n * We use getTiming().delay directly from the animation object.\n */\nconst extractAnimationTiming = (effect: KeyframeEffect): AnimationTiming => {\n  const timing = effect.getTiming();\n\n  return {\n    duration: Number(timing.duration) || 0,\n    delay: Number(timing.delay) || 0,\n    iterations: Number(timing.iterations) || DEFAULT_ANIMATION_ITERATIONS,\n    direction: timing.direction || \"normal\",\n  };\n};\n\n/**\n * Prepares animation for manual control by ensuring it's paused\n */\nconst prepareAnimation = (animation: Animation): void => {\n  // Ensure animation is in a playable state (not finished)\n  // Finished animations can't be controlled, so reset them\n  if (animation.playState === \"finished\") {\n    animation.cancel();\n    // Re-initialize the animation so it can be controlled\n    animation.play();\n    animation.pause();\n  } else if (animation.playState === \"running\") {\n    // Pause running animations so we can control them manually\n    animation.pause();\n  } else {\n    // For animations in \"idle\" or \"paused\" state, ensure they're initialized\n    // by playing and pausing. This ensures they're in a state where currentTime\n    // changes will actually apply keyframes.\n    // Only do this if currentTime is null (hasn't been set yet) to avoid\n    // disrupting animations that are already being controlled\n    if (animation.currentTime === null) {\n      animation.play();\n      animation.pause();\n    }\n    // Also ensure playState is \"paused\" (not \"idle\")\n    // Some animations might be in \"idle\" state even after play/pause\n    if (animation.playState === \"idle\") {\n      // Force to paused state by setting currentTime to 0 then pausing\n      animation.currentTime = 0;\n      animation.pause();\n    }\n  }\n};\n\n/**\n * Maps element time to animation currentTime and sets it on the animation.\n *\n * WHY: This function explicitly performs the time mapping transformation,\n * making it clear that we're transforming element time to animation time.\n */\nconst mapAndSetAnimationTime = (\n  animation: Animation,\n  element: AnimatableElement,\n  timing: AnimationTiming,\n  effectiveDelay: number,\n): void => {\n  // Use ownCurrentTimeMs for all elements (timegroups and other temporal elements)\n  // This gives us time relative to when the element started, which ensures animations\n  // on child elements are synchronized with their containing timegroup's timeline.\n  // For timegroups, ownCurrentTimeMs is the time relative to when the timegroup started.\n  // For other temporal elements, ownCurrentTimeMs is the time relative to their start.\n  const elementTime = element.ownCurrentTimeMs ?? 0;\n\n  // CRITICAL: Ensure animation is paused before setting currentTime\n  // Animations in \"running\" state won't apply keyframes when currentTime is set manually\n  if (animation.playState === \"running\") {\n    animation.pause();\n  }\n\n  // Calculate adjusted time (element time minus delay)\n  const adjustedTime = elementTime - effectiveDelay;\n\n  // If before delay, show initial keyframe state (0% of animation)\n  // Use strict < 0 so that at exactly the delay time (adjustedTime = 0), we start animating\n  if (adjustedTime < 0) {\n    // Before delay: currentTime should be at the absolute timeline time\n    // This ensures the animation is \"caught up\" with the delay\n    animation.currentTime = elementTime;\n    return;\n  }\n\n  // At delay time (adjustedTime = 0) or after, the animation should be active\n  const { duration, iterations } = timing;\n  const currentIteration = Math.floor(adjustedTime / duration);\n\n  if (currentIteration >= iterations) {\n    // Animation is completed - use completed time mapping\n    const maxSafeTime = calculateMaxSafeAnimationTime(duration, iterations);\n    const completedAnimationTime = getCompletedAnimationTime(\n      timing,\n      maxSafeTime,\n    );\n\n    // Completed: currentTime should be delay + completed animation time (absolute timeline time)\n    animation.currentTime = effectiveDelay + completedAnimationTime;\n  } else {\n    // Animation is in progress - map element time to animation time\n    const animationTime = mapElementTimeToAnimationTime(\n      elementTime,\n      timing,\n      effectiveDelay,\n    );\n\n    // For alternate direction with delay in iteration 0, mapAlternateDirectionTime returns elementTime directly\n    // For other cases, currentTime should be delay + animation time (absolute timeline time)\n    // Check if this is alternate direction with delay in iteration 0\n    const { direction } = timing;\n    const isAlternateWithDelay =\n      (direction === \"alternate\" || direction === \"alternate-reverse\") &&\n      effectiveDelay > 0;\n    if (isAlternateWithDelay && currentIteration === 0) {\n      // For alternate direction iteration 0 with delay, use elementTime directly\n      animation.currentTime = elementTime;\n    } else {\n      // For other cases, currentTime should be delay + animation time (absolute timeline time)\n      animation.currentTime = effectiveDelay + animationTime;\n    }\n  }\n};\n\n/**\n * Synchronizes a single animation with the timeline using the element as the time source.\n *\n * For animations in this element's subtree, always use this element as the time source.\n * This handles both animations directly on the temporal element and on its non-temporal children.\n */\nconst synchronizeAnimation = (\n  animation: Animation,\n  element: AnimatableElement,\n): void => {\n  const effect = animation.effect;\n  if (!validateAnimationEffect(effect)) {\n    return;\n  }\n\n  const timing = extractAnimationTiming(effect);\n\n  if (timing.duration <= 0) {\n    animation.currentTime = 0;\n    return;\n  }\n\n  // Find the containing timegroup for the animation target.\n  // Temporal elements are always synced to timegroups, so animations should use\n  // the timegroup's timeline as the time source.\n  const target = effect.target;\n  let timeSource: AnimatableElement = element;\n\n  if (target && target instanceof HTMLElement) {\n    // Find the nearest timegroup in the DOM tree\n    const nearestTimegroup = target.closest(\"ef-timegroup\");\n    if (nearestTimegroup && isEFTemporal(nearestTimegroup)) {\n      timeSource = nearestTimegroup as AnimatableElement;\n    }\n  }\n\n  const effectiveDelay = calculateEffectiveDelay(timing.delay, timeSource);\n  mapAndSetAnimationTime(animation, timeSource, timing, effectiveDelay);\n};\n\n/**\n * Coordinates animations for a single element and its subtree, using the element as the time source.\n *\n * Gets animations on the element itself and its subtree.\n * Both CSS animations (created via the 'animation' property) and WAAPI animations are included.\n */\nconst coordinateElementAnimations = (element: AnimatableElement): void => {\n  const animations = element.getAnimations({ subtree: true });\n\n  for (const animation of animations) {\n    prepareAnimation(animation);\n    synchronizeAnimation(animation, element);\n  }\n};\n\n// ============================================================================\n// Visual State Application\n// ============================================================================\n\n/**\n * Applies visual state (CSS + display) to match temporal state.\n *\n * WHY: This function applies visual state based on the element's phase and state.\n * Phase determines what should be visible, and this function applies that decision.\n */\nconst applyVisualState = (\n  element: AnimatableElement,\n  state: TemporalState,\n): void => {\n  // Always set progress (needed for many use cases)\n  element.style.setProperty(PROGRESS_PROPERTY, `${state.progress * 100}%`);\n\n  // Handle visibility based on phase\n  if (!state.isVisible) {\n    element.style.setProperty(\"display\", \"none\");\n    return;\n  }\n  element.style.removeProperty(\"display\");\n\n  // Set other CSS properties for visible elements only\n  element.style.setProperty(DURATION_PROPERTY, `${element.durationMs}ms`);\n  element.style.setProperty(\n    TRANSITION_DURATION_PROPERTY,\n    `${element.parentTimegroup?.overlapMs ?? 0}ms`,\n  );\n  element.style.setProperty(\n    TRANSITION_OUT_START_PROPERTY,\n    `${element.durationMs - (element.parentTimegroup?.overlapMs ?? 0)}ms`,\n  );\n};\n\n/**\n * Applies animation coordination if the element phase requires it.\n *\n * WHY: Animation coordination is driven by phase. If the element is in a phase\n * where animations should be coordinated, we coordinate them.\n */\nconst applyAnimationCoordination = (\n  element: AnimatableElement,\n  phase: ElementPhase,\n): void => {\n  if (shouldCoordinateAnimations(phase, element)) {\n    coordinateElementAnimations(element);\n  }\n};\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Evaluates the complete state for an element update.\n * This separates evaluation (what should the state be?) from application (apply that state).\n */\nconst evaluateElementState = (\n  element: AnimatableElement,\n): ElementUpdateContext => {\n  return {\n    element,\n    state: evaluateTemporalState(element),\n  };\n};\n\n/**\n * Main function: synchronizes DOM element with timeline.\n *\n * Orchestrates clear flow: Phase → Policy → Time Mapping → State Application\n *\n * WHY: This function makes the conceptual flow explicit:\n * 1. Determine phase (what phase is the element in?)\n * 2. Apply policies (should it be visible/coordinated based on phase?)\n * 3. Map time for animations (transform element time to animation time)\n * 4. Apply visual state (update CSS and display based on phase and policies)\n */\nexport const updateAnimations = (element: AnimatableElement): void => {\n  // Evaluate all states\n  const rootContext = evaluateElementState(element);\n  const childContexts = deepGetTemporalElements(element).map(\n    (temporalElement) => evaluateElementState(temporalElement),\n  );\n\n  // Apply visual state and animation coordination for root element\n  applyVisualState(rootContext.element, rootContext.state);\n  applyAnimationCoordination(rootContext.element, rootContext.state.phase);\n\n  // Apply visual state and animation coordination for all temporal child elements\n  childContexts.forEach((context) => {\n    applyVisualState(context.element, context.state);\n    applyAnimationCoordination(context.element, context.state.phase);\n  });\n};\n"],"mappings":"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"}
+{"version":3,"file":"updateAnimations.js","names":["rootTracked","currentAnimations: Animation[]","currentAnimations","timeSource: AnimatableElement","staggerElement: AnimatableElement"],"sources":["../../src/elements/updateAnimations.ts"],"sourcesContent":["import {\n  deepGetTemporalElements,\n  isEFTemporal,\n  type TemporalMixinInterface,\n} from \"./EFTemporal.ts\";\n\n// All animatable elements are temporal elements with HTMLElement interface\nexport type AnimatableElement = TemporalMixinInterface & HTMLElement;\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst ANIMATION_PRECISION_OFFSET = 0.1; // Use 0.1ms to safely avoid completion threshold\nconst DEFAULT_ANIMATION_ITERATIONS = 1;\nconst PROGRESS_PROPERTY = \"--ef-progress\";\nconst DURATION_PROPERTY = \"--ef-duration\";\nconst TRANSITION_DURATION_PROPERTY = \"--ef-transition-duration\";\nconst TRANSITION_OUT_START_PROPERTY = \"--ef-transition-out-start\";\n\n// ============================================================================\n// Animation Tracking\n// ============================================================================\n\n/**\n * Tracks animations per element to prevent them from being lost when they complete.\n * Once an animation reaches 100% completion, it's removed from getAnimations(),\n * but we keep a reference to it so we can continue controlling it.\n */\nconst animationTracker = new WeakMap<Element, Set<Animation>>();\n\n/**\n * Tracks whether DOM structure has changed for an element, requiring animation rediscovery.\n * For render clones (static DOM), this stays false after initial discovery.\n * For prime timeline (interactive), this is set to true when mutations occur.\n */\nconst domStructureChanged = new WeakMap<Element, boolean>();\n\n/**\n * Tracks the last known animation count for an element to detect new animations.\n * Used as a lightweight check before calling expensive getAnimations().\n */\nconst lastAnimationCount = new WeakMap<Element, number>();\n\n/**\n * Checks if an element is in a render clone (static DOM context).\n * Render clones are in containers with class \"ef-render-clone-container\".\n */\nconst isRenderClone = (element: Element): boolean => {\n  return element.closest(\".ef-render-clone-container\") !== null;\n};\n\n/**\n * Validates that an animation is still valid and controllable.\n * Animations become invalid when:\n * - They've been cancelled (idle state and not in getAnimations())\n * - Their effect is null (animation was removed)\n * - Their target is no longer in the DOM\n */\nconst isAnimationValid = (\n  animation: Animation,\n  currentAnimations: Animation[],\n): boolean => {\n  // Check if animation has been cancelled\n  if (\n    animation.playState === \"idle\" &&\n    !currentAnimations.includes(animation)\n  ) {\n    return false;\n  }\n\n  // Check if animation effect is still valid\n  const effect = animation.effect;\n  if (!effect) {\n    return false;\n  }\n\n  // Check if target is still in DOM\n  if (effect instanceof KeyframeEffect) {\n    const target = effect.target;\n    if (target && target instanceof Element) {\n      if (!target.isConnected) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n};\n\n/**\n * Discovers and tracks animations on an element and its subtree.\n * This ensures we have references to animations even after they complete.\n *\n * Tracks animations per element where they exist, not just on the root element.\n * This allows us to find animations on any element in the subtree.\n *\n * OPTIMIZATION: For render clones (static DOM), discovery happens once at creation.\n * For prime timeline (interactive), discovery is responsive to DOM changes.\n *\n * Also cleans up invalid animations (cancelled, removed from DOM, etc.)\n */\nconst discoverAndTrackAnimations = (\n  element: AnimatableElement,\n): { tracked: Set<Animation>; current: Animation[] } => {\n  const isClone = isRenderClone(element);\n  const hasTrackedAnimations = animationTracker.has(element);\n  const structureChanged = domStructureChanged.get(element) ?? true;\n  \n  // OPTIMIZATION: For render clones with already-tracked animations and no structure changes,\n  // skip expensive getAnimations() call and reuse tracked animations.\n  // We still need to validate tracked animations are still valid, but we can do that\n  // without calling getAnimations({ subtree: true }) on every frame.\n  if (isClone && hasTrackedAnimations && !structureChanged) {\n    // Use tracked animations directly, but validate them are still valid\n    const rootTracked = animationTracker.get(element)!;\n    const currentAnimations: Animation[] = [];\n    \n    // Quick validation: check if any tracked animations are still in getAnimations()\n    // We only check the root element's direct animations (cheaper than subtree)\n    const rootDirectAnimations = element.getAnimations();\n    for (const animation of rootTracked) {\n      if (isAnimationValid(animation, rootDirectAnimations)) {\n        currentAnimations.push(animation);\n      }\n    }\n    \n    // For render clones, animations don't change, so we can trust tracked set\n    // Just return the tracked set (which should be complete)\n    return { tracked: rootTracked, current: currentAnimations };\n  }\n  \n  // For prime timeline or first discovery: get current animations from the browser (includes subtree)\n  // CRITICAL: This is expensive, so we return it to avoid calling it again\n  const currentAnimations = element.getAnimations({ subtree: true });\n  \n  // Mark structure as stable after discovery (for render clones, this stays stable)\n  if (isClone) {\n    domStructureChanged.set(element, false);\n  }\n  \n  // Track animation count for lightweight change detection\n  lastAnimationCount.set(element, currentAnimations.length);\n\n  // Track animations on each element where they exist\n  for (const animation of currentAnimations) {\n    const effect = animation.effect;\n    const target = effect && effect instanceof KeyframeEffect ? effect.target : null;\n    if (target && target instanceof Element) {\n      let tracked = animationTracker.get(target);\n      if (!tracked) {\n        tracked = new Set<Animation>();\n        animationTracker.set(target, tracked);\n      }\n      tracked.add(animation);\n    }\n  }\n  \n  // Also maintain a set on the root element for coordination\n  let rootTracked = animationTracker.get(element);\n  if (!rootTracked) {\n    rootTracked = new Set<Animation>();\n    animationTracker.set(element, rootTracked);\n  }\n\n  // Update root set with all current animations\n  for (const animation of currentAnimations) {\n    rootTracked.add(animation);\n  }\n\n  // Clean up invalid animations from root set\n  // This handles animations that were cancelled, removed from DOM, or had their effects removed\n  for (const animation of rootTracked) {\n    if (!isAnimationValid(animation, currentAnimations)) {\n      rootTracked.delete(animation);\n    }\n  }\n\n  // Also clean up invalid animations from per-element sets\n  // We need to check all elements that might have tracked animations\n  const allTargets = new Set<Element>();\n  for (const animation of currentAnimations) {\n    const effect = animation.effect;\n    const target = effect && effect instanceof KeyframeEffect ? effect.target : null;\n    if (target && target instanceof Element) {\n      allTargets.add(target);\n    }\n  }\n\n  // Check tracked sets for elements that might have invalid animations\n  // We can't iterate WeakMap directly, but we can check elements we know about\n  // and also check elements in the subtree\n  const subtreeElements = element.querySelectorAll(\"*\");\n  for (const el of subtreeElements) {\n    const tracked = animationTracker.get(el);\n    if (tracked) {\n      for (const animation of tracked) {\n        if (!isAnimationValid(animation, Array.from(el.getAnimations()))) {\n          tracked.delete(animation);\n        }\n      }\n      // Remove empty sets to free memory\n      if (tracked.size === 0) {\n        animationTracker.delete(el);\n      }\n    }\n  }\n\n  return { tracked: rootTracked, current: currentAnimations };\n};\n\n/**\n * Gets tracked animations for a specific element.\n * This allows external code to access animations even after they complete.\n * Automatically filters out invalid animations (cancelled, removed, etc.)\n */\nexport const getTrackedAnimations = (element: Element): Animation[] => {\n  const tracked = animationTracker.get(element);\n  if (!tracked) {\n    return [];\n  }\n\n  const currentAnimations = element.getAnimations();\n\n  // Filter out invalid animations\n  return Array.from(tracked).filter((animation) =>\n    isAnimationValid(animation, currentAnimations),\n  );\n};\n\n/**\n * Cleans up tracked animations when an element is disconnected.\n * This prevents memory leaks.\n */\nexport const cleanupTrackedAnimations = (element: Element): void => {\n  animationTracker.delete(element);\n  domStructureChanged.delete(element);\n  lastAnimationCount.delete(element);\n};\n\n/**\n * Marks that DOM structure has changed for an element, requiring animation rediscovery.\n * Should be called when elements are added/removed or CSS classes change that affect animations.\n * \n * For render clones, this should never be called (DOM is static).\n * For prime timeline, call this when mutations occur that might affect animations.\n */\nexport const markDomStructureChanged = (element: Element): void => {\n  // Only mark changes for prime timeline (not render clones)\n  if (!isRenderClone(element)) {\n    domStructureChanged.set(element, true);\n  }\n};\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Represents the phase an element is in relative to the timeline.\n * This is the primary concept that drives all visibility and animation decisions.\n */\nexport type ElementPhase =\n  | \"before-start\"\n  | \"active\"\n  | \"at-end-boundary\"\n  | \"after-end\";\n\n/**\n * Represents the temporal state of an element relative to the timeline\n */\ninterface TemporalState {\n  progress: number;\n  isVisible: boolean;\n  timelineTimeMs: number;\n  phase: ElementPhase;\n}\n\n/**\n * Context object that holds all evaluated state for an element update.\n * This groups related state together, reducing parameter passing and making\n * the data flow clearer.\n */\ninterface ElementUpdateContext {\n  element: AnimatableElement;\n  state: TemporalState;\n}\n\n/**\n * Animation timing information extracted from an animation effect.\n * Groups related timing properties together.\n */\ninterface AnimationTiming {\n  duration: number;\n  delay: number;\n  iterations: number;\n  direction: string;\n}\n\n/**\n * Capability interface for elements that support stagger offset.\n * This encapsulates the stagger behavior behind a capability check rather than\n * leaking tag name checks throughout the codebase.\n */\ninterface StaggerableElement extends AnimatableElement {\n  staggerOffsetMs?: number;\n}\n\n// ============================================================================\n// Phase Determination\n// ============================================================================\n\n/**\n * Determines what phase an element is in relative to the timeline.\n *\n * WHY: Phase is the primary concept that drives all decisions. By explicitly\n * enumerating phases, we make the code's logic clear: phase determines visibility,\n * animation coordination, and visual state.\n *\n * Phases:\n * - before-start: Timeline is before element's start time\n * - active: Timeline is within element's active range (start to end, exclusive of end)\n * - at-end-boundary: Timeline is exactly at element's end time\n * - after-end: Timeline is after element's end time\n *\n * Note: We detect \"at-end-boundary\" by checking if timeline equals end time.\n * The boundary policy will then determine if this should be treated as visible/active\n * or not based on element characteristics.\n */\nconst determineElementPhase = (\n  element: AnimatableElement,\n  timelineTimeMs: number,\n): ElementPhase => {\n  // Read endTimeMs once to avoid recalculation issues\n  const endTimeMs = element.endTimeMs;\n  const startTimeMs = element.startTimeMs;\n\n  // Invalid range (end <= start) means element hasn't computed its duration yet,\n  // or has no temporal children (e.g., timegroup with only static HTML).\n  // Treat as always active - these elements should be visible at all times.\n  if (endTimeMs <= startTimeMs) {\n    return \"active\";\n  }\n\n  if (timelineTimeMs < startTimeMs) {\n    return \"before-start\";\n  }\n  // Use epsilon to handle floating point precision issues\n  const epsilon = 0.001;\n  const diff = timelineTimeMs - endTimeMs;\n\n  // If clearly after end (difference > epsilon), return 'after-end'\n  if (diff > epsilon) {\n    return \"after-end\";\n  }\n  // If at or very close to end boundary (within epsilon), return 'at-end-boundary'\n  if (Math.abs(diff) <= epsilon) {\n    return \"at-end-boundary\";\n  }\n  // Otherwise, we're before the end, so check if we're active\n  return \"active\";\n};\n\n// ============================================================================\n// Boundary Policies\n// ============================================================================\n\n/**\n * Policy interface for determining behavior at boundaries.\n * Different policies apply different rules for when elements should be visible\n * or have animations coordinated at exact boundary times.\n */\ninterface BoundaryPolicy {\n  /**\n   * Determines if an element should be considered visible/active at the end boundary\n   * based on the element's characteristics.\n   */\n  shouldIncludeEndBoundary(element: AnimatableElement): boolean;\n}\n\n/**\n * Visibility policy: determines when elements should be visible for display purposes.\n *\n * WHY: Root elements, elements aligned with composition end, and text segments\n * should remain visible at exact end time to prevent flicker and show final frames.\n * Other elements use exclusive end for clean transitions between elements.\n */\nclass VisibilityPolicy implements BoundaryPolicy {\n  shouldIncludeEndBoundary(element: AnimatableElement): boolean {\n    // Root elements should remain visible at exact end time to prevent flicker\n    const isRootElement = !element.parentTimegroup;\n    if (isRootElement) {\n      return true;\n    }\n\n    // Elements aligned with composition end should remain visible at exact end time\n    const isLastElementInComposition =\n      element.endTimeMs === element.rootTimegroup?.endTimeMs;\n    if (isLastElementInComposition) {\n      return true;\n    }\n\n    // Text segments use inclusive end since they're meant to be visible for full duration\n    if (this.isTextSegment(element)) {\n      return true;\n    }\n\n    // Other elements use exclusive end for clean transitions\n    return false;\n  }\n\n  /**\n   * Checks if element is a text segment.\n   * Encapsulates the tag name check to hide implementation detail.\n   */\n  protected isTextSegment(element: AnimatableElement): boolean {\n    return element.tagName === \"EF-TEXT-SEGMENT\";\n  }\n}\n\n/**\n * Animation policy: determines when animations should be coordinated.\n *\n * WHY: When an animation reaches exactly the end time of an element, using exclusive\n * end would make the element invisible, causing the animation to be removed from the\n * DOM and creating a visual jump. By using inclusive end, we ensure animations remain\n * coordinated even at exact boundary times, providing smooth visual transitions.\n */\nclass AnimationPolicy implements BoundaryPolicy {\n  shouldIncludeEndBoundary(_element: AnimatableElement): boolean {\n    return true;\n  }\n}\n\n// Policy instances (singleton pattern for stateless policies)\nconst visibilityPolicy = new VisibilityPolicy();\nconst animationPolicy = new AnimationPolicy();\n\n/**\n * Determines if an element should be visible based on its phase and visibility policy.\n */\nconst shouldBeVisible = (\n  phase: ElementPhase,\n  element: AnimatableElement,\n): boolean => {\n  if (phase === \"before-start\" || phase === \"after-end\") {\n    return false;\n  }\n  if (phase === \"active\") {\n    return true;\n  }\n  // phase === \"at-end-boundary\"\n  return visibilityPolicy.shouldIncludeEndBoundary(element);\n};\n\n/**\n * Determines if animations should be coordinated based on element phase and animation policy.\n */\nconst shouldCoordinateAnimations = (\n  phase: ElementPhase,\n  element: AnimatableElement,\n): boolean => {\n  if (phase === \"before-start\" || phase === \"after-end\") {\n    return false;\n  }\n  if (phase === \"active\") {\n    return true;\n  }\n  // phase === \"at-end-boundary\"\n  return animationPolicy.shouldIncludeEndBoundary(element);\n};\n\n// ============================================================================\n// Temporal State Evaluation\n// ============================================================================\n\n/**\n * Evaluates what the element's state should be based on the timeline.\n *\n * WHY: This function determines the complete temporal state including phase,\n * which becomes the primary driver for all subsequent decisions.\n */\nexport const evaluateTemporalState = (\n  element: AnimatableElement,\n): TemporalState => {\n  // Get timeline time from root timegroup, or use element's own time if it IS a timegroup\n  const timelineTimeMs = (element.rootTimegroup ?? element).currentTimeMs;\n\n  const progress =\n    element.durationMs <= 0\n      ? 1\n      : Math.max(0, Math.min(1, element.currentTimeMs / element.durationMs));\n\n  const phase = determineElementPhase(element, timelineTimeMs);\n  const isVisible = shouldBeVisible(phase, element);\n\n  return { progress, isVisible, timelineTimeMs, phase };\n};\n\n/**\n * Evaluates element visibility state specifically for animation coordination.\n * Uses inclusive end boundaries to prevent animation jumps at exact boundaries.\n *\n * This is exported for external use cases that need animation-specific visibility\n * evaluation without the full ElementUpdateContext.\n */\nexport const evaluateAnimationVisibilityState = (\n  element: AnimatableElement,\n): TemporalState => {\n  const state = evaluateTemporalState(element);\n  // Override visibility based on animation policy\n  const shouldCoordinate = shouldCoordinateAnimations(state.phase, element);\n  return { ...state, isVisible: shouldCoordinate };\n};\n\n// ============================================================================\n// Animation Time Mapping\n// ============================================================================\n\n/**\n * Capability check: determines if an element supports stagger offset.\n * Encapsulates the knowledge of which element types support this feature.\n */\nconst supportsStaggerOffset = (\n  element: AnimatableElement,\n): element is StaggerableElement => {\n  // Currently only text segments support stagger offset\n  return element.tagName === \"EF-TEXT-SEGMENT\";\n};\n\n/**\n * Calculates effective delay including stagger offset if applicable.\n *\n * Stagger offset allows elements (like text segments) to have their animations\n * start at different times while keeping their visibility timing unchanged.\n * This enables staggered animation effects within a single timegroup.\n */\nconst calculateEffectiveDelay = (\n  delay: number,\n  element: AnimatableElement,\n): number => {\n  if (supportsStaggerOffset(element)) {\n    // Read stagger offset - try property first (more reliable), then CSS variable\n    // The staggerOffsetMs property is set directly on the element and is always available\n    const segment = element as any;\n    if (\n      segment.staggerOffsetMs !== undefined &&\n      segment.staggerOffsetMs !== null\n    ) {\n      return delay + segment.staggerOffsetMs;\n    }\n\n    // Fallback to CSS variable if property not available\n    let cssValue = (element as HTMLElement).style\n      .getPropertyValue(\"--ef-stagger-offset\")\n      .trim();\n\n    if (!cssValue) {\n      cssValue = window\n        .getComputedStyle(element)\n        .getPropertyValue(\"--ef-stagger-offset\")\n        .trim();\n    }\n\n    if (cssValue) {\n      // Parse \"100ms\" format to milliseconds\n      const match = cssValue.match(/(\\d+(?:\\.\\d+)?)\\s*ms?/);\n      if (match) {\n        const staggerOffset = parseFloat(match[1]!);\n        if (!isNaN(staggerOffset)) {\n          return delay + staggerOffset;\n        }\n      } else {\n        // Try parsing as just a number\n        const numValue = parseFloat(cssValue);\n        if (!isNaN(numValue)) {\n          return delay + numValue;\n        }\n      }\n    }\n  }\n  return delay;\n};\n\n/**\n * Calculates maximum safe animation time to prevent completion.\n *\n * WHY: Once an animation reaches \"finished\" state, it can no longer be manually controlled\n * via currentTime. By clamping to just before completion (using ANIMATION_PRECISION_OFFSET),\n * we ensure the animation remains in a controllable state, allowing us to synchronize it\n * with the timeline even when it would naturally be complete.\n */\nconst calculateMaxSafeAnimationTime = (\n  duration: number,\n  iterations: number,\n): number => {\n  return duration * iterations - ANIMATION_PRECISION_OFFSET;\n};\n\n/**\n * Determines if the current iteration should be reversed based on direction\n */\nconst shouldReverseIteration = (\n  direction: string,\n  currentIteration: number,\n): boolean => {\n  return (\n    direction === \"reverse\" ||\n    (direction === \"alternate\" && currentIteration % 2 === 1) ||\n    (direction === \"alternate-reverse\" && currentIteration % 2 === 0)\n  );\n};\n\n/**\n * Applies direction to iteration time (reverses if needed)\n */\nconst applyDirectionToIterationTime = (\n  currentIterationTime: number,\n  duration: number,\n  direction: string,\n  currentIteration: number,\n): number => {\n  if (shouldReverseIteration(direction, currentIteration)) {\n    return duration - currentIterationTime;\n  }\n  return currentIterationTime;\n};\n\n/**\n * Maps element time to animation time for normal direction.\n * Uses cumulative time throughout the animation.\n * Note: elementTime should already be adjusted (elementTime - effectiveDelay).\n */\nconst mapNormalDirectionTime = (\n  elementTime: number,\n  duration: number,\n  maxSafeTime: number,\n): number => {\n  const currentIteration = Math.floor(elementTime / duration);\n  const iterationTime = elementTime % duration;\n  const cumulativeTime = currentIteration * duration + iterationTime;\n  return Math.min(cumulativeTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time for reverse direction.\n * Uses cumulative time with reversed iterations.\n * Note: elementTime should already be adjusted (elementTime - effectiveDelay).\n */\nconst mapReverseDirectionTime = (\n  elementTime: number,\n  duration: number,\n  maxSafeTime: number,\n): number => {\n  const currentIteration = Math.floor(elementTime / duration);\n  const rawIterationTime = elementTime % duration;\n  const reversedIterationTime = duration - rawIterationTime;\n  const cumulativeTime = currentIteration * duration + reversedIterationTime;\n  return Math.min(cumulativeTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time for alternate/alternate-reverse directions.\n *\n * WHY SPECIAL HANDLING: Alternate directions oscillate between forward and reverse iterations.\n * Without delay, we use iteration time (0 to duration) because the animation naturally\n * resets each iteration. However, with delay, iteration 0 needs to account for the delay\n * offset (using ownCurrentTimeMs), and later iterations need cumulative time to properly\n * track progress across multiple iterations. This complexity requires a dedicated mapper\n * rather than trying to handle it in the general case.\n */\nconst mapAlternateDirectionTime = (\n  elementTime: number,\n  effectiveDelay: number,\n  duration: number,\n  direction: string,\n  maxSafeTime: number,\n): number => {\n  const adjustedTime = elementTime - effectiveDelay;\n\n  if (effectiveDelay > 0) {\n    // With delay: iteration 0 uses elementTime to include delay offset,\n    // later iterations use cumulative time to track progress across iterations\n    const currentIteration = Math.floor(adjustedTime / duration);\n    if (currentIteration === 0) {\n      return Math.min(elementTime, maxSafeTime);\n    }\n    return Math.min(adjustedTime, maxSafeTime);\n  }\n\n  // Without delay: use iteration time (after direction applied) since animation\n  // naturally resets each iteration\n  const currentIteration = Math.floor(elementTime / duration);\n  const rawIterationTime = elementTime % duration;\n  const iterationTime = applyDirectionToIterationTime(\n    rawIterationTime,\n    duration,\n    direction,\n    currentIteration,\n  );\n  return Math.min(iterationTime, maxSafeTime);\n};\n\n/**\n * Maps element time to animation time based on direction.\n *\n * WHY: This function explicitly transforms element time to animation time, making\n * the time mapping concept clear. Different directions require different transformations\n * to achieve the desired visual effect.\n */\nconst mapElementTimeToAnimationTime = (\n  elementTime: number,\n  timing: AnimationTiming,\n  effectiveDelay: number,\n): number => {\n  const { duration, iterations, direction } = timing;\n  const maxSafeTime = calculateMaxSafeAnimationTime(duration, iterations);\n  // Calculate adjusted time (element time minus delay) for normal/reverse directions\n  const adjustedTime = elementTime - effectiveDelay;\n\n  if (direction === \"reverse\") {\n    return mapReverseDirectionTime(adjustedTime, duration, maxSafeTime);\n  }\n  if (direction === \"alternate\" || direction === \"alternate-reverse\") {\n    return mapAlternateDirectionTime(\n      elementTime,\n      effectiveDelay,\n      duration,\n      direction,\n      maxSafeTime,\n    );\n  }\n  // normal direction - use adjustedTime to account for delay\n  return mapNormalDirectionTime(adjustedTime, duration, maxSafeTime);\n};\n\n/**\n * Determines the animation time for a completed animation based on direction.\n */\nconst getCompletedAnimationTime = (\n  timing: AnimationTiming,\n  maxSafeTime: number,\n): number => {\n  const { direction, iterations, duration } = timing;\n\n  if (direction === \"alternate\" || direction === \"alternate-reverse\") {\n    // For alternate directions, determine if final iteration is reversed\n    const finalIteration = iterations - 1;\n    const isFinalIterationReversed =\n      (direction === \"alternate\" && finalIteration % 2 === 1) ||\n      (direction === \"alternate-reverse\" && finalIteration % 2 === 0);\n\n    if (isFinalIterationReversed) {\n      // At end of reversed iteration, currentTime should be near 0 (but clamped)\n      return Math.min(duration - ANIMATION_PRECISION_OFFSET, maxSafeTime);\n    }\n  }\n\n  // For normal, reverse, or forward final iteration of alternate: use max safe time\n  return maxSafeTime;\n};\n\n/**\n * Validates that animation effect is a KeyframeEffect with a target\n */\nconst validateAnimationEffect = (\n  effect: AnimationEffect | null,\n): effect is KeyframeEffect & { target: Element } => {\n  return (\n    effect !== null &&\n    effect instanceof KeyframeEffect &&\n    effect.target !== null\n  );\n};\n\n/**\n * Extracts timing information from an animation effect.\n * Duration and delay from getTiming() are already in milliseconds.\n * We use getTiming().delay directly from the animation object.\n */\nconst extractAnimationTiming = (effect: KeyframeEffect): AnimationTiming => {\n  const timing = effect.getTiming();\n\n  return {\n    duration: Number(timing.duration) || 0,\n    delay: Number(timing.delay) || 0,\n    iterations: Number(timing.iterations) || DEFAULT_ANIMATION_ITERATIONS,\n    direction: timing.direction || \"normal\",\n  };\n};\n\n/**\n * Prepares animation for manual control by ensuring it's paused\n */\nconst prepareAnimation = (animation: Animation): void => {\n  // Ensure animation is in a controllable state\n  // Finished animations can't be controlled, so reset them\n  if (animation.playState === \"finished\") {\n    animation.cancel();\n    // After cancel, animation is in idle state - we can set currentTime directly\n    // No need to play/pause - we'll control it via currentTime\n  } else if (animation.playState === \"running\") {\n    // Pause running animations so we can control them manually\n    animation.pause();\n  }\n  // For \"idle\" or \"paused\" state, we can set currentTime directly without play/pause\n  // Setting currentTime on a paused animation will apply the keyframes\n  // No initialization needed - we control everything via currentTime\n};\n\n/**\n * Maps element time to animation currentTime and sets it on the animation.\n *\n * WHY: This function explicitly performs the time mapping transformation,\n * making it clear that we're transforming element time to animation time.\n */\nconst mapAndSetAnimationTime = (\n  animation: Animation,\n  element: AnimatableElement,\n  timing: AnimationTiming,\n  effectiveDelay: number,\n): void => {\n  // Use ownCurrentTimeMs for all elements (timegroups and other temporal elements)\n  // This gives us time relative to when the element started, which ensures animations\n  // on child elements are synchronized with their containing timegroup's timeline.\n  // For timegroups, ownCurrentTimeMs is the time relative to when the timegroup started.\n  // For other temporal elements, ownCurrentTimeMs is the time relative to their start.\n  const elementTime = element.ownCurrentTimeMs ?? 0;\n\n  // Ensure animation is paused before setting currentTime\n  if (animation.playState === \"running\") {\n    animation.pause();\n  }\n\n  // Calculate adjusted time (element time minus delay)\n  const adjustedTime = elementTime - effectiveDelay;\n\n  // If before delay, show initial keyframe state (0% of animation)\n  if (adjustedTime < 0) {\n    // Before delay: show initial keyframe state\n    // For CSS animations with delay > 0, currentTime includes the delay, so set to elementTime\n    // For CSS animations with delay = 0, currentTime is just animation progress, so set to 0\n    if (timing.delay > 0) {\n      animation.currentTime = elementTime;\n    } else {\n      animation.currentTime = 0;\n    }\n    return;\n  }\n\n  // At delay time (adjustedTime = 0) or after, the animation should be active\n  const { duration, iterations } = timing;\n  const currentIteration = Math.floor(adjustedTime / duration);\n\n  if (currentIteration >= iterations) {\n    // Animation is completed - use completed time mapping\n    const maxSafeTime = calculateMaxSafeAnimationTime(duration, iterations);\n    const completedAnimationTime = getCompletedAnimationTime(\n      timing,\n      maxSafeTime,\n    );\n\n    // CRITICAL: For CSS animations, currentTime behavior differs based on whether delay > 0:\n    // - If timing.delay > 0: currentTime includes the delay (absolute timeline time)\n    // - If timing.delay === 0: currentTime is just animation progress (0 to duration)\n    if (timing.delay > 0) {\n      // Completed: currentTime should be delay + completed animation time (absolute timeline time)\n      animation.currentTime = effectiveDelay + completedAnimationTime;\n    } else {\n      // Completed: currentTime should be just the completed animation time (animation progress)\n      animation.currentTime = completedAnimationTime;\n    }\n  } else {\n    // Animation is in progress - map element time to animation time\n    const animationTime = mapElementTimeToAnimationTime(\n      elementTime,\n      timing,\n      effectiveDelay,\n    );\n\n    // CRITICAL: For CSS animations, currentTime behavior differs based on whether delay > 0:\n    // - If timing.delay > 0: currentTime includes the delay (absolute timeline time)\n    // - If timing.delay === 0: currentTime is just animation progress (0 to duration)\n    //   Stagger offset is handled via adjustedTime calculation, but doesn't affect currentTime format\n    const { direction, delay } = timing;\n\n    if (delay > 0) {\n      // CSS animation with delay: currentTime is absolute timeline time\n      const isAlternateWithDelay =\n        (direction === \"alternate\" || direction === \"alternate-reverse\") &&\n        effectiveDelay > 0;\n      if (isAlternateWithDelay && currentIteration === 0) {\n        // For alternate direction iteration 0 with delay, use elementTime directly\n        animation.currentTime = elementTime;\n      } else {\n        // For other cases with delay, currentTime should be delay + animation time (absolute timeline time)\n        animation.currentTime = effectiveDelay + animationTime;\n      }\n    } else {\n      // CSS animation with delay = 0: currentTime is just animation progress\n      // Stagger offset is already accounted for in adjustedTime, so animationTime is the progress\n      animation.currentTime = animationTime;\n    }\n  }\n};\n\n/**\n * Synchronizes a single animation with the timeline using the element as the time source.\n *\n * For animations in this element's subtree, always use this element as the time source.\n * This handles both animations directly on the temporal element and on its non-temporal children.\n */\nconst synchronizeAnimation = (\n  animation: Animation,\n  element: AnimatableElement,\n): void => {\n  const effect = animation.effect;\n  if (!validateAnimationEffect(effect)) {\n    return;\n  }\n\n  const timing = extractAnimationTiming(effect);\n\n  if (timing.duration <= 0) {\n    animation.currentTime = 0;\n    return;\n  }\n\n  // Find the containing timegroup for the animation target.\n  // Temporal elements are always synced to timegroups, so animations should use\n  // the timegroup's timeline as the time source.\n  const target = effect.target;\n  let timeSource: AnimatableElement = element;\n\n  if (target && target instanceof HTMLElement) {\n    // Find the nearest timegroup in the DOM tree\n    const nearestTimegroup = target.closest(\"ef-timegroup\");\n    if (nearestTimegroup && isEFTemporal(nearestTimegroup)) {\n      timeSource = nearestTimegroup as AnimatableElement;\n    }\n  }\n\n  // For stagger offset, we need to find the actual text segment element.\n  // CSS animations might be on the segment itself or on a child element.\n  // If the target is not a text segment, try to find the parent text segment.\n  let staggerElement: AnimatableElement = timeSource;\n  if (target && target instanceof HTMLElement) {\n    // Check if target is a text segment\n    const targetAsAnimatable = target as AnimatableElement;\n    if (supportsStaggerOffset(targetAsAnimatable)) {\n      staggerElement = targetAsAnimatable;\n    } else {\n      // Target might be a child element - find the parent text segment\n      const parentSegment = target.closest(\"ef-text-segment\");\n      if (\n        parentSegment &&\n        supportsStaggerOffset(parentSegment as AnimatableElement)\n      ) {\n        staggerElement = parentSegment as AnimatableElement;\n      }\n    }\n  }\n\n  const effectiveDelay = calculateEffectiveDelay(timing.delay, staggerElement);\n  mapAndSetAnimationTime(animation, timeSource, timing, effectiveDelay);\n};\n\n/**\n * Coordinates animations for a single element and its subtree, using the element as the time source.\n *\n * Uses tracked animations to ensure we can control animations even after they complete.\n * Both CSS animations (created via the 'animation' property) and WAAPI animations are included.\n *\n * CRITICAL: CSS animations are created asynchronously when classes are added. This function\n * discovers new animations on each call and tracks them in memory. Once animations complete,\n * they're removed from getAnimations(), but we keep references to them so we can continue\n * controlling them.\n */\nconst coordinateElementAnimations = (element: AnimatableElement): void => {\n  // Discover and track animations (includes both current and previously completed ones)\n  // Reuse the current animations array to avoid calling getAnimations() twice\n  const { tracked: trackedAnimations, current: currentAnimations } = discoverAndTrackAnimations(element);\n\n  for (const animation of trackedAnimations) {\n    // Skip invalid animations (cancelled, removed from DOM, etc.)\n    if (!isAnimationValid(animation, currentAnimations)) {\n      continue;\n    }\n\n    prepareAnimation(animation);\n    synchronizeAnimation(animation, element);\n  }\n};\n\n// ============================================================================\n// Visual State Application\n// ============================================================================\n\n/**\n * Applies visual state (CSS + display) to match temporal state.\n *\n * WHY: This function applies visual state based on the element's phase and state.\n * Phase determines what should be visible, and this function applies that decision.\n */\nconst applyVisualState = (\n  element: AnimatableElement,\n  state: TemporalState,\n): void => {\n  // Always set progress (needed for many use cases)\n  element.style.setProperty(PROGRESS_PROPERTY, `${state.progress}`);\n\n  // Handle visibility based on phase\n  if (!state.isVisible) {\n    element.style.setProperty(\"display\", \"none\");\n    return;\n  }\n  element.style.removeProperty(\"display\");\n\n  // Set other CSS properties for visible elements only\n  element.style.setProperty(DURATION_PROPERTY, `${element.durationMs}ms`);\n  element.style.setProperty(\n    TRANSITION_DURATION_PROPERTY,\n    `${element.parentTimegroup?.overlapMs ?? 0}ms`,\n  );\n  element.style.setProperty(\n    TRANSITION_OUT_START_PROPERTY,\n    `${element.durationMs - (element.parentTimegroup?.overlapMs ?? 0)}ms`,\n  );\n};\n\n/**\n * Applies animation coordination if the element phase requires it.\n *\n * WHY: Animation coordination is driven by phase. If the element is in a phase\n * where animations should be coordinated, we coordinate them.\n */\nconst applyAnimationCoordination = (\n  element: AnimatableElement,\n  phase: ElementPhase,\n): void => {\n  if (shouldCoordinateAnimations(phase, element)) {\n    coordinateElementAnimations(element);\n  }\n};\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\n/**\n * Evaluates the complete state for an element update.\n * This separates evaluation (what should the state be?) from application (apply that state).\n */\nconst evaluateElementState = (\n  element: AnimatableElement,\n): ElementUpdateContext => {\n  return {\n    element,\n    state: evaluateTemporalState(element),\n  };\n};\n\n/**\n * Main function: synchronizes DOM element with timeline.\n *\n * Orchestrates clear flow: Phase → Policy → Time Mapping → State Application\n *\n * WHY: This function makes the conceptual flow explicit:\n * 1. Determine phase (what phase is the element in?)\n * 2. Apply policies (should it be visible/coordinated based on phase?)\n * 3. Map time for animations (transform element time to animation time)\n * 4. Apply visual state (update CSS and display based on phase and policies)\n */\nexport const updateAnimations = (element: AnimatableElement): void => {\n  // Evaluate all states\n  const rootContext = evaluateElementState(element);\n  const childContexts = deepGetTemporalElements(element).map(\n    (temporalElement) => evaluateElementState(temporalElement),\n  );\n\n  // Apply visual state and animation coordination for root element\n  applyVisualState(rootContext.element, rootContext.state);\n  applyAnimationCoordination(rootContext.element, rootContext.state.phase);\n\n  // Apply visual state and animation coordination for all temporal child elements\n  childContexts.forEach((context) => {\n    applyVisualState(context.element, context.state);\n    applyAnimationCoordination(context.element, context.state.phase);\n  });\n};\n"],"mappings":"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"}

package/dist/getRenderInfo.d.ts

@@ -22,9 +22,9 @@ declare const RenderInfo: z.ZodObject<{
   }>;
 }, "strip", z.ZodTypeAny, {
   durationMs: number;
+  fps: number;
   width: number;
   height: number;
-  fps: number;
   assets: {
     efMedia: Record<string, any>;
     efCaptions: string[];
@@ -32,9 +32,9 @@ declare const RenderInfo: z.ZodObject<{
   };
 }, {
   durationMs: number;
+  fps: number;
   width: number;
   height: number;
-  fps: number;
   assets: {
     efMedia: Record<string, any>;
     efCaptions: string[];

package/dist/gui/ContextMixin.js

@@ -31,7 +31,8 @@ function ContextMixin(superClass) {
 			this.fetch = async (url, init = {}) => {
 				init.headers ||= {};
 				Object.assign(init.headers, { "Content-Type": "application/json" });
-				if (!EF_RENDERING() && this.signingURL) {
+				const isLocalEndpoint = url.startsWith("/@ef-");
+				if (!EF_RENDERING() && this.signingURL && !isLocalEndpoint) {
 					const { cacheKey, signingPayload } = this.#getTokenCacheKey(url);
 					const urlToken = await globalURLTokenDeduplicator.getToken(cacheKey, async () => {
 						try {
@@ -50,9 +51,10 @@ function ContextMixin(superClass) {
 				} else init.credentials = "include";
 				try {
 					return fetch(url, init).catch((error) => {
+						if (error instanceof DOMException && error.name === "AbortError") throw error;
 						console.error("ContextMixin fetch error", url, error, window.location.href);
 						const enhancedError = new (error instanceof Error ? error.constructor : Error)(`Failed to fetch: ${url}. Original error: ${error instanceof Error ? error.message : String(error)}`);
-						if (error instanceof Error) {
+						if (error instanceof Error && !(error instanceof DOMException)) {
 							enhancedError.name = error.name;
 							enhancedError.stack = error.stack;
 							Object.assign(enhancedError, error);