@tsparticles/plugin-sounds 4.0.0-alpha.2 → 4.0.0-alpha.21

package/249.min.js

@@ -0,0 +1 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_sounds=this.webpackChunk_tsparticles_plugin_sounds||[]).push([[249],{249(t,e,i){i.d(e,{SoundsPluginInstance:()=>m});var n,s,a,o,u=i(303);(n=a||(a={})).mute="soundsMuted",n.unmute="soundsUnmuted",(s=o||(o={})).Block="block",s.None="none";var l=i(946),r=i(794);function c(t){var e,i,n,s,a,o,l,r;let c=(0,u.safeDocument)().createElement("img"),{clickCb:d,container:m,display:h,iconOptions:_,margin:p,options:g,pos:f,rightOffsets:v}=t,{width:y,path:w,style:O,svg:S}=_;return e=c,i=f.top+p,n=f.right-(p*(v.length+1)+y+v.reduce((t,e)=>t+e,0)),s=h,a=g.fullScreen.zIndex+1,o=y,l=p,r=O,e.style.userSelect="none",e.style.position="absolute",e.style.top=`${(i+l).toString()}px`,e.style.left=`${(n-l-o).toString()}px`,e.style.display=s,e.style.zIndex=(a+1).toString(),e.style.cssText+=r,c.src=w??(S?`data:image/svg+xml;base64,${btoa(S)}`:""),(m.canvas.element?.parentNode??(0,u.safeDocument)().body).append(c),c.addEventListener("click",()=>{d()}),c}function d(t){t&&t.remove()}class m{_audioMap;_audioSources;_container;_engine;_gain;_muteImg;_unmuteImg;_volume;_volumeDownImg;_volumeUpImg;constructor(t,e){this._container=t,this._engine=e,this._volume=0,this._audioSources=[],this._audioMap=new Map}async init(){let t=this._container.actualOptions.sounds;if(!t?.enable)return;if(t.autoPlay&&(0,l.E3)()){let t=()=>{removeEventListener(r.m,t),removeEventListener(r.s,t),(0,l.XK)(),this.unmute()},e={capture:!0,once:!0};addEventListener(r.m,t,e),addEventListener(r.s,t,e)}this._volume=t.volume.value;let e=t.events;for(let t of(this._audioMap=new Map,e)){if(!t.audio)continue;let e=(0,u.executeOnSingleOrMultiple)(t.audio,async t=>{let e=await fetch(t.source);if(!e.ok)return;let i=await e.arrayBuffer(),n=this._getAudioContext(),s=await n.decodeAudioData(i);this._audioMap.set(t.source,s)});e instanceof Promise?await e:await Promise.allSettled(e)}}async mute(){this._container.muted||await this.toggleMute()}async start(){let t=this._container,e=t.actualOptions,i=e.sounds;if(!i?.enable||!t.canvas.element)return;t.muted=!0;let n=t.canvas.element,s={top:n.offsetTop,right:n.offsetLeft+n.offsetWidth},{mute:a,unmute:u,volumeDown:r,volumeUp:d}=i.icons,m=async()=>{await this.toggleMute()},h=i.icons.enable?o.Block:o.None;this._muteImg=c({container:t,options:e,pos:s,display:h,iconOptions:a,margin:10,rightOffsets:[r.width,d.width],clickCb:m}),this._unmuteImg=c({container:t,options:e,pos:s,display:o.None,iconOptions:u,margin:10,rightOffsets:[r.width,d.width],clickCb:m}),this._volumeDownImg=c({container:t,options:e,pos:s,display:h,iconOptions:r,margin:10,rightOffsets:[d.width],clickCb:async()=>{await this.volumeDown()}}),this._volumeUpImg=c({container:t,options:e,pos:s,display:h,iconOptions:d,margin:10,rightOffsets:[],clickCb:async()=>{await this.volumeUp()}}),!(0,l.E3)()&&i.autoPlay&&await this.unmute()}stop(){this._container.muted=!0,(async()=>{await this._mute(),d(this._muteImg),d(this._unmuteImg),d(this._volumeDownImg),d(this._volumeUpImg)})()}async toggleMute(){let t=this._container;t.muted=!t.muted,this._updateMuteIcons(),await this._updateMuteStatus()}async unmute(){this._container.muted&&await this.toggleMute()}async volumeDown(){let t=this._container,e=t.actualOptions.sounds;e?.enable&&(t.muted&&(this._volume=0),this._volume-=e.volume.step,await this._updateVolume())}async volumeUp(){let t=this._container.actualOptions.sounds;t?.enable&&(this._volume+=t.volume.step,await this._updateVolume())}_addBuffer=t=>{let e=t.createBufferSource();return this._audioSources.push(e),e};_addOscillator=t=>{let e=t.createOscillator();return this._audioSources.push(e),e};_getAudioContext(){let t=this._container;return t.audioContext??=new AudioContext,t.audioContext}_initEvents=()=>{let t=this._container,e=t.actualOptions.sounds;if(e?.enable&&t.canvas.element)for(let t of e.events){let e=i=>{i&&(async()=>{let n=t.filter&&!t.filter(i);if(this._container===i.container){if(this._container.muted||this._container.destroyed)return(0,u.executeOnSingleOrMultiple)(t.event,t=>{this._engine.removeEventListener(t,e)});if(!n){if(t.audio){let e=(0,u.itemFromSingleOrMultiple)(t.audio);if(!e)return;this._playBuffer(e)}else if(t.melodies){let e=(0,u.itemFromArray)(t.melodies);if(!e)return;e.melodies.length?await Promise.allSettled(e.melodies.map(t=>this._playNote(t.notes,0,e.loop))):await this._playNote(e.notes,0,e.loop)}else if(t.notes){let e=(0,u.itemFromArray)(t.notes);if(!e)return;await this._playNote([e],0,!1)}}}})()};(0,u.executeOnSingleOrMultiple)(t.event,t=>{this._engine.addEventListener(t,e)})}};_mute=async()=>{let t=this._container,e=this._getAudioContext();for(let t of this._audioSources)this._removeAudioSource(t);this._gain&&this._gain.disconnect(),await e.close(),t.audioContext=void 0,this._engine.dispatchEvent(a.mute,{container:this._container})};_playBuffer=t=>{let e=this._audioMap.get(t.source);if(!e)return;let i=this._container.audioContext;if(!i)return;let n=this._addBuffer(i);n.loop=t.loop,n.buffer=e,n.connect(this._gain??i.destination),n.start()};_playFrequency=async(t,e)=>{if(!this._gain||this._container.muted)return;let i=this._getAudioContext(),n=this._addOscillator(i);return n.connect(this._gain),n.type="sine",n.frequency.value=t,n.start(),new Promise(t=>{setTimeout(()=>{this._removeAudioSource(n),t()},e)})};_playMuteSound=()=>{if(this._container.muted)return;let t=this._getAudioContext(),e=t.createGain();e.connect(t.destination),e.gain.value=0;let i=t.createOscillator();i.connect(e),i.type="sine",i.frequency.value=1,i.start(),setTimeout(()=>{i.stop(),i.disconnect(),e.disconnect()})};_playNote=async(t,e,i)=>{if(this._container.muted)return;let n=t[e];if(!n)return;let s=n.value,a=(0,u.executeOnSingleOrMultiple)(s,async(i,n)=>this._playNoteValue(t,e,n));await ((0,u.isArray)(a)?Promise.allSettled(a):a);let o=e+1;i&&o>=t.length&&(o%=t.length),await this._playNote(t,o,i)};_playNoteValue=async(t,e,i)=>{let n=t[e];if(!n)return;let s=(0,u.itemFromSingleOrMultiple)(n.value,i,!0);if(s)try{let t=(0,l.jE)(s);if(!(0,u.isNumber)(t))return;await this._playFrequency(t,n.duration)}catch(t){(0,u.getLogger)().error(t)}};_removeAudioSource=t=>{t.stop(),t.disconnect(),this._audioSources.splice(this._audioSources.indexOf(t),1)};_unmute=()=>{let t=this._container.actualOptions.sounds;if(!t)return;let e=this._getAudioContext(),i=e.createGain();i.connect(e.destination),i.gain.value=t.volume.value/u.percentDenominator,this._gain=i,this._initEvents(),this._engine.dispatchEvent(a.unmute,{container:this._container})};_updateMuteIcons=()=>{let t=this._container,e=t.actualOptions.sounds;if(!e?.enable||!e.icons.enable)return;let i=this._muteImg,n=this._unmuteImg;i&&(i.style.display=t.muted?"block":"none"),n&&(n.style.display=t.muted?"none":"block")};_updateMuteStatus=async()=>{let t=this._container,e=this._getAudioContext();t.muted?(await e.suspend(),await this._mute()):(await e.resume(),this._unmute(),this._playMuteSound())};_updateVolume=async()=>{let t=this._container,e=t.actualOptions.sounds;if(!e?.enable)return;(0,u.clamp)(this._volume,e.volume.min,e.volume.max);let i=!1;this._volume<=0&&!t.muted?(this._volume=0,t.muted=!0,i=!0):this._volume>0&&t.muted&&(t.muted=!1,i=!0),i&&(this._updateMuteIcons(),await this._updateMuteStatus()),this._gain?.gain&&(this._gain.gain.value=this._volume/u.percentDenominator)}}}}]);

package/807.min.js

@@ -0,0 +1,33 @@
+"use strict";(this.webpackChunk_tsparticles_plugin_sounds=this.webpackChunk_tsparticles_plugin_sounds||[]).push([[807],{807(e,t,s){s.d(t,{SoundsPlugin:()=>m});var i=s(794),l=s(303);class o{loop;source;constructor(){this.loop=!1,this.source=""}load(e){(0,l.isNull)(e)||((0,l.isObject)(e)?(void 0!==e.loop&&(this.loop=e.loop),void 0!==e.source&&(this.source=e.source)):this.source=e)}}class n{duration;value;constructor(){this.duration=500,this.value=[]}load(e){(0,l.isNull)(e)||(void 0!==e.duration&&(this.duration=e.duration),void 0!==e.value&&(this.value=e.value))}}class a{loop;melodies;notes;constructor(){this.loop=!1,this.melodies=[],this.notes=[]}load(e){(0,l.isNull)(e)||(void 0!==e.loop&&(this.loop=e.loop),void 0!==e.melodies&&(this.melodies=e.melodies.map(e=>{let t=new a;return t.load(e),t})),void 0!==e.notes&&(this.notes=e.notes.map(e=>{let t=new n;return t.load(e),t})))}}class c{audio;event;filter;melodies;notes;constructor(){this.event=[],this.notes=[]}load(e){if(!(0,l.isNull)(e)&&(void 0!==e.event&&(this.event=e.event),void 0!==e.audio&&((0,l.isArray)(e.audio)?this.audio=e.audio.map(e=>{let t=new o;return t.load(e),t}):(this.audio=new o,this.audio.load(e.audio))),void 0!==e.notes&&(this.notes=e.notes.map(e=>{let t=new n;return t.load(e),t})),void 0!==e.melodies&&(this.melodies=e.melodies.map(e=>{let t=new a;return t.load(e),t})),e.filter))if((0,l.isString)(e.filter)){let t=globalThis[e.filter];(0,l.isFunction)(t)&&(this.filter=t)}else this.filter=e.filter}}class h{height;path;style;svg;width;constructor(){this.width=24,this.height=24,this.style=""}load(e){(0,l.isNull)(e)||(void 0!==e.path&&(this.path=e.path),void 0!==e.svg&&(this.svg=e.svg),void 0!==e.width&&(this.width=e.width),void 0!==e.height&&(this.height=e.height))}}class u{enable;mute;unmute;volumeDown;volumeUp;constructor(){this.mute=new h,this.unmute=new h,this.volumeDown=new h,this.volumeUp=new h,this.enable=!1,this.mute.svg=`<?xml version="1.0"?>
+<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"
+    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <g id="Layer_1">
+        <path fill="#fff" d="M19.707,5.293c-0.391-0.391-1.023-0.391-1.414,0l-1.551,1.551c-0.345-0.688-0.987-1.02-1.604-1.02c-0.449,0-0.905,0.152-1.356,0.453l-2.672,1.781C10.357,8.561,8.904,9,8,9c-1.654,0-3,1.346-3,3v2c0,1.237,0.754,2.302,1.826,2.76l-1.533,1.533c-0.391,0.391-0.391,1.023,0,1.414C5.488,19.902,5.744,20,6,20s0.512-0.098,0.707-0.293l2.527-2.527c0.697,0.174,1.416,0.455,1.875,0.762l2.672,1.781c0.451,0.301,0.907,0.453,1.356,0.453C16.035,20.176,17,19.495,17,18V9.414l2.707-2.707C20.098,6.316,20.098,5.684,19.707,5.293z M14.891,7.941c0.038-0.025,0.073-0.046,0.104-0.062C14.998,7.914,15,7.954,15,8v1.293l-2,2V9.202L14.891,7.941z M7,12c0-0.552,0.448-1,1-1c1.211,0,2.907-0.495,4-1.146v2.439l-2.83,2.83C8.757,15.046,8.356,15,8,15c-0.552,0-1-0.448-1-1V12z M10.301,15.406L12,13.707v2.439C11.519,15.859,10.925,15.604,10.301,15.406z M14.994,18.12c-0.03-0.016-0.065-0.036-0.104-0.062L13,16.798v-4.091l2-2V18C15,18.046,14.998,18.086,14.994,18.12z"/>
+    </g>
+</svg>`,this.unmute.svg=`<?xml version="1.0"?>
+<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"
+    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <g id="Layer_1">
+        <path fill="#fff" d="M17.138,5.824c-0.449,0-0.905,0.152-1.356,0.453l-2.672,1.781C12.357,8.561,10.904,9,10,9c-1.654,0-3,1.346-3,3v2c0,1.654,1.346,3,3,3c0.904,0,2.357,0.439,3.109,0.941l2.672,1.781c0.451,0.301,0.907,0.453,1.356,0.453C18.035,20.176,19,19.495,19,18V8C19,6.505,18.035,5.824,17.138,5.824z M14,16.146C12.907,15.495,11.211,15,10,15c-0.552,0-1-0.448-1-1v-2c0-0.552,0.448-1,1-1c1.211,0,2.907-0.495,4-1.146V16.146z M17,18c0,0.046-0.002,0.086-0.006,0.12c-0.03-0.016-0.065-0.036-0.104-0.062L15,16.798V9.202l1.891-1.261c0.038-0.025,0.073-0.046,0.104-0.062C16.998,7.914,17,7.954,17,8V18z"/>
+    </g>
+</svg>`,this.volumeDown.svg=`<?xml version="1.0"?>
+<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"
+    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <g id="Layer_1">
+        <path fill="#fff" d="M15.138,5.824c-0.449,0-0.905,0.152-1.356,0.453l-2.672,1.781C10.357,8.561,8.904,9,8,9c-1.654,0-3,1.346-3,3v2c0,1.654,1.346,3,3,3c0.904,0,2.357,0.439,3.109,0.941l2.672,1.781c0.451,0.301,0.907,0.453,1.356,0.453C16.035,20.176,17,19.495,17,18V8C17,6.505,16.035,5.824,15.138,5.824z M8,15c-0.552,0-1-0.448-1-1v-2c0-0.552,0.448-1,1-1c1.211,0,2.907-0.495,4-1.146v6.293C10.907,15.495,9.211,15,8,15z M15,18c0,0.046-0.002,0.086-0.006,0.12c-0.03-0.016-0.065-0.036-0.104-0.062L13,16.798V9.202l1.891-1.261c0.038-0.025,0.073-0.046,0.104-0.062C14.998,7.914,15,7.954,15,8V18z"/>
+        <path fill="#fff" d="M18.292,10.294c-0.39,0.391-0.39,1.023,0.002,1.414c0.345,0.345,0.535,0.803,0.535,1.291c0,0.489-0.19,0.948-0.536,1.294c-0.391,0.39-0.391,1.023,0,1.414C18.488,15.902,18.744,16,19,16s0.512-0.098,0.707-0.293c0.724-0.723,1.122-1.685,1.122-2.708s-0.398-1.984-1.123-2.707C19.317,9.903,18.683,9.901,18.292,10.294z"/>
+    </g>
+</svg>`,this.volumeUp.svg=`<?xml version="1.0"?>
+<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"
+    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+    <g id="Layer_1">
+        <path fill="#fff" d="M16.706,10.292c-0.389-0.389-1.023-0.391-1.414,0.002c-0.39,0.391-0.39,1.023,0.002,1.414c0.345,0.345,0.535,0.803,0.535,1.291c0,0.489-0.19,0.948-0.536,1.294c-0.391,0.39-0.391,1.023,0,1.414C15.488,15.902,15.744,16,16,16s0.512-0.098,0.707-0.293c0.724-0.723,1.122-1.685,1.122-2.708S17.431,11.015,16.706,10.292z"/>
+        <path fill="#fff" d="M18.706,8.292c-0.391-0.389-1.023-0.39-1.414,0.002c-0.39,0.391-0.39,1.024,0.002,1.414c0.879,0.877,1.363,2.044,1.364,3.287c0.001,1.246-0.484,2.417-1.365,3.298c-0.391,0.391-0.391,1.023,0,1.414C17.488,17.902,17.744,18,18,18s0.512-0.098,0.707-0.293c1.259-1.259,1.952-2.933,1.951-4.713C20.657,11.217,19.964,9.547,18.706,8.292z"/>
+        <path fill="#fff" d="M20.706,6.292c-0.391-0.389-1.023-0.39-1.414,0.002c-0.39,0.391-0.39,1.024,0.002,1.414c1.412,1.409,2.191,3.285,2.192,5.284c0.002,2.002-0.777,3.885-2.193,5.301c-0.391,0.391-0.391,1.023,0,1.414C19.488,19.902,19.744,20,20,20s0.512-0.098,0.707-0.293c1.794-1.794,2.781-4.18,2.779-6.717C23.485,10.457,22.497,8.078,20.706,6.292z"/>
+        <path fill="#fff" d="M12.138,5.824c-0.449,0-0.905,0.152-1.356,0.453L8.109,8.059C7.357,8.561,5.904,9,5,9c-1.654,0-3,1.346-3,3v2c0,1.654,1.346,3,3,3c0.904,0,2.357,0.439,3.109,0.941l2.672,1.781c0.451,0.301,0.907,0.453,1.356,0.453C13.035,20.176,14,19.495,14,18V8C14,6.505,13.035,5.824,12.138,5.824z M5,15c-0.552,0-1-0.448-1-1v-2c0-0.552,0.448-1,1-1c1.211,0,2.907-0.495,4-1.146v6.293C7.907,15.495,6.211,15,5,15z M12,18c0,0.046-0.002,0.086-0.006,0.12c-0.03-0.016-0.065-0.036-0.104-0.062L10,16.798V9.202l1.891-1.261c0.038-0.025,0.073-0.046,0.104-0.062C11.998,7.914,12,7.954,12,8V18z"/>
+    </g>
+</svg>`}load(e){(0,l.isNull)(e)||(void 0!==e.enable&&(this.enable=e.enable),this.mute.load(e.mute),this.unmute.load(e.unmute),this.volumeDown.load(e.volumeDown),this.volumeUp.load(e.volumeUp))}}class v{max;min;step;value;constructor(){this.value=100,this.max=100,this.min=0,this.step=10}load(e){(0,l.isNull)(e)||((0,l.isObject)(e)?(void 0!==e.max&&(this.max=e.max),void 0!==e.min&&(this.min=e.min),void 0!==e.step&&(this.step=e.step),void 0!==e.value&&(this.value=e.value)):this.value=e)}}class d{autoPlay;enable;events;icons;volume;constructor(){this.autoPlay=!0,this.enable=!1,this.events=[],this.icons=new u,this.volume=new v}load(e){(0,l.isNull)(e)||(void 0!==e.autoPlay&&(this.autoPlay=e.autoPlay),void 0!==e.enable&&(this.enable=e.enable),void 0!==e.events&&(this.events=e.events.map(e=>{let t=new c;return t.load(e),t})),this.icons.load(e.icons),void 0!==e.volume&&this.volume.load(e.volume))}}var r=s(946);let p=()=>{removeEventListener(i.m,p),removeEventListener(i.s,p),(0,r.XK)()};class m{id="sounds";_engine;constructor(e){this._engine=e;const t={capture:!0,once:!0};addEventListener(i.m,p,t),addEventListener(i.s,p,t)}async getPlugin(e){let{SoundsPluginInstance:t}=await s.e(249).then(s.bind(s,249));return new t(e,this._engine)}loadOptions(e,t,s){if(!this.needsPlugin(t)&&!this.needsPlugin(s))return;let i=t.sounds;i?.load===void 0&&(t.sounds=i=new d),i.load(s?.sounds)}needsPlugin(e){return e?.sounds?.enable??!1}}},794(e,t,s){s.d(t,{m:()=>i,s:()=>l});let i="pointerdown",l="touchstart"},946(e,t,s){s.d(t,{E3:()=>n,XK:()=>a,jE:()=>l});let i=new Map;function l(e){let t=/(([A-G]b?)(\d))|pause/i.exec(e);if(!t?.length)return;let s=t[2]??t[0],l=i.get(s);if(l)return l[parseInt(t[3]??"0")]}i.set("C",[16.35,32.7,65.41,130.81,261.63,523.25,1046.5,2093,4186.01]),i.set("Db",[17.32,34.65,69.3,138.59,277.18,554.37,1108.73,2217.46,4434.92]),i.set("D",[18.35,36.71,73.42,146.83,293.66,587.33,1174.66,2349.32,4698.63]),i.set("Eb",[19.45,38.89,77.78,155.56,311.13,622.25,1244.51,2489.02,4978.03]),i.set("E",[20.6,41.2,82.41,164.81,329.63,659.25,1318.51,2637.02,5274.04]),i.set("F",[21.83,43.65,87.31,174.61,349.23,698.46,1396.91,2793.83,5587.65]),i.set("Gb",[23.12,46.25,92.5,185,369.99,739.99,1479.98,2959.96,5919.91]),i.set("G",[24.5,49,98,196,392,783.99,1567.98,3135.96,6271.93]),i.set("Ab",[25.96,51.91,103.83,207.65,415.3,830.61,1661.22,3322.44,6644.88]),i.set("A",[27.5,55,110,220,440,880,1760,3520,7040]),i.set("Bb",[29.14,58.27,116.54,233.08,466.16,932.33,1864.66,3729.31,7458.62]),i.set("B",[30.87,61.74,123.47,246.94,493.88,987.77,1975.53,3951.07,7902.13]),i.set("pause",[0]);let o=!0,n=()=>o,a=()=>{o=!1}}}]);

package/browser/Options/Classes/Sounds.js

@@ -3,6 +3,11 @@ import { SoundsEvent } from "./SoundsEvent.js";
 import { SoundsIcons } from "./SoundsIcons.js";
 import { SoundsVolume } from "./SoundsVolume.js";
 export class Sounds {
+    autoPlay;
+    enable;
+    events;
+    icons;
+    volume;
     constructor() {
         this.autoPlay = true;
         this.enable = false;

package/browser/Options/Classes/SoundsAudio.js

@@ -1,5 +1,7 @@
 import { isNull, isObject } from "@tsparticles/engine";
 export class SoundsAudio {
+    loop;
+    source;
     constructor() {
         this.loop = false;
         this.source = "";

package/browser/Options/Classes/SoundsEvent.js

@@ -3,6 +3,11 @@ import { SoundsAudio } from "./SoundsAudio.js";
 import { SoundsMelody } from "./SoundsMelody.js";
 import { SoundsNote } from "./SoundsNote.js";
 export class SoundsEvent {
+    audio;
+    event;
+    filter;
+    melodies;
+    notes;
     constructor() {
         this.event = [];
         this.notes = [];

package/browser/Options/Classes/SoundsIcon.js

@@ -1,5 +1,10 @@
 import { isNull } from "@tsparticles/engine";
 export class SoundsIcon {
+    height;
+    path;
+    style;
+    svg;
+    width;
     constructor() {
         this.width = 24;
         this.height = 24;

package/browser/Options/Classes/SoundsIcons.js

@@ -1,6 +1,11 @@
 import { isNull } from "@tsparticles/engine";
 import { SoundsIcon } from "./SoundsIcon.js";
 export class SoundsIcons {
+    enable;
+    mute;
+    unmute;
+    volumeDown;
+    volumeUp;
     constructor() {
         this.mute = new SoundsIcon();
         this.unmute = new SoundsIcon();

package/browser/Options/Classes/SoundsMelody.js

@@ -1,6 +1,9 @@
 import { isNull } from "@tsparticles/engine";
 import { SoundsNote } from "./SoundsNote.js";
 export class SoundsMelody {
+    loop;
+    melodies;
+    notes;
     constructor() {
         this.loop = false;
         this.melodies = [];

package/browser/Options/Classes/SoundsNote.js

@@ -1,5 +1,7 @@
 import { isNull } from "@tsparticles/engine";
 export class SoundsNote {
+    duration;
+    value;
     constructor() {
         this.duration = 500;
         this.value = [];

package/browser/Options/Classes/SoundsVolume.js

@@ -1,5 +1,9 @@
 import { isNull, isObject } from "@tsparticles/engine";
 export class SoundsVolume {
+    max;
+    min;
+    step;
+    value;
     constructor() {
         this.value = 100;
         this.max = 100;

package/browser/SoundsPlugin.js

@@ -1,6 +1,5 @@
-import { mouseDownEvent, touchStartEvent, } from "@tsparticles/engine";
+import { mouseDownEvent, touchStartEvent } from "./constants.js";
 import { Sounds } from "./Options/Classes/Sounds.js";
-import { SoundsInstance } from "./SoundsInstance.js";
 import { unmuteWindow } from "./utils.js";
 const generalFirstClickHandler = () => {
     removeEventListener(mouseDownEvent, generalFirstClickHandler);
@@ -8,8 +7,9 @@ const generalFirstClickHandler = () => {
     unmuteWindow();
 };
 export class SoundsPlugin {
+    id = "sounds";
+    _engine;
     constructor(engine) {
-        this.id = "sounds";
         this._engine = engine;
         const listenerOptions = {
             capture: true,
@@ -18,10 +18,11 @@ export class SoundsPlugin {
         addEventListener(mouseDownEvent, generalFirstClickHandler, listenerOptions);
         addEventListener(touchStartEvent, generalFirstClickHandler, listenerOptions);
     }
-    getPlugin(container) {
-        return Promise.resolve(new SoundsInstance(container, this._engine));
+    async getPlugin(container) {
+        const { SoundsPluginInstance } = await import("./SoundsPluginInstance.js");
+        return new SoundsPluginInstance(container, this._engine);
     }
-    loadOptions(options, source) {
+    loadOptions(_container, options, source) {
         if (!this.needsPlugin(options) && !this.needsPlugin(source)) {
             return;
         }

package/browser/SoundsPluginInstance.js

@@ -0,0 +1,437 @@
+import { clamp, executeOnSingleOrMultiple, getLogger, isArray, isNumber, itemFromArray, itemFromSingleOrMultiple, percentDenominator, safeDocument, } from "@tsparticles/engine";
+import { ImageDisplay, SoundsEventType } from "./enums.js";
+import { getNoteFrequency, isWindowMuted, unmuteWindow } from "./utils.js";
+import { mouseDownEvent, touchStartEvent } from "./constants.js";
+const zIndexOffset = 1, rightOffset = 1, minVolume = 0;
+function initImage(data) {
+    const img = safeDocument().createElement("img"), { clickCb, container, display, iconOptions, margin, options, pos, rightOffsets } = data, { width, path, style, svg } = iconOptions, defaultAccumulator = 0;
+    setIconStyle(img, pos.top + margin, pos.right -
+        (margin * (rightOffsets.length + rightOffset) + width + rightOffsets.reduce((a, b) => a + b, defaultAccumulator)), display, options.fullScreen.zIndex + zIndexOffset, width, margin, style);
+    img.src = path ?? (svg ? `data:image/svg+xml;base64,${btoa(svg)}` : "");
+    const parent = container.canvas.element?.parentNode ?? safeDocument().body;
+    parent.append(img);
+    img.addEventListener("click", () => {
+        void clickCb();
+    });
+    return img;
+}
+function removeImage(image) {
+    if (!image) {
+        return;
+    }
+    image.remove();
+}
+function setIconStyle(icon, top, left, display, zIndex, width, margin, style) {
+    icon.style.userSelect = "none";
+    icon.style.position = "absolute";
+    icon.style.top = `${(top + margin).toString()}px`;
+    icon.style.left = `${(left - margin - width).toString()}px`;
+    icon.style.display = display;
+    icon.style.zIndex = (zIndex + zIndexOffset).toString();
+    icon.style.cssText += style;
+}
+export class SoundsPluginInstance {
+    _audioMap;
+    _audioSources;
+    _container;
+    _engine;
+    _gain;
+    _muteImg;
+    _unmuteImg;
+    _volume;
+    _volumeDownImg;
+    _volumeUpImg;
+    constructor(container, engine) {
+        this._container = container;
+        this._engine = engine;
+        this._volume = 0;
+        this._audioSources = [];
+        this._audioMap = new Map();
+    }
+    async init() {
+        const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
+        if (!soundsOptions?.enable) {
+            return;
+        }
+        if (soundsOptions.autoPlay && isWindowMuted()) {
+            const firstClickHandler = () => {
+                removeEventListener(mouseDownEvent, firstClickHandler);
+                removeEventListener(touchStartEvent, firstClickHandler);
+                unmuteWindow();
+                void this.unmute();
+            }, listenerOptions = {
+                capture: true,
+                once: true,
+            };
+            addEventListener(mouseDownEvent, firstClickHandler, listenerOptions);
+            addEventListener(touchStartEvent, firstClickHandler, listenerOptions);
+        }
+        this._volume = soundsOptions.volume.value;
+        const events = soundsOptions.events;
+        this._audioMap = new Map();
+        for (const event of events) {
+            if (!event.audio) {
+                continue;
+            }
+            const promises = executeOnSingleOrMultiple(event.audio, async (audio) => {
+                const response = await fetch(audio.source);
+                if (!response.ok) {
+                    return;
+                }
+                const arrayBuffer = await response.arrayBuffer(), audioContext = this._getAudioContext(), audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
+                this._audioMap.set(audio.source, audioBuffer);
+            });
+            if (promises instanceof Promise) {
+                await promises;
+            }
+            else {
+                await Promise.allSettled(promises);
+            }
+        }
+    }
+    async mute() {
+        if (!this._container.muted) {
+            await this.toggleMute();
+        }
+    }
+    async start() {
+        const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
+        if (!soundsOptions?.enable || !container.canvas.element) {
+            return;
+        }
+        container.muted = true;
+        const canvas = container.canvas.element, pos = {
+            top: canvas.offsetTop,
+            right: canvas.offsetLeft + canvas.offsetWidth,
+        }, { mute, unmute, volumeDown, volumeUp } = soundsOptions.icons, margin = 10, toggleMute = async () => {
+            await this.toggleMute();
+        }, enableIcons = soundsOptions.icons.enable, display = enableIcons ? ImageDisplay.Block : ImageDisplay.None;
+        this._muteImg = initImage({
+            container,
+            options,
+            pos,
+            display,
+            iconOptions: mute,
+            margin,
+            rightOffsets: [volumeDown.width, volumeUp.width],
+            clickCb: toggleMute,
+        });
+        this._unmuteImg = initImage({
+            container,
+            options,
+            pos,
+            display: ImageDisplay.None,
+            iconOptions: unmute,
+            margin,
+            rightOffsets: [volumeDown.width, volumeUp.width],
+            clickCb: toggleMute,
+        });
+        this._volumeDownImg = initImage({
+            container,
+            options,
+            pos,
+            display,
+            iconOptions: volumeDown,
+            margin,
+            rightOffsets: [volumeUp.width],
+            clickCb: async () => {
+                await this.volumeDown();
+            },
+        });
+        this._volumeUpImg = initImage({
+            container,
+            options,
+            pos,
+            display,
+            iconOptions: volumeUp,
+            margin,
+            rightOffsets: [],
+            clickCb: async () => {
+                await this.volumeUp();
+            },
+        });
+        if (!isWindowMuted() && soundsOptions.autoPlay) {
+            await this.unmute();
+        }
+    }
+    stop() {
+        this._container.muted = true;
+        void (async () => {
+            await this._mute();
+            removeImage(this._muteImg);
+            removeImage(this._unmuteImg);
+            removeImage(this._volumeDownImg);
+            removeImage(this._volumeUpImg);
+        })();
+    }
+    async toggleMute() {
+        const container = this._container;
+        container.muted = !container.muted;
+        this._updateMuteIcons();
+        await this._updateMuteStatus();
+    }
+    async unmute() {
+        if (this._container.muted) {
+            await this.toggleMute();
+        }
+    }
+    async volumeDown() {
+        const container = this._container, soundsOptions = container.actualOptions.sounds;
+        if (!soundsOptions?.enable) {
+            return;
+        }
+        if (container.muted) {
+            this._volume = 0;
+        }
+        this._volume -= soundsOptions.volume.step;
+        await this._updateVolume();
+    }
+    async volumeUp() {
+        const container = this._container, soundsOptions = container.actualOptions.sounds;
+        if (!soundsOptions?.enable) {
+            return;
+        }
+        this._volume += soundsOptions.volume.step;
+        await this._updateVolume();
+    }
+    _addBuffer = audioCtx => {
+        const buffer = audioCtx.createBufferSource();
+        this._audioSources.push(buffer);
+        return buffer;
+    };
+    _addOscillator = audioCtx => {
+        const oscillator = audioCtx.createOscillator();
+        this._audioSources.push(oscillator);
+        return oscillator;
+    };
+    _getAudioContext() {
+        const container = this._container;
+        container.audioContext ??= new AudioContext();
+        return container.audioContext;
+    }
+    _initEvents = () => {
+        const container = this._container, soundsOptions = container.actualOptions.sounds;
+        if (!soundsOptions?.enable || !container.canvas.element) {
+            return;
+        }
+        for (const event of soundsOptions.events) {
+            const cb = (args) => {
+                if (!args) {
+                    return;
+                }
+                void (async () => {
+                    const filterNotValid = event.filter && !event.filter(args);
+                    if (this._container !== args.container) {
+                        return;
+                    }
+                    if (!!this._container.muted || this._container.destroyed) {
+                        executeOnSingleOrMultiple(event.event, item => {
+                            this._engine.removeEventListener(item, cb);
+                        });
+                        return;
+                    }
+                    if (filterNotValid) {
+                        return;
+                    }
+                    const defaultNoteIndex = 0;
+                    if (event.audio) {
+                        const audio = itemFromSingleOrMultiple(event.audio);
+                        if (!audio) {
+                            return;
+                        }
+                        this._playBuffer(audio);
+                    }
+                    else if (event.melodies) {
+                        const melody = itemFromArray(event.melodies);
+                        if (!melody) {
+                            return;
+                        }
+                        if (melody.melodies.length) {
+                            await Promise.allSettled(melody.melodies.map(m => this._playNote(m.notes, defaultNoteIndex, melody.loop)));
+                        }
+                        else {
+                            await this._playNote(melody.notes, defaultNoteIndex, melody.loop);
+                        }
+                    }
+                    else if (event.notes) {
+                        const note = itemFromArray(event.notes);
+                        if (!note) {
+                            return;
+                        }
+                        await this._playNote([note], defaultNoteIndex, false);
+                    }
+                })();
+            };
+            executeOnSingleOrMultiple(event.event, item => {
+                this._engine.addEventListener(item, cb);
+            });
+        }
+    };
+    _mute = async () => {
+        const container = this._container, audioContext = this._getAudioContext();
+        for (const source of this._audioSources) {
+            this._removeAudioSource(source);
+        }
+        if (this._gain) {
+            this._gain.disconnect();
+        }
+        await audioContext.close();
+        container.audioContext = undefined;
+        this._engine.dispatchEvent(SoundsEventType.mute, { container: this._container });
+    };
+    _playBuffer = audio => {
+        const audioBuffer = this._audioMap.get(audio.source);
+        if (!audioBuffer) {
+            return;
+        }
+        const audioCtx = this._container.audioContext;
+        if (!audioCtx) {
+            return;
+        }
+        const source = this._addBuffer(audioCtx);
+        source.loop = audio.loop;
+        source.buffer = audioBuffer;
+        source.connect(this._gain ?? audioCtx.destination);
+        source.start();
+    };
+    _playFrequency = async (frequency, duration) => {
+        if (!this._gain || this._container.muted) {
+            return;
+        }
+        const audioContext = this._getAudioContext(), oscillator = this._addOscillator(audioContext);
+        oscillator.connect(this._gain);
+        oscillator.type = "sine";
+        oscillator.frequency.value = frequency;
+        oscillator.start();
+        return new Promise(resolve => {
+            setTimeout(() => {
+                this._removeAudioSource(oscillator);
+                resolve();
+            }, duration);
+        });
+    };
+    _playMuteSound = () => {
+        if (this._container.muted) {
+            return;
+        }
+        const audioContext = this._getAudioContext(), gain = audioContext.createGain();
+        gain.connect(audioContext.destination);
+        gain.gain.value = 0;
+        const oscillator = audioContext.createOscillator();
+        oscillator.connect(gain);
+        oscillator.type = "sine";
+        oscillator.frequency.value = 1;
+        oscillator.start();
+        setTimeout(() => {
+            oscillator.stop();
+            oscillator.disconnect();
+            gain.disconnect();
+        });
+    };
+    _playNote = async (notes, noteIdx, loop) => {
+        if (this._container.muted) {
+            return;
+        }
+        const note = notes[noteIdx];
+        if (!note) {
+            return;
+        }
+        const value = note.value, promises = executeOnSingleOrMultiple(value, async (_, idx) => {
+            return this._playNoteValue(notes, noteIdx, idx);
+        });
+        await (isArray(promises) ? Promise.allSettled(promises) : promises);
+        const indexOffset = 1;
+        let nextNoteIdx = noteIdx + indexOffset;
+        if (loop && nextNoteIdx >= notes.length) {
+            nextNoteIdx = nextNoteIdx % notes.length;
+        }
+        await this._playNote(notes, nextNoteIdx, loop);
+    };
+    _playNoteValue = async (notes, noteIdx, valueIdx) => {
+        const note = notes[noteIdx];
+        if (!note) {
+            return;
+        }
+        const value = itemFromSingleOrMultiple(note.value, valueIdx, true);
+        if (!value) {
+            return;
+        }
+        try {
+            const freq = getNoteFrequency(value);
+            if (!isNumber(freq)) {
+                return;
+            }
+            await this._playFrequency(freq, note.duration);
+        }
+        catch (e) {
+            getLogger().error(e);
+        }
+    };
+    _removeAudioSource = source => {
+        source.stop();
+        source.disconnect();
+        const deleteCount = 1;
+        this._audioSources.splice(this._audioSources.indexOf(source), deleteCount);
+    };
+    _unmute = () => {
+        const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
+        if (!soundsOptions) {
+            return;
+        }
+        const audioContext = this._getAudioContext(), gain = audioContext.createGain();
+        gain.connect(audioContext.destination);
+        gain.gain.value = soundsOptions.volume.value / percentDenominator;
+        this._gain = gain;
+        this._initEvents();
+        this._engine.dispatchEvent(SoundsEventType.unmute, { container: this._container });
+    };
+    _updateMuteIcons = () => {
+        const container = this._container, soundsOptions = container.actualOptions.sounds;
+        if (!soundsOptions?.enable || !soundsOptions.icons.enable) {
+            return;
+        }
+        const muteImg = this._muteImg, unmuteImg = this._unmuteImg;
+        if (muteImg) {
+            muteImg.style.display = container.muted ? "block" : "none";
+        }
+        if (unmuteImg) {
+            unmuteImg.style.display = container.muted ? "none" : "block";
+        }
+    };
+    _updateMuteStatus = async () => {
+        const container = this._container, audioContext = this._getAudioContext();
+        if (container.muted) {
+            await audioContext.suspend();
+            await this._mute();
+        }
+        else {
+            await audioContext.resume();
+            this._unmute();
+            this._playMuteSound();
+        }
+    };
+    _updateVolume = async () => {
+        const container = this._container, soundsOptions = container.actualOptions.sounds;
+        if (!soundsOptions?.enable) {
+            return;
+        }
+        clamp(this._volume, soundsOptions.volume.min, soundsOptions.volume.max);
+        let stateChanged = false;
+        if (this._volume <= minVolume && !container.muted) {
+            this._volume = 0;
+            container.muted = true;
+            stateChanged = true;
+        }
+        else if (this._volume > minVolume && container.muted) {
+            container.muted = false;
+            stateChanged = true;
+        }
+        if (stateChanged) {
+            this._updateMuteIcons();
+            await this._updateMuteStatus();
+        }
+        if (this._gain?.gain) {
+            this._gain.gain.value = this._volume / percentDenominator;
+        }
+    };
+}

package/browser/constants.js

@@ -0,0 +1 @@
+export const mouseDownEvent = "pointerdown", touchStartEvent = "touchstart";

package/browser/index.js

@@ -1,6 +1,6 @@
-export function loadSoundsPlugin(engine) {
-    engine.checkVersion("4.0.0-alpha.2");
-    engine.register(async (e) => {
+export async function loadSoundsPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.21");
+    await engine.register(async (e) => {
         const { SoundsPlugin } = await import("./SoundsPlugin.js");
         e.addPlugin(new SoundsPlugin(engine));
     });

package/cjs/Options/Classes/Sounds.js

@@ -3,6 +3,11 @@ import { SoundsEvent } from "./SoundsEvent.js";
 import { SoundsIcons } from "./SoundsIcons.js";
 import { SoundsVolume } from "./SoundsVolume.js";
 export class Sounds {
+    autoPlay;
+    enable;
+    events;
+    icons;
+    volume;
     constructor() {
         this.autoPlay = true;
         this.enable = false;

package/cjs/Options/Classes/SoundsAudio.js

@@ -1,5 +1,7 @@
 import { isNull, isObject } from "@tsparticles/engine";
 export class SoundsAudio {
+    loop;
+    source;
     constructor() {
         this.loop = false;
         this.source = "";