@jswork/howler-audio-manager 0.0.0-stage → 1.0.1

package/dist/index.d.mts

@@ -0,0 +1,70 @@
+import { Howl, Howler } from 'howler';
+
+interface AudioManagerOptions {
+    /** Default global volume (0.0 to 1.0), defaults to 1.0 */
+    defaultVolume?: number;
+}
+interface PlayOptions {
+    /** Play volume override (0.0 to 1.0) */
+    volume?: number;
+    /** Callback triggered when playback starts */
+    onStart?: (soundId: number) => void;
+    /** Callback triggered when playback ends */
+    onEnd?: (soundId: number) => void;
+    /** Callback triggered when playback encounters an error */
+    onError?: (soundId: number, error: unknown) => void;
+    /** Callback triggered when playback is manually stopped */
+    onStop?: (soundId: number) => void;
+}
+interface PlayUrlOptions extends PlayOptions {
+    /** Whether to loop the audio, defaults to false */
+    loop?: boolean;
+    /** Whether to stop currently playing URL audio, defaults to true */
+    singleton?: boolean;
+}
+type AudioEventType = 'play' | 'end' | 'stop' | 'pause' | 'error' | 'load';
+interface AudioEventPayload<K = string> {
+    type: 'effect' | 'url';
+    key?: K;
+    url?: string;
+    soundId?: number;
+    error?: unknown;
+}
+interface EventSubscription {
+    destroy: () => void;
+}
+type SoundResourceMap<K extends string | number> = Record<K, string>;
+
+declare class AudioManager<K extends string | number = string> {
+    private effectCache;
+    private urlAudioCache;
+    private preloadPromises;
+    private activeUrlHowl;
+    private globalVolume;
+    private listeners;
+    private HowlConstructor;
+    private HowlerInstance;
+    constructor(options?: AudioManagerOptions, inject?: {
+        HowlClass?: typeof Howl;
+        HowlerObj?: typeof Howler;
+    });
+    hasEffect(key: K): boolean;
+    loadEffect(key: K, url: string): void;
+    loadEffects(map: SoundResourceMap<K>): void;
+    playEffect(key: K, options?: PlayOptions): number | undefined;
+    stopEffect(key: K): void;
+    removeEffect(key: K): void;
+    preloadUrl(url: string): Promise<void>;
+    preloadUrls(urls: string[]): Promise<void[]>;
+    private createUrlHowl;
+    playUrl(url: string, options?: PlayUrlOptions): number;
+    stopUrl(url: string): void;
+    on(event: AudioEventType, handler: (payload: AudioEventPayload<K>) => void): EventSubscription;
+    protected emit(event: AudioEventType, payload: AudioEventPayload<K>): void;
+    setGlobalVolume(volume: number): void;
+    mute(muted: boolean): void;
+    stopAll(): void;
+    destroy(): void;
+}
+
+export { type AudioEventPayload, type AudioEventType, AudioManager, type AudioManagerOptions, type EventSubscription, type PlayOptions, type PlayUrlOptions, type SoundResourceMap, AudioManager as default };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { Howl, Howler } from 'howler';
+
+interface AudioManagerOptions {
+    /** Default global volume (0.0 to 1.0), defaults to 1.0 */
+    defaultVolume?: number;
+}
+interface PlayOptions {
+    /** Play volume override (0.0 to 1.0) */
+    volume?: number;
+    /** Callback triggered when playback starts */
+    onStart?: (soundId: number) => void;
+    /** Callback triggered when playback ends */
+    onEnd?: (soundId: number) => void;
+    /** Callback triggered when playback encounters an error */
+    onError?: (soundId: number, error: unknown) => void;
+    /** Callback triggered when playback is manually stopped */
+    onStop?: (soundId: number) => void;
+}
+interface PlayUrlOptions extends PlayOptions {
+    /** Whether to loop the audio, defaults to false */
+    loop?: boolean;
+    /** Whether to stop currently playing URL audio, defaults to true */
+    singleton?: boolean;
+}
+type AudioEventType = 'play' | 'end' | 'stop' | 'pause' | 'error' | 'load';
+interface AudioEventPayload<K = string> {
+    type: 'effect' | 'url';
+    key?: K;
+    url?: string;
+    soundId?: number;
+    error?: unknown;
+}
+interface EventSubscription {
+    destroy: () => void;
+}
+type SoundResourceMap<K extends string | number> = Record<K, string>;
+
+declare class AudioManager<K extends string | number = string> {
+    private effectCache;
+    private urlAudioCache;
+    private preloadPromises;
+    private activeUrlHowl;
+    private globalVolume;
+    private listeners;
+    private HowlConstructor;
+    private HowlerInstance;
+    constructor(options?: AudioManagerOptions, inject?: {
+        HowlClass?: typeof Howl;
+        HowlerObj?: typeof Howler;
+    });
+    hasEffect(key: K): boolean;
+    loadEffect(key: K, url: string): void;
+    loadEffects(map: SoundResourceMap<K>): void;
+    playEffect(key: K, options?: PlayOptions): number | undefined;
+    stopEffect(key: K): void;
+    removeEffect(key: K): void;
+    preloadUrl(url: string): Promise<void>;
+    preloadUrls(urls: string[]): Promise<void[]>;
+    private createUrlHowl;
+    playUrl(url: string, options?: PlayUrlOptions): number;
+    stopUrl(url: string): void;
+    on(event: AudioEventType, handler: (payload: AudioEventPayload<K>) => void): EventSubscription;
+    protected emit(event: AudioEventType, payload: AudioEventPayload<K>): void;
+    setGlobalVolume(volume: number): void;
+    mute(muted: boolean): void;
+    stopAll(): void;
+    destroy(): void;
+}
+
+// @ts-ignore
+export = AudioManager;
+export { type AudioEventPayload, type AudioEventType, AudioManager, type AudioManagerOptions, type EventSubscription, type PlayOptions, type PlayUrlOptions, type SoundResourceMap };

package/dist/index.esm.js

@@ -0,0 +1,403 @@
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+/*!
+ * name: @jswork/howler-audio-manager
+ * description: Howler.js audio manager, enum-driven sounds for H5.
+ * homepage: https://js.work
+ * version: 1.0.1
+ * date: 2026-10-20 18:54:06
+ * license: MIT
+ */ // src/manager.ts
+import { Howl, Howler } from "howler";
+var AudioManager = /*#__PURE__*/ function() {
+    "use strict";
+    function AudioManager(options, inject) {
+        _class_call_check(this, AudioManager);
+        var _ref, _ref1;
+        this.effectCache = /* @__PURE__ */ new Map();
+        this.urlAudioCache = /* @__PURE__ */ new Map();
+        this.preloadPromises = /* @__PURE__ */ new Map();
+        this.activeUrlHowl = null;
+        this.globalVolume = 1;
+        this.listeners = /* @__PURE__ */ new Map();
+        this.HowlConstructor = (_ref = inject === null || inject === void 0 ? void 0 : inject.HowlClass) !== null && _ref !== void 0 ? _ref : Howl;
+        this.HowlerInstance = (_ref1 = inject === null || inject === void 0 ? void 0 : inject.HowlerObj) !== null && _ref1 !== void 0 ? _ref1 : Howler;
+        if (typeof (options === null || options === void 0 ? void 0 : options.defaultVolume) === "number") {
+            this.setGlobalVolume(options.defaultVolume);
+        }
+    }
+    _create_class(AudioManager, [
+        {
+            key: "hasEffect",
+            value: function hasEffect(key) {
+                return this.effectCache.has(key);
+            }
+        },
+        {
+            key: "loadEffect",
+            value: function loadEffect(key, url) {
+                var _this = this;
+                if (this.effectCache.has(key)) {
+                    this.effectCache.get(key).unload();
+                }
+                var howl = new this.HowlConstructor({
+                    src: [
+                        url
+                    ],
+                    preload: true
+                });
+                howl.on("load", function() {
+                    _this.emit("load", {
+                        type: "effect",
+                        key: key,
+                        url: url
+                    });
+                });
+                howl.on("loaderror", function(_id, error) {
+                    _this.emit("error", {
+                        type: "effect",
+                        key: key,
+                        url: url,
+                        error: error
+                    });
+                });
+                this.effectCache.set(key, howl);
+            }
+        },
+        {
+            key: "loadEffects",
+            value: function loadEffects(map) {
+                var _this = this;
+                Object.keys(map).forEach(function(key) {
+                    var typedKey = isNaN(Number(key)) ? key : Number(key);
+                    _this.loadEffect(typedKey, map[key]);
+                });
+            }
+        },
+        {
+            key: "playEffect",
+            value: function playEffect(key, options) {
+                var _this = this;
+                var howl = this.effectCache.get(key);
+                if (!howl) {
+                    console.warn("[AudioManager] Effect not found for key: ".concat(String(key), "."));
+                    return void 0;
+                }
+                if (howl.playing()) {
+                    howl.stop();
+                }
+                if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                    howl.volume(options.volume);
+                }
+                howl.off("play");
+                howl.off("end");
+                howl.off("stop");
+                howl.off("playerror");
+                howl.once("play", function(soundId) {
+                    var _options_onStart;
+                    options === null || options === void 0 ? void 0 : (_options_onStart = options.onStart) === null || _options_onStart === void 0 ? void 0 : _options_onStart.call(options, soundId);
+                    _this.emit("play", {
+                        type: "effect",
+                        key: key,
+                        soundId: soundId
+                    });
+                });
+                howl.once("end", function(soundId) {
+                    var _options_onEnd;
+                    if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                        howl.volume(1);
+                    }
+                    options === null || options === void 0 ? void 0 : (_options_onEnd = options.onEnd) === null || _options_onEnd === void 0 ? void 0 : _options_onEnd.call(options, soundId);
+                    _this.emit("end", {
+                        type: "effect",
+                        key: key,
+                        soundId: soundId
+                    });
+                });
+                howl.once("stop", function(soundId) {
+                    var _options_onStop;
+                    if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                        howl.volume(1);
+                    }
+                    options === null || options === void 0 ? void 0 : (_options_onStop = options.onStop) === null || _options_onStop === void 0 ? void 0 : _options_onStop.call(options, soundId);
+                    _this.emit("stop", {
+                        type: "effect",
+                        key: key,
+                        soundId: soundId
+                    });
+                });
+                howl.once("playerror", function(soundId, error) {
+                    var _options_onError;
+                    options === null || options === void 0 ? void 0 : (_options_onError = options.onError) === null || _options_onError === void 0 ? void 0 : _options_onError.call(options, soundId, error);
+                    _this.emit("error", {
+                        type: "effect",
+                        key: key,
+                        soundId: soundId,
+                        error: error
+                    });
+                });
+                return howl.play();
+            }
+        },
+        {
+            key: "stopEffect",
+            value: function stopEffect(key) {
+                var howl = this.effectCache.get(key);
+                if (howl) {
+                    howl.stop();
+                }
+            }
+        },
+        {
+            key: "removeEffect",
+            value: function removeEffect(key) {
+                var howl = this.effectCache.get(key);
+                if (howl) {
+                    howl.unload();
+                    this.effectCache.delete(key);
+                }
+            }
+        },
+        {
+            key: "preloadUrl",
+            value: function preloadUrl(url) {
+                var _this = this;
+                var existing = this.urlAudioCache.get(url);
+                if (existing && existing.state() === "loaded") {
+                    return Promise.resolve();
+                }
+                var pending = this.preloadPromises.get(url);
+                if (pending) {
+                    return pending;
+                }
+                var howl = existing && existing.state() !== "unloaded" ? existing : this.createUrlHowl(url);
+                var promise = new Promise(function(resolve, reject) {
+                    howl.once("load", function() {
+                        resolve();
+                    });
+                    howl.once("loaderror", function(_id, error) {
+                        _this.urlAudioCache.delete(url);
+                        reject(error);
+                    });
+                });
+                this.preloadPromises.set(url, promise);
+                var settle = function settle() {
+                    if (_this.preloadPromises.get(url) === promise) {
+                        _this.preloadPromises.delete(url);
+                    }
+                };
+                promise.then(settle, settle);
+                return promise;
+            }
+        },
+        {
+            key: "preloadUrls",
+            value: function preloadUrls(urls) {
+                var _this = this;
+                return Promise.all(urls.map(function(url) {
+                    return _this.preloadUrl(url);
+                }));
+            }
+        },
+        {
+            key: "createUrlHowl",
+            value: function createUrlHowl(url) {
+                var _this = this;
+                var howl = new this.HowlConstructor({
+                    src: [
+                        url
+                    ],
+                    preload: true
+                });
+                howl.on("load", function() {
+                    _this.emit("load", {
+                        type: "url",
+                        url: url
+                    });
+                });
+                howl.on("loaderror", function(_id, error) {
+                    _this.urlAudioCache.delete(url);
+                    _this.emit("error", {
+                        type: "url",
+                        url: url,
+                        error: error
+                    });
+                });
+                this.urlAudioCache.set(url, howl);
+                return howl;
+            }
+        },
+        {
+            key: "playUrl",
+            value: function playUrl(url, options) {
+                var _this = this;
+                var howl = this.urlAudioCache.get(url) || this.createUrlHowl(url);
+                var isSingleton = (options === null || options === void 0 ? void 0 : options.singleton) !== false;
+                if (isSingleton && this.activeUrlHowl && this.activeUrlHowl !== howl && this.activeUrlHowl.playing()) {
+                    this.activeUrlHowl.stop();
+                }
+                if (howl.playing()) {
+                    howl.stop();
+                }
+                if ((options === null || options === void 0 ? void 0 : options.loop) !== void 0) {
+                    howl.loop(options.loop);
+                }
+                if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                    howl.volume(options.volume);
+                }
+                if (isSingleton) {
+                    this.activeUrlHowl = howl;
+                }
+                howl.off("play");
+                howl.off("end");
+                howl.off("stop");
+                howl.off("playerror");
+                howl.once("play", function(soundId) {
+                    var _options_onStart;
+                    options === null || options === void 0 ? void 0 : (_options_onStart = options.onStart) === null || _options_onStart === void 0 ? void 0 : _options_onStart.call(options, soundId);
+                    _this.emit("play", {
+                        type: "url",
+                        url: url,
+                        soundId: soundId
+                    });
+                });
+                howl.once("end", function(soundId) {
+                    var _options_onEnd;
+                    if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                        howl.volume(1);
+                    }
+                    options === null || options === void 0 ? void 0 : (_options_onEnd = options.onEnd) === null || _options_onEnd === void 0 ? void 0 : _options_onEnd.call(options, soundId);
+                    _this.emit("end", {
+                        type: "url",
+                        url: url,
+                        soundId: soundId
+                    });
+                    if (_this.activeUrlHowl === howl && !howl.loop()) {
+                        _this.activeUrlHowl = null;
+                    }
+                });
+                howl.once("stop", function(soundId) {
+                    var _options_onStop;
+                    if (typeof (options === null || options === void 0 ? void 0 : options.volume) === "number") {
+                        howl.volume(1);
+                    }
+                    options === null || options === void 0 ? void 0 : (_options_onStop = options.onStop) === null || _options_onStop === void 0 ? void 0 : _options_onStop.call(options, soundId);
+                    _this.emit("stop", {
+                        type: "url",
+                        url: url,
+                        soundId: soundId
+                    });
+                    if (_this.activeUrlHowl === howl) {
+                        _this.activeUrlHowl = null;
+                    }
+                });
+                howl.once("playerror", function(soundId, error) {
+                    var _options_onError;
+                    options === null || options === void 0 ? void 0 : (_options_onError = options.onError) === null || _options_onError === void 0 ? void 0 : _options_onError.call(options, soundId, error);
+                    _this.emit("error", {
+                        type: "url",
+                        url: url,
+                        soundId: soundId,
+                        error: error
+                    });
+                    if (_this.activeUrlHowl === howl) {
+                        _this.activeUrlHowl = null;
+                    }
+                });
+                return howl.play();
+            }
+        },
+        {
+            key: "stopUrl",
+            value: function stopUrl(url) {
+                var howl = this.urlAudioCache.get(url);
+                if (howl) {
+                    howl.stop();
+                }
+            }
+        },
+        {
+            key: "on",
+            value: function on(event, handler) {
+                var _this_listeners_get;
+                var set = (_this_listeners_get = this.listeners.get(event)) !== null && _this_listeners_get !== void 0 ? _this_listeners_get : /* @__PURE__ */ new Set();
+                this.listeners.set(event, set);
+                set.add(handler);
+                return {
+                    destroy: function destroy() {
+                        set.delete(handler);
+                    }
+                };
+            }
+        },
+        {
+            key: "emit",
+            value: function emit(event, payload) {
+                var set = this.listeners.get(event);
+                if (set) {
+                    set.forEach(function(handler) {
+                        try {
+                            handler(payload);
+                        } catch (err) {
+                            console.error("[AudioManager] Error in event listener for ".concat(event, ":"), err);
+                        }
+                    });
+                }
+            }
+        },
+        {
+            key: "setGlobalVolume",
+            value: function setGlobalVolume(volume) {
+                this.globalVolume = volume;
+                this.HowlerInstance.volume(volume);
+            }
+        },
+        {
+            key: "mute",
+            value: function mute(muted) {
+                this.HowlerInstance.mute(muted);
+            }
+        },
+        {
+            key: "stopAll",
+            value: function stopAll() {
+                this.HowlerInstance.stop();
+                this.activeUrlHowl = null;
+            }
+        },
+        {
+            key: "destroy",
+            value: function destroy() {
+                this.effectCache.forEach(function(howl) {
+                    return howl.unload();
+                });
+                this.urlAudioCache.forEach(function(howl) {
+                    return howl.unload();
+                });
+                this.effectCache.clear();
+                this.urlAudioCache.clear();
+                this.preloadPromises.clear();
+                this.listeners.clear();
+                this.activeUrlHowl = null;
+            }
+        }
+    ]);
+    return AudioManager;
+}();
+export { AudioManager, AudioManager as default };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/afei/github/howler-audio-manager/dist/index.esm.js","../src/manager.ts"],"names":["Howl","Howler","AudioManager","options","inject","effectCache","Map","urlAudioCache","preloadPromises","activeUrlHowl","globalVolume","listeners","HowlConstructor","HowlClass","HowlerInstance","HowlerObj","defaultVolume","setGlobalVolume","hasEffect","key","has","loadEffect","url","get","unload","howl","src","preload","on","emit","type","_id","error","set","loadEffects","map","Object","keys","forEach","typedKey","isNaN","Number","playEffect","console","warn","String","playing","stop","volume","off","once","soundId","onStart","onEnd","onStop","onError","play","stopEffect","removeEffect","delete","preloadUrl","existing","state","Promise","resolve","pending","createUrlHowl","promise","reject","settle","then","preloadUrls","urls","all","playUrl","isSingleton","singleton","loop","stopUrl","event","handler","Set","add","destroy","payload","err","mute","muted","stopAll","clear","default"],"mappings":"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","sourcesContent":["/*!\n * name: @jswork/howler-audio-manager\n * description: Howler.js audio manager, enum-driven sounds for H5.\n * homepage: https://js.work\n * version: 1.0.1\n * date: 2026-10-20 18:54:06\n * license: MIT\n */\n\n\n// src/manager.ts\nimport { Howl, Howler } from \"howler\";\nvar AudioManager = class {\n  constructor(options, inject) {\n    this.effectCache = /* @__PURE__ */ new Map();\n    this.urlAudioCache = /* @__PURE__ */ new Map();\n    this.preloadPromises = /* @__PURE__ */ new Map();\n    this.activeUrlHowl = null;\n    this.globalVolume = 1;\n    this.listeners = /* @__PURE__ */ new Map();\n    this.HowlConstructor = inject?.HowlClass ?? Howl;\n    this.HowlerInstance = inject?.HowlerObj ?? Howler;\n    if (typeof options?.defaultVolume === \"number\") {\n      this.setGlobalVolume(options.defaultVolume);\n    }\n  }\n  hasEffect(key) {\n    return this.effectCache.has(key);\n  }\n  loadEffect(key, url) {\n    if (this.effectCache.has(key)) {\n      this.effectCache.get(key).unload();\n    }\n    const howl = new this.HowlConstructor({\n      src: [url],\n      preload: true\n    });\n    howl.on(\"load\", () => {\n      this.emit(\"load\", { type: \"effect\", key, url });\n    });\n    howl.on(\"loaderror\", (_id, error) => {\n      this.emit(\"error\", { type: \"effect\", key, url, error });\n    });\n    this.effectCache.set(key, howl);\n  }\n  loadEffects(map) {\n    Object.keys(map).forEach((key) => {\n      const typedKey = isNaN(Number(key)) ? key : Number(key);\n      this.loadEffect(typedKey, map[key]);\n    });\n  }\n  playEffect(key, options) {\n    const howl = this.effectCache.get(key);\n    if (!howl) {\n      console.warn(`[AudioManager] Effect not found for key: ${String(key)}.`);\n      return void 0;\n    }\n    if (howl.playing()) {\n      howl.stop();\n    }\n    if (typeof options?.volume === \"number\") {\n      howl.volume(options.volume);\n    }\n    howl.off(\"play\");\n    howl.off(\"end\");\n    howl.off(\"stop\");\n    howl.off(\"playerror\");\n    howl.once(\"play\", (soundId) => {\n      options?.onStart?.(soundId);\n      this.emit(\"play\", { type: \"effect\", key, soundId });\n    });\n    howl.once(\"end\", (soundId) => {\n      if (typeof options?.volume === \"number\") {\n        howl.volume(1);\n      }\n      options?.onEnd?.(soundId);\n      this.emit(\"end\", { type: \"effect\", key, soundId });\n    });\n    howl.once(\"stop\", (soundId) => {\n      if (typeof options?.volume === \"number\") {\n        howl.volume(1);\n      }\n      options?.onStop?.(soundId);\n      this.emit(\"stop\", { type: \"effect\", key, soundId });\n    });\n    howl.once(\"playerror\", (soundId, error) => {\n      options?.onError?.(soundId, error);\n      this.emit(\"error\", { type: \"effect\", key, soundId, error });\n    });\n    return howl.play();\n  }\n  stopEffect(key) {\n    const howl = this.effectCache.get(key);\n    if (howl) {\n      howl.stop();\n    }\n  }\n  removeEffect(key) {\n    const howl = this.effectCache.get(key);\n    if (howl) {\n      howl.unload();\n      this.effectCache.delete(key);\n    }\n  }\n  preloadUrl(url) {\n    const existing = this.urlAudioCache.get(url);\n    if (existing && existing.state() === \"loaded\") {\n      return Promise.resolve();\n    }\n    const pending = this.preloadPromises.get(url);\n    if (pending) {\n      return pending;\n    }\n    const howl = existing && existing.state() !== \"unloaded\" ? existing : this.createUrlHowl(url);\n    const promise = new Promise((resolve, reject) => {\n      howl.once(\"load\", () => {\n        resolve();\n      });\n      howl.once(\"loaderror\", (_id, error) => {\n        this.urlAudioCache.delete(url);\n        reject(error);\n      });\n    });\n    this.preloadPromises.set(url, promise);\n    const settle = () => {\n      if (this.preloadPromises.get(url) === promise) {\n        this.preloadPromises.delete(url);\n      }\n    };\n    promise.then(settle, settle);\n    return promise;\n  }\n  preloadUrls(urls) {\n    return Promise.all(urls.map((url) => this.preloadUrl(url)));\n  }\n  createUrlHowl(url) {\n    const howl = new this.HowlConstructor({\n      src: [url],\n      preload: true\n    });\n    howl.on(\"load\", () => {\n      this.emit(\"load\", { type: \"url\", url });\n    });\n    howl.on(\"loaderror\", (_id, error) => {\n      this.urlAudioCache.delete(url);\n      this.emit(\"error\", { type: \"url\", url, error });\n    });\n    this.urlAudioCache.set(url, howl);\n    return howl;\n  }\n  playUrl(url, options) {\n    const howl = this.urlAudioCache.get(url) || this.createUrlHowl(url);\n    const isSingleton = options?.singleton !== false;\n    if (isSingleton && this.activeUrlHowl && this.activeUrlHowl !== howl && this.activeUrlHowl.playing()) {\n      this.activeUrlHowl.stop();\n    }\n    if (howl.playing()) {\n      howl.stop();\n    }\n    if (options?.loop !== void 0) {\n      howl.loop(options.loop);\n    }\n    if (typeof options?.volume === \"number\") {\n      howl.volume(options.volume);\n    }\n    if (isSingleton) {\n      this.activeUrlHowl = howl;\n    }\n    howl.off(\"play\");\n    howl.off(\"end\");\n    howl.off(\"stop\");\n    howl.off(\"playerror\");\n    howl.once(\"play\", (soundId) => {\n      options?.onStart?.(soundId);\n      this.emit(\"play\", { type: \"url\", url, soundId });\n    });\n    howl.once(\"end\", (soundId) => {\n      if (typeof options?.volume === \"number\") {\n        howl.volume(1);\n      }\n      options?.onEnd?.(soundId);\n      this.emit(\"end\", { type: \"url\", url, soundId });\n      if (this.activeUrlHowl === howl && !howl.loop()) {\n        this.activeUrlHowl = null;\n      }\n    });\n    howl.once(\"stop\", (soundId) => {\n      if (typeof options?.volume === \"number\") {\n        howl.volume(1);\n      }\n      options?.onStop?.(soundId);\n      this.emit(\"stop\", { type: \"url\", url, soundId });\n      if (this.activeUrlHowl === howl) {\n        this.activeUrlHowl = null;\n      }\n    });\n    howl.once(\"playerror\", (soundId, error) => {\n      options?.onError?.(soundId, error);\n      this.emit(\"error\", { type: \"url\", url, soundId, error });\n      if (this.activeUrlHowl === howl) {\n        this.activeUrlHowl = null;\n      }\n    });\n    return howl.play();\n  }\n  stopUrl(url) {\n    const howl = this.urlAudioCache.get(url);\n    if (howl) {\n      howl.stop();\n    }\n  }\n  on(event, handler) {\n    const set = this.listeners.get(event) ?? /* @__PURE__ */ new Set();\n    this.listeners.set(event, set);\n    set.add(handler);\n    return {\n      destroy: () => {\n        set.delete(handler);\n      }\n    };\n  }\n  emit(event, payload) {\n    const set = this.listeners.get(event);\n    if (set) {\n      set.forEach((handler) => {\n        try {\n          handler(payload);\n        } catch (err) {\n          console.error(`[AudioManager] Error in event listener for ${event}:`, err);\n        }\n      });\n    }\n  }\n  setGlobalVolume(volume) {\n    this.globalVolume = volume;\n    this.HowlerInstance.volume(volume);\n  }\n  mute(muted) {\n    this.HowlerInstance.mute(muted);\n  }\n  stopAll() {\n    this.HowlerInstance.stop();\n    this.activeUrlHowl = null;\n  }\n  destroy() {\n    this.effectCache.forEach((howl) => howl.unload());\n    this.urlAudioCache.forEach((howl) => howl.unload());\n    this.effectCache.clear();\n    this.urlAudioCache.clear();\n    this.preloadPromises.clear();\n    this.listeners.clear();\n    this.activeUrlHowl = null;\n  }\n};\nexport {\n  AudioManager,\n  AudioManager as default\n};\n","import { Howl, Howler } from 'howler';\nimport type {\n  AudioManagerOptions,\n  PlayOptions,\n  PlayUrlOptions,\n  AudioEventType,\n  AudioEventPayload,\n  EventSubscription,\n  SoundResourceMap\n} from './types';\n\nexport class AudioManager<K extends string | number = string> {\n  private effectCache = new Map<K, Howl>();\n  private urlAudioCache = new Map<string, Howl>();\n  private preloadPromises = new Map<string, Promise<void>>();\n  private activeUrlHowl: Howl | null = null;\n  private globalVolume = 1.0;\n  private listeners = new Map<AudioEventType, Set<(payload: AudioEventPayload<K>) => void>>();\n\n  private HowlConstructor: typeof Howl;\n  private HowlerInstance: typeof Howler;\n\n  constructor(\n    options?: AudioManagerOptions,\n    inject?: { HowlClass?: typeof Howl; HowlerObj?: typeof Howler }\n  ) {\n    this.HowlConstructor = inject?.HowlClass ?? Howl;\n    this.HowlerInstance = inject?.HowlerObj ?? Howler;\n    if (typeof options?.defaultVolume === 'number') {\n      this.setGlobalVolume(options.defaultVolume);\n    }\n  }\n\n  hasEffect(key: K): boolean {\n    return this.effectCache.has(key);\n  }\n\n  loadEffect(key: K, url: string): void {\n    if (this.effectCache.has(key)) {\n      this.effectCache.get(key)!.unload();\n    }\n    const howl = new this.HowlConstructor({\n      src: [url],\n      preload: true\n    });\n    howl.on('load', () => {\n      this.emit('load', { type: 'effect', key, url });\n    });\n    howl.on('loaderror', (_id: number, error: unknown) => {\n      this.emit('error', { type: 'effect', key, url, error });\n    });\n    this.effectCache.set(key, howl);\n  }\n\n  loadEffects(map: SoundResourceMap<K>): void {\n    Object.keys(map).forEach((key) => {\n      const typedKey = (isNaN(Number(key)) ? key : Number(key)) as K;\n      this.loadEffect(typedKey, map[key as any]);\n    });\n  }\n\n  playEffect(key: K, options?: PlayOptions): number | undefined {\n    const howl = this.effectCache.get(key);\n    if (!howl) {\n      console.warn(`[AudioManager] Effect not found for key: ${String(key)}.`);\n      return undefined;\n    }\n\n    if (howl.playing()) {\n      howl.stop();\n    }\n\n    if (typeof options?.volume === 'number') {\n      howl.volume(options.volume);\n    }\n\n    // Clear handlers from previous plays to avoid stale/duplicate callbacks.\n    howl.off('play');\n    howl.off('end');\n    howl.off('stop');\n    howl.off('playerror');\n\n    howl.once('play', (soundId: number) => {\n      options?.onStart?.(soundId);\n      this.emit('play', { type: 'effect', key, soundId });\n    });\n\n    howl.once('end', (soundId: number) => {\n      if (typeof options?.volume === 'number') {\n        howl.volume(1);\n      }\n      options?.onEnd?.(soundId);\n      this.emit('end', { type: 'effect', key, soundId });\n    });\n\n    howl.once('stop', (soundId: number) => {\n      if (typeof options?.volume === 'number') {\n        howl.volume(1);\n      }\n      options?.onStop?.(soundId);\n      this.emit('stop', { type: 'effect', key, soundId });\n    });\n\n    howl.once('playerror', (soundId: number, error: unknown) => {\n      options?.onError?.(soundId, error);\n      this.emit('error', { type: 'effect', key, soundId, error });\n    });\n\n    return howl.play();\n  }\n\n  stopEffect(key: K): void {\n    const howl = this.effectCache.get(key);\n    if (howl) {\n      howl.stop();\n    }\n  }\n\n  removeEffect(key: K): void {\n    const howl = this.effectCache.get(key);\n    if (howl) {\n      howl.unload();\n      this.effectCache.delete(key);\n    }\n  }\n\n  preloadUrl(url: string): Promise<void> {\n    const existing = this.urlAudioCache.get(url);\n    if (existing && existing.state() === 'loaded') {\n      return Promise.resolve();\n    }\n\n    const pending = this.preloadPromises.get(url);\n    if (pending) {\n      return pending;\n    }\n\n    // A howl in a terminal failed state (unloaded after error) must be replaced\n    // so a fresh instance can retry the load.\n    const howl = existing && existing.state() !== 'unloaded' ? existing : this.createUrlHowl(url);\n\n    const promise = new Promise<void>((resolve, reject) => {\n      howl.once('load', () => {\n        resolve();\n      });\n\n      howl.once('loaderror', (_id: number, error: unknown) => {\n        this.urlAudioCache.delete(url);\n        reject(error);\n      });\n    });\n\n    this.preloadPromises.set(url, promise);\n    const settle = () => {\n      if (this.preloadPromises.get(url) === promise) {\n        this.preloadPromises.delete(url);\n      }\n    };\n    promise.then(settle, settle);\n\n    return promise;\n  }\n\n  preloadUrls(urls: string[]): Promise<void[]> {\n    return Promise.all(urls.map((url) => this.preloadUrl(url)));\n  }\n\n  private createUrlHowl(url: string): Howl {\n    const howl = new this.HowlConstructor({\n      src: [url],\n      preload: true\n    });\n    howl.on('load', () => {\n      this.emit('load', { type: 'url', url });\n    });\n    howl.on('loaderror', (_id: number, error: unknown) => {\n      this.urlAudioCache.delete(url);\n      this.emit('error', { type: 'url', url, error });\n    });\n    this.urlAudioCache.set(url, howl);\n    return howl;\n  }\n\n  playUrl(url: string, options?: PlayUrlOptions): number {\n    const howl = this.urlAudioCache.get(url) || this.createUrlHowl(url);\n\n    // Singleton mutex: stop currently active URL audio if singleton !== false\n    const isSingleton = options?.singleton !== false;\n    if (\n      isSingleton &&\n      this.activeUrlHowl &&\n      this.activeUrlHowl !== howl &&\n      this.activeUrlHowl.playing()\n    ) {\n      this.activeUrlHowl.stop();\n    }\n\n    // Overlap prevention on the same audio instance\n    if (howl.playing()) {\n      howl.stop();\n    }\n\n    if (options?.loop !== undefined) {\n      howl.loop(options.loop);\n    }\n\n    if (typeof options?.volume === 'number') {\n      howl.volume(options.volume);\n    }\n\n    if (isSingleton) {\n      this.activeUrlHowl = howl;\n    }\n\n    // Clear handlers from previous plays to avoid stale/duplicate callbacks.\n    howl.off('play');\n    howl.off('end');\n    howl.off('stop');\n    howl.off('playerror');\n\n    howl.once('play', (soundId: number) => {\n      options?.onStart?.(soundId);\n      this.emit('play', { type: 'url', url, soundId });\n    });\n\n    howl.once('end', (soundId: number) => {\n      if (typeof options?.volume === 'number') {\n        howl.volume(1);\n      }\n      options?.onEnd?.(soundId);\n      this.emit('end', { type: 'url', url, soundId });\n      if (this.activeUrlHowl === howl && !howl.loop()) {\n        this.activeUrlHowl = null;\n      }\n    });\n\n    howl.once('stop', (soundId: number) => {\n      if (typeof options?.volume === 'number') {\n        howl.volume(1);\n      }\n      options?.onStop?.(soundId);\n      this.emit('stop', { type: 'url', url, soundId });\n      if (this.activeUrlHowl === howl) {\n        this.activeUrlHowl = null;\n      }\n    });\n\n    howl.once('playerror', (soundId: number, error: unknown) => {\n      options?.onError?.(soundId, error);\n      this.emit('error', { type: 'url', url, soundId, error });\n      if (this.activeUrlHowl === howl) {\n        this.activeUrlHowl = null;\n      }\n    });\n\n    return howl.play();\n  }\n\n  stopUrl(url: string): void {\n    const howl = this.urlAudioCache.get(url);\n    if (howl) {\n      howl.stop();\n    }\n  }\n\n  on(event: AudioEventType, handler: (payload: AudioEventPayload<K>) => void): EventSubscription {\n    const set = this.listeners.get(event) ?? new Set<(payload: AudioEventPayload<K>) => void>();\n    this.listeners.set(event, set);\n    set.add(handler);\n    return {\n      destroy: () => {\n        set.delete(handler);\n      }\n    };\n  }\n\n  protected emit(event: AudioEventType, payload: AudioEventPayload<K>): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      set.forEach((handler) => {\n        try {\n          handler(payload);\n        } catch (err) {\n          console.error(`[AudioManager] Error in event listener for ${event}:`, err);\n        }\n      });\n    }\n  }\n\n  setGlobalVolume(volume: number): void {\n    this.globalVolume = volume;\n    this.HowlerInstance.volume(volume);\n  }\n\n  mute(muted: boolean): void {\n    this.HowlerInstance.mute(muted);\n  }\n\n  stopAll(): void {\n    this.HowlerInstance.stop();\n    this.activeUrlHowl = null;\n  }\n\n  destroy(): void {\n    this.effectCache.forEach((howl) => howl.unload());\n    this.urlAudioCache.forEach((howl) => howl.unload());\n    this.effectCache.clear();\n    this.urlAudioCache.clear();\n    this.preloadPromises.clear();\n    this.listeners.clear();\n    this.activeUrlHowl = null;\n  }\n}\n"]}