@react-text-game/core 0.4.0 → 0.5.0

package/dist/audio/constants.js

@@ -0,0 +1,20 @@
+import { STORAGE_SYSTEM_PATH } from "../constants";
+/**
+ * Base JSONPath for audio storage within the system path.
+ *
+ * All audio tracks with IDs will be stored under this path.
+ * Individual tracks are stored at: $._system.audio.{id}
+ */
+export const AUDIO_STORAGE_PATH = `${STORAGE_SYSTEM_PATH}.audio`;
+/**
+ * Default audio configuration values.
+ */
+export const DEFAULT_AUDIO_OPTIONS = {
+    volume: 1.0,
+    loop: false,
+    playbackRate: 1.0,
+    muted: false,
+    autoPlay: false,
+    preload: "metadata",
+};
+//# sourceMappingURL=constants.js.map

package/dist/audio/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/audio/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,mBAAmB,QAAoC,CAAC;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,KAAK;IACX,YAAY,EAAE,GAAG;IACjB,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,UAAmB;CACtB,CAAC"}

package/dist/audio/fabric.d.ts

@@ -0,0 +1,35 @@
+import { AudioTrack } from "./audioTrack";
+import type { AudioOptions } from "./types";
+/**
+ * Factory function to create a new audio track.
+ *
+ * Follows the project's factory-first pattern similar to createEntity() and newStory().
+ * Creates an AudioTrack instance with reactive state management and automatic
+ * registration with the AudioManager.
+ *
+ * @param src - Path to the audio file (relative or absolute URL)
+ * @param options - Optional audio configuration
+ * @returns A reactive AudioTrack instance
+ *
+ * @example
+ * ```typescript
+ * // Create background music with auto-save
+ * const bgMusic = createAudio('assets/music/theme.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ *   volume: 0.5,
+ * });
+ *
+ * await bgMusic.play();
+ * bgMusic.setVolume(0.7);
+ *
+ * // Create sound effect (no ID = no auto-save)
+ * const clickSound = createAudio('assets/sfx/click.mp3', {
+ *   volume: 0.8,
+ * });
+ *
+ * clickSound.play();
+ * ```
+ */
+export declare const createAudio: (src: string, options?: AudioOptions) => AudioTrack;
+//# sourceMappingURL=fabric.d.ts.map

package/dist/audio/fabric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fabric.d.ts","sourceRoot":"","sources":["../../src/audio/fabric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,WAAW,GACpB,KAAK,MAAM,EACX,UAAU,YAAY,KACvB,UAEF,CAAC"}

package/dist/audio/fabric.js

@@ -0,0 +1,36 @@
+import { AudioTrack } from "./audioTrack";
+/**
+ * Factory function to create a new audio track.
+ *
+ * Follows the project's factory-first pattern similar to createEntity() and newStory().
+ * Creates an AudioTrack instance with reactive state management and automatic
+ * registration with the AudioManager.
+ *
+ * @param src - Path to the audio file (relative or absolute URL)
+ * @param options - Optional audio configuration
+ * @returns A reactive AudioTrack instance
+ *
+ * @example
+ * ```typescript
+ * // Create background music with auto-save
+ * const bgMusic = createAudio('assets/music/theme.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ *   volume: 0.5,
+ * });
+ *
+ * await bgMusic.play();
+ * bgMusic.setVolume(0.7);
+ *
+ * // Create sound effect (no ID = no auto-save)
+ * const clickSound = createAudio('assets/sfx/click.mp3', {
+ *   volume: 0.8,
+ * });
+ *
+ * clickSound.play();
+ * ```
+ */
+export const createAudio = (src, options) => {
+    return new AudioTrack(src, options);
+};
+//# sourceMappingURL=fabric.js.map

package/dist/audio/fabric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fabric.js","sourceRoot":"","sources":["../../src/audio/fabric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACvB,GAAW,EACX,OAAsB,EACZ,EAAE;IACZ,OAAO,IAAI,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC,CAAC"}

package/dist/audio/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Audio module for the react-text-game engine.
+ *
+ * Provides comprehensive audio support with reactive state management,
+ * automatic persistence, and global controls.
+ *
+ * @example
+ * ```typescript
+ * import { createAudio, AudioManager } from '@react-text-game/core/audio';
+ *
+ * // Create and control audio tracks
+ * const music = createAudio('music.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ *   volume: 0.7,
+ * });
+ *
+ * await music.play();
+ * music.pause();
+ * music.setVolume(0.5);
+ *
+ * // Global controls
+ * AudioManager.setMasterVolume(0.8);
+ * AudioManager.muteAll();
+ * ```
+ *
+ * @module audio
+ */
+export { AudioManager, AudioTrack } from "./audioTrack";
+export { AUDIO_STORAGE_PATH, DEFAULT_AUDIO_OPTIONS } from "./constants";
+export { createAudio } from "./fabric";
+export type { AudioOptions, AudioSaveState, AudioState, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EACR,YAAY,EACZ,cAAc,EACd,UAAU,GACb,MAAM,SAAS,CAAC"}

package/dist/audio/index.js

@@ -0,0 +1,32 @@
+/**
+ * Audio module for the react-text-game engine.
+ *
+ * Provides comprehensive audio support with reactive state management,
+ * automatic persistence, and global controls.
+ *
+ * @example
+ * ```typescript
+ * import { createAudio, AudioManager } from '@react-text-game/core/audio';
+ *
+ * // Create and control audio tracks
+ * const music = createAudio('music.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ *   volume: 0.7,
+ * });
+ *
+ * await music.play();
+ * music.pause();
+ * music.setVolume(0.5);
+ *
+ * // Global controls
+ * AudioManager.setMasterVolume(0.8);
+ * AudioManager.muteAll();
+ * ```
+ *
+ * @module audio
+ */
+export { AudioManager, AudioTrack } from "./audioTrack";
+export { AUDIO_STORAGE_PATH, DEFAULT_AUDIO_OPTIONS } from "./constants";
+export { createAudio } from "./fabric";
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/audio/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Configuration options for creating an audio track.
+ *
+ * @example
+ * ```typescript
+ * const audio = createAudio('music.mp3', {
+ *   id: 'bg-music',
+ *   volume: 0.7,
+ *   loop: true,
+ *   autoPlay: false,
+ * });
+ * ```
+ */
+export interface AudioOptions {
+    /**
+     * Unique identifier for the audio track.
+     * Required for save/load functionality.
+     * If not provided, a random ID will be generated.
+     */
+    id?: string;
+    /**
+     * Initial volume level (0.0 to 1.0).
+     * @default 1.0
+     */
+    volume?: number;
+    /**
+     * Whether to loop the audio automatically.
+     * @default false
+     */
+    loop?: boolean;
+    /**
+     * Playback rate multiplier (0.5 = half speed, 2.0 = double speed).
+     * @default 1.0
+     */
+    playbackRate?: number;
+    /**
+     * Whether to start muted.
+     * @default false
+     */
+    muted?: boolean;
+    /**
+     * Auto-play on creation.
+     * Note: May be blocked by browser autoplay policies.
+     * @default false
+     */
+    autoPlay?: boolean;
+    /**
+     * Preload strategy for the audio file.
+     * - 'none': Don't preload
+     * - 'metadata': Preload only metadata
+     * - 'auto': Let browser decide
+     * @default 'metadata'
+     */
+    preload?: "none" | "metadata" | "auto";
+}
+/**
+ * Reactive state of an audio track.
+ *
+ * This interface represents the observable state that can be used
+ * with React hooks for reactive updates.
+ *
+ * @example
+ * ```typescript
+ * const state = audio.getState();
+ * console.log(state.isPlaying); // true/false
+ * console.log(state.currentTime); // 45.2
+ * ```
+ */
+export interface AudioState {
+    /** Whether audio is currently playing */
+    isPlaying: boolean;
+    /** Whether audio is paused */
+    isPaused: boolean;
+    /** Whether audio is stopped */
+    isStopped: boolean;
+    /** Current playback position in seconds */
+    currentTime: number;
+    /** Total duration in seconds */
+    duration: number;
+    /** Current volume (0.0 to 1.0) */
+    volume: number;
+    /** Whether audio is looping */
+    loop: boolean;
+    /** Current playback rate multiplier */
+    playbackRate: number;
+    /** Whether audio is muted */
+    muted: boolean;
+}
+/**
+ * Saved state for audio track persistence.
+ *
+ * This is a subset of AudioState that gets persisted to storage.
+ */
+export interface AudioSaveState {
+    id: string;
+    src: string;
+    volume: number;
+    loop: boolean;
+    playbackRate: number;
+    muted: boolean;
+    currentTime: number;
+    isPlaying: boolean;
+    isPaused: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/audio/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audio/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACvB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IAEnB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IAEnB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,IAAI,EAAE,OAAO,CAAC;IAEd,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACrB"}

package/dist/audio/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/audio/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audio/types.ts"],"names":[],"mappings":""}

package/dist/hooks/index.d.ts

@@ -1,3 +1,5 @@
+export * from './useAudio';
+export * from './useAudioManager';
 export * from './useCurrentPassage';
 export * from './useGameEntity';
 export * from './useGameIsStarted';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -1,3 +1,5 @@
+export * from './useAudio';
+export * from './useAudioManager';
 export * from './useCurrentPassage';
 export * from './useGameEntity';
 export * from './useGameIsStarted';

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/hooks/useAudio.d.ts

@@ -0,0 +1,50 @@
+import type { AudioTrack } from "../audio";
+/**
+ * React hook to access reactive audio state.
+ *
+ * This hook makes audio state observable in React components, automatically
+ * triggering re-renders when the audio state changes (playback position,
+ * volume, playing status, etc.).
+ *
+ * @param audio - The audio track to observe
+ * @returns Reactive audio state snapshot
+ *
+ * @example
+ * ```typescript
+ * import { createAudio } from '@react-text-game/core/audio';
+ * import { useAudio } from '@react-text-game/core';
+ *
+ * const bgMusic = createAudio('music.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ * });
+ *
+ * function MusicPlayer() {
+ *   const audioState = useAudio(bgMusic);
+ *
+ *   return (
+ *     <div>
+ *       <p>Playing: {audioState.isPlaying ? 'Yes' : 'No'}</p>
+ *       <p>Time: {audioState.currentTime.toFixed(1)}s / {audioState.duration.toFixed(1)}s</p>
+ *       <p>Volume: {(audioState.volume * 100).toFixed(0)}%</p>
+ *
+ *       <button onClick={() => bgMusic.play()}>Play</button>
+ *       <button onClick={() => bgMusic.pause()}>Pause</button>
+ *       <button onClick={() => bgMusic.stop()}>Stop</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useAudio: (audio: AudioTrack) => {
+    readonly isPlaying: boolean;
+    readonly isPaused: boolean;
+    readonly isStopped: boolean;
+    readonly currentTime: number;
+    readonly duration: number;
+    readonly volume: number;
+    readonly loop: boolean;
+    readonly playbackRate: number;
+    readonly muted: boolean;
+};
+//# sourceMappingURL=useAudio.d.ts.map

package/dist/hooks/useAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudio.d.ts","sourceRoot":"","sources":["../../src/hooks/useAudio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,UAAU;;;;;;;;;;CAEzC,CAAC"}

package/dist/hooks/useAudio.js

@@ -0,0 +1,42 @@
+import { useSnapshot } from "valtio";
+/**
+ * React hook to access reactive audio state.
+ *
+ * This hook makes audio state observable in React components, automatically
+ * triggering re-renders when the audio state changes (playback position,
+ * volume, playing status, etc.).
+ *
+ * @param audio - The audio track to observe
+ * @returns Reactive audio state snapshot
+ *
+ * @example
+ * ```typescript
+ * import { createAudio } from '@react-text-game/core/audio';
+ * import { useAudio } from '@react-text-game/core';
+ *
+ * const bgMusic = createAudio('music.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ * });
+ *
+ * function MusicPlayer() {
+ *   const audioState = useAudio(bgMusic);
+ *
+ *   return (
+ *     <div>
+ *       <p>Playing: {audioState.isPlaying ? 'Yes' : 'No'}</p>
+ *       <p>Time: {audioState.currentTime.toFixed(1)}s / {audioState.duration.toFixed(1)}s</p>
+ *       <p>Volume: {(audioState.volume * 100).toFixed(0)}%</p>
+ *
+ *       <button onClick={() => bgMusic.play()}>Play</button>
+ *       <button onClick={() => bgMusic.pause()}>Pause</button>
+ *       <button onClick={() => bgMusic.stop()}>Stop</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useAudio = (audio) => {
+    return useSnapshot(audio.getState());
+};
+//# sourceMappingURL=useAudio.js.map

package/dist/hooks/useAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudio.js","sourceRoot":"","sources":["../../src/hooks/useAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAE,EAAE;IAC1C,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/dist/hooks/useAudioManager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * React hook to access global audio manager state and controls.
+ *
+ * This hook provides access to the AudioManager's reactive state
+ * (master volume, mute status) and bound control methods.
+ *
+ * @returns Reactive audio manager state and control methods
+ *
+ * @example
+ * ```typescript
+ * import { useAudioManager } from '@react-text-game/core';
+ *
+ * function AudioSettingsMenu() {
+ *   const audioManager = useAudioManager();
+ *
+ *   return (
+ *     <div>
+ *       <h2>Audio Settings</h2>
+ *
+ *       <label>
+ *         Master Volume: {(audioManager.masterVolume * 100).toFixed(0)}%
+ *         <input
+ *           type="range"
+ *           min="0"
+ *           max="1"
+ *           step="0.01"
+ *           value={audioManager.masterVolume}
+ *           onChange={(e) => audioManager.setMasterVolume(parseFloat(e.target.value))}
+ *         />
+ *       </label>
+ *
+ *       <button onClick={audioManager.muteAll}>
+ *         Mute All
+ *       </button>
+ *       <button onClick={audioManager.unmuteAll}>
+ *         Unmute All
+ *       </button>
+ *       <button onClick={audioManager.pauseAll}>
+ *         Pause All
+ *       </button>
+ *       <button onClick={audioManager.resumeAll}>
+ *         Resume All
+ *       </button>
+ *
+ *       <p>Muted: {audioManager.isMuted ? 'Yes' : 'No'}</p>
+ *       <p>Total Tracks: {audioManager.getAllTracks().length}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useAudioManager: () => {
+    setMasterVolume: (volume: number) => void;
+    getMasterVolume: () => number;
+    muteAll: () => void;
+    unmuteAll: () => void;
+    pauseAll: () => void;
+    resumeAll: () => void;
+    stopAll: () => void;
+    getAllTracks: () => Array<import("../audio").AudioTrack>;
+    getTrackById: (id: string) => import("../audio").AudioTrack | undefined;
+    disposeAll: () => void;
+    masterVolume: number;
+    isMuted: boolean;
+};
+//# sourceMappingURL=useAudioManager.d.ts.map

package/dist/hooks/useAudioManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudioManager.d.ts","sourceRoot":"","sources":["../../src/hooks/useAudioManager.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAgB3B,CAAC"}

package/dist/hooks/useAudioManager.js

@@ -0,0 +1,70 @@
+import { useSnapshot } from "valtio";
+import { AudioManager } from "../audio";
+/**
+ * React hook to access global audio manager state and controls.
+ *
+ * This hook provides access to the AudioManager's reactive state
+ * (master volume, mute status) and bound control methods.
+ *
+ * @returns Reactive audio manager state and control methods
+ *
+ * @example
+ * ```typescript
+ * import { useAudioManager } from '@react-text-game/core';
+ *
+ * function AudioSettingsMenu() {
+ *   const audioManager = useAudioManager();
+ *
+ *   return (
+ *     <div>
+ *       <h2>Audio Settings</h2>
+ *
+ *       <label>
+ *         Master Volume: {(audioManager.masterVolume * 100).toFixed(0)}%
+ *         <input
+ *           type="range"
+ *           min="0"
+ *           max="1"
+ *           step="0.01"
+ *           value={audioManager.masterVolume}
+ *           onChange={(e) => audioManager.setMasterVolume(parseFloat(e.target.value))}
+ *         />
+ *       </label>
+ *
+ *       <button onClick={audioManager.muteAll}>
+ *         Mute All
+ *       </button>
+ *       <button onClick={audioManager.unmuteAll}>
+ *         Unmute All
+ *       </button>
+ *       <button onClick={audioManager.pauseAll}>
+ *         Pause All
+ *       </button>
+ *       <button onClick={audioManager.resumeAll}>
+ *         Resume All
+ *       </button>
+ *
+ *       <p>Muted: {audioManager.isMuted ? 'Yes' : 'No'}</p>
+ *       <p>Total Tracks: {audioManager.getAllTracks().length}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useAudioManager = () => {
+    const state = useSnapshot(AudioManager.getState());
+    return {
+        ...state,
+        setMasterVolume: AudioManager.setMasterVolume.bind(AudioManager),
+        getMasterVolume: AudioManager.getMasterVolume.bind(AudioManager),
+        muteAll: AudioManager.muteAll.bind(AudioManager),
+        unmuteAll: AudioManager.unmuteAll.bind(AudioManager),
+        pauseAll: AudioManager.pauseAll.bind(AudioManager),
+        resumeAll: AudioManager.resumeAll.bind(AudioManager),
+        stopAll: AudioManager.stopAll.bind(AudioManager),
+        getAllTracks: AudioManager.getAllTracks.bind(AudioManager),
+        getTrackById: AudioManager.getTrackById.bind(AudioManager),
+        disposeAll: AudioManager.disposeAll.bind(AudioManager),
+    };
+};
+//# sourceMappingURL=useAudioManager.js.map

package/dist/hooks/useAudioManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAudioManager.js","sourceRoot":"","sources":["../../src/hooks/useAudioManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEnD,OAAO;QACH,GAAG,KAAK;QACR,eAAe,EAAE,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;QAChE,eAAe,EAAE,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;QAChE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAChD,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;QACpD,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;QAClD,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;QACpD,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAChD,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC1D,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;QAC1D,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;KACzD,CAAC;AACN,CAAC,CAAC"}

package/dist/i18n/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/i18n/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CACzC,CASA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAW,MAAmB,mDAGhE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/i18n/utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CACzC,CAeA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAW,MAAmB,mDAGhE,CAAC"}

package/dist/i18n/utils.js

@@ -22,6 +22,12 @@ import i18next from "i18next";
  */
 export async function loadUITranslations() {
     try {
+        // UI package is a peer dependency and may not be installed.
+        // This dynamic import will fail gracefully at runtime if UI package is not available.
+        // Using @ts-ignore instead of @ts-expect-error because the error may or may not exist
+        // depending on whether the UI package is built/installed.
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
         const { uiTranslations } = await import("@react-text-game/ui/i18n");
         return uiTranslations;
         // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/dist/i18n/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/i18n/utils.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IAGpC,IAAI,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACpE,OAAO,cAAc,CAAC;QACtB,6DAA6D;IACjE,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACV,0EAA0E;QAC1E,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAoB,UAAU,EAAE,EAAE;IACjE,+DAA+D;IAC/D,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/i18n/utils.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IAGpC,IAAI,CAAC;QACD,4DAA4D;QAC5D,sFAAsF;QACtF,sFAAsF;QACtF,0DAA0D;QAC1D,6DAA6D;QAC7D,aAAa;QACb,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACpE,OAAO,cAAc,CAAC;QACtB,6DAA6D;IACjE,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACV,0EAA0E;QAC1E,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAoB,UAAU,EAAE,EAAE;IACjE,+DAA+D;IAC/D,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/tests/audio.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audio.test.d.ts.map

package/dist/tests/audio.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.test.d.ts","sourceRoot":"","sources":["../../src/tests/audio.test.ts"],"names":[],"mappings":""}