@tsparticles/engine 3.0.0-alpha.1 → 3.0.0-beta.1

package/umd/Utils/NumberUtils.js

@@ -4,19 +4,21 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../Core/Utils/Vector"], factory);
+        define(["require", "exports", "./Utils.js", "../Core/Utils/Vector.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.getValue = 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_1 = require("../Core/Utils/Vector");
+    const Utils_js_1 = require("./Utils.js");
+    const Vector_js_1 = require("../Core/Utils/Vector.js");
     let _random = Math.random;
     const easings = new Map();
     function addEasing(name, easing) {
-        if (!easings.get(name)) {
-            easings.set(name, easing);
+        if (easings.get(name)) {
+            return;
         }
+        easings.set(name, easing);
     }
     exports.addEasing = addEasing;
     function getEasing(name) {
@@ -49,19 +51,19 @@
     }
     exports.randomInRange = randomInRange;
     function getRangeValue(value) {
-        return typeof value === "number" ? value : randomInRange(value);
+        return (0, Utils_js_1.isNumber)(value) ? value : randomInRange(value);
     }
     exports.getRangeValue = getRangeValue;
     function getRangeMin(value) {
-        return typeof value === "number" ? value : value.min;
+        return (0, Utils_js_1.isNumber)(value) ? value : value.min;
     }
     exports.getRangeMin = getRangeMin;
     function getRangeMax(value) {
-        return typeof value === "number" ? value : value.max;
+        return (0, Utils_js_1.isNumber)(value) ? value : value.max;
     }
     exports.getRangeMax = getRangeMax;
     function setRangeValue(source, value) {
-        if (source === value || (value === undefined && typeof source === "number")) {
+        if (source === value || (value === undefined && (0, Utils_js_1.isNumber)(source))) {
             return source;
         }
         const min = getRangeMin(source), max = getRangeMax(source);
@@ -74,7 +76,7 @@
     }
     exports.setRangeValue = setRangeValue;
     function getValue(options) {
-        const random = options.random, { enable, minimumValue } = typeof random === "boolean"
+        const random = options.random, { enable, minimumValue } = (0, Utils_js_1.isBoolean)(random)
             ? {
                 enable: random,
                 minimumValue: 0,
@@ -93,46 +95,44 @@
     }
     exports.getDistance = getDistance;
     function getParticleDirectionAngle(direction, position, center) {
-        if (typeof direction === "number") {
+        if ((0, Utils_js_1.isNumber)(direction)) {
             return (direction * Math.PI) / 180;
         }
-        else {
-            switch (direction) {
-                case "top":
-                    return -Math.PI / 2;
-                case "top-right":
-                    return -Math.PI / 4;
-                case "right":
-                    return 0;
-                case "bottom-right":
-                    return Math.PI / 4;
-                case "bottom":
-                    return Math.PI / 2;
-                case "bottom-left":
-                    return (3 * Math.PI) / 4;
-                case "left":
-                    return Math.PI;
-                case "top-left":
-                    return (-3 * Math.PI) / 4;
-                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;
-            }
+        switch (direction) {
+            case "top":
+                return -Math.PI / 2;
+            case "top-right":
+                return -Math.PI / 4;
+            case "right":
+                return 0;
+            case "bottom-right":
+                return Math.PI / 4;
+            case "bottom":
+                return Math.PI / 2;
+            case "bottom-left":
+                return (3 * Math.PI) / 4;
+            case "left":
+                return Math.PI;
+            case "top-left":
+                return (-3 * Math.PI) / 4;
+            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;
         }
     }
     exports.getParticleDirectionAngle = getParticleDirectionAngle;
     function getParticleBaseVelocity(direction) {
-        const baseVelocity = Vector_1.Vector.origin;
+        const baseVelocity = Vector_js_1.Vector.origin;
         baseVelocity.length = 1;
         baseVelocity.angle = direction;
         return baseVelocity;
     }
     exports.getParticleBaseVelocity = getParticleBaseVelocity;
     function collisionVelocity(v1, v2, m1, m2) {
-        return Vector_1.Vector.create((v1.x * (m1 - m2)) / (m1 + m2) + (v2.x * 2 * m2) / (m1 + m2), v1.y);
+        return Vector_js_1.Vector.create((v1.x * (m1 - m2)) / (m1 + m2) + (v2.x * 2 * m2) / (m1 + m2), v1.y);
     }
     exports.collisionVelocity = collisionVelocity;
     function calcPositionFromSize(data) {
@@ -145,35 +145,31 @@
     }
     exports.calcPositionFromSize = calcPositionFromSize;
     function calcPositionOrRandomFromSize(data) {
-        var _a, _b, _c, _d;
         return {
-            x: (((_b = (_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : getRandom() * 100) * data.size.width) / 100,
-            y: (((_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : getRandom() * 100) * data.size.height) / 100,
+            x: ((data.position?.x ?? getRandom() * 100) * data.size.width) / 100,
+            y: ((data.position?.y ?? getRandom() * 100) * data.size.height) / 100,
         };
     }
     exports.calcPositionOrRandomFromSize = calcPositionOrRandomFromSize;
     function calcPositionOrRandomFromSizeRanged(data) {
-        var _a, _b;
         const position = {
-            x: ((_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== undefined ? getRangeValue(data.position.x) : undefined,
-            y: ((_b = data.position) === null || _b === void 0 ? void 0 : _b.y) !== undefined ? getRangeValue(data.position.y) : undefined,
+            x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
+            y: data.position?.y !== undefined ? getRangeValue(data.position.y) : undefined,
         };
         return calcPositionOrRandomFromSize({ size: data.size, position });
     }
     exports.calcPositionOrRandomFromSizeRanged = calcPositionOrRandomFromSizeRanged;
     function calcExactPositionOrRandomFromSize(data) {
-        var _a, _b, _c, _d;
         return {
-            x: (_b = (_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : getRandom() * data.size.width,
-            y: (_d = (_c = data.position) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : getRandom() * data.size.height,
+            x: data.position?.x ?? getRandom() * data.size.width,
+            y: data.position?.y ?? getRandom() * data.size.height,
         };
     }
     exports.calcExactPositionOrRandomFromSize = calcExactPositionOrRandomFromSize;
     function calcExactPositionOrRandomFromSizeRanged(data) {
-        var _a, _b;
         const position = {
-            x: ((_a = data.position) === null || _a === void 0 ? void 0 : _a.x) !== undefined ? getRangeValue(data.position.x) : undefined,
-            y: ((_b = data.position) === null || _b === void 0 ? void 0 : _b.y) !== undefined ? getRangeValue(data.position.y) : undefined,
+            x: data.position?.x !== undefined ? getRangeValue(data.position.x) : undefined,
+            y: data.position?.y !== undefined ? getRangeValue(data.position.y) : undefined,
         };
         return calcExactPositionOrRandomFromSize({ size: data.size, position });
     }

package/umd/Utils/OptionsUtils.js

@@ -4,13 +4,13 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../Options/Classes/Particles/ParticlesOptions"], factory);
+        define(["require", "exports", "../Options/Classes/Particles/ParticlesOptions.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.loadParticlesOptions = exports.loadOptions = void 0;
-    const ParticlesOptions_1 = require("../Options/Classes/Particles/ParticlesOptions");
+    const ParticlesOptions_js_1 = require("../Options/Classes/Particles/ParticlesOptions.js");
     function loadOptions(options, ...sourceOptionsArr) {
         for (const sourceOptions of sourceOptionsArr) {
             options.load(sourceOptions);
@@ -18,7 +18,7 @@
     }
     exports.loadOptions = loadOptions;
     function loadParticlesOptions(engine, container, ...sourceOptionsArr) {
-        const options = new ParticlesOptions_1.ParticlesOptions(engine, container);
+        const options = new ParticlesOptions_js_1.ParticlesOptions(engine, container);
         loadOptions(options, ...sourceOptionsArr);
         return options;
     }

package/umd/Utils/RgbColorManager.js

@@ -4,33 +4,31 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./NumberUtils"], factory);
+        define(["require", "exports", "./NumberUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.RgbColorManager = void 0;
-    const NumberUtils_1 = require("./NumberUtils");
+    const NumberUtils_js_1 = require("./NumberUtils.js");
     class RgbColorManager {
         constructor() {
             this.key = "rgb";
             this.stringPrefix = "rgb";
         }
         handleColor(color) {
-            var _a;
-            const colorValue = color.value, rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
+            const colorValue = color.value, rgbColor = colorValue.rgb ?? color.value;
             if (rgbColor.r !== undefined) {
                 return rgbColor;
             }
         }
         handleRangeColor(color) {
-            var _a;
-            const colorValue = color.value, rgbColor = (_a = colorValue.rgb) !== null && _a !== void 0 ? _a : color.value;
+            const colorValue = color.value, rgbColor = colorValue.rgb ?? color.value;
             if (rgbColor.r !== undefined) {
                 return {
-                    r: (0, NumberUtils_1.getRangeValue)(rgbColor.r),
-                    g: (0, NumberUtils_1.getRangeValue)(rgbColor.g),
-                    b: (0, NumberUtils_1.getRangeValue)(rgbColor.b),
+                    r: (0, NumberUtils_js_1.getRangeValue)(rgbColor.r),
+                    g: (0, NumberUtils_js_1.getRangeValue)(rgbColor.g),
+                    b: (0, NumberUtils_js_1.getRangeValue)(rgbColor.b),
                 };
             }
         }
@@ -41,7 +39,7 @@
             const regex = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*([\d.%]+)\s*)?\)/i, result = regex.exec(input);
             return result
                 ? {
-                    a: result.length > 4 ? (0, NumberUtils_1.parseAlpha)(result[5]) : 1,
+                    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),

package/umd/Utils/Utils.js

@@ -4,16 +4,37 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./NumberUtils", "../Core/Utils/Vector"], factory);
+        define(["require", "exports", "./NumberUtils.js", "../Core/Utils/Vector.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    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.cancelAnimation = exports.animate = exports.safeMatchMedia = exports.hasMatchMedia = exports.isSsr = void 0;
-    const NumberUtils_1 = require("./NumberUtils");
-    const Vector_1 = require("../Core/Utils/Vector");
-    function rectSideBounce(pSide, pOtherSide, rectSide, rectOtherSide, velocity, factor) {
-        const res = { bounced: false };
+    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.safeMatchMedia = exports.hasMatchMedia = exports.isSsr = exports.getLogger = exports.setLogger = void 0;
+    const NumberUtils_js_1 = require("./NumberUtils.js");
+    const Vector_js_1 = require("../Core/Utils/Vector.js");
+    const _logger = {
+        debug: console.debug,
+        error: console.error,
+        info: console.info,
+        log: console.log,
+        verbose: console.log,
+        warning: console.warn,
+    };
+    function setLogger(logger) {
+        _logger.debug = logger.debug || _logger.debug;
+        _logger.error = logger.error || _logger.error;
+        _logger.info = logger.info || _logger.info;
+        _logger.log = logger.log || _logger.log;
+        _logger.verbose = logger.verbose || _logger.verbose;
+        _logger.warning = logger.warning || _logger.warning;
+    }
+    exports.setLogger = setLogger;
+    function getLogger() {
+        return _logger;
+    }
+    exports.getLogger = getLogger;
+    function rectSideBounce(data) {
+        const res = { bounced: false }, { pSide, pOtherSide, rectSide, rectOtherSide, velocity, factor } = data;
         if (pOtherSide.min < rectOtherSide.min ||
             pOtherSide.min > rectOtherSide.max ||
             pOtherSide.max < rectOtherSide.min ||
@@ -31,7 +52,7 @@
         const res = executeOnSingleOrMultiple(selectors, (selector) => {
             return element.matches(selector);
         });
-        return res instanceof Array ? res.some((t) => t) : res;
+        return isArray(res) ? res.some((t) => t) : res;
     }
     function isSsr() {
         return typeof window === "undefined" || !window || typeof window.document === "undefined" || !window.document;
@@ -48,32 +69,27 @@
         return matchMedia(query);
     }
     exports.safeMatchMedia = safeMatchMedia;
-    function animate() {
-        return isSsr()
-            ? (callback) => setTimeout(callback)
-            : (callback) => (requestAnimationFrame || setTimeout)(callback);
-    }
-    exports.animate = animate;
-    function cancelAnimation() {
-        return isSsr()
-            ? (handle) => clearTimeout(handle)
-            : (handle) => (cancelAnimationFrame || clearTimeout)(handle);
-    }
-    exports.cancelAnimation = cancelAnimation;
+    function safeMutationObserver(callback) {
+        if (isSsr() || typeof MutationObserver === "undefined") {
+            return;
+        }
+        return new MutationObserver(callback);
+    }
+    exports.safeMutationObserver = safeMutationObserver;
     function isInArray(value, array) {
-        return value === array || (array instanceof Array && array.indexOf(value) > -1);
+        return value === array || (isArray(array) && array.indexOf(value) > -1);
     }
     exports.isInArray = isInArray;
     async function loadFont(font, weight) {
         try {
-            await document.fonts.load(`${weight !== null && weight !== void 0 ? weight : "400"} 36px '${font !== null && font !== void 0 ? font : "Verdana"}'`);
+            await document.fonts.load(`${weight ?? "400"} 36px '${font ?? "Verdana"}'`);
         }
-        catch (_a) {
+        catch {
         }
     }
     exports.loadFont = loadFont;
     function arrayRandomIndex(array) {
-        return Math.floor((0, NumberUtils_1.getRandom)() * array.length);
+        return Math.floor((0, NumberUtils_js_1.getRandom)() * array.length);
     }
     exports.arrayRandomIndex = arrayRandomIndex;
     function itemFromArray(array, index, useIndex = true) {
@@ -81,7 +97,7 @@
     }
     exports.itemFromArray = itemFromArray;
     function isPointInside(point, size, offset, radius, direction) {
-        return areBoundsInside(calculateBounds(point, radius !== null && radius !== void 0 ? radius : 0), size, offset, direction);
+        return areBoundsInside(calculateBounds(point, radius ?? 0), size, offset, direction);
     }
     exports.isPointInside = isPointInside;
     function areBoundsInside(bounds, size, offset, direction) {
@@ -115,24 +131,24 @@
             if (source === undefined || source === null) {
                 continue;
             }
-            if (typeof source !== "object") {
+            if (!isObject(source)) {
                 destination = source;
                 continue;
             }
             const sourceIsArray = Array.isArray(source);
-            if (sourceIsArray && (typeof destination !== "object" || !destination || !Array.isArray(destination))) {
+            if (sourceIsArray && (isObject(destination) || !destination || !Array.isArray(destination))) {
                 destination = [];
             }
-            else if (!sourceIsArray && (typeof destination !== "object" || !destination || Array.isArray(destination))) {
+            else if (!sourceIsArray && (isObject(destination) || !destination || Array.isArray(destination))) {
                 destination = {};
             }
             for (const key in source) {
                 if (key === "__proto__") {
                     continue;
                 }
-                const sourceDict = source, value = sourceDict[key], isObject = typeof value === "object", destDict = destination;
+                const sourceDict = source, value = sourceDict[key], destDict = destination;
                 destDict[key] =
-                    isObject && Array.isArray(value)
+                    isObject(value) && Array.isArray(value)
                         ? value.map((v) => deepExtend(destDict[key], v))
                         : deepExtend(destDict[key], value);
             }
@@ -175,16 +191,16 @@
             radius: p.getRadius(),
             mass: p.getMass(),
             velocity: p.velocity,
-            factor: Vector_1.Vector.create((0, NumberUtils_1.getValue)(p.options.bounce.horizontal), (0, NumberUtils_1.getValue)(p.options.bounce.vertical)),
+            factor: Vector_js_1.Vector.create((0, NumberUtils_js_1.getValue)(p.options.bounce.horizontal), (0, NumberUtils_js_1.getValue)(p.options.bounce.vertical)),
         };
     }
     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_1.getDistances)(pos2, pos1);
+        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) {
             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_1.collisionVelocity)(u1, u2, m1, m2), v2 = (0, NumberUtils_1.collisionVelocity)(u2, u1, m1, m2), vFinal1 = v1.rotate(-angle), vFinal2 = v2.rotate(-angle);
+        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);
         p1.velocity.x = vFinal1.x * p1.factor.x;
         p1.velocity.y = vFinal1.y * p1.factor.y;
         p2.velocity.x = vFinal2.x * p2.factor.x;
@@ -193,18 +209,25 @@
     exports.circleBounce = circleBounce;
     function rectBounce(particle, divBounds) {
         const pPos = particle.getPosition(), size = particle.getRadius(), bounds = calculateBounds(pPos, size), resH = rectSideBounce({
-            min: bounds.left,
-            max: bounds.right,
-        }, {
-            min: bounds.top,
-            max: bounds.bottom,
-        }, {
-            min: divBounds.left,
-            max: divBounds.right,
-        }, {
-            min: divBounds.top,
-            max: divBounds.bottom,
-        }, particle.velocity.x, (0, NumberUtils_1.getValue)(particle.options.bounce.horizontal));
+            pSide: {
+                min: bounds.left,
+                max: bounds.right,
+            },
+            pOtherSide: {
+                min: bounds.top,
+                max: bounds.bottom,
+            },
+            rectSide: {
+                min: divBounds.left,
+                max: divBounds.right,
+            },
+            rectOtherSide: {
+                min: divBounds.top,
+                max: divBounds.bottom,
+            },
+            velocity: particle.velocity.x,
+            factor: (0, NumberUtils_js_1.getValue)(particle.options.bounce.horizontal),
+        });
         if (resH.bounced) {
             if (resH.velocity !== undefined) {
                 particle.velocity.x = resH.velocity;
@@ -214,18 +237,25 @@
             }
         }
         const resV = rectSideBounce({
-            min: bounds.top,
-            max: bounds.bottom,
-        }, {
-            min: bounds.left,
-            max: bounds.right,
-        }, {
-            min: divBounds.top,
-            max: divBounds.bottom,
-        }, {
-            min: divBounds.left,
-            max: divBounds.right,
-        }, particle.velocity.y, (0, NumberUtils_1.getValue)(particle.options.bounce.vertical));
+            pSide: {
+                min: bounds.top,
+                max: bounds.bottom,
+            },
+            pOtherSide: {
+                min: bounds.left,
+                max: bounds.right,
+            },
+            rectSide: {
+                min: divBounds.top,
+                max: divBounds.bottom,
+            },
+            rectOtherSide: {
+                min: divBounds.left,
+                max: divBounds.right,
+            },
+            velocity: particle.velocity.y,
+            factor: (0, NumberUtils_js_1.getValue)(particle.options.bounce.vertical),
+        });
         if (resV.bounced) {
             if (resV.velocity !== undefined) {
                 particle.velocity.y = resV.velocity;
@@ -237,30 +267,30 @@
     }
     exports.rectBounce = rectBounce;
     function executeOnSingleOrMultiple(obj, callback) {
-        return obj instanceof Array ? obj.map((item, index) => callback(item, index)) : callback(obj, 0);
+        return isArray(obj) ? obj.map((item, index) => callback(item, index)) : callback(obj, 0);
     }
     exports.executeOnSingleOrMultiple = executeOnSingleOrMultiple;
     function itemFromSingleOrMultiple(obj, index, useIndex) {
-        return obj instanceof Array ? itemFromArray(obj, index, useIndex) : obj;
+        return isArray(obj) ? itemFromArray(obj, index, useIndex) : obj;
     }
     exports.itemFromSingleOrMultiple = itemFromSingleOrMultiple;
     function findItemFromSingleOrMultiple(obj, callback) {
-        return obj instanceof Array ? obj.find((t, index) => callback(t, index)) : callback(obj, 0) ? obj : undefined;
+        return isArray(obj) ? obj.find((t, index) => callback(t, index)) : callback(obj, 0) ? obj : undefined;
     }
     exports.findItemFromSingleOrMultiple = findItemFromSingleOrMultiple;
     function initParticleNumericAnimationValue(options, pxRatio) {
-        const valueRange = options.value, animationOptions = options.animation;
-        const res = {
-            enable: options.animation.enable,
-            value: (0, NumberUtils_1.getRangeValue)(options.value) * pxRatio,
-            max: (0, NumberUtils_1.getRangeMax)(valueRange) * pxRatio,
-            min: (0, NumberUtils_1.getRangeMin)(valueRange) * pxRatio,
+        const valueRange = options.value, animationOptions = options.animation, res = {
+            delayTime: (0, NumberUtils_js_1.getRangeValue)(animationOptions.delay) * 1000,
+            enable: animationOptions.enable,
+            value: (0, NumberUtils_js_1.getRangeValue)(options.value) * pxRatio,
+            max: (0, NumberUtils_js_1.getRangeMax)(valueRange) * pxRatio,
+            min: (0, NumberUtils_js_1.getRangeMin)(valueRange) * pxRatio,
             loops: 0,
-            maxLoops: (0, NumberUtils_1.getRangeValue)(options.animation.count),
+            maxLoops: (0, NumberUtils_js_1.getRangeValue)(animationOptions.count),
+            time: 0,
         };
         if (animationOptions.enable) {
-            res.decay = 1 - (0, NumberUtils_1.getRangeValue)(animationOptions.decay);
-            let autoStatus = false;
+            res.decay = 1 - (0, NumberUtils_js_1.getRangeValue)(animationOptions.decay);
             switch (animationOptions.mode) {
                 case "increase":
                     res.status = "increasing";
@@ -269,12 +299,10 @@
                     res.status = "decreasing";
                     break;
                 case "random":
-                    res.status = (0, NumberUtils_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
-                    break;
-                case "auto":
-                    autoStatus = true;
+                    res.status = (0, NumberUtils_js_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
                     break;
             }
+            const autoStatus = animationOptions.mode === "auto";
             switch (animationOptions.startValue) {
                 case "min":
                     res.value = res.min;
@@ -282,17 +310,17 @@
                         res.status = "increasing";
                     }
                     break;
-                case "random":
-                    res.value = (0, NumberUtils_1.randomInRange)(res);
+                case "max":
+                    res.value = res.max;
                     if (autoStatus) {
-                        res.status = (0, NumberUtils_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
+                        res.status = "decreasing";
                     }
                     break;
-                case "max":
+                case "random":
                 default:
-                    res.value = res.max;
+                    res.value = (0, NumberUtils_js_1.randomInRange)(res);
                     if (autoStatus) {
-                        res.status = "decreasing";
+                        res.status = (0, NumberUtils_js_1.getRandom)() >= 0.5 ? "increasing" : "decreasing";
                     }
                     break;
             }
@@ -301,4 +329,56 @@
         return res;
     }
     exports.initParticleNumericAnimationValue = initParticleNumericAnimationValue;
+    function getPositionOrSize(positionOrSize, canvasSize) {
+        const isPercent = positionOrSize.mode === "percent";
+        if (!isPercent) {
+            const { mode: _, ...rest } = positionOrSize;
+            return rest;
+        }
+        const isPosition = "x" in positionOrSize;
+        if (isPosition) {
+            return {
+                x: (positionOrSize.x / 100) * canvasSize.width,
+                y: (positionOrSize.y / 100) * canvasSize.height,
+            };
+        }
+        else {
+            return {
+                width: (positionOrSize.width / 100) * canvasSize.width,
+                height: (positionOrSize.height / 100) * canvasSize.height,
+            };
+        }
+    }
+    function getPosition(position, canvasSize) {
+        return getPositionOrSize(position, canvasSize);
+    }
+    exports.getPosition = getPosition;
+    function getSize(size, canvasSize) {
+        return getPositionOrSize(size, canvasSize);
+    }
+    exports.getSize = getSize;
+    function isBoolean(arg) {
+        return typeof arg === "boolean";
+    }
+    exports.isBoolean = isBoolean;
+    function isString(arg) {
+        return typeof arg === "string";
+    }
+    exports.isString = isString;
+    function isNumber(arg) {
+        return typeof arg === "number";
+    }
+    exports.isNumber = isNumber;
+    function isFunction(arg) {
+        return typeof arg === "function";
+    }
+    exports.isFunction = isFunction;
+    function isObject(arg) {
+        return typeof arg === "object" && arg !== null;
+    }
+    exports.isObject = isObject;
+    function isArray(arg) {
+        return Array.isArray(arg);
+    }
+    exports.isArray = isArray;
 });