@tsparticles/plugin-emitters 3.9.0 → 4.0.0-alpha.0

package/umd/EmitterInstance.js

@@ -13,7 +13,7 @@
     const engine_1 = require("@tsparticles/engine");
     const Emitter_js_1 = require("./Options/Classes/Emitter.js");
     const EmitterSize_js_1 = require("./Options/Classes/EmitterSize.js");
-    const half = 0.5, defaultLifeDelay = 0, minLifeCount = 0, defaultSpawnDelay = 0, defaultEmitDelay = 0, defaultLifeCount = -1, defaultColorAnimationFactor = 1;
+    const defaultLifeDelay = 0, minLifeCount = 0, defaultSpawnDelay = 0, defaultEmitDelay = 0, defaultLifeCount = -1, defaultColorAnimationFactor = 1;
     function setParticlesOptionsColor(particlesOptions, color) {
         if (particlesOptions.color) {
             particlesOptions.color.value = color;
@@ -45,7 +45,7 @@
                 if (this._paused) {
                     return;
                 }
-                const duration = this.options.life?.duration !== undefined ? (0, engine_1.getRangeValue)(this.options.life.duration) : undefined, minDuration = 0, minLifeCount = 0;
+                const duration = this.options.life.duration !== undefined ? (0, engine_1.getRangeValue)(this.options.life.duration) : undefined, minDuration = 0, minLifeCount = 0;
                 if ((this._lifeCount > minLifeCount || this._immortal) && duration !== undefined && duration > minDuration) {
                     this._duration = duration * engine_1.millisecondsToSeconds;
                 }
@@ -55,9 +55,9 @@
                 if (!animation.enable) {
                     return initValue;
                 }
-                const colorOffset = (0, engine_1.randomInRange)(animation.offset), delay = (0, engine_1.getRangeValue)(this.options.rate.delay), emitFactor = container.retina.reduceFactor
+                const colorOffset = (0, engine_1.randomInRangeValue)(animation.offset), delay = (0, engine_1.getRangeValue)(this.options.rate.delay), emitFactor = container.retina.reduceFactor
                     ? (delay * engine_1.millisecondsToSeconds) / container.retina.reduceFactor
-                    : Infinity, defaultColorSpeed = 0, colorSpeed = (0, engine_1.getRangeValue)(animation.speed ?? defaultColorSpeed);
+                    : Infinity, colorSpeed = (0, engine_1.getRangeValue)(animation.speed);
                 return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * factor) % maxValue;
             };
             this._engine = engine;
@@ -81,8 +81,7 @@
             this.fill = this.options.fill;
             this._firstSpawn = !this.options.life.wait;
             this._startParticlesAdded = false;
-            let particlesOptions = (0, engine_1.deepExtend)({}, this.options.particles);
-            particlesOptions ??= {};
+            const particlesOptions = (0, engine_1.deepExtend)({}, this.options.particles);
             particlesOptions.move ??= {};
             particlesOptions.move.direction ??= this.options.direction;
             if (this.options.spawnColor) {
@@ -95,7 +94,7 @@
             this._lifeCount = this.options.life.count ?? defaultLifeCount;
             this._immortal = this._lifeCount <= minLifeCount;
             if (this.options.domId) {
-                const element = document.getElementById(this.options.domId);
+                const element = (0, engine_1.safeDocument)().getElementById(this.options.domId);
                 if (element) {
                     this._mutationObserver = new MutationObserver(() => {
                         this.resize();
@@ -229,12 +228,12 @@
         _calcPosition() {
             const container = this.container;
             if (this.options.domId) {
-                const element = document.getElementById(this.options.domId);
+                const element = (0, engine_1.safeDocument)().getElementById(this.options.domId);
                 if (element) {
                     const elRect = element.getBoundingClientRect(), pxRatio = container.retina.pixelRatio;
                     return {
-                        x: (elRect.x + elRect.width * half) * pxRatio,
-                        y: (elRect.y + elRect.height * half) * pxRatio,
+                        x: (elRect.x + elRect.width * engine_1.half) * pxRatio,
+                        y: (elRect.y + elRect.height * engine_1.half) * pxRatio,
                     };
                 }
             }
@@ -246,7 +245,7 @@
         _calcSize() {
             const container = this.container;
             if (this.options.domId) {
-                const element = document.getElementById(this.options.domId);
+                const element = (0, engine_1.safeDocument)().getElementById(this.options.domId);
                 if (element) {
                     const elRect = element.getBoundingClientRect();
                     return {
@@ -282,9 +281,9 @@
                     const hslAnimation = this.options.spawnColor?.animation;
                     if (hslAnimation) {
                         const maxValues = {
-                            h: 360,
-                            s: 100,
-                            l: 100,
+                            h: engine_1.hMax,
+                            s: engine_1.sMax,
+                            l: engine_1.lMax,
                         }, colorFactor = 3.6;
                         this.spawnColor.h = this._setColorAnimation(hslAnimation.h, this.spawnColor.h, maxValues.h, colorFactor);
                         this.spawnColor.s = this._setColorAnimation(hslAnimation.s, this.spawnColor.s, maxValues.s);

package/umd/Emitters.js

@@ -60,12 +60,12 @@
             return emitter;
         }
         handleClickMode(mode) {
-            const emitterOptions = this.emitters, modeEmitters = this.interactivityEmitters;
+            const modeEmitters = this.interactivityEmitters;
             if (mode !== EmitterClickMode_js_1.EmitterClickMode.emitter) {
                 return;
             }
             let emittersModeOptions;
-            if (modeEmitters && (0, engine_1.isArray)(modeEmitters.value)) {
+            if ((0, engine_1.isArray)(modeEmitters.value)) {
                 const minLength = 0;
                 if (modeEmitters.value.length > minLength && modeEmitters.random.enable) {
                     emittersModeOptions = [];
@@ -77,7 +77,11 @@
                             continue;
                         }
                         usedIndexes.push(idx);
-                        emittersModeOptions.push((0, engine_1.itemFromArray)(modeEmitters.value, idx));
+                        const selectedOptions = (0, engine_1.itemFromArray)(modeEmitters.value, idx);
+                        if (!selectedOptions) {
+                            continue;
+                        }
+                        emittersModeOptions.push(selectedOptions);
                     }
                 }
                 else {
@@ -85,9 +89,9 @@
                 }
             }
             else {
-                emittersModeOptions = modeEmitters?.value;
+                emittersModeOptions = modeEmitters.value;
             }
-            const emittersOptions = emittersModeOptions ?? emitterOptions, ePosition = this.container.interactivity.mouse.clickPosition;
+            const emittersOptions = emittersModeOptions, ePosition = this.container.interactivity.mouse.clickPosition;
             void (0, engine_1.executeOnSingleOrMultiple)(emittersOptions, async (emitter) => {
                 await this.addEmitter(emitter, ePosition);
             });
@@ -95,9 +99,6 @@
         async init() {
             this.emitters = this.container.actualOptions.emitters;
             this.interactivityEmitters = this.container.actualOptions.interactivity.modes.emitters;
-            if (!this.emitters) {
-                return;
-            }
             if ((0, engine_1.isArray)(this.emitters)) {
                 for (const emitterOptions of this.emitters) {
                     await this.addEmitter(emitterOptions);

package/umd/EmittersPlugin.js

@@ -50,42 +50,29 @@
                 }
                 else {
                     const emitterMode = interactivityEmitters;
-                    if (emitterMode.value !== undefined) {
-                        const defaultCount = 1;
-                        if ((0, engine_1.isArray)(emitterMode.value)) {
-                            options.interactivity.modes.emitters = {
-                                random: {
-                                    count: emitterMode.random.count ?? defaultCount,
-                                    enable: emitterMode.random.enable ?? false,
-                                },
-                                value: emitterMode.value.map(s => {
-                                    const tmp = new Emitter_js_1.Emitter();
-                                    tmp.load(s);
-                                    return tmp;
-                                }),
-                            };
-                        }
-                        else {
-                            const tmp = new Emitter_js_1.Emitter();
-                            tmp.load(emitterMode.value);
-                            options.interactivity.modes.emitters = {
-                                random: {
-                                    count: emitterMode.random.count ?? defaultCount,
-                                    enable: emitterMode.random.enable ?? false,
-                                },
-                                value: tmp,
-                            };
-                        }
+                    if ((0, engine_1.isArray)(emitterMode.value)) {
+                        options.interactivity.modes.emitters = {
+                            random: {
+                                count: emitterMode.random.count,
+                                enable: emitterMode.random.enable,
+                            },
+                            value: emitterMode.value.map(s => {
+                                const tmp = new Emitter_js_1.Emitter();
+                                tmp.load(s);
+                                return tmp;
+                            }),
+                        };
                     }
                     else {
-                        const emitterOptions = (options.interactivity.modes.emitters = {
+                        const tmp = new Emitter_js_1.Emitter();
+                        tmp.load(emitterMode.value);
+                        options.interactivity.modes.emitters = {
                             random: {
-                                count: 1,
-                                enable: false,
+                                count: emitterMode.random.count,
+                                enable: emitterMode.random.enable,
                             },
-                            value: new Emitter_js_1.Emitter(),
-                        });
-                        emitterOptions.value.load(interactivityEmitters);
+                            value: tmp,
+                        };
                     }
                 }
             }

package/umd/Options/Classes/Emitter.js

@@ -32,9 +32,7 @@
                 this.autoPlay = data.autoPlay;
             }
             if (data.size !== undefined) {
-                if (!this.size) {
-                    this.size = new EmitterSize_js_1.EmitterSize();
-                }
+                this.size ??= new EmitterSize_js_1.EmitterSize();
                 this.size.load(data.size);
             }
             if (data.direction !== undefined) {
@@ -61,9 +59,7 @@
                 }
             }
             if (data.spawnColor !== undefined) {
-                if (this.spawnColor === undefined) {
-                    this.spawnColor = new engine_1.AnimatableColor();
-                }
+                this.spawnColor ??= new engine_1.AnimatableColor();
                 this.spawnColor.load(data.spawnColor);
             }
             if (data.startCount !== undefined) {

package/umd/ShapeManager.js

@@ -12,9 +12,6 @@
     exports.ShapeManager = void 0;
     const shapeGeneratorss = new Map();
     class ShapeManager {
-        constructor(engine) {
-            this._engine = engine;
-        }
         addShapeGenerator(name, generator) {
             if (!this.getShapeGenerator(name)) {
                 shapeGeneratorss.set(name, generator);

package/umd/index.js

@@ -9,6 +9,28 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
@@ -18,32 +40,25 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./EmittersPlugin.js", "./ShapeManager.js", "./EmitterContainer.js", "./EmitterShapeBase.js", "./EmittersEngine.js", "./IEmitterShape.js", "./IEmitterShapeGenerator.js", "./Enums/EmitterClickMode.js", "./IRandomPositionData.js"], factory);
+        define(["require", "exports", "./EmitterShapeBase.js", "./Enums/EmitterClickMode.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
+    var __syncRequire = typeof module === "object" && typeof module.exports === "object";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.loadEmittersPlugin = loadEmittersPlugin;
-    const EmittersPlugin_js_1 = require("./EmittersPlugin.js");
-    const ShapeManager_js_1 = require("./ShapeManager.js");
-    async function loadEmittersPlugin(engine, refresh = true) {
-        engine.checkVersion("3.9.0");
-        if (!engine.emitterShapeManager) {
-            engine.emitterShapeManager = new ShapeManager_js_1.ShapeManager(engine);
-        }
-        if (!engine.addEmitterShapeGenerator) {
-            engine.addEmitterShapeGenerator = (name, generator) => {
-                engine.emitterShapeManager?.addShapeGenerator(name, generator);
+    function loadEmittersPlugin(engine) {
+        engine.checkVersion("4.0.0-alpha.0");
+        engine.register(async (e) => {
+            const { ShapeManager } = await (__syncRequire ? Promise.resolve().then(() => __importStar(require("./ShapeManager.js"))) : new Promise((resolve_1, reject_1) => { require(["./ShapeManager.js"], resolve_1, reject_1); }).then(__importStar)), { EmittersPlugin } = await (__syncRequire ? Promise.resolve().then(() => __importStar(require("./EmittersPlugin.js"))) : new Promise((resolve_2, reject_2) => { require(["./EmittersPlugin.js"], resolve_2, reject_2); }).then(__importStar));
+            e.emitterShapeManager ??= new ShapeManager();
+            e.addEmitterShapeGenerator ??= (name, generator) => {
+                e.emitterShapeManager?.addShapeGenerator(name, generator);
             };
-        }
-        const plugin = new EmittersPlugin_js_1.EmittersPlugin(engine);
-        await engine.addPlugin(plugin, refresh);
+            const plugin = new EmittersPlugin(e);
+            e.addPlugin(plugin);
+        });
     }
-    __exportStar(require("./EmitterContainer.js"), exports);
     __exportStar(require("./EmitterShapeBase.js"), exports);
-    __exportStar(require("./EmittersEngine.js"), exports);
-    __exportStar(require("./IEmitterShape.js"), exports);
-    __exportStar(require("./IEmitterShapeGenerator.js"), exports);
     __exportStar(require("./Enums/EmitterClickMode.js"), exports);
-    __exportStar(require("./IRandomPositionData.js"), exports);
 });