animejs 4.4.1 → 4.5.0

package/dist/modules/scope/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/scope/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/scope/scope.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/scope/scope.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - scope - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/drawable.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/drawable.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/helpers.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/helpers.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/morphto.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/morphto.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/motionpath.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/svg/motionpath.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - svg - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/text/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/text/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/text/scramble.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -20,6 +20,16 @@ var consts = require('../core/consts.cjs');
  * } from '../types/index.js'
 */
 
+/**
+ * @typedef {Object} ScrambleTextTween
+ * @property {Number} from
+ * @property {Number} to
+ * @property {Number} duration
+ * @property {Number} delay
+ * @property {String} ease
+ * @property {(v: Number) => String} modifier
+ */
+
 /**
  * '-' is the range operator; place it at the start or end of the string to use it as a literal (e.g. '-abc' or 'abc-')
  * @param {String} str
@@ -57,7 +67,7 @@ const originalTexts = new WeakMap();
  * progressively revealing the original text.
  *
  * @param {ScrambleTextParams} [params]
- * @return {FunctionValue}
+ * @return {FunctionValue<ScrambleTextTween>}
  */
 const scrambleText = (params = {}) => {
   if (!params) params = {};

package/dist/modules/text/scramble.d.ts

@@ -1,3 +1,11 @@
-export function scrambleText(params?: ScrambleTextParams): FunctionValue;
+export function scrambleText(params?: ScrambleTextParams): FunctionValue<ScrambleTextTween>;
+export type ScrambleTextTween = {
+    from: number;
+    to: number;
+    duration: number;
+    delay: number;
+    ease: string;
+    modifier: (v: number) => string;
+};
 import type { ScrambleTextParams } from '../types/index.js';
 import type { FunctionValue } from '../types/index.js';

package/dist/modules/text/scramble.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -18,6 +18,16 @@ import { noop } from '../core/consts.js';
  * } from '../types/index.js'
 */
 
+/**
+ * @typedef {Object} ScrambleTextTween
+ * @property {Number} from
+ * @property {Number} to
+ * @property {Number} duration
+ * @property {Number} delay
+ * @property {String} ease
+ * @property {(v: Number) => String} modifier
+ */
+
 /**
  * '-' is the range operator; place it at the start or end of the string to use it as a literal (e.g. '-abc' or 'abc-')
  * @param {String} str
@@ -55,7 +65,7 @@ const originalTexts = new WeakMap();
  * progressively revealing the original text.
  *
  * @param {ScrambleTextParams} [params]
- * @return {FunctionValue}
+ * @return {FunctionValue<ScrambleTextTween>}
  */
 const scrambleText = (params = {}) => {
   if (!params) params = {};

package/dist/modules/text/split.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -118,6 +118,7 @@ const filterLineElements = ($el, lineIndex, bin) => {
  */
 const generateTemplate = (type, params = {}) => {
   let template = ``;
+  if (!params) params = {};
   const classString = helpers.isStr(params.class) ? ` class="${params.class}"` : '';
   const cloneType = values.setValue(params.clone, false);
   const wrapType = values.setValue(params.wrap, false);

package/dist/modules/text/split.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - text - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -116,6 +116,7 @@ const filterLineElements = ($el, lineIndex, bin) => {
  */
 const generateTemplate = (type, params = {}) => {
   let template = ``;
+  if (!params) params = {};
   const classString = isStr(params.class) ? ` class="${params.class}"` : '';
   const cloneType = setValue(params.clone, false);
   const wrapType = setValue(params.wrap, false);

package/dist/modules/timeline/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timeline/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timeline/position.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timeline/position.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timeline/timeline.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -34,6 +34,7 @@ var position = require('./position.cjs');
  *   TimelinePosition,
  *   StaggerFunction,
  *   TargetsArray,
+ *   TweakRegister,
  * } from '../types/index.js'
 */
 
@@ -43,8 +44,6 @@ var position = require('./position.cjs');
  * } from '../waapi/waapi.js'
 */
 
-/** @import {TweakRegister} from 'tweaks' */
-
 /**
  * @param {Timeline} tl
  * @return {Number}
@@ -237,13 +236,21 @@ class Timeline extends timer.Timer {
     if (!helpers.isUnd(synced) && !helpers.isUnd(/** @type {WAAPIAnimation} */(synced).persist)) {
       /** @type {WAAPIAnimation} */(synced).persist = true;
     }
-    return this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
+    const editor = globals.globals.editor;
+    const childHook = editor && editor.addTimelineChild;
+    if (editor && editor.addTimelineSync) {
+      position = editor.addTimelineSync(synced, position, this.id);
+      editor.addTimelineChild = null; // Suppress the per-child hook for the internal .add, sync already registered.
+    }
+    const result = this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
+    if (editor) editor.addTimelineChild = childHook;
+    return result;
   }
 
   /**
    * @param  {TargetsParam} targets
    * @param  {AnimationParams} parameters
-   * @param  {TimelinePosition} [position]
+   * @param  {TimelinePosition|StaggerFunction<Number|String>|TweakRegister} [position]
    * @return {this}
    */
   set(targets, parameters, position) {
@@ -260,6 +267,7 @@ class Timeline extends timer.Timer {
    */
   call(callback, position) {
     if (helpers.isUnd(callback) || callback && !helpers.isFnc(callback)) return this;
+    if (globals.globals.editor && globals.globals.editor.addTimelineCall) position = globals.globals.editor.addTimelineCall(callback, position, this.id);
     return this.add({ duration: 0, delay: 0, onComplete: () => callback(this) }, position);
   }
 
@@ -271,6 +279,7 @@ class Timeline extends timer.Timer {
    */
   label(labelName, position$1) {
     if (helpers.isUnd(labelName) || labelName && !helpers.isStr(labelName)) return this;
+    if (globals.globals.editor && globals.globals.editor.addTimelineLabel) position$1 = globals.globals.editor.addTimelineLabel(labelName, position$1, this.id);
     this.labels[labelName] = position.parseTimelinePosition(this, position$1);
     return this;
   }

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

@@ -109,10 +109,10 @@ export class Timeline extends Timer {
     /**
      * @param  {TargetsParam} targets
      * @param  {AnimationParams} parameters
-     * @param  {TimelinePosition} [position]
+     * @param  {TimelinePosition|StaggerFunction<Number|String>|TweakRegister} [position]
      * @return {this}
      */
-    set(targets: TargetsParam, parameters: AnimationParams, position?: TimelinePosition): this;
+    set(targets: TargetsParam, parameters: AnimationParams, position?: TimelinePosition | StaggerFunction<number | string> | TweakRegister): this;
     /**
      * @param {Callback<Timer>} callback
      * @param {TimelinePosition} [position]
@@ -164,7 +164,7 @@ import type { TargetsParam } from '../types/index.js';
 import type { AnimationParams } from '../types/index.js';
 import type { TimelinePosition } from '../types/index.js';
 import type { StaggerFunction } from '../types/index.js';
-import type { TweakRegister } from 'tweaks';
+import type { TweakRegister } from '../types/index.js';
 import type { TimerParams } from '../types/index.js';
 import type { Tickable } from '../types/index.js';
 import type { WAAPIAnimation } from '../waapi/waapi.js';

package/dist/modules/timeline/timeline.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timeline - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */
@@ -32,6 +32,7 @@ import { parseTimelinePosition } from './position.js';
  *   TimelinePosition,
  *   StaggerFunction,
  *   TargetsArray,
+ *   TweakRegister,
  * } from '../types/index.js'
 */
 
@@ -41,8 +42,6 @@ import { parseTimelinePosition } from './position.js';
  * } from '../waapi/waapi.js'
 */
 
-/** @import {TweakRegister} from 'tweaks' */
-
 /**
  * @param {Timeline} tl
  * @return {Number}
@@ -235,13 +234,21 @@ class Timeline extends Timer {
     if (!isUnd(synced) && !isUnd(/** @type {WAAPIAnimation} */(synced).persist)) {
       /** @type {WAAPIAnimation} */(synced).persist = true;
     }
-    return this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
+    const editor = globals.editor;
+    const childHook = editor && editor.addTimelineChild;
+    if (editor && editor.addTimelineSync) {
+      position = editor.addTimelineSync(synced, position, this.id);
+      editor.addTimelineChild = null; // Suppress the per-child hook for the internal .add, sync already registered.
+    }
+    const result = this.add(synced, { currentTime: [0, duration], duration, delay: 0, ease: 'linear', playbackEase: 'linear' }, position);
+    if (editor) editor.addTimelineChild = childHook;
+    return result;
   }
 
   /**
    * @param  {TargetsParam} targets
    * @param  {AnimationParams} parameters
-   * @param  {TimelinePosition} [position]
+   * @param  {TimelinePosition|StaggerFunction<Number|String>|TweakRegister} [position]
    * @return {this}
    */
   set(targets, parameters, position) {
@@ -258,6 +265,7 @@ class Timeline extends Timer {
    */
   call(callback, position) {
     if (isUnd(callback) || callback && !isFnc(callback)) return this;
+    if (globals.editor && globals.editor.addTimelineCall) position = globals.editor.addTimelineCall(callback, position, this.id);
     return this.add({ duration: 0, delay: 0, onComplete: () => callback(this) }, position);
   }
 
@@ -269,6 +277,7 @@ class Timeline extends Timer {
    */
   label(labelName, position) {
     if (isUnd(labelName) || labelName && !isStr(labelName)) return this;
+    if (globals.editor && globals.editor.addTimelineLabel) position = globals.editor.addTimelineLabel(labelName, position, this.id);
     this.labels[labelName] = parseTimelinePosition(this, position);
     return this;
   }

package/dist/modules/timer/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timer/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timer/timer.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/timer/timer.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - timer - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

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

@@ -27,17 +27,36 @@ export type Renderable = JSAnimation | Timeline;
 export type Tickable = Timer | Renderable;
 export type CallbackArgument = Timer & JSAnimation & Timeline;
 export type Revertible = Animatable | Tickable | WAAPIAnimation | Draggable | ScrollObserver | TextSplitter | Scope | AutoLayout;
+export type TweakRegister = {
+    type: string;
+    defaultValue: any;
+};
 export type StaggerFunction<T> = (target?: Target, index?: number, targets?: TargetsArray, prevTween?: Tween | null, tl?: Timeline) => T;
 export type StaggerParams = {
     start?: number | string;
     from?: number | "first" | "center" | "last" | "random" | Array<number>;
     reversed?: boolean;
     grid?: Array<number> | boolean;
-    axis?: ("x" | "y");
-    use?: string | ((target: Target, i: number, length: number) => number);
+    axis?: ("x" | "y" | "z");
+    use?: string | {
+        method(target: Target, i: number, length: number): number;
+    }["method"];
     total?: number;
     ease?: EasingParam;
     modifier?: TweenModifier;
+    /**
+     * Additive uniform noise on the
+     * computed stagger value. Number form gives flat `+/-jitter`; tuple form
+     * ramps the magnitude `start -> end` across the from/axis/grid ordering
+     * and respects `ease`.
+     */
+    jitter?: number | [number, number];
+    /**
+     * Seed for jitter draws and `from: 'random'`
+     * shuffling. `false` (default) uses Math.random. `true` seeds with `0`. A
+     * number is used directly as the seed.
+     */
+    seed?: boolean | number;
 };
 export type DOMTarget = HTMLElement | SVGElement;
 export type JSTarget = Record<string, any>;
@@ -89,7 +108,9 @@ export type SpringParams = {
      */
     onComplete?: Callback<JSAnimation>;
 };
-export type Callback<T> = (self: T, e?: PointerEvent) => any;
+export type Callback<T> = {
+    method(self: T): any;
+}["method"];
 export type TickableCallbacks<T extends unknown> = {
     onBegin?: Callback<T>;
     onBeforeUpdate?: Callback<T>;
@@ -115,7 +136,8 @@ export type TimerOptions = {
     priority?: number;
 };
 export type TimerParams = TimerOptions & TickableCallbacks<Timer>;
-export type FunctionValue = (target?: Target, index?: number, targets?: TargetsArray, prevTween?: Tween | null) => number | string | TweenObjectValue | EasingParam | Array<number | string | TweenObjectValue>;
+export type FunctionValueReturn = number | string | TweenKeyValue | EasingParam | Array<number | string | TweenKeyValue>;
+export type FunctionValue<T = FunctionValueReturn> = (target?: Target, index?: number, targets?: TargetsArray, prevTween?: Tween | null) => T;
 export type TweenModifier = (value: number) => number | string;
 export type ColorArray = [number, number, number, number];
 export type Tween = {
@@ -123,7 +145,7 @@ export type Tween = {
     parent: JSAnimation;
     property: string;
     target: Target;
-    _value: string | number;
+    _value: string | number | any;
     _toFunc: Function | null;
     _fromFunc: Function | null;
     _ease: EasingFunction;
@@ -142,7 +164,11 @@ export type Tween = {
     _startTime: number;
     _changeDuration: number;
     _absoluteStartTime: number;
+    _absoluteUpdateStartTime: number;
+    _absoluteEndTime: number;
+    _hasFromValue: number;
     _tweenType: tweenTypes;
+    _setter: ((target: any, value: number, tween: Tween) => void) | null;
     _valueType: valueTypes;
     _composition: number;
     _isOverlapped: number;
@@ -174,11 +200,11 @@ export type TweenDecomposedValue = {
      */
     o: string;
     /**
-     * - Array of Numbers (in case of complex value type)
+     * - Array of Numbers (complex / color value type)
      */
     d: Array<number>;
     /**
-     * - Strings (in case of complex value type)
+     * - Strings (complex value type)
      */
     s: Array<string>;
 };
@@ -189,7 +215,7 @@ export type TweenPropertySiblings = {
 export type TweenLookups = Record<string, TweenPropertySiblings>;
 export type TweenReplaceLookups = WeakMap<Target, TweenLookups>;
 export type TweenAdditiveLookups = Map<Target, TweenLookups>;
-export type TweenParamValue = number | string | FunctionValue | EasingParam;
+export type TweenParamValue = number | string | FunctionValue | EasingParam | TweakRegister;
 export type TweenPropValue = TweenParamValue | [TweenParamValue, TweenParamValue];
 export type TweenComposition = (string & {}) | "none" | "replace" | "blend" | compositionTypes;
 export type TweenParamsOptions = {
@@ -290,7 +316,7 @@ export type AnimatablePropertyParamsOptions = {
     modifier?: TweenModifier;
     composition?: TweenComposition;
 };
-export type AnimatableParams = Record<string, TweenParamValue | EasingParam | TweenModifier | TweenComposition | AnimatablePropertyParamsOptions> & AnimatablePropertyParamsOptions;
+export type AnimatableParams = Record<string, TweenParamValue | EasingParam | TweenModifier | TweenComposition | AnimatablePropertyParamsOptions | Callback<JSAnimation>> & AnimatablePropertyParamsOptions & TickableCallbacks<JSAnimation> & RenderableCallbacks<JSAnimation>;
 export type ReactRef = {
     current?: HTMLElement | SVGElement | null;
 };
@@ -305,7 +331,7 @@ export type ScopeParams = {
 export type ScopedCallback<T> = (scope: Scope) => T;
 export type ScopeCleanupCallback = (scope?: Scope) => any;
 export type ScopeConstructorCallback = (scope?: Scope) => ScopeCleanupCallback | void;
-export type ScopeMethod = (...args: any[]) => ScopeCleanupCallback | void;
+export type ScopeMethod = (...args: any[]) => any;
 export type ScrollThresholdValue = string | number;
 export type ScrollThresholdParam = {
     target?: ScrollThresholdValue;
@@ -475,6 +501,5 @@ import type { TextSplitter } from '../text/split.js';
 import type { Scope } from '../scope/scope.js';
 import type { AutoLayout } from '../layout/layout.js';
 import type { Spring } from '../easings/spring/index.js';
-import type { TweakRegister } from 'tweaks';
 import type { tweenTypes } from '../core/consts.js';
 import type { valueTypes } from '../core/consts.js';

package/dist/modules/utils/chainable.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - utils - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/utils/chainable.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - utils - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/utils/index.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - utils - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/utils/index.js

@@ -1,6 +1,6 @@
 /**
  * Anime.js - utils - ESM
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */

package/dist/modules/utils/number.cjs

@@ -1,6 +1,6 @@
 /**
  * Anime.js - utils - CJS
- * @version v4.4.1
+ * @version v4.5.0
  * @license MIT
  * @copyright 2026 - Julian Garnier
  */