tsparticles 1.41.4 → 1.42.0

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

@@ -1,8 +1,9 @@
+import type { RangeValue } from "../../../../Types";
 /**
  * @category Options
  */
 export interface IRotateAnimation {
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
 }

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

@@ -1,8 +1,9 @@
+import type { RangeValue } from "../../../../Types";
 /**
  * @category Options
  */
 export interface ITiltAnimation {
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
 }

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

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

package/browser/Plugins/Absorbers/AbsorberInstance.js

@@ -105,7 +105,7 @@ export class AbsorberInstance {
         var _a, _b;
         const container = this.container;
         const percentPosition = this.options.position;
-        return 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 Vector.create((getRangeValue((_a = percentPosition === null || percentPosition === void 0 ? void 0 : percentPosition.x) !== null && _a !== void 0 ? _a : Math.random() * 100) / 100) * container.canvas.size.width, (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/browser/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";
 /**
@@ -13,7 +13,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/browser/Plugins/Absorbers/Options/Classes/Absorber.js

@@ -1,5 +1,6 @@
 import { AbsorberSize } from "./AbsorberSize";
 import { OptionsColor } from "../../../../Options/Classes/OptionsColor";
+import { setRangeValue } from "../../../../Utils";
 /**
  * [[include:Options/Plugins/Absorbers.md]]
  * @category Absorbers Plugin
@@ -29,10 +30,13 @@ export class Absorber {
             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 = setRangeValue(data.position.x);
+            }
+            if (data.position.y !== undefined) {
+                this.position.y = setRangeValue(data.position.y);
+            }
         }
         if (data.size !== undefined) {
             this.size.load(data.size);

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

@@ -1,4 +1,4 @@
-import type { IColor, ICoordinates } from "../../../../Core";
+import type { IColor, IRangedCoordinates } from "../../../../Core";
 import type { IAbsorberSize } from "./IAbsorberSize";
 import { RecursivePartial } from "../../../../Types";
 /**
@@ -22,7 +22,7 @@ export interface IAbsorber {
     /**
      * Absorber position, percent values calculated on canvas size
      */
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     /**
      * Absorber size, these values will be used as pixels
      */

package/browser/Plugins/Emitters/EmitterInstance.js

@@ -18,8 +18,8 @@ import { EmitterSize } from "./Options/Classes/EmitterSize";
  */
 export 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);
@@ -38,22 +38,23 @@ export class EmitterInstance {
             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 = 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 = 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();
                 size.load({
                     height: 0,
@@ -62,7 +63,7 @@ export class EmitterInstance {
                 });
                 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();
     }
@@ -210,8 +211,8 @@ export class EmitterInstance {
         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: (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: (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() {
@@ -260,7 +261,7 @@ export class EmitterInstance {
         const colorOffset = randomInRange(animation.offset);
         const delay = 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 = getRangeValue((_a = animation.speed) !== null && _a !== void 0 ? _a : 0);
         return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * 3.6) % maxValue;
     }
 }

package/browser/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";
 /**
  * [[include:Options/Plugins/Emitters.md]]
@@ -22,7 +22,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/browser/Plugins/Emitters/Options/Classes/Emitter.js

@@ -1,8 +1,8 @@
+import { deepExtend, setRangeValue } from "../../../../Utils";
 import { AnimatableColor } from "../../../../Options/Classes/AnimatableColor";
 import { EmitterLife } from "./EmitterLife";
 import { EmitterRate } from "./EmitterRate";
 import { EmitterSize } from "./EmitterSize";
-import { deepExtend } from "../../../../Utils";
 /**
  * [[include:Options/Plugins/Emitters.md]]
  * @category Emitters Plugin
@@ -46,10 +46,13 @@ export class Emitter {
             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 = setRangeValue(data.position.x);
+            }
+            if (data.position.y) {
+                this.position.y = setRangeValue(data.position.y);
+            }
         }
         if (data.spawnColor !== undefined) {
             if (this.spawnColor === undefined) {

package/browser/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";
 /**
  * Particles emitter object options
@@ -51,7 +51,7 @@ export interface IEmitter {
      * The relative position (in percent) of the emitter, where particles spawns.
      * If size is specified the position will be the center of the size options
      */
-    position?: RecursivePartial<ICoordinates>;
+    position?: RecursivePartial<IRangedCoordinates>;
     /**
      * The particles emitting rate options
      */

package/browser/Updaters/Angle/AngleUpdater.js

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

package/browser/Updaters/Opacity/OpacityUpdater.js

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

package/browser/Updaters/Roll/RollUpdater.js

@@ -26,19 +26,19 @@ export class RollUpdater {
                 const alterType = Math.random() >= 0.5 ? "darken" /* darken */ : "enlighten" /* enlighten */;
                 particle.roll.alter = {
                     type: alterType,
-                    value: alterType === "darken" /* darken */ ? rollOpt.darken.value : rollOpt.enlighten.value,
+                    value: getRangeValue(alterType === "darken" /* darken */ ? rollOpt.darken.value : rollOpt.enlighten.value),
                 };
             }
             else if (rollOpt.darken.enable) {
                 particle.roll.alter = {
                     type: "darken" /* darken */,
-                    value: rollOpt.darken.value,
+                    value: getRangeValue(rollOpt.darken.value),
                 };
             }
             else if (rollOpt.enlighten.enable) {
                 particle.roll.alter = {
                     type: "enlighten" /* enlighten */,
-                    value: rollOpt.enlighten.value,
+                    value: getRangeValue(rollOpt.enlighten.value),
                 };
             }
         }

package/browser/Updaters/Tilt/TiltUpdater.js

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

package/browser/Utils/ColorUtils.js

@@ -1,4 +1,4 @@
-import { mix, randomInRange, setRangeValue } from "./NumberUtils";
+import { getRangeValue, mix, randomInRange, setRangeValue } from "./NumberUtils";
 import { Constants } from "../Core";
 import { itemFromArray } from "./Utils";
 /**
@@ -465,7 +465,7 @@ export function getHslAnimationFromHsl(hsl, animationOptions, reduceFactor) {
 function setColorAnimation(colorValue, colorAnimation, reduceFactor) {
     colorValue.enable = colorAnimation.enable;
     if (colorValue.enable) {
-        colorValue.velocity = (colorAnimation.speed / 100) * reduceFactor;
+        colorValue.velocity = (getRangeValue(colorAnimation.speed) / 100) * reduceFactor;
         if (colorAnimation.sync) {
             return;
         }

package/esm/Core/Canvas.js

@@ -1,4 +1,4 @@
-import { clear, colorToHsl, colorToRgb, deepExtend, drawConnectLine, drawGrabLine, drawParticle, drawParticlePlugin, drawPlugin, getStyleFromHsl, getStyleFromRgb, gradient, paintBase, } from "../Utils";
+import { clear, colorToHsl, colorToRgb, deepExtend, drawConnectLine, drawGrabLine, drawParticle, drawParticlePlugin, drawPlugin, getRangeValue, getStyleFromHsl, getStyleFromRgb, gradient, paintBase, } from "../Utils";
 import { Constants } from "./Utils";
 export class Canvas {
     constructor(container) {
@@ -95,10 +95,7 @@ export class Canvas {
         const container = this.container;
         const pxRatio = container.retina.pixelRatio;
         const size = container.canvas.size;
-        const oldSize = {
-            width: size.width,
-            height: size.height,
-        };
+        const oldSize = Object.assign({}, size);
         size.width = this.element.offsetWidth * pxRatio;
         size.height = this.element.offsetHeight * pxRatio;
         this.element.width = size.width;
@@ -157,7 +154,9 @@ export class Canvas {
         const zIndexOptions = particle.options.zIndex;
         const zOpacityFactor = (1 - particle.zIndexFactor) ** zIndexOptions.opacityRate;
         const radius = particle.getRadius();
-        const opacity = twinkling ? twinkle.opacity : (_d = (_b = particle.bubble.opacity) !== null && _b !== void 0 ? _b : (_c = particle.opacity) === null || _c === void 0 ? void 0 : _c.value) !== null && _d !== void 0 ? _d : 1;
+        const opacity = twinkling
+            ? getRangeValue(twinkle.opacity)
+            : (_d = (_b = particle.bubble.opacity) !== null && _b !== void 0 ? _b : (_c = particle.opacity) === null || _c === void 0 ? void 0 : _c.value) !== null && _d !== void 0 ? _d : 1;
         const strokeOpacity = (_f = (_e = particle.stroke) === null || _e === void 0 ? void 0 : _e.opacity) !== null && _f !== void 0 ? _f : opacity;
         const zOpacity = opacity * zOpacityFactor;
         const fillColorValue = fColor ? getStyleFromHsl(fColor, zOpacity) : undefined;

package/esm/Core/Interfaces/ICoordinates.d.ts

@@ -1,3 +1,4 @@
+import type { RangeValue } from "../../Types";
 export interface ICoordinates {
     x: number;
     y: number;
@@ -5,3 +6,10 @@ export interface ICoordinates {
 export interface ICoordinates3d extends ICoordinates {
     z: number;
 }
+export interface IRangedCoordinates {
+    x: RangeValue;
+    y: RangeValue;
+}
+export interface IRangedCoordinates3d extends IRangedCoordinates {
+    z: RangeValue;
+}

package/esm/Core/Interfaces/IParticleGravity.d.ts

@@ -0,0 +1,5 @@
+export interface IParticleGravity {
+    enable: boolean;
+    acceleration: number;
+    inverse: boolean;
+}

package/esm/Core/Interfaces/IParticleGravity.js

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

package/esm/Core/Interfaces/index.d.ts

@@ -18,6 +18,7 @@ export * from "./IMovePathGenerator";
 export * from "./IParticle";
 export * from "./IParticleGradientAnimation";
 export * from "./IParticleGradientColorAnimation";
+export * from "./IParticleGravity";
 export * from "./IParticleHslAnimation";
 export * from "./IParticlesInteractor";
 export * from "./IParticleLife";

package/esm/Core/Interfaces/index.js

@@ -18,6 +18,7 @@ export * from "./IMovePathGenerator";
 export * from "./IParticle";
 export * from "./IParticleGradientAnimation";
 export * from "./IParticleGradientColorAnimation";
+export * from "./IParticleGravity";
 export * from "./IParticleHslAnimation";
 export * from "./IParticlesInteractor";
 export * from "./IParticleLife";

package/esm/Core/Particle.d.ts

@@ -1,5 +1,5 @@
 import { ShapeType } from "../Enums";
-import type { IBubbleParticleData, ICoordinates, ICoordinates3d, IDelta, IHsl, IParticle, IParticleGradientAnimation, IParticleHslAnimation, IParticleLife, IParticleNumericValueAnimation, IParticleRetinaProps, IParticleRoll, IParticleSpin, IParticleTiltValueAnimation, IParticleValueAnimation, IParticleWobble, IRgb, IShapeValues } from "./Interfaces";
+import type { IBubbleParticleData, ICoordinates, ICoordinates3d, IDelta, IHsl, IParticle, IParticleGradientAnimation, IParticleGravity, IParticleHslAnimation, IParticleLife, IParticleNumericValueAnimation, IParticleRetinaProps, IParticleRoll, IParticleSpin, IParticleTiltValueAnimation, IParticleValueAnimation, IParticleWobble, IRgb, IShapeValues } from "./Interfaces";
 import { Vector, Vector3d } from "./Utils";
 import type { Container } from "./Container";
 import type { Engine } from "../engine";
@@ -13,6 +13,7 @@ export declare class Particle implements IParticle {
     readonly container: Container;
     readonly group?: string | undefined;
     destroyed: boolean;
+    ignoresResizeRatio: boolean;
     lastPathTime: number;
     misplaced: boolean;
     spawning: boolean;
@@ -36,6 +37,7 @@ export declare class Particle implements IParticle {
     strokeWidth?: number;
     stroke?: Stroke;
     strokeColor?: IParticleHslAnimation;
+    readonly gravity: IParticleGravity;
     readonly moveDecay: number;
     readonly direction: number;
     readonly position: Vector3d;

package/esm/Core/Particle.js

@@ -42,6 +42,7 @@ export class Particle {
         this.retina = {
             maxDistance: {},
         };
+        this.ignoresResizeRatio = true;
         const pxRatio = container.retina.pixelRatio;
         const mainOptions = container.actualOptions;
         const particlesOptions = new ParticlesOptions();
@@ -85,7 +86,7 @@ export class Particle {
             max: getRangeMax(sizeRange) * pxRatio,
             min: getRangeMin(sizeRange) * pxRatio,
             loops: 0,
-            maxLoops: sizeOptions.animation.count,
+            maxLoops: getRangeValue(sizeOptions.animation.count),
         };
         const sizeAnimation = sizeOptions.animation;
         if (sizeAnimation.enable) {
@@ -119,6 +120,12 @@ export class Particle {
         this.initialVelocity = this.calculateVelocity();
         this.velocity = this.initialVelocity.copy();
         this.moveDecay = 1 - getRangeValue(this.options.move.decay);
+        const gravityOptions = this.options.move.gravity;
+        this.gravity = {
+            enable: gravityOptions.enable,
+            acceleration: getRangeValue(gravityOptions.acceleration),
+            inverse: gravityOptions.inverse,
+        };
         this.position = this.calcPosition(container, position, clamp(zIndexValue, 0, container.zLayers));
         this.initialPosition = this.position.copy();
         this.offset = Vector.origin;
@@ -326,12 +333,7 @@ export class Particle {
         return overlaps;
     }
     calculateVelocity() {
-        const baseVelocity = getParticleBaseVelocity(this.direction);
-        const res = baseVelocity.copy();
-        const moveOptions = this.options.move;
-        const rad = (Math.PI / 180) * moveOptions.angle.value;
-        const radOffset = (Math.PI / 180) * moveOptions.angle.offset;
-        const range = {
+        const baseVelocity = getParticleBaseVelocity(this.direction), res = baseVelocity.copy(), moveOptions = this.options.move, rad = (Math.PI / 180) * getRangeValue(moveOptions.angle.value), radOffset = (Math.PI / 180) * getRangeValue(moveOptions.angle.offset), range = {
             left: radOffset - rad / 2,
             right: radOffset + rad / 2,
         };

package/esm/Core/Particles.js

@@ -108,10 +108,11 @@ export class Particles {
         }
         for (const particle of this.array) {
             const resizeFactor = container.canvas.resizeFactor;
-            if (resizeFactor) {
+            if (resizeFactor && !particle.ignoresResizeRatio) {
                 particle.position.x *= resizeFactor.width;
                 particle.position.y *= resizeFactor.height;
             }
+            particle.ignoresResizeRatio = false;
             particle.bubble.inRange = false;
             for (const [, plugin] of this.container.plugins) {
                 if (particle.destroyed) {

package/esm/Core/Retina.js

@@ -40,13 +40,13 @@ export class Retina {
             container.canvas.size.height = element.offsetHeight * ratio;
         }
         const particles = options.particles;
-        this.attractDistance = particles.move.attract.distance * ratio;
+        this.attractDistance = getRangeValue(particles.move.attract.distance) * ratio;
         this.linksDistance = particles.links.distance * ratio;
         this.linksWidth = particles.links.width * ratio;
-        this.sizeAnimationSpeed = particles.size.animation.speed * ratio;
-        this.maxSpeed = particles.move.gravity.maxSpeed * ratio;
+        this.sizeAnimationSpeed = getRangeValue(particles.size.animation.speed) * ratio;
+        this.maxSpeed = getRangeValue(particles.move.gravity.maxSpeed) * ratio;
         if (particles.orbit.radius !== undefined) {
-            this.orbitRadius = particles.orbit.radius * this.container.retina.pixelRatio;
+            this.orbitRadius = getRangeValue(particles.orbit.radius) * this.container.retina.pixelRatio;
         }
         const modes = options.interactivity.modes;
         this.connectModeDistance = modes.connect.distance * ratio;
@@ -66,19 +66,19 @@ export class Retina {
         const ratio = this.pixelRatio;
         const moveDistance = options.move.distance;
         const props = particle.retina;
-        props.attractDistance = options.move.attract.distance * ratio;
+        props.attractDistance = getRangeValue(options.move.attract.distance) * ratio;
         props.linksDistance = options.links.distance * ratio;
         props.linksWidth = options.links.width * ratio;
         props.moveDrift = getRangeValue(options.move.drift) * ratio;
         props.moveSpeed = getRangeValue(options.move.speed) * ratio;
-        props.sizeAnimationSpeed = options.size.animation.speed * ratio;
+        props.sizeAnimationSpeed = getRangeValue(options.size.animation.speed) * ratio;
         if (particle.spin) {
             props.spinAcceleration = getRangeValue(options.move.spin.acceleration) * ratio;
         }
         const maxDistance = props.maxDistance;
         maxDistance.horizontal = moveDistance.horizontal !== undefined ? moveDistance.horizontal * ratio : undefined;
         maxDistance.vertical = moveDistance.vertical !== undefined ? moveDistance.vertical * ratio : undefined;
-        props.maxSpeed = options.move.gravity.maxSpeed * ratio;
+        props.maxSpeed = getRangeValue(options.move.gravity.maxSpeed) * ratio;
     }
     handleMotionChange(mediaQuery) {
         const options = this.container.actualOptions;

package/esm/Core/Utils/ParticlesMover.js

@@ -52,7 +52,7 @@ export class ParticlesMover {
         const container = this.container, slowFactor = this.getProximitySpeedFactor(particle), baseSpeed = ((_a = (_d = particle.retina).moveSpeed) !== null && _a !== void 0 ? _a : (_d.moveSpeed = getRangeValue(moveOptions.speed) * container.retina.pixelRatio)) *
             container.retina.reduceFactor, moveDrift = ((_b = (_e = particle.retina).moveDrift) !== null && _b !== void 0 ? _b : (_e.moveDrift = getRangeValue(particle.options.move.drift) * container.retina.pixelRatio)), maxSize = getRangeMax(particleOptions.size.value) * container.retina.pixelRatio, sizeFactor = moveOptions.size ? particle.getRadius() / maxSize : 1, diffFactor = 2, speedFactor = (sizeFactor * slowFactor * (delta.factor || 1)) / diffFactor, moveSpeed = baseSpeed * speedFactor;
         this.applyPath(particle, delta);
-        const gravityOptions = moveOptions.gravity;
+        const gravityOptions = particle.gravity;
         const gravityFactor = gravityOptions.enable && gravityOptions.inverse ? -1 : 1;
         if (gravityOptions.enable && moveSpeed) {
             particle.velocity.y += (gravityFactor * (gravityOptions.acceleration * delta.factor)) / (60 * moveSpeed);
@@ -67,7 +67,7 @@ export class ParticlesMover {
         const velocity = particle.velocity.mult(moveSpeed);
         const maxSpeed = (_c = particle.retina.maxSpeed) !== null && _c !== void 0 ? _c : container.retina.maxSpeed;
         if (gravityOptions.enable &&
-            gravityOptions.maxSpeed > 0 &&
+            maxSpeed > 0 &&
             ((!gravityOptions.inverse && velocity.y >= 0 && velocity.y >= maxSpeed) ||
                 (gravityOptions.inverse && velocity.y <= 0 && velocity.y <= -maxSpeed))) {
             velocity.y = gravityFactor * maxSpeed;

package/esm/Interactions/Particles/Links/LinkInstance.js

@@ -1,4 +1,4 @@
-import { colorToRgb, drawLinkLine, drawLinkTriangle, getDistance, getLinkColor } from "../../../Utils";
+import { colorToRgb, drawLinkLine, drawLinkTriangle, getDistance, getLinkColor, getRangeValue } from "../../../Utils";
 export class LinkInstance {
     constructor(container) {
         this.container = container;
@@ -99,7 +99,7 @@ export class LinkInstance {
                 const twinkling = Math.random() < twinkleFreq;
                 if (twinkling && twinkleRgb !== undefined) {
                     colorLine = twinkleRgb;
-                    opacity = twinkle.opacity;
+                    opacity = getRangeValue(twinkle.opacity);
                 }
             }
             if (!colorLine) {

package/esm/Options/Classes/AnimatableGradient.d.ts

@@ -35,17 +35,17 @@ export declare class AnimatableGradientColor implements IAnimatableGradientColor
     load(data?: RecursivePartial<IAnimatableGradientColor>): void;
 }
 export declare class GradientAngleAnimation implements IAnimation, IOptionLoader<IAnimation> {
-    count: number;
+    count: RangeValue;
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
     constructor();
     load(data?: RecursivePartial<IAnimation>): void;
 }
 export declare class GradientColorOpacityAnimation implements IGradientColorOpacityAnimation, IOptionLoader<IGradientColorOpacityAnimation> {
-    count: number;
+    count: RangeValue;
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
     startValue: StartValueType | keyof typeof StartValueType;
     constructor();

package/esm/Options/Classes/AnimatableGradient.js

@@ -93,13 +93,13 @@ export class GradientAngleAnimation {
             return;
         }
         if (data.count !== undefined) {
-            this.count = data.count;
+            this.count = setRangeValue(data.count);
         }
         if (data.enable !== undefined) {
             this.enable = data.enable;
         }
         if (data.speed !== undefined) {
-            this.speed = data.speed;
+            this.speed = setRangeValue(data.speed);
         }
         if (data.sync !== undefined) {
             this.sync = data.sync;
@@ -119,13 +119,13 @@ export class GradientColorOpacityAnimation {
             return;
         }
         if (data.count !== undefined) {
-            this.count = data.count;
+            this.count = setRangeValue(data.count);
         }
         if (data.enable !== undefined) {
             this.enable = data.enable;
         }
         if (data.speed !== undefined) {
-            this.speed = data.speed;
+            this.speed = setRangeValue(data.speed);
         }
         if (data.sync !== undefined) {
             this.sync = data.sync;

package/esm/Options/Classes/AnimationOptions.d.ts

@@ -1,10 +1,10 @@
-import { IAnimation } from "../Interfaces/IAnimation";
-import { IOptionLoader } from "../Interfaces/IOptionLoader";
-import { RecursivePartial } from "../../Types";
+import type { RangeValue, RecursivePartial } from "../../Types";
+import type { IAnimation } from "../Interfaces/IAnimation";
+import type { IOptionLoader } from "../Interfaces/IOptionLoader";
 export declare class AnimationOptions implements IAnimation, IOptionLoader<IAnimation> {
-    count: number;
+    count: RangeValue;
     enable: boolean;
-    speed: number;
+    speed: RangeValue;
     sync: boolean;
     constructor();
     load(data?: RecursivePartial<IAnimation>): void;