@tsparticles/plugin-emitters 3.0.0-alpha.0

package/tsparticles.plugin.emitters.min.js

@@ -0,0 +1,2 @@
+/*! For license information please see tsparticles.plugin.emitters.min.js.LICENSE.txt */
+!function(t,i){if("object"==typeof exports&&"object"==typeof module)module.exports=i(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],i);else{var e="object"==typeof exports?i(require("@tsparticles/engine")):i(t.window);for(var s in e)("object"==typeof exports?exports:t)[s]=e[s]}}(this,(t=>(()=>{"use strict";var i={533:i=>{i.exports=t}},e={};function s(t){var n=e[t];if(void 0!==n)return n.exports;var o=e[t]={exports:{}};return i[t](o,o.exports,s),o.exports}s.d=(t,i)=>{for(var e in i)s.o(i,e)&&!s.o(t,e)&&Object.defineProperty(t,e,{enumerable:!0,get:i[e]})},s.o=(t,i)=>Object.prototype.hasOwnProperty.call(t,i),s.r=t=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})};var n={};return(()=>{s.r(n),s.d(n,{loadEmittersPlugin:()=>v});var t=s(533);class i{randomPosition(i,e,s){const[n,o]=[e.width/2,e.height/2],a=((i,e)=>{const s=(0,t.getRandom)()/4,n=Math.atan(e/i*Math.tan(2*Math.PI*s)),o=(0,t.getRandom)();return o<.25?n:o<.5?Math.PI-n:o<.75?Math.PI+n:-n})(n,o),r=(c=a,(h=n)*(d=o)/Math.sqrt((d*Math.cos(c))**2+(h*Math.sin(c))**2)),l=s?r*Math.sqrt((0,t.getRandom)()):r;var h,d,c;return{x:i.x+l*Math.cos(a),y:i.y+l*Math.sin(a)}}}class e{constructor(){this.wait=!1}load(t){void 0!==t&&(void 0!==t.count&&(this.count=t.count),void 0!==t.delay&&(this.delay=t.delay),void 0!==t.duration&&(this.duration=t.duration),void 0!==t.wait&&(this.wait=t.wait))}}class o{constructor(){this.quantity=1,this.delay=.1}load(i){void 0!==i&&(void 0!==i.quantity&&(this.quantity=(0,t.setRangeValue)(i.quantity)),void 0!==i.delay&&(this.delay=(0,t.setRangeValue)(i.delay)))}}class a{constructor(){this.mode="percent",this.height=0,this.width=0}load(t){void 0!==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 r{constructor(){this.autoPlay=!0,this.fill=!0,this.life=new e,this.rate=new o,this.shape="square",this.startCount=0}load(i){void 0!==i&&(void 0!==i.autoPlay&&(this.autoPlay=i.autoPlay),void 0!==i.size&&(void 0===this.size&&(this.size=new a),this.size.load(i.size)),void 0!==i.direction&&(this.direction=i.direction),this.domId=i.domId,void 0!==i.fill&&(this.fill=i.fill),this.life.load(i.life),this.name=i.name,this.particles=(0,t.executeOnSingleOrMultiple)(i.particles,(i=>(0,t.deepExtend)({},i))),this.rate.load(i.rate),void 0!==i.shape&&(this.shape=i.shape),void 0!==i.position&&(this.position={},void 0!==i.position.x&&(this.position.x=(0,t.setRangeValue)(i.position.x)),void 0!==i.position.y&&(this.position.y=(0,t.setRangeValue)(i.position.y))),void 0!==i.spawnColor&&(void 0===this.spawnColor&&(this.spawnColor=new t.AnimatableColor),this.spawnColor.load(i.spawnColor)),void 0!==i.startCount&&(this.startCount=i.startCount))}}class l{constructor(i,e,s,n,o){var l,h,d,c,u,p,m,v;this.emitters=e,this.container=s,this._engine=i,this._currentDuration=0,this._currentEmitDelay=0,this._currentSpawnDelay=0,this._initialPosition=o,n instanceof r?this.options=n:(this.options=new r,this.options.load(n)),this._spawnDelay=1e3*(null!==(l=this.options.life.delay)&&void 0!==l?l:0)/this.container.retina.reduceFactor,this.position=null!==(h=this._initialPosition)&&void 0!==h?h:this.calcPosition(),this.name=this.options.name,this._shape=null===(d=this._engine.emitterShapeManager)||void 0===d?void 0:d.getShape(this.options.shape),this.fill=this.options.fill,this._firstSpawn=!this.options.life.wait,this._startParticlesAdded=!1;let y=(0,t.deepExtend)({},this.options.particles);null!=y||(y={}),null!==(c=y.move)&&void 0!==c||(y.move={}),null!==(u=(v=y.move).direction)&&void 0!==u||(v.direction=this.options.direction),this.options.spawnColor&&(this.spawnColor=(0,t.rangeColorToHsl)(this.options.spawnColor)),this._paused=!this.options.autoPlay,this._particlesOptions=y,this.size=null!==(p=this.options.size)&&void 0!==p?p:(()=>{const t=new a;return t.load({height:0,mode:"percent",width:0}),t})(),this._lifeCount=null!==(m=this.options.life.count)&&void 0!==m?m:-1,this._immortal=this._lifeCount<=0,this._engine.dispatchEvent("emitterCreated",{container:s,data:{emitter:this}}),this.play()}externalPause(){this._paused=!0,this.pause()}externalPlay(){this._paused=!1,this.play()}getPosition(){if(this.options.domId){const t=this.container,i=document.getElementById(this.options.domId);if(i){const e=i.getBoundingClientRect();return{x:(e.x+e.width/2)*t.retina.pixelRatio,y:(e.y+e.height/2)*t.retina.pixelRatio}}}return this.position}getSize(){const t=this.container;if(this.options.domId){const i=document.getElementById(this.options.domId);if(i){const e=i.getBoundingClientRect();return{width:e.width*t.retina.pixelRatio,height:e.height*t.retina.pixelRatio}}}return{width:"percent"===this.size.mode?t.canvas.size.width*this.size.width/100:this.size.width,height:"percent"===this.size.mode?t.canvas.size.height*this.size.height/100:this.size.height}}pause(){this._paused||delete this._emitDelay}play(){var i;if(!this._paused&&this.container.retina.reduceFactor&&(this._lifeCount>0||this._immortal||!this.options.life.count)&&(this._firstSpawn||this._currentSpawnDelay>=(null!==(i=this._spawnDelay)&&void 0!==i?i:0))){if(void 0===this._emitDelay){const i=(0,t.getRangeValue)(this.options.rate.delay);this._emitDelay=1e3*i/this.container.retina.reduceFactor}(this._lifeCount>0||this._immortal)&&this.prepareToDie()}}resize(){const i=this._initialPosition;this.position=i&&(0,t.isPointInside)(i,this.container.canvas.size,t.Vector.origin)?i:this.calcPosition()}update(t){var i,e,s;this._paused||(this._firstSpawn&&(this._firstSpawn=!1,this._currentSpawnDelay=null!==(i=this._spawnDelay)&&void 0!==i?i:0,this._currentEmitDelay=null!==(e=this._emitDelay)&&void 0!==e?e: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._spawnDelay=1e3*(null!==(s=this.options.life.delay)&&void 0!==s?s:0)/this.container.retina.reduceFactor):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(){return(0,t.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 i=(0,t.getRangeValue)(this.options.rate.quantity);this.emitParticles(i)}emitParticles(i){var e,s,n;const o=this.getPosition(),a=this.getSize(),r=(0,t.itemFromSingleOrMultiple)(this._particlesOptions);for(let l=0;l<i;l++){const i=(0,t.deepExtend)({},r);if(this.spawnColor){const t=null===(e=this.options.spawnColor)||void 0===e?void 0:e.animation;t&&(this.spawnColor.h=this.setColorAnimation(t.h,this.spawnColor.h,360),this.spawnColor.s=this.setColorAnimation(t.s,this.spawnColor.s,100),this.spawnColor.l=this.setColorAnimation(t.l,this.spawnColor.l,100)),i.color?i.color.value=this.spawnColor:i.color={value:this.spawnColor}}if(!o)return;const l=null!==(n=null===(s=this._shape)||void 0===s?void 0:s.randomPosition(o,a,this.fill))&&void 0!==n?n:o;this.container.particles.addParticle(l,i)}}prepareToDie(){var t;if(this._paused)return;const i=null===(t=this.options.life)||void 0===t?void 0:t.duration;this.container.retina.reduceFactor&&(this._lifeCount>0||this._immortal)&&void 0!==i&&i>0&&(this._duration=1e3*i)}setColorAnimation(i,e,s){var n;const o=this.container;if(!i.enable)return e;const a=(0,t.randomInRange)(i.offset),r=1e3*(0,t.getRangeValue)(this.options.rate.delay)/o.retina.reduceFactor;return(e+(0,t.getRangeValue)(null!==(n=i.speed)&&void 0!==n?n:0)*o.fpsLimit/r+3.6*a)%s}}class h{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||"number"==typeof t?this.array[t||0]:this.array.find((i=>i.name===t)),i.addEmitter=(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()}}addEmitter(t,i){const e=new r;e.load(t);const s=new l(this._engine,this,this.container,e,i);return this.array.push(s),s}handleClickMode(i){const e=this.emitters,s=this.interactivityEmitters;if("emitter"===i){let i;if(s&&s.value instanceof Array)if(s.value.length>0&&s.random.enable){i=[];const e=[];for(let n=0;n<s.random.count;n++){const o=(0,t.arrayRandomIndex)(s.value);e.includes(o)&&e.length<s.value.length?n--:(e.push(o),i.push((0,t.itemFromArray)(s.value,o)))}}else i=s.value;else i=null==s?void 0:s.value;const n=null!=i?i:e,o=this.container.interactivity.mouse.clickPosition;(0,t.executeOnSingleOrMultiple)(n,(t=>{this.addEmitter(t,o)}))}}async init(){if(this.emitters=this.container.actualOptions.emitters,this.interactivityEmitters=this.container.actualOptions.interactivity.modes.emitters,this.emitters instanceof Array)for(const t of this.emitters)this.addEmitter(t);else 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)}}const d=new Map;class c{constructor(t){this._engine=t}addShape(t,i){this.getShape(t)||d.set(t,i)}getShape(t){return d.get(t)}getSupportedShapes(){return d.keys()}}function u(i,e){return i+e*((0,t.getRandom)()-.5)}class p{randomPosition(i,e,s){if(s)return{x:u(i.x,e.width),y:u(i.y,e.height)};{const s=e.width/2,n=e.height/2,o=Math.floor(4*(0,t.getRandom)()),a=2*((0,t.getRandom)()-.5);switch(o){case 0:return{x:i.x+a*s,y:i.y-n};case 1:return{x:i.x-s,y:i.y+a*n};case 2:return{x:i.x+a*s,y:i.y+n};default:return{x:i.x+s,y:i.y+a*n}}}}}class m{constructor(t){this._engine=t,this.id="emitters"}getPlugin(t){return new h(this._engine,t)}loadOptions(i,e){var s,n,o,a,l,h;if(!this.needsPlugin(i)&&!this.needsPlugin(e))return;(null==e?void 0:e.emitters)&&(i.emitters=(0,t.executeOnSingleOrMultiple)(e.emitters,(t=>{const i=new r;return i.load(t),i})));const d=null===(n=null===(s=null==e?void 0:e.interactivity)||void 0===s?void 0:s.modes)||void 0===n?void 0:n.emitters;if(d)if(d instanceof Array)i.interactivity.modes.emitters={random:{count:1,enable:!0},value:d.map((t=>{const i=new r;return i.load(t),i}))};else{const t=d;if(void 0!==t.value)if(t.value instanceof Array)i.interactivity.modes.emitters={random:{count:null!==(o=t.random.count)&&void 0!==o?o:1,enable:null!==(a=t.random.enable)&&void 0!==a&&a},value:t.value.map((t=>{const i=new r;return i.load(t),i}))};else{const e=new r;e.load(t.value),i.interactivity.modes.emitters={random:{count:null!==(l=t.random.count)&&void 0!==l?l:1,enable:null!==(h=t.random.enable)&&void 0!==h&&h},value:e}}else{(i.interactivity.modes.emitters={random:{count:1,enable:!1},value:new r}).value.load(d)}}}needsPlugin(i){var e,s,n;if(!i)return!1;const o=i.emitters;return o instanceof Array&&!!o.length||void 0!==o||!!(null===(n=null===(s=null===(e=i.interactivity)||void 0===e?void 0:e.events)||void 0===s?void 0:s.onClick)||void 0===n?void 0:n.mode)&&(0,t.isInArray)("emitter",i.interactivity.events.onClick.mode)}}async function v(t){t.emitterShapeManager||(t.emitterShapeManager=new c(t)),t.addEmitterShape||(t.addEmitterShape=(i,e)=>{var s;null===(s=t.emitterShapeManager)||void 0===s||s.addShape(i,e)});const e=new m(t);await t.addPlugin(e),t.addEmitterShape("circle",new i),t.addEmitterShape("square",new p)}})(),n})()));

package/tsparticles.plugin.emitters.min.js.LICENSE.txt

@@ -0,0 +1,8 @@
+/*!
+ * Author : Matteo Bruni
+ * MIT license: https://opensource.org/licenses/MIT
+ * Demo / Generator : https://particles.js.org/
+ * GitHub : https://www.github.com/matteobruni/tsparticles
+ * How to use? : Check the GitHub README
+ * v3.0.0-alpha.0
+ */

package/types/EmitterContainer.d.ts

@@ -0,0 +1,12 @@
+import type { Container, ICoordinates, RecursivePartial } from "@tsparticles/engine";
+import type { EmitterInstance } from "./EmitterInstance";
+import type { EmitterOptions } from "./types";
+import type { IEmitter } from "./Options/Interfaces/IEmitter";
+export type EmitterContainer = Container & {
+    actualOptions: EmitterOptions;
+    addEmitter: (options: RecursivePartial<IEmitter>, position?: ICoordinates) => EmitterInstance;
+    getEmitter: (idxOrName?: number | string) => EmitterInstance | undefined;
+    pauseEmitter: (idxOrName?: number | string) => void;
+    playEmitter: (idxOrName?: number | string) => void;
+    removeEmitter: (idxOrName?: number | string) => void;
+};

package/types/EmitterInstance.d.ts

@@ -0,0 +1,46 @@
+import type { Container, ICoordinates, IDelta, IDimension, IHsl, RecursivePartial } from "@tsparticles/engine";
+import { Emitter } from "./Options/Classes/Emitter";
+import type { Emitters } from "./Emitters";
+import type { EmittersEngine } from "./EmittersEngine";
+import type { IEmitter } from "./Options/Interfaces/IEmitter";
+import type { IEmitterSize } from "./Options/Interfaces/IEmitterSize";
+export declare class EmitterInstance {
+    private readonly emitters;
+    private readonly container;
+    fill: boolean;
+    readonly name?: string;
+    options: Emitter;
+    position?: ICoordinates;
+    size: IEmitterSize;
+    spawnColor?: IHsl;
+    private _currentDuration;
+    private _currentEmitDelay;
+    private _currentSpawnDelay;
+    private _duration?;
+    private _emitDelay?;
+    private readonly _engine;
+    private _firstSpawn;
+    private readonly _immortal;
+    private readonly _initialPosition?;
+    private _lifeCount;
+    private readonly _particlesOptions;
+    private _paused;
+    private readonly _shape?;
+    private _spawnDelay?;
+    private _startParticlesAdded;
+    constructor(engine: EmittersEngine, emitters: Emitters, container: Container, options: RecursivePartial<IEmitter>, position?: ICoordinates);
+    externalPause(): void;
+    externalPlay(): void;
+    getPosition(): ICoordinates | undefined;
+    getSize(): IDimension;
+    pause(): void;
+    play(): void;
+    resize(): void;
+    update(delta: IDelta): void;
+    private calcPosition;
+    private destroy;
+    private emit;
+    private emitParticles;
+    private prepareToDie;
+    private setColorAnimation;
+}

package/types/Emitters.d.ts

@@ -0,0 +1,24 @@
+import type { IContainerPlugin, ICoordinates, IDelta, RecursivePartial, SingleOrMultiple } from "@tsparticles/engine";
+import { Emitter } from "./Options/Classes/Emitter";
+import type { EmitterContainer } from "./EmitterContainer";
+import { EmitterInstance } from "./EmitterInstance";
+import type { EmitterModeOptions } from "./types";
+import type { EmittersEngine } from "./EmittersEngine";
+import type { IEmitter } from "./Options/Interfaces/IEmitter";
+export declare class Emitters implements IContainerPlugin {
+    private readonly container;
+    array: EmitterInstance[];
+    emitters: SingleOrMultiple<Emitter>;
+    interactivityEmitters: EmitterModeOptions;
+    private readonly _engine;
+    constructor(engine: EmittersEngine, container: EmitterContainer);
+    addEmitter(options: RecursivePartial<IEmitter>, position?: ICoordinates): EmitterInstance;
+    handleClickMode(mode: string): void;
+    init(): Promise<void>;
+    pause(): void;
+    play(): void;
+    removeEmitter(emitter: EmitterInstance): void;
+    resize(): void;
+    stop(): void;
+    update(delta: IDelta): void;
+}

package/types/EmittersEngine.d.ts

@@ -0,0 +1,7 @@
+import type { Engine } from "@tsparticles/engine";
+import type { IEmitterShape } from "./IEmitterShape";
+import type { ShapeManager } from "./ShapeManager";
+export type EmittersEngine = Engine & {
+    addEmitterShape?: (name: string, shape: IEmitterShape) => void;
+    emitterShapeManager?: ShapeManager;
+};

package/types/Enums/EmitterClickMode.d.ts

@@ -0,0 +1,3 @@
+export declare const enum EmitterClickMode {
+    emitter = "emitter"
+}

package/types/Enums/EmitterShapeType.d.ts

@@ -0,0 +1,4 @@
+export declare const enum EmitterShapeType {
+    circle = "circle",
+    square = "square"
+}

package/types/IEmitterShape.d.ts

@@ -0,0 +1,4 @@
+import type { ICoordinates, IDimension } from "@tsparticles/engine";
+export interface IEmitterShape {
+    randomPosition(position: ICoordinates, size: IDimension, fill: boolean): ICoordinates;
+}

package/types/Options/Classes/Emitter.d.ts

@@ -0,0 +1,24 @@
+import { AnimatableColor } from "@tsparticles/engine";
+import type { IOptionLoader, IParticlesOptions, IRangedCoordinates, MoveDirection, MoveDirectionAlt, RecursivePartial, SingleOrMultiple } from "@tsparticles/engine";
+import { EmitterLife } from "./EmitterLife";
+import { EmitterRate } from "./EmitterRate";
+import { EmitterShapeType } from "../../Enums/EmitterShapeType";
+import { EmitterSize } from "./EmitterSize";
+import type { IEmitter } from "../Interfaces/IEmitter";
+export declare class Emitter implements IEmitter, IOptionLoader<IEmitter> {
+    autoPlay: boolean;
+    direction?: MoveDirection | keyof typeof MoveDirection | MoveDirectionAlt | number;
+    domId?: string;
+    fill: boolean;
+    life: EmitterLife;
+    name?: string;
+    particles?: SingleOrMultiple<RecursivePartial<IParticlesOptions>>;
+    position?: RecursivePartial<IRangedCoordinates>;
+    rate: EmitterRate;
+    shape: EmitterShapeType | keyof typeof EmitterShapeType;
+    size?: EmitterSize;
+    spawnColor?: AnimatableColor;
+    startCount: number;
+    constructor();
+    load(data?: RecursivePartial<IEmitter>): void;
+}

package/types/Options/Classes/EmitterLife.d.ts

@@ -0,0 +1,10 @@
+import type { IOptionLoader, RecursivePartial } from "@tsparticles/engine";
+import type { IEmitterLife } from "../Interfaces/IEmitterLife";
+export declare class EmitterLife implements IEmitterLife, IOptionLoader<IEmitterLife> {
+    count?: number;
+    delay?: number;
+    duration?: number;
+    wait: boolean;
+    constructor();
+    load(data?: RecursivePartial<IEmitterLife>): void;
+}

package/types/Options/Classes/EmitterRate.d.ts

@@ -0,0 +1,8 @@
+import type { IOptionLoader, RangeValue, RecursivePartial } from "@tsparticles/engine";
+import type { IEmitterRate } from "../Interfaces/IEmitterRate";
+export declare class EmitterRate implements IEmitterRate, IOptionLoader<IEmitterRate> {
+    delay: RangeValue;
+    quantity: RangeValue;
+    constructor();
+    load(data?: RecursivePartial<IEmitterRate>): void;
+}

package/types/Options/Classes/EmitterSize.d.ts

@@ -0,0 +1,10 @@
+import type { IOptionLoader, RecursivePartial } from "@tsparticles/engine";
+import type { IEmitterSize } from "../Interfaces/IEmitterSize";
+import { SizeMode } from "@tsparticles/engine";
+export declare class EmitterSize implements IEmitterSize, IOptionLoader<IEmitterSize> {
+    height: number;
+    mode: SizeMode | keyof typeof SizeMode;
+    width: number;
+    constructor();
+    load(data?: RecursivePartial<IEmitterSize>): void;
+}

package/types/Options/Interfaces/IEmitter.d.ts

@@ -0,0 +1,20 @@
+import type { IAnimatableColor, IParticlesOptions, IRangedCoordinates, MoveDirection, MoveDirectionAlt, RecursivePartial, SingleOrMultiple } from "@tsparticles/engine";
+import type { EmitterShapeType } from "../../Enums/EmitterShapeType";
+import type { IEmitterLife } from "./IEmitterLife";
+import type { IEmitterRate } from "./IEmitterRate";
+import type { IEmitterSize } from "./IEmitterSize";
+export interface IEmitter {
+    autoPlay: boolean;
+    direction?: MoveDirection | keyof typeof MoveDirection | MoveDirectionAlt | number;
+    domId?: string;
+    fill: boolean;
+    life: IEmitterLife;
+    name?: string;
+    particles?: SingleOrMultiple<RecursivePartial<IParticlesOptions>>;
+    position?: RecursivePartial<IRangedCoordinates>;
+    rate: IEmitterRate;
+    shape: EmitterShapeType | keyof typeof EmitterShapeType;
+    size?: IEmitterSize;
+    spawnColor?: IAnimatableColor;
+    startCount: number;
+}

package/types/Options/Interfaces/IEmitterLife.d.ts

@@ -0,0 +1,6 @@
+export interface IEmitterLife {
+    count?: number;
+    delay?: number;
+    duration?: number;
+    wait: boolean;
+}

package/types/Options/Interfaces/IEmitterRate.d.ts

@@ -0,0 +1,5 @@
+import type { RangeValue } from "@tsparticles/engine";
+export interface IEmitterRate {
+    delay: RangeValue;
+    quantity: RangeValue;
+}

package/types/Options/Interfaces/IEmitterSize.d.ts

@@ -0,0 +1,4 @@
+import type { IDimension, SizeMode } from "@tsparticles/engine";
+export interface IEmitterSize extends IDimension {
+    mode: SizeMode | keyof typeof SizeMode;
+}

package/types/ShapeManager.d.ts

@@ -0,0 +1,9 @@
+import type { Engine } from "@tsparticles/engine";
+import type { IEmitterShape } from "./IEmitterShape";
+export declare class ShapeManager {
+    private readonly _engine;
+    constructor(engine: Engine);
+    addShape(name: string, drawer: IEmitterShape): void;
+    getShape(name: string): IEmitterShape | undefined;
+    getSupportedShapes(): IterableIterator<string>;
+}

package/types/Shapes/Circle/CircleShape.d.ts

@@ -0,0 +1,5 @@
+import type { ICoordinates, IDimension } from "@tsparticles/engine";
+import type { IEmitterShape } from "../../IEmitterShape";
+export declare class CircleShape implements IEmitterShape {
+    randomPosition(position: ICoordinates, size: IDimension, fill: boolean): ICoordinates;
+}

package/types/Shapes/Square/SquareShape.d.ts

@@ -0,0 +1,5 @@
+import type { ICoordinates, IDimension } from "@tsparticles/engine";
+import type { IEmitterShape } from "../../IEmitterShape";
+export declare class SquareShape implements IEmitterShape {
+    randomPosition(position: ICoordinates, size: IDimension, fill: boolean): ICoordinates;
+}

package/types/index.d.ts

@@ -0,0 +1,6 @@
+import type { EmittersEngine } from "./EmittersEngine";
+export declare function loadEmittersPlugin(engine: EmittersEngine): Promise<void>;
+export * from "./EmitterContainer";
+export * from "./EmittersEngine";
+export * from "./Enums/EmitterClickMode";
+export * from "./Enums/EmitterShapeType";

package/types/types.d.ts

@@ -0,0 +1,31 @@
+import type { IOptions, Options, SingleOrMultiple } from "@tsparticles/engine";
+import type { Emitter } from "./Options/Classes/Emitter";
+import type { IEmitter } from "./Options/Interfaces/IEmitter";
+export interface IEmitterModeOptions {
+    random: IEmitterModeRandomOptions;
+    value: SingleOrMultiple<IEmitter>;
+}
+export interface IEmitterModeRandomOptions {
+    count: number;
+    enable: boolean;
+}
+export interface EmitterModeOptions {
+    random: IEmitterModeRandomOptions;
+    value: SingleOrMultiple<Emitter>;
+}
+export type IEmitterOptions = IOptions & {
+    emitters: SingleOrMultiple<IEmitter>;
+    interactivity: {
+        modes: {
+            emitters: IEmitterModeOptions | SingleOrMultiple<IEmitter>;
+        };
+    };
+};
+export type EmitterOptions = Options & {
+    emitters: SingleOrMultiple<Emitter>;
+    interactivity: {
+        modes: {
+            emitters: EmitterModeOptions;
+        };
+    };
+};

package/umd/EmitterContainer.js

@@ -0,0 +1,12 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/EmitterInstance.js

@@ -0,0 +1,271 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "@tsparticles/engine", "./Options/Classes/Emitter", "./Options/Classes/EmitterSize"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    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");
+    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._engine = engine;
+            this._currentDuration = 0;
+            this._currentEmitDelay = 0;
+            this._currentSpawnDelay = 0;
+            this._initialPosition = position;
+            if (options instanceof Emitter_1.Emitter) {
+                this.options = options;
+            }
+            else {
+                this.options = new Emitter_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.name = this.options.name;
+            this._shape = (_c = this._engine.emitterShapeManager) === null || _c === void 0 ? void 0 : _c.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);
+            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._immortal = this._lifeCount <= 0;
+            this._engine.dispatchEvent("emitterCreated", {
+                container,
+                data: {
+                    emitter: this,
+                },
+            });
+            this.play();
+        }
+        externalPause() {
+            this._paused = true;
+            this.pause();
+        }
+        externalPlay() {
+            this._paused = false;
+            this.play();
+        }
+        getPosition() {
+            if (this.options.domId) {
+                const container = this.container, element = document.getElementById(this.options.domId);
+                if (element) {
+                    const elRect = element.getBoundingClientRect();
+                    return {
+                        x: (elRect.x + elRect.width / 2) * container.retina.pixelRatio,
+                        y: (elRect.y + elRect.height / 2) * container.retina.pixelRatio,
+                    };
+                }
+            }
+            return this.position;
+        }
+        getSize() {
+            const container = this.container;
+            if (this.options.domId) {
+                const element = document.getElementById(this.options.domId);
+                if (element) {
+                    const elRect = element.getBoundingClientRect();
+                    return {
+                        width: elRect.width * container.retina.pixelRatio,
+                        height: elRect.height * container.retina.pixelRatio,
+                    };
+                }
+            }
+            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,
+            };
+        }
+        pause() {
+            if (this._paused) {
+                return;
+            }
+            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)))) {
+                return;
+            }
+            if (this._emitDelay === undefined) {
+                const delay = (0, engine_1.getRangeValue)(this.options.rate.delay);
+                this._emitDelay = (1000 * delay) / this.container.retina.reduceFactor;
+            }
+            if (this._lifeCount > 0 || this._immortal) {
+                this.prepareToDie();
+            }
+        }
+        resize() {
+            const initialPosition = this._initialPosition;
+            this.position =
+                initialPosition && (0, engine_1.isPointInside)(initialPosition, this.container.canvas.size, engine_1.Vector.origin)
+                    ? initialPosition
+                    : 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;
+            }
+            if (!this._startParticlesAdded) {
+                this._startParticlesAdded = true;
+                this.emitParticles(this.options.startCount);
+            }
+            if (this._duration !== undefined) {
+                this._currentDuration += delta.value;
+                if (this._currentDuration >= this._duration) {
+                    this.pause();
+                    if (this._spawnDelay !== undefined) {
+                        delete this._spawnDelay;
+                    }
+                    if (!this._immortal) {
+                        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;
+                    }
+                    else {
+                        this.destroy();
+                    }
+                    this._currentDuration -= this._duration;
+                    delete this._duration;
+                }
+            }
+            if (this._spawnDelay !== undefined) {
+                this._currentSpawnDelay += delta.value;
+                if (this._currentSpawnDelay >= this._spawnDelay) {
+                    this._engine.dispatchEvent("emitterPlay", {
+                        container: this.container,
+                    });
+                    this.play();
+                    this._currentSpawnDelay -= this._currentSpawnDelay;
+                    delete this._spawnDelay;
+                }
+            }
+            if (this._emitDelay !== undefined) {
+                this._currentEmitDelay += delta.value;
+                if (this._currentEmitDelay >= this._emitDelay) {
+                    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;
+});