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

package/dist/index.esm.js

@@ -0,0 +1,546 @@
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+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;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+/*!
+ * name: @jswork/howler-audio-manager
+ * description: Howler.js audio manager, enum-driven sounds for H5.
+ * homepage: https://js.work
+ * version: 1.0.2
+ * date: 2026-10-20 20:03: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: "getGlobalVolume",
+            value: function getGlobalVolume() {
+                return this.globalVolume;
+            }
+        },
+        {
+            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;
+}();
+// src/react.tsx
+import { createContext, useCallback, useContext, useEffect, useRef, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+var AudioManagerContext = createContext(null);
+function AudioManagerProvider(param) {
+    var manager = param.manager, children = param.children;
+    return /* @__PURE__ */ jsx(AudioManagerContext.Provider, {
+        value: manager,
+        children: children
+    });
+}
+function useAudio() {
+    var manager = useContext(AudioManagerContext);
+    if (!manager) {
+        throw new Error("useAudio must be used within an <AudioManagerProvider>.");
+    }
+    return manager;
+}
+function useAudioEvent(event, handler) {
+    var manager = useAudio();
+    var handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(function() {
+        var subscription = manager.on(event, function(payload) {
+            return handlerRef.current(payload);
+        });
+        return function() {
+            return subscription.destroy();
+        };
+    }, [
+        manager,
+        event
+    ]);
+}
+function useGlobalVolume() {
+    var manager = useAudio();
+    var _useState = _sliced_to_array(useState(function() {
+        return manager.getGlobalVolume();
+    }), 2), volume = _useState[0], setVolumeState = _useState[1];
+    var setVolume = useCallback(function(next) {
+        manager.setGlobalVolume(next);
+        setVolumeState(next);
+    }, [
+        manager
+    ]);
+    return [
+        volume,
+        setVolume
+    ];
+}
+function usePreload(urls) {
+    var manager = useAudio();
+    var urlsKey = JSON.stringify(urls);
+    var _useState = _sliced_to_array(useState({
+        status: "idle",
+        error: null
+    }), 2), state = _useState[0], setState = _useState[1];
+    useEffect(function() {
+        var list = JSON.parse(urlsKey);
+        if (list.length === 0) {
+            setState({
+                status: "idle",
+                error: null
+            });
+            return;
+        }
+        var cancelled = false;
+        setState({
+            status: "loading",
+            error: null
+        });
+        manager.preloadUrls(list).then(function() {
+            if (!cancelled) setState({
+                status: "loaded",
+                error: null
+            });
+        }, function(error) {
+            if (!cancelled) setState({
+                status: "error",
+                error: error
+            });
+        });
+        return function() {
+            cancelled = true;
+        };
+    }, [
+        manager,
+        urlsKey
+    ]);
+    return state;
+}
+export { AudioManager, AudioManagerProvider, AudioManager as default, useAudio, useAudioEvent, useGlobalVolume, usePreload };
+//# 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","../src/react.tsx"],"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","getGlobalVolume","mute","muted","stopAll","clear","createContext","useCallback","useContext","useEffect","useRef","useState","jsx","AudioManagerContext","AudioManagerProvider","manager","children","Provider","value","useAudio","Error","useAudioEvent","handlerRef","current","subscription","useGlobalVolume","setVolumeState","setVolume","next","usePreload","urlsKey","JSON","stringify","status","setState","list","parse","length","cancelled","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.2\n * date: 2026-10-20 20:03: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  getGlobalVolume() {\n    return this.globalVolume;\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};\n\n// src/react.tsx\nimport { createContext, useCallback, useContext, useEffect, useRef, useState } from \"react\";\nimport { jsx } from \"react/jsx-runtime\";\nvar AudioManagerContext = createContext(null);\nfunction AudioManagerProvider({\n  manager,\n  children\n}) {\n  return /* @__PURE__ */ jsx(AudioManagerContext.Provider, { value: manager, children });\n}\nfunction useAudio() {\n  const manager = useContext(AudioManagerContext);\n  if (!manager) {\n    throw new Error(\"useAudio must be used within an <AudioManagerProvider>.\");\n  }\n  return manager;\n}\nfunction useAudioEvent(event, handler) {\n  const manager = useAudio();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n  useEffect(() => {\n    const subscription = manager.on(event, (payload) => handlerRef.current(payload));\n    return () => subscription.destroy();\n  }, [manager, event]);\n}\nfunction useGlobalVolume() {\n  const manager = useAudio();\n  const [volume, setVolumeState] = useState(() => manager.getGlobalVolume());\n  const setVolume = useCallback(\n    (next) => {\n      manager.setGlobalVolume(next);\n      setVolumeState(next);\n    },\n    [manager]\n  );\n  return [volume, setVolume];\n}\nfunction usePreload(urls) {\n  const manager = useAudio();\n  const urlsKey = JSON.stringify(urls);\n  const [state, setState] = useState({ status: \"idle\", error: null });\n  useEffect(() => {\n    const list = JSON.parse(urlsKey);\n    if (list.length === 0) {\n      setState({ status: \"idle\", error: null });\n      return;\n    }\n    let cancelled = false;\n    setState({ status: \"loading\", error: null });\n    manager.preloadUrls(list).then(\n      () => {\n        if (!cancelled) setState({ status: \"loaded\", error: null });\n      },\n      (error) => {\n        if (!cancelled) setState({ status: \"error\", error });\n      }\n    );\n    return () => {\n      cancelled = true;\n    };\n  }, [manager, urlsKey]);\n  return state;\n}\nexport {\n  AudioManager,\n  AudioManagerProvider,\n  AudioManager as default,\n  useAudio,\n  useAudioEvent,\n  useGlobalVolume,\n  usePreload\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  getGlobalVolume(): number {\n    return this.globalVolume;\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","import { createContext, useCallback, useContext, useEffect, useRef, useState } from 'react';\nimport type { ReactNode } from 'react';\nimport { AudioManager } from './manager';\nimport type { AudioEventType, AudioEventPayload } from './types';\n\nconst AudioManagerContext = createContext<AudioManager<any> | null>(null);\n\nexport interface AudioManagerProviderProps<K extends string | number = string> {\n  manager: AudioManager<K>;\n  children?: ReactNode;\n}\n\nexport function AudioManagerProvider<K extends string | number = string>({\n  manager,\n  children\n}: AudioManagerProviderProps<K>) {\n  return (\n    <AudioManagerContext.Provider value={manager}>\n      {children}\n    </AudioManagerContext.Provider>\n  );\n}\n\nexport function useAudio<K extends string | number = string>(): AudioManager<K> {\n  const manager = useContext(AudioManagerContext);\n  if (!manager) {\n    throw new Error('useAudio must be used within an <AudioManagerProvider>.');\n  }\n  return manager as unknown as AudioManager<K>;\n}\n\nexport function useAudioEvent<K extends string | number = string>(\n  event: AudioEventType,\n  handler: (payload: AudioEventPayload<K>) => void\n): void {\n  const manager = useAudio<K>();\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  useEffect(() => {\n    const subscription = manager.on(event, (payload) => handlerRef.current(payload));\n    return () => subscription.destroy();\n  }, [manager, event]);\n}\n\nexport function useGlobalVolume(): [number, (volume: number) => void] {\n  const manager = useAudio();\n  const [volume, setVolumeState] = useState(() => manager.getGlobalVolume());\n\n  const setVolume = useCallback(\n    (next: number) => {\n      manager.setGlobalVolume(next);\n      setVolumeState(next);\n    },\n    [manager]\n  );\n\n  return [volume, setVolume];\n}\n\nexport interface PreloadState {\n  status: 'idle' | 'loading' | 'loaded' | 'error';\n  error: unknown;\n}\n\nexport function usePreload(urls: string[]): PreloadState {\n  const manager = useAudio();\n  const urlsKey = JSON.stringify(urls);\n  const [state, setState] = useState<PreloadState>({ status: 'idle', error: null });\n\n  useEffect(() => {\n    const list: string[] = JSON.parse(urlsKey);\n    if (list.length === 0) {\n      setState({ status: 'idle', error: null });\n      return;\n    }\n\n    let cancelled = false;\n    setState({ status: 'loading', error: null });\n\n    manager.preloadUrls(list).then(\n      () => {\n        if (!cancelled) setState({ status: 'loaded', error: null });\n      },\n      (error) => {\n        if (!cancelled) setState({ status: 'error', error });\n      }\n    );\n\n    return () => {\n      cancelled = true;\n    };\n  }, [manager, urlsKey]);\n\n  return state;\n}\n\n\n"]}