animejs 4.2.0 → 4.2.2

package/dist/modules/timer/timer.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - CJS
- * @version v4.2.0
+ * @version v4.2.2
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -57,7 +57,7 @@ const reviveTimer = timer => {
   if (timer._hasChildren) {
     helpers.forEachChildren(timer, reviveTimer);
   } else {
-    helpers.forEachChildren(timer, (/** @type {Tween} tween*/tween) => {
+    helpers.forEachChildren(timer, (/** @type {Tween} tween */tween) => {
       if (tween._composition !== consts.compositionTypes.none) {
         composition.composeTween(tween, composition.getTweenSiblings(tween.target, tween.property));
       }
@@ -114,7 +114,6 @@ class Timer extends clock.Clock {
                                 /** @type {Number} */(timerLoop) < 0 ? Infinity :
                                 /** @type {Number} */(timerLoop) + 1;
 
-
     let offsetPosition = 0;
 
     if (parent) {
@@ -204,7 +203,7 @@ class Timer extends clock.Clock {
   }
 
   set cancelled(cancelled) {
-    cancelled ? this.cancel() : this.reset(1).play();
+    cancelled ? this.cancel() : this.reset(true).play();
   }
 
   get currentTime() {
@@ -269,10 +268,10 @@ class Timer extends clock.Clock {
   }
 
   /**
-   * @param  {Number} internalRender
+   * @param  {Boolean} [softReset]
    * @return {this}
    */
-  reset(internalRender = 0) {
+  reset(softReset = false) {
     // If cancelled, revive the timer before rendering in order to have propertly composed tweens siblings
     reviveTimer(this);
     if (this._reversed && !this._reverse) this.reversed = false;
@@ -281,7 +280,7 @@ class Timer extends clock.Clock {
     // NOTE: This is only required for Timelines and might be better to move to the Timeline class?
     this._iterationTime = this.iterationDuration;
     // Set tickMode to tickModes.FORCE to force rendering
-    render.tick(this, 0, 1, internalRender, consts.tickModes.FORCE);
+    render.tick(this, 0, 1, ~~softReset, consts.tickModes.FORCE);
     // Reset timer properties after revive / render to make sure the props are not updated again
     resetTimerProperties(this);
     // Also reset children properties
@@ -292,16 +291,16 @@ class Timer extends clock.Clock {
   }
 
   /**
-   * @param  {Number} internalRender
+   * @param  {Boolean} internalRender
    * @return {this}
    */
-  init(internalRender = 0) {
+  init(internalRender = false) {
     this.fps = this._fps;
     this.speed = this._speed;
     // Manually calling .init() on timelines should render all children intial state
     // Forces all children to render once then render to 0 when reseted
     if (!internalRender && this._hasChildren) {
-      render.tick(this, this.duration, 1, internalRender, consts.tickModes.FORCE);
+      render.tick(this, this.duration, 1, ~~internalRender, consts.tickModes.FORCE);
     }
     this.reset(internalRender);
     // Make sure to set autoplay to false to child timers so it doesn't attempt to autoplay / link
@@ -355,7 +354,7 @@ class Timer extends clock.Clock {
 
   /** @return {this} */
   restart() {
-    return this.reset(0).resume();
+    return this.reset().resume();
   }
 
   /**
@@ -458,8 +457,12 @@ class Timer extends clock.Clock {
   }
 
   /**
-   * @param  {Callback<this>} [callback]
-   * @return {Promise}
+   * @typedef {this & {then: null}} ResolvedTimer
+   */
+
+  /**
+   * @param  {Callback<ResolvedTimer>} [callback]
+   * @return Promise<this>
    */
   then(callback = consts.noop) {
     const then = this.then;
@@ -467,7 +470,7 @@ class Timer extends clock.Clock {
       // this.then = null prevents infinite recursion if returned by an async function
       // https://github.com/juliangarnierorg/anime-beta/issues/26
       this.then = null;
-      callback(this);
+      callback(/** @type {ResolvedTimer} */(this));
       this.then = then;
       this._resolve = consts.noop;
     };

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

@@ -79,15 +79,15 @@ export class Timer extends Clock {
     set reversed(reverse: boolean);
     get reversed(): boolean;
     /**
-     * @param  {Number} internalRender
+     * @param  {Boolean} [softReset]
      * @return {this}
      */
-    reset(internalRender?: number): this;
+    reset(softReset?: boolean): this;
     /**
-     * @param  {Number} internalRender
+     * @param  {Boolean} internalRender
      * @return {this}
      */
-    init(internalRender?: number): this;
+    init(internalRender?: boolean): this;
     /** @return {this} */
     resetTime(): this;
     /** @return {this} */
@@ -127,10 +127,15 @@ export class Timer extends Clock {
       */
     complete(): this;
     /**
-     * @param  {Callback<this>} [callback]
-     * @return {Promise}
+     * @typedef {this & {then: null}} ResolvedTimer
      */
-    then(callback?: Callback<this>): Promise<any>;
+    /**
+     * @param  {Callback<ResolvedTimer>} [callback]
+     * @return Promise<this>
+     */
+    then(callback?: Callback<this & {
+        then: null;
+    }>): Promise<any>;
 }
 export function createTimer(parameters?: TimerParams): Timer;
 import { Clock } from '../core/clock.js';

package/dist/modules/timer/timer.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - ESM
- * @version v4.2.0
+ * @version v4.2.2
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -55,7 +55,7 @@ const reviveTimer = timer => {
   if (timer._hasChildren) {
     forEachChildren(timer, reviveTimer);
   } else {
-    forEachChildren(timer, (/** @type {Tween} tween*/tween) => {
+    forEachChildren(timer, (/** @type {Tween} tween */tween) => {
       if (tween._composition !== compositionTypes.none) {
         composeTween(tween, getTweenSiblings(tween.target, tween.property));
       }
@@ -112,7 +112,6 @@ class Timer extends Clock {
                                 /** @type {Number} */(timerLoop) < 0 ? Infinity :
                                 /** @type {Number} */(timerLoop) + 1;
 
-
     let offsetPosition = 0;
 
     if (parent) {
@@ -202,7 +201,7 @@ class Timer extends Clock {
   }
 
   set cancelled(cancelled) {
-    cancelled ? this.cancel() : this.reset(1).play();
+    cancelled ? this.cancel() : this.reset(true).play();
   }
 
   get currentTime() {
@@ -267,10 +266,10 @@ class Timer extends Clock {
   }
 
   /**
-   * @param  {Number} internalRender
+   * @param  {Boolean} [softReset]
    * @return {this}
    */
-  reset(internalRender = 0) {
+  reset(softReset = false) {
     // If cancelled, revive the timer before rendering in order to have propertly composed tweens siblings
     reviveTimer(this);
     if (this._reversed && !this._reverse) this.reversed = false;
@@ -279,7 +278,7 @@ class Timer extends Clock {
     // NOTE: This is only required for Timelines and might be better to move to the Timeline class?
     this._iterationTime = this.iterationDuration;
     // Set tickMode to tickModes.FORCE to force rendering
-    tick(this, 0, 1, internalRender, tickModes.FORCE);
+    tick(this, 0, 1, ~~softReset, tickModes.FORCE);
     // Reset timer properties after revive / render to make sure the props are not updated again
     resetTimerProperties(this);
     // Also reset children properties
@@ -290,16 +289,16 @@ class Timer extends Clock {
   }
 
   /**
-   * @param  {Number} internalRender
+   * @param  {Boolean} internalRender
    * @return {this}
    */
-  init(internalRender = 0) {
+  init(internalRender = false) {
     this.fps = this._fps;
     this.speed = this._speed;
     // Manually calling .init() on timelines should render all children intial state
     // Forces all children to render once then render to 0 when reseted
     if (!internalRender && this._hasChildren) {
-      tick(this, this.duration, 1, internalRender, tickModes.FORCE);
+      tick(this, this.duration, 1, ~~internalRender, tickModes.FORCE);
     }
     this.reset(internalRender);
     // Make sure to set autoplay to false to child timers so it doesn't attempt to autoplay / link
@@ -353,7 +352,7 @@ class Timer extends Clock {
 
   /** @return {this} */
   restart() {
-    return this.reset(0).resume();
+    return this.reset().resume();
   }
 
   /**
@@ -456,8 +455,12 @@ class Timer extends Clock {
   }
 
   /**
-   * @param  {Callback<this>} [callback]
-   * @return {Promise}
+   * @typedef {this & {then: null}} ResolvedTimer
+   */
+
+  /**
+   * @param  {Callback<ResolvedTimer>} [callback]
+   * @return Promise<this>
    */
   then(callback = noop) {
     const then = this.then;
@@ -465,7 +468,7 @@ class Timer extends Clock {
       // this.then = null prevents infinite recursion if returned by an async function
       // https://github.com/juliangarnierorg/anime-beta/issues/26
       this.then = null;
-      callback(this);
+      callback(/** @type {ResolvedTimer} */(this));
       this.then = then;
       this._resolve = noop;
     };

package/dist/modules/types/index.d.ts

@@ -254,7 +254,6 @@ export type TimelineParams = TimerOptions & TimelineOptions & TickableCallbacks<
 export type WAAPITweenValue = string | number | Array<string> | Array<number>;
 export type WAAPIFunctionValue = (target: DOMTarget, index: number, length: number) => WAAPITweenValue;
 export type WAAPIKeyframeValue = WAAPITweenValue | WAAPIFunctionValue | Array<string | number | WAAPIFunctionValue>;
-export type WAAPICallback = Callback<WAAPIAnimation>;
 export type WAAPITweenOptions = {
     to?: WAAPIKeyframeValue;
     from?: WAAPIKeyframeValue;
@@ -274,9 +273,9 @@ export type WAAPIAnimationOptions = {
     ease?: WAAPIEasingParam;
     composition?: CompositeOperation;
     persist?: boolean;
-    onComplete?: WAAPICallback;
+    onComplete?: Callback<WAAPIAnimation>;
 };
-export type WAAPIAnimationParams = Record<string, WAAPIKeyframeValue | WAAPIAnimationOptions | boolean | ScrollObserver | WAAPICallback | WAAPIEasingParam | WAAPITweenOptions> & WAAPIAnimationOptions;
+export type WAAPIAnimationParams = Record<string, WAAPIKeyframeValue | WAAPIAnimationOptions | boolean | ScrollObserver | Callback<WAAPIAnimation> | WAAPIEasingParam | WAAPITweenOptions> & WAAPIAnimationOptions;
 export type AnimatablePropertySetter = (to: number | Array<number>, duration?: number, ease?: EasingParam) => AnimatableObject;
 export type AnimatablePropertyGetter = () => number | Array<number>;
 export type AnimatableProperty = AnimatablePropertySetter & AnimatablePropertyGetter;
@@ -340,6 +339,10 @@ export type DraggableCursorParams = {
     onHover?: string;
     onGrab?: string;
 };
+export type DraggableDragThresholdParams = {
+    mouse?: number;
+    touch?: number;
+};
 export type DraggableParams = {
     trigger?: DOMTargetSelector;
     container?: DOMTargetSelector | Array<number> | ((draggable: Draggable) => DOMTargetSelector | Array<number>);
@@ -351,6 +354,7 @@ export type DraggableParams = {
     containerFriction?: number | ((draggable: Draggable) => number);
     releaseContainerFriction?: number | ((draggable: Draggable) => number);
     dragSpeed?: number | ((draggable: Draggable) => number);
+    dragThreshold?: number | DraggableDragThresholdParams | ((draggable: Draggable) => number | DraggableDragThresholdParams);
     scrollSpeed?: number | ((draggable: Draggable) => number);
     scrollThreshold?: number | ((draggable: Draggable) => number);
     minVelocity?: number | ((draggable: Draggable) => number);

package/dist/modules/utils/chainable.cjs

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

package/dist/modules/utils/chainable.js

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

package/dist/modules/utils/index.cjs

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

package/dist/modules/utils/index.js

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

package/dist/modules/utils/number.cjs

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

package/dist/modules/utils/number.js

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

package/dist/modules/utils/random.cjs

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

package/dist/modules/utils/random.js

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

package/dist/modules/utils/stagger.cjs

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

package/dist/modules/utils/stagger.js

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

package/dist/modules/utils/target.cjs

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

package/dist/modules/utils/target.js

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

package/dist/modules/utils/time.cjs

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

package/dist/modules/utils/time.js

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

package/dist/modules/waapi/composition.cjs

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

package/dist/modules/waapi/composition.js

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

package/dist/modules/waapi/index.cjs

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

package/dist/modules/waapi/index.js

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

package/dist/modules/waapi/waapi.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - waapi - CJS
- * @version v4.2.0
+ * @version v4.2.2
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -27,7 +27,6 @@ var composition = require('./composition.cjs');
  *   WAAPIAnimationParams,
  *   WAAPITweenOptions,
  *   WAAPIKeyframeValue,
- *   WAAPICallback,
  *   WAAPITweenValue
  * } from '../types/index.js'
 */
@@ -459,14 +458,18 @@ class WAAPIAnimation {
   }
 
   /**
-   * @param  {WAAPICallback} [callback]
-   * @return {Promise}
+   * @typedef {this & {then: null}} ResolvedWAAPIAnimation
+   */
+
+  /**
+   * @param  {Callback<ResolvedWAAPIAnimation>} [callback]
+   * @return Promise<this>
    */
   then(callback = consts.noop) {
     const then = this.then;
     const onResolve = () => {
       this.then = null;
-      callback(this);
+      callback(/** @type {ResolvedWAAPIAnimation} */(this));
       this.then = then;
       this._resolve = consts.noop;
     };

package/dist/modules/waapi/waapi.d.ts

@@ -65,10 +65,15 @@ export class WAAPIAnimation {
     cancel(): this;
     revert(): this;
     /**
-     * @param  {WAAPICallback} [callback]
-     * @return {Promise}
+     * @typedef {this & {then: null}} ResolvedWAAPIAnimation
      */
-    then(callback?: WAAPICallback): Promise<any>;
+    /**
+     * @param  {Callback<ResolvedWAAPIAnimation>} [callback]
+     * @return Promise<this>
+     */
+    then(callback?: Callback<this & {
+        then: null;
+    }>): Promise<any>;
 }
 export namespace waapi {
     export function animate(targets: DOMTargetsParam, params: WAAPIAnimationParams): WAAPIAnimation;
@@ -77,7 +82,6 @@ export namespace waapi {
 import type { DOMTargetsArray } from '../types/index.js';
 import type { Callback } from '../types/index.js';
 import type { ScrollObserver } from '../events/scroll.js';
-import type { WAAPICallback } from '../types/index.js';
 import type { DOMTargetsParam } from '../types/index.js';
 import type { WAAPIAnimationParams } from '../types/index.js';
 /**
@@ -91,7 +95,6 @@ import type { WAAPIAnimationParams } from '../types/index.js';
  *   WAAPIAnimationParams,
  *   WAAPITweenOptions,
  *   WAAPIKeyframeValue,
- *   WAAPICallback,
  *   WAAPITweenValue
  * } from '../types/index.js'
 */

package/dist/modules/waapi/waapi.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - waapi - ESM
- * @version v4.2.0
+ * @version v4.2.2
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
@@ -25,7 +25,6 @@ import { addWAAPIAnimation } from './composition.js';
  *   WAAPIAnimationParams,
  *   WAAPITweenOptions,
  *   WAAPIKeyframeValue,
- *   WAAPICallback,
  *   WAAPITweenValue
  * } from '../types/index.js'
 */
@@ -457,14 +456,18 @@ class WAAPIAnimation {
   }
 
   /**
-   * @param  {WAAPICallback} [callback]
-   * @return {Promise}
+   * @typedef {this & {then: null}} ResolvedWAAPIAnimation
+   */
+
+  /**
+   * @param  {Callback<ResolvedWAAPIAnimation>} [callback]
+   * @return Promise<this>
    */
   then(callback = noop) {
     const then = this.then;
     const onResolve = () => {
       this.then = null;
-      callback(this);
+      callback(/** @type {ResolvedWAAPIAnimation} */(this));
       this.then = then;
       this._resolve = noop;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "animejs",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "homepage": "https://animejs.com",
   "description": "JavaScript animation engine",
   "author": "Julian Garnier <julian@animejs.com>",
@@ -31,8 +31,7 @@
     "easings",
     "cubic-bezier",
     "spring",
-    "text",
-    "JavaScript",
+    "splitText",
     "CSS",
     "SVG",
     "WAAPI",
@@ -176,7 +175,7 @@
     "@rollup/plugin-terser": "^0.4.4",
     "@types/mocha": "^10.0.10",
     "@types/node": "^24.3.0",
-    "browser-sync": "^2.29.3",
+    "browser-sync": "^3.0.4",
     "chai": "^4.3.10",
     "mocha": "^10.2.0",
     "nodemon": "^3.1.10",