@tsparticles/engine 3.3.0 → 3.5.0

package/cjs/Core/Container.js

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Container = void 0;
+const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 const Constants_js_1 = require("./Utils/Constants.js");
 const Utils_js_1 = require("../Utils/Utils.js");
 const Canvas_js_1 = require("./Canvas.js");
 const EventListeners_js_1 = require("./Utils/EventListeners.js");
+const EventType_js_1 = require("../Enums/Types/EventType.js");
 const Options_js_1 = require("../Options/Classes/Options.js");
 const Particles_js_1 = require("./Particles.js");
 const Retina_js_1 = require("./Retina.js");
-const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
 function guardCheck(container) {
     return container && !container.destroyed;
@@ -27,7 +28,7 @@ function loadContainerOptions(engine, container, ...sourceOptionsArr) {
 }
 class Container {
     constructor(engine, id, sourceOptions) {
-        this._intersectionManager = (entries) => {
+        this._intersectionManager = entries => {
             if (!guardCheck(this) || !this.actualOptions.pauseOnOutsideViewport) {
                 return;
             }
@@ -86,6 +87,7 @@ class Container {
         this._lastFrameTime = 0;
         this.zLayers = 100;
         this.pageHidden = false;
+        this._clickHandlers = new Map();
         this._sourceOptions = sourceOptions;
         this._initialSourceOptions = sourceOptions;
         this.retina = new Retina_js_1.Retina(this);
@@ -104,8 +106,8 @@ class Container {
         this._options = loadContainerOptions(this._engine, this);
         this.actualOptions = loadContainerOptions(this._engine, this);
         this._eventListeners = new EventListeners_js_1.EventListeners(this);
-        this._intersectionObserver = (0, Utils_js_1.safeIntersectionObserver)((entries) => this._intersectionManager(entries));
-        this._engine.dispatchEvent("containerBuilt", { container: this });
+        this._intersectionObserver = (0, Utils_js_1.safeIntersectionObserver)(entries => this._intersectionManager(entries));
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerBuilt, { container: this });
     }
     get animationStatus() {
         return !this._paused && !this.pageHidden && guardCheck(this);
@@ -133,8 +135,7 @@ class Container {
                 y: pos.y * pxRatio,
             }, particles = this.particles.quadTree.queryCircle(posRetina, radius * pxRatio);
             callback(e, particles);
-        };
-        const clickHandler = (e) => {
+        }, clickHandler = (e) => {
             if (!guardCheck(this)) {
                 return;
             }
@@ -143,27 +144,23 @@ class Container {
                 y: mouseEvent.offsetY || mouseEvent.clientY,
             }, radius = 1;
             clickOrTouchHandler(e, pos, radius);
-        };
-        const touchStartHandler = () => {
+        }, touchStartHandler = () => {
             if (!guardCheck(this)) {
                 return;
             }
             touched = true;
             touchMoved = false;
-        };
-        const touchMoveHandler = () => {
+        }, touchMoveHandler = () => {
             if (!guardCheck(this)) {
                 return;
             }
             touchMoved = true;
-        };
-        const touchEndHandler = (e) => {
+        }, touchEndHandler = (e) => {
             if (!guardCheck(this)) {
                 return;
             }
             if (touched && !touchMoved) {
-                const touchEvent = e;
-                const lengthOffset = 1;
+                const touchEvent = e, lengthOffset = 1;
                 let lastTouch = touchEvent.touches[touchEvent.touches.length - lengthOffset];
                 if (!lastTouch) {
                     lastTouch = touchEvent.changedTouches[touchEvent.changedTouches.length - lengthOffset];
@@ -179,8 +176,7 @@ class Container {
             }
             touched = false;
             touchMoved = false;
-        };
-        const touchCancelHandler = () => {
+        }, touchCancelHandler = () => {
             if (!guardCheck(this)) {
                 return;
             }
@@ -188,11 +184,14 @@ class Container {
             touchMoved = false;
         };
         let touched = false, touchMoved = false;
-        el.addEventListener("click", clickHandler);
-        el.addEventListener("touchstart", touchStartHandler);
-        el.addEventListener("touchmove", touchMoveHandler);
-        el.addEventListener("touchend", touchEndHandler);
-        el.addEventListener("touchcancel", touchCancelHandler);
+        this._clickHandlers.set("click", clickHandler);
+        this._clickHandlers.set("touchstart", touchStartHandler);
+        this._clickHandlers.set("touchmove", touchMoveHandler);
+        this._clickHandlers.set("touchend", touchEndHandler);
+        this._clickHandlers.set("touchcancel", touchCancelHandler);
+        for (const [key, handler] of this._clickHandlers) {
+            el.addEventListener(key, handler);
+        }
     }
     addLifeTime(value) {
         this._lifeTime += value;
@@ -207,11 +206,21 @@ class Container {
     alive() {
         return !this._duration || this._lifeTime <= this._duration;
     }
-    destroy() {
+    clearClickHandlers() {
+        if (!guardCheck(this)) {
+            return;
+        }
+        for (const [key, handler] of this._clickHandlers) {
+            this.interactivity.element?.removeEventListener(key, handler);
+        }
+        this._clickHandlers.clear();
+    }
+    destroy(remove = true) {
         if (!guardCheck(this)) {
             return;
         }
         this.stop();
+        this.clearClickHandlers();
         this.particles.destroy();
         this.canvas.destroy();
         for (const [, effectDrawer] of this.effectDrawers) {
@@ -228,12 +237,14 @@ class Container {
         }
         this._engine.clearPlugins(this);
         this.destroyed = true;
-        const mainArr = this._engine.dom(), idx = mainArr.findIndex((t) => t === this), minIndex = 0;
-        if (idx >= minIndex) {
-            const deleteCount = 1;
-            mainArr.splice(idx, deleteCount);
+        if (remove) {
+            const mainArr = this._engine.items, idx = mainArr.findIndex(t => t === this), minIndex = 0;
+            if (idx >= minIndex) {
+                const deleteCount = 1;
+                mainArr.splice(idx, deleteCount);
+            }
         }
-        this._engine.dispatchEvent("containerDestroyed", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerDestroyed, { container: this });
     }
     draw(force) {
         if (!guardCheck(this)) {
@@ -247,7 +258,7 @@ class Container {
             }
             this._nextFrame(timestamp);
         };
-        this._drawAnimationFrame = requestAnimationFrame((timestamp) => frame(timestamp));
+        this._drawAnimationFrame = (0, NumberUtils_js_1.animate)(timestamp => frame(timestamp));
     }
     async export(type, options = {}) {
         for (const [, plugin] of this.plugins) {
@@ -301,13 +312,14 @@ class Container {
         this.updateActualOptions();
         this.canvas.initBackground();
         this.canvas.resize();
-        this.zLayers = this.actualOptions.zLayers;
-        this._duration = (0, NumberUtils_js_1.getRangeValue)(this.actualOptions.duration) * Constants_js_1.millisecondsToSeconds;
-        this._delay = (0, NumberUtils_js_1.getRangeValue)(this.actualOptions.delay) * Constants_js_1.millisecondsToSeconds;
+        const { zLayers, duration, delay, fpsLimit, smooth } = this.actualOptions;
+        this.zLayers = zLayers;
+        this._duration = (0, NumberUtils_js_1.getRangeValue)(duration) * Constants_js_1.millisecondsToSeconds;
+        this._delay = (0, NumberUtils_js_1.getRangeValue)(delay) * Constants_js_1.millisecondsToSeconds;
         this._lifeTime = 0;
         const defaultFpsLimit = 120, minFpsLimit = 0;
-        this.fpsLimit = this.actualOptions.fpsLimit > minFpsLimit ? this.actualOptions.fpsLimit : defaultFpsLimit;
-        this._smooth = this.actualOptions.smooth;
+        this.fpsLimit = fpsLimit > minFpsLimit ? fpsLimit : defaultFpsLimit;
+        this._smooth = smooth;
         for (const [, drawer] of this.effectDrawers) {
             await drawer.init?.(this);
         }
@@ -317,13 +329,13 @@ class Container {
         for (const [, plugin] of this.plugins) {
             await plugin.init?.();
         }
-        this._engine.dispatchEvent("containerInit", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerInit, { container: this });
         await this.particles.init();
         this.particles.setDensity();
         for (const [, plugin] of this.plugins) {
             plugin.particlesSetup?.();
         }
-        this._engine.dispatchEvent("particlesSetup", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.particlesSetup, { container: this });
     }
     async loadTheme(name) {
         if (!guardCheck(this)) {
@@ -337,7 +349,7 @@ class Container {
             return;
         }
         if (this._drawAnimationFrame !== undefined) {
-            cancelAnimationFrame(this._drawAnimationFrame);
+            (0, NumberUtils_js_1.cancelAnimation)(this._drawAnimationFrame);
             delete this._drawAnimationFrame;
         }
         if (this._paused) {
@@ -349,7 +361,7 @@ class Container {
         if (!this.pageHidden) {
             this._paused = true;
         }
-        this._engine.dispatchEvent("containerPaused", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerPaused, { container: this });
     }
     play(force) {
         if (!guardCheck(this)) {
@@ -370,7 +382,7 @@ class Container {
                 }
             }
         }
-        this._engine.dispatchEvent("containerPlay", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerPlay, { container: this });
         this.draw(needsUpdate ?? false);
     }
     async refresh() {
@@ -380,12 +392,13 @@ class Container {
         this.stop();
         return this.start();
     }
-    async reset() {
+    async reset(sourceOptions) {
         if (!guardCheck(this)) {
             return;
         }
-        this._initialSourceOptions = undefined;
-        this._options = loadContainerOptions(this._engine, this);
+        this._initialSourceOptions = sourceOptions;
+        this._sourceOptions = sourceOptions;
+        this._options = loadContainerOptions(this._engine, this, this._initialSourceOptions, this.sourceOptions);
         this.actualOptions = loadContainerOptions(this._engine, this, this._options);
         return this.refresh();
     }
@@ -395,7 +408,7 @@ class Container {
         }
         await this.init();
         this.started = true;
-        await new Promise((resolve) => {
+        await new Promise(resolve => {
             const start = async () => {
                 this._eventListeners.addListeners();
                 if (this.interactivity.element instanceof HTMLElement && this._intersectionObserver) {
@@ -404,7 +417,7 @@ class Container {
                 for (const [, plugin] of this.plugins) {
                     await plugin.start?.();
                 }
-                this._engine.dispatchEvent("containerStarted", { container: this });
+                this._engine.dispatchEvent(EventType_js_1.EventType.containerStarted, { container: this });
                 this.play();
                 resolve();
             };
@@ -435,7 +448,7 @@ class Container {
             this.plugins.delete(key);
         }
         this._sourceOptions = this._options;
-        this._engine.dispatchEvent("containerStopped", { container: this });
+        this._engine.dispatchEvent(EventType_js_1.EventType.containerStopped, { container: this });
     }
     updateActualOptions() {
         this.actualOptions.responsive = [];

package/cjs/Core/Engine.js

@@ -3,12 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Engine = void 0;
 const Constants_js_1 = require("./Utils/Constants.js");
 const Utils_js_1 = require("../Utils/Utils.js");
+const Container_js_1 = require("./Container.js");
 const EventDispatcher_js_1 = require("../Utils/EventDispatcher.js");
+const EventType_js_1 = require("../Enums/Types/EventType.js");
 const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 async function getItemsFromInitializer(container, map, initializers, force = false) {
     let res = map.get(container);
     if (!res || force) {
-        res = await Promise.all([...initializers.values()].map((t) => t(container)));
+        res = await Promise.all([...initializers.values()].map(t => t(container)));
         map.set(container, res);
     }
     return res;
@@ -25,6 +27,46 @@ async function getDataFromUrl(data) {
     (0, Utils_js_1.getLogger)().error(`${Constants_js_1.errorPrefix} ${response.status} while retrieving config file`);
     return data.fallback;
 }
+const generatedTrue = "true", generatedFalse = "false", canvasTag = "canvas", getCanvasFromContainer = (domContainer) => {
+    let canvasEl;
+    if (domContainer instanceof HTMLCanvasElement || domContainer.tagName.toLowerCase() === canvasTag) {
+        canvasEl = domContainer;
+        if (!canvasEl.dataset[Constants_js_1.generatedAttribute]) {
+            canvasEl.dataset[Constants_js_1.generatedAttribute] = generatedFalse;
+        }
+    }
+    else {
+        const existingCanvases = domContainer.getElementsByTagName(canvasTag);
+        if (existingCanvases.length) {
+            const firstIndex = 0;
+            canvasEl = existingCanvases[firstIndex];
+            canvasEl.dataset[Constants_js_1.generatedAttribute] = generatedFalse;
+        }
+        else {
+            canvasEl = document.createElement(canvasTag);
+            canvasEl.dataset[Constants_js_1.generatedAttribute] = generatedTrue;
+            domContainer.appendChild(canvasEl);
+        }
+    }
+    const fullPercent = "100%";
+    if (!canvasEl.style.width) {
+        canvasEl.style.width = fullPercent;
+    }
+    if (!canvasEl.style.height) {
+        canvasEl.style.height = fullPercent;
+    }
+    return canvasEl;
+}, getDomContainer = (id, source) => {
+    let domContainer = source ?? document.getElementById(id);
+    if (domContainer) {
+        return domContainer;
+    }
+    domContainer = document.createElement("div");
+    domContainer.id = id;
+    domContainer.dataset[Constants_js_1.generatedAttribute] = generatedTrue;
+    document.body.append(domContainer);
+    return domContainer;
+};
 class Engine {
     constructor() {
         this._configs = new Map();
@@ -52,16 +94,19 @@ class Engine {
         }
         return res;
     }
+    get items() {
+        return this._domArray;
+    }
     get version() {
-        return "3.3.0";
+        return "3.5.0";
     }
     addConfig(config) {
         const key = config.key ?? config.name ?? "default";
         this._configs.set(key, config);
-        this._eventDispatcher.dispatchEvent("configAdded", { data: { name: key, config } });
+        this._eventDispatcher.dispatchEvent(EventType_js_1.EventType.configAdded, { data: { name: key, config } });
     }
     async addEffect(effect, drawer, refresh = true) {
-        (0, Utils_js_1.executeOnSingleOrMultiple)(effect, (type) => {
+        (0, Utils_js_1.executeOnSingleOrMultiple)(effect, type => {
             if (!this.getEffectDrawer(type)) {
                 this.effectDrawers.set(type, drawer);
             }
@@ -101,12 +146,13 @@ class Engine {
         }
         await this.refresh(refresh);
     }
-    async addShape(shape, drawer, refresh = true) {
-        (0, Utils_js_1.executeOnSingleOrMultiple)(shape, (type) => {
-            if (!this.getShapeDrawer(type)) {
-                this.shapeDrawers.set(type, drawer);
+    async addShape(drawer, refresh = true) {
+        for (const validType of drawer.validTypes) {
+            if (this.getShapeDrawer(validType)) {
+                continue;
             }
-        });
+            this.shapeDrawers.set(validType, drawer);
+        }
         await this.refresh(refresh);
     }
     clearPlugins(container) {
@@ -118,16 +164,10 @@ class Engine {
         this._eventDispatcher.dispatchEvent(type, args);
     }
     dom() {
-        return this._domArray;
+        return this.items;
     }
     domItem(index) {
-        const dom = this.dom(), item = dom[index];
-        if (!item || item.destroyed) {
-            const deleteCount = 1;
-            dom.splice(index, deleteCount);
-            return;
-        }
-        return item;
+        return this.item(index);
     }
     async getAvailablePlugins(container) {
         const res = new Map();
@@ -142,16 +182,16 @@ class Engine {
         return this.effectDrawers.get(type);
     }
     async getInteractors(container, force = false) {
-        return await getItemsFromInitializer(container, this.interactors, this._initializers.interactors, force);
+        return getItemsFromInitializer(container, this.interactors, this._initializers.interactors, force);
     }
     async getMovers(container, force = false) {
-        return await getItemsFromInitializer(container, this.movers, this._initializers.movers, force);
+        return getItemsFromInitializer(container, this.movers, this._initializers.movers, force);
     }
     getPathGenerator(type) {
         return this.pathGenerators.get(type);
     }
     getPlugin(plugin) {
-        return this.plugins.find((t) => t.id === plugin);
+        return this.plugins.find(t => t.id === plugin);
     }
     getPreset(preset) {
         return this.presets.get(preset);
@@ -166,7 +206,7 @@ class Engine {
         return this.shapeDrawers.keys();
     }
     async getUpdaters(container, force = false) {
-        return await getItemsFromInitializer(container, this.updaters, this._initializers.updaters, force);
+        return getItemsFromInitializer(container, this.updaters, this._initializers.updaters, force);
     }
     init() {
         if (this._initialized) {
@@ -174,90 +214,58 @@ class Engine {
         }
         this._initialized = true;
     }
+    item(index) {
+        const { items } = this, item = items[index];
+        if (!item || item.destroyed) {
+            const deleteCount = 1;
+            items.splice(index, deleteCount);
+            return;
+        }
+        return item;
+    }
     async load(params) {
         const randomFactor = 10000, id = params.id ?? params.element?.id ?? `tsparticles${Math.floor((0, NumberUtils_js_1.getRandom)() * randomFactor)}`, { index, url } = params, options = url ? await getDataFromUrl({ fallback: params.options, url, index }) : params.options;
-        let domContainer = params.element ?? document.getElementById(id);
-        if (!domContainer) {
-            domContainer = document.createElement("div");
-            domContainer.id = id;
-            document.body.append(domContainer);
-        }
-        const currentOptions = (0, Utils_js_1.itemFromSingleOrMultiple)(options, index), dom = this.dom(), oldIndex = dom.findIndex((v) => v.id.description === id), minIndex = 0;
+        const currentOptions = (0, Utils_js_1.itemFromSingleOrMultiple)(options, index), { items } = this, oldIndex = items.findIndex(v => v.id.description === id), minIndex = 0, newItem = new Container_js_1.Container(this, id, currentOptions);
         if (oldIndex >= minIndex) {
-            const old = this.domItem(oldIndex);
+            const old = this.item(oldIndex), one = 1, none = 0, deleteCount = old ? one : none;
             if (old && !old.destroyed) {
-                old.destroy();
-                const deleteCount = 1;
-                dom.splice(oldIndex, deleteCount);
-            }
-        }
-        let canvasEl;
-        if (domContainer.tagName.toLowerCase() === "canvas") {
-            canvasEl = domContainer;
-            canvasEl.dataset[Constants_js_1.generatedAttribute] = "false";
-        }
-        else {
-            const existingCanvases = domContainer.getElementsByTagName("canvas");
-            if (existingCanvases.length) {
-                const firstIndex = 0;
-                canvasEl = existingCanvases[firstIndex];
-                canvasEl.dataset[Constants_js_1.generatedAttribute] = "false";
+                old.destroy(false);
             }
-            else {
-                canvasEl = document.createElement("canvas");
-                canvasEl.dataset[Constants_js_1.generatedAttribute] = "true";
-                domContainer.appendChild(canvasEl);
-            }
-        }
-        if (!canvasEl.style.width) {
-            canvasEl.style.width = "100%";
-        }
-        if (!canvasEl.style.height) {
-            canvasEl.style.height = "100%";
-        }
-        const { Container } = await import("./Container.js"), newItem = new Container(this, id, currentOptions);
-        if (oldIndex >= minIndex) {
-            const deleteCount = 0;
-            dom.splice(oldIndex, deleteCount, newItem);
+            items.splice(oldIndex, deleteCount, newItem);
         }
         else {
-            dom.push(newItem);
+            items.push(newItem);
         }
+        const domContainer = getDomContainer(id, params.element), canvasEl = getCanvasFromContainer(domContainer);
         newItem.canvas.loadCanvas(canvasEl);
         await newItem.start();
         return newItem;
     }
     loadOptions(options, sourceOptions) {
-        for (const plugin of this.plugins) {
-            plugin.loadOptions(options, sourceOptions);
-        }
+        this.plugins.forEach(plugin => plugin.loadOptions?.(options, sourceOptions));
     }
     loadParticlesOptions(container, options, ...sourceOptions) {
         const updaters = this.updaters.get(container);
         if (!updaters) {
             return;
         }
-        for (const updater of updaters) {
-            updater.loadOptions?.(options, ...sourceOptions);
-        }
+        updaters.forEach(updater => updater.loadOptions?.(options, ...sourceOptions));
     }
     async refresh(refresh = true) {
         if (!refresh) {
             return;
         }
-        await Promise.all(this.dom().map((t) => t.refresh()));
+        await Promise.all(this.items.map(t => t.refresh()));
     }
     removeEventListener(type, listener) {
         this._eventDispatcher.removeEventListener(type, listener);
     }
     setOnClickHandler(callback) {
-        const dom = this.dom();
-        if (!dom.length) {
+        const { items } = this;
+        if (!items.length) {
             throw new Error(`${Constants_js_1.errorPrefix} can only set click handlers after calling tsParticles.load()`);
         }
-        for (const domItem of dom) {
-            domItem.addClickHandler(callback);
-        }
+        items.forEach(item => item.addClickHandler(callback));
     }
 }
 exports.Engine = Engine;

package/cjs/Core/Particle.js

@@ -6,10 +6,15 @@ 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 EventType_js_1 = require("../Enums/Types/EventType.js");
 const Interactivity_js_1 = require("../Options/Classes/Interactivity/Interactivity.js");
+const MoveDirection_js_1 = require("../Enums/Directions/MoveDirection.js");
+const OutMode_js_1 = require("../Enums/Modes/OutMode.js");
+const ParticleOutType_js_1 = require("../Enums/Types/ParticleOutType.js");
+const PixelMode_js_1 = require("../Enums/Modes/PixelMode.js");
 const CanvasUtils_js_1 = require("../Utils/CanvasUtils.js");
 const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
-const defaultRetryCount = 0, double = 2, half = 0.5, squareExp = 2;
+const defaultRetryCount = 0, double = 2, half = 0.5, squareExp = 2, randomString = "random";
 function loadEffectData(effect, effectOptions, id, reduceDuplicates) {
     const effectData = effectOptions.options[effect];
     if (!effectData) {
@@ -58,7 +63,7 @@ class Particle {
             }), pos = Vectors_js_1.Vector3d.create(exactPosition.x, exactPosition.y, zIndex), radius = this.getRadius(), outModes = this.options.move.outModes, fixHorizontal = (outMode) => {
                 fixOutMode({
                     outMode,
-                    checkModes: ["bounce"],
+                    checkModes: [OutMode_js_1.OutMode.bounce],
                     coord: pos.x,
                     maxCoord: container.canvas.size.width,
                     setCb: (value) => (pos.x += value),
@@ -67,7 +72,7 @@ class Particle {
             }, fixVertical = (outMode) => {
                 fixOutMode({
                     outMode,
-                    checkModes: ["bounce"],
+                    checkModes: [OutMode_js_1.OutMode.bounce],
                     coord: pos.y,
                     maxCoord: container.canvas.size.height,
                     setCb: (value) => (pos.y += value),
@@ -86,7 +91,7 @@ class Particle {
         };
         this._calculateVelocity = () => {
             const baseVelocity = (0, NumberUtils_js_1.getParticleBaseVelocity)(this.direction), res = baseVelocity.copy(), moveOptions = this.options.move;
-            if (moveOptions.direction === "inside" || moveOptions.direction === "outside") {
+            if (moveOptions.direction === MoveDirection_js_1.MoveDirection.inside || moveOptions.direction === MoveDirection_js_1.MoveDirection.outside) {
                 return res;
             }
             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 = {
@@ -114,9 +119,9 @@ class Particle {
             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());
+            return !!this.container.particles.find(particle => (0, NumberUtils_js_1.getDistance)(pos, particle.position) < radius + particle.getRadius());
         };
-        this._getRollColor = (color) => {
+        this._getRollColor = color => {
             if (!color || !this.roll || (!this.backColor && !this.roll.alter)) {
                 return color;
             }
@@ -132,7 +137,7 @@ class Particle {
             }
             return color;
         };
-        this._initPosition = (position) => {
+        this._initPosition = position => {
             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();
@@ -140,15 +145,15 @@ class Particle {
             this.moveCenter = {
                 ...(0, Utils_js_1.getPosition)(this.options.move.center, canvasSize),
                 radius: this.options.move.center.radius ?? defaultRadius,
-                mode: this.options.move.center.mode ?? "percent",
+                mode: this.options.move.center.mode ?? PixelMode_js_1.PixelMode.percent,
             };
             this.direction = (0, NumberUtils_js_1.getParticleDirectionAngle)(this.options.move.direction, this.position, this.moveCenter);
             switch (this.options.move.direction) {
-                case "inside":
-                    this.outType = "inside";
+                case MoveDirection_js_1.MoveDirection.inside:
+                    this.outType = ParticleOutType_js_1.ParticleOutType.inside;
                     break;
-                case "outside":
-                    this.outType = "outside";
+                case MoveDirection_js_1.MoveDirection.outside:
+                    this.outType = ParticleOutType_js_1.ParticleOutType.outside;
                     break;
             }
             this.offset = Vectors_js_1.Vector.origin;
@@ -171,7 +176,7 @@ class Particle {
             updater.particleDestroyed?.(this, override);
         }
         pathGenerator?.reset(this);
-        this._engine.dispatchEvent("particleDestroyed", {
+        this._engine.dispatchEvent(EventType_js_1.EventType.particleDestroyed, {
             container: this.container,
             data: {
                 particle: this,
@@ -216,14 +221,15 @@ class Particle {
         this.lastPathTime = 0;
         this.destroyed = false;
         this.unbreakable = false;
+        this.isRotating = false;
         this.rotation = 0;
         this.misplaced = false;
         this.retina = {
             maxDistance: {},
         };
-        this.outType = "normal";
+        this.outType = ParticleOutType_js_1.ParticleOutType.normal;
         this.ignoresResizeRatio = true;
-        const pxRatio = container.retina.pixelRatio, mainOptions = container.actualOptions, particlesOptions = (0, OptionsUtils_js_1.loadParticlesOptions)(this._engine, container, mainOptions.particles), effectType = particlesOptions.effect.type, shapeType = particlesOptions.shape.type, { reduceDuplicates } = particlesOptions;
+        const pxRatio = container.retina.pixelRatio, mainOptions = container.actualOptions, particlesOptions = (0, OptionsUtils_js_1.loadParticlesOptions)(this._engine, container, mainOptions.particles), { reduceDuplicates } = particlesOptions, effectType = particlesOptions.effect.type, shapeType = particlesOptions.shape.type;
         this.effect = (0, Utils_js_1.itemFromSingleOrMultiple)(effectType, this.id, reduceDuplicates);
         this.shape = (0, Utils_js_1.itemFromSingleOrMultiple)(shapeType, this.id, reduceDuplicates);
         const effectOptions = particlesOptions.effect, shapeOptions = particlesOptions.shape;
@@ -243,6 +249,14 @@ class Particle {
                 }
             }
         }
+        if (this.effect === randomString) {
+            const availableEffects = [...this.container.effectDrawers.keys()];
+            this.effect = availableEffects[Math.floor(Math.random() * availableEffects.length)];
+        }
+        if (this.shape === randomString) {
+            const availableShapes = [...this.container.shapeDrawers.keys()];
+            this.shape = availableShapes[Math.floor(Math.random() * availableShapes.length)];
+        }
         this.effectData = loadEffectData(this.effect, effectOptions, this.id, reduceDuplicates);
         this.shapeData = loadShapeData(this.shape, shapeOptions, this.id, reduceDuplicates);
         particlesOptions.load(overrideOptions);