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

package/dist/index.umd.js

@@ -0,0 +1,485 @@
+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 _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+/*!
+ * 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
+ */ (function(g, f) {
+    if ((typeof exports === "undefined" ? "undefined" : _type_of(exports)) == "object" && (typeof module === "undefined" ? "undefined" : _type_of(module)) < "u") {
+        module.exports = f();
+    } else if ("function" == typeof define && define.amd) {
+        define("urlLiteral", f);
+    } else {
+        g["urlLiteral"] = f();
+    }
+})((typeof globalThis === "undefined" ? "undefined" : _type_of(globalThis)) < "u" ? globalThis : (typeof self === "undefined" ? "undefined" : _type_of(self)) < "u" ? self : this, function() {
+    var exports1 = {};
+    var __exports = exports1;
+    var module1 = {
+        exports: exports1
+    };
+    "use strict";
+    var __defProp = Object.defineProperty;
+    var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+    var __getOwnPropNames = Object.getOwnPropertyNames;
+    var __hasOwnProp = Object.prototype.hasOwnProperty;
+    var __export = function __export(target, all) {
+        for(var name in all)__defProp(target, name, {
+            get: all[name],
+            enumerable: true
+        });
+    };
+    var __copyProps = function __copyProps(to, from, except, desc) {
+        if (from && (typeof from === "undefined" ? "undefined" : _type_of(from)) === "object" || typeof from === "function") {
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                var _loop = function() {
+                    var key = _step.value;
+                    if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+                        get: function get() {
+                            return from[key];
+                        },
+                        enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+                    });
+                };
+                for(var _iterator = __getOwnPropNames(from)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true)_loop();
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+        }
+        return to;
+    };
+    var __toCommonJS = function __toCommonJS(mod) {
+        return __copyProps(__defProp({}, "__esModule", {
+            value: true
+        }), mod);
+    };
+    // src/index.ts
+    var index_exports = {};
+    __export(index_exports, {
+        AudioManager: function AudioManager1() {
+            return AudioManager;
+        },
+        default: function _default() {
+            return AudioManager;
+        }
+    });
+    module1.exports = __toCommonJS(index_exports);
+    // src/manager.ts
+    var import_howler = require("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 : import_howler.Howl;
+            this.HowlerInstance = (_ref1 = inject === null || inject === void 0 ? void 0 : inject.HowlerObj) !== null && _ref1 !== void 0 ? _ref1 : import_howler.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;
+    }();
+    // Annotate the CommonJS export names for ESM import in node:
+    0 && (module1.exports = {
+        AudioManager: AudioManager
+    });
+    if (__exports != exports1) module1.exports = exports1;
+    return module1.exports;
+});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/afei/github/howler-audio-manager/dist/index.umd.js","../src/index.ts","../src/manager.ts"],"names":["g","f","exports","module","define","amd","globalThis","self","__exports","__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__toCommonJS","mod","value","index_exports","AudioManager","default","import_howler","require","options","inject","effectCache","Map","urlAudioCache","preloadPromises","activeUrlHowl","globalVolume","listeners","HowlConstructor","HowlClass","Howl","HowlerInstance","HowlerObj","Howler","defaultVolume","setGlobalVolume","hasEffect","has","loadEffect","url","unload","howl","src","preload","on","emit","type","_id","error","set","loadEffects","map","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","playUrl","isSingleton","singleton","loop","stopUrl","event","handler","Set","add","destroy","payload","err","mute","muted","stopAll","clear"],"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(function(g,f){if(typeof exports==\"object\"&&typeof module<\"u\"){module.exports=f()}else if(\"function\"==typeof define && define.amd){define(\"urlLiteral\",f)}else {g[\"urlLiteral\"]=f()}}(typeof globalThis < \"u\" ? globalThis : typeof self < \"u\" ? self : this,function(){var exports={};var __exports=exports;var module={exports};\n\"use strict\";\nvar __defProp = Object.defineProperty;\nvar __getOwnPropDesc = Object.getOwnPropertyDescriptor;\nvar __getOwnPropNames = Object.getOwnPropertyNames;\nvar __hasOwnProp = Object.prototype.hasOwnProperty;\nvar __export = (target, all) => {\n  for (var name in all)\n    __defProp(target, name, { get: all[name], enumerable: true });\n};\nvar __copyProps = (to, from, except, desc) => {\n  if (from && typeof from === \"object\" || typeof from === \"function\") {\n    for (let key of __getOwnPropNames(from))\n      if (!__hasOwnProp.call(to, key) && key !== except)\n        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });\n  }\n  return to;\n};\nvar __toCommonJS = (mod) => __copyProps(__defProp({}, \"__esModule\", { value: true }), mod);\n\n// src/index.ts\nvar index_exports = {};\n__export(index_exports, {\n  AudioManager: () => AudioManager,\n  default: () => AudioManager\n});\nmodule.exports = __toCommonJS(index_exports);\n\n// src/manager.ts\nvar import_howler = require(\"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 ?? import_howler.Howl;\n    this.HowlerInstance = inject?.HowlerObj ?? import_howler.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};\n// Annotate the CommonJS export names for ESM import in node:\n0 && (module.exports = {\n  AudioManager\n});\n\nif(__exports != exports)module.exports = exports;return module.exports}));\n","export * from './types';\nexport { AudioManager } from './manager';\nexport { AudioManager as default } from './manager';\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"]}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@jswork/howler-audio-manager",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Howler.js audio manager, enum-driven sounds for H5.",
+  "npmClient": "pnpm",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "src",
+    "dist"
+  ],
+  "prettier": "@jswork/style-guide/prettier",
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "release": "release-it"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "howler": "^2.2.4"
+  },
+  "peerDependenciesMeta": {
+    "howler": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@jswork/style-guide": "^1.0.3",
+    "@jswork/tsup-banner": "^1.0.4",
+    "@swc/core": "^1.5.5",
+    "@types/howler": "^2.2.12",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.11",
+    "esbuild-plugin-replace": "^1.4.0",
+    "esbuild-plugin-umd-wrapper": "^3.0.0",
+    "howler": "^2.2.4",
+    "prettier": "^3.3.3",
+    "tsup": "^8.2.4",
+    "typescript": "^4.9.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "homepage": "https://js.work",
+  "keywords": [
+    "howler",
+    "audio-manager",
+    "h5-audio",
+    "sound-effects"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export { AudioManager } from './manager';
+export { AudioManager as default } from './manager';