tsparticles 1.41.4 → 1.42.0

package/scripts/install.js

@@ -1,4 +1,5 @@
 const path = require('path');
+const particlesJsFoundError = "particles.js-found";
 const reactParticlesJsFoundError = "react-particles-js-found";
 
 try {
@@ -20,8 +21,16 @@ try {
         return;
     }
 
+    if (dependencies["particles.js"]) {
+        console.error("\x1b[31m%s\x1b[0m", "The package particles.js can't be installed with tsparticles, since it can lead to unexpected behaviors, please uninstall particles.js and remove it from the package.json file.");
+
+        throw new Error(reactParticlesJsFoundError);
+    }
+
     if (dependencies["react-particles-js"]) {
-        console.error("\x1b[31m%s\x1b[0m", "The package react-particles-js has been deprecated and is not supported anymore. Please consider switching to react-tsparticles package.");
+        console.error("\x1b[31m%s\x1b[0m", "The package react-particles-js has been deprecated and is not supported anymore.");
+        console.error("\x1b[31m%s\x1b[0m", "Please consider switching to react-tsparticles package.")
+        console.error("\x1b[31m%s\x1b[0m", "This error will be fixed once react-particles-js is removed from the package.json file.");
 
         throw new Error(reactParticlesJsFoundError);
     }
@@ -88,7 +97,7 @@ try {
         }
     }
 } catch (error) {
-    if (error.message === reactParticlesJsFoundError) {
+    if (error.message === reactParticlesJsFoundError || error.message === particlesJsFoundError) {
         throw error;
     }
 

package/tsparticles.engine.js

@@ -1087,7 +1087,7 @@
     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;
         }
@@ -2037,7 +2037,7 @@
         }
         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);
@@ -2051,7 +2051,7 @@
         }
         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 && (!gravityOptions.inverse && velocity.y >= 0 && velocity.y >= maxSpeed || gravityOptions.inverse && velocity.y <= 0 && velocity.y <= -maxSpeed)) {
+        if (gravityOptions.enable && maxSpeed > 0 && (!gravityOptions.inverse && velocity.y >= 0 && velocity.y >= maxSpeed || gravityOptions.inverse && velocity.y <= 0 && velocity.y <= -maxSpeed)) {
           velocity.y = gravityFactor * maxSpeed;
           if (moveSpeed) {
             particle.velocity.y = velocity.y / moveSpeed;
@@ -2560,10 +2560,7 @@
         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;
@@ -2622,7 +2619,7 @@
         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;
@@ -3640,7 +3637,7 @@
           return;
         }
         if (data.count !== undefined) {
-          this.count = data.count;
+          this.count = setRangeValue(data.count);
         }
         if (data.enable !== undefined) {
           this.enable = data.enable;
@@ -3649,7 +3646,7 @@
           this.offset = setRangeValue(data.offset);
         }
         if (data.speed !== undefined) {
-          this.speed = data.speed;
+          this.speed = setRangeValue(data.speed);
         }
         if (data.sync !== undefined) {
           this.sync = data.sync;
@@ -3797,13 +3794,13 @@
           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;
@@ -3823,13 +3820,13 @@
           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;
@@ -4155,7 +4152,7 @@
           return;
         }
         if (data.distance !== undefined) {
-          this.distance = data.distance;
+          this.distance = setRangeValue(data.distance);
         }
         if (data.enable !== undefined) {
           this.enable = data.enable;
@@ -4180,10 +4177,10 @@
           return;
         }
         if (data.offset !== undefined) {
-          this.offset = data.offset;
+          this.offset = setRangeValue(data.offset);
         }
         if (data.value !== undefined) {
-          this.value = data.value;
+          this.value = setRangeValue(data.value);
         }
       }
     }
@@ -4199,7 +4196,7 @@
           return;
         }
         if (data.acceleration !== undefined) {
-          this.acceleration = data.acceleration;
+          this.acceleration = setRangeValue(data.acceleration);
         }
         if (data.enable !== undefined) {
           this.enable = data.enable;
@@ -4208,7 +4205,7 @@
           this.inverse = data.inverse;
         }
         if (data.maxSpeed !== undefined) {
-          this.maxSpeed = data.maxSpeed;
+          this.maxSpeed = setRangeValue(data.maxSpeed);
         }
       }
     }
@@ -4423,13 +4420,13 @@
           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;
@@ -4533,13 +4530,13 @@
           this.enable = data.enable;
         }
         if (data.opacity !== undefined) {
-          this.opacity = data.opacity;
+          this.opacity = setRangeValue(data.opacity);
         }
         if (data.width !== undefined) {
-          this.width = data.width;
+          this.width = setRangeValue(data.width);
         }
         if (data.radius !== undefined) {
-          this.radius = data.radius;
+          this.radius = setRangeValue(data.radius);
         }
         if (data.color !== undefined) {
           this.color = OptionsColor.create(this.color, data.color);
@@ -4620,16 +4617,16 @@
           this.enabled = data.enabled;
         }
         if (data.distance !== undefined) {
-          this.distance = data.distance;
+          this.distance = setRangeValue(data.distance);
         }
         if (data.duration !== undefined) {
-          this.duration = data.duration;
+          this.duration = setRangeValue(data.duration);
         }
         if (data.factor !== undefined) {
-          this.factor = data.factor;
+          this.factor = setRangeValue(data.factor);
         }
         if (data.speed !== undefined) {
-          this.speed = data.speed;
+          this.speed = setRangeValue(data.speed);
         }
       }
     }
@@ -4646,7 +4643,7 @@
           this.enable = data.enable;
         }
         if (data.value !== undefined) {
-          this.value = data.value;
+          this.value = setRangeValue(data.value);
         }
       }
     }
@@ -4692,7 +4689,7 @@
           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;
@@ -4948,7 +4945,7 @@
           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;
@@ -4997,7 +4994,7 @@
           this.frequency = data.frequency;
         }
         if (data.opacity !== undefined) {
-          this.opacity = data.opacity;
+          this.opacity = setRangeValue(data.opacity);
         }
       }
     }
@@ -5432,6 +5429,7 @@
         this.retina = {
           maxDistance: {}
         };
+        this.ignoresResizeRatio = true;
         const pxRatio = container.retina.pixelRatio;
         const mainOptions = container.actualOptions;
         const particlesOptions = new ParticlesOptions;
@@ -5471,7 +5469,7 @@
           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) {
@@ -5505,6 +5503,12 @@
         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;
@@ -5712,12 +5716,7 @@
         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
         };
@@ -5867,10 +5866,11 @@
         }
         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) {
@@ -6106,13 +6106,13 @@
           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;
@@ -6132,19 +6132,19 @@
         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;