@lucaismyname/ginger 0.0.13 → 0.0.15

package/README.md

@@ -337,7 +337,7 @@ Props:
 | `initialPlaylistMeta` | `PlaylistMeta \| null` | `null` | Queue/playlist metadata |
 | `initialShuffle` | `boolean` | `false` | Start shuffled |
 | `initialRepeatMode` | `"off" \| "all" \| "one"` | `"off"` | Initial repeat mode |
-| `initialPlaybackMode` | `"playlist" \| "single"` | `"playlist"` | Playlist wraps/advances vs single-track stop behavior |
+| `initialPlaybackMode` | `"playlist" \| "single"` | `"playlist"` | Playlist wraps/advances vs single-track stop behavior (change after mount with `useGinger().setPlaybackMode`) |
 | `initialPaused` | `boolean` | `true` | Start paused or playing |
 | `initialVolume` | `number` | `1` | Initial volume, clamped `0..1` |
 | `initialMuted` | `boolean` | `false` | Initial muted state |
@@ -427,6 +427,7 @@ Returned values:
 | `insertTrackAt`, `removeTrackAt`, `moveTrack`, `enqueueNext` | Queue mutation actions |
 | `playTrackAt`, `selectTrackAt` | Pick a track by index |
 | `setPlaylistMeta` | Replace playlist metadata |
+| `setPlaybackMode` | `"playlist"` or `"single"` (next/prev/end behavior and repeat-one) |
 | `audioRef` | Ref to the underlying `HTMLAudioElement` |
 | `dispatch` | Raw reducer dispatch for advanced cases |
 
@@ -695,8 +696,85 @@ 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) and whole-file grids for waveforms or spectrograms (**`useAudioFileAnalysis`** / **`analyzeAudioFile`**, `@lucaismyname/ginger/waveform`). See [Audio analyzers (visualizations)](#audio-analyzers-visualizations).
+
 Recipes below cover queue lifecycle and media edge cases.
 
+## Audio analyzers (visualizations)
+
+Ginger separates **live** analysis (while the native `<audio>` element plays) from **whole-file** analysis (decode once, build static or seek-independent grids).
+
+### Live: `useGingerLiveAnalyzer`
+
+Import from the main package:
+
+```tsx
+import { Ginger, useGingerLiveAnalyzer } from "@lucaismyname/ginger";
+
+function Spectrum() {
+  const { frequencyData, frequencyBinCount, error, resume, isSuspended } = useGingerLiveAnalyzer({
+    fftSize: 2048,
+  });
+
+  if (error) return <p role="alert">{error}</p>;
+  if (isSuspended) {
+    return (
+      <button type="button" onClick={() => void resume()}>
+        Enable audio analysis
+      </button>
+    );
+  }
+
+  return (
+    <div>
+      {/* e.g. map frequencyData[0..frequencyBinCount) to bar heights */}
+      <span>{frequencyBinCount} bins</span>
+    </div>
+  );
+}
+
+// Mount <Ginger.Player crossOrigin="anonymous" /> when fileUrl is cross-origin so Web Audio can use the element.
+```
+
+Important:
+
+- **CORS** — For cross-origin `fileUrl` values, set **`crossOrigin`** on **`Ginger.Player`** (for example `"anonymous"`) so the media element is usable with **`AudioContext`**.
+- **One `MediaElementAudioSourceNode` per `<audio>`** — The library reuses a single Web Audio graph per underlying element. Multiple instances of **`useGingerLiveAnalyzer`** attach extra **`AnalyserNode`**s as taps; only one tap carries audio to **`destination`** so volume stays correct.
+- **Autoplay** — The **`AudioContext`** may start **`suspended`** until a user gesture; call **`resume()`** or start playback after interaction.
+- **Reading buffers** — `frequencyData` and `timeDomainData` are updated each animation frame while enabled; read them during render after **`frequencyBinCount > 0`** (they are backed by mutable buffers that the hook fills in a `requestAnimationFrame` loop).
+
+### Whole file: `@lucaismyname/ginger/waveform`
+
+Use **`useAudioFileAnalysis`** (React hook) or **`analyzeAudioFile`** / **`analyzeAudioBuffer`** (imperative) for amplitude grids and optional spectrogram rows without playing the track.
+
+```tsx
+import { useAudioFileAnalysis } from "@lucaismyname/ginger/waveform";
+
+function FileViz({ url }: { url: string }) {
+  const { data, isLoading, error } = useAudioFileAnalysis(url, {
+    timeSlices: 128,
+    samplesPerSlice: 8,
+    spectrogram: true,
+    fftSize: 1024,
+    frequencyBins: 256,
+  });
+
+  if (isLoading) return <p>Loading analysis…</p>;
+  if (error) return <p role="alert">{error}</p>;
+  if (!data) return null;
+
+  return (
+    <div>
+      <p>Duration: {data.duration}s</p>
+      {/* data.amplitudeGrid: number[][] */}
+      {/* data.spectrogram?: number[][] normalized to [0, 1] */}
+    </div>
+  );
+}
+```
+
+**`useAudioPeaks`** (same subpath) remains a lightweight helper: a single row of decoded amplitude peaks. Prefer **`useAudioFileAnalysis`** when you need a 2D amplitude grid or spectrogram.
+
 ## Recipes
 
 ### Updating the queue after mount
@@ -800,7 +878,7 @@ This allows persisted volume/rate/repeat/index and optional per-track resume pos
 - `moveTrack(fromIndex, toIndex)`
 - `enqueueNext(track)`
 
-Provider supports `initialPlaybackMode?: "playlist" | "single"` (`"playlist"` default).
+Provider supports `initialPlaybackMode?: "playlist" | "single"` (`"playlist"` default). Use `setPlaybackMode("playlist" | "single")` from `useGinger()` or `useGingerPlayback()` to change mode without a full `init()`.
 
 ### Reduced motion and blocked-play policy
 

package/dist/{GingerSplitContexts-4YZ-OJ9V.js → GingerSplitContexts-BzBExb95.js}

@@ -1,5 +1,5 @@
-import { useContext as n, useMemo as o, createContext as r } from "react";
-const i = r(null), u = r(null);
+import { useContext as n, useMemo as o, createContext as s } from "react";
+const i = s(null), u = s(null);
 function c() {
   const e = n(i);
   if (!e) throw new Error("Ginger hooks must be used within <Ginger.Provider>");
@@ -10,11 +10,11 @@ function _() {
   if (!e) throw new Error("Ginger hooks must be used within <Ginger.Provider>");
   return e;
 }
-function z() {
+function B() {
   const e = c(), t = _();
   return o(() => l(e, t), [e, t]);
 }
-function B(e, t) {
+function D(e, t) {
   return { ...e, ...t };
 }
 function l(e, t) {
@@ -27,37 +27,38 @@ function l(e, t) {
     prev: f,
     setRepeatMode: x,
     cycleRepeat: y,
-    toggleShuffle: G,
-    setQueue: h,
-    insertTrackAt: b,
+    toggleShuffle: b,
+    setQueue: G,
+    insertTrackAt: h,
     removeTrackAt: P,
     moveTrack: M,
     enqueueNext: v,
     playTrackAt: w,
     selectTrackAt: C,
     setPlaylistMeta: R,
-    dispatch: T,
-    ...s
+    setPlaybackMode: T,
+    dispatch: A,
+    ...r
   } = e, {
-    seek: A,
-    setVolume: S,
-    setMuted: E,
-    toggleMute: q,
-    setPlaybackRate: F,
-    audioRef: V,
-    notifyEnded: N,
-    dispatch: Q,
+    seek: S,
+    setVolume: E,
+    setMuted: q,
+    toggleMute: F,
+    setPlaybackRate: V,
+    audioRef: N,
+    notifyEnded: Q,
+    dispatch: j,
     ...a
   } = t;
-  return { ...s, ...a };
+  return { ...r, ...a };
 }
 export {
   i as G,
-  B as a,
+  D as a,
   c as b,
-  z as c,
+  B as c,
   u as d,
   l as g,
   _ as u
 };
-//# sourceMappingURL=GingerSplitContexts-4YZ-OJ9V.js.map
+//# sourceMappingURL=GingerSplitContexts-BzBExb95.js.map

package/dist/GingerSplitContexts-BzBExb95.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GingerSplitContexts-BzBExb95.js","sources":["../src/context/GingerSplitContexts.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type Dispatch, type MutableRefObject } from \"react\";\nimport type {\n  GingerAction,\n  GingerInitPayload,\n  GingerMediaSlice,\n  GingerPlaybackSlice,\n  GingerState,\n  PlaybackMode,\n  PlaylistMeta,\n  RepeatMode,\n  Track,\n} from \"../types\";\n\nexport type GingerPlaybackActions = {\n  init: (payload: GingerInitPayload) => void;\n  play: () => void;\n  pause: () => void;\n  togglePlayPause: () => void;\n  next: () => void;\n  prev: () => void;\n  setRepeatMode: (mode: RepeatMode) => void;\n  cycleRepeat: () => void;\n  toggleShuffle: () => void;\n  setQueue: (tracks: Track[], currentIndex?: number) => void;\n  insertTrackAt: (track: Track, index?: number, autoPlay?: boolean) => void;\n  removeTrackAt: (index: number) => void;\n  moveTrack: (fromIndex: number, toIndex: number) => void;\n  enqueueNext: (track: Track) => void;\n  playTrackAt: (index: number) => void;\n  selectTrackAt: (index: number) => void;\n  setPlaylistMeta: (meta: PlaylistMeta | null) => void;\n  setPlaybackMode: (mode: PlaybackMode) => void;\n  dispatch: Dispatch<GingerAction>;\n};\n\nexport type GingerPlaybackContextValue = GingerPlaybackSlice & GingerPlaybackActions;\n\nexport type GingerMediaActions = {\n  seek: (timeSeconds: number) => void;\n  setVolume: (volume: number) => void;\n  setMuted: (muted: boolean) => void;\n  toggleMute: () => void;\n  setPlaybackRate: (rate: number) => void;\n  audioRef: MutableRefObject<HTMLAudioElement | null>;\n  notifyEnded: () => void;\n  dispatch: Dispatch<GingerAction>;\n};\n\nexport type GingerMediaContextValue = GingerMediaSlice & GingerMediaActions;\n\nconst GingerPlaybackContext = createContext<GingerPlaybackContextValue | null>(null);\nconst GingerMediaContext = createContext<GingerMediaContextValue | null>(null);\n\nexport function useGingerPlayback(): GingerPlaybackContextValue {\n  const ctx = useContext(GingerPlaybackContext);\n  if (!ctx) throw new Error(\"Ginger hooks must be used within <Ginger.Provider>\");\n  return ctx;\n}\n\nexport function useGingerMedia(): GingerMediaContextValue {\n  const ctx = useContext(GingerMediaContext);\n  if (!ctx) throw new Error(\"Ginger hooks must be used within <Ginger.Provider>\");\n  return ctx;\n}\n\n/** Full merged state; prefer over `useGingerContext().state` so updates follow playback vs media splits. */\nexport function useGingerState(): GingerState {\n  const pb = useGingerPlayback();\n  const md = useGingerMedia();\n  return useMemo(() => gingerStateFromContextValues(pb, md), [pb, md]);\n}\n\n/** Merge playback + media slices (for selectors and `useGinger`). */\nexport function gingerStateFromContexts(\n  playback: GingerPlaybackSlice,\n  media: GingerMediaSlice,\n): GingerState {\n  return { ...playback, ...media };\n}\n\n/** Merge full context values into `GingerState` (strips action fields). */\nexport function gingerStateFromContextValues(\n  pb: GingerPlaybackContextValue,\n  md: GingerMediaContextValue,\n): GingerState {\n  const {\n    init: _i,\n    play: _p,\n    pause: _pa,\n    togglePlayPause: _t,\n    next: _n,\n    prev: _pr,\n    setRepeatMode: _sr,\n    cycleRepeat: _cr,\n    toggleShuffle: _ts,\n    setQueue: _sq,\n    insertTrackAt: _ita,\n    removeTrackAt: _rta,\n    moveTrack: _mt,\n    enqueueNext: _en,\n    playTrackAt: _pta,\n    selectTrackAt: _sta,\n    setPlaylistMeta: _spm,\n    setPlaybackMode: _spbm,\n    dispatch: _d1,\n    ...playbackRest\n  } = pb;\n  const {\n    seek: _sk,\n    setVolume: _sv,\n    setMuted: _sm,\n    toggleMute: _tm,\n    setPlaybackRate: _spr,\n    audioRef: _ar,\n    notifyEnded: _ne,\n    dispatch: _d2,\n    ...mediaRest\n  } = md;\n  return { ...playbackRest, ...mediaRest };\n}\n\nexport { GingerPlaybackContext, GingerMediaContext };\n"],"names":["GingerPlaybackContext","createContext","GingerMediaContext","useGingerPlayback","ctx","useContext","useGingerMedia","useGingerState","pb","md","useMemo","gingerStateFromContextValues","gingerStateFromContexts","playback","media","_i","_p","_pa","_t","_n","_pr","_sr","_cr","_ts","_sq","_ita","_rta","_mt","_en","_pta","_sta","_spm","_spbm","_d1","playbackRest","_sk","_sv","_sm","_tm","_spr","_ar","_ne","_d2","mediaRest"],"mappings":";AAkDA,MAAMA,IAAwBC,EAAiD,IAAI,GAC7EC,IAAqBD,EAA8C,IAAI;AAEtE,SAASE,IAAgD;AAC9D,QAAMC,IAAMC,EAAWL,CAAqB;AAC5C,MAAI,CAACI,EAAK,OAAM,IAAI,MAAM,oDAAoD;AAC9E,SAAOA;AACT;AAEO,SAASE,IAA0C;AACxD,QAAMF,IAAMC,EAAWH,CAAkB;AACzC,MAAI,CAACE,EAAK,OAAM,IAAI,MAAM,oDAAoD;AAC9E,SAAOA;AACT;AAGO,SAASG,IAA8B;AAC5C,QAAMC,IAAKL,EAAA,GACLM,IAAKH,EAAA;AACX,SAAOI,EAAQ,MAAMC,EAA6BH,GAAIC,CAAE,GAAG,CAACD,GAAIC,CAAE,CAAC;AACrE;AAGO,SAASG,EACdC,GACAC,GACa;AACb,SAAO,EAAE,GAAGD,GAAU,GAAGC,EAAA;AAC3B;AAGO,SAASH,EACdH,GACAC,GACa;AACb,QAAM;AAAA,IACJ,MAAMM;AAAA,IACN,MAAMC;AAAA,IACN,OAAOC;AAAA,IACP,iBAAiBC;AAAA,IACjB,MAAMC;AAAA,IACN,MAAMC;AAAA,IACN,eAAeC;AAAA,IACf,aAAaC;AAAA,IACb,eAAeC;AAAA,IACf,UAAUC;AAAA,IACV,eAAeC;AAAA,IACf,eAAeC;AAAA,IACf,WAAWC;AAAA,IACX,aAAaC;AAAA,IACb,aAAaC;AAAA,IACb,eAAeC;AAAA,IACf,iBAAiBC;AAAA,IACjB,iBAAiBC;AAAA,IACjB,UAAUC;AAAA,IACV,GAAGC;AAAA,EAAA,IACD1B,GACE;AAAA,IACJ,MAAM2B;AAAA,IACN,WAAWC;AAAA,IACX,UAAUC;AAAA,IACV,YAAYC;AAAA,IACZ,iBAAiBC;AAAA,IACjB,UAAUC;AAAA,IACV,aAAaC;AAAA,IACb,UAAUC;AAAA,IACV,GAAGC;AAAA,EAAA,IACDlC;AACJ,SAAO,EAAE,GAAGyB,GAAc,GAAGS,EAAA;AAC/B;"}

package/dist/GingerSplitContexts-C7puo0M7.cjs

@@ -0,0 +1,2 @@
+"use strict";const n=require("react"),r=n.createContext(null),s=n.createContext(null);function a(){const e=n.useContext(r);if(!e)throw new Error("Ginger hooks must be used within <Ginger.Provider>");return e}function o(){const e=n.useContext(s);if(!e)throw new Error("Ginger hooks must be used within <Ginger.Provider>");return e}function g(){const e=a(),t=o();return n.useMemo(()=>i(e,t),[e,t])}function _(e,t){return{...e,...t}}function i(e,t){const{init:l,play:d,pause:m,togglePlayPause:p,next:k,prev:x,setRepeatMode:G,cycleRepeat:y,toggleShuffle:C,setQueue:b,insertTrackAt:f,removeTrackAt:P,moveTrack:M,enqueueNext:h,playTrackAt:R,selectTrackAt:S,setPlaylistMeta:v,setPlaybackMode:w,dispatch:T,...u}=e,{seek:A,setVolume:F,setMuted:q,toggleMute:E,setPlaybackRate:V,audioRef:N,notifyEnded:Q,dispatch:j,...c}=t;return{...u,...c}}exports.GingerMediaContext=s;exports.GingerPlaybackContext=r;exports.gingerStateFromContextValues=i;exports.gingerStateFromContexts=_;exports.useGingerMedia=o;exports.useGingerPlayback=a;exports.useGingerState=g;
+//# sourceMappingURL=GingerSplitContexts-C7puo0M7.cjs.map

package/dist/GingerSplitContexts-C7puo0M7.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GingerSplitContexts-C7puo0M7.cjs","sources":["../src/context/GingerSplitContexts.tsx"],"sourcesContent":["import { createContext, useContext, useMemo, type Dispatch, type MutableRefObject } from \"react\";\nimport type {\n  GingerAction,\n  GingerInitPayload,\n  GingerMediaSlice,\n  GingerPlaybackSlice,\n  GingerState,\n  PlaybackMode,\n  PlaylistMeta,\n  RepeatMode,\n  Track,\n} from \"../types\";\n\nexport type GingerPlaybackActions = {\n  init: (payload: GingerInitPayload) => void;\n  play: () => void;\n  pause: () => void;\n  togglePlayPause: () => void;\n  next: () => void;\n  prev: () => void;\n  setRepeatMode: (mode: RepeatMode) => void;\n  cycleRepeat: () => void;\n  toggleShuffle: () => void;\n  setQueue: (tracks: Track[], currentIndex?: number) => void;\n  insertTrackAt: (track: Track, index?: number, autoPlay?: boolean) => void;\n  removeTrackAt: (index: number) => void;\n  moveTrack: (fromIndex: number, toIndex: number) => void;\n  enqueueNext: (track: Track) => void;\n  playTrackAt: (index: number) => void;\n  selectTrackAt: (index: number) => void;\n  setPlaylistMeta: (meta: PlaylistMeta | null) => void;\n  setPlaybackMode: (mode: PlaybackMode) => void;\n  dispatch: Dispatch<GingerAction>;\n};\n\nexport type GingerPlaybackContextValue = GingerPlaybackSlice & GingerPlaybackActions;\n\nexport type GingerMediaActions = {\n  seek: (timeSeconds: number) => void;\n  setVolume: (volume: number) => void;\n  setMuted: (muted: boolean) => void;\n  toggleMute: () => void;\n  setPlaybackRate: (rate: number) => void;\n  audioRef: MutableRefObject<HTMLAudioElement | null>;\n  notifyEnded: () => void;\n  dispatch: Dispatch<GingerAction>;\n};\n\nexport type GingerMediaContextValue = GingerMediaSlice & GingerMediaActions;\n\nconst GingerPlaybackContext = createContext<GingerPlaybackContextValue | null>(null);\nconst GingerMediaContext = createContext<GingerMediaContextValue | null>(null);\n\nexport function useGingerPlayback(): GingerPlaybackContextValue {\n  const ctx = useContext(GingerPlaybackContext);\n  if (!ctx) throw new Error(\"Ginger hooks must be used within <Ginger.Provider>\");\n  return ctx;\n}\n\nexport function useGingerMedia(): GingerMediaContextValue {\n  const ctx = useContext(GingerMediaContext);\n  if (!ctx) throw new Error(\"Ginger hooks must be used within <Ginger.Provider>\");\n  return ctx;\n}\n\n/** Full merged state; prefer over `useGingerContext().state` so updates follow playback vs media splits. */\nexport function useGingerState(): GingerState {\n  const pb = useGingerPlayback();\n  const md = useGingerMedia();\n  return useMemo(() => gingerStateFromContextValues(pb, md), [pb, md]);\n}\n\n/** Merge playback + media slices (for selectors and `useGinger`). */\nexport function gingerStateFromContexts(\n  playback: GingerPlaybackSlice,\n  media: GingerMediaSlice,\n): GingerState {\n  return { ...playback, ...media };\n}\n\n/** Merge full context values into `GingerState` (strips action fields). */\nexport function gingerStateFromContextValues(\n  pb: GingerPlaybackContextValue,\n  md: GingerMediaContextValue,\n): GingerState {\n  const {\n    init: _i,\n    play: _p,\n    pause: _pa,\n    togglePlayPause: _t,\n    next: _n,\n    prev: _pr,\n    setRepeatMode: _sr,\n    cycleRepeat: _cr,\n    toggleShuffle: _ts,\n    setQueue: _sq,\n    insertTrackAt: _ita,\n    removeTrackAt: _rta,\n    moveTrack: _mt,\n    enqueueNext: _en,\n    playTrackAt: _pta,\n    selectTrackAt: _sta,\n    setPlaylistMeta: _spm,\n    setPlaybackMode: _spbm,\n    dispatch: _d1,\n    ...playbackRest\n  } = pb;\n  const {\n    seek: _sk,\n    setVolume: _sv,\n    setMuted: _sm,\n    toggleMute: _tm,\n    setPlaybackRate: _spr,\n    audioRef: _ar,\n    notifyEnded: _ne,\n    dispatch: _d2,\n    ...mediaRest\n  } = md;\n  return { ...playbackRest, ...mediaRest };\n}\n\nexport { GingerPlaybackContext, GingerMediaContext };\n"],"names":["GingerPlaybackContext","createContext","GingerMediaContext","useGingerPlayback","ctx","useContext","useGingerMedia","useGingerState","pb","md","useMemo","gingerStateFromContextValues","gingerStateFromContexts","playback","media","_i","_p","_pa","_t","_n","_pr","_sr","_cr","_ts","_sq","_ita","_rta","_mt","_en","_pta","_sta","_spm","_spbm","_d1","playbackRest","_sk","_sv","_sm","_tm","_spr","_ar","_ne","_d2","mediaRest"],"mappings":"sCAkDMA,EAAwBC,EAAAA,cAAiD,IAAI,EAC7EC,EAAqBD,EAAAA,cAA8C,IAAI,EAEtE,SAASE,GAAgD,CAC9D,MAAMC,EAAMC,EAAAA,WAAWL,CAAqB,EAC5C,GAAI,CAACI,EAAK,MAAM,IAAI,MAAM,oDAAoD,EAC9E,OAAOA,CACT,CAEO,SAASE,GAA0C,CACxD,MAAMF,EAAMC,EAAAA,WAAWH,CAAkB,EACzC,GAAI,CAACE,EAAK,MAAM,IAAI,MAAM,oDAAoD,EAC9E,OAAOA,CACT,CAGO,SAASG,GAA8B,CAC5C,MAAMC,EAAKL,EAAA,EACLM,EAAKH,EAAA,EACX,OAAOI,EAAAA,QAAQ,IAAMC,EAA6BH,EAAIC,CAAE,EAAG,CAACD,EAAIC,CAAE,CAAC,CACrE,CAGO,SAASG,EACdC,EACAC,EACa,CACb,MAAO,CAAE,GAAGD,EAAU,GAAGC,CAAA,CAC3B,CAGO,SAASH,EACdH,EACAC,EACa,CACb,KAAM,CACJ,KAAMM,EACN,KAAMC,EACN,MAAOC,EACP,gBAAiBC,EACjB,KAAMC,EACN,KAAMC,EACN,cAAeC,EACf,YAAaC,EACb,cAAeC,EACf,SAAUC,EACV,cAAeC,EACf,cAAeC,EACf,UAAWC,EACX,YAAaC,EACb,YAAaC,EACb,cAAeC,EACf,gBAAiBC,EACjB,gBAAiBC,EACjB,SAAUC,EACV,GAAGC,CAAA,EACD1B,EACE,CACJ,KAAM2B,EACN,UAAWC,EACX,SAAUC,EACV,WAAYC,EACZ,gBAAiBC,EACjB,SAAUC,EACV,YAAaC,EACb,SAAUC,EACV,GAAGC,CAAA,EACDlC,EACJ,MAAO,CAAE,GAAGyB,EAAc,GAAGS,CAAA,CAC/B"}

package/dist/analyzer/liveAudioGraph.d.ts

@@ -0,0 +1,14 @@
+/** One MediaElementAudioSourceNode per HTMLAudioElement; multiple AnalyserNodes may tap the source. */
+export type LiveAnalyserOptions = {
+    fftSize: number;
+    smoothingTimeConstant: number;
+    minDecibels: number;
+    maxDecibels: number;
+};
+export declare function attachLiveAnalyser(element: HTMLAudioElement, options: LiveAnalyserOptions): {
+    id: number;
+    context: AudioContext;
+    analyser: AnalyserNode;
+};
+export declare function detachLiveAnalyser(element: HTMLAudioElement, id: number): void;
+//# sourceMappingURL=liveAudioGraph.d.ts.map

package/dist/analyzer/liveAudioGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveAudioGraph.d.ts","sourceRoot":"","sources":["../../src/analyzer/liveAudioGraph.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAsBF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,mBAAmB,GAC3B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAgC/D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CA6B9E"}

package/dist/analyzer/useGingerLiveAnalyzer.d.ts

@@ -0,0 +1,21 @@
+export type UseGingerLiveAnalyzerOptions = {
+    /** When false, the analyser is detached and no frames are read. Default true. */
+    enabled?: boolean;
+    fftSize?: number;
+    smoothingTimeConstant?: number;
+    minDecibels?: number;
+    maxDecibels?: number;
+};
+export type UseGingerLiveAnalyzerResult = {
+    /** Byte frequency data (0–255); length equals `frequencyBinCount`. Updated each animation frame while enabled. */
+    frequencyData: Uint8Array;
+    /** Byte time-domain data (0–255); length equals `fftSize`. */
+    timeDomainData: Uint8Array;
+    frequencyBinCount: number;
+    sampleRate: number;
+    isSuspended: boolean;
+    error: string | null;
+    resume: () => Promise<void>;
+};
+export declare function useGingerLiveAnalyzer(options?: UseGingerLiveAnalyzerOptions): UseGingerLiveAnalyzerResult;
+//# sourceMappingURL=useGingerLiveAnalyzer.d.ts.map

package/dist/analyzer/useGingerLiveAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGingerLiveAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/useGingerLiveAnalyzer.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,4BAA4B,GAAG;IACzC,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,kHAAkH;IAClH,aAAa,EAAE,UAAU,CAAC;IAC1B,8DAA8D;IAC9D,cAAc,EAAE,UAAU,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC;AAKF,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,2BAA2B,CAkK7G"}

package/dist/audio/GingerPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GingerPlayer.d.ts","sourceRoot":"","sources":["../../src/audio/GingerPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,WAAW,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAQF,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,OAAoB,EACpB,WAAW,EACX,oBAA4B,GAC7B,EAAE,iBAAiB,2CAsHnB"}
+{"version":3,"file":"GingerPlayer.d.ts","sourceRoot":"","sources":["../../src/audio/GingerPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,WAAW,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAQF,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,OAAoB,EACpB,WAAW,EACX,oBAA4B,GAC7B,EAAE,iBAAiB,2CA6HnB"}

package/dist/audio/GingerPlayer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GingerPlayer.test.d.ts.map

package/dist/audio/GingerPlayer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GingerPlayer.test.d.ts","sourceRoot":"","sources":["../../src/audio/GingerPlayer.test.tsx"],"names":[],"mappings":""}

package/dist/client.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-DYoHDn8T.cjs"),r=require("./useSeekDrag-DBzoym0-.cjs"),i=require("./GingerSplitContexts-Bze1Bqe2.cjs");exports.Ginger=e.Ginger;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.derivePlaybackUiState=e.derivePlaybackUiState;exports.useGingerLocale=e.useGingerLocale;exports.usePlayPauseBinding=e.usePlayPauseBinding;exports.useSeekBarBinding=e.useSeekBarBinding;exports.useVolumeSlider=e.useVolumeSlider;exports.parseLrc=r.parseLrc;exports.useGinger=r.useGinger;exports.useGingerChapters=r.useGingerChapters;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLyricsSync=r.useGingerLyricsSync;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useSeekDrag=r.useSeekDrag;exports.gingerStateFromContextValues=i.gingerStateFromContextValues;exports.gingerStateFromContexts=i.gingerStateFromContexts;exports.useGingerMedia=i.useGingerMedia;exports.useGingerPlayback=i.useGingerPlayback;exports.useGingerState=i.useGingerState;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ginger-BiI69vrn.cjs"),e=require("./useSeekDrag-aS7uk26h.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Ginger=r.Ginger;exports.clampPlaybackRate=r.clampPlaybackRate;exports.clampVolume=r.clampVolume;exports.defaultGingerLocale=r.defaultGingerLocale;exports.derivePlaybackUiState=r.derivePlaybackUiState;exports.useGingerLocale=r.useGingerLocale;exports.usePlayPauseBinding=r.usePlayPauseBinding;exports.useSeekBarBinding=r.useSeekBarBinding;exports.useVolumeSlider=r.useVolumeSlider;exports.attachLiveAnalyser=e.attachLiveAnalyser;exports.detachLiveAnalyser=e.detachLiveAnalyser;exports.parseLrc=e.parseLrc;exports.useGinger=e.useGinger;exports.useGingerChapters=e.useGingerChapters;exports.useGingerDebugLog=e.useGingerDebugLog;exports.useGingerKeyboardShortcuts=e.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=e.useGingerLiveAnalyzer;exports.useGingerLyricsSync=e.useGingerLyricsSync;exports.useGingerSleepTimer=e.useGingerSleepTimer;exports.useSeekDrag=e.useSeekDrag;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,28 +1,31 @@
-import { G as s, c as r, a as i, d as u, b as g, u as n, e as t, f as o, g as c } from "./ginger-Dntdd6zH.js";
-import { p as G, u as m, a as S, b as d, c as p, d as b, e as y, f } from "./useSeekDrag-jLsYA-uG.js";
-import { g as x, a as L, u as P, b as B, c as C } from "./GingerSplitContexts-4YZ-OJ9V.js";
+import { G as s, c as r, a as i, d as g, b as n, u, e as t, f as l, g as o } from "./ginger-BTPRqWHs.js";
+import { a as G, d, p as m, u as y, b as S, c as p, e as b, f as L, g as f, h, i as k } from "./useSeekDrag-Br1V0Vao.js";
+import { g as P, a as v, u as A, b as B, c as C } from "./GingerSplitContexts-BzBExb95.js";
 export {
   s as Ginger,
+  G as attachLiveAnalyser,
   r as clampPlaybackRate,
   i as clampVolume,
-  u as defaultGingerLocale,
-  g as derivePlaybackUiState,
-  x as gingerStateFromContextValues,
-  L as gingerStateFromContexts,
-  G as parseLrc,
-  m as useGinger,
+  g as defaultGingerLocale,
+  n as derivePlaybackUiState,
+  d as detachLiveAnalyser,
+  P as gingerStateFromContextValues,
+  v as gingerStateFromContexts,
+  m as parseLrc,
+  y as useGinger,
   S as useGingerChapters,
-  d as useGingerDebugLog,
-  p as useGingerKeyboardShortcuts,
-  n as useGingerLocale,
-  b as useGingerLyricsSync,
-  P as useGingerMedia,
+  p as useGingerDebugLog,
+  b as useGingerKeyboardShortcuts,
+  L as useGingerLiveAnalyzer,
+  u as useGingerLocale,
+  f as useGingerLyricsSync,
+  A as useGingerMedia,
   B as useGingerPlayback,
-  y as useGingerSleepTimer,
+  h as useGingerSleepTimer,
   C as useGingerState,
   t as usePlayPauseBinding,
-  o as useSeekBarBinding,
-  f as useSeekDrag,
-  c as useVolumeSlider
+  l as useSeekBarBinding,
+  k as useSeekDrag,
+  o as useVolumeSlider
 };
 //# sourceMappingURL=client.js.map

package/dist/context/GingerContext.d.ts

@@ -1,5 +1,5 @@
 import { Dispatch, MutableRefObject } from 'react';
-import { GingerAction, GingerInitPayload, GingerState, PlaylistMeta, RepeatMode, Track } from '../types';
+import { GingerAction, GingerInitPayload, GingerState, PlaybackMode, PlaylistMeta, RepeatMode, Track } from '../types';
 export type GingerContextValue = {
     state: GingerState;
     dispatch: Dispatch<GingerAction>;
@@ -28,6 +28,7 @@ export type GingerContextValue = {
     playTrackAt: (index: number) => void;
     selectTrackAt: (index: number) => void;
     setPlaylistMeta: (meta: PlaylistMeta | null) => void;
+    setPlaybackMode: (mode: PlaybackMode) => void;
 };
 declare const GingerContext: import('react').Context<GingerContextValue | null>;
 export declare function useGingerContext(): GingerContextValue;

package/dist/context/GingerContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GingerContext.d.ts","sourceRoot":"","sources":["../../src/context/GingerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAE9G,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,QAAQ,EAAE,gBAAgB,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,4EAA4E;IAC5E,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,aAAa,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1E,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,QAAA,MAAM,aAAa,oDAAiD,CAAC;AAErE,wBAAgB,gBAAgB,IAAI,kBAAkB,CAIrD;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"GingerContext.d.ts","sourceRoot":"","sources":["../../src/context/GingerContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACxF,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACN,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjC,QAAQ,EAAE,gBAAgB,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,4EAA4E;IAC5E,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,aAAa,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1E,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEF,QAAA,MAAM,aAAa,oDAAiD,CAAC;AAErE,wBAAgB,gBAAgB,IAAI,kBAAkB,CAIrD;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/context/GingerProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GingerProvider.d.ts","sourceRoot":"","sources":["../../src/context/GingerProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAqB,mBAAmB,EAAmC,MAAM,UAAU,CAAC;AAmBxG,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,aAAkB,EAClB,YAAgB,EAChB,mBAA0B,EAC1B,cAAsB,EACtB,iBAAyB,EACzB,mBAAgC,EAChC,aAAoB,EACpB,aAAiB,EACjB,YAAoB,EACpB,mBAAuB,EACvB,eAAe,EACf,MAAM,EACN,YAAoB,EACpB,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAsB,EACtB,mBAA2B,EAC3B,QAAgB,EAChB,SAAS,EACT,KAAK,EACL,aAAa,EACb,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,EAAE,mBAAmB,2CAufrB"}
+{"version":3,"file":"GingerProvider.d.ts","sourceRoot":"","sources":["../../src/context/GingerProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,mBAAmB,EAKpB,MAAM,UAAU,CAAC;AAmBlB,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,aAAkB,EAClB,YAAgB,EAChB,mBAA0B,EAC1B,cAAsB,EACtB,iBAAyB,EACzB,mBAAgC,EAChC,aAAoB,EACpB,aAAiB,EACjB,YAAoB,EACpB,mBAAuB,EACvB,eAAe,EACf,MAAM,EACN,YAAoB,EACpB,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAsB,EACtB,mBAA2B,EAC3B,QAAgB,EAChB,SAAS,EACT,KAAK,EACL,aAAa,EACb,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,EAAE,mBAAmB,2CA+frB"}

package/dist/context/GingerSplitContexts.d.ts

@@ -1,5 +1,5 @@
 import { Dispatch, MutableRefObject } from 'react';
-import { GingerAction, GingerInitPayload, GingerMediaSlice, GingerPlaybackSlice, GingerState, PlaylistMeta, RepeatMode, Track } from '../types';
+import { GingerAction, GingerInitPayload, GingerMediaSlice, GingerPlaybackSlice, GingerState, PlaybackMode, PlaylistMeta, RepeatMode, Track } from '../types';
 export type GingerPlaybackActions = {
     init: (payload: GingerInitPayload) => void;
     play: () => void;
@@ -18,6 +18,7 @@ export type GingerPlaybackActions = {
     playTrackAt: (index: number) => void;
     selectTrackAt: (index: number) => void;
     setPlaylistMeta: (meta: PlaylistMeta | null) => void;
+    setPlaybackMode: (mode: PlaybackMode) => void;
     dispatch: Dispatch<GingerAction>;
 };
 export type GingerPlaybackContextValue = GingerPlaybackSlice & GingerPlaybackActions;

package/dist/context/GingerSplitContexts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GingerSplitContexts.d.ts","sourceRoot":"","sources":["../../src/context/GingerSplitContexts.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"GingerSplitContexts.d.ts","sourceRoot":"","sources":["../../src/context/GingerSplitContexts.tsx"],"names":[],"mappings":"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"}

package/dist/core/playbackReducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playbackReducer.d.ts","sourceRoot":"","sources":["../../src/core/playbackReducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAY7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnD;AAkBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,WAAW,CA0Bd;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAoOnF"}
+{"version":3,"file":"playbackReducer.d.ts","sourceRoot":"","sources":["../../src/core/playbackReducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAY7E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnD;AAkBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,WAAW,CA0Bd;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAwOnF"}

package/dist/core/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/core/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,CAU/E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKlG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAKpF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAKrE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAetF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAEzF"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/core/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,CAU/E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAyBlG;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAKpF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAKrE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAetF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,CAEzF"}

package/dist/experimental-gapless/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),t=require("../GingerSplitContexts-Bze1Bqe2.cjs");function a(){const{tracks:e}=t.useGingerPlayback();return s.useMemo(()=>({supported:!1,reason:"Gapless playback requires dedicated Web Audio graph orchestration.",preloadedTrackIds:e.map(r=>r.id??r.fileUrl)}),[e])}exports.useExperimentalGapless=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),t=require("../GingerSplitContexts-C7puo0M7.cjs");function a(){const{tracks:e}=t.useGingerPlayback();return s.useMemo(()=>({supported:!1,reason:"Gapless playback requires dedicated Web Audio graph orchestration.",preloadedTrackIds:e.map(r=>r.id??r.fileUrl)}),[e])}exports.useExperimentalGapless=a;
 //# sourceMappingURL=index.cjs.map

package/dist/experimental-gapless/index.js

@@ -1,5 +1,5 @@
 import { useMemo as a } from "react";
-import { b as s } from "../GingerSplitContexts-4YZ-OJ9V.js";
+import { b as s } from "../GingerSplitContexts-BzBExb95.js";
 function i() {
   const { tracks: e } = s();
   return a(