@joewinke/jatui 0.31.1 → 0.31.2

package/dist/sound/SoundSettings.svelte

@@ -71,7 +71,7 @@
 		const p = player ?? getSoundPlayer();
 		// A preview click is a real gesture: unlock here too, so a first-ever
 		// preview on iOS actually sounds instead of resuming a dead context.
-		void p.unlock();
+		void p.unlock?.();
 		previewing = p.play(name, { preview: true, loop: false });
 		previewTimer = setTimeout(stopPreview, PREVIEW_MAX_MS);
 	}

package/dist/sound/player.d.ts

@@ -53,15 +53,17 @@ export interface SoundPlayer {
     /**
      * Unlock audio output from inside a user-gesture handler (iOS/Safari
      * keeps a context suspended unless the gesture created/resumed it —
-     * see `sound/unlock.ts`). Backends without an unlock concept resolve
-     * immediately. A cheap no-op once unlocked.
+     * see `sound/unlock.ts`). OPTIONAL: a custom player without one is
+     * assumed fine — unlock resolves and `unlocked` reads undefined, which
+     * hosts treat as "no unlock concept". A cheap no-op once unlocked.
      */
-    unlock(): Promise<void>;
+    unlock?(): Promise<void>;
     /**
-     * True when the backend reports a running output context; a backend
-     * with no unlock concept always reports true. False before any unlock.
+     * True when the player's backend reports a running output context;
+     * false before any unlock, undefined when the player has no unlock
+     * concept.
      */
-    readonly unlocked: boolean;
+    readonly unlocked?: boolean;
     /** Decode clips ahead of time (defaults to every semantic name). */
     preload(names?: readonly SoundId[]): Promise<void>;
     stopAll(): void;

package/dist/sound/unlock.js

@@ -30,7 +30,7 @@ import { getSoundPlayer } from './player';
  * is a cheap no-op once the context is running.
  */
 export async function unlockSound() {
-    await getSoundPlayer().unlock();
+    await getSoundPlayer().unlock?.();
 }
 const GESTURES = ['pointerup', 'touchend', 'click', 'keydown'];
 /** The target `armSoundUnlock` installed its one-shot listener on, if any. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.31.1",
+  "version": "0.31.2",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",