@tsparticles/plugin-emitters 3.0.0-alpha.1 → 3.0.0-beta.1

package/cjs/EmitterInstance.js

@@ -2,53 +2,121 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmitterInstance = void 0;
 const engine_1 = require("@tsparticles/engine");
-const Emitter_1 = require("./Options/Classes/Emitter");
-const EmitterSize_1 = require("./Options/Classes/EmitterSize");
+const Emitter_js_1 = require("./Options/Classes/Emitter.js");
+const EmitterSize_js_1 = require("./Options/Classes/EmitterSize.js");
 class EmitterInstance {
     constructor(engine, emitters, container, options, position) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        var _h;
         this.emitters = emitters;
         this.container = container;
+        this._calcPosition = () => {
+            return (0, engine_1.calcPositionOrRandomFromSizeRanged)({
+                size: this.container.canvas.size,
+                position: this.options.position,
+            });
+        };
+        this._destroy = () => {
+            this.emitters.removeEmitter(this);
+            this._engine.dispatchEvent("emitterDestroyed", {
+                container: this.container,
+                data: {
+                    emitter: this,
+                },
+            });
+        };
+        this._emit = () => {
+            if (this._paused) {
+                return;
+            }
+            const quantity = (0, engine_1.getRangeValue)(this.options.rate.quantity);
+            this._emitParticles(quantity);
+        };
+        this._emitParticles = (quantity) => {
+            const position = this.getPosition(), size = this.getSize(), singleParticlesOptions = (0, engine_1.itemFromSingleOrMultiple)(this._particlesOptions);
+            for (let i = 0; i < quantity; i++) {
+                const particlesOptions = (0, engine_1.deepExtend)({}, singleParticlesOptions);
+                if (this.spawnColor) {
+                    const hslAnimation = this.options.spawnColor?.animation;
+                    if (hslAnimation) {
+                        this.spawnColor.h = this._setColorAnimation(hslAnimation.h, this.spawnColor.h, 360);
+                        this.spawnColor.s = this._setColorAnimation(hslAnimation.s, this.spawnColor.s, 100);
+                        this.spawnColor.l = this._setColorAnimation(hslAnimation.l, this.spawnColor.l, 100);
+                    }
+                    if (!particlesOptions.color) {
+                        particlesOptions.color = {
+                            value: this.spawnColor,
+                        };
+                    }
+                    else {
+                        particlesOptions.color.value = this.spawnColor;
+                    }
+                }
+                if (!position) {
+                    return;
+                }
+                const pPosition = this._shape?.randomPosition(position, size, this.fill) ?? position;
+                this.container.particles.addParticle(pPosition, particlesOptions);
+            }
+        };
+        this._prepareToDie = () => {
+            if (this._paused) {
+                return;
+            }
+            const duration = this.options.life?.duration !== undefined ? (0, engine_1.getRangeValue)(this.options.life.duration) : undefined;
+            if (this.container.retina.reduceFactor &&
+                (this._lifeCount > 0 || this._immortal) &&
+                duration !== undefined &&
+                duration > 0) {
+                this._duration = duration * 1000;
+            }
+        };
+        this._setColorAnimation = (animation, initValue, maxValue) => {
+            const container = this.container;
+            if (!animation.enable) {
+                return initValue;
+            }
+            const colorOffset = (0, engine_1.randomInRange)(animation.offset), delay = (0, engine_1.getRangeValue)(this.options.rate.delay), emitFactor = (1000 * delay) / container.retina.reduceFactor, colorSpeed = (0, engine_1.getRangeValue)(animation.speed ?? 0);
+            return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * 3.6) % maxValue;
+        };
         this._engine = engine;
         this._currentDuration = 0;
         this._currentEmitDelay = 0;
         this._currentSpawnDelay = 0;
         this._initialPosition = position;
-        if (options instanceof Emitter_1.Emitter) {
+        if (options instanceof Emitter_js_1.Emitter) {
             this.options = options;
         }
         else {
-            this.options = new Emitter_1.Emitter();
+            this.options = new Emitter_js_1.Emitter();
             this.options.load(options);
         }
-        this._spawnDelay = (((_a = this.options.life.delay) !== null && _a !== void 0 ? _a : 0) * 1000) / this.container.retina.reduceFactor;
-        this.position = (_b = this._initialPosition) !== null && _b !== void 0 ? _b : this.calcPosition();
+        this._spawnDelay = ((0, engine_1.getRangeValue)(this.options.life.delay ?? 0) * 1000) / this.container.retina.reduceFactor;
+        this.position = this._initialPosition ?? this._calcPosition();
         this.name = this.options.name;
-        this._shape = (_c = this._engine.emitterShapeManager) === null || _c === void 0 ? void 0 : _c.getShape(this.options.shape);
+        this._shape = this._engine.emitterShapeManager?.getShape(this.options.shape);
         this.fill = this.options.fill;
         this._firstSpawn = !this.options.life.wait;
         this._startParticlesAdded = false;
         let particlesOptions = (0, engine_1.deepExtend)({}, this.options.particles);
-        particlesOptions !== null && particlesOptions !== void 0 ? particlesOptions : (particlesOptions = {});
-        (_d = particlesOptions.move) !== null && _d !== void 0 ? _d : (particlesOptions.move = {});
-        (_e = (_h = particlesOptions.move).direction) !== null && _e !== void 0 ? _e : (_h.direction = this.options.direction);
+        particlesOptions ??= {};
+        particlesOptions.move ??= {};
+        particlesOptions.move.direction ??= this.options.direction;
         if (this.options.spawnColor) {
             this.spawnColor = (0, engine_1.rangeColorToHsl)(this.options.spawnColor);
         }
         this._paused = !this.options.autoPlay;
         this._particlesOptions = particlesOptions;
         this.size =
-            (_f = this.options.size) !== null && _f !== void 0 ? _f : (() => {
-                const size = new EmitterSize_1.EmitterSize();
-                size.load({
-                    height: 0,
-                    mode: "percent",
-                    width: 0,
-                });
-                return size;
-            })();
-        this._lifeCount = (_g = this.options.life.count) !== null && _g !== void 0 ? _g : -1;
+            this.options.size ??
+                (() => {
+                    const size = new EmitterSize_js_1.EmitterSize();
+                    size.load({
+                        height: 0,
+                        mode: "percent",
+                        width: 0,
+                    });
+                    return size;
+                })();
+        this._lifeCount = this.options.life.count ?? -1;
         this._immortal = this._lifeCount <= 0;
         this._engine.dispatchEvent("emitterCreated", {
             container,
@@ -91,14 +159,7 @@ class EmitterInstance {
                 };
             }
         }
-        return {
-            width: this.size.mode === "percent"
-                ? (container.canvas.size.width * this.size.width) / 100
-                : this.size.width,
-            height: this.size.mode === "percent"
-                ? (container.canvas.size.height * this.size.height) / 100
-                : this.size.height,
-        };
+        return (0, engine_1.getSize)(this.size, container.canvas.size);
     }
     pause() {
         if (this._paused) {
@@ -107,13 +168,12 @@ class EmitterInstance {
         delete this._emitDelay;
     }
     play() {
-        var _a;
         if (this._paused) {
             return;
         }
         if (!(this.container.retina.reduceFactor &&
             (this._lifeCount > 0 || this._immortal || !this.options.life.count) &&
-            (this._firstSpawn || this._currentSpawnDelay >= ((_a = this._spawnDelay) !== null && _a !== void 0 ? _a : 0)))) {
+            (this._firstSpawn || this._currentSpawnDelay >= (this._spawnDelay ?? 0)))) {
             return;
         }
         if (this._emitDelay === undefined) {
@@ -121,7 +181,7 @@ class EmitterInstance {
             this._emitDelay = (1000 * delay) / this.container.retina.reduceFactor;
         }
         if (this._lifeCount > 0 || this._immortal) {
-            this.prepareToDie();
+            this._prepareToDie();
         }
     }
     resize() {
@@ -129,21 +189,20 @@ class EmitterInstance {
         this.position =
             initialPosition && (0, engine_1.isPointInside)(initialPosition, this.container.canvas.size, engine_1.Vector.origin)
                 ? initialPosition
-                : this.calcPosition();
+                : this._calcPosition();
     }
     update(delta) {
-        var _a, _b, _c;
         if (this._paused) {
             return;
         }
         if (this._firstSpawn) {
             this._firstSpawn = false;
-            this._currentSpawnDelay = (_a = this._spawnDelay) !== null && _a !== void 0 ? _a : 0;
-            this._currentEmitDelay = (_b = this._emitDelay) !== null && _b !== void 0 ? _b : 0;
+            this._currentSpawnDelay = this._spawnDelay ?? 0;
+            this._currentEmitDelay = this._emitDelay ?? 0;
         }
         if (!this._startParticlesAdded) {
             this._startParticlesAdded = true;
-            this.emitParticles(this.options.startCount);
+            this._emitParticles(this.options.startCount);
         }
         if (this._duration !== undefined) {
             this._currentDuration += delta.value;
@@ -156,11 +215,12 @@ class EmitterInstance {
                     this._lifeCount--;
                 }
                 if (this._lifeCount > 0 || this._immortal) {
-                    this.position = this.calcPosition();
-                    this._spawnDelay = (((_c = this.options.life.delay) !== null && _c !== void 0 ? _c : 0) * 1000) / this.container.retina.reduceFactor;
+                    this.position = this._calcPosition();
+                    this._spawnDelay =
+                        ((0, engine_1.getRangeValue)(this.options.life.delay ?? 0) * 1000) / this.container.retina.reduceFactor;
                 }
                 else {
-                    this.destroy();
+                    this._destroy();
                 }
                 this._currentDuration -= this._duration;
                 delete this._duration;
@@ -180,82 +240,10 @@ class EmitterInstance {
         if (this._emitDelay !== undefined) {
             this._currentEmitDelay += delta.value;
             if (this._currentEmitDelay >= this._emitDelay) {
-                this.emit();
+                this._emit();
                 this._currentEmitDelay -= this._emitDelay;
             }
         }
     }
-    calcPosition() {
-        return (0, engine_1.calcPositionOrRandomFromSizeRanged)({
-            size: this.container.canvas.size,
-            position: this.options.position,
-        });
-    }
-    destroy() {
-        this.emitters.removeEmitter(this);
-        this._engine.dispatchEvent("emitterDestroyed", {
-            container: this.container,
-            data: {
-                emitter: this,
-            },
-        });
-    }
-    emit() {
-        if (this._paused) {
-            return;
-        }
-        const quantity = (0, engine_1.getRangeValue)(this.options.rate.quantity);
-        this.emitParticles(quantity);
-    }
-    emitParticles(quantity) {
-        var _a, _b, _c;
-        const position = this.getPosition(), size = this.getSize(), singleParticlesOptions = (0, engine_1.itemFromSingleOrMultiple)(this._particlesOptions);
-        for (let i = 0; i < quantity; i++) {
-            const particlesOptions = (0, engine_1.deepExtend)({}, singleParticlesOptions);
-            if (this.spawnColor) {
-                const hslAnimation = (_a = this.options.spawnColor) === null || _a === void 0 ? void 0 : _a.animation;
-                if (hslAnimation) {
-                    this.spawnColor.h = this.setColorAnimation(hslAnimation.h, this.spawnColor.h, 360);
-                    this.spawnColor.s = this.setColorAnimation(hslAnimation.s, this.spawnColor.s, 100);
-                    this.spawnColor.l = this.setColorAnimation(hslAnimation.l, this.spawnColor.l, 100);
-                }
-                if (!particlesOptions.color) {
-                    particlesOptions.color = {
-                        value: this.spawnColor,
-                    };
-                }
-                else {
-                    particlesOptions.color.value = this.spawnColor;
-                }
-            }
-            if (!position) {
-                return;
-            }
-            const pPosition = (_c = (_b = this._shape) === null || _b === void 0 ? void 0 : _b.randomPosition(position, size, this.fill)) !== null && _c !== void 0 ? _c : position;
-            this.container.particles.addParticle(pPosition, particlesOptions);
-        }
-    }
-    prepareToDie() {
-        var _a;
-        if (this._paused) {
-            return;
-        }
-        const duration = (_a = this.options.life) === null || _a === void 0 ? void 0 : _a.duration;
-        if (this.container.retina.reduceFactor &&
-            (this._lifeCount > 0 || this._immortal) &&
-            duration !== undefined &&
-            duration > 0) {
-            this._duration = duration * 1000;
-        }
-    }
-    setColorAnimation(animation, initValue, maxValue) {
-        var _a;
-        const container = this.container;
-        if (!animation.enable) {
-            return initValue;
-        }
-        const colorOffset = (0, engine_1.randomInRange)(animation.offset), delay = (0, engine_1.getRangeValue)(this.options.rate.delay), emitFactor = (1000 * delay) / container.retina.reduceFactor, colorSpeed = (0, engine_1.getRangeValue)((_a = animation.speed) !== null && _a !== void 0 ? _a : 0);
-        return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * 3.6) % maxValue;
-    }
 }
 exports.EmitterInstance = EmitterInstance;

package/cjs/Emitters.js

@@ -1,18 +1,9 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Emitters = void 0;
 const engine_1 = require("@tsparticles/engine");
-const Emitter_1 = require("./Options/Classes/Emitter");
-const EmitterInstance_1 = require("./EmitterInstance");
+const Emitter_js_1 = require("./Options/Classes/Emitter.js");
+const EmitterInstance_js_1 = require("./EmitterInstance.js");
 class Emitters {
     constructor(engine, container) {
         this.container = container;
@@ -26,7 +17,7 @@ class Emitters {
             },
             value: [],
         };
-        container.getEmitter = (idxOrName) => idxOrName === undefined || typeof idxOrName === "number"
+        container.getEmitter = (idxOrName) => idxOrName === undefined || (0, engine_1.isNumber)(idxOrName)
             ? this.array[idxOrName || 0]
             : this.array.find((t) => t.name === idxOrName);
         container.addEmitter = (options, position) => this.addEmitter(options, position);
@@ -50,56 +41,58 @@ class Emitters {
         };
     }
     addEmitter(options, position) {
-        const emitterOptions = new Emitter_1.Emitter();
+        const emitterOptions = new Emitter_js_1.Emitter();
         emitterOptions.load(options);
-        const emitter = new EmitterInstance_1.EmitterInstance(this._engine, this, this.container, emitterOptions, position);
+        const emitter = new EmitterInstance_js_1.EmitterInstance(this._engine, this, this.container, emitterOptions, position);
         this.array.push(emitter);
         return emitter;
     }
     handleClickMode(mode) {
         const emitterOptions = this.emitters, modeEmitters = this.interactivityEmitters;
-        if (mode === "emitter") {
-            let emittersModeOptions;
-            if (modeEmitters && modeEmitters.value instanceof Array) {
-                if (modeEmitters.value.length > 0 && modeEmitters.random.enable) {
-                    emittersModeOptions = [];
-                    const usedIndexes = [];
-                    for (let i = 0; i < modeEmitters.random.count; i++) {
-                        const idx = (0, engine_1.arrayRandomIndex)(modeEmitters.value);
-                        if (usedIndexes.includes(idx) && usedIndexes.length < modeEmitters.value.length) {
-                            i--;
-                            continue;
-                        }
-                        usedIndexes.push(idx);
-                        emittersModeOptions.push((0, engine_1.itemFromArray)(modeEmitters.value, idx));
+        if (mode !== "emitter") {
+            return;
+        }
+        let emittersModeOptions;
+        if (modeEmitters && (0, engine_1.isArray)(modeEmitters.value)) {
+            if (modeEmitters.value.length > 0 && modeEmitters.random.enable) {
+                emittersModeOptions = [];
+                const usedIndexes = [];
+                for (let i = 0; i < modeEmitters.random.count; i++) {
+                    const idx = (0, engine_1.arrayRandomIndex)(modeEmitters.value);
+                    if (usedIndexes.includes(idx) && usedIndexes.length < modeEmitters.value.length) {
+                        i--;
+                        continue;
                     }
-                }
-                else {
-                    emittersModeOptions = modeEmitters.value;
+                    usedIndexes.push(idx);
+                    emittersModeOptions.push((0, engine_1.itemFromArray)(modeEmitters.value, idx));
                 }
             }
             else {
-                emittersModeOptions = modeEmitters === null || modeEmitters === void 0 ? void 0 : modeEmitters.value;
+                emittersModeOptions = modeEmitters.value;
             }
-            const emittersOptions = emittersModeOptions !== null && emittersModeOptions !== void 0 ? emittersModeOptions : emitterOptions, ePosition = this.container.interactivity.mouse.clickPosition;
-            (0, engine_1.executeOnSingleOrMultiple)(emittersOptions, (emitter) => {
-                this.addEmitter(emitter, ePosition);
-            });
         }
+        else {
+            emittersModeOptions = modeEmitters?.value;
+        }
+        const emittersOptions = emittersModeOptions ?? emitterOptions, ePosition = this.container.interactivity.mouse.clickPosition;
+        (0, engine_1.executeOnSingleOrMultiple)(emittersOptions, (emitter) => {
+            this.addEmitter(emitter, ePosition);
+        });
     }
-    init() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.emitters = this.container.actualOptions.emitters;
-            this.interactivityEmitters = this.container.actualOptions.interactivity.modes.emitters;
-            if (this.emitters instanceof Array) {
-                for (const emitterOptions of this.emitters) {
-                    this.addEmitter(emitterOptions);
-                }
-            }
-            else {
-                this.addEmitter(this.emitters);
+    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) {
+                this.addEmitter(emitterOptions);
             }
-        });
+        }
+        else {
+            this.addEmitter(this.emitters);
+        }
     }
     pause() {
         for (const emitter of this.array) {

package/cjs/Options/Classes/Emitter.js

@@ -2,28 +2,28 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Emitter = void 0;
 const engine_1 = require("@tsparticles/engine");
-const EmitterLife_1 = require("./EmitterLife");
-const EmitterRate_1 = require("./EmitterRate");
-const EmitterSize_1 = require("./EmitterSize");
+const EmitterLife_js_1 = require("./EmitterLife.js");
+const EmitterRate_js_1 = require("./EmitterRate.js");
+const EmitterSize_js_1 = require("./EmitterSize.js");
 class Emitter {
     constructor() {
         this.autoPlay = true;
         this.fill = true;
-        this.life = new EmitterLife_1.EmitterLife();
-        this.rate = new EmitterRate_1.EmitterRate();
+        this.life = new EmitterLife_js_1.EmitterLife();
+        this.rate = new EmitterRate_js_1.EmitterRate();
         this.shape = "square";
         this.startCount = 0;
     }
     load(data) {
-        if (data === undefined) {
+        if (!data) {
             return;
         }
         if (data.autoPlay !== undefined) {
             this.autoPlay = data.autoPlay;
         }
         if (data.size !== undefined) {
-            if (this.size === undefined) {
-                this.size = new EmitterSize_1.EmitterSize();
+            if (!this.size) {
+                this.size = new EmitterSize_js_1.EmitterSize();
             }
             this.size.load(data.size);
         }

package/cjs/Options/Classes/EmitterLife.js

@@ -1,22 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmitterLife = void 0;
+const engine_1 = require("@tsparticles/engine");
 class EmitterLife {
     constructor() {
         this.wait = false;
     }
     load(data) {
-        if (data === undefined) {
+        if (!data) {
             return;
         }
         if (data.count !== undefined) {
             this.count = data.count;
         }
         if (data.delay !== undefined) {
-            this.delay = data.delay;
+            this.delay = (0, engine_1.setRangeValue)(data.delay);
         }
         if (data.duration !== undefined) {
-            this.duration = data.duration;
+            this.duration = (0, engine_1.setRangeValue)(data.duration);
         }
         if (data.wait !== undefined) {
             this.wait = data.wait;

package/cjs/Shapes/Circle/CircleShape.js

@@ -18,7 +18,7 @@ class CircleShape {
             else {
                 return -theta;
             }
-        }, radius = (x, y, theta) => (x * y) / Math.sqrt(Math.pow((y * Math.cos(theta)), 2) + Math.pow((x * Math.sin(theta)), 2)), [a, b] = [size.width / 2, size.height / 2], randomTheta = generateTheta(a, b), maxRadius = radius(a, b, randomTheta), randomRadius = fill ? maxRadius * Math.sqrt((0, engine_1.getRandom)()) : maxRadius;
+        }, radius = (x, y, theta) => (x * y) / Math.sqrt((y * Math.cos(theta)) ** 2 + (x * Math.sin(theta)) ** 2), [a, b] = [size.width / 2, size.height / 2], randomTheta = generateTheta(a, b), maxRadius = radius(a, b, randomTheta), randomRadius = fill ? maxRadius * Math.sqrt((0, engine_1.getRandom)()) : maxRadius;
         return {
             x: position.x + randomRadius * Math.cos(randomTheta),
             y: position.y + randomRadius * Math.sin(randomTheta),