animejs 4.2.0-beta.0 → 4.2.1

package/dist/modules/easings/eases/index.js

@@ -0,0 +1,8 @@
+/**
+ * Anime.js - easings - ESM
+ * @version v4.2.1
+ * @license MIT
+ * @copyright 2025 - Julian Garnier
+ */
+
+export { eases } from './parser.js';

package/dist/modules/easings/{eases.cjs → eases/parser.cjs}

@@ -1,20 +1,15 @@
 /**
  * Anime.js - easings - CJS
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
 'use strict';
 
-var consts = require('../core/consts.cjs');
-var helpers = require('../core/helpers.cjs');
-var parser = require('./parser.cjs');
-var none = require('./none.cjs');
-var cubicBezier = require('./cubic-bezier.cjs');
-var steps = require('./steps.cjs');
-var linear = require('./linear.cjs');
-var irregular = require('./irregular.cjs');
+var consts = require('../../core/consts.cjs');
+var helpers = require('../../core/helpers.cjs');
+var none = require('../none.cjs');
 
 /**
  * @import {
@@ -24,9 +19,27 @@ var irregular = require('./irregular.cjs');
  *   BackEasing,
  *   ElasticEasing,
  *   PowerEasing,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
+
+/** @type {PowerEasing} */
+const easeInPower = (p = 1.68) => t => helpers.pow(t, +p);
+
+/**
+ * @callback EaseType
+ * @param {EasingFunction} Ease
+ * @return {EasingFunction}
+ */
+
+/** @type {Record<String, EaseType>} */
+const easeTypes = {
+  in: easeIn => t => easeIn(t),
+  out: easeIn => t => 1 - easeIn(1 - t),
+  inOut: easeIn => t => t < .5 ? easeIn(t * 2) / 2 : 1 - easeIn(t * -2 + 2) / 2,
+  outIn: easeIn => t => t < .5 ? (1 - easeIn(1 - t * 2)) / 2 : (easeIn(t * 2 - 1) + 1) / 2,
+};
+
 /**
  * Easing functions adapted and simplified from https://robertpenner.com/easing/
  * (c) 2001 Robert Penner
@@ -37,11 +50,11 @@ const doublePI = helpers.PI * 2;
 
 /** @type {Record<String, EasingFunctionWithParams|EasingFunction>} */
 const easeInFunctions = {
-  [consts.emptyString]: parser.easeInPower,
-  Quad: parser.easeInPower(2),
-  Cubic: parser.easeInPower(3),
-  Quart: parser.easeInPower(4),
-  Quint: parser.easeInPower(5),
+  [consts.emptyString]: easeInPower,
+  Quad: easeInPower(2),
+  Cubic: easeInPower(3),
+  Quart: easeInPower(4),
+  Quint: easeInPower(5),
   /** @type {EasingFunction} */
   Sine: t => 1 - helpers.cos(t * halfPI),
   /** @type {EasingFunction} */
@@ -55,7 +68,7 @@ const easeInFunctions = {
     return 1 / helpers.pow(4, 3 - b) - 7.5625 * helpers.pow((pow2 * 3 - 2) / 22 - t, 2);
   },
   /** @type {BackEasing} */
-  Back: (overshoot = 1.70158) => t => (+overshoot + 1) * t * t * t - +overshoot * t * t,
+  Back: (overshoot = 1.7) => t => (+overshoot + 1) * t * t * t - +overshoot * t * t,
   /** @type {ElasticEasing} */
   Elastic: (amplitude = 1, period = .3) => {
     const a = helpers.clamp(+amplitude, 1, 10);
@@ -68,10 +81,8 @@ const easeInFunctions = {
 
 /**
  * @typedef  {Object} EasesFunctions
- * @property {typeof linear} linear
- * @property {typeof irregular} irregular
- * @property {typeof steps} steps
- * @property {typeof cubicBezier} cubicBezier
+ * @property {typeof none} linear
+ * @property {typeof none} none
  * @property {PowerEasing} in
  * @property {PowerEasing} out
  * @property {PowerEasing} inOut
@@ -119,11 +130,11 @@ const easeInFunctions = {
  */
 
 const eases = (/*#__PURE__ */ (() => {
-  const list = { linear: linear.linear, irregular: irregular.irregular, steps: steps.steps, cubicBezier: cubicBezier.cubicBezier };
-  for (let type in parser.easeTypes) {
+  const list = { linear: none.none, none: none.none };
+  for (let type in easeTypes) {
     for (let name in easeInFunctions) {
       const easeIn = easeInFunctions[name];
-      const easeType = parser.easeTypes[type];
+      const easeType = easeTypes[type];
       list[type + name] = /** @type {EasingFunctionWithParams|EasingFunction} */(
         name === consts.emptyString || name === 'Back' || name === 'Elastic' ?
         (a, b) => easeType(/** @type {EasingFunctionWithParams} */(easeIn)(a, b)) :
@@ -135,15 +146,46 @@ const eases = (/*#__PURE__ */ (() => {
 })());
 
 /** @type {Record<String, EasingFunction>} */
-const JSEasesLookups = { linear: none.none };
+const easesLookups = { linear: none.none, none: none.none };
+
+/**
+ * @param  {String} string
+ * @return {EasingFunction}
+ */
+const parseEaseString = (string) => {
+  if (easesLookups[string]) return easesLookups[string];
+  if (string.indexOf('(') <= -1) {
+    const hasParams = easeTypes[string] || string.includes('Back') || string.includes('Elastic');
+    const parsedFn = /** @type {EasingFunction} */(hasParams ? /** @type {EasingFunctionWithParams} */(eases[string])() : eases[string]);
+    return parsedFn ? easesLookups[string] = parsedFn : none.none;
+  } else {
+    const split = string.slice(0, -1).split('(');
+    const parsedFn = /** @type {EasingFunctionWithParams} */(eases[split[0]]);
+    return parsedFn ? easesLookups[string] = parsedFn(...split[1].split(',')) : none.none;
+  }
+};
+
+const deprecated = ['steps(', 'irregular(', 'linear(', 'cubicBezier('];
 
 /**
  * @param  {EasingParam} ease
  * @return {EasingFunction}
  */
-const parseEase = ease => helpers.isFnc(ease) ? ease :
-  helpers.isStr(ease) ? parser.parseEaseString(/** @type {String} */(ease), eases, JSEasesLookups) :
-  none.none;
+const parseEase = ease => {
+  if (helpers.isStr(ease)) {
+    for (let i = 0, l = deprecated.length; i < l; i++) {
+      if (helpers.stringStartsWith(ease, deprecated[i])) {
+        console.warn(`String syntax for \`ease: "${ease}"\` has been removed from the core and replaced by importing and passing the easing function directly: \`ease: ${ease}\``);
+        return none.none;
+      }
+    }
+  }
+  const easeFunc = helpers.isFnc(ease) ? ease : helpers.isStr(ease) ? parseEaseString(/** @type {String} */(ease)) : none.none;
+  return easeFunc;
+};
 
+exports.easeInPower = easeInPower;
+exports.easeTypes = easeTypes;
 exports.eases = eases;
 exports.parseEase = parseEase;
+exports.parseEaseString = parseEaseString;

package/dist/modules/easings/{eases.d.ts → eases/parser.d.ts}

@@ -1,8 +1,25 @@
+/**
+ * @import {
+ *   EasingFunction,
+ *   EasingFunctionWithParams,
+ *   EasingParam,
+ *   BackEasing,
+ *   ElasticEasing,
+ *   PowerEasing,
+ * } from '../../types/index.js'
+*/
+/** @type {PowerEasing} */
+export const easeInPower: PowerEasing;
+/**
+ * @callback EaseType
+ * @param {EasingFunction} Ease
+ * @return {EasingFunction}
+ */
+/** @type {Record<String, EaseType>} */
+export const easeTypes: Record<string, EaseType>;
 export namespace eases {
-    export let linear: typeof import("./linear.js").linear;
-    export let irregular: typeof import("./irregular.js").irregular;
-    export let steps: typeof import("./steps.js").steps;
-    export let cubicBezier: typeof import("./cubic-bezier.js").cubicBezier;
+    export let linear: typeof import("../none.js").none;
+    export let none: typeof import("../none.js").none;
     let _in: PowerEasing;
     export { _in as in };
     export let out: PowerEasing;
@@ -49,12 +66,12 @@ export namespace eases {
     export let inOutElastic: ElasticEasing;
     export let outInElastic: ElasticEasing;
 }
+export function parseEaseString(string: string): EasingFunction;
 export function parseEase(ease: EasingParam): EasingFunction;
+export type EaseType = (Ease: EasingFunction) => EasingFunction;
 export type EasesFunctions = {
-    linear: typeof linear;
-    irregular: typeof irregular;
-    steps: typeof steps;
-    cubicBezier: typeof cubicBezier;
+    linear: typeof none;
+    none: typeof none;
     in: PowerEasing;
     out: PowerEasing;
     inOut: PowerEasing;
@@ -100,12 +117,9 @@ export type EasesFunctions = {
     inOutElastic: ElasticEasing;
     outInElastic: ElasticEasing;
 };
-import type { PowerEasing } from '../types/index.js';
-import type { EasingFunction } from '../types/index.js';
-import type { BackEasing } from '../types/index.js';
-import type { ElasticEasing } from '../types/index.js';
-import type { EasingParam } from '../types/index.js';
-import { linear as linear_1 } from './linear.js';
-import { irregular as irregular_1 } from './irregular.js';
-import { steps as steps_1 } from './steps.js';
-import { cubicBezier as cubicBezier_1 } from './cubic-bezier.js';
+import type { PowerEasing } from '../../types/index.js';
+import type { EasingFunction } from '../../types/index.js';
+import type { BackEasing } from '../../types/index.js';
+import type { ElasticEasing } from '../../types/index.js';
+import type { EasingParam } from '../../types/index.js';
+import { none as none_1 } from '../none.js';

package/dist/modules/easings/{eases.js → eases/parser.js}

@@ -1,18 +1,13 @@
 /**
  * Anime.js - easings - ESM
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
-import { emptyString, minValue } from '../core/consts.js';
-import { pow, sin, sqrt, cos, isFnc, isStr, clamp, asin, PI } from '../core/helpers.js';
-import { easeTypes, easeInPower, parseEaseString } from './parser.js';
-import { none } from './none.js';
-import { cubicBezier } from './cubic-bezier.js';
-import { steps } from './steps.js';
-import { linear } from './linear.js';
-import { irregular } from './irregular.js';
+import { emptyString, minValue } from '../../core/consts.js';
+import { pow, sin, sqrt, cos, isStr, stringStartsWith, isFnc, clamp, asin, PI } from '../../core/helpers.js';
+import { none } from '../none.js';
 
 /**
  * @import {
@@ -22,9 +17,27 @@ import { irregular } from './irregular.js';
  *   BackEasing,
  *   ElasticEasing,
  *   PowerEasing,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
+
+/** @type {PowerEasing} */
+const easeInPower = (p = 1.68) => t => pow(t, +p);
+
+/**
+ * @callback EaseType
+ * @param {EasingFunction} Ease
+ * @return {EasingFunction}
+ */
+
+/** @type {Record<String, EaseType>} */
+const easeTypes = {
+  in: easeIn => t => easeIn(t),
+  out: easeIn => t => 1 - easeIn(1 - t),
+  inOut: easeIn => t => t < .5 ? easeIn(t * 2) / 2 : 1 - easeIn(t * -2 + 2) / 2,
+  outIn: easeIn => t => t < .5 ? (1 - easeIn(1 - t * 2)) / 2 : (easeIn(t * 2 - 1) + 1) / 2,
+};
+
 /**
  * Easing functions adapted and simplified from https://robertpenner.com/easing/
  * (c) 2001 Robert Penner
@@ -53,7 +66,7 @@ const easeInFunctions = {
     return 1 / pow(4, 3 - b) - 7.5625 * pow((pow2 * 3 - 2) / 22 - t, 2);
   },
   /** @type {BackEasing} */
-  Back: (overshoot = 1.70158) => t => (+overshoot + 1) * t * t * t - +overshoot * t * t,
+  Back: (overshoot = 1.7) => t => (+overshoot + 1) * t * t * t - +overshoot * t * t,
   /** @type {ElasticEasing} */
   Elastic: (amplitude = 1, period = .3) => {
     const a = clamp(+amplitude, 1, 10);
@@ -66,10 +79,8 @@ const easeInFunctions = {
 
 /**
  * @typedef  {Object} EasesFunctions
- * @property {typeof linear} linear
- * @property {typeof irregular} irregular
- * @property {typeof steps} steps
- * @property {typeof cubicBezier} cubicBezier
+ * @property {typeof none} linear
+ * @property {typeof none} none
  * @property {PowerEasing} in
  * @property {PowerEasing} out
  * @property {PowerEasing} inOut
@@ -117,7 +128,7 @@ const easeInFunctions = {
  */
 
 const eases = (/*#__PURE__ */ (() => {
-  const list = { linear, irregular, steps, cubicBezier };
+  const list = { linear: none, none: none };
   for (let type in easeTypes) {
     for (let name in easeInFunctions) {
       const easeIn = easeInFunctions[name];
@@ -133,14 +144,42 @@ const eases = (/*#__PURE__ */ (() => {
 })());
 
 /** @type {Record<String, EasingFunction>} */
-const JSEasesLookups = { linear: none };
+const easesLookups = { linear: none, none: none };
+
+/**
+ * @param  {String} string
+ * @return {EasingFunction}
+ */
+const parseEaseString = (string) => {
+  if (easesLookups[string]) return easesLookups[string];
+  if (string.indexOf('(') <= -1) {
+    const hasParams = easeTypes[string] || string.includes('Back') || string.includes('Elastic');
+    const parsedFn = /** @type {EasingFunction} */(hasParams ? /** @type {EasingFunctionWithParams} */(eases[string])() : eases[string]);
+    return parsedFn ? easesLookups[string] = parsedFn : none;
+  } else {
+    const split = string.slice(0, -1).split('(');
+    const parsedFn = /** @type {EasingFunctionWithParams} */(eases[split[0]]);
+    return parsedFn ? easesLookups[string] = parsedFn(...split[1].split(',')) : none;
+  }
+};
+
+const deprecated = ['steps(', 'irregular(', 'linear(', 'cubicBezier('];
 
 /**
  * @param  {EasingParam} ease
  * @return {EasingFunction}
  */
-const parseEase = ease => isFnc(ease) ? ease :
-  isStr(ease) ? parseEaseString(/** @type {String} */(ease), eases, JSEasesLookups) :
-  none;
+const parseEase = ease => {
+  if (isStr(ease)) {
+    for (let i = 0, l = deprecated.length; i < l; i++) {
+      if (stringStartsWith(ease, deprecated[i])) {
+        console.warn(`String syntax for \`ease: "${ease}"\` has been removed from the core and replaced by importing and passing the easing function directly: \`ease: ${ease}\``);
+        return none;
+      }
+    }
+  }
+  const easeFunc = isFnc(ease) ? ease : isStr(ease) ? parseEaseString(/** @type {String} */(ease)) : none;
+  return easeFunc;
+};
 
-export { eases, parseEase };
+export { easeInPower, easeTypes, eases, parseEase, parseEaseString };

package/dist/modules/easings/index.cjs

@@ -1,24 +1,26 @@
 /**
  * Anime.js - easings - CJS
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
 'use strict';
 
-var none = require('./none.cjs');
-var cubicBezier = require('./cubic-bezier.cjs');
-var steps = require('./steps.cjs');
-var linear = require('./linear.cjs');
-var irregular = require('./irregular.cjs');
-var eases = require('./eases.cjs');
+var index = require('./cubic-bezier/index.cjs');
+var index$1 = require('./steps/index.cjs');
+var index$2 = require('./linear/index.cjs');
+var index$3 = require('./irregular/index.cjs');
+var index$4 = require('./spring/index.cjs');
+var parser = require('./eases/parser.cjs');
 
 
 
-exports.none = none.none;
-exports.cubicBezier = cubicBezier.cubicBezier;
-exports.steps = steps.steps;
-exports.linear = linear.linear;
-exports.irregular = irregular.irregular;
-exports.eases = eases.eases;
+exports.cubicBezier = index.cubicBezier;
+exports.steps = index$1.steps;
+exports.linear = index$2.linear;
+exports.irregular = index$3.irregular;
+exports.Spring = index$4.Spring;
+exports.createSpring = index$4.createSpring;
+exports.spring = index$4.spring;
+exports.eases = parser.eases;

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

@@ -1,6 +1,6 @@
-export { none } from "./none.js";
-export { cubicBezier } from "./cubic-bezier.js";
-export { steps } from "./steps.js";
-export { linear } from "./linear.js";
-export { irregular } from "./irregular.js";
-export { eases } from "./eases.js";
+export * from "./cubic-bezier/index.js";
+export * from "./steps/index.js";
+export * from "./linear/index.js";
+export * from "./irregular/index.js";
+export * from "./spring/index.js";
+export * from "./eases/index.js";

package/dist/modules/easings/index.js

@@ -1,13 +1,13 @@
 /**
  * Anime.js - easings - ESM
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
-export { none } from './none.js';
-export { cubicBezier } from './cubic-bezier.js';
-export { steps } from './steps.js';
-export { linear } from './linear.js';
-export { irregular } from './irregular.js';
-export { eases } from './eases.js';
+export { cubicBezier } from './cubic-bezier/index.js';
+export { steps } from './steps/index.js';
+export { linear } from './linear/index.js';
+export { irregular } from './irregular/index.js';
+export { Spring, createSpring, spring } from './spring/index.js';
+export { eases } from './eases/parser.js';

package/dist/modules/easings/{irregular.cjs → irregular/index.cjs}

@@ -1,19 +1,19 @@
 /**
  * Anime.js - easings - CJS
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
 'use strict';
 
-var helpers = require('../core/helpers.cjs');
-var linear = require('./linear.cjs');
+var helpers = require('../../core/helpers.cjs');
+var index = require('../linear/index.cjs');
 
 /**
  * @import {
  *   EasingFunction,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
 /**
@@ -35,7 +35,7 @@ const irregular = (length = 10, randomness = 1) => {
     values.push(helpers.clamp(randomValue, previousValue, 1));
   }
   values.push(1);
-  return linear.linear(...values);
+  return index.linear(...values);
 };
 
 exports.irregular = irregular;

package/dist/modules/easings/{irregular.d.ts → irregular/index.d.ts}

@@ -1,2 +1,2 @@
 export function irregular(length?: number, randomness?: number): EasingFunction;
-import type { EasingFunction } from '../types/index.js';
+import type { EasingFunction } from '../../types/index.js';

package/dist/modules/easings/{irregular.js → irregular/index.js}

@@ -1,17 +1,17 @@
 /**
  * Anime.js - easings - ESM
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
-import { clamp } from '../core/helpers.js';
-import { linear } from './linear.js';
+import { clamp } from '../../core/helpers.js';
+import { linear } from '../linear/index.js';
 
 /**
  * @import {
  *   EasingFunction,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
 /**

package/dist/modules/easings/{linear.cjs → linear/index.cjs}

@@ -1,19 +1,19 @@
 /**
  * Anime.js - easings - CJS
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
 'use strict';
 
-var helpers = require('../core/helpers.cjs');
-var none = require('./none.cjs');
+var helpers = require('../../core/helpers.cjs');
+var none = require('../none.cjs');
 
 /**
  * @import {
  *   EasingFunction,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
 /**

package/dist/modules/easings/{linear.d.ts → linear/index.d.ts}

@@ -1,2 +1,2 @@
 export function linear(...args: (string | number)[]): EasingFunction;
-import type { EasingFunction } from '../types/index.js';
+import type { EasingFunction } from '../../types/index.js';

package/dist/modules/easings/{linear.js → linear/index.js}

@@ -1,17 +1,17 @@
 /**
  * Anime.js - easings - ESM
- * @version v4.2.0
+ * @version v4.2.1
  * @license MIT
  * @copyright 2025 - Julian Garnier
  */
 
-import { isStr, parseNumber, isUnd } from '../core/helpers.js';
-import { none } from './none.js';
+import { isStr, parseNumber, isUnd } from '../../core/helpers.js';
+import { none } from '../none.js';
 
 /**
  * @import {
  *   EasingFunction,
- * } from '../types/index.js'
+ * } from '../../types/index.js'
 */
 
 /**

package/dist/modules/easings/none.cjs

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

package/dist/modules/easings/none.js

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