@wvdsh/sdk-js 1.3.20 → 1.3.21

package/dist/index.d.ts

@@ -43,17 +43,24 @@ declare abstract class WavedashManager {
  *     e.g. a PIXI/GDevelop intro video), force-muting it before playback begins
  *     regardless of how it was created — the one path the DOM-based sources and
  *     the `muted` setter all miss.
+ *
+ * Speech synthesis (`window.speechSynthesis`): bypasses both Web Audio and HTML
+ * media entirely, so it gets its own shim — `speak()` forces the utterance's
+ * native volume to 0 while muted.
  */
 declare class AudioManager extends WavedashManager {
     private _isMuted;
     private contexts;
     private elements;
     private intendedMuted;
+    private intendedUtteranceVolume;
     private originalAudioContext;
     private originalWebKitAudioContext;
     private originalAudio;
     private originalMutedDescriptor;
     private originalPlay;
+    private originalSpeak;
+    private originalUtteranceVolumeDescriptor;
     private mutationObserver;
     constructor(sdk: WavedashSDK);
     isMuted(): boolean;
@@ -78,6 +85,18 @@ declare class AudioManager extends WavedashManager {
      */
     private trackElement;
     private installShims;
+    /**
+     * Shim `window.speechSynthesis` so speech respects the SDK mute state.
+     *
+     * Never swallows speak(): utterances have a lifecycle the game may sequence
+     * off (onstart/onend, synth.speaking/pending checks), so every call is
+     * delegated and silenced via volume instead. Volume is sampled at speak()
+     * time, so forcing the native value to 0 right before delegating silences
+     * anything spoken while muted; in-flight speech at the mute edge is
+     * deliberately left to finish (can't be softened mid-utterance, and
+     * cancel() would discard the pending queue).
+     */
+    private shimSpeechSynthesis;
     private shimAudioContextClass;
     destroy(): void;
 }

package/dist/index.js

@@ -124,12 +124,16 @@ var AudioManager = class extends WavedashManager {
     // HTML media elements we know about + their game-intended muted state
     this.elements = new WeakRefSet();
     this.intendedMuted = /* @__PURE__ */ new WeakMap();
+    // Speech synthesis utterances + their game-intended volume
+    this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
     // Originals (restored on destroy)
     this.originalAudioContext = null;
     this.originalWebKitAudioContext = null;
     this.originalAudio = null;
     this.originalMutedDescriptor = null;
     this.originalPlay = null;
+    this.originalSpeak = null;
+    this.originalUtteranceVolumeDescriptor = null;
     this.mutationObserver = null;
     this.handleMute = (data) => {
       if (this._isMuted === data.isMuted) return;
@@ -275,6 +279,66 @@ var AudioManager = class extends WavedashManager {
         return originalPlay.call(this);
       };
     })(this);
+    this.shimSpeechSynthesis();
+  }
+  /**
+   * Shim `window.speechSynthesis` so speech respects the SDK mute state.
+   *
+   * Never swallows speak(): utterances have a lifecycle the game may sequence
+   * off (onstart/onend, synth.speaking/pending checks), so every call is
+   * delegated and silenced via volume instead. Volume is sampled at speak()
+   * time, so forcing the native value to 0 right before delegating silences
+   * anything spoken while muted; in-flight speech at the mute edge is
+   * deliberately left to finish (can't be softened mid-utterance, and
+   * cancel() would discard the pending queue).
+   */
+  shimSpeechSynthesis() {
+    if (!window.speechSynthesis || typeof SpeechSynthesisUtterance === "undefined") {
+      return;
+    }
+    this.originalUtteranceVolumeDescriptor = Object.getOwnPropertyDescriptor(
+      SpeechSynthesisUtterance.prototype,
+      "volume"
+    ) ?? null;
+    const volDesc = this.originalUtteranceVolumeDescriptor;
+    if (volDesc?.get && volDesc?.set) {
+      ((manager) => {
+        Object.defineProperty(SpeechSynthesisUtterance.prototype, "volume", {
+          configurable: true,
+          get() {
+            const intended = manager.intendedUtteranceVolume.get(this);
+            return intended !== void 0 ? intended : volDesc.get.call(this);
+          },
+          set(value) {
+            manager.intendedUtteranceVolume.set(this, value);
+            volDesc.set.call(this, value);
+          }
+        });
+      })(this);
+    }
+    const speechSynthesis = window.speechSynthesis;
+    const originalSpeak = speechSynthesis.speak;
+    this.originalSpeak = originalSpeak;
+    ((manager) => {
+      speechSynthesis.speak = function(utterance) {
+        if (manager._isMuted) {
+          if (!manager.intendedUtteranceVolume.has(utterance)) {
+            const current = volDesc?.get ? volDesc.get.call(utterance) : utterance.volume;
+            manager.intendedUtteranceVolume.set(utterance, current);
+          }
+          if (volDesc?.set) volDesc.set.call(utterance, 0);
+          else utterance.volume = 0;
+        } else {
+          const intended = manager.intendedUtteranceVolume.get(utterance);
+          if (intended !== void 0) {
+            if (volDesc?.set) volDesc.set.call(utterance, intended);
+            else utterance.volume = intended;
+            manager.intendedUtteranceVolume.delete(utterance);
+          }
+        }
+        return originalSpeak.call(speechSynthesis, utterance);
+      };
+    })(this);
   }
   shimAudioContextClass(Original) {
     return /* @__PURE__ */ ((manager) => class extends Original {
@@ -320,6 +384,16 @@ var AudioManager = class extends WavedashManager {
       if (this.originalAudio) {
         window.Audio = this.originalAudio;
       }
+      if (this.originalSpeak && window.speechSynthesis) {
+        window.speechSynthesis.speak = this.originalSpeak;
+      }
+    }
+    if (this.originalUtteranceVolumeDescriptor && typeof SpeechSynthesisUtterance !== "undefined") {
+      Object.defineProperty(
+        SpeechSynthesisUtterance.prototype,
+        "volume",
+        this.originalUtteranceVolumeDescriptor
+      );
     }
     if (this.originalPlay) {
       HTMLMediaElement.prototype.play = this.originalPlay;
@@ -334,6 +408,7 @@ var AudioManager = class extends WavedashManager {
     this.contexts.clear();
     this.elements.clear();
     this.intendedMuted = /* @__PURE__ */ new WeakMap();
+    this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
     super.destroy();
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wvdsh/sdk-js",
-  "version": "1.3.20",
+  "version": "1.3.21",
   "type": "module",
   "description": "Wavedash JavaScript SDK",
   "main": "./dist/client.js",