@q9labsai/chalk-react 4.1.2 → 4.1.3

package/dist/{chunk-FTWI75A2.js → chunk-4SU35WSH.js}

@@ -9661,15 +9661,64 @@ function diffSoundCues(previous, next) {
   }
   return cues;
 }
+var AUTOPLAY_UNLOCK_EVENTS = ["pointerdown", "touchend", "click", "keydown"];
+function isAutoplayBlocked(cause) {
+  return typeof DOMException !== "undefined" && cause instanceof DOMException && cause.name === "NotAllowedError";
+}
+function supportsSinkSelection(element) {
+  return "setSinkId" in element && typeof element.setSinkId === "function";
+}
 function soundSourceFor(cue, canPlay) {
   const asset = CHALK_SOUND_ASSETS[cue];
   return canPlay(asset.opus.mimeType) ? asset.opus.url : asset.mp3.url;
 }
-function createSoundPlayer({ volume = 0.6, onError } = {}) {
+function createSoundPlayer({ volume = 0.6, outputDeviceId, onError, unlockTarget = typeof window === "undefined" ? null : window } = {}) {
   const elements = /* @__PURE__ */ new Map();
   const lastPlayed = /* @__PURE__ */ new Map();
+  const blocked = /* @__PURE__ */ new Set();
+  const playbackInFlight = /* @__PURE__ */ new Set();
   const probe = typeof Audio === "undefined" ? null : new Audio();
   const canPlay = (mimeType) => probe !== null && probe.canPlayType(mimeType) !== "";
+  let listeningForUnlock = false;
+  const removeUnlockListeners = () => {
+    if (!unlockTarget || !listeningForUnlock) return;
+    for (const event of AUTOPLAY_UNLOCK_EVENTS) unlockTarget.removeEventListener(event, retryBlocked, true);
+    listeningForUnlock = false;
+  };
+  const addUnlockListeners = () => {
+    if (!unlockTarget || listeningForUnlock) return;
+    for (const event of AUTOPLAY_UNLOCK_EVENTS) unlockTarget.addEventListener(event, retryBlocked, { capture: true, passive: true });
+    listeningForUnlock = true;
+  };
+  const reportPlaybackFailure = (cue, cause) => {
+    if (isAutoplayBlocked(cause)) {
+      blocked.add(cue);
+      addUnlockListeners();
+    }
+    onError?.(cue, cause);
+  };
+  const playElement = (cue, element) => {
+    if (playbackInFlight.has(cue)) return;
+    playbackInFlight.add(cue);
+    element.currentTime = 0;
+    element.play().then(
+      () => {
+        playbackInFlight.delete(cue);
+        blocked.delete(cue);
+        if (blocked.size === 0) removeUnlockListeners();
+      },
+      (cause) => {
+        playbackInFlight.delete(cue);
+        reportPlaybackFailure(cue, cause);
+      }
+    );
+  };
+  function retryBlocked() {
+    for (const cue of blocked) {
+      const element = elements.get(cue);
+      if (element) playElement(cue, element);
+    }
+  }
   return {
     play: (cue) => {
       if (probe === null) return;
@@ -9681,12 +9730,15 @@ function createSoundPlayer({ volume = 0.6, onError } = {}) {
         element = new Audio(soundSourceFor(cue, canPlay));
         element.preload = "auto";
         element.volume = volume;
+        if (outputDeviceId && supportsSinkSelection(element) && element.sinkId !== outputDeviceId) void element.setSinkId(outputDeviceId).catch(() => void 0);
         elements.set(cue, element);
       }
-      element.currentTime = 0;
-      element.play().catch((cause) => onError?.(cue, cause));
+      playElement(cue, element);
     },
     dispose: () => {
+      removeUnlockListeners();
+      blocked.clear();
+      playbackInFlight.clear();
       for (const element of elements.values()) {
         element.pause();
         element.removeAttribute("src");
@@ -9697,13 +9749,14 @@ function createSoundPlayer({ volume = 0.6, onError } = {}) {
 }
 
 // src/internal/useSoundCues.ts
-function useSoundCues(enabled, createPlayer = () => createSoundPlayer()) {
+function useSoundCues(enabled, createPlayer = createSoundPlayer) {
   const client = useSpaceClient();
+  const outputDeviceId = useMedia().selection.speaker ?? void 0;
   const createPlayerRef = useRef20(createPlayer);
   createPlayerRef.current = createPlayer;
   useEffect32(() => {
     if (!enabled) return;
-    const player = createPlayerRef.current();
+    const player = createPlayerRef.current({ outputDeviceId });
     let previous = client.getSnapshot();
     const unsubscribe = client.subscribe(() => {
       const next = client.getSnapshot();
@@ -9714,7 +9767,7 @@ function useSoundCues(enabled, createPlayer = () => createSoundPlayer()) {
       unsubscribe();
       player.dispose();
     };
-  }, [client, enabled]);
+  }, [client, enabled, outputDeviceId]);
 }
 
 // src/components/composite/ReactionPicker.tsx

package/dist/components/index.js

@@ -35,7 +35,7 @@ import {
   SettingsPanel,
   Stage,
   buildStageItems
-} from "../chunk-FTWI75A2.js";
+} from "../chunk-4SU35WSH.js";
 import "../chunk-ZEZLA34O.js";
 export {
   AdmissionPanel,

package/dist/index.js

@@ -35,7 +35,7 @@ import {
   useSelf,
   useSpaceClient,
   useWhiteboard
-} from "./chunk-FTWI75A2.js";
+} from "./chunk-4SU35WSH.js";
 import "./chunk-ZEZLA34O.js";
 export {
   COSMIC_CHALK_THEME,

package/dist/internal/sound-cues.d.ts

@@ -15,14 +15,18 @@ export interface SoundPlayer {
     readonly play: (cue: SoundCue) => void;
     readonly dispose: () => void;
 }
+type SoundUnlockTarget = Pick<EventTarget, "addEventListener" | "removeEventListener">;
 /** Picks the Opus file when the browser can decode it, otherwise the MP3. */
 export declare function soundSourceFor(cue: SoundCue, canPlay: (mimeType: string) => boolean): string;
 /**
  * Lazily creates one `HTMLAudioElement` per cue and replays it from the start. Playback failures
  * (autoplay policy before the first gesture, network) are reported through `onError` and never thrown.
  */
-export declare function createSoundPlayer({ volume, onError }?: {
+export declare function createSoundPlayer({ volume, outputDeviceId, onError, unlockTarget }?: {
     volume?: number;
+    outputDeviceId?: string;
     onError?: (cue: SoundCue, cause: unknown) => void;
+    unlockTarget?: SoundUnlockTarget | null;
 }): SoundPlayer;
+export {};
 //# sourceMappingURL=sound-cues.d.ts.map

package/dist/internal/sound-cues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sound-cues.d.ts","sourceRoot":"","sources":["../../src/internal/sound-cues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEvD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,iEAAgG,CAAC;AAEjI,8GAA8G;AAC9G,eAAO,MAAM,eAAe,MAAM,CAAC;AAMnC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,QAAQ,EAAE,CA2B/F;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAG5F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAY,EAAE,OAAO,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAAO,GAAG,WAAW,CA8BrJ"}
+{"version":3,"file":"sound-cues.d.ts","sourceRoot":"","sources":["../../src/internal/sound-cues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEvD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,iEAAgG,CAAC;AAEjI,8GAA8G;AAC9G,eAAO,MAAM,eAAe,MAAM,CAAC;AAMnC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,QAAQ,EAAE,CA2B/F;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AASD,KAAK,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,CAAC;AAUvF,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAG5F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAY,EAAE,cAAc,EAAE,OAAO,EAAE,YAA4D,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAO,GAAG,WAAW,CAgFrS"}

package/dist/internal/useSoundCues.d.ts

@@ -1,7 +1,9 @@
 import { type SoundPlayer } from "./sound-cues";
 /**
  * Plays the join / leave / message / hand-raise / reaction cues for snapshot changes on the
- * current client while `enabled`. Autoplay refusals before the first user gesture are ignored.
+ * current client while `enabled`. Autoplay refusals are retried after the next user gesture.
  */
-export declare function useSoundCues(enabled: boolean, createPlayer?: () => SoundPlayer): void;
+export declare function useSoundCues(enabled: boolean, createPlayer?: (options: {
+    readonly outputDeviceId?: string;
+}) => SoundPlayer): void;
 //# sourceMappingURL=useSoundCues.d.ts.map

package/dist/internal/useSoundCues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSoundCues.d.ts","sourceRoot":"","sources":["../../src/internal/useSoundCues.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAElF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,GAAE,MAAM,WAAuC,GAAG,IAAI,CAmBhH"}
+{"version":3,"file":"useSoundCues.d.ts","sourceRoot":"","sources":["../../src/internal/useSoundCues.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAElF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,GAAE,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,WAA+B,GAAG,IAAI,CAoBrJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-react",
-  "version": "4.1.2",
+  "version": "4.1.3",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -61,10 +61,10 @@
     "@base-ui/react": "^1.7.0",
     "@hugeicons/core-free-icons": "^4.2.3",
     "@hugeicons/react": "^1.1.9",
-    "@q9labsai/chalk-client": "^4.1.2",
-    "@q9labsai/chalk-ui": "^4.1.2",
-    "@q9labsai/chalk-whiteboard": "^4.1.2",
-    "@q9labsai/facehash": "^4.1.2",
+    "@q9labsai/chalk-client": "^4.1.3",
+    "@q9labsai/chalk-ui": "^4.1.3",
+    "@q9labsai/chalk-whiteboard": "^4.1.3",
+    "@q9labsai/facehash": "^4.1.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "sonner": "^2.0.8",