@tsparticles/engine 3.0.3 → 3.2.0

package/cjs/Core/Particle.js

@@ -3,13 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Particle = void 0;
 const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 const Utils_js_1 = require("../Utils/Utils.js");
+const Constants_js_1 = require("./Utils/Constants.js");
 const ColorUtils_js_1 = require("../Utils/ColorUtils.js");
 const Interactivity_js_1 = require("../Options/Classes/Interactivity/Interactivity.js");
 const Vector_js_1 = require("./Utils/Vector.js");
 const Vector3d_js_1 = require("./Utils/Vector3d.js");
 const CanvasUtils_js_1 = require("../Utils/CanvasUtils.js");
-const Constants_js_1 = require("./Utils/Constants.js");
 const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
+const defaultRetryCount = 0, double = 2, half = 0.5, squareExp = 2;
 function loadEffectData(effect, effectOptions, id, reduceDuplicates) {
     const effectData = effectOptions.options[effect];
     if (!effectData) {
@@ -34,7 +35,7 @@ function fixOutMode(data) {
     if (!(0, Utils_js_1.isInArray)(data.outMode, data.checkModes)) {
         return;
     }
-    const diameter = data.radius * 2;
+    const diameter = data.radius * double;
     if (data.coord > data.maxCoord - diameter) {
         data.setCb(-data.radius);
     }
@@ -43,9 +44,9 @@ function fixOutMode(data) {
     }
 }
 class Particle {
-    constructor(engine, id, container, position, overrideOptions, group) {
+    constructor(engine, container) {
         this.container = container;
-        this._calcPosition = (container, position, zIndex, tryCount = 0) => {
+        this._calcPosition = (container, position, zIndex, tryCount = defaultRetryCount) => {
             for (const [, plugin] of container.plugins) {
                 const pluginPos = plugin.particlePosition !== undefined ? plugin.particlePosition(position, this) : undefined;
                 if (pluginPos) {
@@ -58,7 +59,7 @@ class Particle {
             }), pos = Vector3d_js_1.Vector3d.create(exactPosition.x, exactPosition.y, zIndex), radius = this.getRadius(), outModes = this.options.move.outModes, fixHorizontal = (outMode) => {
                 fixOutMode({
                     outMode,
-                    checkModes: ["bounce", "bounce-horizontal"],
+                    checkModes: ["bounce"],
                     coord: pos.x,
                     maxCoord: container.canvas.size.width,
                     setCb: (value) => (pos.x += value),
@@ -67,7 +68,7 @@ class Particle {
             }, fixVertical = (outMode) => {
                 fixOutMode({
                     outMode,
-                    checkModes: ["bounce", "bounce-vertical"],
+                    checkModes: ["bounce"],
                     coord: pos.y,
                     maxCoord: container.canvas.size.height,
                     setCb: (value) => (pos.y += value),
@@ -79,7 +80,8 @@ class Particle {
             fixVertical(outModes.top ?? outModes.default);
             fixVertical(outModes.bottom ?? outModes.default);
             if (this._checkOverlap(pos, tryCount)) {
-                return this._calcPosition(container, undefined, zIndex, tryCount + 1);
+                const increment = 1;
+                return this._calcPosition(container, undefined, zIndex, tryCount + increment);
             }
             return pos;
         };
@@ -88,9 +90,9 @@ class Particle {
             if (moveOptions.direction === "inside" || moveOptions.direction === "outside") {
                 return res;
             }
-            const rad = (Math.PI / 180) * (0, NumberUtils_js_1.getRangeValue)(moveOptions.angle.value), radOffset = (Math.PI / 180) * (0, NumberUtils_js_1.getRangeValue)(moveOptions.angle.offset), range = {
-                left: radOffset - rad * 0.5,
-                right: radOffset + rad * 0.5,
+            const rad = (0, NumberUtils_js_1.degToRad)((0, NumberUtils_js_1.getRangeValue)(moveOptions.angle.value)), radOffset = (0, NumberUtils_js_1.degToRad)((0, NumberUtils_js_1.getRangeValue)(moveOptions.angle.offset)), range = {
+                left: radOffset - rad * half,
+                right: radOffset + rad * half,
             };
             if (!moveOptions.straight) {
                 res.angle += (0, NumberUtils_js_1.randomInRange)((0, NumberUtils_js_1.setRangeValue)(range.left, range.right));
@@ -100,7 +102,7 @@ class Particle {
             }
             return res;
         };
-        this._checkOverlap = (pos, tryCount = 0) => {
+        this._checkOverlap = (pos, tryCount = defaultRetryCount) => {
             const collisionsOptions = this.options.collisions, radius = this.getRadius();
             if (!collisionsOptions.enable) {
                 return false;
@@ -109,8 +111,8 @@ class Particle {
             if (overlapOptions.enable) {
                 return false;
             }
-            const retries = overlapOptions.retries;
-            if (retries >= 0 && tryCount > retries) {
+            const retries = overlapOptions.retries, minRetries = 0;
+            if (retries >= minRetries && tryCount > retries) {
                 throw new Error(`${Constants_js_1.errorPrefix} particle is overlapping and can't be placed`);
             }
             return !!this.container.particles.find((particle) => (0, NumberUtils_js_1.getDistance)(pos, particle.position) < radius + particle.getRadius());
@@ -119,7 +121,7 @@ class Particle {
             if (!color || !this.roll || (!this.backColor && !this.roll.alter)) {
                 return color;
             }
-            const backFactor = this.roll.horizontal && this.roll.vertical ? 2 : 1, backSum = this.roll.horizontal ? Math.PI * 0.5 : 0, rolled = Math.floor(((this.roll.angle ?? 0) + backSum) / (Math.PI / backFactor)) % 2;
+            const rollFactor = 1, none = 0, backFactor = this.roll.horizontal && this.roll.vertical ? double * rollFactor : rollFactor, backSum = this.roll.horizontal ? Math.PI * half : none, rolled = Math.floor(((this.roll.angle ?? none) + backSum) / (Math.PI / backFactor)) % double;
             if (!rolled) {
                 return color;
             }
@@ -132,13 +134,13 @@ class Particle {
             return color;
         };
         this._initPosition = (position) => {
-            const container = this.container, zIndexValue = (0, NumberUtils_js_1.getRangeValue)(this.options.zIndex.value);
-            this.position = this._calcPosition(container, position, (0, NumberUtils_js_1.clamp)(zIndexValue, 0, container.zLayers));
+            const container = this.container, zIndexValue = (0, NumberUtils_js_1.getRangeValue)(this.options.zIndex.value), minZ = 0;
+            this.position = this._calcPosition(container, position, (0, NumberUtils_js_1.clamp)(zIndexValue, minZ, container.zLayers));
             this.initialPosition = this.position.copy();
-            const canvasSize = container.canvas.size;
+            const canvasSize = container.canvas.size, defaultRadius = 0;
             this.moveCenter = {
                 ...(0, Utils_js_1.getPosition)(this.options.move.center, canvasSize),
-                radius: this.options.move.center.radius ?? 0,
+                radius: this.options.move.center.radius ?? defaultRadius,
                 mode: this.options.move.center.mode ?? "percent",
             };
             this.direction = (0, NumberUtils_js_1.getParticleDirectionAngle)(this.options.move.direction, this.position, this.moveCenter);
@@ -153,7 +155,6 @@ class Particle {
             this.offset = Vector_js_1.Vector.origin;
         };
         this._engine = engine;
-        this.init(id, position, overrideOptions, group);
     }
     destroy(override) {
         if (this.unbreakable || this.destroyed) {
@@ -163,14 +164,14 @@ class Particle {
         this.bubble.inRange = false;
         this.slow.inRange = false;
         const container = this.container, pathGenerator = this.pathGenerator, shapeDrawer = container.shapeDrawers.get(this.shape);
-        shapeDrawer && shapeDrawer.particleDestroy && shapeDrawer.particleDestroy(this);
+        shapeDrawer?.particleDestroy?.(this);
         for (const [, plugin] of container.plugins) {
-            plugin.particleDestroyed && plugin.particleDestroyed(this, override);
+            plugin.particleDestroyed?.(this, override);
         }
         for (const updater of container.particles.updaters) {
-            updater.particleDestroyed && updater.particleDestroyed(this, override);
+            updater.particleDestroyed?.(this, override);
         }
-        pathGenerator && pathGenerator.reset(this);
+        pathGenerator?.reset(this);
         this._engine.dispatchEvent("particleDestroyed", {
             container: this.container,
             data: {
@@ -178,18 +179,18 @@ class Particle {
             },
         });
     }
-    draw(delta) {
+    async draw(delta) {
         const container = this.container, canvas = container.canvas;
         for (const [, plugin] of container.plugins) {
-            canvas.drawParticlePlugin(plugin, this, delta);
+            await canvas.drawParticlePlugin(plugin, this, delta);
         }
-        canvas.drawParticle(this, delta);
+        await canvas.drawParticle(this, delta);
     }
     getFillColor() {
         return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.color));
     }
     getMass() {
-        return this.getRadius() ** 2 * Math.PI * 0.5;
+        return this.getRadius() ** squareExp * Math.PI * half;
     }
     getPosition() {
         return {
@@ -204,7 +205,7 @@ class Particle {
     getStrokeColor() {
         return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.strokeColor));
     }
-    init(id, position, overrideOptions, group) {
+    async init(id, position, overrideOptions, group) {
         const container = this.container, engine = this._engine;
         this.id = id;
         this.group = group;
@@ -228,14 +229,14 @@ class Particle {
         this.shape = (0, Utils_js_1.itemFromSingleOrMultiple)(shapeType, this.id, reduceDuplicates);
         const effectOptions = particlesOptions.effect, shapeOptions = particlesOptions.shape;
         if (overrideOptions) {
-            if (overrideOptions.effect && overrideOptions.effect.type) {
+            if (overrideOptions.effect?.type) {
                 const overrideEffectType = overrideOptions.effect.type, effect = (0, Utils_js_1.itemFromSingleOrMultiple)(overrideEffectType, this.id, reduceDuplicates);
                 if (effect) {
                     this.effect = effect;
                     effectOptions.load(overrideOptions.effect);
                 }
             }
-            if (overrideOptions.shape && overrideOptions.shape.type) {
+            if (overrideOptions.shape?.type) {
                 const overrideShapeType = overrideOptions.shape.type, shape = (0, Utils_js_1.itemFromSingleOrMultiple)(overrideShapeType, this.id, reduceDuplicates);
                 if (shape) {
                     this.shape = shape;
@@ -264,11 +265,11 @@ class Particle {
         this.shapeClose = shapeData?.close ?? particlesOptions.shape.close;
         this.options = particlesOptions;
         const pathOptions = this.options.move.path;
-        this.pathDelay = (0, NumberUtils_js_1.getRangeValue)(pathOptions.delay.value) * 1000;
+        this.pathDelay = (0, NumberUtils_js_1.getRangeValue)(pathOptions.delay.value) * Constants_js_1.millisecondsToSeconds;
         if (pathOptions.generator) {
             this.pathGenerator = this._engine.getPathGenerator(pathOptions.generator);
             if (this.pathGenerator && container.addPath(pathOptions.generator, this.pathGenerator)) {
-                this.pathGenerator.init(container);
+                await this.pathGenerator.init(container);
             }
         }
         container.retina.initParticle(this);
@@ -283,7 +284,8 @@ class Particle {
         this._initPosition(position);
         this.initialVelocity = this._calculateVelocity();
         this.velocity = this.initialVelocity.copy();
-        this.moveDecay = 1 - (0, NumberUtils_js_1.getRangeValue)(this.options.move.decay);
+        const decayOffset = 1;
+        this.moveDecay = decayOffset - (0, NumberUtils_js_1.getRangeValue)(this.options.move.decay);
         const particles = container.particles;
         particles.setLastZIndex(this.position.z);
         this.zIndexFactor = this.position.z / container.zLayers;
@@ -295,8 +297,8 @@ class Particle {
                 container.effectDrawers.set(this.effect, effectDrawer);
             }
         }
-        if (effectDrawer && effectDrawer.loadEffect) {
-            effectDrawer.loadEffect(this);
+        if (effectDrawer?.loadEffect) {
+            await effectDrawer.loadEffect(this);
         }
         let shapeDrawer = container.shapeDrawers.get(this.shape);
         if (!shapeDrawer) {
@@ -305,8 +307,8 @@ class Particle {
                 container.shapeDrawers.set(this.shape, shapeDrawer);
             }
         }
-        if (shapeDrawer && shapeDrawer.loadShape) {
-            shapeDrawer.loadShape(this);
+        if (shapeDrawer?.loadShape) {
+            await shapeDrawer.loadShape(this);
         }
         const sideCountFunc = shapeDrawer?.getSidesCount;
         if (sideCountFunc) {
@@ -315,19 +317,15 @@ class Particle {
         this.spawning = false;
         this.shadowColor = (0, ColorUtils_js_1.rangeColorToRgb)(this.options.shadow.color);
         for (const updater of particles.updaters) {
-            updater.init(this);
+            await updater.init(this);
         }
         for (const mover of particles.movers) {
-            mover.init && mover.init(this);
-        }
-        if (effectDrawer && effectDrawer.particleInit) {
-            effectDrawer.particleInit(container, this);
-        }
-        if (shapeDrawer && shapeDrawer.particleInit) {
-            shapeDrawer.particleInit(container, this);
+            await mover.init?.(this);
         }
+        await effectDrawer?.particleInit?.(container, this);
+        await shapeDrawer?.particleInit?.(container, this);
         for (const [, plugin] of container.plugins) {
-            plugin.particleCreated && plugin.particleCreated(this);
+            plugin.particleCreated?.(this);
         }
     }
     isInsideCanvas() {
@@ -342,7 +340,7 @@ class Particle {
     }
     reset() {
         for (const updater of this.container.particles.updaters) {
-            updater.reset && updater.reset(this);
+            updater.reset?.(this);
         }
     }
 }

package/cjs/Core/Particles.js

@@ -1,14 +1,36 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Particles = void 0;
 const Utils_js_1 = require("../Utils/Utils.js");
 const InteractionManager_js_1 = require("./Utils/InteractionManager.js");
-const Particle_js_1 = require("./Particle.js");
 const Point_js_1 = require("./Utils/Point.js");
 const QuadTree_js_1 = require("./Utils/QuadTree.js");
 const Rectangle_js_1 = require("./Utils/Rectangle.js");
 const Constants_js_1 = require("./Utils/Constants.js");
-const qTreeCapacity = 4;
+const qTreeCapacity = 4, squareExp = 2, defaultRemoveQuantity = 1;
 const qTreeRectangle = (canvasSize) => {
     const { height, width } = canvasSize, posOffset = -0.25, sizeFactor = 1.5;
     return new Rectangle_js_1.Rectangle(posOffset * width, posOffset * height, sizeFactor * width, sizeFactor * height);
@@ -20,7 +42,7 @@ class Particles {
                 this._pool.push(particle);
             }
         };
-        this._applyDensity = (options, manualCount, group) => {
+        this._applyDensity = async (options, manualCount, group) => {
             const numberOptions = options.number;
             if (!options.number.density?.enable) {
                 if (group === undefined) {
@@ -31,7 +53,7 @@ class Particles {
                 }
                 return;
             }
-            const densityFactor = this._initDensityFactor(numberOptions.density), optParticlesNumber = numberOptions.value, optParticlesLimit = numberOptions.limit.value > 0 ? numberOptions.limit.value : optParticlesNumber, particlesNumber = Math.min(optParticlesNumber, optParticlesLimit) * densityFactor + manualCount, particlesCount = Math.min(this.count, this.filter((t) => t.group === group).length);
+            const densityFactor = this._initDensityFactor(numberOptions.density), optParticlesNumber = numberOptions.value, minLimit = 0, optParticlesLimit = numberOptions.limit.value > minLimit ? numberOptions.limit.value : optParticlesNumber, particlesNumber = Math.min(optParticlesNumber, optParticlesLimit) * densityFactor + manualCount, particlesCount = Math.min(this.count, this.filter((t) => t.group === group).length);
             if (group === undefined) {
                 this._limit = numberOptions.limit.value * densityFactor;
             }
@@ -39,29 +61,28 @@ class Particles {
                 this._groupLimits.set(group, numberOptions.limit.value * densityFactor);
             }
             if (particlesCount < particlesNumber) {
-                this.push(Math.abs(particlesNumber - particlesCount), undefined, options, group);
+                await this.push(Math.abs(particlesNumber - particlesCount), undefined, options, group);
             }
             else if (particlesCount > particlesNumber) {
                 this.removeQuantity(particlesCount - particlesNumber, group);
             }
         };
         this._initDensityFactor = (densityOptions) => {
-            const container = this._container;
+            const container = this._container, defaultFactor = 1;
             if (!container.canvas.element || !densityOptions.enable) {
-                return 1;
+                return defaultFactor;
             }
             const canvas = container.canvas.element, pxRatio = container.retina.pixelRatio;
-            return (canvas.width * canvas.height) / (densityOptions.height * densityOptions.width * pxRatio ** 2);
+            return (canvas.width * canvas.height) / (densityOptions.height * densityOptions.width * pxRatio ** squareExp);
         };
-        this._pushParticle = (position, overrideOptions, group, initializer) => {
+        this._pushParticle = async (position, overrideOptions, group, initializer) => {
             try {
                 let particle = this._pool.pop();
-                if (particle) {
-                    particle.init(this._nextId, position, overrideOptions, group);
-                }
-                else {
-                    particle = new Particle_js_1.Particle(this._engine, this._nextId, this._container, position, overrideOptions, group);
+                if (!particle) {
+                    const { Particle } = await Promise.resolve().then(() => __importStar(require("./Particle.js")));
+                    particle = new Particle(this._engine, this._container);
                 }
+                await particle.init(this._nextId, position, overrideOptions, group);
                 let canAdd = true;
                 if (initializer) {
                     canAdd = initializer(particle);
@@ -82,7 +103,6 @@ class Particles {
             }
             catch (e) {
                 (0, Utils_js_1.getLogger)().warning(`${Constants_js_1.errorPrefix} adding particle: ${e}`);
-                return;
             }
         };
         this._removeParticle = (index, group, override) => {
@@ -90,9 +110,9 @@ class Particles {
             if (!particle || particle.group !== group) {
                 return false;
             }
-            const zIdx = this._zArray.indexOf(particle);
-            this._array.splice(index, 1);
-            this._zArray.splice(zIdx, 1);
+            const zIdx = this._zArray.indexOf(particle), deleteCount = 1;
+            this._array.splice(index, deleteCount);
+            this._zArray.splice(zIdx, deleteCount);
             particle.destroy(override);
             this._engine.dispatchEvent("particleRemoved", {
                 container: this._container,
@@ -114,26 +134,27 @@ class Particles {
         this._needsSort = false;
         this._lastZIndex = 0;
         this._interactionManager = new InteractionManager_js_1.InteractionManager(engine, container);
+        this._pluginsInitialized = false;
         const canvasSize = container.canvas.size;
         this.quadTree = new QuadTree_js_1.QuadTree(qTreeRectangle(canvasSize), qTreeCapacity);
-        this.movers = this._engine.getMovers(container, true);
-        this.updaters = this._engine.getUpdaters(container, true);
+        this.movers = [];
+        this.updaters = [];
     }
     get count() {
         return this._array.length;
     }
-    addManualParticles() {
+    async addManualParticles() {
         const container = this._container, options = container.actualOptions;
         for (const particle of options.manualParticles) {
-            this.addParticle(particle.position ? (0, Utils_js_1.getPosition)(particle.position, container.canvas.size) : undefined, particle.options);
+            await this.addParticle(particle.position ? (0, Utils_js_1.getPosition)(particle.position, container.canvas.size) : undefined, particle.options);
         }
     }
-    addParticle(position, overrideOptions, group, initializer) {
-        const limitOptions = this._container.actualOptions.particles.number.limit, limit = group === undefined ? this._limit : this._groupLimits.get(group) ?? this._limit, currentCount = this.count;
-        if (limit > 0) {
+    async addParticle(position, overrideOptions, group, initializer) {
+        const limitOptions = this._container.actualOptions.particles.number.limit, limit = group === undefined ? this._limit : this._groupLimits.get(group) ?? this._limit, currentCount = this.count, minLimit = 0;
+        if (limit > minLimit) {
             if (limitOptions.mode === "delete") {
-                const countToRemove = currentCount + 1 - limit;
-                if (countToRemove > 0) {
+                const countOffset = 1, minCount = 0, countToRemove = currentCount + countOffset - limit;
+                if (countToRemove > minCount) {
                     this.removeQuantity(countToRemove);
                 }
             }
@@ -143,11 +164,12 @@ class Particles {
                 }
             }
         }
-        return this._pushParticle(position, overrideOptions, group, initializer);
+        return await this._pushParticle(position, overrideOptions, group, initializer);
     }
     clear() {
         this._array = [];
         this._zArray = [];
+        this._pluginsInitialized = false;
     }
     destroy() {
         this._array = [];
@@ -160,10 +182,10 @@ class Particles {
         canvas.clear();
         await this.update(delta);
         for (const [, plugin] of container.plugins) {
-            canvas.drawPlugin(plugin, delta);
+            await canvas.drawPlugin(plugin, delta);
         }
         for (const p of this._zArray) {
-            p.draw(delta);
+            await p.draw(delta);
         }
     }
     filter(condition) {
@@ -178,13 +200,12 @@ class Particles {
     handleClickMode(mode) {
         this._interactionManager.handleClickMode(mode);
     }
-    init() {
+    async init() {
         const container = this._container, options = container.actualOptions;
         this._lastZIndex = 0;
         this._needsSort = false;
+        await this.initPlugins();
         let handled = false;
-        this.updaters = this._engine.getUpdaters(container, true);
-        this._interactionManager.init();
         for (const [, plugin] of container.plugins) {
             if (plugin.particlesInitialization !== undefined) {
                 handled = plugin.particlesInitialization();
@@ -193,55 +214,67 @@ class Particles {
                 break;
             }
         }
-        this._interactionManager.init();
-        for (const [, pathGenerator] of container.pathGenerators) {
-            pathGenerator.init(container);
-        }
-        this.addManualParticles();
+        await this.addManualParticles();
         if (!handled) {
             const particlesOptions = options.particles, groups = particlesOptions.groups;
             for (const group in groups) {
                 const groupOptions = groups[group];
                 for (let i = this.count, j = 0; j < groupOptions.number?.value && i < particlesOptions.number.value; i++, j++) {
-                    this.addParticle(undefined, groupOptions, group);
+                    await this.addParticle(undefined, groupOptions, group);
                 }
             }
             for (let i = this.count; i < particlesOptions.number.value; i++) {
-                this.addParticle();
+                await this.addParticle();
             }
         }
     }
-    push(nb, mouse, overrideOptions, group) {
+    async initPlugins() {
+        if (this._pluginsInitialized) {
+            return;
+        }
+        const container = this._container;
+        this.movers = await this._engine.getMovers(container, true);
+        this.updaters = await this._engine.getUpdaters(container, true);
+        await this._interactionManager.init();
+        for (const [, pathGenerator] of container.pathGenerators) {
+            await pathGenerator.init(container);
+        }
+    }
+    async push(nb, mouse, overrideOptions, group) {
         for (let i = 0; i < nb; i++) {
-            this.addParticle(mouse?.position, overrideOptions, group);
+            await this.addParticle(mouse?.position, overrideOptions, group);
         }
     }
     async redraw() {
         this.clear();
-        this.init();
+        await this.init();
         await this.draw({ value: 0, factor: 0 });
     }
     remove(particle, group, override) {
         this.removeAt(this._array.indexOf(particle), undefined, group, override);
     }
-    removeAt(index, quantity = 1, group, override) {
-        if (index < 0 || index > this.count) {
+    removeAt(index, quantity = defaultRemoveQuantity, group, override) {
+        const minIndex = 0;
+        if (index < minIndex || index > this.count) {
             return;
         }
         let deleted = 0;
         for (let i = index; deleted < quantity && i < this.count; i++) {
-            this._removeParticle(i--, group, override) && deleted++;
+            if (this._removeParticle(i--, group, override)) {
+                deleted++;
+            }
         }
     }
     removeQuantity(quantity, group) {
-        this.removeAt(0, quantity, group);
+        const defaultIndex = 0;
+        this.removeAt(defaultIndex, quantity, group);
     }
-    setDensity() {
-        const options = this._container.actualOptions, groups = options.particles.groups;
+    async setDensity() {
+        const options = this._container.actualOptions, groups = options.particles.groups, manualCount = 0;
         for (const group in groups) {
-            this._applyDensity(groups[group], 0, group);
+            await this._applyDensity(groups[group], manualCount, group);
         }
-        this._applyDensity(options.particles, options.manualParticles.length);
+        await this._applyDensity(options.particles, options.manualParticles.length);
     }
     setLastZIndex(zIndex) {
         this._lastZIndex = zIndex;
@@ -257,7 +290,7 @@ class Particles {
             pathGenerator.update();
         }
         for (const [, plugin] of container.plugins) {
-            plugin.update && (await plugin.update(delta));
+            await plugin.update?.(delta);
         }
         const resizeFactor = this._resizeFactor;
         for (const particle of this._array) {
@@ -268,15 +301,17 @@ class Particles {
                 particle.initialPosition.y *= resizeFactor.height;
             }
             particle.ignoresResizeRatio = false;
-            await this._interactionManager.reset(particle);
+            this._interactionManager.reset(particle);
             for (const [, plugin] of this._container.plugins) {
                 if (particle.destroyed) {
                     break;
                 }
-                plugin.particleUpdate && plugin.particleUpdate(particle, delta);
+                plugin.particleUpdate?.(particle, delta);
             }
             for (const mover of this.movers) {
-                mover.isEnabled(particle) && mover.move(particle, delta);
+                if (mover.isEnabled(particle)) {
+                    await mover.move(particle, delta);
+                }
             }
             if (particle.destroyed) {
                 particlesToDelete.add(particle);
@@ -301,7 +336,7 @@ class Particles {
         await this._interactionManager.externalInteract(delta);
         for (const particle of this._array) {
             for (const updater of this.updaters) {
-                updater.update(particle, delta);
+                await updater.update(particle, delta);
             }
             if (!particle.destroyed && !particle.spawning) {
                 await this._interactionManager.particlesInteract(particle, delta);
@@ -311,7 +346,8 @@ class Particles {
         if (this._needsSort) {
             const zArray = this._zArray;
             zArray.sort((a, b) => b.position.z - a.position.z || a.id - b.id);
-            this._lastZIndex = zArray[zArray.length - 1].position.z;
+            const lengthOffset = 1;
+            this._lastZIndex = zArray[zArray.length - lengthOffset].position.z;
             this._needsSort = false;
         }
     }

package/cjs/Core/Retina.js

@@ -3,16 +3,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Retina = void 0;
 const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 const Utils_js_1 = require("../Utils/Utils.js");
+const defaultRatio = 1, defaultReduceFactor = 1;
 class Retina {
     constructor(container) {
         this.container = container;
-        this.pixelRatio = 1;
-        this.reduceFactor = 1;
+        this.pixelRatio = defaultRatio;
+        this.reduceFactor = defaultReduceFactor;
     }
     init() {
         const container = this.container, options = container.actualOptions;
-        this.pixelRatio = !options.detectRetina || (0, Utils_js_1.isSsr)() ? 1 : window.devicePixelRatio;
-        this.reduceFactor = 1;
+        this.pixelRatio = !options.detectRetina || (0, Utils_js_1.isSsr)() ? defaultRatio : window.devicePixelRatio;
+        this.reduceFactor = defaultReduceFactor;
         const ratio = this.pixelRatio, canvas = container.canvas;
         if (canvas.element) {
             const element = canvas.element;

package/cjs/Core/Utils/Circle.js

@@ -4,6 +4,7 @@ exports.Circle = void 0;
 const Range_js_1 = require("./Range.js");
 const Rectangle_js_1 = require("./Rectangle.js");
 const NumberUtils_js_1 = require("../../Utils/NumberUtils.js");
+const squareExp = 2;
 class Circle extends Range_js_1.Range {
     constructor(x, y, radius) {
         super(x, y);
@@ -15,12 +16,12 @@ class Circle extends Range_js_1.Range {
     intersects(range) {
         const pos1 = this.position, pos2 = range.position, distPos = { x: Math.abs(pos2.x - pos1.x), y: Math.abs(pos2.y - pos1.y) }, r = this.radius;
         if (range instanceof Circle) {
-            const rSum = r + range.radius, dist = Math.sqrt(distPos.x ** 2 + distPos.y ** 2);
+            const rSum = r + range.radius, dist = Math.sqrt(distPos.x ** squareExp + distPos.y ** squareExp);
             return rSum > dist;
         }
         else if (range instanceof Rectangle_js_1.Rectangle) {
-            const { width, height } = range.size, edges = Math.pow(distPos.x - width, 2) + Math.pow(distPos.y - height, 2);
-            return (edges <= r ** 2 ||
+            const { width, height } = range.size, edges = Math.pow(distPos.x - width, squareExp) + Math.pow(distPos.y - height, squareExp);
+            return (edges <= r ** squareExp ||
                 (distPos.x <= r + width && distPos.y <= r + height) ||
                 distPos.x <= width ||
                 distPos.y <= height);