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

package/esm/SoundsInstance.js

@@ -1,15 +1,15 @@
-import { clamp, executeOnSingleOrMultiple, getLogger, isArray, isNumber, itemFromArray, itemFromSingleOrMultiple, mouseDownEvent, percentDenominator, touchStartEvent, } from "@tsparticles/engine";
+import { clamp, executeOnSingleOrMultiple, getLogger, isArray, isNumber, itemFromArray, itemFromSingleOrMultiple, mouseDownEvent, percentDenominator, safeDocument, touchStartEvent, } from "@tsparticles/engine";
 import { ImageDisplay, SoundsEventType } from "./enums.js";
 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, style, svg } = iconOptions, defaultAccumulator = 0;
+    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 ?? document.body;
+    const parent = container.canvas.element?.parentNode ?? safeDocument().body;
     parent.append(img);
     img.addEventListener("click", () => {
         void clickCb();
@@ -24,12 +24,11 @@ function removeImage(image) {
 }
 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.top = `${(top + margin).toString()}px`;
+    icon.style.left = `${(left - margin - width).toString()}px`;
     icon.style.display = display;
-    icon.style.zIndex = `${zIndex + zIndexOffset}`;
+    icon.style.zIndex = (zIndex + zIndexOffset).toString();
     icon.style.cssText += style;
 }
 export class SoundsInstance {
@@ -56,7 +55,7 @@ export class SoundsInstance {
                         if (this._container !== args.container) {
                             return;
                         }
-                        if (!this._container || !!this._container.muted || this._container.destroyed) {
+                        if (!!this._container.muted || this._container.destroyed) {
                             executeOnSingleOrMultiple(event.event, item => {
                                 this._engine.removeEventListener(item, cb);
                             });
@@ -67,10 +66,17 @@ export class SoundsInstance {
                         }
                         const defaultNoteIndex = 0;
                         if (event.audio) {
-                            this._playBuffer(itemFromSingleOrMultiple(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)));
                             }
@@ -80,6 +86,9 @@ export class SoundsInstance {
                         }
                         else if (event.notes) {
                             const note = itemFromArray(event.notes);
+                            if (!note) {
+                                return;
+                            }
                             await this._playNote([note], defaultNoteIndex, false);
                         }
                     })();
@@ -158,8 +167,7 @@ export class SoundsInstance {
             if (!note) {
                 return;
             }
-            const value = note.value;
-            const promises = executeOnSingleOrMultiple(value, async (_, idx) => {
+            const value = note.value, promises = executeOnSingleOrMultiple(value, async (_, idx) => {
                 return this._playNoteValue(notes, noteIdx, idx);
             });
             await (isArray(promises) ? Promise.allSettled(promises) : promises);
@@ -168,9 +176,6 @@ export class SoundsInstance {
             if (loop && nextNoteIdx >= notes.length) {
                 nextNoteIdx = nextNoteIdx % notes.length;
             }
-            if (this._container.muted) {
-                return;
-            }
             await this._playNote(notes, nextNoteIdx, loop);
         };
         this._playNoteValue = async (notes, noteIdx, valueIdx) => {
@@ -179,6 +184,9 @@ export class SoundsInstance {
                 return;
             }
             const value = itemFromSingleOrMultiple(note.value, valueIdx, true);
+            if (!value) {
+                return;
+            }
             try {
                 const freq = getNoteFrequency(value);
                 if (!isNumber(freq)) {
@@ -201,11 +209,7 @@ export class SoundsInstance {
             if (!soundsOptions) {
                 return;
             }
-            const audioContext = this._getAudioContext();
-            if (!this._audioSources) {
-                this._audioSources = [];
-            }
-            const gain = audioContext.createGain();
+            const audioContext = this._getAudioContext(), gain = audioContext.createGain();
             gain.connect(audioContext.destination);
             gain.gain.value = soundsOptions.volume.value / percentDenominator;
             this._gain = gain;
@@ -228,11 +232,11 @@ export class SoundsInstance {
         this._updateMuteStatus = async () => {
             const container = this._container, audioContext = this._getAudioContext();
             if (container.muted) {
-                await audioContext?.suspend();
+                await audioContext.suspend();
                 await this._mute();
             }
             else {
-                await audioContext?.resume();
+                await audioContext.resume();
                 this._unmute();
                 this._playMuteSound();
             }
@@ -416,9 +420,7 @@ export class SoundsInstance {
     }
     _getAudioContext() {
         const container = this._container;
-        if (!container.audioContext) {
-            container.audioContext = new AudioContext();
-        }
+        container.audioContext ??= new AudioContext();
         return container.audioContext;
     }
 }

package/esm/index.js

@@ -1,5 +1,7 @@
-import { SoundsPlugin } from "./SoundsPlugin.js";
-export async function loadSoundsPlugin(engine, refresh = true) {
-    engine.checkVersion("3.9.0");
-    await engine.addPlugin(new SoundsPlugin(engine), refresh);
+export function loadSoundsPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.0");
+    engine.register(async (e) => {
+        const { SoundsPlugin } = await import("./SoundsPlugin.js");
+        e.addPlugin(new SoundsPlugin(engine));
+    });
 }

package/esm/utils.js

@@ -17,11 +17,11 @@ export function getNoteFrequency(note) {
     if (!result?.length) {
         return;
     }
-    const noteKey = result[groupKey] || result[defaultMatchKey], noteItem = notes.get(noteKey);
+    const noteKey = result[groupKey] ?? result[defaultMatchKey], noteItem = notes.get(noteKey);
     if (!noteItem) {
         return;
     }
-    return noteItem[parseInt(result[innerGroupKey] || "0")];
+    return noteItem[parseInt(result[innerGroupKey] ?? "0")];
 }
 let muted = true;
 export const isWindowMuted = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/plugin-sounds",
-  "version": "3.9.0",
+  "version": "4.0.0-alpha.0",
   "description": "tsParticles sounds plugin",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -86,9 +86,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@tsparticles/engine": "3.9.0"
+    "@tsparticles/engine": "4.0.0-alpha.0"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "type": "module"
 }