@lucaismyname/ginger 0.0.31 → 0.0.34

package/README.md

@@ -56,7 +56,7 @@ Mount **`<Ginger.Player />`** once inside the same provider tree so the hidden a
 - Streaming adapters: [`docs/guides/streaming-adapters.md`](./docs/guides/streaming-adapters.md)
 - Components reference: [`docs/reference/components.md`](./docs/reference/components.md)
 - Hooks reference: [`docs/reference/hooks.md`](./docs/reference/hooks.md)
-- Subpath exports: [`docs/reference/subpaths.md`](./docs/reference/subpaths.md)
+- Subpath exports (waveform, EQ, spatial, transcript, remote, …): [`docs/reference/subpaths.md`](./docs/reference/subpaths.md)
 - Generated API docs: [`docs/api/index.html`](./docs/api/index.html)
 
 ## Subpath Exports
@@ -65,6 +65,9 @@ Mount **`<Ginger.Player />`** once inside the same provider tree so the hidden a
 - `@lucaismyname/ginger/testing`
 - `@lucaismyname/ginger/waveform`
 - `@lucaismyname/ginger/equalizer`
+- `@lucaismyname/ginger/spatial`
+- `@lucaismyname/ginger/transcript`
+- `@lucaismyname/ginger/remote`
 - `@lucaismyname/ginger/experimental-gapless`
 
 ### Equalizer
@@ -105,6 +108,96 @@ function MyPlayer() {
 
 The EQ and `useGingerLiveAnalyzer` share the same `AudioContext` and can be used together. EQ filters are inserted before the analyser in the Web Audio graph.
 
+### Spatial audio (`@lucaismyname/ginger/spatial`)
+
+Inserts an HRTF **`PannerNode`** into the same Web Audio graph as the EQ and live analyser (one `MediaElementAudioSourceNode` per `<audio>`).
+
+```tsx
+import { useGingerSpatialAudio } from "@lucaismyname/ginger/spatial";
+
+function Spatialized() {
+  const { setSourcePosition, error } = useGingerSpatialAudio({
+    panningModel: "HRTF",
+    position: [2, 0, 0],
+    listenerPosition: [0, 0, 0],
+  });
+
+  return (
+    <div>
+      <button type="button" onClick={() => setSourcePosition(0, 0, -2)}>
+        Move source
+      </button>
+      {error && <p>{error}</p>}
+    </div>
+  );
+}
+```
+
+Use **`setListenerPosition`** and **`setPanningModel`** for runtime updates without rebuilding the graph.
+
+### Transcript (`@lucaismyname/ginger/transcript`)
+
+Parse **SRT** and **WebVTT** captions and sync cues to playback time (podcasts, video-style transcripts). HTML tags in cue text are stripped.
+
+```tsx
+import {
+  parseSrt,
+  parseVtt,
+  useGingerTranscriptSync,
+} from "@lucaismyname/ginger/transcript";
+
+const vtt = `WEBVTT
+
+00:00:01.000 --> 00:00:04.000
+Hello from VTT
+`;
+
+function TranscriptPanel() {
+  const { cues, activeCue, activeCues } = useGingerTranscriptSync({
+    transcript: vtt,
+    format: "auto",
+  });
+
+  return (
+    <div>
+      <p>Now: {activeCue?.text ?? "—"}</p>
+      <p>Overlapping: {activeCues.map((c) => c.text).join(" · ")}</p>
+    </div>
+  );
+}
+
+// Or parse ahead of time:
+const cuesFromSrt = parseSrt(srtString);
+const cuesFromVtt = parseVtt(vttString);
+```
+
+**`useGingerTranscriptSync`** mirrors **`useGingerLyricsSync`** but uses cue **start/end** ranges and exposes **`activeCues`** for overlapping captions. **`parseTranscriptAuto`** chooses VTT when the string starts with `WEBVTT`, otherwise SRT.
+
+### Multi-tab sync (`@lucaismyname/ginger/remote`)
+
+Elects a **leader** tab via **`BroadcastChannel`** and pushes **`INIT`** snapshots to followers so queue and transport settings stay aligned. Mount **`Ginger.Player`** only on the leader so a single `<audio>` element plays.
+
+```tsx
+import { Ginger } from "@lucaismyname/ginger";
+import { useGingerRemote } from "@lucaismyname/ginger/remote";
+
+function RemoteAwarePlayer() {
+  const { isLeader, isPending, error } = useGingerRemote({
+    channelName: "my-app-ginger",
+  });
+
+  return (
+    <>
+      {error && <p role="alert">{error}</p>}
+      {isLeader && <Ginger.Player />}
+      {isPending && <p>Connecting to other tabs…</p>}
+    </>
+  );
+}
+```
+
+Snapshots send the current queue order with **`isShuffled: false`** so followers do not re-randomize; the visible order matches the leader. **`claimLeadership()`** requests leadership (lexicographically smaller tab IDs win conflicts).
+
 ### Experimental Notice
 
 `@lucaismyname/ginger/experimental-gapless` is intentionally non-production.
@@ -781,7 +874,11 @@ Example:
 
 - **Buffered UI** — **`Ginger.Current.BufferRail`** shows load progress; **`Ginger.Current.TimeRail`** supports **`showBuffered`** to stack a buffered layer behind the played segment.
 
-- **Audio analyzers** — Live Web Audio data for real-time visuals (**`useGingerLiveAnalyzer`**, main package), parametric EQ (**`useGingerEqualizer`**, `@lucaismyname/ginger/equalizer`), and whole-file grids for waveforms or spectrograms (**`useAudioFileAnalysis`** / **`analyzeAudioFile`**, `@lucaismyname/ginger/waveform`). See [Audio analyzers (visualizations)](#audio-analyzers-visualizations).
+- **Audio analyzers** — Live Web Audio data for real-time visuals (**`useGingerLiveAnalyzer`**, main package), parametric EQ (**`useGingerEqualizer`**, `@lucaismyname/ginger/equalizer`), **spatial / HRTF panning** (**`useGingerSpatialAudio`**, `@lucaismyname/ginger/spatial`), and whole-file grids for waveforms or spectrograms (**`useAudioFileAnalysis`** / **`analyzeAudioFile`**, `@lucaismyname/ginger/waveform`). See [Audio analyzers (visualizations)](#audio-analyzers-visualizations).
+
+- **Transcripts** — **SRT / WebVTT** parsing and sync (**`parseSrt`**, **`parseVtt`**, **`useGingerTranscriptSync`**, `@lucaismyname/ginger/transcript`); LRC / in-track lyrics remain **`useGingerLyricsSync`** and **`parseLrc()`** on the main package.
+
+- **Multi-tab** — **`useGingerRemote`** (`@lucaismyname/ginger/remote`) coordinates playback state across browser tabs; see [Subpath exports](#subpath-exports).
 
 Recipes below cover queue lifecycle and media edge cases.
 
@@ -1114,9 +1211,12 @@ Additional entrypoints:
 - `@lucaismyname/ginger/client`
 - `@lucaismyname/ginger/testing`
 - `@lucaismyname/ginger/waveform`
+- `@lucaismyname/ginger/spatial`
+- `@lucaismyname/ginger/transcript`
+- `@lucaismyname/ginger/remote`
 - `@lucaismyname/ginger/experimental-gapless`
 
-`experimental-gapless` is explicitly non-production and does not alter core playback.
+See [Subpath Exports](#subpath-exports) for **`spatial`**, **`transcript`**, and **`remote`** usage. `experimental-gapless` is explicitly non-production and does not alter core playback.
 
 ## Notes
 
@@ -1137,8 +1237,8 @@ See [Recipes — Updating the queue after mount](#updating-the-queue-after-mount
 These priorities guide new work in the library; they are not a guarantee of shipping order.
 
 1. **Music libraries and continuous listening** — Features that make track-to-track playback feel better come first: **next-track prefetch** (`useNextTrackPrefetch`), future gapless or crossfade (see `@lucaismyname/ginger/experimental-gapless`), and first-class **chapter** / **synced lyrics** UI (`Ginger.Current.Chapters`, `Ginger.Current.LyricsSynced`).
-2. **Podcasts and live-style streams** — **HLS / DASH** integration is emphasized when a concrete app needs it; the core package stays on native `<audio>` with optional adapters or documentation rather than hard dependencies.
-3. **Embedded or internal players** — **Accessibility**, persistence, and **testing** helpers are favored over heavier ecosystem integrations (Cast, remote playback modules) unless there is a dedicated use case.
+2. **Podcasts and live-style streams** — **HLS / DASH** integration is emphasized when a concrete app needs it; the core package stays on native `<audio>` with optional adapters or documentation rather than hard dependencies. **SRT / WebVTT** transcripts are supported via `@lucaismyname/ginger/transcript`.
+3. **Embedded or internal players** — **Accessibility**, persistence, and **testing** helpers are favored over heavier ecosystem integrations (Cast, proprietary cast SDKs) unless there is a dedicated use case. **Multi-tab** web apps can use `@lucaismyname/ginger/remote` (BroadcastChannel) before reaching for OS-level remote playback.
 
 ## Monorepo Development
 

package/dist/client.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-NEcOSSJD.cjs"),i=require("./liveAudioGraph-D1BXMv_u.cjs"),r=require("./useGingerChapterProgress-BOqUimE7.cjs"),s=require("./selectors-YXnP8Y8g.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Chapters=e.Chapters;exports.Ginger=e.Ginger;exports.LyricsSynced=e.LyricsSynced;exports.Pause=e.Pause;exports.Play=e.Play;exports.RepeatGlyph=e.RepeatGlyph;exports.ShuffleIcon=e.ShuffleIcon;exports.SkipBack=e.SkipBack;exports.SkipForward=e.SkipForward;exports.Volume2=e.Volume2;exports.VolumeX=e.VolumeX;exports.Wrapper=e.Wrapper;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.parseLrc=e.parseLrc;exports.useGingerChapters=e.useGingerChapters;exports.useGingerLocale=e.useGingerLocale;exports.useGingerLyricsSync=e.useGingerLyricsSync;exports.usePlayPauseBinding=e.usePlayPauseBinding;exports.useSeekBarBinding=e.useSeekBarBinding;exports.useVolumeSlider=e.useVolumeSlider;exports.attachLiveAnalyser=i.attachLiveAnalyser;exports.detachLiveAnalyser=i.detachLiveAnalyser;exports.setProcessingChain=i.setProcessingChain;exports.useGinger=i.useGinger;exports.createGingerStore=r.createGingerStore;exports.useGingerChapterProgress=r.useGingerChapterProgress;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=r.useGingerLiveAnalyzer;exports.useGingerPlaybackHistory=r.useGingerPlaybackHistory;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useGingerVolumeFade=r.useGingerVolumeFade;exports.useNextTrackPrefetch=r.useNextTrackPrefetch;exports.useSeekDrag=r.useSeekDrag;exports.derivePlaybackUiState=s.derivePlaybackUiState;exports.gingerStateFromContextValues=a.gingerStateFromContextValues;exports.gingerStateFromContexts=a.gingerStateFromContexts;exports.useGingerMedia=a.useGingerMedia;exports.useGingerPlayback=a.useGingerPlayback;exports.useGingerState=a.useGingerState;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-NEcOSSJD.cjs"),s=require("./useGinger-BXgia32v.cjs"),r=require("./useGingerChapterProgress-BdaalJvX.cjs"),i=require("./liveAudioGraph-0cpHD_Ic.cjs"),n=require("./selectors-YXnP8Y8g.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Chapters=e.Chapters;exports.Ginger=e.Ginger;exports.LyricsSynced=e.LyricsSynced;exports.Pause=e.Pause;exports.Play=e.Play;exports.RepeatGlyph=e.RepeatGlyph;exports.ShuffleIcon=e.ShuffleIcon;exports.SkipBack=e.SkipBack;exports.SkipForward=e.SkipForward;exports.Volume2=e.Volume2;exports.VolumeX=e.VolumeX;exports.Wrapper=e.Wrapper;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.parseLrc=e.parseLrc;exports.useGingerChapters=e.useGingerChapters;exports.useGingerLocale=e.useGingerLocale;exports.useGingerLyricsSync=e.useGingerLyricsSync;exports.usePlayPauseBinding=e.usePlayPauseBinding;exports.useSeekBarBinding=e.useSeekBarBinding;exports.useVolumeSlider=e.useVolumeSlider;exports.useGinger=s.useGinger;exports.createGingerStore=r.createGingerStore;exports.useGingerChapterProgress=r.useGingerChapterProgress;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=r.useGingerLiveAnalyzer;exports.useGingerPlaybackHistory=r.useGingerPlaybackHistory;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useGingerVolumeFade=r.useGingerVolumeFade;exports.useNextTrackPrefetch=r.useNextTrackPrefetch;exports.useSeekDrag=r.useSeekDrag;exports.attachLiveAnalyser=i.attachLiveAnalyser;exports.detachLiveAnalyser=i.detachLiveAnalyser;exports.setProcessingChain=i.setProcessingChain;exports.derivePlaybackUiState=n.derivePlaybackUiState;exports.gingerStateFromContextValues=a.gingerStateFromContextValues;exports.gingerStateFromContexts=a.gingerStateFromContexts;exports.useGingerMedia=a.useGingerMedia;exports.useGingerPlayback=a.useGingerPlayback;exports.useGingerState=a.useGingerState;
 //# sourceMappingURL=client.cjs.map

package/dist/client.js

@@ -1,50 +1,51 @@
-import { C as s, G as r, L as i, P as u, a as t, R as n, S as g, b as o, c, V as l, d as p, W as G, e as y, f as S, g as d, p as m, u as h, h as P, i as f, j as k, k as L, l as b } from "./ginger-L2ZFgzH4.js";
-import { a as C, d as V, s as v, u as B } from "./liveAudioGraph-CmEsdLgZ.js";
-import { c as A, u as R, a as D, b as T, d as W, e as j, f as w, g as z, h as H, i as I } from "./useGingerChapterProgress-DLYdGytK.js";
-import { d as M } from "./selectors-BalBCc7X.js";
-import { g as U, a as X, u as q, b as E, c as J } from "./GingerSplitContexts-BzBExb95.js";
+import { C as s, G as r, L as i, P as t, a as u, R as n, S as o, b as g, c, V as l, d as p, W as G, e as m, f as y, g as S, p as d, u as f, h, i as P, j as k, k as L, l as b } from "./ginger-L2ZFgzH4.js";
+import { u as C } from "./useGinger-hpp2pAGY.js";
+import { c as v, u as B, a as F, b as A, d as R, e as D, f as T, g as W, h as j, i as w } from "./useGingerChapterProgress-CZdv-HiI.js";
+import { a as H, d as I, s as K } from "./liveAudioGraph-DvPaxBCP.js";
+import { d as N } from "./selectors-BalBCc7X.js";
+import { g as X, a as q, u as E, b as J, c as O } from "./GingerSplitContexts-BzBExb95.js";
 export {
   s as Chapters,
   r as Ginger,
   i as LyricsSynced,
-  u as Pause,
-  t as Play,
+  t as Pause,
+  u as Play,
   n as RepeatGlyph,
-  g as ShuffleIcon,
-  o as SkipBack,
+  o as ShuffleIcon,
+  g as SkipBack,
   c as SkipForward,
   l as Volume2,
   p as VolumeX,
   G as Wrapper,
-  C as attachLiveAnalyser,
-  y as clampPlaybackRate,
-  S as clampVolume,
-  A as createGingerStore,
-  d as defaultGingerLocale,
-  M as derivePlaybackUiState,
-  V as detachLiveAnalyser,
-  U as gingerStateFromContextValues,
-  X as gingerStateFromContexts,
-  m as parseLrc,
-  v as setProcessingChain,
-  B as useGinger,
-  R as useGingerChapterProgress,
-  h as useGingerChapters,
-  D as useGingerDebugLog,
-  T as useGingerKeyboardShortcuts,
-  W as useGingerLiveAnalyzer,
-  P as useGingerLocale,
-  f as useGingerLyricsSync,
-  q as useGingerMedia,
-  E as useGingerPlayback,
-  j as useGingerPlaybackHistory,
-  w as useGingerSleepTimer,
-  J as useGingerState,
-  z as useGingerVolumeFade,
-  H as useNextTrackPrefetch,
+  H as attachLiveAnalyser,
+  m as clampPlaybackRate,
+  y as clampVolume,
+  v as createGingerStore,
+  S as defaultGingerLocale,
+  N as derivePlaybackUiState,
+  I as detachLiveAnalyser,
+  X as gingerStateFromContextValues,
+  q as gingerStateFromContexts,
+  d as parseLrc,
+  K as setProcessingChain,
+  C as useGinger,
+  B as useGingerChapterProgress,
+  f as useGingerChapters,
+  F as useGingerDebugLog,
+  A as useGingerKeyboardShortcuts,
+  R as useGingerLiveAnalyzer,
+  h as useGingerLocale,
+  P as useGingerLyricsSync,
+  E as useGingerMedia,
+  J as useGingerPlayback,
+  D as useGingerPlaybackHistory,
+  T as useGingerSleepTimer,
+  O as useGingerState,
+  W as useGingerVolumeFade,
+  j as useNextTrackPrefetch,
   k as usePlayPauseBinding,
   L as useSeekBarBinding,
-  I as useSeekDrag,
+  w as useSeekDrag,
   b as useVolumeSlider
 };
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"client.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/equalizer/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),c=require("../liveAudioGraph-D1BXMv_u.cjs"),B=[{frequency:60},{frequency:250},{frequency:1e3},{frequency:4e3},{frequency:16e3}];function C(q={}){const{enabled:d=!0,bands:m=B}=q,{audioRef:o,state:h}=c.useGinger(),[l,g]=s.useState(m),[p,y]=s.useState(null),a=s.useRef([]);s.useEffect(()=>{const e=o.current;if(!(!e||typeof window>"u")){if(!d){c.setProcessingChain(e,[]),a.current=[];return}try{const t=c.attachLiveAnalyser(e,{fftSize:32,smoothingTimeConstant:0,minDecibels:-100,maxDecibels:0}),{context:n,id:f}=t,i=l.map(r=>{const u=n.createBiquadFilter();return u.type=r.type??"peaking",u.frequency.value=r.frequency,u.gain.value=r.gain??0,u.Q.value=r.q??1,u});a.current=i,c.setProcessingChain(e,i),c.detachLiveAnalyser(e,f),y(null)}catch(t){const n=t instanceof Error?t.message:"Failed to create equalizer";y(n),a.current=[]}return()=>{const t=o.current;t&&c.setProcessingChain(t,[]),a.current=[]}}},[d,l,o,h.currentIndex]);const v=s.useCallback((e,t)=>{const n=a.current[e];n&&(n.gain.value=t),g(f=>f.map((i,r)=>r===e?{...i,gain:t}:i))},[]),S=s.useCallback(e=>{g(e)},[]);return{setBandGain:v,setBands:S,bands:l,error:p}}exports.useGingerEqualizer=C;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),a=require("../liveAudioGraph-0cpHD_Ic.cjs"),B=require("../useGinger-BXgia32v.cjs"),C=[{frequency:60},{frequency:250},{frequency:1e3},{frequency:4e3},{frequency:16e3}];function E(y={}){const{enabled:d=!0,bands:m=C}=y,{audioRef:o,state:h}=B.useGinger(),[l,g]=s.useState(m),[p,q]=s.useState(null),c=s.useRef([]);s.useEffect(()=>{const e=o.current;if(!(!e||typeof window>"u")){if(!d){a.setProcessingChain(e,[]),c.current=[];return}try{const t=a.attachLiveAnalyser(e,{fftSize:32,smoothingTimeConstant:0,minDecibels:-100,maxDecibels:0}),{context:n,id:f}=t,i=l.map(r=>{const u=n.createBiquadFilter();return u.type=r.type??"peaking",u.frequency.value=r.frequency,u.gain.value=r.gain??0,u.Q.value=r.q??1,u});c.current=i,a.setProcessingChain(e,i),a.detachLiveAnalyser(e,f),q(null)}catch(t){const n=t instanceof Error?t.message:"Failed to create equalizer";q(n),c.current=[]}return()=>{const t=o.current;t&&a.setProcessingChain(t,[]),c.current=[]}}},[d,l,o,h.currentIndex]);const v=s.useCallback((e,t)=>{const n=c.current[e];n&&(n.gain.value=t),g(f=>f.map((i,r)=>r===e?{...i,gain:t}:i))},[]),S=s.useCallback(e=>{g(e)},[]);return{setBandGain:v,setBands:S,bands:l,error:p}}exports.useGingerEqualizer=E;
 //# sourceMappingURL=index.cjs.map

package/dist/equalizer/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/equalizer/useGingerEqualizer.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n  attachLiveAnalyser,\n  detachLiveAnalyser,\n  setProcessingChain,\n} from \"../analyzer/liveAudioGraph\";\nimport { useGinger } from \"../hooks/useGinger\";\n\nexport type EqualizerBand = {\n  /** Center frequency in Hz (e.g. 60, 250, 1000, 4000, 16000). */\n  frequency: number;\n  /** Gain in dB. Positive = boost, negative = cut. Typical range: -12 to +12. Default: 0. */\n  gain?: number;\n  /** Q factor (bandwidth). Higher = narrower. Default: 1. */\n  q?: number;\n  /** BiquadFilterNode type. Default: \"peaking\". */\n  type?: BiquadFilterType;\n};\n\nexport type UseGingerEqualizerOptions = {\n  /** When false, EQ nodes are detached and the audio path is bypassed. Default: true. */\n  enabled?: boolean;\n  /** Band definitions. Each band maps to one BiquadFilterNode. */\n  bands?: EqualizerBand[];\n};\n\nexport type UseGingerEqualizerResult = {\n  /** Update a single band's gain in dB without rebuilding the filter chain. */\n  setBandGain: (bandIndex: number, gainDb: number) => void;\n  /** Replace all bands (rebuilds the filter chain). */\n  setBands: (bands: EqualizerBand[]) => void;\n  /** Current band definitions (reflects the latest `setBands` call). */\n  bands: EqualizerBand[];\n  /** Error string if Web Audio is unavailable or filter creation failed. */\n  error: string | null;\n};\n\nconst DEFAULT_BANDS: EqualizerBand[] = [\n  { frequency: 60 },\n  { frequency: 250 },\n  { frequency: 1000 },\n  { frequency: 4000 },\n  { frequency: 16000 },\n];\n\n/**\n * Inserts a parametric EQ into the Web Audio graph for the active Ginger media element.\n *\n * Each band is a `BiquadFilterNode` connected in series between the audio source and the\n * speakers. If `useGingerLiveAnalyzer` is also active, the EQ is inserted before the analyser\n * — both share the same `AudioContext` (the browser allows only one `MediaElementAudioSourceNode`\n * per element).\n *\n * Available as a subpath export:\n * ```ts\n * import { useGingerEqualizer } from \"@lucaismyname/ginger/equalizer\";\n * ```\n */\nexport function useGingerEqualizer(\n  options: UseGingerEqualizerOptions = {},\n): UseGingerEqualizerResult {\n  const { enabled = true, bands: initialBands = DEFAULT_BANDS } = options;\n  const { audioRef, state } = useGinger();\n\n  const [bands, setBandsState] = useState<EqualizerBand[]>(initialBands);\n  const [error, setError] = useState<string | null>(null);\n\n  const filterNodesRef = useRef<BiquadFilterNode[]>([]);\n\n  useEffect(() => {\n    const el = audioRef.current;\n    if (!el || typeof window === \"undefined\") {\n      return;\n    }\n\n    if (!enabled) {\n      setProcessingChain(el, []);\n      filterNodesRef.current = [];\n      return;\n    }\n\n    try {\n      // Attach a temporary analyser solely to get (or create) the shared AudioContext.\n      // The graph is rebuilt by liveAudioGraph after we call setProcessingChain, so this\n      // temporary consumer is detached immediately after we have the context reference.\n      const attached = attachLiveAnalyser(el, {\n        fftSize: 32,\n        smoothingTimeConstant: 0,\n        minDecibels: -100,\n        maxDecibels: 0,\n      });\n      const { context, id: tempId } = attached;\n\n      const filters: BiquadFilterNode[] = bands.map((band) => {\n        const node = context.createBiquadFilter();\n        node.type = band.type ?? \"peaking\";\n        node.frequency.value = band.frequency;\n        node.gain.value = band.gain ?? 0;\n        node.Q.value = band.q ?? 1;\n        return node;\n      });\n\n      filterNodesRef.current = filters;\n\n      // Install processing chain BEFORE removing the temp analyser so the graph stays valid\n      setProcessingChain(el, filters);\n      detachLiveAnalyser(el, tempId);\n\n      setError(null);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : \"Failed to create equalizer\";\n      setError(msg);\n      filterNodesRef.current = [];\n    }\n\n    return () => {\n      const element = audioRef.current;\n      if (element) {\n        setProcessingChain(element, []);\n      }\n      filterNodesRef.current = [];\n    };\n  }, [enabled, bands, audioRef, state.currentIndex]);\n\n  const setBandGain = useCallback((bandIndex: number, gainDb: number) => {\n    const node = filterNodesRef.current[bandIndex];\n    if (node) {\n      node.gain.value = gainDb;\n    }\n    setBandsState((prev) => prev.map((b, i) => (i === bandIndex ? { ...b, gain: gainDb } : b)));\n  }, []);\n\n  const setBands = useCallback((nextBands: EqualizerBand[]) => {\n    setBandsState(nextBands);\n  }, []);\n\n  return { setBandGain, setBands, bands, error };\n}\n"],"names":["DEFAULT_BANDS","useGingerEqualizer","options","enabled","initialBands","audioRef","state","useGinger","bands","setBandsState","useState","error","setError","filterNodesRef","useRef","useEffect","el","setProcessingChain","attached","attachLiveAnalyser","context","tempId","filters","band","node","detachLiveAnalyser","e","msg","element","setBandGain","useCallback","bandIndex","gainDb","prev","b","i","setBands","nextBands"],"mappings":"qJAqCMA,EAAiC,CACrC,CAAE,UAAW,EAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,IAAA,CACf,EAeO,SAASC,EACdC,EAAqC,GACX,CAC1B,KAAM,CAAE,QAAAC,EAAU,GAAM,MAAOC,EAAeJ,GAAkBE,EAC1D,CAAE,SAAAG,EAAU,MAAAC,CAAA,EAAUC,YAAA,EAEtB,CAACC,EAAOC,CAAa,EAAIC,EAAAA,SAA0BN,CAAY,EAC/D,CAACO,EAAOC,CAAQ,EAAIF,EAAAA,SAAwB,IAAI,EAEhDG,EAAiBC,EAAAA,OAA2B,EAAE,EAEpDC,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAKX,EAAS,QACpB,GAAI,GAACW,GAAM,OAAO,OAAW,KAI7B,IAAI,CAACb,EAAS,CACZc,EAAAA,mBAAmBD,EAAI,EAAE,EACzBH,EAAe,QAAU,CAAA,EACzB,MACF,CAEA,GAAI,CAIF,MAAMK,EAAWC,EAAAA,mBAAmBH,EAAI,CACtC,QAAS,GACT,sBAAuB,EACvB,YAAa,KACb,YAAa,CAAA,CACd,EACK,CAAE,QAAAI,EAAS,GAAIC,CAAA,EAAWH,EAE1BI,EAA8Bd,EAAM,IAAKe,GAAS,CACtD,MAAMC,EAAOJ,EAAQ,mBAAA,EACrB,OAAAI,EAAK,KAAOD,EAAK,MAAQ,UACzBC,EAAK,UAAU,MAAQD,EAAK,UAC5BC,EAAK,KAAK,MAAQD,EAAK,MAAQ,EAC/BC,EAAK,EAAE,MAAQD,EAAK,GAAK,EAClBC,CACT,CAAC,EAEDX,EAAe,QAAUS,EAGzBL,EAAAA,mBAAmBD,EAAIM,CAAO,EAC9BG,EAAAA,mBAAmBT,EAAIK,CAAM,EAE7BT,EAAS,IAAI,CACf,OAASc,EAAG,CACV,MAAMC,EAAMD,aAAa,MAAQA,EAAE,QAAU,6BAC7Cd,EAASe,CAAG,EACZd,EAAe,QAAU,CAAA,CAC3B,CAEA,MAAO,IAAM,CACX,MAAMe,EAAUvB,EAAS,QACrBuB,GACFX,EAAAA,mBAAmBW,EAAS,EAAE,EAEhCf,EAAe,QAAU,CAAA,CAC3B,EACF,EAAG,CAACV,EAASK,EAAOH,EAAUC,EAAM,YAAY,CAAC,EAEjD,MAAMuB,EAAcC,EAAAA,YAAY,CAACC,EAAmBC,IAAmB,CACrE,MAAMR,EAAOX,EAAe,QAAQkB,CAAS,EACzCP,IACFA,EAAK,KAAK,MAAQQ,GAEpBvB,EAAewB,GAASA,EAAK,IAAI,CAACC,EAAGC,IAAOA,IAAMJ,EAAY,CAAE,GAAGG,EAAG,KAAMF,CAAA,EAAWE,CAAE,CAAC,CAC5F,EAAG,CAAA,CAAE,EAECE,EAAWN,cAAaO,GAA+B,CAC3D5B,EAAc4B,CAAS,CACzB,EAAG,CAAA,CAAE,EAEL,MAAO,CAAE,YAAAR,EAAa,SAAAO,EAAU,MAAA5B,EAAO,MAAAG,CAAA,CACzC"}
+{"version":3,"file":"index.cjs","sources":["../../src/equalizer/useGingerEqualizer.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n  attachLiveAnalyser,\n  detachLiveAnalyser,\n  setProcessingChain,\n} from \"../analyzer/liveAudioGraph\";\nimport { useGinger } from \"../hooks/useGinger\";\n\nexport type EqualizerBand = {\n  /** Center frequency in Hz (e.g. 60, 250, 1000, 4000, 16000). */\n  frequency: number;\n  /** Gain in dB. Positive = boost, negative = cut. Typical range: -12 to +12. Default: 0. */\n  gain?: number;\n  /** Q factor (bandwidth). Higher = narrower. Default: 1. */\n  q?: number;\n  /** BiquadFilterNode type. Default: \"peaking\". */\n  type?: BiquadFilterType;\n};\n\nexport type UseGingerEqualizerOptions = {\n  /** When false, EQ nodes are detached and the audio path is bypassed. Default: true. */\n  enabled?: boolean;\n  /** Band definitions. Each band maps to one BiquadFilterNode. */\n  bands?: EqualizerBand[];\n};\n\nexport type UseGingerEqualizerResult = {\n  /** Update a single band's gain in dB without rebuilding the filter chain. */\n  setBandGain: (bandIndex: number, gainDb: number) => void;\n  /** Replace all bands (rebuilds the filter chain). */\n  setBands: (bands: EqualizerBand[]) => void;\n  /** Current band definitions (reflects the latest `setBands` call). */\n  bands: EqualizerBand[];\n  /** Error string if Web Audio is unavailable or filter creation failed. */\n  error: string | null;\n};\n\nconst DEFAULT_BANDS: EqualizerBand[] = [\n  { frequency: 60 },\n  { frequency: 250 },\n  { frequency: 1000 },\n  { frequency: 4000 },\n  { frequency: 16000 },\n];\n\n/**\n * Inserts a parametric EQ into the Web Audio graph for the active Ginger media element.\n *\n * Each band is a `BiquadFilterNode` connected in series between the audio source and the\n * speakers. If `useGingerLiveAnalyzer` is also active, the EQ is inserted before the analyser\n * — both share the same `AudioContext` (the browser allows only one `MediaElementAudioSourceNode`\n * per element).\n *\n * Available as a subpath export:\n * ```ts\n * import { useGingerEqualizer } from \"@lucaismyname/ginger/equalizer\";\n * ```\n */\nexport function useGingerEqualizer(\n  options: UseGingerEqualizerOptions = {},\n): UseGingerEqualizerResult {\n  const { enabled = true, bands: initialBands = DEFAULT_BANDS } = options;\n  const { audioRef, state } = useGinger();\n\n  const [bands, setBandsState] = useState<EqualizerBand[]>(initialBands);\n  const [error, setError] = useState<string | null>(null);\n\n  const filterNodesRef = useRef<BiquadFilterNode[]>([]);\n\n  useEffect(() => {\n    const el = audioRef.current;\n    if (!el || typeof window === \"undefined\") {\n      return;\n    }\n\n    if (!enabled) {\n      setProcessingChain(el, []);\n      filterNodesRef.current = [];\n      return;\n    }\n\n    try {\n      // Attach a temporary analyser solely to get (or create) the shared AudioContext.\n      // The graph is rebuilt by liveAudioGraph after we call setProcessingChain, so this\n      // temporary consumer is detached immediately after we have the context reference.\n      const attached = attachLiveAnalyser(el, {\n        fftSize: 32,\n        smoothingTimeConstant: 0,\n        minDecibels: -100,\n        maxDecibels: 0,\n      });\n      const { context, id: tempId } = attached;\n\n      const filters: BiquadFilterNode[] = bands.map((band) => {\n        const node = context.createBiquadFilter();\n        node.type = band.type ?? \"peaking\";\n        node.frequency.value = band.frequency;\n        node.gain.value = band.gain ?? 0;\n        node.Q.value = band.q ?? 1;\n        return node;\n      });\n\n      filterNodesRef.current = filters;\n\n      // Install processing chain BEFORE removing the temp analyser so the graph stays valid\n      setProcessingChain(el, filters);\n      detachLiveAnalyser(el, tempId);\n\n      setError(null);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : \"Failed to create equalizer\";\n      setError(msg);\n      filterNodesRef.current = [];\n    }\n\n    return () => {\n      const element = audioRef.current;\n      if (element) {\n        setProcessingChain(element, []);\n      }\n      filterNodesRef.current = [];\n    };\n  }, [enabled, bands, audioRef, state.currentIndex]);\n\n  const setBandGain = useCallback((bandIndex: number, gainDb: number) => {\n    const node = filterNodesRef.current[bandIndex];\n    if (node) {\n      node.gain.value = gainDb;\n    }\n    setBandsState((prev) => prev.map((b, i) => (i === bandIndex ? { ...b, gain: gainDb } : b)));\n  }, []);\n\n  const setBands = useCallback((nextBands: EqualizerBand[]) => {\n    setBandsState(nextBands);\n  }, []);\n\n  return { setBandGain, setBands, bands, error };\n}\n"],"names":["DEFAULT_BANDS","useGingerEqualizer","options","enabled","initialBands","audioRef","state","useGinger","bands","setBandsState","useState","error","setError","filterNodesRef","useRef","useEffect","el","setProcessingChain","attached","attachLiveAnalyser","context","tempId","filters","band","node","detachLiveAnalyser","e","msg","element","setBandGain","useCallback","bandIndex","gainDb","prev","b","i","setBands","nextBands"],"mappings":"4LAqCMA,EAAiC,CACrC,CAAE,UAAW,EAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,GAAA,EACb,CAAE,UAAW,IAAA,CACf,EAeO,SAASC,EACdC,EAAqC,GACX,CAC1B,KAAM,CAAE,QAAAC,EAAU,GAAM,MAAOC,EAAeJ,GAAkBE,EAC1D,CAAE,SAAAG,EAAU,MAAAC,CAAA,EAAUC,YAAA,EAEtB,CAACC,EAAOC,CAAa,EAAIC,EAAAA,SAA0BN,CAAY,EAC/D,CAACO,EAAOC,CAAQ,EAAIF,EAAAA,SAAwB,IAAI,EAEhDG,EAAiBC,EAAAA,OAA2B,EAAE,EAEpDC,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAKX,EAAS,QACpB,GAAI,GAACW,GAAM,OAAO,OAAW,KAI7B,IAAI,CAACb,EAAS,CACZc,EAAAA,mBAAmBD,EAAI,EAAE,EACzBH,EAAe,QAAU,CAAA,EACzB,MACF,CAEA,GAAI,CAIF,MAAMK,EAAWC,EAAAA,mBAAmBH,EAAI,CACtC,QAAS,GACT,sBAAuB,EACvB,YAAa,KACb,YAAa,CAAA,CACd,EACK,CAAE,QAAAI,EAAS,GAAIC,CAAA,EAAWH,EAE1BI,EAA8Bd,EAAM,IAAKe,GAAS,CACtD,MAAMC,EAAOJ,EAAQ,mBAAA,EACrB,OAAAI,EAAK,KAAOD,EAAK,MAAQ,UACzBC,EAAK,UAAU,MAAQD,EAAK,UAC5BC,EAAK,KAAK,MAAQD,EAAK,MAAQ,EAC/BC,EAAK,EAAE,MAAQD,EAAK,GAAK,EAClBC,CACT,CAAC,EAEDX,EAAe,QAAUS,EAGzBL,EAAAA,mBAAmBD,EAAIM,CAAO,EAC9BG,EAAAA,mBAAmBT,EAAIK,CAAM,EAE7BT,EAAS,IAAI,CACf,OAASc,EAAG,CACV,MAAMC,EAAMD,aAAa,MAAQA,EAAE,QAAU,6BAC7Cd,EAASe,CAAG,EACZd,EAAe,QAAU,CAAA,CAC3B,CAEA,MAAO,IAAM,CACX,MAAMe,EAAUvB,EAAS,QACrBuB,GACFX,EAAAA,mBAAmBW,EAAS,EAAE,EAEhCf,EAAe,QAAU,CAAA,CAC3B,EACF,EAAG,CAACV,EAASK,EAAOH,EAAUC,EAAM,YAAY,CAAC,EAEjD,MAAMuB,EAAcC,EAAAA,YAAY,CAACC,EAAmBC,IAAmB,CACrE,MAAMR,EAAOX,EAAe,QAAQkB,CAAS,EACzCP,IACFA,EAAK,KAAK,MAAQQ,GAEpBvB,EAAewB,GAASA,EAAK,IAAI,CAACC,EAAGC,IAAOA,IAAMJ,EAAY,CAAE,GAAGG,EAAG,KAAMF,CAAA,EAAWE,CAAE,CAAC,CAC5F,EAAG,CAAA,CAAE,EAECE,EAAWN,cAAaO,GAA+B,CAC3D5B,EAAc4B,CAAS,CACzB,EAAG,CAAA,CAAE,EAEL,MAAO,CAAE,YAAAR,EAAa,SAAAO,EAAU,MAAA5B,EAAO,MAAAG,CAAA,CACzC"}

package/dist/equalizer/index.js

@@ -1,5 +1,6 @@
-import { useState as y, useRef as A, useEffect as S, useCallback as q } from "react";
-import { u as x, s as f, a as z, d as C } from "../liveAudioGraph-CmEsdLgZ.js";
+import { useState as y, useRef as A, useEffect as S, useCallback as p } from "react";
+import { s as f, a as x, d as z } from "../liveAudioGraph-DvPaxBCP.js";
+import { u as C } from "../useGinger-hpp2pAGY.js";
 const D = [
   { frequency: 60 },
   { frequency: 250 },
@@ -7,45 +8,45 @@ const D = [
   { frequency: 4e3 },
   { frequency: 16e3 }
 ];
-function L(g = {}) {
-  const { enabled: l = !0, bands: p = D } = g, { audioRef: u, state: h } = x(), [i, d] = y(p), [v, m] = y(null), s = A([]);
+function R(q = {}) {
+  const { enabled: l = !0, bands: g = D } = q, { audioRef: i, state: h } = C(), [o, d] = y(g), [v, m] = y(null), s = A([]);
   S(() => {
-    const e = u.current;
+    const e = i.current;
     if (!(!e || typeof window > "u")) {
       if (!l) {
         f(e, []), s.current = [];
         return;
       }
       try {
-        const t = z(e, {
+        const t = x(e, {
           fftSize: 32,
           smoothingTimeConstant: 0,
           minDecibels: -100,
           maxDecibels: 0
-        }), { context: n, id: o } = t, c = i.map((r) => {
+        }), { context: n, id: u } = t, c = o.map((r) => {
           const a = n.createBiquadFilter();
           return a.type = r.type ?? "peaking", a.frequency.value = r.frequency, a.gain.value = r.gain ?? 0, a.Q.value = r.q ?? 1, a;
         });
-        s.current = c, f(e, c), C(e, o), m(null);
+        s.current = c, f(e, c), z(e, u), m(null);
       } catch (t) {
         const n = t instanceof Error ? t.message : "Failed to create equalizer";
         m(n), s.current = [];
       }
       return () => {
-        const t = u.current;
+        const t = i.current;
         t && f(t, []), s.current = [];
       };
     }
-  }, [l, i, u, h.currentIndex]);
-  const B = q((e, t) => {
+  }, [l, o, i, h.currentIndex]);
+  const B = p((e, t) => {
     const n = s.current[e];
-    n && (n.gain.value = t), d((o) => o.map((c, r) => r === e ? { ...c, gain: t } : c));
-  }, []), E = q((e) => {
+    n && (n.gain.value = t), d((u) => u.map((c, r) => r === e ? { ...c, gain: t } : c));
+  }, []), E = p((e) => {
     d(e);
   }, []);
-  return { setBandGain: B, setBands: E, bands: i, error: v };
+  return { setBandGain: B, setBands: E, bands: o, error: v };
 }
 export {
-  L as useGingerEqualizer
+  R as useGingerEqualizer
 };
 //# sourceMappingURL=index.js.map

package/dist/equalizer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/equalizer/useGingerEqualizer.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n  attachLiveAnalyser,\n  detachLiveAnalyser,\n  setProcessingChain,\n} from \"../analyzer/liveAudioGraph\";\nimport { useGinger } from \"../hooks/useGinger\";\n\nexport type EqualizerBand = {\n  /** Center frequency in Hz (e.g. 60, 250, 1000, 4000, 16000). */\n  frequency: number;\n  /** Gain in dB. Positive = boost, negative = cut. Typical range: -12 to +12. Default: 0. */\n  gain?: number;\n  /** Q factor (bandwidth). Higher = narrower. Default: 1. */\n  q?: number;\n  /** BiquadFilterNode type. Default: \"peaking\". */\n  type?: BiquadFilterType;\n};\n\nexport type UseGingerEqualizerOptions = {\n  /** When false, EQ nodes are detached and the audio path is bypassed. Default: true. */\n  enabled?: boolean;\n  /** Band definitions. Each band maps to one BiquadFilterNode. */\n  bands?: EqualizerBand[];\n};\n\nexport type UseGingerEqualizerResult = {\n  /** Update a single band's gain in dB without rebuilding the filter chain. */\n  setBandGain: (bandIndex: number, gainDb: number) => void;\n  /** Replace all bands (rebuilds the filter chain). */\n  setBands: (bands: EqualizerBand[]) => void;\n  /** Current band definitions (reflects the latest `setBands` call). */\n  bands: EqualizerBand[];\n  /** Error string if Web Audio is unavailable or filter creation failed. */\n  error: string | null;\n};\n\nconst DEFAULT_BANDS: EqualizerBand[] = [\n  { frequency: 60 },\n  { frequency: 250 },\n  { frequency: 1000 },\n  { frequency: 4000 },\n  { frequency: 16000 },\n];\n\n/**\n * Inserts a parametric EQ into the Web Audio graph for the active Ginger media element.\n *\n * Each band is a `BiquadFilterNode` connected in series between the audio source and the\n * speakers. If `useGingerLiveAnalyzer` is also active, the EQ is inserted before the analyser\n * — both share the same `AudioContext` (the browser allows only one `MediaElementAudioSourceNode`\n * per element).\n *\n * Available as a subpath export:\n * ```ts\n * import { useGingerEqualizer } from \"@lucaismyname/ginger/equalizer\";\n * ```\n */\nexport function useGingerEqualizer(\n  options: UseGingerEqualizerOptions = {},\n): UseGingerEqualizerResult {\n  const { enabled = true, bands: initialBands = DEFAULT_BANDS } = options;\n  const { audioRef, state } = useGinger();\n\n  const [bands, setBandsState] = useState<EqualizerBand[]>(initialBands);\n  const [error, setError] = useState<string | null>(null);\n\n  const filterNodesRef = useRef<BiquadFilterNode[]>([]);\n\n  useEffect(() => {\n    const el = audioRef.current;\n    if (!el || typeof window === \"undefined\") {\n      return;\n    }\n\n    if (!enabled) {\n      setProcessingChain(el, []);\n      filterNodesRef.current = [];\n      return;\n    }\n\n    try {\n      // Attach a temporary analyser solely to get (or create) the shared AudioContext.\n      // The graph is rebuilt by liveAudioGraph after we call setProcessingChain, so this\n      // temporary consumer is detached immediately after we have the context reference.\n      const attached = attachLiveAnalyser(el, {\n        fftSize: 32,\n        smoothingTimeConstant: 0,\n        minDecibels: -100,\n        maxDecibels: 0,\n      });\n      const { context, id: tempId } = attached;\n\n      const filters: BiquadFilterNode[] = bands.map((band) => {\n        const node = context.createBiquadFilter();\n        node.type = band.type ?? \"peaking\";\n        node.frequency.value = band.frequency;\n        node.gain.value = band.gain ?? 0;\n        node.Q.value = band.q ?? 1;\n        return node;\n      });\n\n      filterNodesRef.current = filters;\n\n      // Install processing chain BEFORE removing the temp analyser so the graph stays valid\n      setProcessingChain(el, filters);\n      detachLiveAnalyser(el, tempId);\n\n      setError(null);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : \"Failed to create equalizer\";\n      setError(msg);\n      filterNodesRef.current = [];\n    }\n\n    return () => {\n      const element = audioRef.current;\n      if (element) {\n        setProcessingChain(element, []);\n      }\n      filterNodesRef.current = [];\n    };\n  }, [enabled, bands, audioRef, state.currentIndex]);\n\n  const setBandGain = useCallback((bandIndex: number, gainDb: number) => {\n    const node = filterNodesRef.current[bandIndex];\n    if (node) {\n      node.gain.value = gainDb;\n    }\n    setBandsState((prev) => prev.map((b, i) => (i === bandIndex ? { ...b, gain: gainDb } : b)));\n  }, []);\n\n  const setBands = useCallback((nextBands: EqualizerBand[]) => {\n    setBandsState(nextBands);\n  }, []);\n\n  return { setBandGain, setBands, bands, error };\n}\n"],"names":["DEFAULT_BANDS","useGingerEqualizer","options","enabled","initialBands","audioRef","state","useGinger","bands","setBandsState","useState","error","setError","filterNodesRef","useRef","useEffect","el","setProcessingChain","attached","attachLiveAnalyser","context","tempId","filters","band","node","detachLiveAnalyser","e","msg","element","setBandGain","useCallback","bandIndex","gainDb","prev","b","i","setBands","nextBands"],"mappings":";;AAqCA,MAAMA,IAAiC;AAAA,EACrC,EAAE,WAAW,GAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,KAAA;AACf;AAeO,SAASC,EACdC,IAAqC,IACX;AAC1B,QAAM,EAAE,SAAAC,IAAU,IAAM,OAAOC,IAAeJ,MAAkBE,GAC1D,EAAE,UAAAG,GAAU,OAAAC,EAAA,IAAUC,EAAA,GAEtB,CAACC,GAAOC,CAAa,IAAIC,EAA0BN,CAAY,GAC/D,CAACO,GAAOC,CAAQ,IAAIF,EAAwB,IAAI,GAEhDG,IAAiBC,EAA2B,EAAE;AAEpD,EAAAC,EAAU,MAAM;AACd,UAAMC,IAAKX,EAAS;AACpB,QAAI,GAACW,KAAM,OAAO,SAAW,MAI7B;AAAA,UAAI,CAACb,GAAS;AACZ,QAAAc,EAAmBD,GAAI,EAAE,GACzBH,EAAe,UAAU,CAAA;AACzB;AAAA,MACF;AAEA,UAAI;AAIF,cAAMK,IAAWC,EAAmBH,GAAI;AAAA,UACtC,SAAS;AAAA,UACT,uBAAuB;AAAA,UACvB,aAAa;AAAA,UACb,aAAa;AAAA,QAAA,CACd,GACK,EAAE,SAAAI,GAAS,IAAIC,EAAA,IAAWH,GAE1BI,IAA8Bd,EAAM,IAAI,CAACe,MAAS;AACtD,gBAAMC,IAAOJ,EAAQ,mBAAA;AACrB,iBAAAI,EAAK,OAAOD,EAAK,QAAQ,WACzBC,EAAK,UAAU,QAAQD,EAAK,WAC5BC,EAAK,KAAK,QAAQD,EAAK,QAAQ,GAC/BC,EAAK,EAAE,QAAQD,EAAK,KAAK,GAClBC;AAAA,QACT,CAAC;AAED,QAAAX,EAAe,UAAUS,GAGzBL,EAAmBD,GAAIM,CAAO,GAC9BG,EAAmBT,GAAIK,CAAM,GAE7BT,EAAS,IAAI;AAAA,MACf,SAASc,GAAG;AACV,cAAMC,IAAMD,aAAa,QAAQA,EAAE,UAAU;AAC7C,QAAAd,EAASe,CAAG,GACZd,EAAe,UAAU,CAAA;AAAA,MAC3B;AAEA,aAAO,MAAM;AACX,cAAMe,IAAUvB,EAAS;AACzB,QAAIuB,KACFX,EAAmBW,GAAS,EAAE,GAEhCf,EAAe,UAAU,CAAA;AAAA,MAC3B;AAAA;AAAA,EACF,GAAG,CAACV,GAASK,GAAOH,GAAUC,EAAM,YAAY,CAAC;AAEjD,QAAMuB,IAAcC,EAAY,CAACC,GAAmBC,MAAmB;AACrE,UAAMR,IAAOX,EAAe,QAAQkB,CAAS;AAC7C,IAAIP,MACFA,EAAK,KAAK,QAAQQ,IAEpBvB,EAAc,CAACwB,MAASA,EAAK,IAAI,CAACC,GAAGC,MAAOA,MAAMJ,IAAY,EAAE,GAAGG,GAAG,MAAMF,EAAA,IAAWE,CAAE,CAAC;AAAA,EAC5F,GAAG,CAAA,CAAE,GAECE,IAAWN,EAAY,CAACO,MAA+B;AAC3D,IAAA5B,EAAc4B,CAAS;AAAA,EACzB,GAAG,CAAA,CAAE;AAEL,SAAO,EAAE,aAAAR,GAAa,UAAAO,GAAU,OAAA5B,GAAO,OAAAG,EAAA;AACzC;"}
+{"version":3,"file":"index.js","sources":["../../src/equalizer/useGingerEqualizer.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n  attachLiveAnalyser,\n  detachLiveAnalyser,\n  setProcessingChain,\n} from \"../analyzer/liveAudioGraph\";\nimport { useGinger } from \"../hooks/useGinger\";\n\nexport type EqualizerBand = {\n  /** Center frequency in Hz (e.g. 60, 250, 1000, 4000, 16000). */\n  frequency: number;\n  /** Gain in dB. Positive = boost, negative = cut. Typical range: -12 to +12. Default: 0. */\n  gain?: number;\n  /** Q factor (bandwidth). Higher = narrower. Default: 1. */\n  q?: number;\n  /** BiquadFilterNode type. Default: \"peaking\". */\n  type?: BiquadFilterType;\n};\n\nexport type UseGingerEqualizerOptions = {\n  /** When false, EQ nodes are detached and the audio path is bypassed. Default: true. */\n  enabled?: boolean;\n  /** Band definitions. Each band maps to one BiquadFilterNode. */\n  bands?: EqualizerBand[];\n};\n\nexport type UseGingerEqualizerResult = {\n  /** Update a single band's gain in dB without rebuilding the filter chain. */\n  setBandGain: (bandIndex: number, gainDb: number) => void;\n  /** Replace all bands (rebuilds the filter chain). */\n  setBands: (bands: EqualizerBand[]) => void;\n  /** Current band definitions (reflects the latest `setBands` call). */\n  bands: EqualizerBand[];\n  /** Error string if Web Audio is unavailable or filter creation failed. */\n  error: string | null;\n};\n\nconst DEFAULT_BANDS: EqualizerBand[] = [\n  { frequency: 60 },\n  { frequency: 250 },\n  { frequency: 1000 },\n  { frequency: 4000 },\n  { frequency: 16000 },\n];\n\n/**\n * Inserts a parametric EQ into the Web Audio graph for the active Ginger media element.\n *\n * Each band is a `BiquadFilterNode` connected in series between the audio source and the\n * speakers. If `useGingerLiveAnalyzer` is also active, the EQ is inserted before the analyser\n * — both share the same `AudioContext` (the browser allows only one `MediaElementAudioSourceNode`\n * per element).\n *\n * Available as a subpath export:\n * ```ts\n * import { useGingerEqualizer } from \"@lucaismyname/ginger/equalizer\";\n * ```\n */\nexport function useGingerEqualizer(\n  options: UseGingerEqualizerOptions = {},\n): UseGingerEqualizerResult {\n  const { enabled = true, bands: initialBands = DEFAULT_BANDS } = options;\n  const { audioRef, state } = useGinger();\n\n  const [bands, setBandsState] = useState<EqualizerBand[]>(initialBands);\n  const [error, setError] = useState<string | null>(null);\n\n  const filterNodesRef = useRef<BiquadFilterNode[]>([]);\n\n  useEffect(() => {\n    const el = audioRef.current;\n    if (!el || typeof window === \"undefined\") {\n      return;\n    }\n\n    if (!enabled) {\n      setProcessingChain(el, []);\n      filterNodesRef.current = [];\n      return;\n    }\n\n    try {\n      // Attach a temporary analyser solely to get (or create) the shared AudioContext.\n      // The graph is rebuilt by liveAudioGraph after we call setProcessingChain, so this\n      // temporary consumer is detached immediately after we have the context reference.\n      const attached = attachLiveAnalyser(el, {\n        fftSize: 32,\n        smoothingTimeConstant: 0,\n        minDecibels: -100,\n        maxDecibels: 0,\n      });\n      const { context, id: tempId } = attached;\n\n      const filters: BiquadFilterNode[] = bands.map((band) => {\n        const node = context.createBiquadFilter();\n        node.type = band.type ?? \"peaking\";\n        node.frequency.value = band.frequency;\n        node.gain.value = band.gain ?? 0;\n        node.Q.value = band.q ?? 1;\n        return node;\n      });\n\n      filterNodesRef.current = filters;\n\n      // Install processing chain BEFORE removing the temp analyser so the graph stays valid\n      setProcessingChain(el, filters);\n      detachLiveAnalyser(el, tempId);\n\n      setError(null);\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : \"Failed to create equalizer\";\n      setError(msg);\n      filterNodesRef.current = [];\n    }\n\n    return () => {\n      const element = audioRef.current;\n      if (element) {\n        setProcessingChain(element, []);\n      }\n      filterNodesRef.current = [];\n    };\n  }, [enabled, bands, audioRef, state.currentIndex]);\n\n  const setBandGain = useCallback((bandIndex: number, gainDb: number) => {\n    const node = filterNodesRef.current[bandIndex];\n    if (node) {\n      node.gain.value = gainDb;\n    }\n    setBandsState((prev) => prev.map((b, i) => (i === bandIndex ? { ...b, gain: gainDb } : b)));\n  }, []);\n\n  const setBands = useCallback((nextBands: EqualizerBand[]) => {\n    setBandsState(nextBands);\n  }, []);\n\n  return { setBandGain, setBands, bands, error };\n}\n"],"names":["DEFAULT_BANDS","useGingerEqualizer","options","enabled","initialBands","audioRef","state","useGinger","bands","setBandsState","useState","error","setError","filterNodesRef","useRef","useEffect","el","setProcessingChain","attached","attachLiveAnalyser","context","tempId","filters","band","node","detachLiveAnalyser","e","msg","element","setBandGain","useCallback","bandIndex","gainDb","prev","b","i","setBands","nextBands"],"mappings":";;;AAqCA,MAAMA,IAAiC;AAAA,EACrC,EAAE,WAAW,GAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,IAAA;AAAA,EACb,EAAE,WAAW,KAAA;AACf;AAeO,SAASC,EACdC,IAAqC,IACX;AAC1B,QAAM,EAAE,SAAAC,IAAU,IAAM,OAAOC,IAAeJ,MAAkBE,GAC1D,EAAE,UAAAG,GAAU,OAAAC,EAAA,IAAUC,EAAA,GAEtB,CAACC,GAAOC,CAAa,IAAIC,EAA0BN,CAAY,GAC/D,CAACO,GAAOC,CAAQ,IAAIF,EAAwB,IAAI,GAEhDG,IAAiBC,EAA2B,EAAE;AAEpD,EAAAC,EAAU,MAAM;AACd,UAAMC,IAAKX,EAAS;AACpB,QAAI,GAACW,KAAM,OAAO,SAAW,MAI7B;AAAA,UAAI,CAACb,GAAS;AACZ,QAAAc,EAAmBD,GAAI,EAAE,GACzBH,EAAe,UAAU,CAAA;AACzB;AAAA,MACF;AAEA,UAAI;AAIF,cAAMK,IAAWC,EAAmBH,GAAI;AAAA,UACtC,SAAS;AAAA,UACT,uBAAuB;AAAA,UACvB,aAAa;AAAA,UACb,aAAa;AAAA,QAAA,CACd,GACK,EAAE,SAAAI,GAAS,IAAIC,EAAA,IAAWH,GAE1BI,IAA8Bd,EAAM,IAAI,CAACe,MAAS;AACtD,gBAAMC,IAAOJ,EAAQ,mBAAA;AACrB,iBAAAI,EAAK,OAAOD,EAAK,QAAQ,WACzBC,EAAK,UAAU,QAAQD,EAAK,WAC5BC,EAAK,KAAK,QAAQD,EAAK,QAAQ,GAC/BC,EAAK,EAAE,QAAQD,EAAK,KAAK,GAClBC;AAAA,QACT,CAAC;AAED,QAAAX,EAAe,UAAUS,GAGzBL,EAAmBD,GAAIM,CAAO,GAC9BG,EAAmBT,GAAIK,CAAM,GAE7BT,EAAS,IAAI;AAAA,MACf,SAASc,GAAG;AACV,cAAMC,IAAMD,aAAa,QAAQA,EAAE,UAAU;AAC7C,QAAAd,EAASe,CAAG,GACZd,EAAe,UAAU,CAAA;AAAA,MAC3B;AAEA,aAAO,MAAM;AACX,cAAMe,IAAUvB,EAAS;AACzB,QAAIuB,KACFX,EAAmBW,GAAS,EAAE,GAEhCf,EAAe,UAAU,CAAA;AAAA,MAC3B;AAAA;AAAA,EACF,GAAG,CAACV,GAASK,GAAOH,GAAUC,EAAM,YAAY,CAAC;AAEjD,QAAMuB,IAAcC,EAAY,CAACC,GAAmBC,MAAmB;AACrE,UAAMR,IAAOX,EAAe,QAAQkB,CAAS;AAC7C,IAAIP,MACFA,EAAK,KAAK,QAAQQ,IAEpBvB,EAAc,CAACwB,MAASA,EAAK,IAAI,CAACC,GAAGC,MAAOA,MAAMJ,IAAY,EAAE,GAAGG,GAAG,MAAMF,EAAA,IAAWE,CAAE,CAAC;AAAA,EAC5F,GAAG,CAAA,CAAE,GAECE,IAAWN,EAAY,CAACO,MAA+B;AAC3D,IAAA5B,EAAc4B,CAAS;AAAA,EACzB,GAAG,CAAA,CAAE;AAEL,SAAO,EAAE,aAAAR,GAAa,UAAAO,GAAU,OAAA5B,GAAO,OAAAG,EAAA;AACzC;"}

package/dist/hooks/useNextTrackPrefetch.d.ts

@@ -11,6 +11,9 @@ export type UseNextTrackPrefetchOptions = {
  * Warms the browser cache for the **logical** next track (same rules as the Next control:
  * `computeNextIndex` from queue, repeat, and playback mode) using a detached `HTMLAudioElement`
  * with `preload="auto"`. Safe to call alongside `Ginger.Player`; it does not replace main playback.
+ *
+ * The effect depends on the `tracks` array reference from context. If the parent recreates `tracks`
+ * every render, prefetch will restart repeatedly; keep a stable queue reference (e.g. memoize) when possible.
  */
 export declare function useNextTrackPrefetch(options?: UseNextTrackPrefetchOptions): void;
 //# sourceMappingURL=useNextTrackPrefetch.d.ts.map

package/dist/hooks/useNextTrackPrefetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNextTrackPrefetch.d.ts","sourceRoot":"","sources":["../../src/hooks/useNextTrackPrefetch.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG;IACxC,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,GAAG,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAChE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,IAAI,CAsBpF"}
+{"version":3,"file":"useNextTrackPrefetch.d.ts","sourceRoot":"","sources":["../../src/hooks/useNextTrackPrefetch.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,2BAA2B,GAAG;IACxC,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,GAAG,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAChE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,IAAI,CAsBpF"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-NEcOSSJD.cjs"),i=require("./liveAudioGraph-D1BXMv_u.cjs"),r=require("./useGingerChapterProgress-BOqUimE7.cjs"),s=require("./selectors-YXnP8Y8g.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Chapters=e.Chapters;exports.Ginger=e.Ginger;exports.LyricsSynced=e.LyricsSynced;exports.Pause=e.Pause;exports.Play=e.Play;exports.RepeatGlyph=e.RepeatGlyph;exports.ShuffleIcon=e.ShuffleIcon;exports.SkipBack=e.SkipBack;exports.SkipForward=e.SkipForward;exports.Volume2=e.Volume2;exports.VolumeX=e.VolumeX;exports.Wrapper=e.Wrapper;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.parseLrc=e.parseLrc;exports.useGingerChapters=e.useGingerChapters;exports.useGingerLocale=e.useGingerLocale;exports.useGingerLyricsSync=e.useGingerLyricsSync;exports.usePlayPauseBinding=e.usePlayPauseBinding;exports.useSeekBarBinding=e.useSeekBarBinding;exports.useVolumeSlider=e.useVolumeSlider;exports.attachLiveAnalyser=i.attachLiveAnalyser;exports.detachLiveAnalyser=i.detachLiveAnalyser;exports.setProcessingChain=i.setProcessingChain;exports.useGinger=i.useGinger;exports.createGingerStore=r.createGingerStore;exports.useGingerChapterProgress=r.useGingerChapterProgress;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=r.useGingerLiveAnalyzer;exports.useGingerPlaybackHistory=r.useGingerPlaybackHistory;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useGingerVolumeFade=r.useGingerVolumeFade;exports.useNextTrackPrefetch=r.useNextTrackPrefetch;exports.useSeekDrag=r.useSeekDrag;exports.derivePlaybackUiState=s.derivePlaybackUiState;exports.gingerStateFromContextValues=a.gingerStateFromContextValues;exports.gingerStateFromContexts=a.gingerStateFromContexts;exports.useGingerMedia=a.useGingerMedia;exports.useGingerPlayback=a.useGingerPlayback;exports.useGingerState=a.useGingerState;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-NEcOSSJD.cjs"),s=require("./useGinger-BXgia32v.cjs"),r=require("./useGingerChapterProgress-BdaalJvX.cjs"),i=require("./liveAudioGraph-0cpHD_Ic.cjs"),n=require("./selectors-YXnP8Y8g.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Chapters=e.Chapters;exports.Ginger=e.Ginger;exports.LyricsSynced=e.LyricsSynced;exports.Pause=e.Pause;exports.Play=e.Play;exports.RepeatGlyph=e.RepeatGlyph;exports.ShuffleIcon=e.ShuffleIcon;exports.SkipBack=e.SkipBack;exports.SkipForward=e.SkipForward;exports.Volume2=e.Volume2;exports.VolumeX=e.VolumeX;exports.Wrapper=e.Wrapper;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.parseLrc=e.parseLrc;exports.useGingerChapters=e.useGingerChapters;exports.useGingerLocale=e.useGingerLocale;exports.useGingerLyricsSync=e.useGingerLyricsSync;exports.usePlayPauseBinding=e.usePlayPauseBinding;exports.useSeekBarBinding=e.useSeekBarBinding;exports.useVolumeSlider=e.useVolumeSlider;exports.useGinger=s.useGinger;exports.createGingerStore=r.createGingerStore;exports.useGingerChapterProgress=r.useGingerChapterProgress;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=r.useGingerLiveAnalyzer;exports.useGingerPlaybackHistory=r.useGingerPlaybackHistory;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useGingerVolumeFade=r.useGingerVolumeFade;exports.useNextTrackPrefetch=r.useNextTrackPrefetch;exports.useSeekDrag=r.useSeekDrag;exports.attachLiveAnalyser=i.attachLiveAnalyser;exports.detachLiveAnalyser=i.detachLiveAnalyser;exports.setProcessingChain=i.setProcessingChain;exports.derivePlaybackUiState=n.derivePlaybackUiState;exports.gingerStateFromContextValues=a.gingerStateFromContextValues;exports.gingerStateFromContexts=a.gingerStateFromContexts;exports.useGingerMedia=a.useGingerMedia;exports.useGingerPlayback=a.useGingerPlayback;exports.useGingerState=a.useGingerState;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,50 +1,51 @@
-import { C as s, G as r, L as i, P as u, a as t, R as n, S as g, b as o, c, V as l, d as p, W as G, e as y, f as S, g as d, p as m, u as h, h as P, i as f, j as k, k as L, l as b } from "./ginger-L2ZFgzH4.js";
-import { a as C, d as V, s as v, u as B } from "./liveAudioGraph-CmEsdLgZ.js";
-import { c as A, u as R, a as D, b as T, d as W, e as j, f as w, g as z, h as H, i as I } from "./useGingerChapterProgress-DLYdGytK.js";
-import { d as M } from "./selectors-BalBCc7X.js";
-import { g as U, a as X, u as q, b as E, c as J } from "./GingerSplitContexts-BzBExb95.js";
+import { C as s, G as r, L as i, P as t, a as u, R as n, S as o, b as g, c, V as l, d as p, W as G, e as m, f as y, g as S, p as d, u as f, h, i as P, j as k, k as L, l as b } from "./ginger-L2ZFgzH4.js";
+import { u as C } from "./useGinger-hpp2pAGY.js";
+import { c as v, u as B, a as F, b as A, d as R, e as D, f as T, g as W, h as j, i as w } from "./useGingerChapterProgress-CZdv-HiI.js";
+import { a as H, d as I, s as K } from "./liveAudioGraph-DvPaxBCP.js";
+import { d as N } from "./selectors-BalBCc7X.js";
+import { g as X, a as q, u as E, b as J, c as O } from "./GingerSplitContexts-BzBExb95.js";
 export {
   s as Chapters,
   r as Ginger,
   i as LyricsSynced,
-  u as Pause,
-  t as Play,
+  t as Pause,
+  u as Play,
   n as RepeatGlyph,
-  g as ShuffleIcon,
-  o as SkipBack,
+  o as ShuffleIcon,
+  g as SkipBack,
   c as SkipForward,
   l as Volume2,
   p as VolumeX,
   G as Wrapper,
-  C as attachLiveAnalyser,
-  y as clampPlaybackRate,
-  S as clampVolume,
-  A as createGingerStore,
-  d as defaultGingerLocale,
-  M as derivePlaybackUiState,
-  V as detachLiveAnalyser,
-  U as gingerStateFromContextValues,
-  X as gingerStateFromContexts,
-  m as parseLrc,
-  v as setProcessingChain,
-  B as useGinger,
-  R as useGingerChapterProgress,
-  h as useGingerChapters,
-  D as useGingerDebugLog,
-  T as useGingerKeyboardShortcuts,
-  W as useGingerLiveAnalyzer,
-  P as useGingerLocale,
-  f as useGingerLyricsSync,
-  q as useGingerMedia,
-  E as useGingerPlayback,
-  j as useGingerPlaybackHistory,
-  w as useGingerSleepTimer,
-  J as useGingerState,
-  z as useGingerVolumeFade,
-  H as useNextTrackPrefetch,
+  H as attachLiveAnalyser,
+  m as clampPlaybackRate,
+  y as clampVolume,
+  v as createGingerStore,
+  S as defaultGingerLocale,
+  N as derivePlaybackUiState,
+  I as detachLiveAnalyser,
+  X as gingerStateFromContextValues,
+  q as gingerStateFromContexts,
+  d as parseLrc,
+  K as setProcessingChain,
+  C as useGinger,
+  B as useGingerChapterProgress,
+  f as useGingerChapters,
+  F as useGingerDebugLog,
+  A as useGingerKeyboardShortcuts,
+  R as useGingerLiveAnalyzer,
+  h as useGingerLocale,
+  P as useGingerLyricsSync,
+  E as useGingerMedia,
+  J as useGingerPlayback,
+  D as useGingerPlaybackHistory,
+  T as useGingerSleepTimer,
+  O as useGingerState,
+  W as useGingerVolumeFade,
+  j as useNextTrackPrefetch,
   k as usePlayPauseBinding,
   L as useSeekBarBinding,
-  I as useSeekDrag,
+  w as useSeekDrag,
   b as useVolumeSlider
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/liveAudioGraph-0cpHD_Ic.cjs

@@ -0,0 +1,2 @@
+"use strict";const r=new WeakMap;function h(t){const e=2**Math.round(Math.log2(t));return Math.min(32768,Math.max(32,e))}function d(t){const{processingChain:e}=t;return e.length>0?e[e.length-1]:t.source}function a(t){const{source:e,processingChain:n,consumers:s,context:c}=t;try{e.disconnect()}catch{}for(const i of n)try{i.disconnect()}catch{}for(const{analyser:i}of s.values())try{i.disconnect(c.destination)}catch{}if(n.length>0){e.connect(n[0]);for(let i=0;i<n.length-1;i++)n[i].connect(n[i+1])}const o=d(t);if(s.size===0)o.connect(c.destination);else{let i=!0;for(const{analyser:u}of s.values())o.connect(u),i&&(u.connect(c.destination),i=!1)}}function f(t){let e=r.get(t);if(!e){const n=window.AudioContext??window.webkitAudioContext;if(!n)throw new Error("Web Audio API is not available");const s=new n,c=s.createMediaElementSource(t);e={context:s,source:c,consumers:new Map,nextId:0,processingChain:[],processingActive:!1},r.set(t,e)}return e}function l(t,e){if(e.consumers.size===0&&!e.processingActive){try{e.source.disconnect()}catch{}e.context.close(),r.delete(t)}}function g(t,e){const n=f(t),{context:s}=n,c=s.createAnalyser();c.fftSize=h(e.fftSize),c.smoothingTimeConstant=e.smoothingTimeConstant,c.minDecibels=e.minDecibels,c.maxDecibels=e.maxDecibels;const o=n.nextId;return n.nextId+=1,n.consumers.set(o,{analyser:c}),a(n),{id:o,context:s,analyser:c}}function y(t,e){const n=r.get(t);if(!n)return;const s=n.consumers.get(e);if(s){try{s.analyser.disconnect()}catch{}if(n.consumers.delete(e),n.consumers.size===0&&!n.processingActive){l(t,n);return}a(n)}}function m(t,e){if(typeof window>"u")return;if(e.length===0){const s=r.get(t);if(!s)return;s.processingChain=[],s.processingActive=!1,s.consumers.size===0?l(t,s):a(s);return}const n=f(t);n.processingChain=e,n.processingActive=!0,a(n)}exports.attachLiveAnalyser=g;exports.detachLiveAnalyser=y;exports.setProcessingChain=m;
+//# sourceMappingURL=liveAudioGraph-0cpHD_Ic.cjs.map

package/dist/liveAudioGraph-0cpHD_Ic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveAudioGraph-0cpHD_Ic.cjs","sources":["../src/analyzer/liveAudioGraph.ts"],"sourcesContent":["/**\n * One MediaElementAudioSourceNode per HTMLAudioElement; multiple AnalyserNodes may tap the source.\n * An optional processing chain (e.g. EQ filters) can be inserted between the source and the\n * analysers via `setProcessingChain`.\n */\n\nexport type LiveAnalyserOptions = {\n  fftSize: number;\n  smoothingTimeConstant: number;\n  minDecibels: number;\n  maxDecibels: number;\n};\n\ntype Consumer = {\n  analyser: AnalyserNode;\n};\n\ntype ElementEntry = {\n  context: AudioContext;\n  source: MediaElementAudioSourceNode;\n  consumers: Map<number, Consumer>;\n  nextId: number;\n  /** Ordered processing nodes (e.g. BiquadFilterNode[]) inserted between source and analysers. */\n  processingChain: AudioNode[];\n  /** True while a processing chain is installed; prevents context teardown when no consumers exist. */\n  processingActive: boolean;\n};\n\nconst entries = new WeakMap<HTMLAudioElement, ElementEntry>();\n\nfunction clampFftSize(n: number): number {\n  const p = 2 ** Math.round(Math.log2(n));\n  return Math.min(32768, Math.max(32, p));\n}\n\nfunction getChainTail(entry: ElementEntry): AudioNode {\n  const { processingChain } = entry;\n  return processingChain.length > 0 ? processingChain[processingChain.length - 1]! : entry.source;\n}\n\n/**\n * Rebuild all graph connections from scratch.\n * Call after any structural change (add/remove consumer, change processing chain).\n */\nfunction rebuildGraph(entry: ElementEntry): void {\n  const { source, processingChain, consumers, context } = entry;\n\n  // Disconnect source outputs\n  try {\n    source.disconnect();\n  } catch {\n    // ignore\n  }\n\n  // Disconnect processing chain node outputs\n  for (const node of processingChain) {\n    try {\n      node.disconnect();\n    } catch {\n      // ignore\n    }\n  }\n\n  // Disconnect all analysers from destination (we will reconnect selectively below)\n  for (const { analyser } of consumers.values()) {\n    try {\n      analyser.disconnect(context.destination);\n    } catch {\n      // ignore\n    }\n  }\n\n  // Build processing chain: source → node[0] → ... → node[N]\n  if (processingChain.length > 0) {\n    source.connect(processingChain[0]!);\n    for (let i = 0; i < processingChain.length - 1; i++) {\n      processingChain[i]!.connect(processingChain[i + 1]!);\n    }\n  }\n\n  const tail = getChainTail(entry);\n\n  if (consumers.size === 0) {\n    // No analyser consumers: route tail directly to destination so audio is audible\n    tail.connect(context.destination);\n  } else {\n    // Connect tail to all analysers; first one routes to destination (playback sink)\n    let isFirst = true;\n    for (const { analyser } of consumers.values()) {\n      tail.connect(analyser);\n      if (isFirst) {\n        analyser.connect(context.destination);\n        isFirst = false;\n      }\n    }\n  }\n}\n\nfunction getOrCreateEntry(element: HTMLAudioElement): ElementEntry {\n  let entry = entries.get(element);\n  if (!entry) {\n    const Context =\n      window.AudioContext ??\n      (window as unknown as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Context) {\n      throw new Error(\"Web Audio API is not available\");\n    }\n    const context = new Context();\n    const source = context.createMediaElementSource(element);\n    entry = {\n      context,\n      source,\n      consumers: new Map(),\n      nextId: 0,\n      processingChain: [],\n      processingActive: false,\n    };\n    entries.set(element, entry);\n  }\n  return entry;\n}\n\nfunction maybeCloseEntry(element: HTMLAudioElement, entry: ElementEntry): void {\n  if (entry.consumers.size === 0 && !entry.processingActive) {\n    try {\n      entry.source.disconnect();\n    } catch {\n      // ignore\n    }\n    void entry.context.close();\n    entries.delete(element);\n  }\n}\n\nexport function attachLiveAnalyser(\n  element: HTMLAudioElement,\n  options: LiveAnalyserOptions,\n): { id: number; context: AudioContext; analyser: AnalyserNode } {\n  const entry = getOrCreateEntry(element);\n  const { context } = entry;\n\n  const analyser = context.createAnalyser();\n  analyser.fftSize = clampFftSize(options.fftSize);\n  analyser.smoothingTimeConstant = options.smoothingTimeConstant;\n  analyser.minDecibels = options.minDecibels;\n  analyser.maxDecibels = options.maxDecibels;\n\n  const id = entry.nextId;\n  entry.nextId += 1;\n  entry.consumers.set(id, { analyser });\n\n  rebuildGraph(entry);\n\n  return { id, context, analyser };\n}\n\nexport function detachLiveAnalyser(element: HTMLAudioElement, id: number): void {\n  const entry = entries.get(element);\n  if (!entry) return;\n\n  const consumer = entry.consumers.get(id);\n  if (!consumer) return;\n\n  try {\n    consumer.analyser.disconnect();\n  } catch {\n    // ignore\n  }\n  entry.consumers.delete(id);\n\n  if (entry.consumers.size === 0 && !entry.processingActive) {\n    maybeCloseEntry(element, entry);\n    return;\n  }\n\n  rebuildGraph(entry);\n}\n\n/**\n * Insert an ordered processing chain (e.g. BiquadFilterNode[]) between the audio source and the\n * analyser consumers. Pass an empty array to clear the chain.\n *\n * Safe to call while analyser consumers are active; the graph is rebuilt immediately.\n * Note: because `createMediaElementSource` can only be called once per element, the EQ and live\n * analyser share the same AudioContext. Calling both for the same element is supported.\n */\nexport function setProcessingChain(element: HTMLAudioElement, nodes: AudioNode[]): void {\n  if (typeof window === \"undefined\") return;\n\n  if (nodes.length === 0) {\n    const entry = entries.get(element);\n    if (!entry) return;\n    entry.processingChain = [];\n    entry.processingActive = false;\n    if (entry.consumers.size === 0) {\n      maybeCloseEntry(element, entry);\n    } else {\n      rebuildGraph(entry);\n    }\n    return;\n  }\n\n  const entry = getOrCreateEntry(element);\n  entry.processingChain = nodes;\n  entry.processingActive = true;\n  rebuildGraph(entry);\n}\n"],"names":["entries","clampFftSize","n","p","getChainTail","entry","processingChain","rebuildGraph","source","consumers","context","node","analyser","tail","isFirst","getOrCreateEntry","element","Context","maybeCloseEntry","attachLiveAnalyser","options","id","detachLiveAnalyser","consumer","setProcessingChain","nodes"],"mappings":"aA4BA,MAAMA,MAAc,QAEpB,SAASC,EAAaC,EAAmB,CACvC,MAAMC,EAAI,GAAK,KAAK,MAAM,KAAK,KAAKD,CAAC,CAAC,EACtC,OAAO,KAAK,IAAI,MAAO,KAAK,IAAI,GAAIC,CAAC,CAAC,CACxC,CAEA,SAASC,EAAaC,EAAgC,CACpD,KAAM,CAAE,gBAAAC,GAAoBD,EAC5B,OAAOC,EAAgB,OAAS,EAAIA,EAAgBA,EAAgB,OAAS,CAAC,EAAKD,EAAM,MAC3F,CAMA,SAASE,EAAaF,EAA2B,CAC/C,KAAM,CAAE,OAAAG,EAAQ,gBAAAF,EAAiB,UAAAG,EAAW,QAAAC,GAAYL,EAGxD,GAAI,CACFG,EAAO,WAAA,CACT,MAAQ,CAER,CAGA,UAAWG,KAAQL,EACjB,GAAI,CACFK,EAAK,WAAA,CACP,MAAQ,CAER,CAIF,SAAW,CAAE,SAAAC,CAAA,IAAcH,EAAU,SACnC,GAAI,CACFG,EAAS,WAAWF,EAAQ,WAAW,CACzC,MAAQ,CAER,CAIF,GAAIJ,EAAgB,OAAS,EAAG,CAC9BE,EAAO,QAAQF,EAAgB,CAAC,CAAE,EAClC,QAAS,EAAI,EAAG,EAAIA,EAAgB,OAAS,EAAG,IAC9CA,EAAgB,CAAC,EAAG,QAAQA,EAAgB,EAAI,CAAC,CAAE,CAEvD,CAEA,MAAMO,EAAOT,EAAaC,CAAK,EAE/B,GAAII,EAAU,OAAS,EAErBI,EAAK,QAAQH,EAAQ,WAAW,MAC3B,CAEL,IAAII,EAAU,GACd,SAAW,CAAE,SAAAF,CAAA,IAAcH,EAAU,SACnCI,EAAK,QAAQD,CAAQ,EACjBE,IACFF,EAAS,QAAQF,EAAQ,WAAW,EACpCI,EAAU,GAGhB,CACF,CAEA,SAASC,EAAiBC,EAAyC,CACjE,IAAIX,EAAQL,EAAQ,IAAIgB,CAAO,EAC/B,GAAI,CAACX,EAAO,CACV,MAAMY,EACJ,OAAO,cACN,OAAmE,mBACtE,GAAI,CAACA,EACH,MAAM,IAAI,MAAM,gCAAgC,EAElD,MAAMP,EAAU,IAAIO,EACdT,EAASE,EAAQ,yBAAyBM,CAAO,EACvDX,EAAQ,CACN,QAAAK,EACA,OAAAF,EACA,cAAe,IACf,OAAQ,EACR,gBAAiB,CAAA,EACjB,iBAAkB,EAAA,EAEpBR,EAAQ,IAAIgB,EAASX,CAAK,CAC5B,CACA,OAAOA,CACT,CAEA,SAASa,EAAgBF,EAA2BX,EAA2B,CAC7E,GAAIA,EAAM,UAAU,OAAS,GAAK,CAACA,EAAM,iBAAkB,CACzD,GAAI,CACFA,EAAM,OAAO,WAAA,CACf,MAAQ,CAER,CACKA,EAAM,QAAQ,MAAA,EACnBL,EAAQ,OAAOgB,CAAO,CACxB,CACF,CAEO,SAASG,EACdH,EACAI,EAC+D,CAC/D,MAAMf,EAAQU,EAAiBC,CAAO,EAChC,CAAE,QAAAN,GAAYL,EAEdO,EAAWF,EAAQ,eAAA,EACzBE,EAAS,QAAUX,EAAamB,EAAQ,OAAO,EAC/CR,EAAS,sBAAwBQ,EAAQ,sBACzCR,EAAS,YAAcQ,EAAQ,YAC/BR,EAAS,YAAcQ,EAAQ,YAE/B,MAAMC,EAAKhB,EAAM,OACjB,OAAAA,EAAM,QAAU,EAChBA,EAAM,UAAU,IAAIgB,EAAI,CAAE,SAAAT,EAAU,EAEpCL,EAAaF,CAAK,EAEX,CAAE,GAAAgB,EAAI,QAAAX,EAAS,SAAAE,CAAA,CACxB,CAEO,SAASU,EAAmBN,EAA2BK,EAAkB,CAC9E,MAAMhB,EAAQL,EAAQ,IAAIgB,CAAO,EACjC,GAAI,CAACX,EAAO,OAEZ,MAAMkB,EAAWlB,EAAM,UAAU,IAAIgB,CAAE,EACvC,GAAKE,EAEL,IAAI,CACFA,EAAS,SAAS,WAAA,CACpB,MAAQ,CAER,CAGA,GAFAlB,EAAM,UAAU,OAAOgB,CAAE,EAErBhB,EAAM,UAAU,OAAS,GAAK,CAACA,EAAM,iBAAkB,CACzDa,EAAgBF,EAASX,CAAK,EAC9B,MACF,CAEAE,EAAaF,CAAK,EACpB,CAUO,SAASmB,EAAmBR,EAA2BS,EAA0B,CACtF,GAAI,OAAO,OAAW,IAAa,OAEnC,GAAIA,EAAM,SAAW,EAAG,CACtB,MAAMpB,EAAQL,EAAQ,IAAIgB,CAAO,EACjC,GAAI,CAACX,EAAO,OACZA,EAAM,gBAAkB,CAAA,EACxBA,EAAM,iBAAmB,GACrBA,EAAM,UAAU,OAAS,EAC3Ba,EAAgBF,EAASX,CAAK,EAE9BE,EAAaF,CAAK,EAEpB,MACF,CAEA,MAAMA,EAAQU,EAAiBC,CAAO,EACtCX,EAAM,gBAAkBoB,EACxBpB,EAAM,iBAAmB,GACzBE,EAAaF,CAAK,CACpB"}