@tsparticles/engine 3.0.2 → 3.1.0

package/umd/Utils/NumberUtils.js

@@ -4,16 +4,17 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../Core/Utils/Vector.js", "./Utils.js"], factory);
+        define(["require", "exports", "../Core/Utils/Vector.js", "./Utils.js", "../Core/Utils/Constants.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.parseAlpha = exports.calcExactPositionOrRandomFromSizeRanged = exports.calcExactPositionOrRandomFromSize = exports.calcPositionOrRandomFromSizeRanged = exports.calcPositionOrRandomFromSize = exports.calcPositionFromSize = exports.collisionVelocity = exports.getParticleBaseVelocity = exports.getParticleDirectionAngle = exports.getDistance = exports.getDistances = exports.setRangeValue = exports.getRangeMax = exports.getRangeMin = exports.getRangeValue = exports.randomInRange = exports.mix = exports.clamp = exports.getRandom = exports.setRandom = exports.getEasing = exports.addEasing = void 0;
+    exports.parseAlpha = exports.calcExactPositionOrRandomFromSizeRanged = exports.calcExactPositionOrRandomFromSize = exports.calcPositionOrRandomFromSizeRanged = exports.calcPositionOrRandomFromSize = exports.calcPositionFromSize = exports.collisionVelocity = exports.getParticleBaseVelocity = exports.getParticleDirectionAngle = exports.degToRad = exports.getDistance = exports.getDistances = exports.setRangeValue = exports.getRangeMax = exports.getRangeMin = exports.getRangeValue = exports.randomInRange = exports.mix = exports.clamp = exports.getRandom = exports.setRandom = exports.getEasing = exports.addEasing = void 0;
     const Vector_js_1 = require("../Core/Utils/Vector.js");
     const Utils_js_1 = require("./Utils.js");
+    const Constants_js_1 = require("../Core/Utils/Constants.js");
     let _random = Math.random;
-    const easings = new Map();
+    const easings = new Map(), double = 2, doublePI = Math.PI * double;
     function addEasing(name, easing) {
         if (easings.get(name)) {
             return;
@@ -22,7 +23,7 @@
     }
     exports.addEasing = addEasing;
     function getEasing(name) {
-        return easings.get(name) || ((value) => value);
+        return easings.get(name) ?? ((value) => value);
     }
     exports.getEasing = getEasing;
     function setRandom(rnd = Math.random) {
@@ -30,7 +31,8 @@
     }
     exports.setRandom = setRandom;
     function getRandom() {
-        return clamp(_random(), 0, 1 - 1e-16);
+        const min = 0, max = 1;
+        return clamp(_random(), min, max - Number.EPSILON);
     }
     exports.getRandom = getRandom;
     function clamp(num, min, max) {
@@ -42,10 +44,10 @@
     }
     exports.mix = mix;
     function randomInRange(r) {
-        const max = getRangeMax(r);
+        const max = getRangeMax(r), minOffset = 0;
         let min = getRangeMin(r);
         if (max === min) {
-            min = 0;
+            min = minOffset;
         }
         return getRandom() * (max - min) + min;
     }
@@ -76,41 +78,47 @@
     }
     exports.setRangeValue = setRangeValue;
     function getDistances(pointA, pointB) {
-        const dx = pointA.x - pointB.x, dy = pointA.y - pointB.y;
-        return { dx: dx, dy: dy, distance: Math.sqrt(dx ** 2 + dy ** 2) };
+        const dx = pointA.x - pointB.x, dy = pointA.y - pointB.y, squareExp = 2;
+        return { dx: dx, dy: dy, distance: Math.sqrt(dx ** squareExp + dy ** squareExp) };
     }
     exports.getDistances = getDistances;
     function getDistance(pointA, pointB) {
         return getDistances(pointA, pointB).distance;
     }
     exports.getDistance = getDistance;
+    function degToRad(degrees) {
+        const PIDeg = 180;
+        return (degrees * Math.PI) / PIDeg;
+    }
+    exports.degToRad = degToRad;
     function getParticleDirectionAngle(direction, position, center) {
         if ((0, Utils_js_1.isNumber)(direction)) {
-            return (direction * Math.PI) / 180;
+            return degToRad(direction);
         }
+        const empty = 0, half = 0.5, quarter = 0.25, threeQuarter = half + quarter;
         switch (direction) {
             case "top":
-                return -Math.PI * 0.5;
+                return -Math.PI * half;
             case "top-right":
-                return -Math.PI * 0.25;
+                return -Math.PI * quarter;
             case "right":
-                return 0;
+                return empty;
             case "bottom-right":
-                return Math.PI * 0.25;
+                return Math.PI * quarter;
             case "bottom":
-                return Math.PI * 0.5;
+                return Math.PI * half;
             case "bottom-left":
-                return Math.PI * 0.75;
+                return Math.PI * threeQuarter;
             case "left":
                 return Math.PI;
             case "top-left":
-                return -Math.PI * 0.75;
+                return -Math.PI * threeQuarter;
             case "inside":
                 return Math.atan2(center.y - position.y, center.x - position.x);
             case "outside":
                 return Math.atan2(position.y - center.y, position.x - center.x);
             default:
-                return getRandom() * Math.PI * 2;
+                return getRandom() * doublePI;
         }
     }
     exports.getParticleDirectionAngle = getParticleDirectionAngle;
@@ -122,22 +130,23 @@
     }
     exports.getParticleBaseVelocity = getParticleBaseVelocity;
     function collisionVelocity(v1, v2, m1, m2) {
-        return Vector_js_1.Vector.create((v1.x * (m1 - m2)) / (m1 + m2) + (v2.x * 2 * m2) / (m1 + m2), v1.y);
+        const double = 2;
+        return Vector_js_1.Vector.create((v1.x * (m1 - m2)) / (m1 + m2) + (v2.x * double * m2) / (m1 + m2), v1.y);
     }
     exports.collisionVelocity = collisionVelocity;
     function calcPositionFromSize(data) {
-        return data.position && data.position.x !== undefined && data.position.y !== undefined
+        return data.position?.x !== undefined && data.position.y !== undefined
             ? {
-                x: (data.position.x * data.size.width) / 100,
-                y: (data.position.y * data.size.height) / 100,
+                x: (data.position.x * data.size.width) / Constants_js_1.percentDenominator,
+                y: (data.position.y * data.size.height) / Constants_js_1.percentDenominator,
             }
             : undefined;
     }
     exports.calcPositionFromSize = calcPositionFromSize;
     function calcPositionOrRandomFromSize(data) {
         return {
-            x: ((data.position?.x ?? getRandom() * 100) * data.size.width) / 100,
-            y: ((data.position?.y ?? getRandom() * 100) * data.size.height) / 100,
+            x: ((data.position?.x ?? getRandom() * Constants_js_1.percentDenominator) * data.size.width) / Constants_js_1.percentDenominator,
+            y: ((data.position?.y ?? getRandom() * Constants_js_1.percentDenominator) * data.size.height) / Constants_js_1.percentDenominator,
         };
     }
     exports.calcPositionOrRandomFromSize = calcPositionOrRandomFromSize;
@@ -165,7 +174,11 @@
     }
     exports.calcExactPositionOrRandomFromSizeRanged = calcExactPositionOrRandomFromSizeRanged;
     function parseAlpha(input) {
-        return input ? (input.endsWith("%") ? parseFloat(input) / 100 : parseFloat(input)) : 1;
+        const defaultAlpha = 1;
+        if (!input) {
+            return defaultAlpha;
+        }
+        return input.endsWith("%") ? parseFloat(input) / Constants_js_1.percentDenominator : parseFloat(input);
     }
     exports.parseAlpha = parseAlpha;
 });

package/umd/Utils/RgbColorManager.js

@@ -36,13 +36,13 @@
             if (!input.startsWith(this.stringPrefix)) {
                 return;
             }
-            const regex = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([\d.%]+)\s*)?\)/i, result = regex.exec(input);
+            const regex = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([\d.%]+)\s*)?\)/i, result = regex.exec(input), radix = 10, minLength = 4, defaultAlpha = 1;
             return result
                 ? {
-                    a: result.length > 4 ? (0, NumberUtils_js_1.parseAlpha)(result[5]) : 1,
-                    b: parseInt(result[3], 10),
-                    g: parseInt(result[2], 10),
-                    r: parseInt(result[1], 10),
+                    a: result.length > minLength ? (0, NumberUtils_js_1.parseAlpha)(result[5]) : defaultAlpha,
+                    b: parseInt(result[3], radix),
+                    g: parseInt(result[2], radix),
+                    r: parseInt(result[1], radix),
                 }
                 : undefined;
         }

package/umd/Utils/Utils.js

@@ -4,13 +4,14 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./NumberUtils.js", "../Core/Utils/Vector.js"], factory);
+        define(["require", "exports", "./NumberUtils.js", "../Core/Utils/Constants.js", "../Core/Utils/Vector.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.isArray = exports.isObject = exports.isFunction = exports.isNumber = exports.isString = exports.isBoolean = exports.getSize = exports.getPosition = exports.initParticleNumericAnimationValue = exports.findItemFromSingleOrMultiple = exports.itemFromSingleOrMultiple = exports.executeOnSingleOrMultiple = exports.rectBounce = exports.circleBounce = exports.circleBounceDataFromParticle = exports.divMode = exports.singleDivModeExecute = exports.divModeExecute = exports.isDivModeEnabled = exports.deepExtend = exports.calculateBounds = exports.areBoundsInside = exports.isPointInside = exports.itemFromArray = exports.arrayRandomIndex = exports.loadFont = exports.isInArray = exports.safeMutationObserver = exports.safeIntersectionObserver = exports.safeMatchMedia = exports.hasMatchMedia = exports.isSsr = exports.getLogger = exports.setLogger = void 0;
+    exports.updateAnimation = exports.isArray = exports.isObject = exports.isFunction = exports.isNumber = exports.isString = exports.isBoolean = exports.getSize = exports.getPosition = exports.initParticleNumericAnimationValue = exports.findItemFromSingleOrMultiple = exports.itemFromSingleOrMultiple = exports.executeOnSingleOrMultiple = exports.rectBounce = exports.circleBounce = exports.circleBounceDataFromParticle = exports.divMode = exports.singleDivModeExecute = exports.divModeExecute = exports.isDivModeEnabled = exports.deepExtend = exports.calculateBounds = exports.areBoundsInside = exports.isPointInside = exports.itemFromArray = exports.arrayRandomIndex = exports.loadFont = exports.isInArray = exports.safeMutationObserver = exports.safeIntersectionObserver = exports.safeMatchMedia = exports.hasMatchMedia = exports.isSsr = exports.getLogger = exports.setLogger = void 0;
     const NumberUtils_js_1 = require("./NumberUtils.js");
+    const Constants_js_1 = require("../Core/Utils/Constants.js");
     const Vector_js_1 = require("../Core/Utils/Vector.js");
     const _logger = {
         debug: console.debug,
@@ -34,15 +35,15 @@
     }
     exports.getLogger = getLogger;
     function rectSideBounce(data) {
-        const res = { bounced: false }, { pSide, pOtherSide, rectSide, rectOtherSide, velocity, factor } = data;
+        const res = { bounced: false }, { pSide, pOtherSide, rectSide, rectOtherSide, velocity, factor } = data, half = 0.5, minVelocity = 0;
         if (pOtherSide.min < rectOtherSide.min ||
             pOtherSide.min > rectOtherSide.max ||
             pOtherSide.max < rectOtherSide.min ||
             pOtherSide.max > rectOtherSide.max) {
             return res;
         }
-        if ((pSide.max >= rectSide.min && pSide.max <= (rectSide.max + rectSide.min) * 0.5 && velocity > 0) ||
-            (pSide.min <= rectSide.max && pSide.min > (rectSide.max + rectSide.min) * 0.5 && velocity < 0)) {
+        if ((pSide.max >= rectSide.min && pSide.max <= (rectSide.max + rectSide.min) * half && velocity > minVelocity) ||
+            (pSide.min <= rectSide.max && pSide.min > (rectSide.max + rectSide.min) * half && velocity < minVelocity)) {
             res.velocity = velocity * -factor;
             res.bounced = true;
         }
@@ -84,7 +85,8 @@
     }
     exports.safeMutationObserver = safeMutationObserver;
     function isInArray(value, array) {
-        return value === array || (isArray(array) && array.indexOf(value) > -1);
+        const invalidIndex = -1;
+        return value === array || (isArray(array) && array.indexOf(value) > invalidIndex);
     }
     exports.isInArray = isInArray;
     async function loadFont(font, weight) {
@@ -104,7 +106,8 @@
     }
     exports.itemFromArray = itemFromArray;
     function isPointInside(point, size, offset, radius, direction) {
-        return areBoundsInside(calculateBounds(point, radius ?? 0), size, offset, direction);
+        const minRadius = 0;
+        return areBoundsInside(calculateBounds(point, radius ?? minRadius), size, offset, direction);
     }
     exports.isPointInside = isPointInside;
     function areBoundsInside(bounds, size, offset, direction) {
@@ -203,8 +206,8 @@
     }
     exports.circleBounceDataFromParticle = circleBounceDataFromParticle;
     function circleBounce(p1, p2) {
-        const { x: xVelocityDiff, y: yVelocityDiff } = p1.velocity.sub(p2.velocity), [pos1, pos2] = [p1.position, p2.position], { dx: xDist, dy: yDist } = (0, NumberUtils_js_1.getDistances)(pos2, pos1);
-        if (xVelocityDiff * xDist + yVelocityDiff * yDist < 0) {
+        const { x: xVelocityDiff, y: yVelocityDiff } = p1.velocity.sub(p2.velocity), [pos1, pos2] = [p1.position, p2.position], { dx: xDist, dy: yDist } = (0, NumberUtils_js_1.getDistances)(pos2, pos1), minimumDistance = 0;
+        if (xVelocityDiff * xDist + yVelocityDiff * yDist < minimumDistance) {
             return;
         }
         const angle = -Math.atan2(yDist, xDist), m1 = p1.mass, m2 = p2.mass, u1 = p1.velocity.rotate(angle), u2 = p2.velocity.rotate(angle), v1 = (0, NumberUtils_js_1.collisionVelocity)(u1, u2, m1, m2), v2 = (0, NumberUtils_js_1.collisionVelocity)(u2, u1, m1, m2), vFinal1 = v1.rotate(-angle), vFinal2 = v2.rotate(-angle);
@@ -274,7 +277,8 @@
     }
     exports.rectBounce = rectBounce;
     function executeOnSingleOrMultiple(obj, callback) {
-        return isArray(obj) ? obj.map((item, index) => callback(item, index)) : callback(obj, 0);
+        const defaultIndex = 0;
+        return isArray(obj) ? obj.map((item, index) => callback(item, index)) : callback(obj, defaultIndex);
     }
     exports.executeOnSingleOrMultiple = executeOnSingleOrMultiple;
     function itemFromSingleOrMultiple(obj, index, useIndex) {
@@ -282,12 +286,16 @@
     }
     exports.itemFromSingleOrMultiple = itemFromSingleOrMultiple;
     function findItemFromSingleOrMultiple(obj, callback) {
-        return isArray(obj) ? obj.find((t, index) => callback(t, index)) : callback(obj, 0) ? obj : undefined;
+        if (isArray(obj)) {
+            return obj.find((t, index) => callback(t, index));
+        }
+        const defaultIndex = 0;
+        return callback(obj, defaultIndex) ? obj : undefined;
     }
     exports.findItemFromSingleOrMultiple = findItemFromSingleOrMultiple;
     function initParticleNumericAnimationValue(options, pxRatio) {
         const valueRange = options.value, animationOptions = options.animation, res = {
-            delayTime: (0, NumberUtils_js_1.getRangeValue)(animationOptions.delay) * 1000,
+            delayTime: (0, NumberUtils_js_1.getRangeValue)(animationOptions.delay) * Constants_js_1.millisecondsToSeconds,
             enable: animationOptions.enable,
             value: (0, NumberUtils_js_1.getRangeValue)(options.value) * pxRatio,
             max: (0, NumberUtils_js_1.getRangeMax)(valueRange) * pxRatio,
@@ -295,9 +303,9 @@
             loops: 0,
             maxLoops: (0, NumberUtils_js_1.getRangeValue)(animationOptions.count),
             time: 0,
-        };
+        }, decayOffset = 1;
         if (animationOptions.enable) {
-            res.decay = 1 - (0, NumberUtils_js_1.getRangeValue)(animationOptions.decay);
+            res.decay = decayOffset - (0, NumberUtils_js_1.getRangeValue)(animationOptions.decay);
             switch (animationOptions.mode) {
                 case "increase":
                     res.status = "increasing";
@@ -306,7 +314,7 @@
                     res.status = "decreasing";
                     break;
                 case "random":
-                    res.status = (0, NumberUtils_js_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
+                    res.status = (0, NumberUtils_js_1.getRandom)() >= Constants_js_1.halfRandom ? "increasing" : "decreasing";
                     break;
             }
             const autoStatus = animationOptions.mode === "auto";
@@ -327,7 +335,7 @@
                 default:
                     res.value = (0, NumberUtils_js_1.randomInRange)(res);
                     if (autoStatus) {
-                        res.status = (0, NumberUtils_js_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
+                        res.status = (0, NumberUtils_js_1.getRandom)() >= Constants_js_1.halfRandom ? "increasing" : "decreasing";
                     }
                     break;
             }
@@ -345,14 +353,14 @@
         const isPosition = "x" in positionOrSize;
         if (isPosition) {
             return {
-                x: (positionOrSize.x / 100) * canvasSize.width,
-                y: (positionOrSize.y / 100) * canvasSize.height,
+                x: (positionOrSize.x / Constants_js_1.percentDenominator) * canvasSize.width,
+                y: (positionOrSize.y / Constants_js_1.percentDenominator) * canvasSize.height,
             };
         }
         else {
             return {
-                width: (positionOrSize.width / 100) * canvasSize.width,
-                height: (positionOrSize.height / 100) * canvasSize.height,
+                width: (positionOrSize.width / Constants_js_1.percentDenominator) * canvasSize.width,
+                height: (positionOrSize.height / Constants_js_1.percentDenominator) * canvasSize.height,
             };
         }
     }
@@ -388,4 +396,80 @@
         return Array.isArray(arg);
     }
     exports.isArray = isArray;
+    function checkDestroy(particle, destroyType, value, minValue, maxValue) {
+        switch (destroyType) {
+            case "max":
+                if (value >= maxValue) {
+                    particle.destroy();
+                }
+                break;
+            case "min":
+                if (value <= minValue) {
+                    particle.destroy();
+                }
+                break;
+        }
+    }
+    function updateAnimation(particle, data, changeDirection, destroyType, delta) {
+        const minLoops = 0, minDelay = 0, identity = 1, minVelocity = 0, minDecay = 1;
+        if (particle.destroyed ||
+            !data ||
+            !data.enable ||
+            ((data.maxLoops ?? minLoops) > minLoops && (data.loops ?? minLoops) > (data.maxLoops ?? minLoops))) {
+            return;
+        }
+        const velocity = (data.velocity ?? minVelocity) * delta.factor, minValue = data.min, maxValue = data.max, decay = data.decay ?? minDecay;
+        if (!data.time) {
+            data.time = 0;
+        }
+        if ((data.delayTime ?? minDelay) > minDelay && data.time < (data.delayTime ?? minDelay)) {
+            data.time += delta.value;
+        }
+        if ((data.delayTime ?? minDelay) > minDelay && data.time < (data.delayTime ?? minDelay)) {
+            return;
+        }
+        switch (data.status) {
+            case "increasing":
+                if (data.value >= maxValue) {
+                    if (changeDirection) {
+                        data.status = "decreasing";
+                    }
+                    else {
+                        data.value -= maxValue;
+                    }
+                    if (!data.loops) {
+                        data.loops = minLoops;
+                    }
+                    data.loops++;
+                }
+                else {
+                    data.value += velocity;
+                }
+                break;
+            case "decreasing":
+                if (data.value <= minValue) {
+                    if (changeDirection) {
+                        data.status = "increasing";
+                    }
+                    else {
+                        data.value += maxValue;
+                    }
+                    if (!data.loops) {
+                        data.loops = minLoops;
+                    }
+                    data.loops++;
+                }
+                else {
+                    data.value -= velocity;
+                }
+        }
+        if (data.velocity && decay !== identity) {
+            data.velocity *= decay;
+        }
+        checkDestroy(particle, destroyType, data.value, minValue, maxValue);
+        if (!particle.destroyed) {
+            data.value = (0, NumberUtils_js_1.clamp)(data.value, minValue, maxValue);
+        }
+    }
+    exports.updateAnimation = updateAnimation;
 });