animejs 4.2.2 → 4.3.0-beta.1

package/dist/modules/scope/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/scope/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/scope/scope.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/scope/scope.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/drawable.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/drawable.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/helpers.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/helpers.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/morphto.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/morphto.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/motionpath.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/svg/motionpath.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/text/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/text/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/text/split.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -89,12 +89,23 @@ const filterEmptyElements = $el => {
 /**
  * @param {HTMLElement} $el
  * @param {Number} lineIndex
- * @param {Set<HTMLElement>} bin
- * @returns {Set<HTMLElement>}
+ * @param {Set<HTMLElement|Node>} bin
+ * @returns {Set<HTMLElement|Node>}
  */
 const filterLineElements = ($el, lineIndex, bin) => {
   const dataLineAttr = $el.getAttribute(dataLine);
-  if (dataLineAttr !== null && +dataLineAttr !== lineIndex || $el.tagName === 'BR') bin.add($el);
+  if (dataLineAttr !== null && +dataLineAttr !== lineIndex || $el.tagName === 'BR') {
+    bin.add($el);
+    // Also remove adjacent whitespace-only text nodes
+    const prev = $el.previousSibling;
+    const next = $el.nextSibling;
+    if (prev && prev.nodeType === 3 && whiteSpaceRgx.test(prev.textContent)) {
+      bin.add(prev);
+    }
+    if (next && next.nodeType === 3 && whiteSpaceRgx.test(next.textContent)) {
+      bin.add(next);
+    }
+  }
   let i = $el.childElementCount;
   while (i--) filterLineElements(/** @type {HTMLElement} */($el.children[i]), lineIndex, bin);
   return bin;
@@ -309,7 +320,7 @@ class TextSplitter {
             // Only concatenate if both current and previous are non-word-like and don't contain spaces
             const lastWordIndex = tempWords.length - 1;
             const lastWord = tempWords[lastWordIndex];
-            if (!lastWord.includes(' ') && !segment.includes(' ')) {
+            if (!whiteSpaceGroupRgx.test(lastWord) && !whiteSpaceGroupRgx.test(segment)) {
               tempWords[lastWordIndex] += segment;
             } else {
               tempWords.push(segment);
@@ -402,7 +413,7 @@ class TextSplitter {
     for (let i = 0, l = elementsArray.length; i < l; i++) {
       const $el = elementsArray[i];
       const { top, height } = $el.getBoundingClientRect();
-      if (y && top - y > height * .5) linesCount++;
+      if (!helpers.isUnd(y) && top - y > height * .5) linesCount++;
       $el.setAttribute(dataLine, `${linesCount}`);
       const nested = $el.querySelectorAll(`[${dataLine}]`);
       let c = nested.length;
@@ -416,9 +427,11 @@ class TextSplitter {
       for (let lineIndex = 0; lineIndex < linesCount + 1; lineIndex++) {
         const $clone = /** @type {HTMLElement} */($el.cloneNode(true));
         filterLineElements($clone, lineIndex, new Set()).forEach($el => {
-          const $parent = $el.parentElement;
-          if ($parent) parents.add($parent);
-          $el.remove();
+          const $parent = $el.parentNode;
+          if ($parent) {
+            if ($el.nodeType === 1) parents.add(/** @type {HTMLElement} */($parent));
+            $parent.removeChild($el);
+          }
         });
         clones.push($clone);
       }
@@ -431,6 +444,7 @@ class TextSplitter {
       if (wordTemplate) this.words = getAllTopLevelElements($el, wordType);
       if (charTemplate) this.chars = getAllTopLevelElements($el, charType);
     }
+
     // Remove the word wrappers and clear the words array if lines split only
     if (this.linesOnly) {
       const words = this.words;

package/dist/modules/text/split.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -87,12 +87,23 @@ const filterEmptyElements = $el => {
 /**
  * @param {HTMLElement} $el
  * @param {Number} lineIndex
- * @param {Set<HTMLElement>} bin
- * @returns {Set<HTMLElement>}
+ * @param {Set<HTMLElement|Node>} bin
+ * @returns {Set<HTMLElement|Node>}
  */
 const filterLineElements = ($el, lineIndex, bin) => {
   const dataLineAttr = $el.getAttribute(dataLine);
-  if (dataLineAttr !== null && +dataLineAttr !== lineIndex || $el.tagName === 'BR') bin.add($el);
+  if (dataLineAttr !== null && +dataLineAttr !== lineIndex || $el.tagName === 'BR') {
+    bin.add($el);
+    // Also remove adjacent whitespace-only text nodes
+    const prev = $el.previousSibling;
+    const next = $el.nextSibling;
+    if (prev && prev.nodeType === 3 && whiteSpaceRgx.test(prev.textContent)) {
+      bin.add(prev);
+    }
+    if (next && next.nodeType === 3 && whiteSpaceRgx.test(next.textContent)) {
+      bin.add(next);
+    }
+  }
   let i = $el.childElementCount;
   while (i--) filterLineElements(/** @type {HTMLElement} */($el.children[i]), lineIndex, bin);
   return bin;
@@ -307,7 +318,7 @@ class TextSplitter {
             // Only concatenate if both current and previous are non-word-like and don't contain spaces
             const lastWordIndex = tempWords.length - 1;
             const lastWord = tempWords[lastWordIndex];
-            if (!lastWord.includes(' ') && !segment.includes(' ')) {
+            if (!whiteSpaceGroupRgx.test(lastWord) && !whiteSpaceGroupRgx.test(segment)) {
               tempWords[lastWordIndex] += segment;
             } else {
               tempWords.push(segment);
@@ -400,7 +411,7 @@ class TextSplitter {
     for (let i = 0, l = elementsArray.length; i < l; i++) {
       const $el = elementsArray[i];
       const { top, height } = $el.getBoundingClientRect();
-      if (y && top - y > height * .5) linesCount++;
+      if (!isUnd(y) && top - y > height * .5) linesCount++;
       $el.setAttribute(dataLine, `${linesCount}`);
       const nested = $el.querySelectorAll(`[${dataLine}]`);
       let c = nested.length;
@@ -414,9 +425,11 @@ class TextSplitter {
       for (let lineIndex = 0; lineIndex < linesCount + 1; lineIndex++) {
         const $clone = /** @type {HTMLElement} */($el.cloneNode(true));
         filterLineElements($clone, lineIndex, new Set()).forEach($el => {
-          const $parent = $el.parentElement;
-          if ($parent) parents.add($parent);
-          $el.remove();
+          const $parent = $el.parentNode;
+          if ($parent) {
+            if ($el.nodeType === 1) parents.add(/** @type {HTMLElement} */($parent));
+            $parent.removeChild($el);
+          }
         });
         clones.push($clone);
       }
@@ -429,6 +442,7 @@ class TextSplitter {
       if (wordTemplate) this.words = getAllTopLevelElements($el, wordType);
       if (charTemplate) this.chars = getAllTopLevelElements($el, charType);
     }
+
     // Remove the word wrappers and clear the words array if lines split only
     if (this.linesOnly) {
       const words = this.words;

package/dist/modules/timeline/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timeline/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timeline/position.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timeline/position.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timeline/timeline.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -77,11 +77,11 @@ function addTlChild(childParams, tl, timePosition, targets, index, length) {
   const isSetter = helpers.isNum(childParams.duration) && /** @type {Number} */(childParams.duration) <= consts.minValue;
   // Offset the tl position with -minValue for 0 duration animations or .set() calls in order to align their end value with the defined position
   const adjustedPosition = isSetter ? timePosition - consts.minValue : timePosition;
-  render.tick(tl, adjustedPosition, 1, 1, consts.tickModes.AUTO);
+  if (tl.composition) render.tick(tl, adjustedPosition, 1, 1, consts.tickModes.AUTO);
   const tlChild = targets ?
     new animation.JSAnimation(targets,/** @type {AnimationParams} */(childParams), tl, adjustedPosition, false, index, length) :
     new timer.Timer(/** @type {TimerParams} */(childParams), tl, adjustedPosition);
-  tlChild.init(true);
+  if (tl.composition) tlChild.init(true);
   // TODO: Might be better to insert at a position relative to startTime?
   helpers.addChild(tl, tlChild);
   helpers.forEachChildren(tl, (/** @type {Renderable} */child) => {
@@ -93,6 +93,8 @@ function addTlChild(childParams, tl, timePosition, targets, index, length) {
   return tl;
 }
 
+let TLId = 0;
+
 class Timeline extends timer.Timer {
 
   /**
@@ -100,6 +102,9 @@ class Timeline extends timer.Timer {
    */
   constructor(parameters = {}) {
     super(/** @type {TimerParams&TimelineParams} */(parameters), null, 0);
+    ++TLId;
+    /** @type {String|Number} */
+    this.id = !helpers.isUnd(parameters.id) ? parameters.id : TLId;
     /** @type {Number} */
     this.duration = 0; // TL duration starts at 0 and grows when adding children
     /** @type {Record<String, Number>} */
@@ -108,6 +113,8 @@ class Timeline extends timer.Timer {
     const globalDefaults = globals.globals.defaults;
     /** @type {DefaultsParams} */
     this.defaults = defaultsParams ? helpers.mergeObjects(defaultsParams, globalDefaults) : globalDefaults;
+    /** @type {Boolean} */
+    this.composition = values.setValue(parameters.composition, true);
     /** @type {Callback<this>} */
     this.onRender = parameters.onRender || globalDefaults.onRender;
     const tlPlaybackEase = values.setValue(parameters.playbackEase, globalDefaults.playbackEase);
@@ -185,7 +192,8 @@ class Timeline extends timer.Timer {
           position.parseTimelinePosition(this,a2),
         );
       }
-      return this.init(true);
+      if (this.composition) this.init(true);
+      return this;
     }
   }
 
@@ -212,7 +220,7 @@ class Timeline extends timer.Timer {
     if (helpers.isUnd(synced) || synced && helpers.isUnd(synced.pause)) return this;
     synced.pause();
     const duration = +(/** @type {globalThis.Animation} */(synced).effect ? /** @type {globalThis.Animation} */(synced).effect.getTiming().duration : /** @type {Tickable} */(synced).duration);
-    return this.add(synced, { currentTime: [0, duration], duration, ease: 'linear' }, position);
+    return this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
   }
 
   /**
@@ -235,7 +243,7 @@ class Timeline extends timer.Timer {
    */
   call(callback, position) {
     if (helpers.isUnd(callback) || callback && !helpers.isFnc(callback)) return this;
-    return this.add({ duration: 0, onComplete: () => callback(this) }, position);
+    return this.add({ duration: 0, delay: 0, onComplete: () => callback(this) }, position);
   }
 
   /**

package/dist/modules/timeline/timeline.d.ts

@@ -7,6 +7,8 @@ export class Timeline extends Timer {
     labels: Record<string, number>;
     /** @type {DefaultsParams} */
     defaults: DefaultsParams;
+    /** @type {Boolean} */
+    composition: boolean;
     /** @type {Callback<this>} */
     onRender: Callback<this>;
     _ease: import("../types/index.js").EasingFunction;

package/dist/modules/timeline/timeline.js

@@ -1,13 +1,13 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
 import { globals } from '../core/globals.js';
 import { minValue, compositionTypes, tickModes } from '../core/consts.js';
-import { mergeObjects, isObj, isFnc, isUnd, isStr, normalizeTime, forEachChildren, isNum, addChild, clampInfinity } from '../core/helpers.js';
+import { isUnd, mergeObjects, isObj, isFnc, isStr, normalizeTime, forEachChildren, isNum, addChild, clampInfinity } from '../core/helpers.js';
 import { setValue } from '../core/values.js';
 import { parseTargets } from '../core/targets.js';
 import { tick } from '../core/render.js';
@@ -75,11 +75,11 @@ function addTlChild(childParams, tl, timePosition, targets, index, length) {
   const isSetter = isNum(childParams.duration) && /** @type {Number} */(childParams.duration) <= minValue;
   // Offset the tl position with -minValue for 0 duration animations or .set() calls in order to align their end value with the defined position
   const adjustedPosition = isSetter ? timePosition - minValue : timePosition;
-  tick(tl, adjustedPosition, 1, 1, tickModes.AUTO);
+  if (tl.composition) tick(tl, adjustedPosition, 1, 1, tickModes.AUTO);
   const tlChild = targets ?
     new JSAnimation(targets,/** @type {AnimationParams} */(childParams), tl, adjustedPosition, false, index, length) :
     new Timer(/** @type {TimerParams} */(childParams), tl, adjustedPosition);
-  tlChild.init(true);
+  if (tl.composition) tlChild.init(true);
   // TODO: Might be better to insert at a position relative to startTime?
   addChild(tl, tlChild);
   forEachChildren(tl, (/** @type {Renderable} */child) => {
@@ -91,6 +91,8 @@ function addTlChild(childParams, tl, timePosition, targets, index, length) {
   return tl;
 }
 
+let TLId = 0;
+
 class Timeline extends Timer {
 
   /**
@@ -98,6 +100,9 @@ class Timeline extends Timer {
    */
   constructor(parameters = {}) {
     super(/** @type {TimerParams&TimelineParams} */(parameters), null, 0);
+    ++TLId;
+    /** @type {String|Number} */
+    this.id = !isUnd(parameters.id) ? parameters.id : TLId;
     /** @type {Number} */
     this.duration = 0; // TL duration starts at 0 and grows when adding children
     /** @type {Record<String, Number>} */
@@ -106,6 +111,8 @@ class Timeline extends Timer {
     const globalDefaults = globals.defaults;
     /** @type {DefaultsParams} */
     this.defaults = defaultsParams ? mergeObjects(defaultsParams, globalDefaults) : globalDefaults;
+    /** @type {Boolean} */
+    this.composition = setValue(parameters.composition, true);
     /** @type {Callback<this>} */
     this.onRender = parameters.onRender || globalDefaults.onRender;
     const tlPlaybackEase = setValue(parameters.playbackEase, globalDefaults.playbackEase);
@@ -183,7 +190,8 @@ class Timeline extends Timer {
           parseTimelinePosition(this,a2),
         );
       }
-      return this.init(true);
+      if (this.composition) this.init(true);
+      return this;
     }
   }
 
@@ -210,7 +218,7 @@ class Timeline extends Timer {
     if (isUnd(synced) || synced && isUnd(synced.pause)) return this;
     synced.pause();
     const duration = +(/** @type {globalThis.Animation} */(synced).effect ? /** @type {globalThis.Animation} */(synced).effect.getTiming().duration : /** @type {Tickable} */(synced).duration);
-    return this.add(synced, { currentTime: [0, duration], duration, ease: 'linear' }, position);
+    return this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
   }
 
   /**
@@ -233,7 +241,7 @@ class Timeline extends Timer {
    */
   call(callback, position) {
     if (isUnd(callback) || callback && !isFnc(callback)) return this;
-    return this.add({ duration: 0, onComplete: () => callback(this) }, position);
+    return this.add({ duration: 0, delay: 0, onComplete: () => callback(this) }, position);
   }
 
   /**

package/dist/modules/timer/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timer/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - ESM
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */

package/dist/modules/timer/timer.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - CJS
- * @version v4.2.2
+ * @version v4.3.0-beta.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -82,6 +82,8 @@ class Timer extends clock.Clock {
 
     super(0);
 
+    ++timerId;
+
     const {
       id,
       delay,
@@ -103,31 +105,42 @@ class Timer extends clock.Clock {
 
     if (globals.scope.current) globals.scope.current.register(this);
 
-    const timerInitTime = parent ? 0 : engine.engine._elapsedTime;
+    const timerInitTime = parent ? 0 : engine.engine._lastTickTime;
     const timerDefaults = parent ? parent.defaults : globals.globals.defaults;
     const timerDelay = /** @type {Number} */(helpers.isFnc(delay) || helpers.isUnd(delay) ? timerDefaults.delay : +delay);
     const timerDuration = helpers.isFnc(duration) || helpers.isUnd(duration) ? Infinity : +duration;
     const timerLoop = values.setValue(loop, timerDefaults.loop);
     const timerLoopDelay = values.setValue(loopDelay, timerDefaults.loopDelay);
-    const timerIterationCount = timerLoop === true ||
-                                timerLoop === Infinity ||
-                                /** @type {Number} */(timerLoop) < 0 ? Infinity :
-                                /** @type {Number} */(timerLoop) + 1;
+    let timerIterationCount = timerLoop === true ||
+                              timerLoop === Infinity ||
+                              /** @type {Number} */(timerLoop) < 0 ? Infinity :
+                              /** @type {Number} */(timerLoop) + 1;
+
+    if (globals.devTools) {
+      const isInfinite = timerIterationCount === Infinity;
+      const registered = globals.devTools.register(this, parameters, isInfinite);
+      if (registered && isInfinite) {
+        const minIterations = alternate ? 2 : 1;
+        const iterations = parent ? globals.devTools.maxNestedInfiniteLoops : globals.devTools.maxInfiniteLoops;
+        timerIterationCount = Math.max(iterations, minIterations);
+      }
+    }
 
     let offsetPosition = 0;
 
     if (parent) {
       offsetPosition = parentPosition;
     } else {
-      // Make sure to tick the engine once if not currently running to get up to date engine._elapsedTime
+      // Make sure to tick the engine once if not currently running to get up to date engine._lastTickTime
       // to avoid big gaps with the following offsetPosition calculation
       if (!engine.engine.reqId) engine.engine.requestTick(helpers.now());
       // Make sure to scale the offset position with globals.timeScale to properly handle seconds unit
-      offsetPosition = (engine.engine._elapsedTime - engine.engine._startTime) * globals.globals.timeScale;
+      offsetPosition = (engine.engine._lastTickTime - engine.engine._startTime) * globals.globals.timeScale;
     }
 
     // Timer's parameters
-    this.id = !helpers.isUnd(id) ? id : ++timerId;
+    /** @type {String|Number} */
+    this.id = !helpers.isUnd(id) ? id : timerId;
     /** @type {Timeline} */
     this.parent = parent;
     // Total duration of the timer
@@ -187,7 +200,7 @@ class Timer extends clock.Clock {
 
     // Clock's parameters
     /** @type {Number} */
-    this._elapsedTime = timerInitTime;
+    this._lastTickTime = timerInitTime;
     /** @type {Number} */
     this._startTime = timerInitTime;
     /** @type {Number} */
@@ -218,7 +231,7 @@ class Timer extends clock.Clock {
   }
 
   get iterationCurrentTime() {
-    return helpers.round(this._iterationTime, globals.globals.precision);
+    return helpers.clamp(helpers.round(this._iterationTime, globals.globals.precision), 0, this.iterationDuration);
   }
 
   set iterationCurrentTime(time) {
@@ -316,9 +329,9 @@ class Timer extends clock.Clock {
   /** @return {this} */
   resetTime() {
     const timeScale = 1 / (this._speed * engine.engine._speed);
-    // TODO: See if we can safely use engine._elapsedTime here
+    // TODO: See if we can safely use engine._lastTickTime here
     // if (!engine.reqId) engine.requestTick(now())
-    // this._startTime = engine._elapsedTime - (this._currentTime + this._delay) * timeScale;
+    // this._startTime = engine._lastTickTime - (this._currentTime + this._delay) * timeScale;
     this._startTime = helpers.now() - (this._currentTime + this._delay) * timeScale;
     return this;
   }

package/dist/modules/timer/timer.d.ts

@@ -8,6 +8,7 @@ export class Timer extends Clock {
      * @param {Number} [parentPosition]
      */
     constructor(parameters?: TimerParams, parent?: Timeline, parentPosition?: number);
+    /** @type {String|Number} */
     id: string | number;
     /** @type {Timeline} */
     parent: Timeline;