@react-text-game/core 0.4.1 → 0.5.1

package/dist/audio/audioTrack.js

@@ -0,0 +1,656 @@
+import { proxy, subscribe } from "valtio";
+import { logger } from "../logger";
+import { Storage } from "../storage";
+import { AUDIO_STORAGE_PATH, DEFAULT_AUDIO_OPTIONS } from "./constants";
+/**
+ * Individual audio track with reactive state management.
+ *
+ * AudioTrack wraps the HTMLAudioElement API with Valtio reactive state,
+ * making it easy to integrate with React components and the game's save system.
+ *
+ * Features:
+ * - Reactive state updates via Valtio
+ * - Automatic persistence with save/load
+ * - Volume, loop, and playback rate controls
+ * - Fade in/out effects
+ * - Event-driven state synchronization
+ *
+ * @example
+ * ```typescript
+ * const music = new AudioTrack('assets/music.mp3', {
+ *   id: 'bg-music',
+ *   loop: true,
+ *   volume: 0.7,
+ * });
+ *
+ * await music.play();
+ * music.setVolume(0.5);
+ * ```
+ */
+export class AudioTrack {
+    id;
+    src;
+    audioElement;
+    state;
+    jsonPath;
+    unsubscribe;
+    constructor(src, options = {}) {
+        this.id = options.id || `audio-${Date.now()}-${Math.random()}`;
+        this.src = src;
+        this.jsonPath = `${AUDIO_STORAGE_PATH}.${this.id}`;
+        // Create reactive state with Valtio
+        this.state = proxy({
+            isPlaying: false,
+            isPaused: false,
+            isStopped: true,
+            currentTime: 0,
+            duration: 0,
+            volume: options.volume ?? DEFAULT_AUDIO_OPTIONS.volume,
+            loop: options.loop ?? DEFAULT_AUDIO_OPTIONS.loop,
+            playbackRate: options.playbackRate ?? DEFAULT_AUDIO_OPTIONS.playbackRate,
+            muted: options.muted ?? DEFAULT_AUDIO_OPTIONS.muted,
+        });
+        // Create audio element
+        this.audioElement = new Audio(src);
+        this.audioElement.loop = this.state.loop;
+        this.audioElement.playbackRate = this.state.playbackRate;
+        this.audioElement.muted = this.state.muted;
+        this.audioElement.preload =
+            options.preload ?? DEFAULT_AUDIO_OPTIONS.preload;
+        // Attach event listeners
+        this.attachEventListeners();
+        // Register with AudioManager
+        AudioManager._registerTrack(this);
+        // Apply effective volume (considering master volume)
+        // Must be called after registration since it needs AudioManager
+        this._applyEffectiveVolume();
+        // Setup auto-save subscription if ID provided
+        if (options.id) {
+            // Subscribe to state changes for auto-save
+            // Audio will be saved whenever state changes, matching the pattern
+            // of other game objects that persist their state
+            //
+            // Note: Initial state is not auto-saved here to avoid overwriting
+            // existing saved states during load operations. Call save() manually
+            // or trigger a state change to persist the initial state.
+            this.unsubscribe = subscribe(this.state, () => {
+                this.save();
+            });
+        }
+        // Auto-play if requested (may be blocked by browser)
+        if (options.autoPlay) {
+            this.play().catch((error) => {
+                logger.warn(`Auto-play blocked for "${this.id}". User interaction required.`, error);
+            });
+        }
+        logger.log(`Audio track created: ${this.id} (${src})`);
+    }
+    /**
+     * Attaches event listeners to sync HTMLAudioElement state with reactive state.
+     * @private
+     */
+    attachEventListeners() {
+        this.audioElement.addEventListener("loadedmetadata", () => {
+            this.state.duration = this.audioElement.duration;
+        });
+        this.audioElement.addEventListener("timeupdate", () => {
+            this.state.currentTime = this.audioElement.currentTime;
+        });
+        this.audioElement.addEventListener("play", () => {
+            this.state.isPlaying = true;
+            this.state.isPaused = false;
+            this.state.isStopped = false;
+        });
+        this.audioElement.addEventListener("pause", () => {
+            this.state.isPlaying = false;
+            this.state.isPaused = true;
+        });
+        this.audioElement.addEventListener("ended", () => {
+            if (!this.state.loop) {
+                this.state.isPlaying = false;
+                this.state.isStopped = true;
+                this.state.isPaused = false;
+                this.state.currentTime = 0;
+            }
+        });
+        this.audioElement.addEventListener("volumechange", () => {
+            // Only sync muted state, not volume
+            // Volume state is managed separately to support master volume
+            this.state.muted = this.audioElement.muted;
+        });
+        this.audioElement.addEventListener("ratechange", () => {
+            this.state.playbackRate = this.audioElement.playbackRate;
+        });
+    }
+    /**
+     * Plays the audio track.
+     *
+     * @returns Promise that resolves when playback starts
+     * @throws Error if playback fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await audio.play();
+     * } catch (error) {
+     *   console.error('Playback failed:', error);
+     * }
+     * ```
+     */
+    async play() {
+        try {
+            await this.audioElement.play();
+        }
+        catch (error) {
+            logger.error(`Failed to play audio: ${this.src}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Pauses the audio track.
+     *
+     * @example
+     * ```typescript
+     * audio.pause();
+     * ```
+     */
+    pause() {
+        this.audioElement.pause();
+    }
+    /**
+     * Resumes playback if the audio is paused.
+     *
+     * @example
+     * ```typescript
+     * audio.resume();
+     * ```
+     */
+    resume() {
+        if (this.state.isPaused) {
+            this.play().catch((error) => {
+                logger.error(`Failed to resume audio: ${this.src}`, error);
+            });
+        }
+    }
+    /**
+     * Stops the audio track and resets to the beginning.
+     *
+     * @example
+     * ```typescript
+     * audio.stop();
+     * ```
+     */
+    stop() {
+        this.audioElement.pause();
+        this.audioElement.currentTime = 0;
+        this.state.isPlaying = false;
+        this.state.isPaused = false;
+        this.state.isStopped = true;
+    }
+    /**
+     * Sets the volume level.
+     *
+     * @param volume - Volume level (0.0 to 1.0), clamped to valid range
+     *
+     * @example
+     * ```typescript
+     * audio.setVolume(0.5); // 50% volume
+     * ```
+     */
+    setVolume(volume) {
+        const clampedVolume = Math.max(0, Math.min(1, volume));
+        this.state.volume = clampedVolume;
+        this._applyEffectiveVolume();
+    }
+    /**
+     * Applies the effective volume (track volume * master volume) to the audio element.
+     * Internal method used by AudioManager to apply master volume changes.
+     *
+     * @internal
+     */
+    _applyEffectiveVolume() {
+        const masterVolume = AudioManager.getMasterVolume();
+        const effectiveVolume = this.state.volume * masterVolume;
+        this.audioElement.volume = effectiveVolume;
+    }
+    /**
+     * Sets whether the audio should loop.
+     *
+     * @param loop - True to enable looping, false to disable
+     *
+     * @example
+     * ```typescript
+     * audio.setLoop(true);
+     * ```
+     */
+    setLoop(loop) {
+        this.audioElement.loop = loop;
+        this.state.loop = loop;
+    }
+    /**
+     * Sets the playback rate.
+     *
+     * @param rate - Playback rate multiplier (0.5 = half speed, 2.0 = double speed)
+     *
+     * @example
+     * ```typescript
+     * audio.setPlaybackRate(1.5); // 1.5x speed
+     * ```
+     */
+    setPlaybackRate(rate) {
+        this.audioElement.playbackRate = rate;
+        this.state.playbackRate = rate;
+    }
+    /**
+     * Sets whether the audio is muted.
+     *
+     * @param muted - True to mute, false to unmute
+     *
+     * @example
+     * ```typescript
+     * audio.setMuted(true);
+     * ```
+     */
+    setMuted(muted) {
+        this.audioElement.muted = muted;
+        this.state.muted = muted;
+    }
+    /**
+     * Seeks to a specific time in the audio.
+     *
+     * @param time - Time in seconds, clamped to [0, duration]
+     *
+     * @example
+     * ```typescript
+     * audio.seek(30); // Seek to 30 seconds
+     * ```
+     */
+    seek(time) {
+        const clampedTime = Math.max(0, Math.min(this.state.duration, time));
+        this.audioElement.currentTime = clampedTime;
+    }
+    /**
+     * Fades in the audio over a specified duration.
+     *
+     * Starts at volume 0 and gradually increases to the target volume.
+     *
+     * @param duration - Fade duration in milliseconds
+     * @returns Promise that resolves when fade completes
+     *
+     * @example
+     * ```typescript
+     * await audio.fadeIn(2000); // Fade in over 2 seconds
+     * ```
+     */
+    async fadeIn(duration = 1000) {
+        const targetVolume = this.state.volume;
+        this.state.volume = 0;
+        this.audioElement.volume = 0;
+        await this.play();
+        return this.fadeTo(targetVolume, duration);
+    }
+    /**
+     * Fades out the audio over a specified duration and stops.
+     *
+     * @param duration - Fade duration in milliseconds
+     * @returns Promise that resolves when fade completes
+     *
+     * @example
+     * ```typescript
+     * await audio.fadeOut(1500); // Fade out over 1.5 seconds
+     * ```
+     */
+    async fadeOut(duration = 1000) {
+        await this.fadeTo(0, duration);
+        this.stop();
+    }
+    /**
+     * Fades to a target volume over a specified duration.
+     *
+     * @private
+     * @param targetVolume - Target volume level (0.0 to 1.0)
+     * @param duration - Fade duration in milliseconds
+     * @returns Promise that resolves when fade completes
+     */
+    async fadeTo(targetVolume, duration) {
+        const startVolume = this.audioElement.volume;
+        const startTime = Date.now();
+        return new Promise((resolve) => {
+            const fade = () => {
+                const elapsed = Date.now() - startTime;
+                const progress = Math.min(elapsed / duration, 1);
+                const currentVolume = startVolume + (targetVolume - startVolume) * progress;
+                this.audioElement.volume = currentVolume;
+                this.state.volume = currentVolume;
+                if (progress < 1) {
+                    requestAnimationFrame(fade);
+                }
+                else {
+                    resolve();
+                }
+            };
+            requestAnimationFrame(fade);
+        });
+    }
+    /**
+     * Gets the reactive audio state.
+     *
+     * This state is a Valtio proxy and can be used with useSnapshot() in React.
+     *
+     * @returns The reactive audio state
+     *
+     * @example
+     * ```typescript
+     * const state = audio.getState();
+     * console.log(state.isPlaying); // true/false
+     * ```
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Saves the current audio state to storage.
+     *
+     * Called automatically when auto-save is enabled.
+     *
+     * @example
+     * ```typescript
+     * audio.save();
+     * ```
+     */
+    save() {
+        const saveState = {
+            id: this.id,
+            src: this.src,
+            volume: this.state.volume,
+            loop: this.state.loop,
+            playbackRate: this.state.playbackRate,
+            muted: this.state.muted,
+            currentTime: this.state.currentTime,
+            isPlaying: this.state.isPlaying,
+            isPaused: this.state.isPaused,
+        };
+        Storage.setValue(this.jsonPath, saveState, true);
+    }
+    /**
+     * Loads the audio state from storage.
+     *
+     * Restores volume, loop, playback rate, muted status, and playback position.
+     * Optionally resumes playback if the audio was playing when saved.
+     *
+     * @example
+     * ```typescript
+     * audio.load();
+     * ```
+     */
+    load() {
+        const savedState = Storage.getValue(this.jsonPath);
+        if (savedState.length > 0) {
+            const state = savedState[0];
+            this.state.volume = state.volume;
+            this.state.loop = state.loop;
+            this.state.playbackRate = state.playbackRate;
+            this.state.muted = state.muted;
+            // Apply effective volume (considering master volume)
+            this._applyEffectiveVolume();
+            this.audioElement.loop = state.loop;
+            this.audioElement.playbackRate = state.playbackRate;
+            this.audioElement.muted = state.muted;
+            this.audioElement.currentTime = state.currentTime;
+            // Restore playback state
+            if (state.isPlaying && !state.isPaused) {
+                this.play().catch((error) => {
+                    logger.warn(`Could not auto-resume audio "${this.id}" on load. User interaction may be required.`, error);
+                });
+            }
+        }
+    }
+    /**
+     * Cleans up the audio track and removes all listeners.
+     *
+     * Should be called when the audio track is no longer needed.
+     *
+     * @example
+     * ```typescript
+     * audio.dispose();
+     * ```
+     */
+    dispose() {
+        this.stop();
+        this.unsubscribe?.();
+        AudioManager._unregisterTrack(this);
+        // Remove all event listeners by cloning the element
+        const clone = this.audioElement.cloneNode();
+        this.audioElement.parentNode?.replaceChild(clone, this.audioElement);
+        logger.log(`Audio track disposed: ${this.id}`);
+    }
+}
+/**
+ * Global audio manager for controlling all audio tracks.
+ *
+ * AudioManager provides a singleton interface for game-wide audio operations
+ * like master volume control, muting all tracks, or pausing all audio.
+ *
+ * @example
+ * ```typescript
+ * // Global volume control
+ * AudioManager.setMasterVolume(0.5);
+ *
+ * // Mute all audio
+ * AudioManager.muteAll();
+ *
+ * // Pause all playing tracks
+ * AudioManager.pauseAll();
+ * ```
+ */
+class AudioManagerClass {
+    tracks = new Map();
+    state = proxy({
+        masterVolume: 1,
+        isMuted: false,
+    });
+    /**
+     * Internal method to register a track.
+     * Called automatically by AudioTrack constructor.
+     *
+     * @internal
+     * @param track - The audio track to register
+     */
+    _registerTrack(track) {
+        this.tracks.set(track.id, track);
+        logger.log(`AudioManager registered track: ${track.id}`);
+    }
+    /**
+     * Internal method to unregister a track.
+     * Called automatically by AudioTrack.dispose().
+     *
+     * @internal
+     * @param track - The audio track to unregister
+     */
+    _unregisterTrack(track) {
+        this.tracks.delete(track.id);
+        logger.log(`AudioManager unregistered track: ${track.id}`);
+    }
+    /**
+     * Sets the master volume for all audio tracks.
+     *
+     * The master volume is multiplied with each track's individual volume.
+     * This does not modify individual track volumes - it applies a global multiplier.
+     *
+     * @param volume - Master volume level (0.0 to 1.0), clamped to valid range
+     *
+     * @example
+     * ```typescript
+     * AudioManager.setMasterVolume(0.5); // 50% master volume
+     * ```
+     */
+    setMasterVolume(volume) {
+        const clampedVolume = Math.max(0, Math.min(1, volume));
+        this.state.masterVolume = clampedVolume;
+        // Apply to all tracks without modifying their base volume
+        this.tracks.forEach((track) => {
+            track._applyEffectiveVolume();
+        });
+        logger.log(`Master volume set to: ${clampedVolume}`);
+    }
+    /**
+     * Gets the current master volume.
+     *
+     * @returns The master volume level (0.0 to 1.0)
+     *
+     * @example
+     * ```typescript
+     * const volume = AudioManager.getMasterVolume();
+     * ```
+     */
+    getMasterVolume() {
+        return this.state.masterVolume;
+    }
+    /**
+     * Mutes all audio tracks.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.muteAll();
+     * ```
+     */
+    muteAll() {
+        this.state.isMuted = true;
+        this.tracks.forEach((track) => track.setMuted(true));
+        logger.log("All audio tracks muted");
+    }
+    /**
+     * Unmutes all audio tracks.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.unmuteAll();
+     * ```
+     */
+    unmuteAll() {
+        this.state.isMuted = false;
+        this.tracks.forEach((track) => track.setMuted(false));
+        logger.log("All audio tracks unmuted");
+    }
+    /**
+     * Pauses all currently playing audio tracks.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.pauseAll();
+     * ```
+     */
+    pauseAll() {
+        this.tracks.forEach((track) => {
+            if (track.getState().isPlaying) {
+                track.pause();
+            }
+        });
+        logger.log("All audio tracks paused");
+    }
+    /**
+     * Resumes all paused audio tracks.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.resumeAll();
+     * ```
+     */
+    resumeAll() {
+        this.tracks.forEach((track) => {
+            if (track.getState().isPaused) {
+                track.resume();
+            }
+        });
+        logger.log("All audio tracks resumed");
+    }
+    /**
+     * Stops all audio tracks.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.stopAll();
+     * ```
+     */
+    stopAll() {
+        this.tracks.forEach((track) => track.stop());
+        logger.log("All audio tracks stopped");
+    }
+    /**
+     * Gets all registered audio tracks.
+     *
+     * @returns Array of all audio tracks
+     *
+     * @example
+     * ```typescript
+     * const tracks = AudioManager.getAllTracks();
+     * console.log(`Total tracks: ${tracks.length}`);
+     * ```
+     */
+    getAllTracks() {
+        return Array.from(this.tracks.values());
+    }
+    /**
+     * Gets an audio track by its ID.
+     *
+     * @param id - The unique identifier of the audio track
+     * @returns The audio track, or undefined if not found
+     *
+     * @example
+     * ```typescript
+     * const music = AudioManager.getTrackById('bg-music');
+     * if (music) {
+     *   music.play();
+     * }
+     * ```
+     */
+    getTrackById(id) {
+        return this.tracks.get(id);
+    }
+    /**
+     * Gets the reactive audio manager state.
+     *
+     * This state is a Valtio proxy and can be used with useSnapshot() in React.
+     *
+     * @returns The reactive audio manager state
+     *
+     * @example
+     * ```typescript
+     * const state = AudioManager.getState();
+     * console.log(state.masterVolume); // 1.0
+     * ```
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Disposes all audio tracks.
+     *
+     * Useful for cleanup when shutting down the game.
+     *
+     * @example
+     * ```typescript
+     * AudioManager.disposeAll();
+     * ```
+     */
+    disposeAll() {
+        this.tracks.forEach((track) => track.dispose());
+        this.tracks.clear();
+        logger.log("All audio tracks disposed");
+    }
+}
+/**
+ * Singleton instance of the AudioManager.
+ *
+ * Use this to control all audio tracks globally.
+ *
+ * @example
+ * ```typescript
+ * import { AudioManager } from '@react-text-game/core/audio';
+ *
+ * AudioManager.setMasterVolume(0.8);
+ * AudioManager.muteAll();
+ * ```
+ */
+export const AudioManager = new AudioManagerClass();
+//# sourceMappingURL=audioTrack.js.map

package/dist/audio/audioTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioTrack.js","sourceRoot":"","sources":["../../src/audio/audioTrack.ts"],"names":[],"mappings":"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"}

package/dist/audio/constants.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 declare const AUDIO_STORAGE_PATH: "$._system.audio";
+/**
+ * Default audio configuration values.
+ */
+export declare const DEFAULT_AUDIO_OPTIONS: {
+    readonly volume: 1;
+    readonly loop: false;
+    readonly playbackRate: 1;
+    readonly muted: false;
+    readonly autoPlay: false;
+    readonly preload: "metadata";
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/audio/constants.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,mBAA6D,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC"}