animejs 4.1.4 → 4.2.0

package/dist/modules/animation/additive.cjs

@@ -0,0 +1,82 @@
+/**
+ * Anime.js - animation - CJS
+ * @version v4.2.0
+ * @license MIT
+ * @copyright 2025 - Julian Garnier
+ */
+
+'use strict';
+
+var consts = require('../core/consts.cjs');
+var helpers = require('../core/helpers.cjs');
+var render = require('../core/render.cjs');
+
+const additive = {
+  animation: null,
+  update: consts.noop,
+};
+
+/**
+ * @import {
+ *   Tween,
+ *   TweenAdditiveLookups,
+ * } from '../types/index.js'
+ */
+
+/**
+ * @typedef AdditiveAnimation
+ * @property {Number} duration
+ * @property {Number} _offset
+ * @property {Number} _delay
+ * @property {Tween} _head
+ * @property {Tween} _tail
+ */
+
+/**
+ * @param  {TweenAdditiveLookups} lookups
+ * @return {AdditiveAnimation}
+ */
+const addAdditiveAnimation = lookups => {
+  let animation = additive.animation;
+  if (!animation) {
+    animation = {
+      duration: consts.minValue,
+      computeDeltaTime: consts.noop,
+      _offset: 0,
+      _delay: 0,
+      _head: null,
+      _tail: null,
+    };
+    additive.animation = animation;
+    additive.update = () => {
+      lookups.forEach(propertyAnimation => {
+        for (let propertyName in propertyAnimation) {
+          const tweens = propertyAnimation[propertyName];
+          const lookupTween = tweens._head;
+          if (lookupTween) {
+            const valueType = lookupTween._valueType;
+            const additiveValues = valueType === consts.valueTypes.COMPLEX || valueType === consts.valueTypes.COLOR ? helpers.cloneArray(lookupTween._fromNumbers) : null;
+            let additiveValue = lookupTween._fromNumber;
+            let tween = tweens._tail;
+            while (tween && tween !== lookupTween) {
+              if (additiveValues) {
+                for (let i = 0, l = tween._numbers.length; i < l; i++) additiveValues[i] += tween._numbers[i];
+              } else {
+                additiveValue += tween._number;
+              }
+              tween = tween._prevAdd;
+            }
+            lookupTween._toNumber = additiveValue;
+            lookupTween._toNumbers = additiveValues;
+          }
+        }
+      });
+      // TODO: Avoid polymorphism here, idealy the additive animation should be a regular animation with a higher priority in the render loop
+      render.render(animation, 1, 1, 0, consts.tickModes.FORCE);
+    };
+  }
+  return animation;
+};
+
+exports.addAdditiveAnimation = addAdditiveAnimation;
+exports.additive = additive;

package/dist/modules/animation/additive.d.ts

@@ -0,0 +1,15 @@
+export namespace additive {
+    export let animation: any;
+    export { noop as update };
+}
+export function addAdditiveAnimation(lookups: TweenAdditiveLookups): AdditiveAnimation;
+export type AdditiveAnimation = {
+    duration: number;
+    _offset: number;
+    _delay: number;
+    _head: Tween;
+    _tail: Tween;
+};
+import { noop } from '../core/consts.js';
+import type { TweenAdditiveLookups } from '../types/index.js';
+import type { Tween } from '../types/index.js';

package/dist/modules/animation/additive.js

@@ -0,0 +1,79 @@
+/**
+ * Anime.js - animation - ESM
+ * @version v4.2.0
+ * @license MIT
+ * @copyright 2025 - Julian Garnier
+ */
+
+import { noop, minValue, valueTypes, tickModes } from '../core/consts.js';
+import { cloneArray } from '../core/helpers.js';
+import { render } from '../core/render.js';
+
+const additive = {
+  animation: null,
+  update: noop,
+};
+
+/**
+ * @import {
+ *   Tween,
+ *   TweenAdditiveLookups,
+ * } from '../types/index.js'
+ */
+
+/**
+ * @typedef AdditiveAnimation
+ * @property {Number} duration
+ * @property {Number} _offset
+ * @property {Number} _delay
+ * @property {Tween} _head
+ * @property {Tween} _tail
+ */
+
+/**
+ * @param  {TweenAdditiveLookups} lookups
+ * @return {AdditiveAnimation}
+ */
+const addAdditiveAnimation = lookups => {
+  let animation = additive.animation;
+  if (!animation) {
+    animation = {
+      duration: minValue,
+      computeDeltaTime: noop,
+      _offset: 0,
+      _delay: 0,
+      _head: null,
+      _tail: null,
+    };
+    additive.animation = animation;
+    additive.update = () => {
+      lookups.forEach(propertyAnimation => {
+        for (let propertyName in propertyAnimation) {
+          const tweens = propertyAnimation[propertyName];
+          const lookupTween = tweens._head;
+          if (lookupTween) {
+            const valueType = lookupTween._valueType;
+            const additiveValues = valueType === valueTypes.COMPLEX || valueType === valueTypes.COLOR ? cloneArray(lookupTween._fromNumbers) : null;
+            let additiveValue = lookupTween._fromNumber;
+            let tween = tweens._tail;
+            while (tween && tween !== lookupTween) {
+              if (additiveValues) {
+                for (let i = 0, l = tween._numbers.length; i < l; i++) additiveValues[i] += tween._numbers[i];
+              } else {
+                additiveValue += tween._number;
+              }
+              tween = tween._prevAdd;
+            }
+            lookupTween._toNumber = additiveValue;
+            lookupTween._toNumbers = additiveValues;
+          }
+        }
+      });
+      // TODO: Avoid polymorphism here, idealy the additive animation should be a regular animation with a higher priority in the render loop
+      render(animation, 1, 1, 0, tickModes.FORCE);
+    };
+  }
+  return animation;
+};
+
+export { addAdditiveAnimation, additive };