tsparticles 1.41.4 → 1.42.0

package/umd/Options/Classes/Particles/Twinkle/TwinkleValues.d.ts

@@ -1,12 +1,12 @@
+import type { RangeValue, RecursivePartial } from "../../../../Types";
 import type { IOptionLoader } from "../../../Interfaces/IOptionLoader";
 import type { ITwinkleValues } from "../../../Interfaces/Particles/Twinkle/ITwinkleValues";
 import { OptionsColor } from "../../OptionsColor";
-import type { RecursivePartial } from "../../../../Types";
 export declare class TwinkleValues implements ITwinkleValues, IOptionLoader<ITwinkleValues> {
     color?: OptionsColor;
     enable: boolean;
     frequency: number;
-    opacity: number;
+    opacity: RangeValue;
     constructor();
     load(data?: RecursivePartial<ITwinkleValues>): void;
 }

package/umd/Options/Classes/Particles/Twinkle/TwinkleValues.js

@@ -4,13 +4,14 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../OptionsColor"], factory);
+        define(["require", "exports", "../../OptionsColor", "../../../../Utils"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.TwinkleValues = void 0;
     const OptionsColor_1 = require("../../OptionsColor");
+    const Utils_1 = require("../../../../Utils");
     class TwinkleValues {
         constructor() {
             this.enable = false;
@@ -31,7 +32,7 @@
                 this.frequency = data.frequency;
             }
             if (data.opacity !== undefined) {
-                this.opacity = data.opacity;
+                this.opacity = (0, Utils_1.setRangeValue)(data.opacity);
             }
         }
     }

package/umd/Options/Interfaces/IAnimation.d.ts

@@ -1,6 +1,7 @@
+import { RangeValue } from "../../Types";
 export interface IAnimation {
-    count: number;
+    count: RangeValue;
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
 }

package/umd/Options/Interfaces/Particles/Move/IAttract.d.ts

@@ -1,6 +1,7 @@
-import type { ICoordinates } from "../../../../Core/Interfaces/ICoordinates";
+import type { ICoordinates } from "../../../../Core";
+import type { RangeValue } from "../../../../Types";
 export interface IAttract {
-    distance: number;
+    distance: RangeValue;
     enable: boolean;
     rotateX: number;
     rotateY: number;

package/umd/Options/Interfaces/Particles/Move/IMoveAngle.d.ts

@@ -1,4 +1,5 @@
+import type { RangeValue } from "../../../../Types";
 export interface IMoveAngle {
-    offset: number;
-    value: number;
+    offset: RangeValue;
+    value: RangeValue;
 }

package/umd/Options/Interfaces/Particles/Move/IMoveGravity.d.ts

@@ -1,6 +1,7 @@
+import type { RangeValue } from "../../../../Types";
 export interface IMoveGravity {
-    acceleration: number;
+    acceleration: RangeValue;
     enable: boolean;
     inverse: boolean;
-    maxSpeed: number;
+    maxSpeed: RangeValue;
 }

package/umd/Options/Interfaces/Particles/Orbit/IOrbit.d.ts

@@ -2,11 +2,12 @@ import type { IAnimatable } from "../../IAnimatable";
 import type { IAnimation } from "../../IAnimation";
 import type { IColor } from "../../../../Core";
 import type { IValueWithRandom } from "../../IValueWithRandom";
+import type { RangeValue } from "../../../../Types";
 export interface IOrbit extends IAnimatable<IAnimation> {
     color?: string | IColor;
     enable: boolean;
-    radius?: number;
+    radius?: RangeValue;
     rotation: IValueWithRandom;
-    opacity: number;
-    width: number;
+    opacity: RangeValue;
+    width: RangeValue;
 }

package/umd/Options/Interfaces/Particles/Repulse/IRepulse.d.ts

@@ -1,8 +1,9 @@
 import type { IValueWithRandom } from "../../IValueWithRandom";
+import type { RangeValue } from "../../../../Types";
 export interface IRepulse extends IValueWithRandom {
     enabled: boolean;
-    distance: number;
-    duration: number;
-    factor: number;
-    speed: number;
+    distance: RangeValue;
+    duration: RangeValue;
+    factor: RangeValue;
+    speed: RangeValue;
 }

package/umd/Options/Interfaces/Particles/Roll/IRollLight.d.ts

@@ -1,4 +1,5 @@
+import type { RangeValue } from "../../../../Types";
 export interface IRollLight {
     enable: boolean;
-    value: number;
+    value: RangeValue;
 }

package/umd/Options/Interfaces/Particles/Rotate/IRotateAnimation.d.ts

@@ -1,5 +1,6 @@
+import type { RangeValue } from "../../../../Types";
 export interface IRotateAnimation {
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
 }

package/umd/Options/Interfaces/Particles/Tilt/ITiltAnimation.d.ts

@@ -1,5 +1,6 @@
+import type { RangeValue } from "../../../../Types";
 export interface ITiltAnimation {
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
 }

package/umd/Options/Interfaces/Particles/Twinkle/ITwinkleValues.d.ts

@@ -1,7 +1,8 @@
-import type { IColor } from "../../../../Core/Interfaces/Colors";
+import type { IColor } from "../../../../Core";
+import type { RangeValue } from "../../../../Types";
 export interface ITwinkleValues {
     color?: string | IColor;
     enable: boolean;
     frequency: number;
-    opacity: number;
+    opacity: RangeValue;
 }

package/umd/Plugins/Absorbers/AbsorberInstance.js

@@ -114,7 +114,7 @@
             var _a, _b;
             const container = this.container;
             const percentPosition = this.options.position;
-            return Core_1.Vector.create((((_a = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.x) !== null && _a !== void 0 ? _a : Math.random() * 100) / 100) * container.canvas.size.width, (((_b = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.y) !== null && _b !== void 0 ? _b : Math.random() * 100) / 100) * container.canvas.size.height);
+            return Core_1.Vector.create(((0, Utils_1.getRangeValue)((_a = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.x) !== null && _a !== void 0 ? _a : Math.random() * 100) / 100) * container.canvas.size.width, ((0, Utils_1.getRangeValue)((_b = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.y) !== null && _b !== void 0 ? _b : Math.random() * 100) / 100) * container.canvas.size.height);
         }
         updateParticlePosition(particle, v) {
             var _a;

package/umd/Plugins/Absorbers/Options/Classes/Absorber.d.ts

@@ -1,7 +1,7 @@
 import { AbsorberSize } from "./AbsorberSize";
 import type { IAbsorber } from "../Interfaces/IAbsorber";
-import type { ICoordinates } from "../../../../Core";
 import type { IOptionLoader } from "../../../../Options/Interfaces/IOptionLoader";
+import type { IRangedCoordinates } from "../../../../Core";
 import { OptionsColor } from "../../../../Options/Classes/OptionsColor";
 import type { RecursivePartial } from "../../../../Types";
 export declare class Absorber implements IAbsorber, IOptionLoader<IAbsorber> {
@@ -9,7 +9,7 @@ export declare class Absorber implements IAbsorber, IOptionLoader<IAbsorber> {
     draggable: boolean;
     name?: string;
     opacity: number;
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     size: AbsorberSize;
     destroy: boolean;
     orbits: boolean;

package/umd/Plugins/Absorbers/Options/Classes/Absorber.js

@@ -4,7 +4,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./AbsorberSize", "../../../../Options/Classes/OptionsColor"], factory);
+        define(["require", "exports", "./AbsorberSize", "../../../../Options/Classes/OptionsColor", "../../../../Utils"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -12,6 +12,7 @@
     exports.Absorber = void 0;
     const AbsorberSize_1 = require("./AbsorberSize");
     const OptionsColor_1 = require("../../../../Options/Classes/OptionsColor");
+    const Utils_1 = require("../../../../Utils");
     class Absorber {
         constructor() {
             this.color = new OptionsColor_1.OptionsColor();
@@ -37,10 +38,13 @@
                 this.opacity = data.opacity;
             }
             if (data.position !== undefined) {
-                this.position = {
-                    x: data.position.x,
-                    y: data.position.y,
-                };
+                this.position = {};
+                if (data.position.x !== undefined) {
+                    this.position.x = (0, Utils_1.setRangeValue)(data.position.x);
+                }
+                if (data.position.y !== undefined) {
+                    this.position.y = (0, Utils_1.setRangeValue)(data.position.y);
+                }
             }
             if (data.size !== undefined) {
                 this.size.load(data.size);

package/umd/Plugins/Absorbers/Options/Interfaces/IAbsorber.d.ts

@@ -1,11 +1,11 @@
-import type { IColor, ICoordinates } from "../../../../Core";
+import type { IColor, IRangedCoordinates } from "../../../../Core";
 import type { IAbsorberSize } from "./IAbsorberSize";
 import { RecursivePartial } from "../../../../Types";
 export interface IAbsorber {
     color: IColor | string;
     name?: string;
     opacity: number;
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     size: IAbsorberSize;
     draggable: boolean;
     destroy: boolean;

package/umd/Plugins/Emitters/EmitterInstance.js

@@ -27,8 +27,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     const EmitterSize_1 = require("./Options/Classes/EmitterSize");
     class EmitterInstance {
         constructor(engine, emitters, container, options, position) {
-            var _a, _b, _c, _d, _e, _f;
-            var _g;
+            var _a, _b, _c, _d, _e, _f, _g;
+            var _h;
             this.emitters = emitters;
             this.container = container;
             _EmitterInstance_firstSpawn.set(this, void 0);
@@ -47,22 +47,23 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
                 this.options.load(options);
             }
             this.spawnDelay = (((_a = this.options.life.delay) !== null && _a !== void 0 ? _a : 0) * 1000) / this.container.retina.reduceFactor;
+            this.position = (_b = this.initialPosition) !== null && _b !== void 0 ? _b : this.calcPosition();
             this.name = this.options.name;
-            this.shape = (_b = __classPrivateFieldGet(this, _EmitterInstance_engine, "f").emitterShapeManager) === null || _b === void 0 ? void 0 : _b.getShape(this.options.shape);
+            this.shape = (_c = __classPrivateFieldGet(this, _EmitterInstance_engine, "f").emitterShapeManager) === null || _c === void 0 ? void 0 : _c.getShape(this.options.shape);
             this.fill = this.options.fill;
             __classPrivateFieldSet(this, _EmitterInstance_firstSpawn, !this.options.life.wait, "f");
             __classPrivateFieldSet(this, _EmitterInstance_startParticlesAdded, false, "f");
             let particlesOptions = (0, Utils_1.deepExtend)({}, this.options.particles);
             particlesOptions !== null && particlesOptions !== void 0 ? particlesOptions : (particlesOptions = {});
-            (_c = particlesOptions.move) !== null && _c !== void 0 ? _c : (particlesOptions.move = {});
-            (_d = (_g = particlesOptions.move).direction) !== null && _d !== void 0 ? _d : (_g.direction = this.options.direction);
+            (_d = particlesOptions.move) !== null && _d !== void 0 ? _d : (particlesOptions.move = {});
+            (_e = (_h = particlesOptions.move).direction) !== null && _e !== void 0 ? _e : (_h.direction = this.options.direction);
             if (this.options.spawnColor) {
                 this.spawnColor = (0, Utils_1.colorToHsl)(this.options.spawnColor);
             }
             this.paused = !this.options.autoPlay;
             this.particlesOptions = particlesOptions;
             this.size =
-                (_e = this.options.size) !== null && _e !== void 0 ? _e : (() => {
+                (_f = this.options.size) !== null && _f !== void 0 ? _f : (() => {
                     const size = new EmitterSize_1.EmitterSize();
                     size.load({
                         height: 0,
@@ -71,7 +72,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
                     });
                     return size;
                 })();
-            this.lifeCount = (_f = this.options.life.count) !== null && _f !== void 0 ? _f : -1;
+            this.lifeCount = (_g = this.options.life.count) !== null && _g !== void 0 ? _g : -1;
             this.immortal = this.lifeCount <= 0;
             this.play();
         }
@@ -219,8 +220,8 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
             const container = this.container;
             const percentPosition = this.options.position;
             return {
-                x: (((_a = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.x) !== null && _a !== void 0 ? _a : Math.random() * 100) / 100) * container.canvas.size.width,
-                y: (((_b = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.y) !== null && _b !== void 0 ? _b : Math.random() * 100) / 100) * container.canvas.size.height,
+                x: ((0, Utils_1.getRangeValue)((_a = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.x) !== null && _a !== void 0 ? _a : Math.random() * 100) / 100) * container.canvas.size.width,
+                y: ((0, Utils_1.getRangeValue)((_b = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.y) !== null && _b !== void 0 ? _b : Math.random() * 100) / 100) * container.canvas.size.height,
             };
         }
         emit() {
@@ -269,7 +270,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
             const colorOffset = (0, Utils_1.randomInRange)(animation.offset);
             const delay = (0, Utils_1.getRangeValue)(this.options.rate.delay);
             const emitFactor = (1000 * delay) / container.retina.reduceFactor;
-            const colorSpeed = (_a = animation.speed) !== null && _a !== void 0 ? _a : 0;
+            const colorSpeed = (0, Utils_1.getRangeValue)((_a = animation.speed) !== null && _a !== void 0 ? _a : 0);
             return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * 3.6) % maxValue;
         }
     }

package/umd/Plugins/Emitters/Options/Classes/Emitter.d.ts

@@ -4,10 +4,10 @@ import { EmitterLife } from "./EmitterLife";
 import { EmitterRate } from "./EmitterRate";
 import { EmitterShapeType } from "../../Enums";
 import { EmitterSize } from "./EmitterSize";
-import type { ICoordinates } from "../../../../Core";
 import type { IEmitter } from "../Interfaces/IEmitter";
 import type { IOptionLoader } from "../../../../Options/Interfaces/IOptionLoader";
 import type { IParticles } from "../../../../Options/Interfaces/Particles/IParticles";
+import type { IRangedCoordinates } from "../../../../Core";
 import type { RecursivePartial } from "../../../../Types";
 export declare class Emitter implements IEmitter, IOptionLoader<IEmitter> {
     autoPlay: boolean;
@@ -18,7 +18,7 @@ export declare class Emitter implements IEmitter, IOptionLoader<IEmitter> {
     life: EmitterLife;
     name?: string;
     particles?: RecursivePartial<IParticles>;
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     rate: EmitterRate;
     shape: EmitterShapeType | keyof typeof EmitterShapeType;
     spawnColor?: AnimatableColor;

package/umd/Plugins/Emitters/Options/Classes/Emitter.js

@@ -4,17 +4,17 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../../../Options/Classes/AnimatableColor", "./EmitterLife", "./EmitterRate", "./EmitterSize", "../../../../Utils"], factory);
+        define(["require", "exports", "../../../../Utils", "../../../../Options/Classes/AnimatableColor", "./EmitterLife", "./EmitterRate", "./EmitterSize"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Emitter = void 0;
+    const Utils_1 = require("../../../../Utils");
     const AnimatableColor_1 = require("../../../../Options/Classes/AnimatableColor");
     const EmitterLife_1 = require("./EmitterLife");
     const EmitterRate_1 = require("./EmitterRate");
     const EmitterSize_1 = require("./EmitterSize");
-    const Utils_1 = require("../../../../Utils");
     class Emitter {
         constructor() {
             this.autoPlay = true;
@@ -54,10 +54,13 @@
                 this.shape = data.shape;
             }
             if (data.position !== undefined) {
-                this.position = {
-                    x: data.position.x,
-                    y: data.position.y,
-                };
+                this.position = {};
+                if (data.position.x) {
+                    this.position.x = (0, Utils_1.setRangeValue)(data.position.x);
+                }
+                if (data.position.y) {
+                    this.position.y = (0, Utils_1.setRangeValue)(data.position.y);
+                }
             }
             if (data.spawnColor !== undefined) {
                 if (this.spawnColor === undefined) {

package/umd/Plugins/Emitters/Options/Interfaces/IEmitter.d.ts

@@ -1,11 +1,11 @@
 import type { MoveDirection, MoveDirectionAlt } from "../../../../Enums";
 import type { EmitterShapeType } from "../../Enums";
 import type { IAnimatableColor } from "../../../../Options/Interfaces/IAnimatableColor";
-import type { ICoordinates } from "../../../../Core";
 import type { IEmitterLife } from "./IEmitterLife";
 import type { IEmitterRate } from "./IEmitterRate";
 import type { IEmitterSize } from "./IEmitterSize";
 import type { IParticles } from "../../../../Options/Interfaces/Particles/IParticles";
+import type { IRangedCoordinates } from "../../../../Core";
 import type { RecursivePartial } from "../../../../Types";
 export interface IEmitter {
     autoPlay: boolean;
@@ -16,7 +16,7 @@ export interface IEmitter {
     life: IEmitterLife;
     name?: string;
     particles?: RecursivePartial<IParticles>;
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     rate: IEmitterRate;
     shape: EmitterShapeType | keyof typeof EmitterShapeType;
     spawnColor?: IAnimatableColor;

package/umd/Updaters/Angle/AngleUpdater.js

@@ -66,7 +66,8 @@
             }
             const rotateAnimation = particle.options.rotate.animation;
             if (rotateAnimation.enable) {
-                particle.rotate.velocity = (rotateAnimation.speed / 360) * this.container.retina.reduceFactor;
+                particle.rotate.velocity =
+                    ((0, Utils_1.getRangeValue)(rotateAnimation.speed) / 360) * this.container.retina.reduceFactor;
                 if (!rotateAnimation.sync) {
                     particle.rotate.velocity *= Math.random();
                 }

package/umd/Updaters/Opacity/OpacityUpdater.js

@@ -80,7 +80,7 @@
                 min: (0, Utils_1.getRangeMin)(opacityOptions.value),
                 value: (0, Utils_1.getRangeValue)(opacityOptions.value),
                 loops: 0,
-                maxLoops: opacityOptions.animation.count,
+                maxLoops: (0, Utils_1.getRangeValue)(opacityOptions.animation.count),
             };
             const opacityAnimation = opacityOptions.animation;
             if (opacityAnimation.enable) {
@@ -104,7 +104,8 @@
                         particle.opacity.status = 1;
                         break;
                 }
-                particle.opacity.velocity = (opacityAnimation.speed / 100) * this.container.retina.reduceFactor;
+                particle.opacity.velocity =
+                    ((0, Utils_1.getRangeValue)(opacityAnimation.speed) / 100) * this.container.retina.reduceFactor;
                 if (!opacityAnimation.sync) {
                     particle.opacity.velocity *= Math.random();
                 }

package/umd/Updaters/Roll/RollUpdater.js

@@ -38,19 +38,19 @@
                     const alterType = Math.random() >= 0.5 ? "darken" : "enlighten";
                     particle.roll.alter = {
                         type: alterType,
-                        value: alterType === "darken" ? rollOpt.darken.value : rollOpt.enlighten.value,
+                        value: (0, Utils_1.getRangeValue)(alterType === "darken" ? rollOpt.darken.value : rollOpt.enlighten.value),
                     };
                 }
                 else if (rollOpt.darken.enable) {
                     particle.roll.alter = {
                         type: "darken",
-                        value: rollOpt.darken.value,
+                        value: (0, Utils_1.getRangeValue)(rollOpt.darken.value),
                     };
                 }
                 else if (rollOpt.enlighten.enable) {
                     particle.roll.alter = {
                         type: "enlighten",
-                        value: rollOpt.enlighten.value,
+                        value: (0, Utils_1.getRangeValue)(rollOpt.enlighten.value),
                     };
                 }
             }

package/umd/Updaters/Tilt/TiltUpdater.js

@@ -67,7 +67,7 @@
             }
             const tiltAnimation = particle.options.tilt.animation;
             if (tiltAnimation.enable) {
-                particle.tilt.velocity = (tiltAnimation.speed / 360) * this.container.retina.reduceFactor;
+                particle.tilt.velocity = ((0, Utils_1.getRangeValue)(tiltAnimation.speed) / 360) * this.container.retina.reduceFactor;
                 if (!tiltAnimation.sync) {
                     particle.tilt.velocity *= Math.random();
                 }

package/umd/Utils/ColorUtils.js

@@ -469,7 +469,7 @@
     function setColorAnimation(colorValue, colorAnimation, reduceFactor) {
         colorValue.enable = colorAnimation.enable;
         if (colorValue.enable) {
-            colorValue.velocity = (colorAnimation.speed / 100) * reduceFactor;
+            colorValue.velocity = ((0, NumberUtils_1.getRangeValue)(colorAnimation.speed) / 100) * reduceFactor;
             if (colorAnimation.sync) {
                 return;
             }