@juandinella/audio-bands 0.1.0

package/README.md

@@ -0,0 +1,187 @@
+# audio-bands
+
+Headless audio frequency analysis for the browser. Get real-time `bass`, `mid`, and `high` values normalized to `0–1` from a music track, a microphone, or both at the same time. No renderer included.
+
+```ts
+const { bass, mid, high } = audio.getBands();
+// bass: 0.73, mid: 0.41, high: 0.12
+
+const fft = audio.getFftData();
+// Uint8Array(128) — raw frequency bins, 0–255 each
+```
+
+## Why
+
+Every audio visualization library either handles only playback (no analysis) or draws its own canvas and hides the data. This one only gives you numbers.
+
+## Install
+
+```bash
+npm install @juandinella/audio-bands
+```
+
+React is an optional peer dependency. The core class works in any framework or plain HTML.
+
+## Usage
+
+### Vanilla JS
+
+Works in Vue, Svelte, plain HTML — anything.
+
+```js
+import { AudioBands } from '@juandinella/audio-bands';
+
+const audio = new AudioBands({
+  onPlay: () => console.log('playing'),
+  onPause: () => console.log('paused'),
+  onError: () => console.error('failed to load'),
+  onMicStart: () => console.log('mic on'),
+  onMicStop: () => console.log('mic off'),
+});
+
+await audio.load('/track.mp3');
+
+// Call inside your animation loop
+function loop() {
+  const { bass, mid, high, overall } = audio.getBands();
+  // drive your canvas, SVG, CSS, WebGL — whatever
+
+  const fft = audio.getFftData(); // raw bins for spectrum visualizations
+  requestAnimationFrame(loop);
+}
+requestAnimationFrame(loop);
+
+// Clean up when done
+audio.destroy();
+```
+
+### React hook
+
+```tsx
+import { useAudioBands } from '@juandinella/audio-bands';
+import { useEffect, useRef } from 'react';
+
+function Visualizer() {
+  const { loadTrack, togglePlayPause, toggleMic, getBands, isPlaying } = useAudioBands();
+  const canvasRef = useRef<HTMLCanvasElement>(null);
+
+  useEffect(() => {
+    loadTrack('/track.mp3');
+  }, []);
+
+  useEffect(() => {
+    const canvas = canvasRef.current!;
+    const ctx = canvas.getContext('2d')!;
+    let raf: number;
+
+    function loop() {
+      const { bass, mid, high } = getBands();
+
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+      ctx.beginPath();
+      ctx.arc(canvas.width / 2, canvas.height / 2, 20 + bass * 80, 0, Math.PI * 2);
+      ctx.fill();
+
+      raf = requestAnimationFrame(loop);
+    }
+
+    raf = requestAnimationFrame(loop);
+    return () => cancelAnimationFrame(raf);
+  }, [getBands]);
+
+  return (
+    <>
+      <canvas ref={canvasRef} width={400} height={400} />
+      <button onClick={togglePlayPause}>{isPlaying ? 'Pause' : 'Play'}</button>
+      <button onClick={toggleMic}>Toggle mic</button>
+    </>
+  );
+}
+```
+
+### Mic input
+
+```ts
+// Enable mic — browser will ask for permission
+await audio.enableMic();
+
+// Get frequency bands from the mic
+const { bass } = audio.getBands('mic');
+
+// Get raw waveform data (time-domain)
+const waveform = audio.getWaveform(); // Uint8Array | null
+
+// Disable mic and stop the stream
+audio.disableMic();
+```
+
+## API
+
+### `AudioBands` (vanilla JS)
+
+```ts
+new AudioBands(callbacks?: AudioBandsCallbacks)
+```
+
+| Method | Description |
+|---|---|
+| `load(url)` | Load and play an audio file. Resolves when playback starts. |
+| `togglePlayPause()` | Toggle playback. |
+| `enableMic()` | Request mic access and start analysis. |
+| `disableMic()` | Stop mic stream and clean up. |
+| `getBands(source?)` | Returns `Bands` for `'music'` (default) or `'mic'`. Call inside RAF. |
+| `getFftData(source?)` | Returns raw `Uint8Array` of frequency bins (0–255) for `'music'` or `'mic'`. Call inside RAF. |
+| `getWaveform()` | Returns raw time-domain `Uint8Array` from mic. Call inside RAF. |
+| `destroy()` | Stop playback, release mic, close AudioContext. |
+
+### `useAudioBands()` (React)
+
+Same capabilities as `AudioBands`. `destroy()` is called automatically on unmount.
+
+```ts
+const {
+  isPlaying,
+  micActive,
+  audioError,
+  loadTrack,
+  togglePlayPause,
+  toggleMic,
+  getBands,
+  getFftData,
+  getWaveform,
+} = useAudioBands();
+```
+
+### `Bands`
+
+```ts
+type Bands = {
+  bass: number;    // 0–1 — low frequencies (0–8% of spectrum)
+  mid: number;     // 0–1 — mid frequencies (8–40%)
+  high: number;    // 0–1 — high frequencies (40–100%)
+  overall: number; // 0–1 — weighted mix: bass×0.5 + mid×0.3 + high×0.2
+};
+```
+
+### `AudioBandsCallbacks`
+
+```ts
+type AudioBandsCallbacks = {
+  onPlay?: () => void;
+  onPause?: () => void;
+  onError?: () => void;
+  onMicStart?: () => void;
+  onMicStop?: () => void;
+};
+```
+
+## Notes
+
+- `AudioContext` is created lazily on the first call to `load()` or `enableMic()`. Browsers require a user gesture before audio can start.
+- The mic analyser is **not** connected to `AudioContext.destination`, so there is no feedback loop.
+- `getBands()`, `getFftData()`, and `getWaveform()` read live data from the audio graph. Call them inside `requestAnimationFrame`, not in response to React state.
+- `getFftData()` returns the same underlying buffer on every call. Copy it if you need to compare frames: `Array.from(fft)`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,235 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AudioBands: () => AudioBands,
+  useAudioBands: () => useAudioBands
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/core.ts
+var ZERO = { bass: 0, mid: 0, high: 0, overall: 0 };
+function avg(arr, from, to) {
+  let sum = 0;
+  for (let i = from; i < to; i++) sum += arr[i];
+  return sum / (to - from);
+}
+function computeBands(analyser, data) {
+  analyser.getByteFrequencyData(data);
+  const len = data.length;
+  const bass = avg(data, 0, Math.floor(len * 0.08));
+  const mid = avg(data, Math.floor(len * 0.08), Math.floor(len * 0.4));
+  const high = avg(data, Math.floor(len * 0.4), len);
+  return {
+    bass: bass / 255,
+    mid: mid / 255,
+    high: high / 255,
+    overall: (bass * 0.5 + mid * 0.3 + high * 0.2) / 255
+  };
+}
+var AudioBands = class {
+  constructor(callbacks = {}) {
+    this.ctx = null;
+    this.musicAnalyser = null;
+    this.musicData = null;
+    this.micAnalyser = null;
+    this.micData = null;
+    this.micWaveformData = null;
+    this.audioEl = null;
+    this.musicSource = null;
+    this.micSource = null;
+    this.micStream = null;
+    this.callbacks = callbacks;
+  }
+  // Lazy — AudioContext must be created after a user gesture
+  ensureCtx() {
+    if (this.ctx) return this.ctx;
+    const Ctx = window.AudioContext || window.webkitAudioContext;
+    const ctx = new Ctx();
+    const analyser = ctx.createAnalyser();
+    analyser.fftSize = 256;
+    analyser.smoothingTimeConstant = 0.85;
+    analyser.connect(ctx.destination);
+    this.ctx = ctx;
+    this.musicAnalyser = analyser;
+    this.musicData = new Uint8Array(analyser.frequencyBinCount);
+    return ctx;
+  }
+  async load(url) {
+    const ctx = this.ensureCtx();
+    this.audioEl?.pause();
+    if (this.audioEl) this.audioEl.src = "";
+    try {
+      this.musicSource?.disconnect();
+    } catch {
+    }
+    const audio = new Audio();
+    audio.crossOrigin = "anonymous";
+    audio.src = url;
+    audio.loop = true;
+    this.audioEl = audio;
+    const source = ctx.createMediaElementSource(audio);
+    source.connect(this.musicAnalyser);
+    this.musicSource = source;
+    try {
+      await audio.play();
+      this.callbacks.onPlay?.();
+    } catch {
+      this.callbacks.onError?.();
+    }
+  }
+  togglePlayPause() {
+    const audio = this.audioEl;
+    if (!audio) return;
+    if (audio.paused) {
+      audio.play();
+      this.callbacks.onPlay?.();
+    } else {
+      audio.pause();
+      this.callbacks.onPause?.();
+    }
+  }
+  async enableMic() {
+    const ctx = this.ensureCtx();
+    try {
+      const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
+      this.micStream = stream;
+      const analyser = ctx.createAnalyser();
+      analyser.fftSize = 256;
+      analyser.smoothingTimeConstant = 0.8;
+      this.micAnalyser = analyser;
+      this.micData = new Uint8Array(analyser.frequencyBinCount);
+      this.micWaveformData = new Uint8Array(analyser.fftSize);
+      const source = ctx.createMediaStreamSource(stream);
+      source.connect(analyser);
+      this.micSource = source;
+      this.callbacks.onMicStart?.();
+    } catch {
+      console.warn("[audio-bands] Mic access denied");
+    }
+  }
+  disableMic() {
+    this.micStream?.getTracks().forEach((t) => t.stop());
+    this.micStream = null;
+    try {
+      this.micSource?.disconnect();
+    } catch {
+    }
+    this.micSource = null;
+    this.micAnalyser = null;
+    this.micData = null;
+    this.micWaveformData = null;
+    this.callbacks.onMicStop?.();
+  }
+  // Call inside requestAnimationFrame to get current frequency data
+  getBands(source = "music") {
+    if (source === "mic") {
+      if (!this.micAnalyser || !this.micData) return { ...ZERO };
+      return computeBands(this.micAnalyser, this.micData);
+    }
+    if (!this.musicAnalyser || !this.musicData) return { ...ZERO };
+    return computeBands(this.musicAnalyser, this.musicData);
+  }
+  // Call inside requestAnimationFrame to get raw FFT frequency bins (0–255 per bin)
+  getFftData(source = "music") {
+    if (source === "mic") {
+      if (!this.micAnalyser || !this.micData) return null;
+      this.micAnalyser.getByteFrequencyData(this.micData);
+      return this.micData;
+    }
+    if (!this.musicAnalyser || !this.musicData) return null;
+    this.musicAnalyser.getByteFrequencyData(this.musicData);
+    return this.musicData;
+  }
+  // Call inside requestAnimationFrame to get raw time-domain waveform
+  getWaveform() {
+    if (!this.micAnalyser || !this.micWaveformData) return null;
+    this.micAnalyser.getByteTimeDomainData(this.micWaveformData);
+    return this.micWaveformData;
+  }
+  // Call when done — stops mic, closes AudioContext
+  destroy() {
+    this.audioEl?.pause();
+    this.micStream?.getTracks().forEach((t) => t.stop());
+    this.ctx?.close();
+  }
+};
+
+// src/react.ts
+var import_react = require("react");
+function useAudioBands() {
+  const [isPlaying, setIsPlaying] = (0, import_react.useState)(false);
+  const [micActive, setMicActive] = (0, import_react.useState)(false);
+  const [audioError, setAudioError] = (0, import_react.useState)(false);
+  const instance = (0, import_react.useRef)(null);
+  if (!instance.current) {
+    instance.current = new AudioBands({
+      onPlay: () => setIsPlaying(true),
+      onPause: () => setIsPlaying(false),
+      onError: () => setAudioError(true),
+      onMicStart: () => setMicActive(true),
+      onMicStop: () => setMicActive(false)
+    });
+  }
+  (0, import_react.useEffect)(() => {
+    return () => instance.current?.destroy();
+  }, []);
+  const loadTrack = (0, import_react.useCallback)(async (url) => {
+    setAudioError(false);
+    await instance.current.load(url);
+  }, []);
+  const togglePlayPause = (0, import_react.useCallback)(() => {
+    instance.current.togglePlayPause();
+  }, []);
+  const toggleMic = (0, import_react.useCallback)(async () => {
+    if (micActive) {
+      instance.current.disableMic();
+    } else {
+      await instance.current.enableMic();
+    }
+  }, [micActive]);
+  const getBands = (0, import_react.useCallback)((source) => {
+    return instance.current.getBands(source);
+  }, []);
+  const getFftData = (0, import_react.useCallback)((source) => {
+    return instance.current.getFftData(source);
+  }, []);
+  const getWaveform = (0, import_react.useCallback)(() => {
+    return instance.current.getWaveform();
+  }, []);
+  return {
+    isPlaying,
+    micActive,
+    audioError,
+    loadTrack,
+    togglePlayPause,
+    toggleMic,
+    getBands,
+    getFftData,
+    getWaveform
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AudioBands,
+  useAudioBands
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core.ts","../src/react.ts"],"sourcesContent":["// Vanilla JS — use in any framework or plain HTML\nexport { AudioBands } from './core';\n\n// React hook — wrapper over AudioBands\nexport { useAudioBands } from './react';\n\n// Types\nexport type { Bands, AudioSource, AudioBandsCallbacks } from './types';\nexport type { UseAudioBandsReturn } from './react';\n","import type { Bands, AudioSource, AudioBandsCallbacks } from './types';\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 computeBands(analyser: AnalyserNode, data: Uint8Array<ArrayBuffer>): Bands {\n  analyser.getByteFrequencyData(data);\n  const len = data.length;\n  const bass = avg(data, 0, Math.floor(len * 0.08));\n  const mid = avg(data, Math.floor(len * 0.08), Math.floor(len * 0.4));\n  const high = avg(data, Math.floor(len * 0.4), len);\n  return {\n    bass: bass / 255,\n    mid: mid / 255,\n    high: high / 255,\n    overall: (bass * 0.5 + mid * 0.3 + high * 0.2) / 255,\n  };\n}\n\n/**\n * Vanilla JS class — no framework dependency.\n * Works in React, Vue, Svelte, or plain HTML.\n *\n * Call destroy() when done to close the AudioContext and stop the mic.\n */\nexport class AudioBands {\n  private callbacks: AudioBandsCallbacks;\n\n  private ctx: AudioContext | null = null;\n  private musicAnalyser: AnalyserNode | null = null;\n  private musicData: 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\n  constructor(callbacks: AudioBandsCallbacks = {}) {\n    this.callbacks = callbacks;\n  }\n\n  // Lazy — AudioContext must be created after a user gesture\n  private ensureCtx(): AudioContext {\n    if (this.ctx) return this.ctx;\n\n    const Ctx =\n      window.AudioContext ||\n      (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;\n\n    const ctx = new Ctx();\n    const analyser = ctx.createAnalyser();\n    analyser.fftSize = 256;\n    analyser.smoothingTimeConstant = 0.85;\n    analyser.connect(ctx.destination);\n\n    this.ctx = ctx;\n    this.musicAnalyser = analyser;\n    this.musicData = new Uint8Array(analyser.frequencyBinCount) as Uint8Array<ArrayBuffer>;\n\n    return ctx;\n  }\n\n  async load(url: string): Promise<void> {\n    const ctx = this.ensureCtx();\n\n    this.audioEl?.pause();\n    if (this.audioEl) this.audioEl.src = '';\n    try { this.musicSource?.disconnect(); } catch { /* already disconnected */ }\n\n    const audio = new Audio();\n    audio.crossOrigin = 'anonymous';\n    audio.src = url;\n    audio.loop = true;\n    this.audioEl = audio;\n\n    const source = ctx.createMediaElementSource(audio);\n    source.connect(this.musicAnalyser!);\n    this.musicSource = source;\n\n    try {\n      await audio.play();\n      this.callbacks.onPlay?.();\n    } catch {\n      this.callbacks.onError?.();\n    }\n  }\n\n  togglePlayPause(): void {\n    const audio = this.audioEl;\n    if (!audio) return;\n    if (audio.paused) {\n      audio.play();\n      this.callbacks.onPlay?.();\n    } else {\n      audio.pause();\n      this.callbacks.onPause?.();\n    }\n  }\n\n  async enableMic(): Promise<void> {\n    const ctx = this.ensureCtx();\n\n    try {\n      const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });\n      this.micStream = stream;\n\n      const analyser = ctx.createAnalyser();\n      analyser.fftSize = 256;\n      analyser.smoothingTimeConstant = 0.8;\n      this.micAnalyser = analyser;\n      this.micData = new Uint8Array(analyser.frequencyBinCount) as Uint8Array<ArrayBuffer>;\n      this.micWaveformData = new Uint8Array(analyser.fftSize) as Uint8Array<ArrayBuffer>;\n\n      const source = ctx.createMediaStreamSource(stream);\n      source.connect(analyser);\n      // Not connected to destination — prevents mic feedback\n      this.micSource = source;\n\n      this.callbacks.onMicStart?.();\n    } catch {\n      console.warn('[audio-bands] Mic access denied');\n    }\n  }\n\n  disableMic(): void {\n    this.micStream?.getTracks().forEach((t) => t.stop());\n    this.micStream = null;\n    try { this.micSource?.disconnect(); } catch { /* already disconnected */ }\n    this.micSource = null;\n    this.micAnalyser = null;\n    this.micData = null;\n    this.micWaveformData = null;\n    this.callbacks.onMicStop?.();\n  }\n\n  // Call inside requestAnimationFrame to get current frequency data\n  getBands(source: AudioSource = 'music'): Bands {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return { ...ZERO };\n      return computeBands(this.micAnalyser, this.micData);\n    }\n    if (!this.musicAnalyser || !this.musicData) return { ...ZERO };\n    return computeBands(this.musicAnalyser, this.musicData);\n  }\n\n  // Call inside requestAnimationFrame to get raw FFT frequency bins (0–255 per bin)\n  getFftData(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return null;\n      this.micAnalyser.getByteFrequencyData(this.micData);\n      return this.micData;\n    }\n    if (!this.musicAnalyser || !this.musicData) return null;\n    this.musicAnalyser.getByteFrequencyData(this.musicData);\n    return this.musicData;\n  }\n\n  // Call inside requestAnimationFrame to get raw time-domain waveform\n  getWaveform(): Uint8Array<ArrayBuffer> | null {\n    if (!this.micAnalyser || !this.micWaveformData) return null;\n    this.micAnalyser.getByteTimeDomainData(this.micWaveformData);\n    return this.micWaveformData;\n  }\n\n  // Call when done — stops mic, closes AudioContext\n  destroy(): void {\n    this.audioEl?.pause();\n    this.micStream?.getTracks().forEach((t) => t.stop());\n    this.ctx?.close();\n  }\n}\n","'use client';\n\nimport { useRef, useState, useCallback, useEffect } from 'react';\nimport { AudioBands } from './core';\nimport type { Bands, AudioSource } from './types';\n\nexport type UseAudioBandsReturn = {\n  isPlaying: boolean;\n  micActive: boolean;\n  audioError: boolean;\n  loadTrack: (url: string) => Promise<void>;\n  togglePlayPause: () => void;\n  toggleMic: () => Promise<void>;\n  getBands: (source?: AudioSource) => Bands;\n  getFftData: (source?: AudioSource) => Uint8Array<ArrayBuffer> | null;\n  getWaveform: () => Uint8Array<ArrayBuffer> | null;\n};\n\n/**\n * React hook — thin wrapper over AudioBands.\n * Handles lifecycle (destroy on unmount) and exposes state for re-renders.\n */\nexport function useAudioBands(): UseAudioBandsReturn {\n  const [isPlaying, setIsPlaying] = useState(false);\n  const [micActive, setMicActive] = useState(false);\n  const [audioError, setAudioError] = useState(false);\n\n  const instance = useRef<AudioBands | null>(null);\n\n  if (!instance.current) {\n    instance.current = new AudioBands({\n      onPlay: () => setIsPlaying(true),\n      onPause: () => setIsPlaying(false),\n      onError: () => setAudioError(true),\n      onMicStart: () => setMicActive(true),\n      onMicStop: () => setMicActive(false),\n    });\n  }\n\n  useEffect(() => {\n    return () => instance.current?.destroy();\n  }, []);\n\n  const loadTrack = useCallback(async (url: string) => {\n    setAudioError(false);\n    await instance.current!.load(url);\n  }, []);\n\n  const togglePlayPause = useCallback(() => {\n    instance.current!.togglePlayPause();\n  }, []);\n\n  const toggleMic = useCallback(async () => {\n    if (micActive) {\n      instance.current!.disableMic();\n    } else {\n      await instance.current!.enableMic();\n    }\n  }, [micActive]);\n\n  const getBands = useCallback((source?: AudioSource) => {\n    return instance.current!.getBands(source);\n  }, []);\n\n  const getFftData = useCallback((source?: AudioSource) => {\n    return instance.current!.getFftData(source);\n  }, []);\n\n  const getWaveform = useCallback(() => {\n    return instance.current!.getWaveform();\n  }, []);\n\n  return {\n    isPlaying,\n    micActive,\n    audioError,\n    loadTrack,\n    togglePlayPause,\n    toggleMic,\n    getBands,\n    getFftData,\n    getWaveform,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+type Bands = {
+    bass: number;
+    mid: number;
+    high: number;
+    overall: number;
+};
+type AudioSource = 'music' | 'mic';
+type AudioBandsCallbacks = {
+    onPlay?: () => void;
+    onPause?: () => void;
+    onError?: () => void;
+    onMicStart?: () => void;
+    onMicStop?: () => void;
+};
+
+/**
+ * Vanilla JS class — no framework dependency.
+ * Works in React, Vue, Svelte, or plain HTML.
+ *
+ * Call destroy() when done to close the AudioContext and stop the mic.
+ */
+declare class AudioBands {
+    private callbacks;
+    private ctx;
+    private musicAnalyser;
+    private musicData;
+    private micAnalyser;
+    private micData;
+    private micWaveformData;
+    private audioEl;
+    private musicSource;
+    private micSource;
+    private micStream;
+    constructor(callbacks?: AudioBandsCallbacks);
+    private ensureCtx;
+    load(url: string): Promise<void>;
+    togglePlayPause(): void;
+    enableMic(): Promise<void>;
+    disableMic(): void;
+    getBands(source?: AudioSource): Bands;
+    getFftData(source?: AudioSource): Uint8Array<ArrayBuffer> | null;
+    getWaveform(): Uint8Array<ArrayBuffer> | null;
+    destroy(): void;
+}
+
+type UseAudioBandsReturn = {
+    isPlaying: boolean;
+    micActive: boolean;
+    audioError: boolean;
+    loadTrack: (url: string) => Promise<void>;
+    togglePlayPause: () => void;
+    toggleMic: () => Promise<void>;
+    getBands: (source?: AudioSource) => Bands;
+    getFftData: (source?: AudioSource) => Uint8Array<ArrayBuffer> | null;
+    getWaveform: () => Uint8Array<ArrayBuffer> | null;
+};
+/**
+ * React hook — thin wrapper over AudioBands.
+ * Handles lifecycle (destroy on unmount) and exposes state for re-renders.
+ */
+declare function useAudioBands(): UseAudioBandsReturn;
+
+export { AudioBands, type AudioBandsCallbacks, type AudioSource, type Bands, type UseAudioBandsReturn, useAudioBands };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+type Bands = {
+    bass: number;
+    mid: number;
+    high: number;
+    overall: number;
+};
+type AudioSource = 'music' | 'mic';
+type AudioBandsCallbacks = {
+    onPlay?: () => void;
+    onPause?: () => void;
+    onError?: () => void;
+    onMicStart?: () => void;
+    onMicStop?: () => void;
+};
+
+/**
+ * Vanilla JS class — no framework dependency.
+ * Works in React, Vue, Svelte, or plain HTML.
+ *
+ * Call destroy() when done to close the AudioContext and stop the mic.
+ */
+declare class AudioBands {
+    private callbacks;
+    private ctx;
+    private musicAnalyser;
+    private musicData;
+    private micAnalyser;
+    private micData;
+    private micWaveformData;
+    private audioEl;
+    private musicSource;
+    private micSource;
+    private micStream;
+    constructor(callbacks?: AudioBandsCallbacks);
+    private ensureCtx;
+    load(url: string): Promise<void>;
+    togglePlayPause(): void;
+    enableMic(): Promise<void>;
+    disableMic(): void;
+    getBands(source?: AudioSource): Bands;
+    getFftData(source?: AudioSource): Uint8Array<ArrayBuffer> | null;
+    getWaveform(): Uint8Array<ArrayBuffer> | null;
+    destroy(): void;
+}
+
+type UseAudioBandsReturn = {
+    isPlaying: boolean;
+    micActive: boolean;
+    audioError: boolean;
+    loadTrack: (url: string) => Promise<void>;
+    togglePlayPause: () => void;
+    toggleMic: () => Promise<void>;
+    getBands: (source?: AudioSource) => Bands;
+    getFftData: (source?: AudioSource) => Uint8Array<ArrayBuffer> | null;
+    getWaveform: () => Uint8Array<ArrayBuffer> | null;
+};
+/**
+ * React hook — thin wrapper over AudioBands.
+ * Handles lifecycle (destroy on unmount) and exposes state for re-renders.
+ */
+declare function useAudioBands(): UseAudioBandsReturn;
+
+export { AudioBands, type AudioBandsCallbacks, type AudioSource, type Bands, type UseAudioBandsReturn, useAudioBands };

package/dist/index.js

@@ -0,0 +1,207 @@
+// src/core.ts
+var ZERO = { bass: 0, mid: 0, high: 0, overall: 0 };
+function avg(arr, from, to) {
+  let sum = 0;
+  for (let i = from; i < to; i++) sum += arr[i];
+  return sum / (to - from);
+}
+function computeBands(analyser, data) {
+  analyser.getByteFrequencyData(data);
+  const len = data.length;
+  const bass = avg(data, 0, Math.floor(len * 0.08));
+  const mid = avg(data, Math.floor(len * 0.08), Math.floor(len * 0.4));
+  const high = avg(data, Math.floor(len * 0.4), len);
+  return {
+    bass: bass / 255,
+    mid: mid / 255,
+    high: high / 255,
+    overall: (bass * 0.5 + mid * 0.3 + high * 0.2) / 255
+  };
+}
+var AudioBands = class {
+  constructor(callbacks = {}) {
+    this.ctx = null;
+    this.musicAnalyser = null;
+    this.musicData = null;
+    this.micAnalyser = null;
+    this.micData = null;
+    this.micWaveformData = null;
+    this.audioEl = null;
+    this.musicSource = null;
+    this.micSource = null;
+    this.micStream = null;
+    this.callbacks = callbacks;
+  }
+  // Lazy — AudioContext must be created after a user gesture
+  ensureCtx() {
+    if (this.ctx) return this.ctx;
+    const Ctx = window.AudioContext || window.webkitAudioContext;
+    const ctx = new Ctx();
+    const analyser = ctx.createAnalyser();
+    analyser.fftSize = 256;
+    analyser.smoothingTimeConstant = 0.85;
+    analyser.connect(ctx.destination);
+    this.ctx = ctx;
+    this.musicAnalyser = analyser;
+    this.musicData = new Uint8Array(analyser.frequencyBinCount);
+    return ctx;
+  }
+  async load(url) {
+    const ctx = this.ensureCtx();
+    this.audioEl?.pause();
+    if (this.audioEl) this.audioEl.src = "";
+    try {
+      this.musicSource?.disconnect();
+    } catch {
+    }
+    const audio = new Audio();
+    audio.crossOrigin = "anonymous";
+    audio.src = url;
+    audio.loop = true;
+    this.audioEl = audio;
+    const source = ctx.createMediaElementSource(audio);
+    source.connect(this.musicAnalyser);
+    this.musicSource = source;
+    try {
+      await audio.play();
+      this.callbacks.onPlay?.();
+    } catch {
+      this.callbacks.onError?.();
+    }
+  }
+  togglePlayPause() {
+    const audio = this.audioEl;
+    if (!audio) return;
+    if (audio.paused) {
+      audio.play();
+      this.callbacks.onPlay?.();
+    } else {
+      audio.pause();
+      this.callbacks.onPause?.();
+    }
+  }
+  async enableMic() {
+    const ctx = this.ensureCtx();
+    try {
+      const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
+      this.micStream = stream;
+      const analyser = ctx.createAnalyser();
+      analyser.fftSize = 256;
+      analyser.smoothingTimeConstant = 0.8;
+      this.micAnalyser = analyser;
+      this.micData = new Uint8Array(analyser.frequencyBinCount);
+      this.micWaveformData = new Uint8Array(analyser.fftSize);
+      const source = ctx.createMediaStreamSource(stream);
+      source.connect(analyser);
+      this.micSource = source;
+      this.callbacks.onMicStart?.();
+    } catch {
+      console.warn("[audio-bands] Mic access denied");
+    }
+  }
+  disableMic() {
+    this.micStream?.getTracks().forEach((t) => t.stop());
+    this.micStream = null;
+    try {
+      this.micSource?.disconnect();
+    } catch {
+    }
+    this.micSource = null;
+    this.micAnalyser = null;
+    this.micData = null;
+    this.micWaveformData = null;
+    this.callbacks.onMicStop?.();
+  }
+  // Call inside requestAnimationFrame to get current frequency data
+  getBands(source = "music") {
+    if (source === "mic") {
+      if (!this.micAnalyser || !this.micData) return { ...ZERO };
+      return computeBands(this.micAnalyser, this.micData);
+    }
+    if (!this.musicAnalyser || !this.musicData) return { ...ZERO };
+    return computeBands(this.musicAnalyser, this.musicData);
+  }
+  // Call inside requestAnimationFrame to get raw FFT frequency bins (0–255 per bin)
+  getFftData(source = "music") {
+    if (source === "mic") {
+      if (!this.micAnalyser || !this.micData) return null;
+      this.micAnalyser.getByteFrequencyData(this.micData);
+      return this.micData;
+    }
+    if (!this.musicAnalyser || !this.musicData) return null;
+    this.musicAnalyser.getByteFrequencyData(this.musicData);
+    return this.musicData;
+  }
+  // Call inside requestAnimationFrame to get raw time-domain waveform
+  getWaveform() {
+    if (!this.micAnalyser || !this.micWaveformData) return null;
+    this.micAnalyser.getByteTimeDomainData(this.micWaveformData);
+    return this.micWaveformData;
+  }
+  // Call when done — stops mic, closes AudioContext
+  destroy() {
+    this.audioEl?.pause();
+    this.micStream?.getTracks().forEach((t) => t.stop());
+    this.ctx?.close();
+  }
+};
+
+// src/react.ts
+import { useRef, useState, useCallback, useEffect } from "react";
+function useAudioBands() {
+  const [isPlaying, setIsPlaying] = useState(false);
+  const [micActive, setMicActive] = useState(false);
+  const [audioError, setAudioError] = useState(false);
+  const instance = useRef(null);
+  if (!instance.current) {
+    instance.current = new AudioBands({
+      onPlay: () => setIsPlaying(true),
+      onPause: () => setIsPlaying(false),
+      onError: () => setAudioError(true),
+      onMicStart: () => setMicActive(true),
+      onMicStop: () => setMicActive(false)
+    });
+  }
+  useEffect(() => {
+    return () => instance.current?.destroy();
+  }, []);
+  const loadTrack = useCallback(async (url) => {
+    setAudioError(false);
+    await instance.current.load(url);
+  }, []);
+  const togglePlayPause = useCallback(() => {
+    instance.current.togglePlayPause();
+  }, []);
+  const toggleMic = useCallback(async () => {
+    if (micActive) {
+      instance.current.disableMic();
+    } else {
+      await instance.current.enableMic();
+    }
+  }, [micActive]);
+  const getBands = useCallback((source) => {
+    return instance.current.getBands(source);
+  }, []);
+  const getFftData = useCallback((source) => {
+    return instance.current.getFftData(source);
+  }, []);
+  const getWaveform = useCallback(() => {
+    return instance.current.getWaveform();
+  }, []);
+  return {
+    isPlaying,
+    micActive,
+    audioError,
+    loadTrack,
+    togglePlayPause,
+    toggleMic,
+    getBands,
+    getFftData,
+    getWaveform
+  };
+}
+export {
+  AudioBands,
+  useAudioBands
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/react.ts"],"sourcesContent":["import type { Bands, AudioSource, AudioBandsCallbacks } from './types';\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 computeBands(analyser: AnalyserNode, data: Uint8Array<ArrayBuffer>): Bands {\n  analyser.getByteFrequencyData(data);\n  const len = data.length;\n  const bass = avg(data, 0, Math.floor(len * 0.08));\n  const mid = avg(data, Math.floor(len * 0.08), Math.floor(len * 0.4));\n  const high = avg(data, Math.floor(len * 0.4), len);\n  return {\n    bass: bass / 255,\n    mid: mid / 255,\n    high: high / 255,\n    overall: (bass * 0.5 + mid * 0.3 + high * 0.2) / 255,\n  };\n}\n\n/**\n * Vanilla JS class — no framework dependency.\n * Works in React, Vue, Svelte, or plain HTML.\n *\n * Call destroy() when done to close the AudioContext and stop the mic.\n */\nexport class AudioBands {\n  private callbacks: AudioBandsCallbacks;\n\n  private ctx: AudioContext | null = null;\n  private musicAnalyser: AnalyserNode | null = null;\n  private musicData: 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\n  constructor(callbacks: AudioBandsCallbacks = {}) {\n    this.callbacks = callbacks;\n  }\n\n  // Lazy — AudioContext must be created after a user gesture\n  private ensureCtx(): AudioContext {\n    if (this.ctx) return this.ctx;\n\n    const Ctx =\n      window.AudioContext ||\n      (window as unknown as { webkitAudioContext: typeof AudioContext }).webkitAudioContext;\n\n    const ctx = new Ctx();\n    const analyser = ctx.createAnalyser();\n    analyser.fftSize = 256;\n    analyser.smoothingTimeConstant = 0.85;\n    analyser.connect(ctx.destination);\n\n    this.ctx = ctx;\n    this.musicAnalyser = analyser;\n    this.musicData = new Uint8Array(analyser.frequencyBinCount) as Uint8Array<ArrayBuffer>;\n\n    return ctx;\n  }\n\n  async load(url: string): Promise<void> {\n    const ctx = this.ensureCtx();\n\n    this.audioEl?.pause();\n    if (this.audioEl) this.audioEl.src = '';\n    try { this.musicSource?.disconnect(); } catch { /* already disconnected */ }\n\n    const audio = new Audio();\n    audio.crossOrigin = 'anonymous';\n    audio.src = url;\n    audio.loop = true;\n    this.audioEl = audio;\n\n    const source = ctx.createMediaElementSource(audio);\n    source.connect(this.musicAnalyser!);\n    this.musicSource = source;\n\n    try {\n      await audio.play();\n      this.callbacks.onPlay?.();\n    } catch {\n      this.callbacks.onError?.();\n    }\n  }\n\n  togglePlayPause(): void {\n    const audio = this.audioEl;\n    if (!audio) return;\n    if (audio.paused) {\n      audio.play();\n      this.callbacks.onPlay?.();\n    } else {\n      audio.pause();\n      this.callbacks.onPause?.();\n    }\n  }\n\n  async enableMic(): Promise<void> {\n    const ctx = this.ensureCtx();\n\n    try {\n      const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });\n      this.micStream = stream;\n\n      const analyser = ctx.createAnalyser();\n      analyser.fftSize = 256;\n      analyser.smoothingTimeConstant = 0.8;\n      this.micAnalyser = analyser;\n      this.micData = new Uint8Array(analyser.frequencyBinCount) as Uint8Array<ArrayBuffer>;\n      this.micWaveformData = new Uint8Array(analyser.fftSize) as Uint8Array<ArrayBuffer>;\n\n      const source = ctx.createMediaStreamSource(stream);\n      source.connect(analyser);\n      // Not connected to destination — prevents mic feedback\n      this.micSource = source;\n\n      this.callbacks.onMicStart?.();\n    } catch {\n      console.warn('[audio-bands] Mic access denied');\n    }\n  }\n\n  disableMic(): void {\n    this.micStream?.getTracks().forEach((t) => t.stop());\n    this.micStream = null;\n    try { this.micSource?.disconnect(); } catch { /* already disconnected */ }\n    this.micSource = null;\n    this.micAnalyser = null;\n    this.micData = null;\n    this.micWaveformData = null;\n    this.callbacks.onMicStop?.();\n  }\n\n  // Call inside requestAnimationFrame to get current frequency data\n  getBands(source: AudioSource = 'music'): Bands {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return { ...ZERO };\n      return computeBands(this.micAnalyser, this.micData);\n    }\n    if (!this.musicAnalyser || !this.musicData) return { ...ZERO };\n    return computeBands(this.musicAnalyser, this.musicData);\n  }\n\n  // Call inside requestAnimationFrame to get raw FFT frequency bins (0–255 per bin)\n  getFftData(source: AudioSource = 'music'): Uint8Array<ArrayBuffer> | null {\n    if (source === 'mic') {\n      if (!this.micAnalyser || !this.micData) return null;\n      this.micAnalyser.getByteFrequencyData(this.micData);\n      return this.micData;\n    }\n    if (!this.musicAnalyser || !this.musicData) return null;\n    this.musicAnalyser.getByteFrequencyData(this.musicData);\n    return this.musicData;\n  }\n\n  // Call inside requestAnimationFrame to get raw time-domain waveform\n  getWaveform(): Uint8Array<ArrayBuffer> | null {\n    if (!this.micAnalyser || !this.micWaveformData) return null;\n    this.micAnalyser.getByteTimeDomainData(this.micWaveformData);\n    return this.micWaveformData;\n  }\n\n  // Call when done — stops mic, closes AudioContext\n  destroy(): void {\n    this.audioEl?.pause();\n    this.micStream?.getTracks().forEach((t) => t.stop());\n    this.ctx?.close();\n  }\n}\n","'use client';\n\nimport { useRef, useState, useCallback, useEffect } from 'react';\nimport { AudioBands } from './core';\nimport type { Bands, AudioSource } from './types';\n\nexport type UseAudioBandsReturn = {\n  isPlaying: boolean;\n  micActive: boolean;\n  audioError: boolean;\n  loadTrack: (url: string) => Promise<void>;\n  togglePlayPause: () => void;\n  toggleMic: () => Promise<void>;\n  getBands: (source?: AudioSource) => Bands;\n  getFftData: (source?: AudioSource) => Uint8Array<ArrayBuffer> | null;\n  getWaveform: () => Uint8Array<ArrayBuffer> | null;\n};\n\n/**\n * React hook — thin wrapper over AudioBands.\n * Handles lifecycle (destroy on unmount) and exposes state for re-renders.\n */\nexport function useAudioBands(): UseAudioBandsReturn {\n  const [isPlaying, setIsPlaying] = useState(false);\n  const [micActive, setMicActive] = useState(false);\n  const [audioError, setAudioError] = useState(false);\n\n  const instance = useRef<AudioBands | null>(null);\n\n  if (!instance.current) {\n    instance.current = new AudioBands({\n      onPlay: () => setIsPlaying(true),\n      onPause: () => setIsPlaying(false),\n      onError: () => setAudioError(true),\n      onMicStart: () => setMicActive(true),\n      onMicStop: () => setMicActive(false),\n    });\n  }\n\n  useEffect(() => {\n    return () => instance.current?.destroy();\n  }, []);\n\n  const loadTrack = useCallback(async (url: string) => {\n    setAudioError(false);\n    await instance.current!.load(url);\n  }, []);\n\n  const togglePlayPause = useCallback(() => {\n    instance.current!.togglePlayPause();\n  }, []);\n\n  const toggleMic = useCallback(async () => {\n    if (micActive) {\n      instance.current!.disableMic();\n    } else {\n      await instance.current!.enableMic();\n    }\n  }, [micActive]);\n\n  const getBands = useCallback((source?: AudioSource) => {\n    return instance.current!.getBands(source);\n  }, []);\n\n  const getFftData = useCallback((source?: AudioSource) => {\n    return instance.current!.getFftData(source);\n  }, []);\n\n  const getWaveform = useCallback(() => {\n    return instance.current!.getWaveform();\n  }, []);\n\n  return {\n    isPlaying,\n    micActive,\n    audioError,\n    loadTrack,\n    togglePlayPause,\n    toggleMic,\n    getBands,\n    getFftData,\n    getWaveform,\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@juandinella/audio-bands",
+  "version": "0.1.0",
+  "description": "Headless React hook for real-time audio frequency analysis. Get bass/mid/high bands from music or mic, without a renderer.",
+  "keywords": [
+    "react",
+    "hook",
+    "audio",
+    "web-audio",
+    "frequency",
+    "visualizer",
+    "headless",
+    "bass",
+    "analyser"
+  ],
+  "author": "Juan Dinella",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}