blacktrigram 0.7.2

package/lib/audio/AudioPool.js

@@ -0,0 +1,206 @@
+//#region src/audio/AudioPool.ts
+/**
+* Generic object pool implementation
+*/
+var ObjectPool = class {
+	available = [];
+	inUse = /* @__PURE__ */ new Set();
+	acquisitionCount = 0;
+	releaseCount = 0;
+	createdCount = 0;
+	constructor(factory, reset, config = {
+		initialSize: 10,
+		maxSize: 100,
+		autoExpand: true
+	}) {
+		this.factory = factory;
+		this.reset = reset;
+		this.config = config;
+		for (let i = 0; i < config.initialSize; i++) this.available.push(this.createObject());
+	}
+	/**
+	* Acquire an object from the pool
+	*/
+	acquire() {
+		this.acquisitionCount++;
+		let obj = this.available.pop();
+		if (!obj) if (this.config.autoExpand && this.canExpand()) obj = this.createObject();
+		else {
+			console.warn("Pool exhausted and cannot expand");
+			return null;
+		}
+		this.inUse.add(obj);
+		return obj;
+	}
+	/**
+	* Release an object back to the pool
+	*/
+	release(obj) {
+		if (!this.inUse.has(obj)) {
+			console.warn("Attempted to release object not in use");
+			return;
+		}
+		this.releaseCount++;
+		this.reset(obj);
+		this.inUse.delete(obj);
+		this.available.push(obj);
+	}
+	/**
+	* Release all objects back to the pool
+	* Resets all in-use objects and returns them to the available pool
+	*/
+	releaseAll() {
+		this.inUse.forEach((obj) => {
+			this.releaseCount++;
+			this.reset(obj);
+			this.available.push(obj);
+		});
+		this.inUse.clear();
+	}
+	/**
+	* Get pool statistics
+	*/
+	getStatistics() {
+		return {
+			available: this.available.length,
+			inUse: this.inUse.size,
+			total: this.available.length + this.inUse.size,
+			acquisitions: this.acquisitionCount,
+			releases: this.releaseCount,
+			created: this.createdCount
+		};
+	}
+	/**
+	* Clear the pool and dispose all objects
+	*/
+	clear() {
+		this.available = [];
+		this.inUse.clear();
+	}
+	createObject() {
+		this.createdCount++;
+		return this.factory();
+	}
+	canExpand() {
+		return this.available.length + this.inUse.size < this.config.maxSize;
+	}
+};
+/**
+* Specialized audio pool for HTMLAudioElement instances
+*/
+var AudioElementPool = class {
+	pools = /* @__PURE__ */ new Map();
+	defaultConfig = {
+		initialSize: 5,
+		maxSize: 20,
+		autoExpand: true
+	};
+	/**
+	* Create a pool for a specific audio asset
+	*/
+	createPool(assetId, audioSrc, config) {
+		const existingPool = this.pools.get(assetId);
+		if (existingPool) return existingPool;
+		const pool = new ObjectPool(() => {
+			const audio = new Audio(audioSrc);
+			audio.preload = "auto";
+			audio.load();
+			return audio;
+		}, (audio) => {
+			audio.pause();
+			audio.currentTime = 0;
+		}, {
+			...this.defaultConfig,
+			...config
+		});
+		this.pools.set(assetId, pool);
+		return pool;
+	}
+	/**
+	* Get pool for an asset (creates if doesn't exist)
+	*/
+	getPool(assetId) {
+		return this.pools.get(assetId);
+	}
+	/**
+	* Acquire audio element from pool
+	*/
+	acquire(assetId) {
+		const pool = this.pools.get(assetId);
+		if (!pool) {
+			console.warn(`No pool exists for asset: ${assetId}`);
+			return null;
+		}
+		return pool.acquire();
+	}
+	/**
+	* Release audio element back to pool
+	*/
+	release(assetId, audio) {
+		const pool = this.pools.get(assetId);
+		if (!pool) {
+			console.warn(`No pool exists for asset: ${assetId}`);
+			return;
+		}
+		pool.release(audio);
+	}
+	/**
+	* Release all audio elements in all pools
+	*/
+	releaseAll() {
+		this.pools.forEach((pool) => pool.releaseAll());
+	}
+	/**
+	* Get statistics for a specific pool
+	*/
+	getPoolStatistics(assetId) {
+		return this.pools.get(assetId)?.getStatistics();
+	}
+	/**
+	* Get statistics for all pools
+	*/
+	getAllStatistics() {
+		const stats = /* @__PURE__ */ new Map();
+		this.pools.forEach((pool, assetId) => {
+			stats.set(assetId, pool.getStatistics());
+		});
+		return stats;
+	}
+	/**
+	* Remove a pool and dispose its resources
+	* @param assetId - The ID of the asset whose pool should be removed
+	* @returns true if the pool existed and was removed, false if no pool was found for the asset
+	*/
+	removePool(assetId) {
+		const pool = this.pools.get(assetId);
+		if (pool) {
+			pool.clear();
+			this.pools.delete(assetId);
+			return true;
+		}
+		return false;
+	}
+	/**
+	* Clear all pools
+	*/
+	clearAll() {
+		this.pools.forEach((pool) => pool.clear());
+		this.pools.clear();
+	}
+	/**
+	* Check if pool exists for asset
+	*/
+	hasPool(assetId) {
+		return this.pools.has(assetId);
+	}
+	/**
+	* Get total number of pools
+	*/
+	getPoolCount() {
+		return this.pools.size;
+	}
+};
+//#endregion
+export { AudioElementPool };
+
+//# sourceMappingURL=AudioPool.js.map

package/lib/audio/AudioPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPool.js","names":[],"sources":["../../src/audio/AudioPool.ts"],"sourcesContent":["/**\n * AudioPool - Object pooling for audio instances\n * Reduces memory allocation overhead for frequently played sounds\n */\n\nexport interface PoolStatistics {\n  readonly available: number;\n  readonly inUse: number;\n  readonly total: number;\n  readonly acquisitions: number;\n  readonly releases: number;\n  readonly created: number;\n}\n\nexport interface PoolConfig {\n  readonly initialSize?: number;\n  readonly maxSize?: number;\n  readonly autoExpand?: boolean;\n}\n\n/**\n * Generic object pool implementation\n */\nexport class ObjectPool<T> {\n  private available: T[] = [];\n  private inUse = new Set<T>();\n  private acquisitionCount = 0;\n  private releaseCount = 0;\n  private createdCount = 0;\n\n  constructor(\n    private readonly factory: () => T,\n    private readonly reset: (obj: T) => void,\n    private readonly config: Required<PoolConfig> = {\n      initialSize: 10,\n      maxSize: 100,\n      autoExpand: true,\n    }\n  ) {\n    // Pre-populate pool\n    for (let i = 0; i < config.initialSize; i++) {\n      this.available.push(this.createObject());\n    }\n  }\n\n  /**\n   * Acquire an object from the pool\n   */\n  acquire(): T | null {\n    this.acquisitionCount++;\n\n    let obj = this.available.pop();\n\n    if (!obj) {\n      // Pool is empty\n      if (this.config.autoExpand && this.canExpand()) {\n        obj = this.createObject();\n      } else {\n        console.warn(\"Pool exhausted and cannot expand\");\n        return null;\n      }\n    }\n\n    this.inUse.add(obj);\n    return obj;\n  }\n\n  /**\n   * Release an object back to the pool\n   */\n  release(obj: T): void {\n    if (!this.inUse.has(obj)) {\n      console.warn(\"Attempted to release object not in use\");\n      return;\n    }\n\n    this.releaseCount++;\n    this.reset(obj);\n    this.inUse.delete(obj);\n    this.available.push(obj);\n  }\n\n  /**\n   * Release all objects back to the pool\n   * Resets all in-use objects and returns them to the available pool\n   */\n  releaseAll(): void {\n    this.inUse.forEach((obj) => {\n      this.releaseCount++;\n      this.reset(obj);\n      this.available.push(obj);\n    });\n    this.inUse.clear();\n  }\n\n  /**\n   * Get pool statistics\n   */\n  getStatistics(): PoolStatistics {\n    return {\n      available: this.available.length,\n      inUse: this.inUse.size,\n      total: this.available.length + this.inUse.size,\n      acquisitions: this.acquisitionCount,\n      releases: this.releaseCount,\n      created: this.createdCount,\n    };\n  }\n\n  /**\n   * Clear the pool and dispose all objects\n   */\n  clear(): void {\n    this.available = [];\n    this.inUse.clear();\n  }\n\n  private createObject(): T {\n    this.createdCount++;\n    return this.factory();\n  }\n\n  private canExpand(): boolean {\n    const total = this.available.length + this.inUse.size;\n    return total < this.config.maxSize;\n  }\n}\n\n/**\n * Specialized audio pool for HTMLAudioElement instances\n */\nexport class AudioElementPool {\n  private pools: Map<string, ObjectPool<HTMLAudioElement>> = new Map();\n  private defaultConfig: Required<PoolConfig> = {\n    initialSize: 5,\n    maxSize: 20,\n    autoExpand: true,\n  };\n\n  /**\n   * Create a pool for a specific audio asset\n   */\n  createPool(\n    assetId: string,\n    audioSrc: string,\n    config?: PoolConfig\n  ): ObjectPool<HTMLAudioElement> {\n    const existingPool = this.pools.get(assetId);\n    if (existingPool) {\n      return existingPool;\n    }\n\n    const poolConfig = { ...this.defaultConfig, ...config };\n\n    const pool = new ObjectPool<HTMLAudioElement>(\n      () => {\n        const audio = new Audio(audioSrc);\n        audio.preload = \"auto\";\n        audio.load();\n        return audio;\n      },\n      (audio) => {\n        audio.pause();\n        audio.currentTime = 0;\n      },\n      poolConfig\n    );\n\n    this.pools.set(assetId, pool);\n    return pool;\n  }\n\n  /**\n   * Get pool for an asset (creates if doesn't exist)\n   */\n  getPool(assetId: string): ObjectPool<HTMLAudioElement> | undefined {\n    return this.pools.get(assetId);\n  }\n\n  /**\n   * Acquire audio element from pool\n   */\n  acquire(assetId: string): HTMLAudioElement | null {\n    const pool = this.pools.get(assetId);\n    if (!pool) {\n      console.warn(`No pool exists for asset: ${assetId}`);\n      return null;\n    }\n    return pool.acquire();\n  }\n\n  /**\n   * Release audio element back to pool\n   */\n  release(assetId: string, audio: HTMLAudioElement): void {\n    const pool = this.pools.get(assetId);\n    if (!pool) {\n      console.warn(`No pool exists for asset: ${assetId}`);\n      return;\n    }\n    pool.release(audio);\n  }\n\n  /**\n   * Release all audio elements in all pools\n   */\n  releaseAll(): void {\n    this.pools.forEach((pool) => pool.releaseAll());\n  }\n\n  /**\n   * Get statistics for a specific pool\n   */\n  getPoolStatistics(assetId: string): PoolStatistics | undefined {\n    const pool = this.pools.get(assetId);\n    return pool?.getStatistics();\n  }\n\n  /**\n   * Get statistics for all pools\n   */\n  getAllStatistics(): Map<string, PoolStatistics> {\n    const stats = new Map<string, PoolStatistics>();\n    this.pools.forEach((pool, assetId) => {\n      stats.set(assetId, pool.getStatistics());\n    });\n    return stats;\n  }\n\n  /**\n   * Remove a pool and dispose its resources\n   * @param assetId - The ID of the asset whose pool should be removed\n   * @returns true if the pool existed and was removed, false if no pool was found for the asset\n   */\n  removePool(assetId: string): boolean {\n    const pool = this.pools.get(assetId);\n    if (pool) {\n      pool.clear();\n      this.pools.delete(assetId);\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Clear all pools\n   */\n  clearAll(): void {\n    this.pools.forEach((pool) => pool.clear());\n    this.pools.clear();\n  }\n\n  /**\n   * Check if pool exists for asset\n   */\n  hasPool(assetId: string): boolean {\n    return this.pools.has(assetId);\n  }\n\n  /**\n   * Get total number of pools\n   */\n  getPoolCount(): number {\n    return this.pools.size;\n  }\n}\n"],"mappings":"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"}

package/lib/audio/AudioProvider.d.ts

@@ -0,0 +1,28 @@
+import React from "react";
+import { AudioConfig, IAudioManager } from "./types";
+export interface AudioProviderProps {
+    children: React.ReactNode;
+    config?: Partial<AudioConfig>;
+    manager?: IAudioManager;
+    /**
+     * If true, defers audio initialization until initializeAudio() is called.
+     * This is useful for requiring user gesture before creating AudioContext.
+     */
+    deferInitialization?: boolean;
+}
+export interface AudioContextValue extends IAudioManager {
+    /**
+     * Initialize audio manager. Must be called after user gesture if deferInitialization is true.
+     */
+    initializeAudio: () => Promise<void>;
+    /**
+     * Whether audio system has been fully initialized and is ready for use.
+     * This includes both AudioContext creation (isInitialized) and asset preloading.
+     * Use this property to determine if audio methods can be safely called.
+     */
+    isAudioReady: boolean;
+}
+export declare const AudioContext: React.Context<AudioContextValue | null>;
+export declare const useAudio: () => AudioContextValue;
+export declare const AudioProvider: React.FC<AudioProviderProps>;
+//# sourceMappingURL=AudioProvider.d.ts.map

package/lib/audio/AudioProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioProvider.d.ts","sourceRoot":"","sources":["../../src/audio/AudioProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAMN,MAAM,OAAO,CAAC;AAGf,OAAO,EAAc,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;OAEG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,YAAY,yCAAgD,CAAC;AAE1E,eAAO,MAAM,QAAQ,QAAO,iBAI3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAqMtD,CAAC"}

package/lib/audio/AudioProvider.js

@@ -0,0 +1,135 @@
+import { audioAssetRegistry } from "./AudioAssetRegistry.js";
+import AudioManager from "./AudioManager.js";
+import React, { createContext, useCallback, useContext, useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/audio/AudioProvider.tsx
+var AudioContext = createContext(null);
+var useAudio = () => {
+	const ctx = useContext(AudioContext);
+	if (!ctx) throw new Error("useAudio must be inside AudioProvider");
+	return ctx;
+};
+var AudioProvider = ({ children, config, manager, deferInitialization = false }) => {
+	const [audioManager] = useState(() => manager ?? new AudioManager(config));
+	const [isAudioReady, setIsAudioReady] = useState(false);
+	const [volumeState, setVolumeState] = useState(() => ({
+		masterVolume: audioManager.masterVolume,
+		sfxVolume: audioManager.sfxVolume,
+		musicVolume: audioManager.musicVolume,
+		muted: audioManager.muted,
+		isInitialized: audioManager.isInitialized
+	}));
+	const syncVolumeState = useCallback(() => {
+		setVolumeState({
+			masterVolume: audioManager.masterVolume,
+			sfxVolume: audioManager.sfxVolume,
+			musicVolume: audioManager.musicVolume,
+			muted: audioManager.muted,
+			isInitialized: audioManager.isInitialized
+		});
+	}, [audioManager]);
+	const initializeAudio = useCallback(async () => {
+		try {
+			await audioManager.initialize();
+			const menuAssets = [
+				audioAssetRegistry.getSFX("menu_hover"),
+				audioAssetRegistry.getSFX("menu_select"),
+				audioAssetRegistry.getSFX("menu_click"),
+				audioAssetRegistry.getSFX("menu_navigate"),
+				audioAssetRegistry.getSFX("menu_back")
+			].filter((asset) => asset !== void 0);
+			const combatAssets = [
+				audioAssetRegistry.getSFX("hit_light"),
+				audioAssetRegistry.getSFX("hit_medium"),
+				audioAssetRegistry.getSFX("hit_heavy"),
+				audioAssetRegistry.getSFX("hit_impact"),
+				audioAssetRegistry.getSFX("guard_block"),
+				audioAssetRegistry.getSFX("attack_light"),
+				audioAssetRegistry.getSFX("attack_whoosh"),
+				audioAssetRegistry.getSFX("stance_change")
+			].filter((asset) => asset !== void 0);
+			const musicAssets = [
+				audioAssetRegistry.getMusic("intro_theme"),
+				audioAssetRegistry.getMusic("combat_theme"),
+				audioAssetRegistry.getMusic("cyberpunk_fusion")
+			].filter((asset) => asset !== void 0);
+			const criticalAssets = [
+				...menuAssets,
+				...combatAssets,
+				...musicAssets
+			];
+			await Promise.all(criticalAssets.map((a) => audioManager.loadAsset(a).catch((err) => {
+				console.warn(`Failed to load critical asset: ${a.id}`, err);
+			})));
+			setIsAudioReady(true);
+		} catch (error) {
+			console.error("Failed to initialize audio manager:", error);
+			setIsAudioReady(true);
+		}
+	}, [audioManager]);
+	useEffect(() => {
+		if (!deferInitialization) initializeAudio();
+	}, [deferInitialization, initializeAudio]);
+	const contextValue = React.useMemo(() => {
+		const wrappedSetVolume = (type, volume) => {
+			audioManager.setVolume(type, volume);
+			syncVolumeState();
+		};
+		const wrappedMute = () => {
+			audioManager.mute();
+			syncVolumeState();
+		};
+		const wrappedUnmute = () => {
+			audioManager.unmute();
+			syncVolumeState();
+		};
+		return {
+			initialize: audioManager.initialize.bind(audioManager),
+			loadAsset: audioManager.loadAsset.bind(audioManager),
+			playSFX: audioManager.playSFX.bind(audioManager),
+			playSoundEffect: audioManager.playSoundEffect.bind(audioManager),
+			playMusic: audioManager.playMusic.bind(audioManager),
+			stopMusic: audioManager.stopMusic.bind(audioManager),
+			setVolume: wrappedSetVolume,
+			mute: wrappedMute,
+			unmute: wrappedUnmute,
+			fadeIn: audioManager.fadeIn.bind(audioManager),
+			fadeOut: audioManager.fadeOut.bind(audioManager),
+			playKoreanTechniqueSound: audioManager.playKoreanTechniqueSound.bind(audioManager),
+			playTrigramStanceSound: audioManager.playTrigramStanceSound.bind(audioManager),
+			playVitalPointHitSound: audioManager.playVitalPointHitSound.bind(audioManager),
+			playDojiangAmbience: audioManager.playDojiangAmbience.bind(audioManager),
+			get isInitialized() {
+				return volumeState.isInitialized;
+			},
+			get masterVolume() {
+				return volumeState.masterVolume;
+			},
+			get sfxVolume() {
+				return volumeState.sfxVolume;
+			},
+			get musicVolume() {
+				return volumeState.musicVolume;
+			},
+			get muted() {
+				return volumeState.muted;
+			},
+			initializeAudio,
+			isAudioReady
+		};
+	}, [
+		audioManager,
+		initializeAudio,
+		isAudioReady,
+		syncVolumeState,
+		volumeState
+	]);
+	return /* @__PURE__ */ jsx(AudioContext.Provider, {
+		value: contextValue,
+		children
+	});
+};
+//#endregion
+export { AudioContext, AudioProvider, useAudio };
+
+//# sourceMappingURL=AudioProvider.js.map

package/lib/audio/AudioProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioProvider.js","names":[],"sources":["../../src/audio/AudioProvider.tsx"],"sourcesContent":["/* eslint-disable react-refresh/only-export-components */\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport { audioAssetRegistry } from \"./AudioAssetRegistry\";\nimport AudioManager from \"./AudioManager\";\nimport { AudioAsset, AudioConfig, IAudioManager } from \"./types\";\n\nexport interface AudioProviderProps {\n  children: React.ReactNode;\n  config?: Partial<AudioConfig>;\n  manager?: IAudioManager;\n  /**\n   * If true, defers audio initialization until initializeAudio() is called.\n   * This is useful for requiring user gesture before creating AudioContext.\n   */\n  deferInitialization?: boolean;\n}\n\nexport interface AudioContextValue extends IAudioManager {\n  /**\n   * Initialize audio manager. Must be called after user gesture if deferInitialization is true.\n   */\n  initializeAudio: () => Promise<void>;\n  /**\n   * Whether audio system has been fully initialized and is ready for use.\n   * This includes both AudioContext creation (isInitialized) and asset preloading.\n   * Use this property to determine if audio methods can be safely called.\n   */\n  isAudioReady: boolean;\n}\n\nexport const AudioContext = createContext<AudioContextValue | null>(null);\n\nexport const useAudio = (): AudioContextValue => {\n  const ctx = useContext(AudioContext);\n  if (!ctx) throw new Error(\"useAudio must be inside AudioProvider\");\n  return ctx;\n};\n\nexport const AudioProvider: React.FC<AudioProviderProps> = ({\n  children,\n  config,\n  manager,\n  deferInitialization = false,\n}) => {\n  const [audioManager] = useState<IAudioManager>(\n    () => manager ?? new AudioManager(config),\n  );\n  const [isAudioReady, setIsAudioReady] = useState(false);\n\n  // Track volume states explicitly to trigger re-renders when they change\n  // Initialize with audioManager values to sync with any custom manager\n  const [volumeState, setVolumeState] = useState(() => ({\n    masterVolume: audioManager.masterVolume,\n    sfxVolume: audioManager.sfxVolume,\n    musicVolume: audioManager.musicVolume,\n    muted: audioManager.muted,\n    isInitialized: audioManager.isInitialized,\n  }));\n\n  // Update volume state whenever audioManager values change\n  const syncVolumeState = useCallback(() => {\n    setVolumeState({\n      masterVolume: audioManager.masterVolume,\n      sfxVolume: audioManager.sfxVolume,\n      musicVolume: audioManager.musicVolume,\n      muted: audioManager.muted,\n      isInitialized: audioManager.isInitialized,\n    });\n  }, [audioManager]);\n\n  const initializeAudio = useCallback(async () => {\n    // Note: We don't check isAudioReady here to allow retry attempts\n    // If initialization fails, users can retry by calling this again\n\n    try {\n      await audioManager.initialize(); // no args\n\n      // Phase 3: Optimized preloading - only critical assets\n      // 3단계: 최적화된 사전 로드 - 중요한 자산만\n      // Non-critical assets will be loaded on-demand when first played\n\n      // 1. Preload critical menu UI sounds (instant playback required)\n      // 중요한 메뉴 UI 사운드 사전 로드 (즉시 재생 필요)\n      const criticalMenuSounds = [\n        audioAssetRegistry.getSFX(\"menu_hover\"),\n        audioAssetRegistry.getSFX(\"menu_select\"),\n        audioAssetRegistry.getSFX(\"menu_click\"),\n        audioAssetRegistry.getSFX(\"menu_navigate\"),\n        audioAssetRegistry.getSFX(\"menu_back\"),\n      ];\n\n      const menuAssets = criticalMenuSounds.filter(\n        (asset) => asset !== undefined,\n      ) as AudioAsset[];\n\n      // 2. Preload critical combat sounds (instant playback required)\n      // 중요한 전투 사운드 사전 로드 (즉시 재생 필요)\n      const criticalCombatSounds = [\n        audioAssetRegistry.getSFX(\"hit_light\"),\n        audioAssetRegistry.getSFX(\"hit_medium\"),\n        audioAssetRegistry.getSFX(\"hit_heavy\"),\n        audioAssetRegistry.getSFX(\"hit_impact\"),\n        audioAssetRegistry.getSFX(\"guard_block\"),\n        audioAssetRegistry.getSFX(\"attack_light\"),\n        audioAssetRegistry.getSFX(\"attack_whoosh\"),\n        audioAssetRegistry.getSFX(\"stance_change\"),\n      ];\n\n      const combatAssets = criticalCombatSounds.filter(\n        (asset) => asset !== undefined,\n      ) as AudioAsset[];\n\n      // 3. Preload essential music tracks (intro, combat, training)\n      // 필수 음악 트랙 사전 로드 (인트로, 전투, 훈련)\n      const introMusic = audioAssetRegistry.getMusic(\"intro_theme\");\n      const combatMusic = audioAssetRegistry.getMusic(\"combat_theme\");\n      const trainingMusic = audioAssetRegistry.getMusic(\"cyberpunk_fusion\");\n\n      const musicAssets = [introMusic, combatMusic, trainingMusic].filter(\n        (asset) => asset !== undefined,\n      ) as AudioAsset[];\n\n      // Combine critical assets for parallel loading\n      // 병렬 로드를 위한 중요 자산 결합\n      const criticalAssets = [...menuAssets, ...combatAssets, ...musicAssets];\n\n      // Preload critical assets in parallel (30MB cache limit will handle this)\n      // 중요 자산을 병렬로 사전 로드 (30MB 캐시 제한이 이를 처리함)\n      await Promise.all(\n        criticalAssets.map((a) =>\n          audioManager.loadAsset(a).catch((err) => {\n            console.warn(`Failed to load critical asset: ${a.id}`, err);\n          }),\n        ),\n      );\n\n      // NOTE: Non-critical assets are loaded on-demand:\n      // - Archetype themes: Loaded on-demand when first requested (예: 캐릭터 선택 화면 또는 전투 화면에서 필요할 때)\n      // - Other combat sounds: Loaded when first used in combat\n      // - Placeholder assets: Loaded as fallbacks when needed\n      // - Philosophy screen music: Loaded on-demand when philosophy screen opens\n      // This reduces initial memory footprint while ensuring core gameplay music is ready\n\n      setIsAudioReady(true);\n    } catch (error) {\n      console.error(\"Failed to initialize audio manager:\", error);\n      // Continue without audio - silent mode fallback\n      setIsAudioReady(true); // Mark as ready even in fallback mode\n    }\n  }, [audioManager]); // Removed isAudioReady to prevent unnecessary callback recreation\n\n  // Auto-initialize if not deferred\n  useEffect(() => {\n    if (!deferInitialization) {\n      initializeAudio();\n    }\n  }, [deferInitialization, initializeAudio]);\n\n  const contextValue = React.useMemo<AudioContextValue>(() => {\n    // Wrap methods that change volume state to also sync React state\n    const wrappedSetVolume = (\n      type: \"master\" | \"sfx\" | \"music\" | \"voice\",\n      volume: number,\n    ) => {\n      audioManager.setVolume(type, volume);\n      syncVolumeState();\n    };\n\n    const wrappedMute = () => {\n      audioManager.mute();\n      syncVolumeState();\n    };\n\n    const wrappedUnmute = () => {\n      audioManager.unmute();\n      syncVolumeState();\n    };\n\n    // Create a dynamic wrapper that accesses getter properties on-demand\n    // This ensures components always get current values\n    return {\n      // Explicitly bind all IAudioManager methods\n      initialize: audioManager.initialize.bind(audioManager),\n      loadAsset: audioManager.loadAsset.bind(audioManager),\n      playSFX: audioManager.playSFX.bind(audioManager),\n      playSoundEffect: audioManager.playSoundEffect.bind(audioManager),\n      playMusic: audioManager.playMusic.bind(audioManager),\n      stopMusic: audioManager.stopMusic.bind(audioManager),\n      setVolume: wrappedSetVolume,\n      mute: wrappedMute,\n      unmute: wrappedUnmute,\n      fadeIn: audioManager.fadeIn.bind(audioManager),\n      fadeOut: audioManager.fadeOut.bind(audioManager),\n      playKoreanTechniqueSound:\n        audioManager.playKoreanTechniqueSound.bind(audioManager),\n      playTrigramStanceSound:\n        audioManager.playTrigramStanceSound.bind(audioManager),\n      playVitalPointHitSound:\n        audioManager.playVitalPointHitSound.bind(audioManager),\n      playDojiangAmbience: audioManager.playDojiangAmbience.bind(audioManager),\n\n      // Use tracked state values for reactivity (triggers re-renders)\n      get isInitialized() {\n        return volumeState.isInitialized;\n      },\n      get masterVolume() {\n        return volumeState.masterVolume;\n      },\n      get sfxVolume() {\n        return volumeState.sfxVolume;\n      },\n      get musicVolume() {\n        return volumeState.musicVolume;\n      },\n      get muted() {\n        return volumeState.muted;\n      },\n\n      // AudioProvider-specific properties\n      initializeAudio,\n      isAudioReady,\n    };\n  }, [\n    audioManager,\n    initializeAudio,\n    isAudioReady,\n    syncVolumeState,\n    volumeState,\n  ]);\n\n  return (\n    <AudioContext.Provider value={contextValue}>\n      {children}\n    </AudioContext.Provider>\n  );\n};\n"],"mappings":"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"}

package/lib/audio/AudioUtils.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Audio utility functions for Korean martial arts game
+ */
+import type { AudioFormat } from "./types";
+export declare const AUDIO_FORMATS: readonly AudioFormat[];
+/**
+ * Select the best available audio format based on browser support
+ */
+export declare function selectAudioFormat(availableFormats: readonly AudioFormat[], preferredFormats?: readonly AudioFormat[]): AudioFormat | null;
+/**
+ * Get preferred audio URLs based on format selection
+ * Returns an array of URLs to try in order of preference
+ */
+export declare function getPreferredFormat(availableFormats: readonly AudioFormat[], basePath: string): string[];
+/**
+ * Check if the browser can play a specific audio type
+ */
+export declare function canPlayType(format: AudioFormat): boolean;
+/**
+ * Clamp volume to valid range (0-1)
+ */
+export declare function clampVolume(volume: number): number;
+/**
+ * Get metadata for the best available format
+ */
+export declare function getBestFormatMetadata(availableFormats: readonly AudioFormat[]): {
+    format: AudioFormat | null;
+    supported: boolean;
+    quality: "medium" | "low" | "high";
+};
+export declare class AudioUtils {
+    /**
+     * Check if browser can play audio type
+     */
+    static canPlayType(mimeType: string): boolean;
+    /**
+     * Select best audio format from available options
+     */
+    static selectAudioFormat(available: readonly AudioFormat[], preferred?: readonly AudioFormat[]): AudioFormat | null;
+    /**
+     * Get best format metadata
+     */
+    static getBestFormatMetadata(formats: readonly AudioFormat[]): {
+        format: AudioFormat | null;
+        supported: boolean;
+        confidence: string;
+    };
+}
+/**
+ * Detect supported audio formats in the current browser
+ */
+export declare function detectSupportedFormats(): AudioFormat[];
+/**
+ * Create and configure an audio element
+ */
+export declare function createAudioElement(url: string, volume?: number): HTMLAudioElement;
+/**
+ * Validate audio URL format
+ */
+export declare function validateAudioUrl(url: string): boolean;
+/**
+ * Normalize volume to range [0, 1]
+ */
+export declare function normalizeVolume(volume: number): number;
+/**
+ * Format audio duration from seconds to mm:ss
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Check if the Audio API is supported
+ */
+export declare function isAudioSupported(): boolean;
+/**
+ * Get the optimal audio format from supported formats
+ */
+export declare function getOptimalFormat(supportedFormats: AudioFormat[]): AudioFormat | null;
+//# sourceMappingURL=AudioUtils.d.ts.map

package/lib/audio/AudioUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioUtils.d.ts","sourceRoot":"","sources":["../../src/audio/AudioUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAKtC,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,SAAS,WAAW,EAAE,EACxC,gBAAgB,GAAE,SAAS,WAAW,EAAkB,GACvD,WAAW,GAAG,IAAI,CAgBpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,SAAS,WAAW,EAAE,EACxC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAeV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CASxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,SAAS,WAAW,EAAE;;;;EAQzC;AAmBD,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM7C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,SAAS,EAAE,SAAS,WAAW,EAAE,EACjC,SAAS,GAAE,SAAS,WAAW,EAK9B,GACA,WAAW,GAAG,IAAI;IAsBrB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG;QAC7D,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB;CAoBF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,EAAE,CAqBtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAY,GACnB,gBAAgB,CAKlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,WAAW,EAAE,GAC9B,WAAW,GAAG,IAAI,CAepB"}

package/lib/audio/AudioUtils.js

@@ -0,0 +1,164 @@
+//#region src/audio/AudioUtils.ts
+var AUDIO_FORMATS = [
+	"audio/webm",
+	"audio/mp3",
+	"audio/wav",
+	"audio/ogg"
+];
+/**
+* Select the best available audio format based on browser support
+*/
+function selectAudioFormat(availableFormats, preferredFormats = AUDIO_FORMATS) {
+	for (const preferred of preferredFormats) if (availableFormats.includes(preferred) && canPlayType(preferred)) return preferred;
+	for (const format of availableFormats) if (canPlayType(format)) return format;
+	return null;
+}
+/**
+* Get preferred audio URLs based on format selection
+* Returns an array of URLs to try in order of preference
+*/
+function getPreferredFormat(availableFormats, basePath) {
+	const selectedFormat = selectAudioFormat(availableFormats);
+	if (!selectedFormat) {
+		const fallbackFormat = availableFormats[0];
+		if (fallbackFormat) return [`${basePath}.${fallbackFormat.replace("audio/", "")}`];
+		return [];
+	}
+	return [`${basePath}.${selectedFormat.replace("audio/", "")}`];
+}
+/**
+* Check if the browser can play a specific audio type
+*/
+function canPlayType(format) {
+	if (typeof Audio === "undefined") return ["audio/mp3", "audio/wav"].includes(format);
+	const support = new Audio().canPlayType(format);
+	return support === "probably" || support === "maybe";
+}
+/**
+* Clamp volume to valid range (0-1)
+*/
+function clampVolume(volume) {
+	return Math.max(0, Math.min(1, volume));
+}
+/**
+* Get metadata for the best available format
+*/
+function getBestFormatMetadata(availableFormats) {
+	const selectedFormat = selectAudioFormat(availableFormats);
+	return {
+		format: selectedFormat,
+		supported: selectedFormat ? canPlayType(selectedFormat) : false,
+		quality: getFormatQuality(selectedFormat)
+	};
+}
+function getFormatQuality(format) {
+	if (!format) return "low";
+	switch (format) {
+		case "audio/wav": return "high";
+		case "audio/webm":
+		case "audio/ogg": return "medium";
+		default: return "medium";
+	}
+}
+var AudioUtils = class {
+	/**
+	* Check if browser can play audio type
+	*/
+	static canPlayType(mimeType) {
+		const canPlay = new Audio().canPlayType(mimeType);
+		return canPlay === "probably" || canPlay === "maybe";
+	}
+	/**
+	* Select best audio format from available options
+	*/
+	static selectAudioFormat(available, preferred = [
+		"audio/mp3",
+		"audio/wav",
+		"audio/ogg",
+		"audio/webm"
+	]) {
+		const availableFormats = [...available];
+		const preferredFormats = [...preferred];
+		for (const format of preferredFormats) if (availableFormats.includes(format) && this.canPlayType(format)) return format;
+		for (const format of availableFormats) if (this.canPlayType(format)) return format;
+		return null;
+	}
+	/**
+	* Get best format metadata
+	*/
+	static getBestFormatMetadata(formats) {
+		const selectedFormat = this.selectAudioFormat(formats);
+		if (!selectedFormat) return {
+			format: null,
+			supported: false,
+			confidence: ""
+		};
+		const confidence = new Audio().canPlayType(selectedFormat);
+		return {
+			format: selectedFormat,
+			supported: this.canPlayType(selectedFormat),
+			confidence
+		};
+	}
+};
+/**
+* Detect supported audio formats in the current browser
+*/
+function detectSupportedFormats() {
+	const audio = new Audio();
+	const formats = [];
+	if (audio.canPlayType("audio/mp3")) formats.push("audio/mp3");
+	if (audio.canPlayType("audio/wav")) formats.push("audio/wav");
+	if (audio.canPlayType("audio/ogg")) formats.push("audio/ogg");
+	if (audio.canPlayType("audio/webm")) formats.push("audio/webm");
+	return formats;
+}
+/**
+* Create and configure an audio element
+*/
+function createAudioElement(url, volume = 1) {
+	const audio = new Audio(url);
+	audio.volume = volume;
+	audio.preload = "auto";
+	return audio;
+}
+/**
+* Validate audio URL format
+*/
+function validateAudioUrl(url) {
+	return typeof url === "string" && url.length > 0;
+}
+/**
+* Normalize volume to range [0, 1]
+*/
+function normalizeVolume(volume) {
+	return Math.max(0, Math.min(1, volume));
+}
+/**
+* Format audio duration from seconds to mm:ss
+*/
+function formatDuration(seconds) {
+	return `${Math.floor(seconds / 60)}:${Math.floor(seconds % 60).toString().padStart(2, "0")}`;
+}
+/**
+* Check if the Audio API is supported
+*/
+function isAudioSupported() {
+	return typeof Audio !== "undefined";
+}
+/**
+* Get the optimal audio format from supported formats
+*/
+function getOptimalFormat(supportedFormats) {
+	for (const format of [
+		"audio/webm",
+		"audio/mp3",
+		"audio/wav",
+		"audio/ogg"
+	]) if (supportedFormats.includes(format)) return format;
+	return supportedFormats.length > 0 ? supportedFormats[0] : null;
+}
+//#endregion
+export { AUDIO_FORMATS, AudioUtils, canPlayType, clampVolume, createAudioElement, detectSupportedFormats, formatDuration, getBestFormatMetadata, getOptimalFormat, getPreferredFormat, isAudioSupported, normalizeVolume, selectAudioFormat, validateAudioUrl };
+
+//# sourceMappingURL=AudioUtils.js.map