@tsparticles/plugin-sounds 3.0.3 → 3.2.0

package/265.min.js

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

package/265.min.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! tsParticles Sounds Plugin v3.2.0 by Matteo Bruni */

package/714.min.js

@@ -0,0 +1,2 @@
+/*! For license information please see 714.min.js.LICENSE.txt */
+(this.webpackChunk_tsparticles_plugin_sounds=this.webpackChunk_tsparticles_plugin_sounds||[]).push([[714],{714:(t,s,e)=>{e.d(s,{SoundsPlugin:()=>w});var i=e(533);class n{constructor(){this.loop=!1,this.source=""}load(t){void 0!==t&&((0,i.isObject)(t)?(void 0!==t.loop&&(this.loop=t.loop),void 0!==t.source&&(this.source=t.source)):this.source=t)}}class o{constructor(){this.duration=500,this.value=[]}load(t){t&&(void 0!==t.duration&&(this.duration=t.duration),void 0!==t.value&&(this.value=t.value))}}class l{constructor(){this.loop=!1,this.melodies=[],this.notes=[]}load(t){void 0!==t&&(void 0!==t.loop&&(this.loop=t.loop),void 0!==t.melodies&&(this.melodies=t.melodies.map((t=>{const s=new l;return s.load(t),s}))),void 0!==t.notes&&(this.notes=t.notes.map((t=>{const s=new o;return s.load(t),s}))))}}class c{constructor(){this.event=[],this.notes=[]}load(t){if(t&&(void 0!==t.event&&(this.event=t.event),void 0!==t.audio&&((0,i.isArray)(t.audio)?this.audio=t.audio.map((t=>{const s=new n;return s.load(t),s})):(this.audio=new n,this.audio.load(t.audio))),void 0!==t.notes&&(this.notes=t.notes.map((t=>{const s=new o;return s.load(t),s}))),void 0!==t.melodies&&(this.melodies=t.melodies.map((t=>{const s=new l;return s.load(t),s}))),t.filter))if((0,i.isString)(t.filter)){const s=window[t.filter];(0,i.isFunction)(s)&&(this.filter=s)}else this.filter=t.filter}}class a{constructor(){this.width=24,this.height=24,this.style=""}load(t){t&&(void 0!==t.path&&(this.path=t.path),void 0!==t.svg&&(this.svg=t.svg),void 0!==t.width&&(this.width=t.width),void 0!==t.height&&(this.height=t.height))}}class h{constructor(){this.mute=new a,this.unmute=new a,this.volumeDown=new a,this.volumeUp=new a,this.enable=!1,this.mute.svg='<?xml version="1.0"?>\n<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"\n    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"\n    xmlns:xlink="http://www.w3.org/1999/xlink">\n    <g id="Layer_1">\n        <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"/>\n    </g>\n</svg>',this.unmute.svg='<?xml version="1.0"?>\n<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"\n    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"\n    xmlns:xlink="http://www.w3.org/1999/xlink">\n    <g id="Layer_1">\n        <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"/>\n    </g>\n</svg>',this.volumeDown.svg='<?xml version="1.0"?>\n<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"\n    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"\n    xmlns:xlink="http://www.w3.org/1999/xlink">\n    <g id="Layer_1">\n        <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"/>\n        <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"/>\n    </g>\n</svg>',this.volumeUp.svg='<?xml version="1.0"?>\n<svg baseProfile="tiny" height="24px" version="1.2" viewBox="0 0 24 24" width="24px"\n    xml:space="preserve" xmlns="http://www.w3.org/2000/svg"\n    xmlns:xlink="http://www.w3.org/1999/xlink">\n    <g id="Layer_1">\n        <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"/>\n        <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"/>\n        <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"/>\n        <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"/>\n    </g>\n</svg>'}load(t){t&&(void 0!==t.enable&&(this.enable=t.enable),this.mute.load(t.mute),this.unmute.load(t.unmute),this.volumeDown.load(t.volumeDown),this.volumeUp.load(t.volumeUp))}}class v{constructor(){this.value=100,this.max=100,this.min=0,this.step=10}load(t){void 0!==t&&((0,i.isObject)(t)?(void 0!==t.max&&(this.max=t.max),void 0!==t.min&&(this.min=t.min),void 0!==t.step&&(this.step=t.step),void 0!==t.value&&(this.value=t.value)):this.value=t)}}class d{constructor(){this.autoPlay=!0,this.enable=!1,this.events=[],this.icons=new h,this.volume=new v}load(t){t&&(void 0!==t.autoPlay&&(this.autoPlay=t.autoPlay),void 0!==t.enable&&(this.enable=t.enable),void 0!==t.events&&(this.events=t.events.map((t=>{const s=new c;return s.load(t),s}))),this.icons.load(t.icons),void 0!==t.volume&&this.volume.load(t.volume))}}var r=e(856);const u=()=>{removeEventListener(i.mouseDownEvent,u),removeEventListener(i.touchStartEvent,u),(0,r.ON)()};class w{constructor(t){this.id="sounds",this._engine=t;const s={capture:!0,once:!0};addEventListener(i.mouseDownEvent,u,s),addEventListener(i.touchStartEvent,u,s)}async getPlugin(t){const{SoundsInstance:s}=await e.e(265).then(e.bind(e,265));return new s(t,this._engine)}loadOptions(t,s){if(!this.needsPlugin(t)&&!this.needsPlugin(s))return;let e=t.sounds;void 0===e?.load&&(t.sounds=e=new d),e.load(s?.sounds)}needsPlugin(t){return t?.sounds?.enable??!1}}},856:(t,s,e)=>{e.d(s,{ON:()=>c,c3:()=>l,g6:()=>n});const i=new Map;function n(t){const s=/(([A-G]b?)(\d))|pause/i.exec(t);if(!s?.length)return;const e=s[2]||s[0],n=i.get(e);return n?n[parseInt(s[3]||"0")]:void 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;const l=()=>o,c=()=>{o=!1}}}]);

package/714.min.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! tsParticles Sounds Plugin v3.2.0 by Matteo Bruni */

package/browser/Options/Classes/Sounds.js

@@ -3,6 +3,7 @@ import { SoundsIcons } from "./SoundsIcons.js";
 import { SoundsVolume } from "./SoundsVolume.js";
 export class Sounds {
     constructor() {
+        this.autoPlay = true;
         this.enable = false;
         this.events = [];
         this.icons = new SoundsIcons();
@@ -12,6 +13,9 @@ export class Sounds {
         if (!data) {
             return;
         }
+        if (data.autoPlay !== undefined) {
+            this.autoPlay = data.autoPlay;
+        }
         if (data.enable !== undefined) {
             this.enable = data.enable;
         }

package/browser/Options/Classes/SoundsEvent.js

@@ -41,10 +41,11 @@ export class SoundsEvent {
                 return tmp;
             });
         }
-        if (data.filter !== undefined) {
+        if (data.filter) {
             if (isString(data.filter)) {
-                if (isFunction(window[data.filter])) {
-                    this.filter = window[data.filter];
+                const filterFunc = window[data.filter];
+                if (isFunction(filterFunc)) {
+                    this.filter = filterFunc;
                 }
             }
             else {

package/browser/Options/Classes/SoundsIcon.js

@@ -2,6 +2,7 @@ export class SoundsIcon {
     constructor() {
         this.width = 24;
         this.height = 24;
+        this.style = "";
     }
     load(data) {
         if (!data) {

package/browser/Options/Classes/SoundsIcons.js

@@ -5,6 +5,7 @@ export class SoundsIcons {
         this.unmute = new SoundsIcon();
         this.volumeDown = new SoundsIcon();
         this.volumeUp = new SoundsIcon();
+        this.enable = false;
         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"
@@ -46,6 +47,9 @@ export class SoundsIcons {
         if (!data) {
             return;
         }
+        if (data.enable !== undefined) {
+            this.enable = data.enable;
+        }
         this.mute.load(data.mute);
         this.unmute.load(data.unmute);
         this.volumeDown.load(data.volumeDown);

package/browser/SoundsInstance.js

@@ -1,12 +1,18 @@
-import { clamp, executeOnSingleOrMultiple, getLogger, isArray, isNumber, itemFromArray, itemFromSingleOrMultiple, } from "@tsparticles/engine";
-import { getNoteFrequency } from "./utils.js";
+import { clamp, executeOnSingleOrMultiple, getLogger, isArray, isNumber, itemFromArray, itemFromSingleOrMultiple, mouseDownEvent, percentDenominator, touchStartEvent, } from "@tsparticles/engine";
+import { getNoteFrequency, isWindowMuted, unmuteWindow } from "./utils.js";
+const zIndexOffset = 1, rightOffset = 1, minVolume = 0;
 function initImage(data) {
-    const img = document.createElement("img"), { clickCb, container, display, iconOptions, margin, options, pos, rightOffsets } = data, { width, path, svg } = iconOptions;
-    setIconStyle(img, pos.top + margin, pos.right - (margin * (rightOffsets.length + 1) + width + rightOffsets.reduce((a, b) => a + b, 0)), display, options.fullScreen.zIndex + 1, width, margin);
+    const img = document.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 || document.body;
+    const parent = container.canvas.element?.parentNode ?? document.body;
     parent.append(img);
-    img.addEventListener("click", clickCb);
+    img.addEventListener("click", () => {
+        void clickCb();
+    });
     return img;
 }
 function removeImage(image) {
@@ -15,14 +21,15 @@ function removeImage(image) {
     }
     image.remove();
 }
-function setIconStyle(icon, top, left, display, zIndex, width, margin) {
+function setIconStyle(icon, top, left, display, zIndex, width, margin, style) {
     icon.style.userSelect = "none";
     icon.style.webkitUserSelect = "none";
     icon.style.position = "absolute";
     icon.style.top = `${top + margin}px`;
     icon.style.left = `${left - margin - width}px`;
     icon.style.display = display;
-    icon.style.zIndex = `${zIndex + 1}`;
+    icon.style.zIndex = `${zIndex + zIndexOffset}`;
+    icon.style.cssText += style;
 }
 export class SoundsInstance {
     constructor(container, engine) {
@@ -43,12 +50,12 @@ export class SoundsInstance {
             }
             for (const event of soundsOptions.events) {
                 const cb = (args) => {
-                    (async () => {
+                    void (async () => {
                         const filterNotValid = event.filter && !event.filter(args);
                         if (this._container !== args.container) {
                             return;
                         }
-                        if (!this._container || this._container.muted || this._container.destroyed) {
+                        if (!this._container || !!this._container.muted || this._container.destroyed) {
                             executeOnSingleOrMultiple(event.event, (item) => {
                                 this._engine.removeEventListener(item, cb);
                             });
@@ -57,21 +64,22 @@ export class SoundsInstance {
                         if (filterNotValid) {
                             return;
                         }
+                        const defaultNoteIndex = 0;
                         if (event.audio) {
                             this._playBuffer(itemFromSingleOrMultiple(event.audio));
                         }
                         else if (event.melodies) {
                             const melody = itemFromArray(event.melodies);
                             if (melody.melodies.length) {
-                                await Promise.allSettled(melody.melodies.map((m) => this._playNote(m.notes, 0, melody.loop)));
+                                await Promise.allSettled(melody.melodies.map((m) => this._playNote(m.notes, defaultNoteIndex, melody.loop)));
                             }
                             else {
-                                await this._playNote(melody.notes, 0, melody.loop);
+                                await this._playNote(melody.notes, defaultNoteIndex, melody.loop);
                             }
                         }
                         else if (event.notes) {
                             const note = itemFromArray(event.notes);
-                            await this._playNote([note], 0, false);
+                            await this._playNote([note], defaultNoteIndex, false);
                         }
                     })();
                 };
@@ -80,18 +88,15 @@ export class SoundsInstance {
                 });
             }
         };
-        this._mute = () => {
-            const container = this._container;
-            if (!container.audioContext) {
-                return;
-            }
+        this._mute = async () => {
+            const container = this._container, audioContext = this._getAudioContext();
             for (const source of this._audioSources) {
                 this._removeAudioSource(source);
             }
             if (this._gain) {
                 this._gain.disconnect();
             }
-            container.audioContext.close();
+            await audioContext.close();
             container.audioContext = undefined;
             this._engine.dispatchEvent("soundsMuted", { container: this._container });
         };
@@ -111,10 +116,10 @@ export class SoundsInstance {
             source.start();
         };
         this._playFrequency = async (frequency, duration) => {
-            if (!this._container.audioContext || !this._gain) {
+            if (!this._gain || this._container.muted) {
                 return;
             }
-            const oscillator = this._addOscillator(this._container.audioContext);
+            const audioContext = this._getAudioContext(), oscillator = this._addOscillator(audioContext);
             oscillator.connect(this._gain);
             oscillator.type = "sine";
             oscillator.frequency.value = frequency;
@@ -127,14 +132,13 @@ export class SoundsInstance {
             });
         };
         this._playMuteSound = () => {
-            const container = this._container;
-            if (!container.audioContext) {
+            if (this._container.muted) {
                 return;
             }
-            const gain = container.audioContext.createGain();
-            gain.connect(container.audioContext.destination);
+            const audioContext = this._getAudioContext(), gain = audioContext.createGain();
+            gain.connect(audioContext.destination);
             gain.gain.value = 0;
-            const oscillator = container.audioContext.createOscillator();
+            const oscillator = audioContext.createOscillator();
             oscillator.connect(gain);
             oscillator.type = "sine";
             oscillator.frequency.value = 1;
@@ -158,7 +162,8 @@ export class SoundsInstance {
                 return this._playNoteValue(notes, noteIdx, idx);
             });
             await (isArray(promises) ? Promise.allSettled(promises) : promises);
-            let nextNoteIdx = noteIdx + 1;
+            const indexOffset = 1;
+            let nextNoteIdx = noteIdx + indexOffset;
             if (loop && nextNoteIdx >= notes.length) {
                 nextNoteIdx = nextNoteIdx % notes.length;
             }
@@ -187,29 +192,31 @@ export class SoundsInstance {
         this._removeAudioSource = (source) => {
             source.stop();
             source.disconnect();
-            this._audioSources.splice(this._audioSources.indexOf(source), 1);
+            const deleteCount = 1;
+            this._audioSources.splice(this._audioSources.indexOf(source), deleteCount);
         };
         this._unmute = () => {
             const container = this._container, options = container.actualOptions, soundsOptions = options.sounds;
             if (!soundsOptions) {
                 return;
             }
-            if (!container.audioContext) {
-                container.audioContext = new AudioContext();
-            }
-            const { audioContext } = container;
+            const audioContext = this._getAudioContext();
             if (!this._audioSources) {
                 this._audioSources = [];
             }
             const gain = audioContext.createGain();
             gain.connect(audioContext.destination);
-            gain.gain.value = soundsOptions.volume.value / 100;
+            gain.gain.value = soundsOptions.volume.value / percentDenominator;
             this._gain = gain;
             this._initEvents();
             this._engine.dispatchEvent("soundsUnmuted", { container: this._container });
         };
         this._updateMuteIcons = () => {
-            const container = this._container, muteImg = this._muteImg, unmuteImg = this._unmuteImg;
+            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";
             }
@@ -218,13 +225,13 @@ export class SoundsInstance {
             }
         };
         this._updateMuteStatus = async () => {
-            const container = this._container;
+            const container = this._container, audioContext = this._getAudioContext();
             if (container.muted) {
-                await container.audioContext?.suspend();
-                this._mute();
+                await audioContext?.suspend();
+                await this._mute();
             }
             else {
-                await container.audioContext?.resume();
+                await audioContext?.resume();
                 this._unmute();
                 this._playMuteSound();
             }
@@ -236,12 +243,12 @@ export class SoundsInstance {
             }
             clamp(this._volume, soundsOptions.volume.min, soundsOptions.volume.max);
             let stateChanged = false;
-            if (this._volume <= 0 && !container.muted) {
+            if (this._volume <= minVolume && !container.muted) {
                 this._volume = 0;
                 container.muted = true;
                 stateChanged = true;
             }
-            else if (this._volume > 0 && container.muted) {
+            else if (this._volume > minVolume && container.muted) {
                 container.muted = false;
                 stateChanged = true;
             }
@@ -250,7 +257,7 @@ export class SoundsInstance {
                 await this._updateMuteStatus();
             }
             if (this._gain?.gain) {
-                this._gain.gain.value = this._volume / 100;
+                this._gain.gain.value = this._volume / percentDenominator;
             }
         };
         this._container = container;
@@ -264,6 +271,20 @@ export class SoundsInstance {
         if (!soundsOptions?.enable) {
             return;
         }
+        if (soundsOptions.autoPlay && isWindowMuted()) {
+            const firstClickHandler = () => {
+                removeEventListener(mouseDownEvent, firstClickHandler);
+                removeEventListener(touchStartEvent, firstClickHandler);
+                unmuteWindow();
+                void this.unmute();
+            };
+            const 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();
@@ -271,16 +292,25 @@ export class SoundsInstance {
             if (!event.audio) {
                 continue;
             }
-            executeOnSingleOrMultiple(event.audio, async (audio) => {
+            const promises = executeOnSingleOrMultiple(event.audio, async (audio) => {
                 const response = await fetch(audio.source);
                 if (!response.ok) {
                     return;
                 }
-                const arrayBuffer = await response.arrayBuffer();
-                container.audioContext = new AudioContext();
-                const audioBuffer = await container.audioContext.decodeAudioData(arrayBuffer);
+                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() {
@@ -292,17 +322,14 @@ export class SoundsInstance {
         const canvas = container.canvas.element, pos = {
             top: canvas.offsetTop,
             right: canvas.offsetLeft + canvas.offsetWidth,
-        }, { mute, unmute, volumeDown, volumeUp } = soundsOptions.icons, margin = 10;
-        const toggleMute = async () => {
-            container.muted = !container.muted;
-            this._updateMuteIcons();
-            await this._updateMuteStatus();
-        };
+        }, { mute, unmute, volumeDown, volumeUp } = soundsOptions.icons, margin = 10, toggleMute = async () => {
+            await this.toggleMute();
+        }, enableIcons = soundsOptions.icons.enable, display = enableIcons ? "block" : "none";
         this._muteImg = initImage({
             container,
             options,
             pos,
-            display: "block",
+            display,
             iconOptions: mute,
             margin,
             rightOffsets: [volumeDown.width, volumeUp.width],
@@ -322,41 +349,75 @@ export class SoundsInstance {
             container,
             options,
             pos,
-            display: "block",
+            display,
             iconOptions: volumeDown,
             margin,
             rightOffsets: [volumeUp.width],
             clickCb: async () => {
-                if (container.muted) {
-                    this._volume = 0;
-                }
-                this._volume -= soundsOptions.volume.step;
-                await this._updateVolume();
+                await this.volumeDown();
             },
         });
         this._volumeUpImg = initImage({
             container,
             options,
             pos,
-            display: "block",
+            display,
             iconOptions: volumeUp,
             margin,
             rightOffsets: [],
             clickCb: async () => {
-                if (container.muted) {
-                    this._volume = 0;
-                }
-                this._volume += soundsOptions.volume.step;
-                await this._updateVolume();
+                await this.volumeUp();
             },
         });
+        if (!isWindowMuted() && soundsOptions.autoPlay) {
+            await this.unmute();
+        }
     }
     stop() {
         this._container.muted = true;
-        this._mute();
-        removeImage(this._muteImg);
-        removeImage(this._unmuteImg);
-        removeImage(this._volumeDownImg);
-        removeImage(this._volumeUpImg);
+        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();
+    }
+    _getAudioContext() {
+        const container = this._container;
+        if (!container.audioContext) {
+            container.audioContext = new AudioContext();
+        }
+        return container.audioContext;
     }
 }

package/browser/SoundsPlugin.js

@@ -0,0 +1,37 @@
+import { mouseDownEvent, touchStartEvent, } from "@tsparticles/engine";
+import { Sounds } from "./Options/Classes/Sounds.js";
+import { unmuteWindow } from "./utils.js";
+const generalFirstClickHandler = () => {
+    removeEventListener(mouseDownEvent, generalFirstClickHandler);
+    removeEventListener(touchStartEvent, generalFirstClickHandler);
+    unmuteWindow();
+};
+export class SoundsPlugin {
+    constructor(engine) {
+        this.id = "sounds";
+        this._engine = engine;
+        const listenerOptions = {
+            capture: true,
+            once: true,
+        };
+        addEventListener(mouseDownEvent, generalFirstClickHandler, listenerOptions);
+        addEventListener(touchStartEvent, generalFirstClickHandler, listenerOptions);
+    }
+    async getPlugin(container) {
+        const { SoundsInstance } = await import("./SoundsInstance.js");
+        return new SoundsInstance(container, this._engine);
+    }
+    loadOptions(options, source) {
+        if (!this.needsPlugin(options) && !this.needsPlugin(source)) {
+            return;
+        }
+        let soundsOptions = options.sounds;
+        if (soundsOptions?.load === undefined) {
+            options.sounds = soundsOptions = new Sounds();
+        }
+        soundsOptions.load(source?.sounds);
+    }
+    needsPlugin(options) {
+        return options?.sounds?.enable ?? false;
+    }
+}

package/browser/index.js

@@ -1,27 +1,4 @@
-import { Sounds } from "./Options/Classes/Sounds.js";
-import { SoundsInstance } from "./SoundsInstance.js";
-class SoundsPlugin {
-    constructor(engine) {
-        this.id = "sounds";
-        this._engine = engine;
-    }
-    getPlugin(container) {
-        return new SoundsInstance(container, this._engine);
-    }
-    loadOptions(options, source) {
-        if (!this.needsPlugin(options) && !this.needsPlugin(source)) {
-            return;
-        }
-        let soundsOptions = options.sounds;
-        if (soundsOptions?.load === undefined) {
-            options.sounds = soundsOptions = new Sounds();
-        }
-        soundsOptions.load(source?.sounds);
-    }
-    needsPlugin(options) {
-        return options?.sounds?.enable ?? false;
-    }
-}
 export async function loadSoundsPlugin(engine, refresh = true) {
+    const { SoundsPlugin } = await import("./SoundsPlugin.js");
     await engine.addPlugin(new SoundsPlugin(engine), refresh);
 }

package/browser/utils.js

@@ -13,13 +13,20 @@ notes.set("Bb", [29.14, 58.27, 116.54, 233.08, 466.16, 932.33, 1864.66, 3729.31,
 notes.set("B", [30.87, 61.74, 123.47, 246.94, 493.88, 987.77, 1975.53, 3951.07, 7902.13]);
 notes.set("pause", [0]);
 export function getNoteFrequency(note) {
-    const regex = /(([A-G]b?)(\d))|pause/i, result = regex.exec(note);
-    if (!result || !result.length) {
+    const regex = /(([A-G]b?)(\d))|pause/i, result = regex.exec(note), groupKey = 2, defaultMatchKey = 0, innerGroupKey = 3;
+    if (!result?.length) {
         return;
     }
-    const noteKey = result[2] || result[0], noteItem = notes.get(noteKey);
+    const noteKey = result[groupKey] || result[defaultMatchKey], noteItem = notes.get(noteKey);
     if (!noteItem) {
         return;
     }
-    return noteItem[parseInt(result[3] || "0")];
+    return noteItem[parseInt(result[innerGroupKey] || "0")];
 }
+let muted = true;
+export const isWindowMuted = () => {
+    return muted;
+};
+export const unmuteWindow = () => {
+    muted = false;
+};

package/cjs/Options/Classes/Sounds.js

@@ -6,6 +6,7 @@ const SoundsIcons_js_1 = require("./SoundsIcons.js");
 const SoundsVolume_js_1 = require("./SoundsVolume.js");
 class Sounds {
     constructor() {
+        this.autoPlay = true;
         this.enable = false;
         this.events = [];
         this.icons = new SoundsIcons_js_1.SoundsIcons();
@@ -15,6 +16,9 @@ class Sounds {
         if (!data) {
             return;
         }
+        if (data.autoPlay !== undefined) {
+            this.autoPlay = data.autoPlay;
+        }
         if (data.enable !== undefined) {
             this.enable = data.enable;
         }

package/cjs/Options/Classes/SoundsEvent.js

@@ -44,10 +44,11 @@ class SoundsEvent {
                 return tmp;
             });
         }
-        if (data.filter !== undefined) {
+        if (data.filter) {
             if ((0, engine_1.isString)(data.filter)) {
-                if ((0, engine_1.isFunction)(window[data.filter])) {
-                    this.filter = window[data.filter];
+                const filterFunc = window[data.filter];
+                if ((0, engine_1.isFunction)(filterFunc)) {
+                    this.filter = filterFunc;
                 }
             }
             else {

package/cjs/Options/Classes/SoundsIcon.js

@@ -5,6 +5,7 @@ class SoundsIcon {
     constructor() {
         this.width = 24;
         this.height = 24;
+        this.style = "";
     }
     load(data) {
         if (!data) {

package/cjs/Options/Classes/SoundsIcons.js

@@ -8,6 +8,7 @@ class SoundsIcons {
         this.unmute = new SoundsIcon_js_1.SoundsIcon();
         this.volumeDown = new SoundsIcon_js_1.SoundsIcon();
         this.volumeUp = new SoundsIcon_js_1.SoundsIcon();
+        this.enable = false;
         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"
@@ -49,6 +50,9 @@ class SoundsIcons {
         if (!data) {
             return;
         }
+        if (data.enable !== undefined) {
+            this.enable = data.enable;
+        }
         this.mute.load(data.mute);
         this.unmute.load(data.unmute);
         this.volumeDown.load(data.volumeDown);