@adea-ai/audio 0.78.0 → 0.79.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { AUDIO_BASE_URL, MUSIC_FILES, type MusicId } from './config';
 export { SoundController, soundController, type MusicOptions } from './controller';
 export { musicForScene, sceneMusicTracks } from './scene-music';
-export { MusicToggle, SoundProvider, useSceneMusic, useSound, type SoundContextValue, } from './sound';
+export { MusicToggle, SoundProvider, useOptionalSound, useSceneMusic, useSound, type SoundContextValue, } from './sound';

package/dist/index.js

@@ -1,5 +1,5 @@
 import { AUDIO_BASE_URL, MUSIC_FILES } from "./config.js";
 import { SoundController, soundController } from "./controller.js";
 import { musicForScene, sceneMusicTracks } from "./scene-music.js";
-import { MusicToggle, SoundProvider, useSceneMusic, useSound } from "./sound.js";
-export { AUDIO_BASE_URL, MUSIC_FILES, MusicToggle, SoundController, SoundProvider, musicForScene, sceneMusicTracks, soundController, useSceneMusic, useSound };
+import { MusicToggle, SoundProvider, useOptionalSound, useSceneMusic, useSound } from "./sound.js";
+export { AUDIO_BASE_URL, MUSIC_FILES, MusicToggle, SoundController, SoundProvider, musicForScene, sceneMusicTracks, soundController, useOptionalSound, useSceneMusic, useSound };

package/dist/sound.d.ts

@@ -10,5 +10,14 @@ export type SoundContextValue = {
 };
 export declare function SoundProvider(props: ParentProps): import("solid-js").JSX.Element;
 export declare function useSound(): SoundContextValue;
+/**
+ * The sound context when one exists, `null` otherwise. Hosts that render
+ * shared components outside a `<SoundProvider>` (tests, alternate shells, a
+ * dialog tree mounted before the app providers) read this instead of letting
+ * `useSound`'s guard throw during render and tear down the whole host tree —
+ * the settings dialog's soundtrack row white-screened the app that way when
+ * the "Input & notifications" section mounted `<MusicToggle />` unprovided.
+ */
+export declare function useOptionalSound(): SoundContextValue | null;
 export declare function useSceneMusic(sceneId: string | null | undefined): void;
 export declare function MusicToggle(): import("solid-js").JSX.Element;

package/dist/sound.js

@@ -51,6 +51,17 @@ function useSound() {
 	if (!value) throw new Error("useSound must be used within <SoundProvider>");
 	return value;
 }
+/**
+* The sound context when one exists, `null` otherwise. Hosts that render
+* shared components outside a `<SoundProvider>` (tests, alternate shells, a
+* dialog tree mounted before the app providers) read this instead of letting
+* `useSound`'s guard throw during render and tear down the whole host tree —
+* the settings dialog's soundtrack row white-screened the app that way when
+* the "Input & notifications" section mounted `<MusicToggle />` unprovided.
+*/
+function useOptionalSound() {
+	return useContext(SoundContext);
+}
 function useSceneMusic(sceneId) {
 	createEffect(on(() => sceneId, (scene) => {
 		const timeout = window.setTimeout(() => {
@@ -88,11 +99,22 @@ function MusicButton(props) {
 	});
 }
 function MusicToggle() {
-	const { musicMuted, toggleMusicMute } = useSound();
+	const context = useOptionalSound();
+	if (context) return createComponent(MusicButton, {
+		get muted() {
+			return context.musicMuted;
+		},
+		get onToggle() {
+			return context.toggleMusicMute;
+		}
+	});
+	const [unprovidedMuted, setUnprovidedMuted] = createSignal(soundController.musicMuted);
 	return createComponent(MusicButton, {
-		muted: musicMuted,
-		onToggle: toggleMusicMute
+		get muted() {
+			return unprovidedMuted();
+		},
+		onToggle: () => setUnprovidedMuted(soundController.toggleMusicMute())
 	});
 }
 //#endregion
-export { MusicToggle, SoundProvider, useSceneMusic, useSound };
+export { MusicToggle, SoundProvider, useOptionalSound, useSceneMusic, useSound };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/audio",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "Optional, lazy music controller and Solid bindings for Adea. Audio is non-blocking so scene loading never waits on sound assets.",
   "keywords": [
     "audio",

package/src/index.ts

@@ -6,6 +6,7 @@ export { musicForScene, sceneMusicTracks } from './scene-music'
 export {
   MusicToggle,
   SoundProvider,
+  useOptionalSound,
   useSceneMusic,
   useSound,
   type SoundContextValue,

package/src/sound.tsx

@@ -72,6 +72,18 @@ export function useSound(): SoundContextValue {
   return value
 }
 
+/**
+ * The sound context when one exists, `null` otherwise. Hosts that render
+ * shared components outside a `<SoundProvider>` (tests, alternate shells, a
+ * dialog tree mounted before the app providers) read this instead of letting
+ * `useSound`'s guard throw during render and tear down the whole host tree —
+ * the settings dialog's soundtrack row white-screened the app that way when
+ * the "Input & notifications" section mounted `<MusicToggle />` unprovided.
+ */
+export function useOptionalSound(): SoundContextValue | null {
+  return useContext(SoundContext)
+}
+
 export function useSceneMusic(sceneId: string | null | undefined): void {
   createEffect(
     on(
@@ -107,6 +119,18 @@ function MusicButton(props: { muted: boolean; onToggle: () => void }) {
 }
 
 export function MusicToggle() {
-  const { musicMuted, toggleMusicMute } = useSound()
-  return <MusicButton muted={musicMuted} onToggle={toggleMusicMute} />
+  const context = useOptionalSound()
+  if (context) {
+    return <MusicButton muted={context.musicMuted} onToggle={context.toggleMusicMute} />
+  }
+  // No provider: drive the singleton controller directly so the control stays
+  // honest and operable instead of throwing during render. The mute state
+  // lives on the controller, so the button only needs to mirror it.
+  const [unprovidedMuted, setUnprovidedMuted] = createSignal(soundController.musicMuted)
+  return (
+    <MusicButton
+      muted={unprovidedMuted()}
+      onToggle={() => setUnprovidedMuted(soundController.toggleMusicMute())}
+    />
+  )
 }