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

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","../src/react.tsx"],"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","AudioManagerProvider","default","useAudio","useAudioEvent","useGlobalVolume","usePreload","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","getGlobalVolume","mute","muted","stopAll","clear","import_react","import_jsx_runtime","AudioManagerContext","createContext","manager","children","jsx","Provider","useContext","Error","handlerRef","useRef","current","useEffect","subscription","useState","setVolumeState","setVolume","useCallback","next","urlsKey","JSON","stringify","status","setState","list","parse","length","cancelled"],"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(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  AudioManagerProvider: () => AudioManagerProvider,\n  default: () => AudioManager,\n  useAudio: () => useAudio,\n  useAudioEvent: () => useAudioEvent,\n  useGlobalVolume: () => useGlobalVolume,\n  usePreload: () => usePreload\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  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\nvar import_react = require(\"react\");\nvar import_jsx_runtime = require(\"react/jsx-runtime\");\nvar AudioManagerContext = (0, import_react.createContext)(null);\nfunction AudioManagerProvider({\n  manager,\n  children\n}) {\n  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AudioManagerContext.Provider, { value: manager, children });\n}\nfunction useAudio() {\n  const manager = (0, import_react.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 = (0, import_react.useRef)(handler);\n  handlerRef.current = handler;\n  (0, import_react.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] = (0, import_react.useState)(() => manager.getGlobalVolume());\n  const setVolume = (0, import_react.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] = (0, import_react.useState)({ status: \"idle\", error: null });\n  (0, import_react.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}\n// Annotate the CommonJS export names for ESM import in node:\n0 && (module.exports = {\n  AudioManager,\n  AudioManagerProvider,\n  useAudio,\n  useAudioEvent,\n  useGlobalVolume,\n  usePreload\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';\nexport * from './react';\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"]}

package/package.json

@@ -1,6 +1,68 @@
 {
+  "description": "Howler.js audio manager, enum-driven sounds for H5.",
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^21.0.3",
+    "@jswork/style-guide": "^1.0.3",
+    "@jswork/tsup-banner": "^1.0.4",
+    "@swc/core": "^1.5.5",
+    "@testing-library/react": "^16.3.3",
+    "@types/howler": "^2.2.12",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.11",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "esbuild-plugin-replace": "^1.4.0",
+    "esbuild-plugin-umd-wrapper": "^3.0.0",
+    "howler": "^2.2.4",
+    "prettier": "^3.3.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.2.4",
+    "typescript": "^4.9.5"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "homepage": "https://js.work",
+  "keywords": [
+    "howler",
+    "audio-manager",
+    "h5-audio",
+    "sound-effects",
+    "audio-management",
+    "howlerjs",
+    "dual-caching",
+    "audio-playback",
+    "memory-leak-prevention"
+  ],
+  "license": "MIT",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
   "name": "@jswork/howler-audio-manager",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "npmClient": "pnpm",
+  "peerDependencies": {
+    "howler": "^2.2.4",
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "howler": {
+      "optional": false
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "prettier": "@jswork/style-guide/prettier",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsup",
+    "release": "release-it",
+    "test": "bun test"
+  },
+  "types": "dist/index.d.ts",
+  "version": "1.0.2"
+}

package/src/index.ts

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

package/src/manager.ts

@@ -0,0 +1,317 @@
+import { Howl, Howler } from 'howler';
+import type {
+  AudioManagerOptions,
+  PlayOptions,
+  PlayUrlOptions,
+  AudioEventType,
+  AudioEventPayload,
+  EventSubscription,
+  SoundResourceMap
+} from './types';
+
+export class AudioManager<K extends string | number = string> {
+  private effectCache = new Map<K, Howl>();
+  private urlAudioCache = new Map<string, Howl>();
+  private preloadPromises = new Map<string, Promise<void>>();
+  private activeUrlHowl: Howl | null = null;
+  private globalVolume = 1.0;
+  private listeners = new Map<AudioEventType, Set<(payload: AudioEventPayload<K>) => void>>();
+
+  private HowlConstructor: typeof Howl;
+  private HowlerInstance: typeof Howler;
+
+  constructor(
+    options?: AudioManagerOptions,
+    inject?: { HowlClass?: typeof Howl; HowlerObj?: typeof Howler }
+  ) {
+    this.HowlConstructor = inject?.HowlClass ?? Howl;
+    this.HowlerInstance = inject?.HowlerObj ?? Howler;
+    if (typeof options?.defaultVolume === 'number') {
+      this.setGlobalVolume(options.defaultVolume);
+    }
+  }
+
+  hasEffect(key: K): boolean {
+    return this.effectCache.has(key);
+  }
+
+  loadEffect(key: K, url: string): void {
+    if (this.effectCache.has(key)) {
+      this.effectCache.get(key)!.unload();
+    }
+    const howl = new this.HowlConstructor({
+      src: [url],
+      preload: true
+    });
+    howl.on('load', () => {
+      this.emit('load', { type: 'effect', key, url });
+    });
+    howl.on('loaderror', (_id: number, error: unknown) => {
+      this.emit('error', { type: 'effect', key, url, error });
+    });
+    this.effectCache.set(key, howl);
+  }
+
+  loadEffects(map: SoundResourceMap<K>): void {
+    Object.keys(map).forEach((key) => {
+      const typedKey = (isNaN(Number(key)) ? key : Number(key)) as K;
+      this.loadEffect(typedKey, map[key as any]);
+    });
+  }
+
+  playEffect(key: K, options?: PlayOptions): number | undefined {
+    const howl = this.effectCache.get(key);
+    if (!howl) {
+      console.warn(`[AudioManager] Effect not found for key: ${String(key)}.`);
+      return undefined;
+    }
+
+    if (howl.playing()) {
+      howl.stop();
+    }
+
+    if (typeof options?.volume === 'number') {
+      howl.volume(options.volume);
+    }
+
+    // Clear handlers from previous plays to avoid stale/duplicate callbacks.
+    howl.off('play');
+    howl.off('end');
+    howl.off('stop');
+    howl.off('playerror');
+
+    howl.once('play', (soundId: number) => {
+      options?.onStart?.(soundId);
+      this.emit('play', { type: 'effect', key, soundId });
+    });
+
+    howl.once('end', (soundId: number) => {
+      if (typeof options?.volume === 'number') {
+        howl.volume(1);
+      }
+      options?.onEnd?.(soundId);
+      this.emit('end', { type: 'effect', key, soundId });
+    });
+
+    howl.once('stop', (soundId: number) => {
+      if (typeof options?.volume === 'number') {
+        howl.volume(1);
+      }
+      options?.onStop?.(soundId);
+      this.emit('stop', { type: 'effect', key, soundId });
+    });
+
+    howl.once('playerror', (soundId: number, error: unknown) => {
+      options?.onError?.(soundId, error);
+      this.emit('error', { type: 'effect', key, soundId, error });
+    });
+
+    return howl.play();
+  }
+
+  stopEffect(key: K): void {
+    const howl = this.effectCache.get(key);
+    if (howl) {
+      howl.stop();
+    }
+  }
+
+  removeEffect(key: K): void {
+    const howl = this.effectCache.get(key);
+    if (howl) {
+      howl.unload();
+      this.effectCache.delete(key);
+    }
+  }
+
+  preloadUrl(url: string): Promise<void> {
+    const existing = this.urlAudioCache.get(url);
+    if (existing && existing.state() === 'loaded') {
+      return Promise.resolve();
+    }
+
+    const pending = this.preloadPromises.get(url);
+    if (pending) {
+      return pending;
+    }
+
+    // A howl in a terminal failed state (unloaded after error) must be replaced
+    // so a fresh instance can retry the load.
+    const howl = existing && existing.state() !== 'unloaded' ? existing : this.createUrlHowl(url);
+
+    const promise = new Promise<void>((resolve, reject) => {
+      howl.once('load', () => {
+        resolve();
+      });
+
+      howl.once('loaderror', (_id: number, error: unknown) => {
+        this.urlAudioCache.delete(url);
+        reject(error);
+      });
+    });
+
+    this.preloadPromises.set(url, promise);
+    const settle = () => {
+      if (this.preloadPromises.get(url) === promise) {
+        this.preloadPromises.delete(url);
+      }
+    };
+    promise.then(settle, settle);
+
+    return promise;
+  }
+
+  preloadUrls(urls: string[]): Promise<void[]> {
+    return Promise.all(urls.map((url) => this.preloadUrl(url)));
+  }
+
+  private createUrlHowl(url: string): Howl {
+    const howl = new this.HowlConstructor({
+      src: [url],
+      preload: true
+    });
+    howl.on('load', () => {
+      this.emit('load', { type: 'url', url });
+    });
+    howl.on('loaderror', (_id: number, error: unknown) => {
+      this.urlAudioCache.delete(url);
+      this.emit('error', { type: 'url', url, error });
+    });
+    this.urlAudioCache.set(url, howl);
+    return howl;
+  }
+
+  playUrl(url: string, options?: PlayUrlOptions): number {
+    const howl = this.urlAudioCache.get(url) || this.createUrlHowl(url);
+
+    // Singleton mutex: stop currently active URL audio if singleton !== false
+    const isSingleton = options?.singleton !== false;
+    if (
+      isSingleton &&
+      this.activeUrlHowl &&
+      this.activeUrlHowl !== howl &&
+      this.activeUrlHowl.playing()
+    ) {
+      this.activeUrlHowl.stop();
+    }
+
+    // Overlap prevention on the same audio instance
+    if (howl.playing()) {
+      howl.stop();
+    }
+
+    if (options?.loop !== undefined) {
+      howl.loop(options.loop);
+    }
+
+    if (typeof options?.volume === 'number') {
+      howl.volume(options.volume);
+    }
+
+    if (isSingleton) {
+      this.activeUrlHowl = howl;
+    }
+
+    // Clear handlers from previous plays to avoid stale/duplicate callbacks.
+    howl.off('play');
+    howl.off('end');
+    howl.off('stop');
+    howl.off('playerror');
+
+    howl.once('play', (soundId: number) => {
+      options?.onStart?.(soundId);
+      this.emit('play', { type: 'url', url, soundId });
+    });
+
+    howl.once('end', (soundId: number) => {
+      if (typeof options?.volume === 'number') {
+        howl.volume(1);
+      }
+      options?.onEnd?.(soundId);
+      this.emit('end', { type: 'url', url, soundId });
+      if (this.activeUrlHowl === howl && !howl.loop()) {
+        this.activeUrlHowl = null;
+      }
+    });
+
+    howl.once('stop', (soundId: number) => {
+      if (typeof options?.volume === 'number') {
+        howl.volume(1);
+      }
+      options?.onStop?.(soundId);
+      this.emit('stop', { type: 'url', url, soundId });
+      if (this.activeUrlHowl === howl) {
+        this.activeUrlHowl = null;
+      }
+    });
+
+    howl.once('playerror', (soundId: number, error: unknown) => {
+      options?.onError?.(soundId, error);
+      this.emit('error', { type: 'url', url, soundId, error });
+      if (this.activeUrlHowl === howl) {
+        this.activeUrlHowl = null;
+      }
+    });
+
+    return howl.play();
+  }
+
+  stopUrl(url: string): void {
+    const howl = this.urlAudioCache.get(url);
+    if (howl) {
+      howl.stop();
+    }
+  }
+
+  on(event: AudioEventType, handler: (payload: AudioEventPayload<K>) => void): EventSubscription {
+    const set = this.listeners.get(event) ?? new Set<(payload: AudioEventPayload<K>) => void>();
+    this.listeners.set(event, set);
+    set.add(handler);
+    return {
+      destroy: () => {
+        set.delete(handler);
+      }
+    };
+  }
+
+  protected emit(event: AudioEventType, payload: AudioEventPayload<K>): void {
+    const set = this.listeners.get(event);
+    if (set) {
+      set.forEach((handler) => {
+        try {
+          handler(payload);
+        } catch (err) {
+          console.error(`[AudioManager] Error in event listener for ${event}:`, err);
+        }
+      });
+    }
+  }
+
+  getGlobalVolume(): number {
+    return this.globalVolume;
+  }
+
+  setGlobalVolume(volume: number): void {
+    this.globalVolume = volume;
+    this.HowlerInstance.volume(volume);
+  }
+
+  mute(muted: boolean): void {
+    this.HowlerInstance.mute(muted);
+  }
+
+  stopAll(): void {
+    this.HowlerInstance.stop();
+    this.activeUrlHowl = null;
+  }
+
+  destroy(): void {
+    this.effectCache.forEach((howl) => howl.unload());
+    this.urlAudioCache.forEach((howl) => howl.unload());
+    this.effectCache.clear();
+    this.urlAudioCache.clear();
+    this.preloadPromises.clear();
+    this.listeners.clear();
+    this.activeUrlHowl = null;
+  }
+}

package/src/react.tsx

@@ -0,0 +1,98 @@
+import { createContext, useCallback, useContext, useEffect, useRef, useState } from 'react';
+import type { ReactNode } from 'react';
+import { AudioManager } from './manager';
+import type { AudioEventType, AudioEventPayload } from './types';
+
+const AudioManagerContext = createContext<AudioManager<any> | null>(null);
+
+export interface AudioManagerProviderProps<K extends string | number = string> {
+  manager: AudioManager<K>;
+  children?: ReactNode;
+}
+
+export function AudioManagerProvider<K extends string | number = string>({
+  manager,
+  children
+}: AudioManagerProviderProps<K>) {
+  return (
+    <AudioManagerContext.Provider value={manager}>
+      {children}
+    </AudioManagerContext.Provider>
+  );
+}
+
+export function useAudio<K extends string | number = string>(): AudioManager<K> {
+  const manager = useContext(AudioManagerContext);
+  if (!manager) {
+    throw new Error('useAudio must be used within an <AudioManagerProvider>.');
+  }
+  return manager as unknown as AudioManager<K>;
+}
+
+export function useAudioEvent<K extends string | number = string>(
+  event: AudioEventType,
+  handler: (payload: AudioEventPayload<K>) => void
+): void {
+  const manager = useAudio<K>();
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+
+  useEffect(() => {
+    const subscription = manager.on(event, (payload) => handlerRef.current(payload));
+    return () => subscription.destroy();
+  }, [manager, event]);
+}
+
+export function useGlobalVolume(): [number, (volume: number) => void] {
+  const manager = useAudio();
+  const [volume, setVolumeState] = useState(() => manager.getGlobalVolume());
+
+  const setVolume = useCallback(
+    (next: number) => {
+      manager.setGlobalVolume(next);
+      setVolumeState(next);
+    },
+    [manager]
+  );
+
+  return [volume, setVolume];
+}
+
+export interface PreloadState {
+  status: 'idle' | 'loading' | 'loaded' | 'error';
+  error: unknown;
+}
+
+export function usePreload(urls: string[]): PreloadState {
+  const manager = useAudio();
+  const urlsKey = JSON.stringify(urls);
+  const [state, setState] = useState<PreloadState>({ status: 'idle', error: null });
+
+  useEffect(() => {
+    const list: string[] = JSON.parse(urlsKey);
+    if (list.length === 0) {
+      setState({ status: 'idle', error: null });
+      return;
+    }
+
+    let cancelled = false;
+    setState({ status: 'loading', error: null });
+
+    manager.preloadUrls(list).then(
+      () => {
+        if (!cancelled) setState({ status: 'loaded', error: null });
+      },
+      (error) => {
+        if (!cancelled) setState({ status: 'error', error });
+      }
+    );
+
+    return () => {
+      cancelled = true;
+    };
+  }, [manager, urlsKey]);
+
+  return state;
+}
+
+

package/src/types.ts

@@ -0,0 +1,40 @@
+export interface AudioManagerOptions {
+  /** Default global volume (0.0 to 1.0), defaults to 1.0 */
+  defaultVolume?: number;
+}
+
+export 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;
+}
+
+export 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;
+}
+
+export type AudioEventType = 'play' | 'end' | 'stop' | 'pause' | 'error' | 'load';
+
+export interface AudioEventPayload<K = string> {
+  type: 'effect' | 'url';
+  key?: K;
+  url?: string;
+  soundId?: number;
+  error?: unknown;
+}
+
+export interface EventSubscription {
+  destroy: () => void;
+}
+
+export type SoundResourceMap<K extends string | number> = Record<K, string>;