@tsparticles/engine 3.0.3 → 3.2.0

package/cjs/Core/Container.js

@@ -1,22 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Container = void 0;
+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 Options_js_1 = require("../Options/Classes/Options.js");
 const Particles_js_1 = require("./Particles.js");
 const Retina_js_1 = require("./Retina.js");
-const Constants_js_1 = require("./Utils/Constants.js");
 const NumberUtils_js_1 = require("../Utils/NumberUtils.js");
 const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
 function guardCheck(container) {
     return container && !container.destroyed;
 }
-function initDelta(value, fpsLimit = 60, smooth = false) {
+const defaultFps = 60;
+function initDelta(value, fpsLimit = defaultFps, smooth = false) {
     return {
         value,
-        factor: smooth ? 60 / fpsLimit : (60 * value) / 1000,
+        factor: smooth ? defaultFps / fpsLimit : (defaultFps * value) / Constants_js_1.millisecondsToSeconds,
     };
 }
 function loadContainerOptions(engine, container, ...sourceOptionsArr) {
@@ -34,14 +35,19 @@ class Container {
                 if (entry.target !== this.interactivity.element) {
                     continue;
                 }
-                (entry.isIntersecting ? this.play : this.pause)();
+                if (entry.isIntersecting) {
+                    this.play();
+                }
+                else {
+                    this.pause();
+                }
             }
         };
         this._nextFrame = async (timestamp) => {
             try {
                 if (!this._smooth &&
                     this._lastFrameTime !== undefined &&
-                    timestamp < this._lastFrameTime + 1000 / this.fpsLimit) {
+                    timestamp < this._lastFrameTime + Constants_js_1.millisecondsToSeconds / this.fpsLimit) {
                     this.draw(false);
                     return;
                 }
@@ -49,7 +55,7 @@ class Container {
                 const delta = initDelta(timestamp - this._lastFrameTime, this.fpsLimit, this._smooth);
                 this.addLifeTime(delta.value);
                 this._lastFrameTime = timestamp;
-                if (delta.value > 1000) {
+                if (delta.value > Constants_js_1.millisecondsToSeconds) {
                     this.draw(false);
                     return;
                 }
@@ -58,7 +64,7 @@ class Container {
                     this.destroy();
                     return;
                 }
-                if (this.getAnimationStatus()) {
+                if (this.animationStatus) {
                     this.draw(false);
                 }
             }
@@ -101,6 +107,9 @@ class Container {
         this._intersectionObserver = (0, Utils_js_1.safeIntersectionObserver)((entries) => this._intersectionManager(entries));
         this._engine.dispatchEvent("containerBuilt", { container: this });
     }
+    get animationStatus() {
+        return !this._paused && !this.pageHidden && guardCheck(this);
+    }
     get options() {
         return this._options;
     }
@@ -132,8 +141,8 @@ class Container {
             const mouseEvent = e, pos = {
                 x: mouseEvent.offsetX || mouseEvent.clientX,
                 y: mouseEvent.offsetY || mouseEvent.clientY,
-            };
-            clickOrTouchHandler(e, pos, 1);
+            }, radius = 1;
+            clickOrTouchHandler(e, pos, radius);
         };
         const touchStartHandler = () => {
             if (!guardCheck(this)) {
@@ -154,16 +163,17 @@ class Container {
             }
             if (touched && !touchMoved) {
                 const touchEvent = e;
-                let lastTouch = touchEvent.touches[touchEvent.touches.length - 1];
+                const lengthOffset = 1;
+                let lastTouch = touchEvent.touches[touchEvent.touches.length - lengthOffset];
                 if (!lastTouch) {
-                    lastTouch = touchEvent.changedTouches[touchEvent.changedTouches.length - 1];
+                    lastTouch = touchEvent.changedTouches[touchEvent.changedTouches.length - lengthOffset];
                     if (!lastTouch) {
                         return;
                     }
                 }
-                const element = this.canvas.element, canvasRect = element ? element.getBoundingClientRect() : undefined, pos = {
-                    x: lastTouch.clientX - (canvasRect ? canvasRect.left : 0),
-                    y: lastTouch.clientY - (canvasRect ? canvasRect.top : 0),
+                const element = this.canvas.element, canvasRect = element ? element.getBoundingClientRect() : undefined, minCoordinate = 0, pos = {
+                    x: lastTouch.clientX - (canvasRect ? canvasRect.left : minCoordinate),
+                    y: lastTouch.clientY - (canvasRect ? canvasRect.top : minCoordinate),
                 };
                 clickOrTouchHandler(e, pos, Math.max(lastTouch.radiusX, lastTouch.radiusY));
             }
@@ -205,10 +215,10 @@ class Container {
         this.particles.destroy();
         this.canvas.destroy();
         for (const [, effectDrawer] of this.effectDrawers) {
-            effectDrawer.destroy && effectDrawer.destroy(this);
+            effectDrawer.destroy?.(this);
         }
         for (const [, shapeDrawer] of this.shapeDrawers) {
-            shapeDrawer.destroy && shapeDrawer.destroy(this);
+            shapeDrawer.destroy?.(this);
         }
         for (const key of this.effectDrawers.keys()) {
             this.effectDrawers.delete(key);
@@ -218,9 +228,10 @@ class Container {
         }
         this._engine.clearPlugins(this);
         this.destroyed = true;
-        const mainArr = this._engine.dom(), idx = mainArr.findIndex((t) => t === this);
-        if (idx >= 0) {
-            mainArr.splice(idx, 1);
+        const mainArr = this._engine.dom(), idx = mainArr.findIndex((t) => t === this), minIndex = 0;
+        if (idx >= minIndex) {
+            const deleteCount = 1;
+            mainArr.splice(idx, deleteCount);
         }
         this._engine.dispatchEvent("containerDestroyed", { container: this });
     }
@@ -229,13 +240,14 @@ class Container {
             return;
         }
         let refreshTime = force;
-        this._drawAnimationFrame = requestAnimationFrame(async (timestamp) => {
+        const frame = async (timestamp) => {
             if (refreshTime) {
                 this._lastFrameTime = undefined;
                 refreshTime = false;
             }
             await this._nextFrame(timestamp);
-        });
+        };
+        this._drawAnimationFrame = requestAnimationFrame((timestamp) => void frame(timestamp));
     }
     async export(type, options = {}) {
         for (const [, plugin] of this.plugins) {
@@ -250,16 +262,13 @@ class Container {
         }
         (0, Utils_js_1.getLogger)().error(`${Constants_js_1.errorPrefix} - Export plugin with type ${type} not found`);
     }
-    getAnimationStatus() {
-        return !this._paused && !this.pageHidden && guardCheck(this);
-    }
     handleClickMode(mode) {
         if (!guardCheck(this)) {
             return;
         }
         this.particles.handleClickMode(mode);
         for (const [, plugin] of this.plugins) {
-            plugin.handleClickMode && plugin.handleClickMode(mode);
+            plugin.handleClickMode?.(mode);
         }
     }
     async init() {
@@ -280,9 +289,10 @@ class Container {
                 this.shapeDrawers.set(type, drawer);
             }
         }
+        await this.particles.initPlugins();
         this._options = loadContainerOptions(this._engine, this, this._initialSourceOptions, this.sourceOptions);
         this.actualOptions = loadContainerOptions(this._engine, this, this._options);
-        const availablePlugins = this._engine.getAvailablePlugins(this);
+        const availablePlugins = await this._engine.getAvailablePlugins(this);
         for (const [id, plugin] of availablePlugins) {
             this.plugins.set(id, plugin);
         }
@@ -292,25 +302,26 @@ class Container {
         this.canvas.initBackground();
         this.canvas.resize();
         this.zLayers = this.actualOptions.zLayers;
-        this._duration = (0, NumberUtils_js_1.getRangeValue)(this.actualOptions.duration) * 1000;
-        this._delay = (0, NumberUtils_js_1.getRangeValue)(this.actualOptions.delay) * 1000;
+        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;
         this._lifeTime = 0;
-        this.fpsLimit = this.actualOptions.fpsLimit > 0 ? this.actualOptions.fpsLimit : 120;
+        const defaultFpsLimit = 120, minFpsLimit = 0;
+        this.fpsLimit = this.actualOptions.fpsLimit > minFpsLimit ? this.actualOptions.fpsLimit : defaultFpsLimit;
         this._smooth = this.actualOptions.smooth;
         for (const [, drawer] of this.effectDrawers) {
-            drawer.init && (await drawer.init(this));
+            await drawer.init?.(this);
         }
         for (const [, drawer] of this.shapeDrawers) {
-            drawer.init && (await drawer.init(this));
+            await drawer.init?.(this);
         }
         for (const [, plugin] of this.plugins) {
-            plugin.init && (await plugin.init());
+            await plugin.init?.();
         }
         this._engine.dispatchEvent("containerInit", { container: this });
-        this.particles.init();
-        this.particles.setDensity();
+        await this.particles.init();
+        await this.particles.setDensity();
         for (const [, plugin] of this.plugins) {
-            plugin.particlesSetup && plugin.particlesSetup();
+            plugin.particlesSetup?.();
         }
         this._engine.dispatchEvent("particlesSetup", { container: this });
     }
@@ -333,7 +344,7 @@ class Container {
             return;
         }
         for (const [, plugin] of this.plugins) {
-            plugin.pause && plugin.pause();
+            plugin.pause?.();
         }
         if (!this.pageHidden) {
             this._paused = true;
@@ -360,7 +371,7 @@ class Container {
             }
         }
         this._engine.dispatchEvent("containerPlay", { container: this });
-        this.draw(needsUpdate || false);
+        this.draw(needsUpdate ?? false);
     }
     async refresh() {
         if (!guardCheck(this)) {
@@ -385,18 +396,19 @@ class Container {
         await this.init();
         this.started = true;
         await new Promise((resolve) => {
-            this._delayTimeout = setTimeout(async () => {
+            const start = async () => {
                 this._eventListeners.addListeners();
                 if (this.interactivity.element instanceof HTMLElement && this._intersectionObserver) {
                     this._intersectionObserver.observe(this.interactivity.element);
                 }
                 for (const [, plugin] of this.plugins) {
-                    plugin.start && (await plugin.start());
+                    await plugin.start?.();
                 }
                 this._engine.dispatchEvent("containerStarted", { container: this });
                 this.play();
                 resolve();
-            }, this._delay);
+            };
+            this._delayTimeout = setTimeout(() => void start(), this._delay);
         });
     }
     stop() {
@@ -417,7 +429,7 @@ class Container {
             this._intersectionObserver.unobserve(this.interactivity.element);
         }
         for (const [, plugin] of this.plugins) {
-            plugin.stop && plugin.stop();
+            plugin.stop?.();
         }
         for (const key of this.plugins.keys()) {
             this.plugins.delete(key);

package/cjs/Core/Engine.js

@@ -1,15 +1,37 @@
 "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.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 NumberUtils_js_1 = require("../Utils/NumberUtils.js");
-function getItemsFromInitializer(container, map, initializers, force = false) {
+async function getItemsFromInitializer(container, map, initializers, force = false) {
     let res = map.get(container);
     if (!res || force) {
-        res = [...initializers.values()].map((t) => t(container));
+        res = await Promise.all([...initializers.values()].map((t) => t(container)));
         map.set(container, res);
     }
     return res;
@@ -21,7 +43,7 @@ async function getDataFromUrl(data) {
     }
     const response = await fetch(url);
     if (response.ok) {
-        return response.json();
+        return (await response.json());
     }
     (0, Utils_js_1.getLogger)().error(`${Constants_js_1.errorPrefix} ${response.status} while retrieving config file`);
     return data.fallback;
@@ -54,16 +76,18 @@ class Engine {
         return res;
     }
     get version() {
-        return "3.0.3";
+        return "3.2.0";
     }
     addConfig(config) {
-        const name = config.name ?? "default";
-        this._configs.set(name, config);
-        this._eventDispatcher.dispatchEvent("configAdded", { data: { name, config } });
+        const key = config.key ?? config.name ?? "default";
+        this._configs.set(key, config);
+        this._eventDispatcher.dispatchEvent("configAdded", { data: { name: key, config } });
     }
     async addEffect(effect, drawer, refresh = true) {
         (0, Utils_js_1.executeOnSingleOrMultiple)(effect, (type) => {
-            !this.getEffectDrawer(type) && this.effectDrawers.set(type, drawer);
+            if (!this.getEffectDrawer(type)) {
+                this.effectDrawers.set(type, drawer);
+            }
         });
         await this.refresh(refresh);
     }
@@ -83,20 +107,28 @@ class Engine {
         await this.refresh(refresh);
     }
     async addPathGenerator(name, generator, refresh = true) {
-        !this.getPathGenerator(name) && this.pathGenerators.set(name, generator);
+        if (!this.getPathGenerator(name)) {
+            this.pathGenerators.set(name, generator);
+        }
         await this.refresh(refresh);
     }
     async addPlugin(plugin, refresh = true) {
-        !this.getPlugin(plugin.id) && this.plugins.push(plugin);
+        if (!this.getPlugin(plugin.id)) {
+            this.plugins.push(plugin);
+        }
         await this.refresh(refresh);
     }
     async addPreset(preset, options, override = false, refresh = true) {
-        (override || !this.getPreset(preset)) && this.presets.set(preset, options);
+        if (override || !this.getPreset(preset)) {
+            this.presets.set(preset, options);
+        }
         await this.refresh(refresh);
     }
     async addShape(shape, drawer, refresh = true) {
         (0, Utils_js_1.executeOnSingleOrMultiple)(shape, (type) => {
-            !this.getShapeDrawer(type) && this.shapeDrawers.set(type, drawer);
+            if (!this.getShapeDrawer(type)) {
+                this.shapeDrawers.set(type, drawer);
+            }
         });
         await this.refresh(refresh);
     }
@@ -114,26 +146,29 @@ class Engine {
     domItem(index) {
         const dom = this.dom(), item = dom[index];
         if (!item || item.destroyed) {
-            dom.splice(index, 1);
+            const deleteCount = 1;
+            dom.splice(index, deleteCount);
             return;
         }
         return item;
     }
-    getAvailablePlugins(container) {
+    async getAvailablePlugins(container) {
         const res = new Map();
         for (const plugin of this.plugins) {
-            plugin.needsPlugin(container.actualOptions) && res.set(plugin.id, plugin.getPlugin(container));
+            if (plugin.needsPlugin(container.actualOptions)) {
+                res.set(plugin.id, await plugin.getPlugin(container));
+            }
         }
         return res;
     }
     getEffectDrawer(type) {
         return this.effectDrawers.get(type);
     }
-    getInteractors(container, force = false) {
-        return getItemsFromInitializer(container, this.interactors, this._initializers.interactors, force);
+    async getInteractors(container, force = false) {
+        return await getItemsFromInitializer(container, this.interactors, this._initializers.interactors, force);
     }
-    getMovers(container, force = false) {
-        return getItemsFromInitializer(container, this.movers, this._initializers.movers, force);
+    async getMovers(container, force = false) {
+        return await getItemsFromInitializer(container, this.movers, this._initializers.movers, force);
     }
     getPathGenerator(type) {
         return this.pathGenerators.get(type);
@@ -153,8 +188,8 @@ class Engine {
     getSupportedShapes() {
         return this.shapeDrawers.keys();
     }
-    getUpdaters(container, force = false) {
-        return getItemsFromInitializer(container, this.updaters, this._initializers.updaters, force);
+    async getUpdaters(container, force = false) {
+        return await getItemsFromInitializer(container, this.updaters, this._initializers.updaters, force);
     }
     init() {
         if (this._initialized) {
@@ -163,19 +198,20 @@ class Engine {
         this._initialized = true;
     }
     async load(params) {
-        const id = params.id ?? params.element?.id ?? `tsparticles${Math.floor((0, NumberUtils_js_1.getRandom)() * 10000)}`, { index, url } = params, options = url ? await getDataFromUrl({ fallback: params.options, url, index }) : params.options;
+        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);
-        if (oldIndex >= 0) {
+        const currentOptions = (0, Utils_js_1.itemFromSingleOrMultiple)(options, index), dom = this.dom(), oldIndex = dom.findIndex((v) => v.id.description === id), minIndex = 0;
+        if (oldIndex >= minIndex) {
             const old = this.domItem(oldIndex);
             if (old && !old.destroyed) {
                 old.destroy();
-                dom.splice(oldIndex, 1);
+                const deleteCount = 1;
+                dom.splice(oldIndex, deleteCount);
             }
         }
         let canvasEl;
@@ -186,7 +222,8 @@ class Engine {
         else {
             const existingCanvases = domContainer.getElementsByTagName("canvas");
             if (existingCanvases.length) {
-                canvasEl = existingCanvases[0];
+                const firstIndex = 0;
+                canvasEl = existingCanvases[firstIndex];
                 canvasEl.dataset[Constants_js_1.generatedAttribute] = "false";
             }
             else {
@@ -201,9 +238,10 @@ class Engine {
         if (!canvasEl.style.height) {
             canvasEl.style.height = "100%";
         }
-        const newItem = new Container_js_1.Container(this, id, currentOptions);
-        if (oldIndex >= 0) {
-            dom.splice(oldIndex, 0, newItem);
+        const { Container } = await Promise.resolve().then(() => __importStar(require("./Container.js"))), newItem = new Container(this, id, currentOptions);
+        if (oldIndex >= minIndex) {
+            const deleteCount = 0;
+            dom.splice(oldIndex, deleteCount, newItem);
         }
         else {
             dom.push(newItem);
@@ -223,14 +261,14 @@ class Engine {
             return;
         }
         for (const updater of updaters) {
-            updater.loadOptions && updater.loadOptions(options, ...sourceOptions);
+            updater.loadOptions?.(options, ...sourceOptions);
         }
     }
     async refresh(refresh = true) {
         if (!refresh) {
             return;
         }
-        this.dom().forEach((t) => t.refresh());
+        await Promise.all(this.dom().map((t) => t.refresh()));
     }
     removeEventListener(type, listener) {
         this._eventDispatcher.removeEventListener(type, listener);