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

package/214.min.js

@@ -0,0 +1,2 @@
+/*! For license information please see 214.min.js.LICENSE.txt */
+(this.webpackChunk_tsparticles_plugin_emitters=this.webpackChunk_tsparticles_plugin_emitters||[]).push([[214],{214(t,i,e){e.d(i,{EmittersPlugin:()=>m});var s=e(303);class o{constructor(){this.wait=!1}load(t){(0,s.isNull)(t)||(void 0!==t.count&&(this.count=t.count),void 0!==t.delay&&(this.delay=(0,s.setRangeValue)(t.delay)),void 0!==t.duration&&(this.duration=(0,s.setRangeValue)(t.duration)),void 0!==t.wait&&(this.wait=t.wait))}}class n{constructor(){this.quantity=1,this.delay=.1}load(t){(0,s.isNull)(t)||(void 0!==t.quantity&&(this.quantity=(0,s.setRangeValue)(t.quantity)),void 0!==t.delay&&(this.delay=(0,s.setRangeValue)(t.delay)))}}class a{constructor(){this.color=!1,this.opacity=!1}load(t){(0,s.isNull)(t)||(void 0!==t.color&&(this.color=t.color),void 0!==t.opacity&&(this.opacity=t.opacity))}}class r{constructor(){this.options={},this.replace=new a,this.type="square"}load(t){(0,s.isNull)(t)||(void 0!==t.options&&(this.options=(0,s.deepExtend)({},t.options??{})),this.replace.load(t.replace),void 0!==t.type&&(this.type=t.type))}}class h{constructor(){this.mode=s.PixelMode.percent,this.height=0,this.width=0}load(t){(0,s.isNull)(t)||(void 0!==t.mode&&(this.mode=t.mode),void 0!==t.height&&(this.height=t.height),void 0!==t.width&&(this.width=t.width))}}class l{constructor(){this.autoPlay=!0,this.fill=!0,this.life=new o,this.rate=new n,this.shape=new r,this.startCount=0}load(t){(0,s.isNull)(t)||(void 0!==t.autoPlay&&(this.autoPlay=t.autoPlay),void 0!==t.size&&(this.size??=new h,this.size.load(t.size)),void 0!==t.direction&&(this.direction=t.direction),this.domId=t.domId,void 0!==t.fill&&(this.fill=t.fill),this.life.load(t.life),this.name=t.name,this.particles=(0,s.executeOnSingleOrMultiple)(t.particles,(t=>(0,s.deepExtend)({},t))),this.rate.load(t.rate),this.shape.load(t.shape),void 0!==t.position&&(this.position={},void 0!==t.position.x&&(this.position.x=(0,s.setRangeValue)(t.position.x)),void 0!==t.position.y&&(this.position.y=(0,s.setRangeValue)(t.position.y))),void 0!==t.spawnColor&&(this.spawnColor??=new s.AnimatableColor,this.spawnColor.load(t.spawnColor)),void 0!==t.startCount&&(this.startCount=t.startCount))}}var c=e(271);function d(t,i){t.color?t.color.value=i:t.color={value:i}}class u{constructor(t,i,e,o,n){this.emitters=i,this.container=e,this._destroy=()=>{this._mutationObserver?.disconnect(),this._mutationObserver=void 0,this._resizeObserver?.disconnect(),this._resizeObserver=void 0,this.emitters.removeEmitter(this),this._engine.dispatchEvent("emitterDestroyed",{container:this.container,data:{emitter:this}})},this._prepareToDie=()=>{if(this._paused)return;const t=void 0!==this.options.life.duration?(0,s.getRangeValue)(this.options.life.duration):void 0;(this._lifeCount>0||this._immortal)&&void 0!==t&&t>0&&(this._duration=t*s.millisecondsToSeconds)},this._setColorAnimation=(t,i,e,o=1)=>{const n=this.container;if(!t.enable)return i;const a=(0,s.randomInRangeValue)(t.offset),r=(0,s.getRangeValue)(this.options.rate.delay),h=n.retina.reduceFactor?r*s.millisecondsToSeconds/n.retina.reduceFactor:1/0;return(i+(0,s.getRangeValue)(t.speed)*n.fpsLimit/h+a*o)%e},this._engine=t,this._currentDuration=0,this._currentEmitDelay=0,this._currentSpawnDelay=0,this._initialPosition=n,o instanceof l?this.options=o:(this.options=new l,this.options.load(o)),this._spawnDelay=e.retina.reduceFactor?(0,s.getRangeValue)(this.options.life.delay??0)*s.millisecondsToSeconds/e.retina.reduceFactor:1/0,this.position=this._initialPosition??this._calcPosition(),this.name=this.options.name,this.fill=this.options.fill,this._firstSpawn=!this.options.life.wait,this._startParticlesAdded=!1;const a=(0,s.deepExtend)({},this.options.particles);if(a.move??={},a.move.direction??=this.options.direction,this.options.spawnColor&&(this.spawnColor=(0,s.rangeColorToHsl)(this._engine,this.options.spawnColor)),this._paused=!this.options.autoPlay,this._particlesOptions=a,this._size=this._calcSize(),this.size=(0,s.getSize)(this._size,this.container.canvas.size),this._lifeCount=this.options.life.count??-1,this._immortal=this._lifeCount<=0,this.options.domId){const t=(0,s.safeDocument)().getElementById(this.options.domId);t&&(this._mutationObserver=new MutationObserver((()=>{this.resize()})),this._resizeObserver=new ResizeObserver((()=>{this.resize()})),this._mutationObserver.observe(t,{attributes:!0,attributeFilter:["style","width","height"]}),this._resizeObserver.observe(t))}const r=this.options.shape,h=this._engine.emitterShapeManager?.getShapeGenerator(r.type);h&&(this._shape=h.generate(this.position,this.size,this.fill,r.options)),this._engine.dispatchEvent("emitterCreated",{container:e,data:{emitter:this}}),this.play()}externalPause(){this._paused=!0,this.pause()}externalPlay(){this._paused=!1,this.play()}async init(){await(this._shape?.init())}pause(){this._paused||delete this._emitDelay}play(){if(this._paused)return;if(!(this._lifeCount>0||this._immortal)&&this.options.life.count||!(this._firstSpawn||this._currentSpawnDelay>=(this._spawnDelay??0)))return;const t=this.container;if(void 0===this._emitDelay){const i=(0,s.getRangeValue)(this.options.rate.delay);this._emitDelay=t.retina.reduceFactor?i*s.millisecondsToSeconds/t.retina.reduceFactor:1/0}(this._lifeCount>0||this._immortal)&&this._prepareToDie()}resize(){const t=this._initialPosition,i=this.container;this.position=t&&(0,s.isPointInside)(t,i.canvas.size,s.Vector.origin)?t:this._calcPosition(),this._size=this._calcSize(),this.size=(0,s.getSize)(this._size,i.canvas.size),this._shape?.resize(this.position,this.size)}update(t){if(this._paused)return;const i=this.container;this._firstSpawn&&(this._firstSpawn=!1,this._currentSpawnDelay=this._spawnDelay??0,this._currentEmitDelay=this._emitDelay??0),this._startParticlesAdded||(this._startParticlesAdded=!0,this._emitParticles(this.options.startCount)),void 0!==this._duration&&(this._currentDuration+=t.value,this._currentDuration>=this._duration&&(this.pause(),void 0!==this._spawnDelay&&delete this._spawnDelay,this._immortal||this._lifeCount--,this._lifeCount>0||this._immortal?(this.position=this._calcPosition(),this._shape?.resize(this.position,this.size),this._spawnDelay=i.retina.reduceFactor?(0,s.getRangeValue)(this.options.life.delay??0)*s.millisecondsToSeconds/i.retina.reduceFactor:1/0):this._destroy(),this._currentDuration-=this._duration,delete this._duration)),void 0!==this._spawnDelay&&(this._currentSpawnDelay+=t.value,this._currentSpawnDelay>=this._spawnDelay&&(this._engine.dispatchEvent("emitterPlay",{container:this.container}),this.play(),this._currentSpawnDelay-=this._currentSpawnDelay,delete this._spawnDelay)),void 0!==this._emitDelay&&(this._currentEmitDelay+=t.value,this._currentEmitDelay>=this._emitDelay&&(this._emit(),this._currentEmitDelay-=this._emitDelay))}_calcPosition(){const t=this.container;if(this.options.domId){const i=(0,s.safeDocument)().getElementById(this.options.domId);if(i){const e=i.getBoundingClientRect(),o=t.retina.pixelRatio;return{x:(e.x+e.width*s.half)*o,y:(e.y+e.height*s.half)*o}}}return(0,s.calcPositionOrRandomFromSizeRanged)({size:t.canvas.size,position:this.options.position})}_calcSize(){const t=this.container;if(this.options.domId){const i=(0,s.safeDocument)().getElementById(this.options.domId);if(i){const e=i.getBoundingClientRect();return{width:e.width*t.retina.pixelRatio,height:e.height*t.retina.pixelRatio,mode:s.PixelMode.precise}}}return this.options.size??(()=>{const t=new h;return t.load({height:0,mode:s.PixelMode.percent,width:0}),t})()}_emit(){if(this._paused)return;const t=(0,s.getRangeValue)(this.options.rate.quantity);this._emitParticles(t)}_emitParticles(t){const i=(0,s.itemFromSingleOrMultiple)(this._particlesOptions),e=this.container.retina.reduceFactor;for(let o=0;o<t*e;o++){const t=(0,s.deepExtend)({},i);if(this.spawnColor){const i=this.options.spawnColor?.animation;if(i){const t={h:s.hMax,s:s.sMax,l:s.lMax},e=3.6;this.spawnColor.h=this._setColorAnimation(i.h,this.spawnColor.h,t.h,e),this.spawnColor.s=this._setColorAnimation(i.s,this.spawnColor.s,t.s),this.spawnColor.l=this._setColorAnimation(i.l,this.spawnColor.l,t.l)}d(t,this.spawnColor)}const e=this.options.shape;let o=this.position;if(this._shape){const i=this._shape.randomPosition();if(i){o=i.position;const s=e.replace;s.color&&i.color&&d(t,i.color),s.opacity&&(t.opacity?t.opacity.value=i.opacity:t.opacity={value:i.opacity})}else o=null}o&&this.container.particles.addParticle(o,t)}}}class p{constructor(t,i){this.container=i,this._engine=t,this.array=[],this.emitters=[],this.interactivityEmitters={random:{count:1,enable:!1},value:[]};i.getEmitter=t=>void 0===t||(0,s.isNumber)(t)?this.array[t??0]:this.array.find((i=>i.name===t)),i.addEmitter=async(t,i)=>this.addEmitter(t,i),i.removeEmitter=t=>{const e=i.getEmitter(t);e&&this.removeEmitter(e)},i.playEmitter=t=>{const e=i.getEmitter(t);e&&e.externalPlay()},i.pauseEmitter=t=>{const e=i.getEmitter(t);e&&e.externalPause()}}async addEmitter(t,i){const e=new l;e.load(t);const s=new u(this._engine,this,this.container,e,i);return await s.init(),this.array.push(s),s}handleClickMode(t){const i=this.interactivityEmitters;if(t!==c.c.emitter)return;let e;if((0,s.isArray)(i.value)){const t=0;if(i.value.length>t&&i.random.enable){e=[];const t=[];for(let o=0;o<i.random.count;o++){const n=(0,s.arrayRandomIndex)(i.value);if(t.includes(n)&&t.length<i.value.length){o--;continue}t.push(n);const a=(0,s.itemFromArray)(i.value,n);a&&e.push(a)}}else e=i.value}else e=i.value;const o=e,n=this.container.interactivity.mouse.clickPosition;(0,s.executeOnSingleOrMultiple)(o,(async t=>{await this.addEmitter(t,n)}))}async init(){if(this.emitters=this.container.actualOptions.emitters,this.interactivityEmitters=this.container.actualOptions.interactivity.modes.emitters,(0,s.isArray)(this.emitters))for(const t of this.emitters)await this.addEmitter(t);else await this.addEmitter(this.emitters)}pause(){for(const t of this.array)t.pause()}play(){for(const t of this.array)t.play()}removeEmitter(t){const i=this.array.indexOf(t);i>=0&&this.array.splice(i,1)}resize(){for(const t of this.array)t.resize()}stop(){this.array=[]}update(t){for(const i of this.array)i.update(t)}}class m{constructor(t){this._engine=t,this.id="emitters"}getPlugin(t){return Promise.resolve(new p(this._engine,t))}loadOptions(t,i){if(!this.needsPlugin(t)&&!this.needsPlugin(i))return;i?.emitters&&(t.emitters=(0,s.executeOnSingleOrMultiple)(i.emitters,(t=>{const i=new l;return i.load(t),i})));const e=i?.interactivity?.modes?.emitters;if(e)if((0,s.isArray)(e))t.interactivity.modes.emitters={random:{count:1,enable:!0},value:e.map((t=>{const i=new l;return i.load(t),i}))};else{const i=e;if((0,s.isArray)(i.value))t.interactivity.modes.emitters={random:{count:i.random.count,enable:i.random.enable},value:i.value.map((t=>{const i=new l;return i.load(t),i}))};else{const e=new l;e.load(i.value),t.interactivity.modes.emitters={random:{count:i.random.count,enable:i.random.enable},value:e}}}}needsPlugin(t){if(!t)return!1;const i=t.emitters;return(0,s.isArray)(i)&&!!i.length||void 0!==i||!!t.interactivity?.events?.onClick?.mode&&(0,s.isInArray)(c.c.emitter,t.interactivity.events.onClick.mode)}}}}]);

package/214.min.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! tsParticles Emitters Plugin v4.0.0-alpha.0 by Matteo Bruni */

package/921.min.js

@@ -0,0 +1,2 @@
+/*! For license information please see 921.min.js.LICENSE.txt */
+(this.webpackChunk_tsparticles_plugin_emitters=this.webpackChunk_tsparticles_plugin_emitters||[]).push([[921],{921(e,t,a){a.d(t,{ShapeManager:()=>s});const r=new Map;class s{addShapeGenerator(e,t){this.getShapeGenerator(e)||r.set(e,t)}getShapeGenerator(e){return r.get(e)}getSupportedShapeGenerators(){return r.keys()}}}}]);

package/921.min.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! tsParticles Emitters Plugin v4.0.0-alpha.0 by Matteo Bruni */

package/browser/EmitterInstance.js

@@ -1,7 +1,7 @@
-import { PixelMode, Vector, calcPositionOrRandomFromSizeRanged, deepExtend, getRangeValue, getSize, isPointInside, itemFromSingleOrMultiple, millisecondsToSeconds, randomInRange, rangeColorToHsl, } from "@tsparticles/engine";
+import { PixelMode, Vector, calcPositionOrRandomFromSizeRanged, deepExtend, getRangeValue, getSize, hMax, half, isPointInside, itemFromSingleOrMultiple, lMax, millisecondsToSeconds, randomInRangeValue, rangeColorToHsl, sMax, safeDocument, } from "@tsparticles/engine";
 import { Emitter } from "./Options/Classes/Emitter.js";
 import { EmitterSize } from "./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;
@@ -33,7 +33,7 @@ export class EmitterInstance {
             if (this._paused) {
                 return;
             }
-            const duration = this.options.life?.duration !== undefined ? getRangeValue(this.options.life.duration) : undefined, minDuration = 0, minLifeCount = 0;
+            const duration = this.options.life.duration !== undefined ? getRangeValue(this.options.life.duration) : undefined, minDuration = 0, minLifeCount = 0;
             if ((this._lifeCount > minLifeCount || this._immortal) && duration !== undefined && duration > minDuration) {
                 this._duration = duration * millisecondsToSeconds;
             }
@@ -43,9 +43,9 @@ export class EmitterInstance {
             if (!animation.enable) {
                 return initValue;
             }
-            const colorOffset = randomInRange(animation.offset), delay = getRangeValue(this.options.rate.delay), emitFactor = container.retina.reduceFactor
+            const colorOffset = randomInRangeValue(animation.offset), delay = getRangeValue(this.options.rate.delay), emitFactor = container.retina.reduceFactor
                 ? (delay * millisecondsToSeconds) / container.retina.reduceFactor
-                : Infinity, defaultColorSpeed = 0, colorSpeed = getRangeValue(animation.speed ?? defaultColorSpeed);
+                : Infinity, colorSpeed = getRangeValue(animation.speed);
             return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * factor) % maxValue;
         };
         this._engine = engine;
@@ -69,8 +69,7 @@ export class EmitterInstance {
         this.fill = this.options.fill;
         this._firstSpawn = !this.options.life.wait;
         this._startParticlesAdded = false;
-        let particlesOptions = deepExtend({}, this.options.particles);
-        particlesOptions ??= {};
+        const particlesOptions = deepExtend({}, this.options.particles);
         particlesOptions.move ??= {};
         particlesOptions.move.direction ??= this.options.direction;
         if (this.options.spawnColor) {
@@ -83,7 +82,7 @@ export class EmitterInstance {
         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 = safeDocument().getElementById(this.options.domId);
             if (element) {
                 this._mutationObserver = new MutationObserver(() => {
                     this.resize();
@@ -217,7 +216,7 @@ export class EmitterInstance {
     _calcPosition() {
         const container = this.container;
         if (this.options.domId) {
-            const element = document.getElementById(this.options.domId);
+            const element = safeDocument().getElementById(this.options.domId);
             if (element) {
                 const elRect = element.getBoundingClientRect(), pxRatio = container.retina.pixelRatio;
                 return {
@@ -234,7 +233,7 @@ export class EmitterInstance {
     _calcSize() {
         const container = this.container;
         if (this.options.domId) {
-            const element = document.getElementById(this.options.domId);
+            const element = safeDocument().getElementById(this.options.domId);
             if (element) {
                 const elRect = element.getBoundingClientRect();
                 return {
@@ -270,9 +269,9 @@ export class EmitterInstance {
                 const hslAnimation = this.options.spawnColor?.animation;
                 if (hslAnimation) {
                     const maxValues = {
-                        h: 360,
-                        s: 100,
-                        l: 100,
+                        h: hMax,
+                        s: sMax,
+                        l: 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/browser/Emitters.js

@@ -48,12 +48,12 @@ export class Emitters {
         return emitter;
     }
     handleClickMode(mode) {
-        const emitterOptions = this.emitters, modeEmitters = this.interactivityEmitters;
+        const modeEmitters = this.interactivityEmitters;
         if (mode !== EmitterClickMode.emitter) {
             return;
         }
         let emittersModeOptions;
-        if (modeEmitters && isArray(modeEmitters.value)) {
+        if (isArray(modeEmitters.value)) {
             const minLength = 0;
             if (modeEmitters.value.length > minLength && modeEmitters.random.enable) {
                 emittersModeOptions = [];
@@ -65,7 +65,11 @@ export class Emitters {
                         continue;
                     }
                     usedIndexes.push(idx);
-                    emittersModeOptions.push(itemFromArray(modeEmitters.value, idx));
+                    const selectedOptions = itemFromArray(modeEmitters.value, idx);
+                    if (!selectedOptions) {
+                        continue;
+                    }
+                    emittersModeOptions.push(selectedOptions);
                 }
             }
             else {
@@ -73,9 +77,9 @@ export class Emitters {
             }
         }
         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 executeOnSingleOrMultiple(emittersOptions, async (emitter) => {
             await this.addEmitter(emitter, ePosition);
         });
@@ -83,9 +87,6 @@ export class Emitters {
     async init() {
         this.emitters = this.container.actualOptions.emitters;
         this.interactivityEmitters = this.container.actualOptions.interactivity.modes.emitters;
-        if (!this.emitters) {
-            return;
-        }
         if (isArray(this.emitters)) {
             for (const emitterOptions of this.emitters) {
                 await this.addEmitter(emitterOptions);

package/browser/EmittersPlugin.js

@@ -38,42 +38,29 @@ export class EmittersPlugin {
             }
             else {
                 const emitterMode = interactivityEmitters;
-                if (emitterMode.value !== undefined) {
-                    const defaultCount = 1;
-                    if (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();
-                                tmp.load(s);
-                                return tmp;
-                            }),
-                        };
-                    }
-                    else {
-                        const tmp = new Emitter();
-                        tmp.load(emitterMode.value);
-                        options.interactivity.modes.emitters = {
-                            random: {
-                                count: emitterMode.random.count ?? defaultCount,
-                                enable: emitterMode.random.enable ?? false,
-                            },
-                            value: tmp,
-                        };
-                    }
+                if (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();
+                            tmp.load(s);
+                            return tmp;
+                        }),
+                    };
                 }
                 else {
-                    const emitterOptions = (options.interactivity.modes.emitters = {
+                    const tmp = new 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(),
-                    });
-                    emitterOptions.value.load(interactivityEmitters);
+                        value: tmp,
+                    };
                 }
             }
         }

package/browser/Options/Classes/Emitter.js

@@ -20,9 +20,7 @@ export class Emitter {
             this.autoPlay = data.autoPlay;
         }
         if (data.size !== undefined) {
-            if (!this.size) {
-                this.size = new EmitterSize();
-            }
+            this.size ??= new EmitterSize();
             this.size.load(data.size);
         }
         if (data.direction !== undefined) {
@@ -49,9 +47,7 @@ export class Emitter {
             }
         }
         if (data.spawnColor !== undefined) {
-            if (this.spawnColor === undefined) {
-                this.spawnColor = new AnimatableColor();
-            }
+            this.spawnColor ??= new AnimatableColor();
             this.spawnColor.load(data.spawnColor);
         }
         if (data.startCount !== undefined) {

package/browser/ShapeManager.js

@@ -1,8 +1,5 @@
 const shapeGeneratorss = new Map();
 export class ShapeManager {
-    constructor(engine) {
-        this._engine = engine;
-    }
     addShapeGenerator(name, generator) {
         if (!this.getShapeGenerator(name)) {
             shapeGeneratorss.set(name, generator);

package/browser/index.js

@@ -1,22 +1,14 @@
-import { EmittersPlugin } from "./EmittersPlugin.js";
-import { ShapeManager } from "./ShapeManager.js";
-export async function loadEmittersPlugin(engine, refresh = true) {
-    engine.checkVersion("3.9.0");
-    if (!engine.emitterShapeManager) {
-        engine.emitterShapeManager = new ShapeManager(engine);
-    }
-    if (!engine.addEmitterShapeGenerator) {
-        engine.addEmitterShapeGenerator = (name, generator) => {
-            engine.emitterShapeManager?.addShapeGenerator(name, generator);
+export function loadEmittersPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.0");
+    engine.register(async (e) => {
+        const { ShapeManager } = await import("./ShapeManager.js"), { EmittersPlugin } = await import("./EmittersPlugin.js");
+        e.emitterShapeManager ??= new ShapeManager();
+        e.addEmitterShapeGenerator ??= (name, generator) => {
+            e.emitterShapeManager?.addShapeGenerator(name, generator);
         };
-    }
-    const plugin = new EmittersPlugin(engine);
-    await engine.addPlugin(plugin, refresh);
+        const plugin = new EmittersPlugin(e);
+        e.addPlugin(plugin);
+    });
 }
-export * from "./EmitterContainer.js";
 export * from "./EmitterShapeBase.js";
-export * from "./EmittersEngine.js";
-export * from "./IEmitterShape.js";
-export * from "./IEmitterShapeGenerator.js";
 export * from "./Enums/EmitterClickMode.js";
-export * from "./IRandomPositionData.js";

package/cjs/EmitterContainer.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/cjs/EmitterInstance.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmitterInstance = void 0;
-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;
+import { PixelMode, Vector, calcPositionOrRandomFromSizeRanged, deepExtend, getRangeValue, getSize, hMax, half, isPointInside, itemFromSingleOrMultiple, lMax, millisecondsToSeconds, randomInRangeValue, rangeColorToHsl, sMax, safeDocument, } from "@tsparticles/engine";
+import { Emitter } from "./Options/Classes/Emitter.js";
+import { EmitterSize } from "./Options/Classes/EmitterSize.js";
+const defaultLifeDelay = 0, minLifeCount = 0, defaultSpawnDelay = 0, defaultEmitDelay = 0, defaultLifeCount = -1, defaultColorAnimationFactor = 1;
 function setParticlesOptionsColor(particlesOptions, color) {
     if (particlesOptions.color) {
         particlesOptions.color.value = color;
@@ -15,7 +12,7 @@ function setParticlesOptionsColor(particlesOptions, color) {
         };
     }
 }
-class EmitterInstance {
+export class EmitterInstance {
     constructor(engine, emitters, container, options, position) {
         this.emitters = emitters;
         this.container = container;
@@ -36,9 +33,9 @@ class EmitterInstance {
             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 ? 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;
+                this._duration = duration * millisecondsToSeconds;
             }
         };
         this._setColorAnimation = (animation, initValue, maxValue, factor = defaultColorAnimationFactor) => {
@@ -46,9 +43,9 @@ class EmitterInstance {
             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
-                ? (delay * engine_1.millisecondsToSeconds) / container.retina.reduceFactor
-                : Infinity, defaultColorSpeed = 0, colorSpeed = (0, engine_1.getRangeValue)(animation.speed ?? defaultColorSpeed);
+            const colorOffset = randomInRangeValue(animation.offset), delay = getRangeValue(this.options.rate.delay), emitFactor = container.retina.reduceFactor
+                ? (delay * millisecondsToSeconds) / container.retina.reduceFactor
+                : Infinity, colorSpeed = getRangeValue(animation.speed);
             return (initValue + (colorSpeed * container.fpsLimit) / emitFactor + colorOffset * factor) % maxValue;
         };
         this._engine = engine;
@@ -56,15 +53,15 @@ class EmitterInstance {
         this._currentEmitDelay = 0;
         this._currentSpawnDelay = 0;
         this._initialPosition = position;
-        if (options instanceof Emitter_js_1.Emitter) {
+        if (options instanceof Emitter) {
             this.options = options;
         }
         else {
-            this.options = new Emitter_js_1.Emitter();
+            this.options = new Emitter();
             this.options.load(options);
         }
         this._spawnDelay = container.retina.reduceFactor
-            ? ((0, engine_1.getRangeValue)(this.options.life.delay ?? defaultLifeDelay) * engine_1.millisecondsToSeconds) /
+            ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
                 container.retina.reduceFactor
             : Infinity;
         this.position = this._initialPosition ?? this._calcPosition();
@@ -72,21 +69,20 @@ class EmitterInstance {
         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 = deepExtend({}, this.options.particles);
         particlesOptions.move ??= {};
         particlesOptions.move.direction ??= this.options.direction;
         if (this.options.spawnColor) {
-            this.spawnColor = (0, engine_1.rangeColorToHsl)(this._engine, this.options.spawnColor);
+            this.spawnColor = rangeColorToHsl(this._engine, this.options.spawnColor);
         }
         this._paused = !this.options.autoPlay;
         this._particlesOptions = particlesOptions;
         this._size = this._calcSize();
-        this.size = (0, engine_1.getSize)(this._size, this.container.canvas.size);
+        this.size = getSize(this._size, this.container.canvas.size);
         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 = safeDocument().getElementById(this.options.domId);
             if (element) {
                 this._mutationObserver = new MutationObserver(() => {
                     this.resize();
@@ -140,9 +136,9 @@ class EmitterInstance {
         }
         const container = this.container;
         if (this._emitDelay === undefined) {
-            const delay = (0, engine_1.getRangeValue)(this.options.rate.delay);
+            const delay = getRangeValue(this.options.rate.delay);
             this._emitDelay = container.retina.reduceFactor
-                ? (delay * engine_1.millisecondsToSeconds) / container.retina.reduceFactor
+                ? (delay * millisecondsToSeconds) / container.retina.reduceFactor
                 : Infinity;
         }
         if (this._lifeCount > minLifeCount || this._immortal) {
@@ -152,11 +148,11 @@ class EmitterInstance {
     resize() {
         const initialPosition = this._initialPosition, container = this.container;
         this.position =
-            initialPosition && (0, engine_1.isPointInside)(initialPosition, container.canvas.size, engine_1.Vector.origin)
+            initialPosition && isPointInside(initialPosition, container.canvas.size, Vector.origin)
                 ? initialPosition
                 : this._calcPosition();
         this._size = this._calcSize();
-        this.size = (0, engine_1.getSize)(this._size, container.canvas.size);
+        this.size = getSize(this._size, container.canvas.size);
         this._shape?.resize(this.position, this.size);
     }
     update(delta) {
@@ -187,7 +183,7 @@ class EmitterInstance {
                     this.position = this._calcPosition();
                     this._shape?.resize(this.position, this.size);
                     this._spawnDelay = container.retina.reduceFactor
-                        ? ((0, engine_1.getRangeValue)(this.options.life.delay ?? defaultLifeDelay) * engine_1.millisecondsToSeconds) /
+                        ? (getRangeValue(this.options.life.delay ?? defaultLifeDelay) * millisecondsToSeconds) /
                             container.retina.reduceFactor
                         : Infinity;
                 }
@@ -220,7 +216,7 @@ class EmitterInstance {
     _calcPosition() {
         const container = this.container;
         if (this.options.domId) {
-            const element = document.getElementById(this.options.domId);
+            const element = safeDocument().getElementById(this.options.domId);
             if (element) {
                 const elRect = element.getBoundingClientRect(), pxRatio = container.retina.pixelRatio;
                 return {
@@ -229,7 +225,7 @@ class EmitterInstance {
                 };
             }
         }
-        return (0, engine_1.calcPositionOrRandomFromSizeRanged)({
+        return calcPositionOrRandomFromSizeRanged({
             size: container.canvas.size,
             position: this.options.position,
         });
@@ -237,22 +233,22 @@ class EmitterInstance {
     _calcSize() {
         const container = this.container;
         if (this.options.domId) {
-            const element = document.getElementById(this.options.domId);
+            const element = safeDocument().getElementById(this.options.domId);
             if (element) {
                 const elRect = element.getBoundingClientRect();
                 return {
                     width: elRect.width * container.retina.pixelRatio,
                     height: elRect.height * container.retina.pixelRatio,
-                    mode: engine_1.PixelMode.precise,
+                    mode: PixelMode.precise,
                 };
             }
         }
         return (this.options.size ??
             (() => {
-                const size = new EmitterSize_js_1.EmitterSize();
+                const size = new EmitterSize();
                 size.load({
                     height: 0,
-                    mode: engine_1.PixelMode.percent,
+                    mode: PixelMode.percent,
                     width: 0,
                 });
                 return size;
@@ -262,20 +258,20 @@ class EmitterInstance {
         if (this._paused) {
             return;
         }
-        const quantity = (0, engine_1.getRangeValue)(this.options.rate.quantity);
+        const quantity = getRangeValue(this.options.rate.quantity);
         this._emitParticles(quantity);
     }
     _emitParticles(quantity) {
-        const singleParticlesOptions = (0, engine_1.itemFromSingleOrMultiple)(this._particlesOptions), reduceFactor = this.container.retina.reduceFactor;
+        const singleParticlesOptions = itemFromSingleOrMultiple(this._particlesOptions), reduceFactor = this.container.retina.reduceFactor;
         for (let i = 0; i < quantity * reduceFactor; i++) {
-            const particlesOptions = (0, engine_1.deepExtend)({}, singleParticlesOptions);
+            const particlesOptions = deepExtend({}, singleParticlesOptions);
             if (this.spawnColor) {
                 const hslAnimation = this.options.spawnColor?.animation;
                 if (hslAnimation) {
                     const maxValues = {
-                        h: 360,
-                        s: 100,
-                        l: 100,
+                        h: hMax,
+                        s: sMax,
+                        l: 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);
@@ -314,4 +310,3 @@ class EmitterInstance {
         }
     }
 }
-exports.EmitterInstance = EmitterInstance;

package/cjs/EmitterShapeBase.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmitterShapeBase = void 0;
-class EmitterShapeBase {
+export class EmitterShapeBase {
     constructor(position, size, fill, options) {
         this.position = position;
         this.size = size;
@@ -13,4 +10,3 @@ class EmitterShapeBase {
         this.size = size;
     }
 }
-exports.EmitterShapeBase = EmitterShapeBase;

package/cjs/Emitters.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Emitters = void 0;
-const engine_1 = require("@tsparticles/engine");
-const Emitter_js_1 = require("./Options/Classes/Emitter.js");
-const EmitterClickMode_js_1 = require("./Enums/EmitterClickMode.js");
-const EmitterInstance_js_1 = require("./EmitterInstance.js");
-class Emitters {
+import { arrayRandomIndex, executeOnSingleOrMultiple, isArray, isNumber, itemFromArray, } from "@tsparticles/engine";
+import { Emitter } from "./Options/Classes/Emitter.js";
+import { EmitterClickMode } from "./Enums/EmitterClickMode.js";
+import { EmitterInstance } from "./EmitterInstance.js";
+export class Emitters {
     constructor(engine, container) {
         this.container = container;
         this._engine = engine;
@@ -19,7 +16,7 @@ class Emitters {
             value: [],
         };
         const defaultIndex = 0;
-        container.getEmitter = (idxOrName) => idxOrName === undefined || (0, engine_1.isNumber)(idxOrName)
+        container.getEmitter = (idxOrName) => idxOrName === undefined || isNumber(idxOrName)
             ? this.array[idxOrName ?? defaultIndex]
             : this.array.find(t => t.name === idxOrName);
         container.addEmitter = async (options, position) => this.addEmitter(options, position);
@@ -43,32 +40,36 @@ class Emitters {
         };
     }
     async addEmitter(options, position) {
-        const emitterOptions = new Emitter_js_1.Emitter();
+        const emitterOptions = new Emitter();
         emitterOptions.load(options);
-        const emitter = new EmitterInstance_js_1.EmitterInstance(this._engine, this, this.container, emitterOptions, position);
+        const emitter = new EmitterInstance(this._engine, this, this.container, emitterOptions, position);
         await emitter.init();
         this.array.push(emitter);
         return emitter;
     }
     handleClickMode(mode) {
-        const emitterOptions = this.emitters, modeEmitters = this.interactivityEmitters;
-        if (mode !== EmitterClickMode_js_1.EmitterClickMode.emitter) {
+        const modeEmitters = this.interactivityEmitters;
+        if (mode !== EmitterClickMode.emitter) {
             return;
         }
         let emittersModeOptions;
-        if (modeEmitters && (0, engine_1.isArray)(modeEmitters.value)) {
+        if (isArray(modeEmitters.value)) {
             const minLength = 0;
             if (modeEmitters.value.length > minLength && modeEmitters.random.enable) {
                 emittersModeOptions = [];
                 const usedIndexes = [];
                 for (let i = 0; i < modeEmitters.random.count; i++) {
-                    const idx = (0, engine_1.arrayRandomIndex)(modeEmitters.value);
+                    const idx = 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));
+                    const selectedOptions = itemFromArray(modeEmitters.value, idx);
+                    if (!selectedOptions) {
+                        continue;
+                    }
+                    emittersModeOptions.push(selectedOptions);
                 }
             }
             else {
@@ -76,20 +77,17 @@ class Emitters {
             }
         }
         else {
-            emittersModeOptions = modeEmitters?.value;
+            emittersModeOptions = modeEmitters.value;
         }
-        const emittersOptions = emittersModeOptions ?? emitterOptions, ePosition = this.container.interactivity.mouse.clickPosition;
-        void (0, engine_1.executeOnSingleOrMultiple)(emittersOptions, async (emitter) => {
+        const emittersOptions = emittersModeOptions, ePosition = this.container.interactivity.mouse.clickPosition;
+        void executeOnSingleOrMultiple(emittersOptions, async (emitter) => {
             await this.addEmitter(emitter, ePosition);
         });
     }
     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)) {
+        if (isArray(this.emitters)) {
             for (const emitterOptions of this.emitters) {
                 await this.addEmitter(emitterOptions);
             }
@@ -128,4 +126,3 @@ class Emitters {
         }
     }
 }
-exports.Emitters = Emitters;

package/cjs/EmittersEngine.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};