@tsparticles/engine 3.6.0-beta.1 → 3.7.0

package/browser/Options/Classes/Particles/Move/MoveGravity.js

@@ -1,3 +1,4 @@
+import { isNull } from "../../../../Utils/TypeUtils.js";
 import { setRangeValue } from "../../../../Utils/NumberUtils.js";
 export class MoveGravity {
     constructor() {
@@ -7,7 +8,7 @@ export class MoveGravity {
         this.maxSpeed = 50;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.acceleration !== undefined) {

package/browser/Options/Classes/Particles/Move/MoveTrail.js

@@ -1,4 +1,5 @@
 import { MoveTrailFill } from "./MoveTrailFill.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class MoveTrail {
     constructor() {
         this.enable = false;
@@ -6,7 +7,7 @@ export class MoveTrail {
         this.fill = new MoveTrailFill();
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.enable !== undefined) {

package/browser/Options/Classes/Particles/Move/MoveTrailFill.js

@@ -1,7 +1,8 @@
 import { OptionsColor } from "../../OptionsColor.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class MoveTrailFill {
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.color !== undefined) {

package/browser/Options/Classes/Particles/Move/OutModes.js

@@ -1,10 +1,11 @@
 import { OutMode } from "../../../../Enums/Modes/OutMode.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class OutModes {
     constructor() {
         this.default = OutMode.out;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.default !== undefined) {

package/browser/Options/Classes/Particles/Move/Path/MovePath.js

@@ -1,5 +1,6 @@
 import { ValueWithRandom } from "../../../ValueWithRandom.js";
 import { deepExtend } from "../../../../../Utils/Utils.js";
+import { isNull } from "../../../../../Utils/TypeUtils.js";
 export class MovePath {
     constructor() {
         this.clamp = true;
@@ -8,7 +9,7 @@ export class MovePath {
         this.options = {};
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.clamp !== undefined) {

package/browser/Options/Classes/Particles/Move/Spin.js

@@ -1,4 +1,5 @@
 import { deepExtend } from "../../../../Utils/Utils.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 import { setRangeValue } from "../../../../Utils/NumberUtils.js";
 export class Spin {
     constructor() {
@@ -6,7 +7,7 @@ export class Spin {
         this.enable = false;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.acceleration !== undefined) {

package/browser/Options/Classes/Particles/Number/ParticlesDensity.js

@@ -1,3 +1,4 @@
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class ParticlesDensity {
     constructor() {
         this.enable = false;
@@ -5,7 +6,7 @@ export class ParticlesDensity {
         this.height = 1080;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.enable !== undefined) {

package/browser/Options/Classes/Particles/Number/ParticlesNumber.js

@@ -1,5 +1,6 @@
 import { ParticlesDensity } from "./ParticlesDensity.js";
 import { ParticlesNumberLimit } from "./ParticlesNumberLimit.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class ParticlesNumber {
     constructor() {
         this.density = new ParticlesDensity();
@@ -7,7 +8,7 @@ export class ParticlesNumber {
         this.value = 0;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         this.density.load(data.density);

package/browser/Options/Classes/Particles/Number/ParticlesNumberLimit.js

@@ -1,11 +1,12 @@
 import { LimitMode } from "../../../../Enums/Modes/LimitMode.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class ParticlesNumberLimit {
     constructor() {
         this.mode = LimitMode.delete;
         this.value = 0;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.mode !== undefined) {

package/browser/Options/Classes/Particles/Opacity/Opacity.js

@@ -1,5 +1,6 @@
 import { OpacityAnimation } from "./OpacityAnimation.js";
 import { RangedAnimationValueWithRandom } from "../../ValueWithRandom.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class Opacity extends RangedAnimationValueWithRandom {
     constructor() {
         super();
@@ -7,7 +8,7 @@ export class Opacity extends RangedAnimationValueWithRandom {
         this.value = 1;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         super.load(data);

package/browser/Options/Classes/Particles/Opacity/OpacityAnimation.js

@@ -1,5 +1,6 @@
 import { DestroyType } from "../../../../Enums/Types/DestroyType.js";
 import { RangedAnimationOptions } from "../../AnimationOptions.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class OpacityAnimation extends RangedAnimationOptions {
     constructor() {
         super();
@@ -8,7 +9,7 @@ export class OpacityAnimation extends RangedAnimationOptions {
     }
     load(data) {
         super.load(data);
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.destroy !== undefined) {

package/browser/Options/Classes/Particles/ParticlesOptions.js

@@ -11,6 +11,7 @@ import { Shape } from "./Shape/Shape.js";
 import { Size } from "./Size/Size.js";
 import { Stroke } from "./Stroke.js";
 import { ZIndex } from "./ZIndex/ZIndex.js";
+import { isNull } from "../../../Utils/TypeUtils.js";
 export class ParticlesOptions {
     constructor(engine, container) {
         this._engine = engine;
@@ -32,7 +33,7 @@ export class ParticlesOptions {
         this.zIndex = new ZIndex();
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.groups !== undefined) {

package/browser/Options/Classes/Particles/Shadow.js

@@ -1,4 +1,5 @@
 import { OptionsColor } from "../OptionsColor.js";
+import { isNull } from "../../../Utils/TypeUtils.js";
 export class Shadow {
     constructor() {
         this.blur = 0;
@@ -11,7 +12,7 @@ export class Shadow {
         this.color.value = "#000";
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.blur !== undefined) {

package/browser/Options/Classes/Particles/Shape/Shape.js

@@ -1,4 +1,5 @@
 import { deepExtend } from "../../../../Utils/Utils.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class Shape {
     constructor() {
         this.close = true;
@@ -7,7 +8,7 @@ export class Shape {
         this.type = "circle";
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         const options = data.options;

package/browser/Options/Classes/Particles/Size/Size.js

@@ -1,5 +1,6 @@
 import { RangedAnimationValueWithRandom } from "../../ValueWithRandom.js";
 import { SizeAnimation } from "./SizeAnimation.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class Size extends RangedAnimationValueWithRandom {
     constructor() {
         super();
@@ -8,7 +9,7 @@ export class Size extends RangedAnimationValueWithRandom {
     }
     load(data) {
         super.load(data);
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         const animation = data.animation;

package/browser/Options/Classes/Particles/Size/SizeAnimation.js

@@ -1,5 +1,6 @@
 import { DestroyType } from "../../../../Enums/Types/DestroyType.js";
 import { RangedAnimationOptions } from "../../AnimationOptions.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class SizeAnimation extends RangedAnimationOptions {
     constructor() {
         super();
@@ -8,7 +9,7 @@ export class SizeAnimation extends RangedAnimationOptions {
     }
     load(data) {
         super.load(data);
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.destroy !== undefined) {

package/browser/Options/Classes/Particles/Stroke.js

@@ -1,11 +1,12 @@
 import { AnimatableColor } from "../AnimatableColor.js";
+import { isNull } from "../../../Utils/TypeUtils.js";
 import { setRangeValue } from "../../../Utils/NumberUtils.js";
 export class Stroke {
     constructor() {
         this.width = 0;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.color !== undefined) {

package/browser/Options/Classes/Particles/ZIndex/ZIndex.js

@@ -1,4 +1,5 @@
 import { ValueWithRandom } from "../../ValueWithRandom.js";
+import { isNull } from "../../../../Utils/TypeUtils.js";
 export class ZIndex extends ValueWithRandom {
     constructor() {
         super();
@@ -8,7 +9,7 @@ export class ZIndex extends ValueWithRandom {
     }
     load(data) {
         super.load(data);
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.opacityRate !== undefined) {

package/browser/Options/Classes/Responsive.js

@@ -1,5 +1,6 @@
 import { ResponsiveMode } from "../../Enums/Modes/ResponsiveMode.js";
 import { deepExtend } from "../../Utils/Utils.js";
+import { isNull } from "../../Utils/TypeUtils.js";
 export class Responsive {
     constructor() {
         this.maxWidth = Infinity;
@@ -7,13 +8,13 @@ export class Responsive {
         this.mode = ResponsiveMode.canvas;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
-        if (data.maxWidth !== undefined) {
+        if (!isNull(data.maxWidth)) {
             this.maxWidth = data.maxWidth;
         }
-        if (data.mode !== undefined) {
+        if (!isNull(data.mode)) {
             if (data.mode === ResponsiveMode.screen) {
                 this.mode = ResponsiveMode.screen;
             }
@@ -21,7 +22,7 @@ export class Responsive {
                 this.mode = ResponsiveMode.canvas;
             }
         }
-        if (data.options !== undefined) {
+        if (!isNull(data.options)) {
             this.options = deepExtend({}, data.options);
         }
     }

package/browser/Options/Classes/Theme/Theme.js

@@ -1,12 +1,13 @@
 import { ThemeDefault } from "./ThemeDefault.js";
 import { deepExtend } from "../../../Utils/Utils.js";
+import { isNull } from "../../../Utils/TypeUtils.js";
 export class Theme {
     constructor() {
         this.name = "";
         this.default = new ThemeDefault();
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.name !== undefined) {

package/browser/Options/Classes/Theme/ThemeDefault.js

@@ -1,4 +1,5 @@
 import { ThemeMode } from "../../../Enums/Modes/ThemeMode.js";
+import { isNull } from "../../../Utils/TypeUtils.js";
 export class ThemeDefault {
     constructor() {
         this.auto = false;
@@ -6,7 +7,7 @@ export class ThemeDefault {
         this.value = false;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         if (data.auto !== undefined) {

package/browser/Options/Classes/ValueWithRandom.js

@@ -1,14 +1,15 @@
 import { AnimationOptions, RangedAnimationOptions } from "./AnimationOptions.js";
+import { isNull } from "../../Utils/TypeUtils.js";
 import { setRangeValue } from "../../Utils/NumberUtils.js";
 export class ValueWithRandom {
     constructor() {
         this.value = 0;
     }
     load(data) {
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
-        if (data.value !== undefined) {
+        if (!isNull(data.value)) {
             this.value = setRangeValue(data.value);
         }
     }
@@ -20,7 +21,7 @@ export class AnimationValueWithRandom extends ValueWithRandom {
     }
     load(data) {
         super.load(data);
-        if (!data) {
+        if (isNull(data)) {
             return;
         }
         const animation = data.animation;

package/browser/Types/EasingFunction.js

@@ -0,0 +1 @@
+export {};

package/browser/Utils/ColorUtils.js

@@ -3,83 +3,63 @@ import { isArray, isString } from "./TypeUtils.js";
 import { millisecondsToSeconds, percentDenominator } from "../Core/Utils/Constants.js";
 import { AnimationStatus } from "../Enums/AnimationStatus.js";
 import { itemFromArray } from "./Utils.js";
-var RgbIndexes;
-(function (RgbIndexes) {
-    RgbIndexes[RgbIndexes["r"] = 1] = "r";
-    RgbIndexes[RgbIndexes["g"] = 2] = "g";
-    RgbIndexes[RgbIndexes["b"] = 3] = "b";
-    RgbIndexes[RgbIndexes["a"] = 4] = "a";
-})(RgbIndexes || (RgbIndexes = {}));
-const randomColorValue = "random", midColorValue = "mid", colorManagers = new Map();
-export function addColorManager(manager) {
-    colorManagers.set(manager.key, manager);
-}
-function stringToRgba(input) {
-    for (const manager of colorManagers.values()) {
+const randomColorValue = "random", midColorValue = "mid";
+function stringToRgba(engine, input) {
+    if (!input) {
+        return;
+    }
+    for (const manager of engine.colorManagers.values()) {
         if (input.startsWith(manager.stringPrefix)) {
             return manager.parseString(input);
         }
     }
-    const shorthandRegex = /^#?([a-f\d])([a-f\d])([a-f\d])([a-f\d])?$/i, hexFixed = input.replace(shorthandRegex, (_, r, g, b, a) => {
-        return r + r + g + g + b + b + (a !== undefined ? a + a : "");
-    }), regex = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})?$/i, result = regex.exec(hexFixed), radix = 16, defaultAlpha = 1, alphaFactor = 0xff;
-    return result
-        ? {
-            a: result[RgbIndexes.a] !== undefined
-                ? parseInt(result[RgbIndexes.a], radix) / alphaFactor
-                : defaultAlpha,
-            b: parseInt(result[RgbIndexes.b], radix),
-            g: parseInt(result[RgbIndexes.g], radix),
-            r: parseInt(result[RgbIndexes.r], radix),
-        }
-        : undefined;
 }
-export function rangeColorToRgb(input, index, useIndex = true) {
+export function rangeColorToRgb(engine, input, index, useIndex = true) {
     if (!input) {
         return;
     }
     const color = isString(input) ? { value: input } : input;
     if (isString(color.value)) {
-        return colorToRgb(color.value, index, useIndex);
+        return colorToRgb(engine, color.value, index, useIndex);
     }
     if (isArray(color.value)) {
-        return rangeColorToRgb({
+        return rangeColorToRgb(engine, {
             value: itemFromArray(color.value, index, useIndex),
         });
     }
-    for (const manager of colorManagers.values()) {
+    for (const manager of engine.colorManagers.values()) {
         const res = manager.handleRangeColor(color);
         if (res) {
             return res;
         }
     }
 }
-export function colorToRgb(input, index, useIndex = true) {
+export function colorToRgb(engine, input, index, useIndex = true) {
     if (!input) {
         return;
     }
     const color = isString(input) ? { value: input } : input;
     if (isString(color.value)) {
-        return color.value === randomColorValue ? getRandomRgbColor() : stringToRgb(color.value);
+        return color.value === randomColorValue ? getRandomRgbColor() : stringToRgb(engine, color.value);
     }
     if (isArray(color.value)) {
-        return colorToRgb({
+        return colorToRgb(engine, {
             value: itemFromArray(color.value, index, useIndex),
         });
     }
-    for (const manager of colorManagers.values()) {
+    for (const manager of engine.colorManagers.values()) {
         const res = manager.handleColor(color);
         if (res) {
             return res;
         }
     }
 }
-export function colorToHsl(color, index, useIndex = true) {
-    const rgb = colorToRgb(color, index, useIndex);
+export function colorToHsl(engine, color, index, useIndex = true) {
+    const rgb = colorToRgb(engine, color, index, useIndex);
     return rgb ? rgbToHsl(rgb) : undefined;
 }
-export function rangeColorToHsl(color, index, useIndex = true) {
-    const rgb = rangeColorToRgb(color, index, useIndex);
+export function rangeColorToHsl(engine, color, index, useIndex = true) {
+    const rgb = rangeColorToRgb(engine, color, index, useIndex);
     return rgb ? rgbToHsl(rgb) : undefined;
 }
 export function rgbToHsl(color) {
@@ -106,11 +86,11 @@ export function rgbToHsl(color) {
     }
     return res;
 }
-export function stringToAlpha(input) {
-    return stringToRgba(input)?.a;
+export function stringToAlpha(engine, input) {
+    return stringToRgba(engine, input)?.a;
 }
-export function stringToRgb(input) {
-    return stringToRgba(input);
+export function stringToRgb(engine, input) {
+    return stringToRgba(engine, input);
 }
 export function hslToRgb(hsl) {
     const hMax = 360, sMax = 100, lMax = 100, sMin = 0, lMin = 0, h = ((hsl.h % hMax) + hMax) % hMax, s = Math.max(sMin, Math.min(sMax, hsl.s)), l = Math.max(lMin, Math.min(lMax, hsl.l)), hNormalized = h / hMax, sNormalized = s / sMax, lNormalized = l / lMax, rgbFactor = 255, triple = 3;
@@ -201,11 +181,11 @@ export function getLinkColor(p1, p2, linkColor) {
         return linkColor;
     }
 }
-export function getLinkRandomColor(optColor, blink, consent) {
+export function getLinkRandomColor(engine, optColor, blink, consent) {
     const color = isString(optColor) ? optColor : optColor.value;
     if (color === randomColorValue) {
         if (consent) {
-            return rangeColorToRgb({
+            return rangeColorToRgb(engine, {
                 value: color,
             });
         }
@@ -218,7 +198,7 @@ export function getLinkRandomColor(optColor, blink, consent) {
         return midColorValue;
     }
     else {
-        return rangeColorToRgb({
+        return rangeColorToRgb(engine, {
             value: color,
         });
     }

package/browser/Utils/NumberUtils.js

@@ -6,16 +6,7 @@ let _random = Math.random;
 const _animationLoop = {
     nextFrame: (cb) => requestAnimationFrame(cb),
     cancel: (idx) => cancelAnimationFrame(idx),
-}, easingFunctions = new Map(), double = 2, doublePI = Math.PI * double;
-export function addEasing(name, easing) {
-    if (easingFunctions.get(name)) {
-        return;
-    }
-    easingFunctions.set(name, easing);
-}
-export function getEasing(name) {
-    return easingFunctions.get(name) ?? ((value) => value);
-}
+}, double = 2, doublePI = Math.PI * double;
 export function setRandom(rnd = Math.random) {
     _random = rnd;
 }

package/browser/Utils/TypeUtils.js

@@ -16,3 +16,6 @@ export function isObject(arg) {
 export function isArray(arg) {
     return Array.isArray(arg);
 }
+export function isNull(arg) {
+    return arg === null || arg === undefined;
+}

package/browser/Utils/Utils.js

@@ -414,3 +414,9 @@ export function updateAnimation(particle, data, changeDirection, destroyType, de
         data.value = clamp(data.value, minValue, maxValue);
     }
 }
+export function assertValidVersion(engine, pluginVersion) {
+    if (engine.version === pluginVersion) {
+        return;
+    }
+    throw new Error(`The tsParticles version is different from the loaded plugins version. Engine version: ${engine.version}. Plugins version: ${pluginVersion}`);
+}

package/browser/exports.js

@@ -78,9 +78,7 @@ export * from "./Options/Classes/Theme/ThemeDefault.js";
 export * from "./Options/Classes/ValueWithRandom.js";
 export * from "./Utils/CanvasUtils.js";
 export * from "./Utils/ColorUtils.js";
-export * from "./Utils/HslColorManager.js";
 export * from "./Utils/NumberUtils.js";
 export * from "./Utils/OptionsUtils.js";
-export * from "./Utils/RgbColorManager.js";
 export * from "./Utils/Utils.js";
 export * from "./Utils/TypeUtils.js";

package/browser/init.js

@@ -1,11 +1,5 @@
 import { Engine } from "./Core/Engine.js";
-import { HslColorManager } from "./Utils/HslColorManager.js";
-import { RgbColorManager } from "./Utils/RgbColorManager.js";
-import { addColorManager } from "./Utils/ColorUtils.js";
 export function init() {
-    const rgbColorManager = new RgbColorManager(), hslColorManager = new HslColorManager();
-    addColorManager(rgbColorManager);
-    addColorManager(hslColorManager);
     const engine = new Engine();
     engine.init();
     return engine;