@juandinella/audio-bands 0.5.0 → 0.6.2

package/README.md

@@ -25,6 +25,8 @@ The intended center of the API is `snapshot()`: one call, one coherent analysis
 npm install @juandinella/audio-bands
 ```
 
+For repository development, `npm test` covers the mocked unit suite and `npm run test:browser` runs a small browser smoke test against the built bundles.
+
 ### Entry points
 
 - `@juandinella/audio-bands`: main framework-agnostic export
@@ -33,6 +35,8 @@ npm install @juandinella/audio-bands
 
 If you use the React hook, install `react` as well.
 
+Minimal reference examples live in [`examples/README.md`](./examples/README.md). The Vite app in `examples/src/App.tsx` is a showcase demo, while `examples/snippets/` contains the smallest copyable integrations.
+
 ## Usage
 
 ### Vanilla JS
@@ -192,7 +196,7 @@ new AudioBands(options?: AudioBandsOptions)
 
 | Method                  | Description |
 | ----------------------- | ----------- |
-| `load(url)`             | Load a track and connect it to the analyser. Rejects with `AudioBandsError` on failure. |
+| `load(url)`             | Load a track, connect it to the analyser, and resolve when the media is ready. Rejects with `AudioBandsError` on load failure. |
 | `play()`                | Start playback for the current track. Rejects with `AudioBandsError` on failure. |
 | `pause()`               | Pause the current track. |
 | `setLoop(loop)`         | Set whether the current and future loaded tracks should loop. |
@@ -285,9 +289,10 @@ type AudioBandsState = {
 ## Notes
 
 - `AudioContext` is created lazily on the first call to `load()` or `enableMic()`.
-- `load()` prepares the current track but does not start playback. Call `play()` or `togglePlayPause()` after loading.
+- `load()` prepares the current track but does not start playback. It resolves only after the media is ready enough for duration/seek reads to be meaningful, then you can call `play()` or `togglePlayPause()`.
 - `togglePlayPause()` follows the same playback error contract as `play()`: if toggling into play fails, the returned promise rejects.
-- `hasTrack` means a track source is currently assigned to the instance. It can still be `true` if `play()` fails due to autoplay policy or another playback error.
+- `hasTrack` means the current track finished loading and is ready on the instance. It can still be `true` if `play()` fails later due to autoplay policy or another playback error.
+- `isPlaying` follows the underlying media element events, so it falls back to `false` when the track pauses or reaches `ended`.
 - `loadError` stores track loading failures only.
 - `playbackError` stores playback failures for the current track, such as autoplay-policy rejections.
 - In the React hook, changing `music`, `mic`, `bandRanges`, or `customBands` recreates the underlying `AudioBands` instance.
@@ -300,6 +305,11 @@ type AudioBandsState = {
 - The default `bass` / `mid` / `high` labels are convenience names for analyser regions, not fixed Hz buckets.
 - `overall` is intended as a simple UI summary, not as an acoustically weighted loudness value.
 
+## Development
+
+- `npm test` builds the package and runs the unit suite.
+- Releases are published from GitHub Actions when a `v*` tag is pushed.
+
 ## License
 
 MIT

package/dist/{chunk-BA6JOXL4.js → chunk-EGVVFGLZ.js}

@@ -128,6 +128,9 @@ var AudioBands = class {
     this.musicSource = null;
     this.micSource = null;
     this.micStream = null;
+    this.musicEventCleanup = null;
+    this.pendingLoadCleanup = null;
+    this.pendingLoadReject = null;
     this.trackLoop = false;
     this.destroyed = false;
     this.options = options;
@@ -154,21 +157,50 @@ var AudioBands = class {
     this.teardownMusic();
     const audio = new Audio();
     audio.crossOrigin = "anonymous";
+    audio.preload = "auto";
     audio.src = url;
     audio.loop = this.trackLoop;
+    this.bindMusicElementEvents(audio);
     this.audioEl = audio;
-    this.setState({ hasTrack: true, loadError: null, playbackError: null });
+    this.setState({ hasTrack: false, loadError: null, playbackError: null });
     const source = ctx.createMediaElementSource(audio);
     source.connect(this.musicAnalyser);
     this.musicSource = source;
+    await new Promise((resolve, reject) => {
+      const finalize = () => {
+        cleanup();
+        this.pendingLoadCleanup = null;
+        this.pendingLoadReject = null;
+      };
+      const handleReady = () => {
+        finalize();
+        this.setState({ hasTrack: true, loadError: null });
+        resolve();
+      };
+      const handleFailure = (event) => {
+        finalize();
+        const mediaError = event?.target?.error ?? audio.error ?? event;
+        reject(this.handleLoadFailure(mediaError));
+      };
+      const cleanup = () => {
+        audio.removeEventListener("loadedmetadata", handleReady);
+        audio.removeEventListener("canplay", handleReady);
+        audio.removeEventListener("error", handleFailure);
+      };
+      this.pendingLoadCleanup = cleanup;
+      this.pendingLoadReject = reject;
+      audio.addEventListener("loadedmetadata", handleReady, { once: true });
+      audio.addEventListener("canplay", handleReady, { once: true });
+      audio.addEventListener("error", handleFailure, { once: true });
+      audio.load();
+    });
   }
   async play() {
     const audio = this.audioEl;
     if (!audio) return;
     try {
       await audio.play();
-      this.setState({ isPlaying: true, playbackError: null });
-      this.options.onPlay?.();
+      this.setState({ playbackError: null });
     } catch (error) {
       throw this.handleError("playback", error, "playback_error");
     }
@@ -177,8 +209,6 @@ var AudioBands = class {
     const audio = this.audioEl;
     if (!audio || audio.paused) return;
     audio.pause();
-    this.setState({ isPlaying: false });
-    this.options.onPause?.();
   }
   async togglePlayPause() {
     const audio = this.audioEl;
@@ -367,6 +397,36 @@ var AudioBands = class {
     this.options.onError?.(wrapped);
     return wrapped;
   }
+  bindMusicElementEvents(audio) {
+    this.musicEventCleanup?.();
+    const handlePlay = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: true, playbackError: null });
+      this.options.onPlay?.();
+    };
+    const handlePause = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: false });
+      this.options.onPause?.();
+    };
+    const handleEnded = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: false });
+    };
+    audio.addEventListener("play", handlePlay);
+    audio.addEventListener("pause", handlePause);
+    audio.addEventListener("ended", handleEnded);
+    this.musicEventCleanup = () => {
+      audio.removeEventListener("play", handlePlay);
+      audio.removeEventListener("pause", handlePause);
+      audio.removeEventListener("ended", handleEnded);
+      if (this.musicEventCleanup) this.musicEventCleanup = null;
+    };
+  }
+  handleLoadFailure(error) {
+    this.teardownMusic();
+    return this.handleError("load", error, "load_error");
+  }
   setState(patch) {
     let changed = false;
     for (const [key, value] of Object.entries(patch)) {
@@ -378,6 +438,23 @@ var AudioBands = class {
     if (changed) this.options.onStateChange?.(this.getState());
   }
   teardownMusic() {
+    this.musicEventCleanup?.();
+    if (this.pendingLoadReject) {
+      const reject = this.pendingLoadReject;
+      this.pendingLoadReject = null;
+      this.pendingLoadCleanup?.();
+      this.pendingLoadCleanup = null;
+      reject(
+        new AudioBandsError(
+          "load",
+          "load_error",
+          "Audio track loading was interrupted before completion"
+        )
+      );
+    } else if (this.pendingLoadCleanup) {
+      this.pendingLoadCleanup();
+      this.pendingLoadCleanup = null;
+    }
     this.audioEl?.pause();
     if (this.audioEl) {
       this.audioEl.src = "";
@@ -402,4 +479,4 @@ export {
   AudioBandsError,
   AudioBands
 };
-//# sourceMappingURL=chunk-BA6JOXL4.js.map
+//# sourceMappingURL=chunk-EGVVFGLZ.js.map

package/dist/chunk-EGVVFGLZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/core.ts"],"sourcesContent":["import type { AudioBandsErrorCode, AudioBandsErrorKind } from './types';\n\nexport class AudioBandsError extends Error {\n  readonly kind: AudioBandsErrorKind;\n  readonly code: AudioBandsErrorCode;\n  readonly cause?: unknown;\n\n  constructor(\n    kind: AudioBandsErrorKind,\n    code: AudioBandsErrorCode,\n    message: string,\n    cause?: unknown,\n  ) {\n    super(message);\n    this.name = 'AudioBandsError';\n    this.kind = kind;\n    this.code = code;\n    this.cause = cause;\n  }\n}\n","import { AudioBandsError } from './errors';\nimport type {\n  AudioAnalyserConfig,\n  AudioBandsOptions,\n  AudioBandsSnapshot,\n  AudioBandsState,\n  AudioSource,\n  BandRange,\n  Bands,\n  ClassicBandRanges,\n  CustomBandRanges,\n} from './types';\n\nconst DEFAULT_MUSIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.85,\n};\n\nconst DEFAULT_MIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.8,\n};\n\nconst DEFAULT_CLASSIC_RANGES: Record<keyof Omit<Bands, 'overall'>, BandRange> = {\n  bass: { from: 0, to: 0.08 },\n  mid: { from: 0.08, to: 0.4 },\n  high: { from: 0.4, to: 1 },\n};\n\nconst ZERO: Bands = { bass: 0, mid: 0, high: 0, overall: 0 };\n\nfunction avg(arr: Uint8Array<ArrayBuffer>, from: number, to: number): number {\n  let sum = 0;\n  for (let i = from; i < to; i++) sum += arr[i];\n  return sum / (to - from);\n}\n\nfunction isPowerOfTwo(value: number): boolean {\n  return (value & (value - 1)) === 0;\n}\n\nfunction normalizeAnalyserConfig(\n  config: AudioAnalyserConfig | undefined,\n  fallback: Required<AudioAnalyserConfig>,\n): Required<AudioAnalyserConfig> {\n  const fftSize = config?.fftSize ?? fallback.fftSize;\n  const smoothingTimeConstant =\n    config?.smoothingTimeConstant ?? fallback.smoothingTimeConstant;\n\n  if (\n    !Number.isInteger(fftSize) ||\n    fftSize < 32 ||\n    fftSize > 32768 ||\n    !isPowerOfTwo(fftSize)\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'fftSize must be a power of two between 32 and 32768',\n    );\n  }\n\n  if (\n    typeof smoothingTimeConstant !== 'number' ||\n    smoothingTimeConstant < 0 ||\n    smoothingTimeConstant > 1\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'smoothingTimeConstant must be between 0 and 1',\n    );\n  }\n\n  return { fftSize, smoothingTimeConstant };\n}\n\nfunction normalizeRange(name: string, range: BandRange | undefined): BandRange {\n  const normalized = range ?? DEFAULT_CLASSIC_RANGES[name as keyof typeof DEFAULT_CLASSIC_RANGES];\n\n  if (\n    typeof normalized?.from !== 'number' ||\n    typeof normalized?.to !== 'number' ||\n    normalized.from < 0 ||\n    normalized.to > 1 ||\n    normalized.from >= normalized.to\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      `Band range \"${name}\" must satisfy 0 <= from < to <= 1`,\n    );\n  }\n\n  return normalized;\n}\n\nfunction normalizeClassicRanges(\n  ranges: ClassicBandRanges | undefined,\n): Record<keyof Omit<Bands, 'overall'>, BandRange> {\n  return {\n    bass: normalizeRange('bass', ranges?.bass),\n    mid: normalizeRange('mid', ranges?.mid),\n    high: normalizeRange('high', ranges?.high),\n  };\n}\n\nfunction normalizeCustomBands(customBands: CustomBandRanges | undefined): CustomBandRanges {\n  if (!customBands) return {};\n\n  return Object.fromEntries(\n    Object.entries(customBands).map(([name, range]) => [name, normalizeRange(name, range)]),\n  );\n}\n\nfunction getIndexes(len: number, range: BandRange): [number, number] {\n  const from = Math.max(0, Math.min(len - 1, Math.floor(len * range.from)));\n  const to = Math.max(from + 1, Math.min(len, Math.floor(len * range.to)));\n  return [from, to];\n}\n\nfunction getRangeValue(data: Uint8Array<ArrayBuffer>, range: BandRange): number {\n  const [from, to] = getIndexes(data.length, range);\n  return avg(data, from, to) / 255;\n}\n\nfunction fillFrequencyData(\n  analyser: AnalyserNode,\n  data: Uint8Array<ArrayBuffer>,\n): Uint8Array<ArrayBuffer> {\n  analyser.getByteFrequencyData(data);\n  return data;\n}\n\nfunction computeBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: Record<keyof Omit<Bands, 'overall'>, BandRange>,\n): Bands {\n  const bass = getRangeValue(data, ranges.bass);\n  const mid = getRangeValue(data, ranges.mid);\n  const high = getRangeValue(data, ranges.high);\n\n  return {\n    bass,\n    mid,\n    high,\n    overall: bass * 0.5 + mid * 0.3 + high * 0.2,\n  };\n}\n\nfunction computeCustomBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: CustomBandRanges,\n): Record<string, number> {\n  return Object.fromEntries(\n    Object.entries(ranges).map(([name, range]) => [name, getRangeValue(data, range)]),\n  );\n}\n\nfunction cloneState(state: AudioBandsState): AudioBandsState {\n  return { ...state };\n}\n\n/**\n * Vanilla JS class — no framework dependency.\n * Works in React, Vue, Svelte, or plain HTML.\n */\nexport class AudioBands {\n  private options: AudioBandsOptions;\n  private readonly musicConfig: Required<AudioAnalyserConfig>;\n  private readonly micConfig: Required<AudioAnalyserConfig>;\n  private readonly classicRanges: Record<keyof Omit<Bands, 'overall'>, BandRange>;\n  private readonly customBandRanges: CustomBandRanges;\n\n  private readonly state: AudioBandsState = {\n    isPlaying: false,\n    micActive: false,\n    hasTrack: false,\n    loadError: null,\n    playbackError: null,\n    micError: null,\n  };\n\n  private ctx: AudioContext | null = null;\n  private musicAnalyser: AnalyserNode | null = null;\n  private musicData: Uint8Array<ArrayBuffer> | null = null;\n  private musicWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private micAnalyser: AnalyserNode | null = null;\n  private micData: Uint8Array<ArrayBuffer> | null = null;\n  private micWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private audioEl: HTMLAudioElement | null = null;\n  private musicSource: MediaElementAudioSourceNode | null = null;\n  private micSource: MediaStreamAudioSourceNode | null = null;\n  private micStream: MediaStream | null = null;\n  private musicEventCleanup: (() => void) | null = null;\n  private pendingLoadCleanup: (() => void) | null = null;\n  private pendingLoadReject: ((error: AudioBandsError) => void) | null = null;\n  private trackLoop = false;\n  private destroyed = false;\n\n  constructor(options: AudioBandsOptions = {}) {\n    this.options = options;\n    this.musicConfig = normalizeAnalyserConfig(options.music, DEFAULT_MUSIC_ANALYSER);\n    this.micConfig = normalizeAnalyserConfig(options.mic, DEFAULT_MIC_ANALYSER);\n    this.classicRanges = normalizeClassicRanges(options.bandRanges);\n    this.customBandRanges = normalizeCustomBands(options.customBands);\n  }\n\n  getState(): AudioBandsState {\n    return cloneState(this.state);\n  }\n\n  getCustomBands(source: AudioSource = 'music'): Record<string, number> {\n    const data = this.readFrequencyData(source);\n    if (!data) return computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges);\n    return computeCustomBands(data, this.customBandRanges);\n  }\n\n  async load(url: string): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('load', error, 'load_error');\n    }\n\n    this.teardownMusic();\n\n    const audio = new Audio();\n    audio.crossOrigin = 'anonymous';\n    audio.preload = 'auto';\n    audio.src = url;\n    audio.loop = this.trackLoop;\n    this.bindMusicElementEvents(audio);\n    this.audioEl = audio;\n    this.setState({ hasTrack: false, loadError: null, playbackError: null });\n\n    const source = ctx.createMediaElementSource(audio);\n    source.connect(this.musicAnalyser!);\n    this.musicSource = source;\n\n    await new Promise<void>((resolve, reject) => {\n      const finalize = () => {\n        cleanup();\n        this.pendingLoadCleanup = null;\n        this.pendingLoadReject = null;\n      };\n\n      const handleReady = () => {\n        finalize();\n        this.setState({ hasTrack: true, loadError: null });\n        resolve();\n      };\n\n      const handleFailure = (event?: Event) => {\n        finalize();\n        const mediaError =\n          (event?.target as HTMLMediaElement | null)?.error ??\n          audio.error ??\n          event;\n        reject(this.handleLoadFailure(mediaError));\n      };\n\n      const cleanup = () => {\n        audio.removeEventListener('loadedmetadata', handleReady);\n        audio.removeEventListener('canplay', handleReady);\n        audio.removeEventListener('error', handleFailure);\n      };\n\n      this.pendingLoadCleanup = cleanup;\n      this.pendingLoadReject = reject;\n\n      audio.addEventListener('loadedmetadata', handleReady, { once: true });\n      audio.addEventListener('canplay', handleReady, { once: true });\n      audio.addEventListener('error', handleFailure, { once: true });\n      audio.load();\n    });\n  }\n\n  async play(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    try {\n      await audio.play();\n      this.setState({ playbackError: null });\n    } catch (error) {\n      throw this.handleError('playback', error, 'playback_error');\n    }\n  }\n\n  pause(): void {\n    const audio = this.audioEl;\n    if (!audio || audio.paused) return;\n\n    audio.pause();\n  }\n\n  async togglePlayPause(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    if (audio.paused) {\n      await this.play();\n      return;\n    }\n\n    this.pause();\n  }\n\n  setLoop(loop: boolean): void {\n    this.trackLoop = loop;\n    if (this.audioEl) this.audioEl.loop = loop;\n  }\n\n  seek(seconds: number): void {\n    if (!Number.isFinite(seconds) || seconds < 0) {\n      throw new AudioBandsError(\n        'config',\n        'invalid_config',\n        'seek time must be a finite number greater than or equal to 0',\n      );\n    }\n\n    if (!this.audioEl) return;\n\n    const duration = Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n    this.audioEl.currentTime = duration === null ? seconds : Math.min(seconds, duration);\n  }\n\n  getDuration(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n  }\n\n  getCurrentTime(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.currentTime) ? this.audioEl.currentTime : null;\n  }\n\n  async enableMic(): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('mic', error);\n    }\n\n    if (this.micStream) return;\n\n    try {\n      const stream = await navigator.mediaDevices.getUserMedia({\n        audio: true,\n        video: false,\n      });\n      this.micStream = stream;\n\n      const analyser = this.createAnalyser(ctx, this.micConfig);\n      this.micAnalyser = analyser;\n      this.micData = new Uint8Array(\n        analyser.frequencyBinCount,\n      ) as Uint8Array<ArrayBuffer>;\n      this.micWaveformData = new Uint8Array(\n        analyser.fftSize,\n      ) as Uint8Array<ArrayBuffer>;\n\n      const source = ctx.createMediaStreamSource(stream);\n      source.connect(analyser);\n      this.micSource = source;\n\n      this.setState({ micActive: true, micError: null });\n      this.options.onMicStart?.();\n    } catch (error) {\n      throw this.handleError('mic', error, 'mic_error');\n    }\n  }\n\n  disableMic(): void {\n    const hadMic = Boolean(this.micStream || this.micSource || this.micAnalyser);\n    this.micStream?.getTracks().forEach((track) => track.stop());\n    this.micStream = null;\n\n    try {\n      this.micSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.micSource = null;\n    this.micAnalyser = null;\n    this.micData = null;\n    this.micWaveformData = null;\n    this.setState({ micActive: false });\n\n    if (hadMic) this.options.onMicStop?.();\n  }\n\n  getBands(source: AudioSource = 'music'): Bands {\n    const data = this.readFrequencyData(source);\n    if (!data) return { ...ZERO };\n    return computeBands(data, this.classicRanges);\n  }\n\n  getFftData(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readFrequencyData(source);\n  }\n\n  getWaveform(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readWaveformData(source);\n  }\n\n  snapshot(source: AudioSource = 'music'): AudioBandsSnapshot {\n    const fft = this.readFrequencyData(source);\n    const waveform = this.readWaveformData(source);\n\n    return {\n      bands: fft ? computeBands(fft, this.classicRanges) : { ...ZERO },\n      customBands: fft\n        ? computeCustomBands(fft, this.customBandRanges)\n        : computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges),\n      fft,\n      waveform,\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n\n    this.teardownMusic();\n    this.disableMic();\n    void this.ctx?.close();\n    this.ctx = null;\n    this.musicAnalyser = null;\n    this.musicData = null;\n    this.musicWaveformData = null;\n    this.setState({ isPlaying: false, micActive: false, hasTrack: false });\n    this.options = {};\n    this.destroyed = true;\n  }\n\n  private readFrequencyData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return null;\n      return fillFrequencyData(this.micAnalyser, this.micData);\n    }\n\n    if (!this.musicAnalyser || !this.musicData) return null;\n    return fillFrequencyData(this.musicAnalyser, this.musicData);\n  }\n\n  private readWaveformData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micWaveformData) return null;\n      this.micAnalyser.getByteTimeDomainData(this.micWaveformData);\n      return this.micWaveformData;\n    }\n\n    if (!this.musicAnalyser || !this.musicWaveformData) return null;\n    this.musicAnalyser.getByteTimeDomainData(this.musicWaveformData);\n    return this.musicWaveformData;\n  }\n\n  private ensureCtx(): AudioContext {\n    if (this.destroyed) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'destroyed',\n        'This AudioBands instance was destroyed',\n      );\n    }\n\n    if (this.ctx) return this.ctx;\n\n    const Ctx =\n      window.AudioContext ||\n      (window as unknown as { webkitAudioContext?: typeof AudioContext })\n        .webkitAudioContext;\n\n    if (!Ctx) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'unsupported_audio_context',\n        'AudioContext is not supported in this environment',\n      );\n    }\n\n    const ctx = new Ctx();\n    const analyser = this.createAnalyser(ctx, this.musicConfig);\n    analyser.connect(ctx.destination);\n\n    this.ctx = ctx;\n    this.musicAnalyser = analyser;\n    this.musicData = new Uint8Array(\n      analyser.frequencyBinCount,\n    ) as Uint8Array<ArrayBuffer>;\n    this.musicWaveformData = new Uint8Array(\n      analyser.fftSize,\n    ) as Uint8Array<ArrayBuffer>;\n\n    return ctx;\n  }\n\n  private createAnalyser(\n    ctx: AudioContext,\n    config: Required<AudioAnalyserConfig>,\n  ): AnalyserNode {\n    const analyser = ctx.createAnalyser();\n    analyser.fftSize = config.fftSize;\n    analyser.smoothingTimeConstant = config.smoothingTimeConstant;\n    return analyser;\n  }\n\n  private handleError(\n    kind: 'load' | 'playback' | 'mic',\n    error: unknown,\n    fallbackCode: 'load_error' | 'playback_error' | 'mic_error' = kind === 'mic'\n      ? 'mic_error'\n      : kind === 'playback'\n        ? 'playback_error'\n        : 'load_error',\n  ): AudioBandsError {\n    const wrapped =\n      error instanceof AudioBandsError\n        ? error\n        : new AudioBandsError(\n            kind,\n            fallbackCode,\n            kind === 'mic'\n              ? 'Failed to access microphone input'\n              : kind === 'playback'\n                ? 'Failed to play audio track'\n                : 'Failed to load audio track',\n            error,\n          );\n\n    if (kind === 'load') {\n      this.setState({ isPlaying: false, loadError: wrapped });\n      this.options.onLoadError?.(wrapped);\n    } else if (kind === 'playback') {\n      this.setState({ isPlaying: false, playbackError: wrapped });\n      this.options.onPlaybackError?.(wrapped);\n    } else {\n      this.setState({ micActive: false, micError: wrapped });\n      this.options.onMicError?.(wrapped);\n    }\n\n    this.options.onError?.(wrapped);\n    return wrapped;\n  }\n\n  private bindMusicElementEvents(audio: HTMLAudioElement): void {\n    this.musicEventCleanup?.();\n\n    const handlePlay = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: true, playbackError: null });\n      this.options.onPlay?.();\n    };\n\n    const handlePause = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: false });\n      this.options.onPause?.();\n    };\n\n    const handleEnded = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: false });\n    };\n\n    audio.addEventListener('play', handlePlay);\n    audio.addEventListener('pause', handlePause);\n    audio.addEventListener('ended', handleEnded);\n\n    this.musicEventCleanup = () => {\n      audio.removeEventListener('play', handlePlay);\n      audio.removeEventListener('pause', handlePause);\n      audio.removeEventListener('ended', handleEnded);\n      if (this.musicEventCleanup) this.musicEventCleanup = null;\n    };\n  }\n\n  private handleLoadFailure(error: unknown): AudioBandsError {\n    this.teardownMusic();\n    return this.handleError('load', error, 'load_error');\n  }\n\n  private setState(patch: Partial<AudioBandsState>): void {\n    let changed = false;\n\n    for (const [key, value] of Object.entries(patch) as Array<\n      [keyof AudioBandsState, AudioBandsState[keyof AudioBandsState]]\n    >) {\n      if (this.state[key] !== value) {\n        this.state[key] = value as never;\n        changed = true;\n      }\n    }\n\n    if (changed) this.options.onStateChange?.(this.getState());\n  }\n\n  private teardownMusic(): void {\n    this.musicEventCleanup?.();\n    if (this.pendingLoadReject) {\n      const reject = this.pendingLoadReject;\n      this.pendingLoadReject = null;\n      this.pendingLoadCleanup?.();\n      this.pendingLoadCleanup = null;\n      reject(\n        new AudioBandsError(\n          'load',\n          'load_error',\n          'Audio track loading was interrupted before completion',\n        ),\n      );\n    } else if (this.pendingLoadCleanup) {\n      this.pendingLoadCleanup();\n      this.pendingLoadCleanup = null;\n    }\n    this.audioEl?.pause();\n    if (this.audioEl) {\n      this.audioEl.src = '';\n      this.audioEl.load();\n    }\n    this.audioEl = null;\n\n    try {\n      this.musicSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.musicSource = null;\n    this.musicWaveformData = this.musicAnalyser\n      ? new Uint8Array(this.musicAnalyser.fftSize) as Uint8Array<ArrayBuffer>\n      : null;\n    this.setState({\n      isPlaying: false,\n      hasTrack: false,\n      playbackError: null,\n    });\n  }\n}\n"],"mappings":";AAEO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAKzC,YACE,MACA,MACA,SACA,OACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AACF;;;ACNA,IAAM,yBAAwD;AAAA,EAC5D,SAAS;AAAA,EACT,uBAAuB;AACzB;AAEA,IAAM,uBAAsD;AAAA,EAC1D,SAAS;AAAA,EACT,uBAAuB;AACzB;AAEA,IAAM,yBAA0E;AAAA,EAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK;AAAA,EAC1B,KAAK,EAAE,MAAM,MAAM,IAAI,IAAI;AAAA,EAC3B,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE;AAC3B;AAEA,IAAM,OAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,EAAE;AAE3D,SAAS,IAAI,KAA8B,MAAc,IAAoB;AAC3E,MAAI,MAAM;AACV,WAAS,IAAI,MAAM,IAAI,IAAI,IAAK,QAAO,IAAI,CAAC;AAC5C,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,aAAa,OAAwB;AAC5C,UAAQ,QAAS,QAAQ,OAAQ;AACnC;AAEA,SAAS,wBACP,QACA,UAC+B;AAC/B,QAAM,UAAU,QAAQ,WAAW,SAAS;AAC5C,QAAM,wBACJ,QAAQ,yBAAyB,SAAS;AAE5C,MACE,CAAC,OAAO,UAAU,OAAO,KACzB,UAAU,MACV,UAAU,SACV,CAAC,aAAa,OAAO,GACrB;AACA,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MACE,OAAO,0BAA0B,YACjC,wBAAwB,KACxB,wBAAwB,GACxB;AACA,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,sBAAsB;AAC1C;AAEA,SAAS,eAAe,MAAc,OAAyC;AAC7E,QAAM,aAAa,SAAS,uBAAuB,IAA2C;AAE9F,MACE,OAAO,YAAY,SAAS,YAC5B,OAAO,YAAY,OAAO,YAC1B,WAAW,OAAO,KAClB,WAAW,KAAK,KAChB,WAAW,QAAQ,WAAW,IAC9B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,eAAe,IAAI;AAAA,IACrB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,uBACP,QACiD;AACjD,SAAO;AAAA,IACL,MAAM,eAAe,QAAQ,QAAQ,IAAI;AAAA,IACzC,KAAK,eAAe,OAAO,QAAQ,GAAG;AAAA,IACtC,MAAM,eAAe,QAAQ,QAAQ,IAAI;AAAA,EAC3C;AACF;AAEA,SAAS,qBAAqB,aAA6D;AACzF,MAAI,CAAC,YAAa,QAAO,CAAC;AAE1B,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,eAAe,MAAM,KAAK,CAAC,CAAC;AAAA,EACxF;AACF;AAEA,SAAS,WAAW,KAAa,OAAoC;AACnE,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,MAAM,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,CAAC,CAAC;AACxE,QAAM,KAAK,KAAK,IAAI,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;AACvE,SAAO,CAAC,MAAM,EAAE;AAClB;AAEA,SAAS,cAAc,MAA+B,OAA0B;AAC9E,QAAM,CAAC,MAAM,EAAE,IAAI,WAAW,KAAK,QAAQ,KAAK;AAChD,SAAO,IAAI,MAAM,MAAM,EAAE,IAAI;AAC/B;AAEA,SAAS,kBACP,UACA,MACyB;AACzB,WAAS,qBAAqB,IAAI;AAClC,SAAO;AACT;AAEA,SAAS,aACP,MACA,QACO;AACP,QAAM,OAAO,cAAc,MAAM,OAAO,IAAI;AAC5C,QAAM,MAAM,cAAc,MAAM,OAAO,GAAG;AAC1C,QAAM,OAAO,cAAc,MAAM,OAAO,IAAI;AAE5C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,OAAO,MAAM,MAAM,MAAM,OAAO;AAAA,EAC3C;AACF;AAEA,SAAS,mBACP,MACA,QACwB;AACxB,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,cAAc,MAAM,KAAK,CAAC,CAAC;AAAA,EAClF;AACF;AAEA,SAAS,WAAW,OAAyC;AAC3D,SAAO,EAAE,GAAG,MAAM;AACpB;AAMO,IAAM,aAAN,MAAiB;AAAA,EAiCtB,YAAY,UAA6B,CAAC,GAAG;AA1B7C,SAAiB,QAAyB;AAAA,MACxC,WAAW;AAAA,MACX,WAAW;AAAA,MACX,UAAU;AAAA,MACV,WAAW;AAAA,MACX,eAAe;AAAA,MACf,UAAU;AAAA,IACZ;AAEA,SAAQ,MAA2B;AACnC,SAAQ,gBAAqC;AAC7C,SAAQ,YAA4C;AACpD,SAAQ,oBAAoD;AAC5D,SAAQ,cAAmC;AAC3C,SAAQ,UAA0C;AAClD,SAAQ,kBAAkD;AAC1D,SAAQ,UAAmC;AAC3C,SAAQ,cAAkD;AAC1D,SAAQ,YAA+C;AACvD,SAAQ,YAAgC;AACxC,SAAQ,oBAAyC;AACjD,SAAQ,qBAA0C;AAClD,SAAQ,oBAA+D;AACvE,SAAQ,YAAY;AACpB,SAAQ,YAAY;AAGlB,SAAK,UAAU;AACf,SAAK,cAAc,wBAAwB,QAAQ,OAAO,sBAAsB;AAChF,SAAK,YAAY,wBAAwB,QAAQ,KAAK,oBAAoB;AAC1E,SAAK,gBAAgB,uBAAuB,QAAQ,UAAU;AAC9D,SAAK,mBAAmB,qBAAqB,QAAQ,WAAW;AAAA,EAClE;AAAA,EAEA,WAA4B;AAC1B,WAAO,WAAW,KAAK,KAAK;AAAA,EAC9B;AAAA,EAEA,eAAe,SAAsB,SAAiC;AACpE,UAAM,OAAO,KAAK,kBAAkB,MAAM;AAC1C,QAAI,CAAC,KAAM,QAAO,mBAAmB,IAAI,WAAW,CAAC,GAA8B,KAAK,gBAAgB;AACxG,WAAO,mBAAmB,MAAM,KAAK,gBAAgB;AAAA,EACvD;AAAA,EAEA,MAAM,KAAK,KAA4B;AACrC,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,UAAU;AAAA,IACvB,SAAS,OAAO;AACd,YAAM,KAAK,YAAY,QAAQ,OAAO,YAAY;AAAA,IACpD;AAEA,SAAK,cAAc;AAEnB,UAAM,QAAQ,IAAI,MAAM;AACxB,UAAM,cAAc;AACpB,UAAM,UAAU;AAChB,UAAM,MAAM;AACZ,UAAM,OAAO,KAAK;AAClB,SAAK,uBAAuB,KAAK;AACjC,SAAK,UAAU;AACf,SAAK,SAAS,EAAE,UAAU,OAAO,WAAW,MAAM,eAAe,KAAK,CAAC;AAEvE,UAAM,SAAS,IAAI,yBAAyB,KAAK;AACjD,WAAO,QAAQ,KAAK,aAAc;AAClC,SAAK,cAAc;AAEnB,UAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAM,WAAW,MAAM;AACrB,gBAAQ;AACR,aAAK,qBAAqB;AAC1B,aAAK,oBAAoB;AAAA,MAC3B;AAEA,YAAM,cAAc,MAAM;AACxB,iBAAS;AACT,aAAK,SAAS,EAAE,UAAU,MAAM,WAAW,KAAK,CAAC;AACjD,gBAAQ;AAAA,MACV;AAEA,YAAM,gBAAgB,CAAC,UAAkB;AACvC,iBAAS;AACT,cAAM,aACH,OAAO,QAAoC,SAC5C,MAAM,SACN;AACF,eAAO,KAAK,kBAAkB,UAAU,CAAC;AAAA,MAC3C;AAEA,YAAM,UAAU,MAAM;AACpB,cAAM,oBAAoB,kBAAkB,WAAW;AACvD,cAAM,oBAAoB,WAAW,WAAW;AAChD,cAAM,oBAAoB,SAAS,aAAa;AAAA,MAClD;AAEA,WAAK,qBAAqB;AAC1B,WAAK,oBAAoB;AAEzB,YAAM,iBAAiB,kBAAkB,aAAa,EAAE,MAAM,KAAK,CAAC;AACpE,YAAM,iBAAiB,WAAW,aAAa,EAAE,MAAM,KAAK,CAAC;AAC7D,YAAM,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;AAC7D,YAAM,KAAK;AAAA,IACb,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAsB;AAC1B,UAAM,QAAQ,KAAK;AACnB,QAAI,CAAC,MAAO;AAEZ,QAAI;AACF,YAAM,MAAM,KAAK;AACjB,WAAK,SAAS,EAAE,eAAe,KAAK,CAAC;AAAA,IACvC,SAAS,OAAO;AACd,YAAM,KAAK,YAAY,YAAY,OAAO,gBAAgB;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,UAAM,QAAQ,KAAK;AACnB,QAAI,CAAC,SAAS,MAAM,OAAQ;AAE5B,UAAM,MAAM;AAAA,EACd;AAAA,EAEA,MAAM,kBAAiC;AACrC,UAAM,QAAQ,KAAK;AACnB,QAAI,CAAC,MAAO;AAEZ,QAAI,MAAM,QAAQ;AAChB,YAAM,KAAK,KAAK;AAChB;AAAA,IACF;AAEA,SAAK,MAAM;AAAA,EACb;AAAA,EAEA,QAAQ,MAAqB;AAC3B,SAAK,YAAY;AACjB,QAAI,KAAK,QAAS,MAAK,QAAQ,OAAO;AAAA,EACxC;AAAA,EAEA,KAAK,SAAuB;AAC1B,QAAI,CAAC,OAAO,SAAS,OAAO,KAAK,UAAU,GAAG;AAC5C,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAS;AAEnB,UAAM,WAAW,OAAO,SAAS,KAAK,QAAQ,QAAQ,IAAI,KAAK,QAAQ,WAAW;AAClF,SAAK,QAAQ,cAAc,aAAa,OAAO,UAAU,KAAK,IAAI,SAAS,QAAQ;AAAA,EACrF;AAAA,EAEA,cAA6B;AAC3B,QAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,WAAO,OAAO,SAAS,KAAK,QAAQ,QAAQ,IAAI,KAAK,QAAQ,WAAW;AAAA,EAC1E;AAAA,EAEA,iBAAgC;AAC9B,QAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,WAAO,OAAO,SAAS,KAAK,QAAQ,WAAW,IAAI,KAAK,QAAQ,cAAc;AAAA,EAChF;AAAA,EAEA,MAAM,YAA2B;AAC/B,QAAI;AACJ,QAAI;AACF,YAAM,KAAK,UAAU;AAAA,IACvB,SAAS,OAAO;AACd,YAAM,KAAK,YAAY,OAAO,KAAK;AAAA,IACrC;AAEA,QAAI,KAAK,UAAW;AAEpB,QAAI;AACF,YAAM,SAAS,MAAM,UAAU,aAAa,aAAa;AAAA,QACvD,OAAO;AAAA,QACP,OAAO;AAAA,MACT,CAAC;AACD,WAAK,YAAY;AAEjB,YAAM,WAAW,KAAK,eAAe,KAAK,KAAK,SAAS;AACxD,WAAK,cAAc;AACnB,WAAK,UAAU,IAAI;AAAA,QACjB,SAAS;AAAA,MACX;AACA,WAAK,kBAAkB,IAAI;AAAA,QACzB,SAAS;AAAA,MACX;AAEA,YAAM,SAAS,IAAI,wBAAwB,MAAM;AACjD,aAAO,QAAQ,QAAQ;AACvB,WAAK,YAAY;AAEjB,WAAK,SAAS,EAAE,WAAW,MAAM,UAAU,KAAK,CAAC;AACjD,WAAK,QAAQ,aAAa;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,KAAK,YAAY,OAAO,OAAO,WAAW;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,aAAmB;AACjB,UAAM,SAAS,QAAQ,KAAK,aAAa,KAAK,aAAa,KAAK,WAAW;AAC3E,SAAK,WAAW,UAAU,EAAE,QAAQ,CAAC,UAAU,MAAM,KAAK,CAAC;AAC3D,SAAK,YAAY;AAEjB,QAAI;AACF,WAAK,WAAW,WAAW;AAAA,IAC7B,QAAQ;AAAA,IAER;AAEA,SAAK,YAAY;AACjB,SAAK,cAAc;AACnB,SAAK,UAAU;AACf,SAAK,kBAAkB;AACvB,SAAK,SAAS,EAAE,WAAW,MAAM,CAAC;AAElC,QAAI,OAAQ,MAAK,QAAQ,YAAY;AAAA,EACvC;AAAA,EAEA,SAAS,SAAsB,SAAgB;AAC7C,UAAM,OAAO,KAAK,kBAAkB,MAAM;AAC1C,QAAI,CAAC,KAAM,QAAO,EAAE,GAAG,KAAK;AAC5B,WAAO,aAAa,MAAM,KAAK,aAAa;AAAA,EAC9C;AAAA,EAEA,WAAW,SAAsB,SAAyC;AACxE,WAAO,KAAK,kBAAkB,MAAM;AAAA,EACtC;AAAA,EAEA,YAAY,SAAsB,SAAyC;AACzE,WAAO,KAAK,iBAAiB,MAAM;AAAA,EACrC;AAAA,EAEA,SAAS,SAAsB,SAA6B;AAC1D,UAAM,MAAM,KAAK,kBAAkB,MAAM;AACzC,UAAM,WAAW,KAAK,iBAAiB,MAAM;AAE7C,WAAO;AAAA,MACL,OAAO,MAAM,aAAa,KAAK,KAAK,aAAa,IAAI,EAAE,GAAG,KAAK;AAAA,MAC/D,aAAa,MACT,mBAAmB,KAAK,KAAK,gBAAgB,IAC7C,mBAAmB,IAAI,WAAW,CAAC,GAA8B,KAAK,gBAAgB;AAAA,MAC1F;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAgB;AACd,QAAI,KAAK,UAAW;AAEpB,SAAK,cAAc;AACnB,SAAK,WAAW;AAChB,SAAK,KAAK,KAAK,MAAM;AACrB,SAAK,MAAM;AACX,SAAK,gBAAgB;AACrB,SAAK,YAAY;AACjB,SAAK,oBAAoB;AACzB,SAAK,SAAS,EAAE,WAAW,OAAO,WAAW,OAAO,UAAU,MAAM,CAAC;AACrE,SAAK,UAAU,CAAC;AAChB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEQ,kBAAkB,QAAqD;AAC7E,QAAI,WAAW,OAAO;AACpB,UAAI,CAAC,KAAK,eAAe,CAAC,KAAK,QAAS,QAAO;AAC/C,aAAO,kBAAkB,KAAK,aAAa,KAAK,OAAO;AAAA,IACzD;AAEA,QAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,UAAW,QAAO;AACnD,WAAO,kBAAkB,KAAK,eAAe,KAAK,SAAS;AAAA,EAC7D;AAAA,EAEQ,iBAAiB,QAAqD;AAC5E,QAAI,WAAW,OAAO;AACpB,UAAI,CAAC,KAAK,eAAe,CAAC,KAAK,gBAAiB,QAAO;AACvD,WAAK,YAAY,sBAAsB,KAAK,eAAe;AAC3D,aAAO,KAAK;AAAA,IACd;AAEA,QAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,kBAAmB,QAAO;AAC3D,SAAK,cAAc,sBAAsB,KAAK,iBAAiB;AAC/D,WAAO,KAAK;AAAA,EACd;AAAA,EAEQ,YAA0B;AAChC,QAAI,KAAK,WAAW;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,KAAK,IAAK,QAAO,KAAK;AAE1B,UAAM,MACJ,OAAO,gBACN,OACE;AAEL,QAAI,CAAC,KAAK;AACR,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,MAAM,IAAI,IAAI;AACpB,UAAM,WAAW,KAAK,eAAe,KAAK,KAAK,WAAW;AAC1D,aAAS,QAAQ,IAAI,WAAW;AAEhC,SAAK,MAAM;AACX,SAAK,gBAAgB;AACrB,SAAK,YAAY,IAAI;AAAA,MACnB,SAAS;AAAA,IACX;AACA,SAAK,oBAAoB,IAAI;AAAA,MAC3B,SAAS;AAAA,IACX;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,eACN,KACA,QACc;AACd,UAAM,WAAW,IAAI,eAAe;AACpC,aAAS,UAAU,OAAO;AAC1B,aAAS,wBAAwB,OAAO;AACxC,WAAO;AAAA,EACT;AAAA,EAEQ,YACN,MACA,OACA,eAA8D,SAAS,QACnE,cACA,SAAS,aACP,mBACA,cACW;AACjB,UAAM,UACJ,iBAAiB,kBACb,QACA,IAAI;AAAA,MACF;AAAA,MACA;AAAA,MACA,SAAS,QACL,sCACA,SAAS,aACP,+BACA;AAAA,MACN;AAAA,IACF;AAEN,QAAI,SAAS,QAAQ;AACnB,WAAK,SAAS,EAAE,WAAW,OAAO,WAAW,QAAQ,CAAC;AACtD,WAAK,QAAQ,cAAc,OAAO;AAAA,IACpC,WAAW,SAAS,YAAY;AAC9B,WAAK,SAAS,EAAE,WAAW,OAAO,eAAe,QAAQ,CAAC;AAC1D,WAAK,QAAQ,kBAAkB,OAAO;AAAA,IACxC,OAAO;AACL,WAAK,SAAS,EAAE,WAAW,OAAO,UAAU,QAAQ,CAAC;AACrD,WAAK,QAAQ,aAAa,OAAO;AAAA,IACnC;AAEA,SAAK,QAAQ,UAAU,OAAO;AAC9B,WAAO;AAAA,EACT;AAAA,EAEQ,uBAAuB,OAA+B;AAC5D,SAAK,oBAAoB;AAEzB,UAAM,aAAa,MAAM;AACvB,UAAI,KAAK,YAAY,MAAO;AAC5B,WAAK,SAAS,EAAE,WAAW,MAAM,eAAe,KAAK,CAAC;AACtD,WAAK,QAAQ,SAAS;AAAA,IACxB;AAEA,UAAM,cAAc,MAAM;AACxB,UAAI,KAAK,YAAY,MAAO;AAC5B,WAAK,SAAS,EAAE,WAAW,MAAM,CAAC;AAClC,WAAK,QAAQ,UAAU;AAAA,IACzB;AAEA,UAAM,cAAc,MAAM;AACxB,UAAI,KAAK,YAAY,MAAO;AAC5B,WAAK,SAAS,EAAE,WAAW,MAAM,CAAC;AAAA,IACpC;AAEA,UAAM,iBAAiB,QAAQ,UAAU;AACzC,UAAM,iBAAiB,SAAS,WAAW;AAC3C,UAAM,iBAAiB,SAAS,WAAW;AAE3C,SAAK,oBAAoB,MAAM;AAC7B,YAAM,oBAAoB,QAAQ,UAAU;AAC5C,YAAM,oBAAoB,SAAS,WAAW;AAC9C,YAAM,oBAAoB,SAAS,WAAW;AAC9C,UAAI,KAAK,kBAAmB,MAAK,oBAAoB;AAAA,IACvD;AAAA,EACF;AAAA,EAEQ,kBAAkB,OAAiC;AACzD,SAAK,cAAc;AACnB,WAAO,KAAK,YAAY,QAAQ,OAAO,YAAY;AAAA,EACrD;AAAA,EAEQ,SAAS,OAAuC;AACtD,QAAI,UAAU;AAEd,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAE5C;AACD,UAAI,KAAK,MAAM,GAAG,MAAM,OAAO;AAC7B,aAAK,MAAM,GAAG,IAAI;AAClB,kBAAU;AAAA,MACZ;AAAA,IACF;AAEA,QAAI,QAAS,MAAK,QAAQ,gBAAgB,KAAK,SAAS,CAAC;AAAA,EAC3D;AAAA,EAEQ,gBAAsB;AAC5B,SAAK,oBAAoB;AACzB,QAAI,KAAK,mBAAmB;AAC1B,YAAM,SAAS,KAAK;AACpB,WAAK,oBAAoB;AACzB,WAAK,qBAAqB;AAC1B,WAAK,qBAAqB;AAC1B;AAAA,QACE,IAAI;AAAA,UACF;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF,WAAW,KAAK,oBAAoB;AAClC,WAAK,mBAAmB;AACxB,WAAK,qBAAqB;AAAA,IAC5B;AACA,SAAK,SAAS,MAAM;AACpB,QAAI,KAAK,SAAS;AAChB,WAAK,QAAQ,MAAM;AACnB,WAAK,QAAQ,KAAK;AAAA,IACpB;AACA,SAAK,UAAU;AAEf,QAAI;AACF,WAAK,aAAa,WAAW;AAAA,IAC/B,QAAQ;AAAA,IAER;AAEA,SAAK,cAAc;AACnB,SAAK,oBAAoB,KAAK,gBAC1B,IAAI,WAAW,KAAK,cAAc,OAAO,IACzC;AACJ,SAAK,SAAS;AAAA,MACZ,WAAW;AAAA,MACX,UAAU;AAAA,MACV,eAAe;AAAA,IACjB,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/core-entry.cjs

@@ -155,6 +155,9 @@ var AudioBands = class {
     this.musicSource = null;
     this.micSource = null;
     this.micStream = null;
+    this.musicEventCleanup = null;
+    this.pendingLoadCleanup = null;
+    this.pendingLoadReject = null;
     this.trackLoop = false;
     this.destroyed = false;
     this.options = options;
@@ -181,21 +184,50 @@ var AudioBands = class {
     this.teardownMusic();
     const audio = new Audio();
     audio.crossOrigin = "anonymous";
+    audio.preload = "auto";
     audio.src = url;
     audio.loop = this.trackLoop;
+    this.bindMusicElementEvents(audio);
     this.audioEl = audio;
-    this.setState({ hasTrack: true, loadError: null, playbackError: null });
+    this.setState({ hasTrack: false, loadError: null, playbackError: null });
     const source = ctx.createMediaElementSource(audio);
     source.connect(this.musicAnalyser);
     this.musicSource = source;
+    await new Promise((resolve, reject) => {
+      const finalize = () => {
+        cleanup();
+        this.pendingLoadCleanup = null;
+        this.pendingLoadReject = null;
+      };
+      const handleReady = () => {
+        finalize();
+        this.setState({ hasTrack: true, loadError: null });
+        resolve();
+      };
+      const handleFailure = (event) => {
+        finalize();
+        const mediaError = event?.target?.error ?? audio.error ?? event;
+        reject(this.handleLoadFailure(mediaError));
+      };
+      const cleanup = () => {
+        audio.removeEventListener("loadedmetadata", handleReady);
+        audio.removeEventListener("canplay", handleReady);
+        audio.removeEventListener("error", handleFailure);
+      };
+      this.pendingLoadCleanup = cleanup;
+      this.pendingLoadReject = reject;
+      audio.addEventListener("loadedmetadata", handleReady, { once: true });
+      audio.addEventListener("canplay", handleReady, { once: true });
+      audio.addEventListener("error", handleFailure, { once: true });
+      audio.load();
+    });
   }
   async play() {
     const audio = this.audioEl;
     if (!audio) return;
     try {
       await audio.play();
-      this.setState({ isPlaying: true, playbackError: null });
-      this.options.onPlay?.();
+      this.setState({ playbackError: null });
     } catch (error) {
       throw this.handleError("playback", error, "playback_error");
     }
@@ -204,8 +236,6 @@ var AudioBands = class {
     const audio = this.audioEl;
     if (!audio || audio.paused) return;
     audio.pause();
-    this.setState({ isPlaying: false });
-    this.options.onPause?.();
   }
   async togglePlayPause() {
     const audio = this.audioEl;
@@ -394,6 +424,36 @@ var AudioBands = class {
     this.options.onError?.(wrapped);
     return wrapped;
   }
+  bindMusicElementEvents(audio) {
+    this.musicEventCleanup?.();
+    const handlePlay = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: true, playbackError: null });
+      this.options.onPlay?.();
+    };
+    const handlePause = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: false });
+      this.options.onPause?.();
+    };
+    const handleEnded = () => {
+      if (this.audioEl !== audio) return;
+      this.setState({ isPlaying: false });
+    };
+    audio.addEventListener("play", handlePlay);
+    audio.addEventListener("pause", handlePause);
+    audio.addEventListener("ended", handleEnded);
+    this.musicEventCleanup = () => {
+      audio.removeEventListener("play", handlePlay);
+      audio.removeEventListener("pause", handlePause);
+      audio.removeEventListener("ended", handleEnded);
+      if (this.musicEventCleanup) this.musicEventCleanup = null;
+    };
+  }
+  handleLoadFailure(error) {
+    this.teardownMusic();
+    return this.handleError("load", error, "load_error");
+  }
   setState(patch) {
     let changed = false;
     for (const [key, value] of Object.entries(patch)) {
@@ -405,6 +465,23 @@ var AudioBands = class {
     if (changed) this.options.onStateChange?.(this.getState());
   }
   teardownMusic() {
+    this.musicEventCleanup?.();
+    if (this.pendingLoadReject) {
+      const reject = this.pendingLoadReject;
+      this.pendingLoadReject = null;
+      this.pendingLoadCleanup?.();
+      this.pendingLoadCleanup = null;
+      reject(
+        new AudioBandsError(
+          "load",
+          "load_error",
+          "Audio track loading was interrupted before completion"
+        )
+      );
+    } else if (this.pendingLoadCleanup) {
+      this.pendingLoadCleanup();
+      this.pendingLoadCleanup = null;
+    }
     this.audioEl?.pause();
     if (this.audioEl) {
       this.audioEl.src = "";

package/dist/core-entry.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core-entry.ts","../src/errors.ts","../src/core.ts"],"sourcesContent":["export { AudioBands } from './core';\nexport { AudioBandsError } from './errors';\nexport type {\n  AudioAnalyserConfig,\n  AudioBandsCallbacks,\n  AudioBandsErrorCode,\n  AudioBandsErrorKind,\n  AudioBandsOptions,\n  AudioBandsSnapshot,\n  AudioBandsState,\n  AudioSource,\n  BandRange,\n  Bands,\n  ClassicBandRanges,\n  CustomBandRanges,\n} from './types';\n","import type { AudioBandsErrorCode, AudioBandsErrorKind } from './types';\n\nexport class AudioBandsError extends Error {\n  readonly kind: AudioBandsErrorKind;\n  readonly code: AudioBandsErrorCode;\n  readonly cause?: unknown;\n\n  constructor(\n    kind: AudioBandsErrorKind,\n    code: AudioBandsErrorCode,\n    message: string,\n    cause?: unknown,\n  ) {\n    super(message);\n    this.name = 'AudioBandsError';\n    this.kind = kind;\n    this.code = code;\n    this.cause = cause;\n  }\n}\n","import { AudioBandsError } from './errors';\nimport type {\n  AudioAnalyserConfig,\n  AudioBandsOptions,\n  AudioBandsSnapshot,\n  AudioBandsState,\n  AudioSource,\n  BandRange,\n  Bands,\n  ClassicBandRanges,\n  CustomBandRanges,\n} from './types';\n\nconst DEFAULT_MUSIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.85,\n};\n\nconst DEFAULT_MIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.8,\n};\n\nconst DEFAULT_CLASSIC_RANGES: Record<keyof Omit<Bands, 'overall'>, BandRange> = {\n  bass: { from: 0, to: 0.08 },\n  mid: { from: 0.08, to: 0.4 },\n  high: { from: 0.4, to: 1 },\n};\n\nconst ZERO: Bands = { bass: 0, mid: 0, high: 0, overall: 0 };\n\nfunction avg(arr: Uint8Array<ArrayBuffer>, from: number, to: number): number {\n  let sum = 0;\n  for (let i = from; i < to; i++) sum += arr[i];\n  return sum / (to - from);\n}\n\nfunction isPowerOfTwo(value: number): boolean {\n  return (value & (value - 1)) === 0;\n}\n\nfunction normalizeAnalyserConfig(\n  config: AudioAnalyserConfig | undefined,\n  fallback: Required<AudioAnalyserConfig>,\n): Required<AudioAnalyserConfig> {\n  const fftSize = config?.fftSize ?? fallback.fftSize;\n  const smoothingTimeConstant =\n    config?.smoothingTimeConstant ?? fallback.smoothingTimeConstant;\n\n  if (\n    !Number.isInteger(fftSize) ||\n    fftSize < 32 ||\n    fftSize > 32768 ||\n    !isPowerOfTwo(fftSize)\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'fftSize must be a power of two between 32 and 32768',\n    );\n  }\n\n  if (\n    typeof smoothingTimeConstant !== 'number' ||\n    smoothingTimeConstant < 0 ||\n    smoothingTimeConstant > 1\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'smoothingTimeConstant must be between 0 and 1',\n    );\n  }\n\n  return { fftSize, smoothingTimeConstant };\n}\n\nfunction normalizeRange(name: string, range: BandRange | undefined): BandRange {\n  const normalized = range ?? DEFAULT_CLASSIC_RANGES[name as keyof typeof DEFAULT_CLASSIC_RANGES];\n\n  if (\n    typeof normalized?.from !== 'number' ||\n    typeof normalized?.to !== 'number' ||\n    normalized.from < 0 ||\n    normalized.to > 1 ||\n    normalized.from >= normalized.to\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      `Band range \"${name}\" must satisfy 0 <= from < to <= 1`,\n    );\n  }\n\n  return normalized;\n}\n\nfunction normalizeClassicRanges(\n  ranges: ClassicBandRanges | undefined,\n): Record<keyof Omit<Bands, 'overall'>, BandRange> {\n  return {\n    bass: normalizeRange('bass', ranges?.bass),\n    mid: normalizeRange('mid', ranges?.mid),\n    high: normalizeRange('high', ranges?.high),\n  };\n}\n\nfunction normalizeCustomBands(customBands: CustomBandRanges | undefined): CustomBandRanges {\n  if (!customBands) return {};\n\n  return Object.fromEntries(\n    Object.entries(customBands).map(([name, range]) => [name, normalizeRange(name, range)]),\n  );\n}\n\nfunction getIndexes(len: number, range: BandRange): [number, number] {\n  const from = Math.max(0, Math.min(len - 1, Math.floor(len * range.from)));\n  const to = Math.max(from + 1, Math.min(len, Math.floor(len * range.to)));\n  return [from, to];\n}\n\nfunction getRangeValue(data: Uint8Array<ArrayBuffer>, range: BandRange): number {\n  const [from, to] = getIndexes(data.length, range);\n  return avg(data, from, to) / 255;\n}\n\nfunction fillFrequencyData(\n  analyser: AnalyserNode,\n  data: Uint8Array<ArrayBuffer>,\n): Uint8Array<ArrayBuffer> {\n  analyser.getByteFrequencyData(data);\n  return data;\n}\n\nfunction computeBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: Record<keyof Omit<Bands, 'overall'>, BandRange>,\n): Bands {\n  const bass = getRangeValue(data, ranges.bass);\n  const mid = getRangeValue(data, ranges.mid);\n  const high = getRangeValue(data, ranges.high);\n\n  return {\n    bass,\n    mid,\n    high,\n    overall: bass * 0.5 + mid * 0.3 + high * 0.2,\n  };\n}\n\nfunction computeCustomBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: CustomBandRanges,\n): Record<string, number> {\n  return Object.fromEntries(\n    Object.entries(ranges).map(([name, range]) => [name, getRangeValue(data, range)]),\n  );\n}\n\nfunction cloneState(state: AudioBandsState): AudioBandsState {\n  return { ...state };\n}\n\n/**\n * Vanilla JS class — no framework dependency.\n * Works in React, Vue, Svelte, or plain HTML.\n */\nexport class AudioBands {\n  private options: AudioBandsOptions;\n  private readonly musicConfig: Required<AudioAnalyserConfig>;\n  private readonly micConfig: Required<AudioAnalyserConfig>;\n  private readonly classicRanges: Record<keyof Omit<Bands, 'overall'>, BandRange>;\n  private readonly customBandRanges: CustomBandRanges;\n\n  private readonly state: AudioBandsState = {\n    isPlaying: false,\n    micActive: false,\n    hasTrack: false,\n    loadError: null,\n    playbackError: null,\n    micError: null,\n  };\n\n  private ctx: AudioContext | null = null;\n  private musicAnalyser: AnalyserNode | null = null;\n  private musicData: Uint8Array<ArrayBuffer> | null = null;\n  private musicWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private micAnalyser: AnalyserNode | null = null;\n  private micData: Uint8Array<ArrayBuffer> | null = null;\n  private micWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private audioEl: HTMLAudioElement | null = null;\n  private musicSource: MediaElementAudioSourceNode | null = null;\n  private micSource: MediaStreamAudioSourceNode | null = null;\n  private micStream: MediaStream | null = null;\n  private trackLoop = false;\n  private destroyed = false;\n\n  constructor(options: AudioBandsOptions = {}) {\n    this.options = options;\n    this.musicConfig = normalizeAnalyserConfig(options.music, DEFAULT_MUSIC_ANALYSER);\n    this.micConfig = normalizeAnalyserConfig(options.mic, DEFAULT_MIC_ANALYSER);\n    this.classicRanges = normalizeClassicRanges(options.bandRanges);\n    this.customBandRanges = normalizeCustomBands(options.customBands);\n  }\n\n  getState(): AudioBandsState {\n    return cloneState(this.state);\n  }\n\n  getCustomBands(source: AudioSource = 'music'): Record<string, number> {\n    const data = this.readFrequencyData(source);\n    if (!data) return computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges);\n    return computeCustomBands(data, this.customBandRanges);\n  }\n\n  async load(url: string): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('load', error, 'load_error');\n    }\n\n    this.teardownMusic();\n\n    const audio = new Audio();\n    audio.crossOrigin = 'anonymous';\n    audio.src = url;\n    audio.loop = this.trackLoop;\n    this.audioEl = audio;\n    this.setState({ hasTrack: true, loadError: null, playbackError: null });\n\n    const source = ctx.createMediaElementSource(audio);\n    source.connect(this.musicAnalyser!);\n    this.musicSource = source;\n  }\n\n  async play(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    try {\n      await audio.play();\n      this.setState({ isPlaying: true, playbackError: null });\n      this.options.onPlay?.();\n    } catch (error) {\n      throw this.handleError('playback', error, 'playback_error');\n    }\n  }\n\n  pause(): void {\n    const audio = this.audioEl;\n    if (!audio || audio.paused) return;\n\n    audio.pause();\n    this.setState({ isPlaying: false });\n    this.options.onPause?.();\n  }\n\n  async togglePlayPause(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    if (audio.paused) {\n      await this.play();\n      return;\n    }\n\n    this.pause();\n  }\n\n  setLoop(loop: boolean): void {\n    this.trackLoop = loop;\n    if (this.audioEl) this.audioEl.loop = loop;\n  }\n\n  seek(seconds: number): void {\n    if (!Number.isFinite(seconds) || seconds < 0) {\n      throw new AudioBandsError(\n        'config',\n        'invalid_config',\n        'seek time must be a finite number greater than or equal to 0',\n      );\n    }\n\n    if (!this.audioEl) return;\n\n    const duration = Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n    this.audioEl.currentTime = duration === null ? seconds : Math.min(seconds, duration);\n  }\n\n  getDuration(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n  }\n\n  getCurrentTime(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.currentTime) ? this.audioEl.currentTime : null;\n  }\n\n  async enableMic(): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('mic', error);\n    }\n\n    if (this.micStream) return;\n\n    try {\n      const stream = await navigator.mediaDevices.getUserMedia({\n        audio: true,\n        video: false,\n      });\n      this.micStream = stream;\n\n      const analyser = this.createAnalyser(ctx, this.micConfig);\n      this.micAnalyser = analyser;\n      this.micData = new Uint8Array(\n        analyser.frequencyBinCount,\n      ) as Uint8Array<ArrayBuffer>;\n      this.micWaveformData = new Uint8Array(\n        analyser.fftSize,\n      ) as Uint8Array<ArrayBuffer>;\n\n      const source = ctx.createMediaStreamSource(stream);\n      source.connect(analyser);\n      this.micSource = source;\n\n      this.setState({ micActive: true, micError: null });\n      this.options.onMicStart?.();\n    } catch (error) {\n      throw this.handleError('mic', error, 'mic_error');\n    }\n  }\n\n  disableMic(): void {\n    const hadMic = Boolean(this.micStream || this.micSource || this.micAnalyser);\n    this.micStream?.getTracks().forEach((track) => track.stop());\n    this.micStream = null;\n\n    try {\n      this.micSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.micSource = null;\n    this.micAnalyser = null;\n    this.micData = null;\n    this.micWaveformData = null;\n    this.setState({ micActive: false });\n\n    if (hadMic) this.options.onMicStop?.();\n  }\n\n  getBands(source: AudioSource = 'music'): Bands {\n    const data = this.readFrequencyData(source);\n    if (!data) return { ...ZERO };\n    return computeBands(data, this.classicRanges);\n  }\n\n  getFftData(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readFrequencyData(source);\n  }\n\n  getWaveform(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readWaveformData(source);\n  }\n\n  snapshot(source: AudioSource = 'music'): AudioBandsSnapshot {\n    const fft = this.readFrequencyData(source);\n    const waveform = this.readWaveformData(source);\n\n    return {\n      bands: fft ? computeBands(fft, this.classicRanges) : { ...ZERO },\n      customBands: fft\n        ? computeCustomBands(fft, this.customBandRanges)\n        : computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges),\n      fft,\n      waveform,\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n\n    this.teardownMusic();\n    this.disableMic();\n    void this.ctx?.close();\n    this.ctx = null;\n    this.musicAnalyser = null;\n    this.musicData = null;\n    this.musicWaveformData = null;\n    this.setState({ isPlaying: false, micActive: false, hasTrack: false });\n    this.options = {};\n    this.destroyed = true;\n  }\n\n  private readFrequencyData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return null;\n      return fillFrequencyData(this.micAnalyser, this.micData);\n    }\n\n    if (!this.musicAnalyser || !this.musicData) return null;\n    return fillFrequencyData(this.musicAnalyser, this.musicData);\n  }\n\n  private readWaveformData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micWaveformData) return null;\n      this.micAnalyser.getByteTimeDomainData(this.micWaveformData);\n      return this.micWaveformData;\n    }\n\n    if (!this.musicAnalyser || !this.musicWaveformData) return null;\n    this.musicAnalyser.getByteTimeDomainData(this.musicWaveformData);\n    return this.musicWaveformData;\n  }\n\n  private ensureCtx(): AudioContext {\n    if (this.destroyed) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'destroyed',\n        'This AudioBands instance was destroyed',\n      );\n    }\n\n    if (this.ctx) return this.ctx;\n\n    const Ctx =\n      window.AudioContext ||\n      (window as unknown as { webkitAudioContext?: typeof AudioContext })\n        .webkitAudioContext;\n\n    if (!Ctx) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'unsupported_audio_context',\n        'AudioContext is not supported in this environment',\n      );\n    }\n\n    const ctx = new Ctx();\n    const analyser = this.createAnalyser(ctx, this.musicConfig);\n    analyser.connect(ctx.destination);\n\n    this.ctx = ctx;\n    this.musicAnalyser = analyser;\n    this.musicData = new Uint8Array(\n      analyser.frequencyBinCount,\n    ) as Uint8Array<ArrayBuffer>;\n    this.musicWaveformData = new Uint8Array(\n      analyser.fftSize,\n    ) as Uint8Array<ArrayBuffer>;\n\n    return ctx;\n  }\n\n  private createAnalyser(\n    ctx: AudioContext,\n    config: Required<AudioAnalyserConfig>,\n  ): AnalyserNode {\n    const analyser = ctx.createAnalyser();\n    analyser.fftSize = config.fftSize;\n    analyser.smoothingTimeConstant = config.smoothingTimeConstant;\n    return analyser;\n  }\n\n  private handleError(\n    kind: 'load' | 'playback' | 'mic',\n    error: unknown,\n    fallbackCode: 'load_error' | 'playback_error' | 'mic_error' = kind === 'mic'\n      ? 'mic_error'\n      : kind === 'playback'\n        ? 'playback_error'\n        : 'load_error',\n  ): AudioBandsError {\n    const wrapped =\n      error instanceof AudioBandsError\n        ? error\n        : new AudioBandsError(\n            kind,\n            fallbackCode,\n            kind === 'mic'\n              ? 'Failed to access microphone input'\n              : kind === 'playback'\n                ? 'Failed to play audio track'\n                : 'Failed to load audio track',\n            error,\n          );\n\n    if (kind === 'load') {\n      this.setState({ isPlaying: false, loadError: wrapped });\n      this.options.onLoadError?.(wrapped);\n    } else if (kind === 'playback') {\n      this.setState({ isPlaying: false, playbackError: wrapped });\n      this.options.onPlaybackError?.(wrapped);\n    } else {\n      this.setState({ micActive: false, micError: wrapped });\n      this.options.onMicError?.(wrapped);\n    }\n\n    this.options.onError?.(wrapped);\n    return wrapped;\n  }\n\n  private setState(patch: Partial<AudioBandsState>): void {\n    let changed = false;\n\n    for (const [key, value] of Object.entries(patch) as Array<\n      [keyof AudioBandsState, AudioBandsState[keyof AudioBandsState]]\n    >) {\n      if (this.state[key] !== value) {\n        this.state[key] = value as never;\n        changed = true;\n      }\n    }\n\n    if (changed) this.options.onStateChange?.(this.getState());\n  }\n\n  private teardownMusic(): void {\n    this.audioEl?.pause();\n    if (this.audioEl) {\n      this.audioEl.src = '';\n      this.audioEl.load();\n    }\n    this.audioEl = null;\n\n    try {\n      this.musicSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.musicSource = null;\n    this.musicWaveformData = this.musicAnalyser\n      ? new Uint8Array(this.musicAnalyser.fftSize) as Uint8Array<ArrayBuffer>\n      : null;\n    this.setState({\n      isPlaying: false,\n      hasTrack: false,\n      playbackError: null,\n    });\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/core-entry.ts","../src/errors.ts","../src/core.ts"],"sourcesContent":["export { AudioBands } from './core';\nexport { AudioBandsError } from './errors';\nexport type {\n  AudioAnalyserConfig,\n  AudioBandsCallbacks,\n  AudioBandsErrorCode,\n  AudioBandsErrorKind,\n  AudioBandsOptions,\n  AudioBandsSnapshot,\n  AudioBandsState,\n  AudioSource,\n  BandRange,\n  Bands,\n  ClassicBandRanges,\n  CustomBandRanges,\n} from './types';\n","import type { AudioBandsErrorCode, AudioBandsErrorKind } from './types';\n\nexport class AudioBandsError extends Error {\n  readonly kind: AudioBandsErrorKind;\n  readonly code: AudioBandsErrorCode;\n  readonly cause?: unknown;\n\n  constructor(\n    kind: AudioBandsErrorKind,\n    code: AudioBandsErrorCode,\n    message: string,\n    cause?: unknown,\n  ) {\n    super(message);\n    this.name = 'AudioBandsError';\n    this.kind = kind;\n    this.code = code;\n    this.cause = cause;\n  }\n}\n","import { AudioBandsError } from './errors';\nimport type {\n  AudioAnalyserConfig,\n  AudioBandsOptions,\n  AudioBandsSnapshot,\n  AudioBandsState,\n  AudioSource,\n  BandRange,\n  Bands,\n  ClassicBandRanges,\n  CustomBandRanges,\n} from './types';\n\nconst DEFAULT_MUSIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.85,\n};\n\nconst DEFAULT_MIC_ANALYSER: Required<AudioAnalyserConfig> = {\n  fftSize: 256,\n  smoothingTimeConstant: 0.8,\n};\n\nconst DEFAULT_CLASSIC_RANGES: Record<keyof Omit<Bands, 'overall'>, BandRange> = {\n  bass: { from: 0, to: 0.08 },\n  mid: { from: 0.08, to: 0.4 },\n  high: { from: 0.4, to: 1 },\n};\n\nconst ZERO: Bands = { bass: 0, mid: 0, high: 0, overall: 0 };\n\nfunction avg(arr: Uint8Array<ArrayBuffer>, from: number, to: number): number {\n  let sum = 0;\n  for (let i = from; i < to; i++) sum += arr[i];\n  return sum / (to - from);\n}\n\nfunction isPowerOfTwo(value: number): boolean {\n  return (value & (value - 1)) === 0;\n}\n\nfunction normalizeAnalyserConfig(\n  config: AudioAnalyserConfig | undefined,\n  fallback: Required<AudioAnalyserConfig>,\n): Required<AudioAnalyserConfig> {\n  const fftSize = config?.fftSize ?? fallback.fftSize;\n  const smoothingTimeConstant =\n    config?.smoothingTimeConstant ?? fallback.smoothingTimeConstant;\n\n  if (\n    !Number.isInteger(fftSize) ||\n    fftSize < 32 ||\n    fftSize > 32768 ||\n    !isPowerOfTwo(fftSize)\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'fftSize must be a power of two between 32 and 32768',\n    );\n  }\n\n  if (\n    typeof smoothingTimeConstant !== 'number' ||\n    smoothingTimeConstant < 0 ||\n    smoothingTimeConstant > 1\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      'smoothingTimeConstant must be between 0 and 1',\n    );\n  }\n\n  return { fftSize, smoothingTimeConstant };\n}\n\nfunction normalizeRange(name: string, range: BandRange | undefined): BandRange {\n  const normalized = range ?? DEFAULT_CLASSIC_RANGES[name as keyof typeof DEFAULT_CLASSIC_RANGES];\n\n  if (\n    typeof normalized?.from !== 'number' ||\n    typeof normalized?.to !== 'number' ||\n    normalized.from < 0 ||\n    normalized.to > 1 ||\n    normalized.from >= normalized.to\n  ) {\n    throw new AudioBandsError(\n      'config',\n      'invalid_config',\n      `Band range \"${name}\" must satisfy 0 <= from < to <= 1`,\n    );\n  }\n\n  return normalized;\n}\n\nfunction normalizeClassicRanges(\n  ranges: ClassicBandRanges | undefined,\n): Record<keyof Omit<Bands, 'overall'>, BandRange> {\n  return {\n    bass: normalizeRange('bass', ranges?.bass),\n    mid: normalizeRange('mid', ranges?.mid),\n    high: normalizeRange('high', ranges?.high),\n  };\n}\n\nfunction normalizeCustomBands(customBands: CustomBandRanges | undefined): CustomBandRanges {\n  if (!customBands) return {};\n\n  return Object.fromEntries(\n    Object.entries(customBands).map(([name, range]) => [name, normalizeRange(name, range)]),\n  );\n}\n\nfunction getIndexes(len: number, range: BandRange): [number, number] {\n  const from = Math.max(0, Math.min(len - 1, Math.floor(len * range.from)));\n  const to = Math.max(from + 1, Math.min(len, Math.floor(len * range.to)));\n  return [from, to];\n}\n\nfunction getRangeValue(data: Uint8Array<ArrayBuffer>, range: BandRange): number {\n  const [from, to] = getIndexes(data.length, range);\n  return avg(data, from, to) / 255;\n}\n\nfunction fillFrequencyData(\n  analyser: AnalyserNode,\n  data: Uint8Array<ArrayBuffer>,\n): Uint8Array<ArrayBuffer> {\n  analyser.getByteFrequencyData(data);\n  return data;\n}\n\nfunction computeBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: Record<keyof Omit<Bands, 'overall'>, BandRange>,\n): Bands {\n  const bass = getRangeValue(data, ranges.bass);\n  const mid = getRangeValue(data, ranges.mid);\n  const high = getRangeValue(data, ranges.high);\n\n  return {\n    bass,\n    mid,\n    high,\n    overall: bass * 0.5 + mid * 0.3 + high * 0.2,\n  };\n}\n\nfunction computeCustomBands(\n  data: Uint8Array<ArrayBuffer>,\n  ranges: CustomBandRanges,\n): Record<string, number> {\n  return Object.fromEntries(\n    Object.entries(ranges).map(([name, range]) => [name, getRangeValue(data, range)]),\n  );\n}\n\nfunction cloneState(state: AudioBandsState): AudioBandsState {\n  return { ...state };\n}\n\n/**\n * Vanilla JS class — no framework dependency.\n * Works in React, Vue, Svelte, or plain HTML.\n */\nexport class AudioBands {\n  private options: AudioBandsOptions;\n  private readonly musicConfig: Required<AudioAnalyserConfig>;\n  private readonly micConfig: Required<AudioAnalyserConfig>;\n  private readonly classicRanges: Record<keyof Omit<Bands, 'overall'>, BandRange>;\n  private readonly customBandRanges: CustomBandRanges;\n\n  private readonly state: AudioBandsState = {\n    isPlaying: false,\n    micActive: false,\n    hasTrack: false,\n    loadError: null,\n    playbackError: null,\n    micError: null,\n  };\n\n  private ctx: AudioContext | null = null;\n  private musicAnalyser: AnalyserNode | null = null;\n  private musicData: Uint8Array<ArrayBuffer> | null = null;\n  private musicWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private micAnalyser: AnalyserNode | null = null;\n  private micData: Uint8Array<ArrayBuffer> | null = null;\n  private micWaveformData: Uint8Array<ArrayBuffer> | null = null;\n  private audioEl: HTMLAudioElement | null = null;\n  private musicSource: MediaElementAudioSourceNode | null = null;\n  private micSource: MediaStreamAudioSourceNode | null = null;\n  private micStream: MediaStream | null = null;\n  private musicEventCleanup: (() => void) | null = null;\n  private pendingLoadCleanup: (() => void) | null = null;\n  private pendingLoadReject: ((error: AudioBandsError) => void) | null = null;\n  private trackLoop = false;\n  private destroyed = false;\n\n  constructor(options: AudioBandsOptions = {}) {\n    this.options = options;\n    this.musicConfig = normalizeAnalyserConfig(options.music, DEFAULT_MUSIC_ANALYSER);\n    this.micConfig = normalizeAnalyserConfig(options.mic, DEFAULT_MIC_ANALYSER);\n    this.classicRanges = normalizeClassicRanges(options.bandRanges);\n    this.customBandRanges = normalizeCustomBands(options.customBands);\n  }\n\n  getState(): AudioBandsState {\n    return cloneState(this.state);\n  }\n\n  getCustomBands(source: AudioSource = 'music'): Record<string, number> {\n    const data = this.readFrequencyData(source);\n    if (!data) return computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges);\n    return computeCustomBands(data, this.customBandRanges);\n  }\n\n  async load(url: string): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('load', error, 'load_error');\n    }\n\n    this.teardownMusic();\n\n    const audio = new Audio();\n    audio.crossOrigin = 'anonymous';\n    audio.preload = 'auto';\n    audio.src = url;\n    audio.loop = this.trackLoop;\n    this.bindMusicElementEvents(audio);\n    this.audioEl = audio;\n    this.setState({ hasTrack: false, loadError: null, playbackError: null });\n\n    const source = ctx.createMediaElementSource(audio);\n    source.connect(this.musicAnalyser!);\n    this.musicSource = source;\n\n    await new Promise<void>((resolve, reject) => {\n      const finalize = () => {\n        cleanup();\n        this.pendingLoadCleanup = null;\n        this.pendingLoadReject = null;\n      };\n\n      const handleReady = () => {\n        finalize();\n        this.setState({ hasTrack: true, loadError: null });\n        resolve();\n      };\n\n      const handleFailure = (event?: Event) => {\n        finalize();\n        const mediaError =\n          (event?.target as HTMLMediaElement | null)?.error ??\n          audio.error ??\n          event;\n        reject(this.handleLoadFailure(mediaError));\n      };\n\n      const cleanup = () => {\n        audio.removeEventListener('loadedmetadata', handleReady);\n        audio.removeEventListener('canplay', handleReady);\n        audio.removeEventListener('error', handleFailure);\n      };\n\n      this.pendingLoadCleanup = cleanup;\n      this.pendingLoadReject = reject;\n\n      audio.addEventListener('loadedmetadata', handleReady, { once: true });\n      audio.addEventListener('canplay', handleReady, { once: true });\n      audio.addEventListener('error', handleFailure, { once: true });\n      audio.load();\n    });\n  }\n\n  async play(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    try {\n      await audio.play();\n      this.setState({ playbackError: null });\n    } catch (error) {\n      throw this.handleError('playback', error, 'playback_error');\n    }\n  }\n\n  pause(): void {\n    const audio = this.audioEl;\n    if (!audio || audio.paused) return;\n\n    audio.pause();\n  }\n\n  async togglePlayPause(): Promise<void> {\n    const audio = this.audioEl;\n    if (!audio) return;\n\n    if (audio.paused) {\n      await this.play();\n      return;\n    }\n\n    this.pause();\n  }\n\n  setLoop(loop: boolean): void {\n    this.trackLoop = loop;\n    if (this.audioEl) this.audioEl.loop = loop;\n  }\n\n  seek(seconds: number): void {\n    if (!Number.isFinite(seconds) || seconds < 0) {\n      throw new AudioBandsError(\n        'config',\n        'invalid_config',\n        'seek time must be a finite number greater than or equal to 0',\n      );\n    }\n\n    if (!this.audioEl) return;\n\n    const duration = Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n    this.audioEl.currentTime = duration === null ? seconds : Math.min(seconds, duration);\n  }\n\n  getDuration(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.duration) ? this.audioEl.duration : null;\n  }\n\n  getCurrentTime(): number | null {\n    if (!this.audioEl) return null;\n    return Number.isFinite(this.audioEl.currentTime) ? this.audioEl.currentTime : null;\n  }\n\n  async enableMic(): Promise<void> {\n    let ctx: AudioContext;\n    try {\n      ctx = this.ensureCtx();\n    } catch (error) {\n      throw this.handleError('mic', error);\n    }\n\n    if (this.micStream) return;\n\n    try {\n      const stream = await navigator.mediaDevices.getUserMedia({\n        audio: true,\n        video: false,\n      });\n      this.micStream = stream;\n\n      const analyser = this.createAnalyser(ctx, this.micConfig);\n      this.micAnalyser = analyser;\n      this.micData = new Uint8Array(\n        analyser.frequencyBinCount,\n      ) as Uint8Array<ArrayBuffer>;\n      this.micWaveformData = new Uint8Array(\n        analyser.fftSize,\n      ) as Uint8Array<ArrayBuffer>;\n\n      const source = ctx.createMediaStreamSource(stream);\n      source.connect(analyser);\n      this.micSource = source;\n\n      this.setState({ micActive: true, micError: null });\n      this.options.onMicStart?.();\n    } catch (error) {\n      throw this.handleError('mic', error, 'mic_error');\n    }\n  }\n\n  disableMic(): void {\n    const hadMic = Boolean(this.micStream || this.micSource || this.micAnalyser);\n    this.micStream?.getTracks().forEach((track) => track.stop());\n    this.micStream = null;\n\n    try {\n      this.micSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.micSource = null;\n    this.micAnalyser = null;\n    this.micData = null;\n    this.micWaveformData = null;\n    this.setState({ micActive: false });\n\n    if (hadMic) this.options.onMicStop?.();\n  }\n\n  getBands(source: AudioSource = 'music'): Bands {\n    const data = this.readFrequencyData(source);\n    if (!data) return { ...ZERO };\n    return computeBands(data, this.classicRanges);\n  }\n\n  getFftData(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readFrequencyData(source);\n  }\n\n  getWaveform(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    return this.readWaveformData(source);\n  }\n\n  snapshot(source: AudioSource = 'music'): AudioBandsSnapshot {\n    const fft = this.readFrequencyData(source);\n    const waveform = this.readWaveformData(source);\n\n    return {\n      bands: fft ? computeBands(fft, this.classicRanges) : { ...ZERO },\n      customBands: fft\n        ? computeCustomBands(fft, this.customBandRanges)\n        : computeCustomBands(new Uint8Array(1) as Uint8Array<ArrayBuffer>, this.customBandRanges),\n      fft,\n      waveform,\n    };\n  }\n\n  destroy(): void {\n    if (this.destroyed) return;\n\n    this.teardownMusic();\n    this.disableMic();\n    void this.ctx?.close();\n    this.ctx = null;\n    this.musicAnalyser = null;\n    this.musicData = null;\n    this.musicWaveformData = null;\n    this.setState({ isPlaying: false, micActive: false, hasTrack: false });\n    this.options = {};\n    this.destroyed = true;\n  }\n\n  private readFrequencyData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return null;\n      return fillFrequencyData(this.micAnalyser, this.micData);\n    }\n\n    if (!this.musicAnalyser || !this.musicData) return null;\n    return fillFrequencyData(this.musicAnalyser, this.musicData);\n  }\n\n  private readWaveformData(source: AudioSource): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micWaveformData) return null;\n      this.micAnalyser.getByteTimeDomainData(this.micWaveformData);\n      return this.micWaveformData;\n    }\n\n    if (!this.musicAnalyser || !this.musicWaveformData) return null;\n    this.musicAnalyser.getByteTimeDomainData(this.musicWaveformData);\n    return this.musicWaveformData;\n  }\n\n  private ensureCtx(): AudioContext {\n    if (this.destroyed) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'destroyed',\n        'This AudioBands instance was destroyed',\n      );\n    }\n\n    if (this.ctx) return this.ctx;\n\n    const Ctx =\n      window.AudioContext ||\n      (window as unknown as { webkitAudioContext?: typeof AudioContext })\n        .webkitAudioContext;\n\n    if (!Ctx) {\n      throw new AudioBandsError(\n        'lifecycle',\n        'unsupported_audio_context',\n        'AudioContext is not supported in this environment',\n      );\n    }\n\n    const ctx = new Ctx();\n    const analyser = this.createAnalyser(ctx, this.musicConfig);\n    analyser.connect(ctx.destination);\n\n    this.ctx = ctx;\n    this.musicAnalyser = analyser;\n    this.musicData = new Uint8Array(\n      analyser.frequencyBinCount,\n    ) as Uint8Array<ArrayBuffer>;\n    this.musicWaveformData = new Uint8Array(\n      analyser.fftSize,\n    ) as Uint8Array<ArrayBuffer>;\n\n    return ctx;\n  }\n\n  private createAnalyser(\n    ctx: AudioContext,\n    config: Required<AudioAnalyserConfig>,\n  ): AnalyserNode {\n    const analyser = ctx.createAnalyser();\n    analyser.fftSize = config.fftSize;\n    analyser.smoothingTimeConstant = config.smoothingTimeConstant;\n    return analyser;\n  }\n\n  private handleError(\n    kind: 'load' | 'playback' | 'mic',\n    error: unknown,\n    fallbackCode: 'load_error' | 'playback_error' | 'mic_error' = kind === 'mic'\n      ? 'mic_error'\n      : kind === 'playback'\n        ? 'playback_error'\n        : 'load_error',\n  ): AudioBandsError {\n    const wrapped =\n      error instanceof AudioBandsError\n        ? error\n        : new AudioBandsError(\n            kind,\n            fallbackCode,\n            kind === 'mic'\n              ? 'Failed to access microphone input'\n              : kind === 'playback'\n                ? 'Failed to play audio track'\n                : 'Failed to load audio track',\n            error,\n          );\n\n    if (kind === 'load') {\n      this.setState({ isPlaying: false, loadError: wrapped });\n      this.options.onLoadError?.(wrapped);\n    } else if (kind === 'playback') {\n      this.setState({ isPlaying: false, playbackError: wrapped });\n      this.options.onPlaybackError?.(wrapped);\n    } else {\n      this.setState({ micActive: false, micError: wrapped });\n      this.options.onMicError?.(wrapped);\n    }\n\n    this.options.onError?.(wrapped);\n    return wrapped;\n  }\n\n  private bindMusicElementEvents(audio: HTMLAudioElement): void {\n    this.musicEventCleanup?.();\n\n    const handlePlay = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: true, playbackError: null });\n      this.options.onPlay?.();\n    };\n\n    const handlePause = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: false });\n      this.options.onPause?.();\n    };\n\n    const handleEnded = () => {\n      if (this.audioEl !== audio) return;\n      this.setState({ isPlaying: false });\n    };\n\n    audio.addEventListener('play', handlePlay);\n    audio.addEventListener('pause', handlePause);\n    audio.addEventListener('ended', handleEnded);\n\n    this.musicEventCleanup = () => {\n      audio.removeEventListener('play', handlePlay);\n      audio.removeEventListener('pause', handlePause);\n      audio.removeEventListener('ended', handleEnded);\n      if (this.musicEventCleanup) this.musicEventCleanup = null;\n    };\n  }\n\n  private handleLoadFailure(error: unknown): AudioBandsError {\n    this.teardownMusic();\n    return this.handleError('load', error, 'load_error');\n  }\n\n  private setState(patch: Partial<AudioBandsState>): void {\n    let changed = false;\n\n    for (const [key, value] of Object.entries(patch) as Array<\n      [keyof AudioBandsState, AudioBandsState[keyof AudioBandsState]]\n    >) {\n      if (this.state[key] !== value) {\n        this.state[key] = value as never;\n        changed = true;\n      }\n    }\n\n    if (changed) this.options.onStateChange?.(this.getState());\n  }\n\n  private teardownMusic(): void {\n    this.musicEventCleanup?.();\n    if (this.pendingLoadReject) {\n      const reject = this.pendingLoadReject;\n      this.pendingLoadReject = null;\n      this.pendingLoadCleanup?.();\n      this.pendingLoadCleanup = null;\n      reject(\n        new AudioBandsError(\n          'load',\n          'load_error',\n          'Audio track loading was interrupted before completion',\n        ),\n      );\n    } else if (this.pendingLoadCleanup) {\n      this.pendingLoadCleanup();\n      this.pendingLoadCleanup = null;\n    }\n    this.audioEl?.pause();\n    if (this.audioEl) {\n      this.audioEl.src = '';\n      this.audioEl.load();\n    }\n    this.audioEl = null;\n\n    try {\n      this.musicSource?.disconnect();\n    } catch {\n      /* already disconnected */\n    }\n\n    this.musicSource = null;\n    this.musicWaveformData = this.musicAnalyser\n      ? new Uint8Array(this.musicAnalyser.fftSize) as Uint8Array<ArrayBuffer>\n      : null;\n    this.setState({\n      isPlaying: false,\n      hasTrack: false,\n      playbackError: null,\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core-entry.d.cts

@@ -23,6 +23,9 @@ declare class AudioBands {
     private musicSource;
     private micSource;
     private micStream;
+    private musicEventCleanup;
+    private pendingLoadCleanup;
+    private pendingLoadReject;
     private trackLoop;
     private destroyed;
     constructor(options?: AudioBandsOptions);
@@ -48,6 +51,8 @@ declare class AudioBands {
     private ensureCtx;
     private createAnalyser;
     private handleError;
+    private bindMusicElementEvents;
+    private handleLoadFailure;
     private setState;
     private teardownMusic;
 }

package/dist/core-entry.d.ts

@@ -23,6 +23,9 @@ declare class AudioBands {
     private musicSource;
     private micSource;
     private micStream;
+    private musicEventCleanup;
+    private pendingLoadCleanup;
+    private pendingLoadReject;
     private trackLoop;
     private destroyed;
     constructor(options?: AudioBandsOptions);
@@ -48,6 +51,8 @@ declare class AudioBands {
     private ensureCtx;
     private createAnalyser;
     private handleError;
+    private bindMusicElementEvents;
+    private handleLoadFailure;
     private setState;
     private teardownMusic;
 }

package/dist/core-entry.js

@@ -1,7 +1,7 @@
 import {
   AudioBands,
   AudioBandsError
-} from "./chunk-BA6JOXL4.js";
+} from "./chunk-EGVVFGLZ.js";
 export {
   AudioBands,
   AudioBandsError