@lucaismyname/ginger 0.0.15 → 0.0.20

package/README.md

@@ -1,3 +1,79 @@
+# @lucaismyname/ginger
+
+Headless React audio player primitives for building custom music and podcast UIs.
+
+## Install
+
+```bash
+npm install @lucaismyname/ginger
+```
+
+Peer dependencies:
+
+- `react >= 18`
+- `react-dom >= 18`
+
+## Quick Start
+
+```tsx
+import { Ginger } from "@lucaismyname/ginger";
+
+const tracks = [{ id: "a", title: "Track A", fileUrl: "/audio/a.mp3" }];
+
+export function Player() {
+  return (
+    <Ginger.Provider initialTracks={tracks}>
+      <Ginger.Player />
+      <Ginger.Control.PlayPause />
+      <Ginger.Control.Previous />
+      <Ginger.Control.Next />
+      <Ginger.Control.SeekBar />
+      <Ginger.Control.Volume />
+      <Ginger.Current.Title fallback="No track" />
+    </Ginger.Provider>
+  );
+}
+```
+
+## Documentation
+
+- Getting started: [`docs/getting-started.md`](./docs/getting-started.md)
+- Testing guide: [`docs/guides/testing.md`](./docs/guides/testing.md)
+- Recipes: [`docs/guides/recipes.md`](./docs/guides/recipes.md)
+- Accessibility checklist: [`docs/guides/accessibility.md`](./docs/guides/accessibility.md)
+- 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)
+- Generated API docs: [`docs/api/index.html`](./docs/api/index.html)
+
+## Subpath Exports
+
+- `@lucaismyname/ginger/client`
+- `@lucaismyname/ginger/testing`
+- `@lucaismyname/ginger/waveform`
+- `@lucaismyname/ginger/experimental-gapless`
+
+### Experimental Notice
+
+`@lucaismyname/ginger/experimental-gapless` is intentionally non-production.
+It currently provides capability metadata only and does not alter playback behavior.
+
+## Release Process
+
+- Changelog: [`CHANGELOG.md`](./CHANGELOG.md)
+- Release note template: [`../../.github/release-template.md`](../../.github/release-template.md)
+
+Before publishing:
+
+```bash
+npm run build
+npm run test
+npm run typecheck
+npm run lint
+npm run docs:api
+```
+
 # ginger
 
 **`@lucaismyname/ginger`** is a headless React audio player built on the native **`<audio>`** element. It gives you a provider, a hidden media element, a typed state/control hook, and composable React components for transport controls, track metadata, queue metadata, and playlists.
@@ -491,6 +567,8 @@ Other current-track components:
 |-----------|-------------|-----------------|
 | `Ginger.Current.Artwork` | Current track artwork or playlist artwork fallback | `unstyled`, `imgStyle`, `sizes`, `loading`, `decoding`, `onError`, display-base props |
 | `Ginger.Current.Lyrics` | Track lyrics | `preserveWhitespace`, render-prop `children` |
+| `Ginger.Current.LyricsSynced` | Timed / LRC lyrics with active line | `activeClassName`, `lineClassName`, `unstyled`, render-prop `children` |
+| `Ginger.Current.Chapters` | Chapter list; click seeks to `startSeconds` | `formatStart`, `unstyled`, render-prop `children` |
 | `Ginger.Current.FileUrl` | Track `fileUrl`, hidden unless explicitly enabled | `visible`, display-base props |
 | `Ginger.Current.QueueIndex` | Current queue index | `base`, render-prop `children` |
 | `Ginger.Current.QueueLength` | Queue length | render-prop `children` |
@@ -688,7 +766,7 @@ Example:
 
 - **Headless control bindings** (bind to your own components): **`useSeekBarBinding()`**, **`useVolumeSlider()`**, **`usePlayPauseBinding({ playAriaLabel?, pauseAriaLabel? })`**. Each returns props such as `value`, `min`, `max`, handlers, and `ariaLabel` / `ariaValueText` where relevant.
 
-- **Advanced hooks** — **`useGingerKeyboardShortcuts()`**, **`useGingerSleepTimer()`**, **`useSeekDrag()`**, **`useGingerChapters()`**, **`useGingerLyricsSync()`**, and **`useGingerDebugLog()`** are available for custom UX and diagnostics.
+- **Advanced hooks** — **`useGingerKeyboardShortcuts()`**, **`useGingerSleepTimer()`**, **`useSeekDrag()`**, **`useNextTrackPrefetch()`**, **`useGingerChapters()`**, **`useGingerLyricsSync()`**, and **`useGingerDebugLog()`** are available for custom UX and diagnostics.
 
 - **Locale** — Pass **`locale={partialMessages}`** on `Ginger.Provider` (type **`GingerLocaleMessages`**) to translate built-in control strings; **`useGingerLocale()`** reads the merged messages anywhere under the provider.
 
@@ -847,6 +925,31 @@ function ChapterAndLyrics() {
 
 `Track` now supports optional `chapters` and `lyricsTimed` fields. For LRC parsing, use `parseLrc()`.
 
+For ready-made UI, use **`Ginger.Current.Chapters`** and **`Ginger.Current.LyricsSynced`** (same data as the hooks above).
+
+### Next-track prefetch
+
+```tsx
+import { Ginger, useNextTrackPrefetch } from "@lucaismyname/ginger";
+
+function PrefetchNext() {
+  useNextTrackPrefetch({ crossOrigin: "anonymous" });
+  return null;
+}
+
+export function App() {
+  return (
+    <Ginger.Provider initialTracks={tracks}>
+      <Ginger.Player crossOrigin="anonymous" />
+      <PrefetchNext />
+      {/* ... */}
+    </Ginger.Provider>
+  );
+}
+```
+
+The hook preloads the **logical** next track (same rules as the Next button) using a detached `HTMLAudioElement` with `preload="auto"`. Pass **`crossOrigin`** when it matches **`Ginger.Player`** for cross-origin URLs.
+
 ### Sleep timer and drag seek
 
 ```tsx
@@ -896,6 +999,7 @@ Use `useGingerDebugLog(true)` during development to log core state transitions i
 - `Ginger.Control.SeekBar` and `Ginger.Control.Volume` accept `unstyled`.
 - `Ginger.Current.Artwork`, `Ginger.Queue.Artwork`, `Ginger.Current.TimeRail`, and `Ginger.Current.BufferRail` accept `unstyled`.
 - `Ginger.Playlist` and `Ginger.Playlist.Track` accept `unstyled`.
+- `Ginger.Current.Chapters` and `Ginger.Current.LyricsSynced` accept `unstyled`.
 
 This gives you a pure state+behavior layer while keeping convenience components available.
 
@@ -924,6 +1028,14 @@ There is no `window` at import time, but playback only starts when the audio ele
 
 See [Recipes — Updating the queue after mount](#updating-the-queue-after-mount).
 
+## Development priorities
+
+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.
+
 ## Monorepo Development
 
 | Path | Purpose |

package/dist/client.cjs

@@ -1,2 +1,2 @@
-"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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ginger-CMbd3s8C.cjs"),r=require("./useNextTrackPrefetch-CFoUynDv.cjs"),a=require("./GingerSplitContexts-C7puo0M7.cjs");exports.Chapters=e.Chapters;exports.Ginger=e.Ginger;exports.LyricsSynced=e.LyricsSynced;exports.clampPlaybackRate=e.clampPlaybackRate;exports.clampVolume=e.clampVolume;exports.defaultGingerLocale=e.defaultGingerLocale;exports.derivePlaybackUiState=e.derivePlaybackUiState;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=r.attachLiveAnalyser;exports.detachLiveAnalyser=r.detachLiveAnalyser;exports.useGinger=r.useGinger;exports.useGingerDebugLog=r.useGingerDebugLog;exports.useGingerKeyboardShortcuts=r.useGingerKeyboardShortcuts;exports.useGingerLiveAnalyzer=r.useGingerLiveAnalyzer;exports.useGingerSleepTimer=r.useGingerSleepTimer;exports.useNextTrackPrefetch=r.useNextTrackPrefetch;exports.useSeekDrag=r.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,31 +1,34 @@
-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";
+import { C as s, G as r, L as i, c as n, a as t, d as u, b as g, p as c, u as l, e as o, f as G, g as y, h as d, i as S } from "./ginger-8x4WzVmw.js";
+import { a as p, d as L, u as b, b as h, c as f, e as k, f as x, g as P, h as C } from "./useNextTrackPrefetch-CV1khU0h.js";
+import { g as A, a as B, u as V, b as D, c as F } from "./GingerSplitContexts-BzBExb95.js";
 export {
-  s as Ginger,
-  G as attachLiveAnalyser,
-  r as clampPlaybackRate,
-  i as clampVolume,
-  g as defaultGingerLocale,
-  n as derivePlaybackUiState,
-  d as detachLiveAnalyser,
-  P as gingerStateFromContextValues,
-  v as gingerStateFromContexts,
-  m as parseLrc,
-  y as useGinger,
-  S as useGingerChapters,
-  p as useGingerDebugLog,
-  b as useGingerKeyboardShortcuts,
-  L as useGingerLiveAnalyzer,
-  u as useGingerLocale,
-  f as useGingerLyricsSync,
-  A as useGingerMedia,
-  B as useGingerPlayback,
-  h as useGingerSleepTimer,
-  C as useGingerState,
-  t as usePlayPauseBinding,
-  l as useSeekBarBinding,
-  k as useSeekDrag,
-  o as useVolumeSlider
+  s as Chapters,
+  r as Ginger,
+  i as LyricsSynced,
+  p as attachLiveAnalyser,
+  n as clampPlaybackRate,
+  t as clampVolume,
+  u as defaultGingerLocale,
+  g as derivePlaybackUiState,
+  L as detachLiveAnalyser,
+  A as gingerStateFromContextValues,
+  B as gingerStateFromContexts,
+  c as parseLrc,
+  b as useGinger,
+  l as useGingerChapters,
+  h as useGingerDebugLog,
+  f as useGingerKeyboardShortcuts,
+  k as useGingerLiveAnalyzer,
+  o as useGingerLocale,
+  G as useGingerLyricsSync,
+  V as useGingerMedia,
+  D as useGingerPlayback,
+  x as useGingerSleepTimer,
+  F as useGingerState,
+  P as useNextTrackPrefetch,
+  y as usePlayPauseBinding,
+  d as useSeekBarBinding,
+  C as useSeekDrag,
+  S as useVolumeSlider
 };
 //# sourceMappingURL=client.js.map

package/dist/client.test.d.ts

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

package/dist/client.test.d.ts.map

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

package/dist/components/controls/Controls.d.ts

@@ -7,62 +7,75 @@ export type PlayPauseProps = ButtonHTMLAttributes<HTMLButtonElement> & {
     playAriaLabel?: string;
     /** Screen-reader label when playing (action would pause); defaults to match `pauseLabel` when it is a string */
     pauseAriaLabel?: string;
+    children?: ReactNode;
 };
-export declare function PlayPause({ playLabel, pauseLabel, playAriaLabel, pauseAriaLabel, type, onClick, ...rest }: PlayPauseProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlayPause({ playLabel, pauseLabel, playAriaLabel, pauseAriaLabel, children, type, onClick, ...rest }: PlayPauseProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace PlayPause {
     var displayName: string;
 }
-export type RepeatProps = ButtonHTMLAttributes<HTMLButtonElement>;
-export declare function Repeat({ type, onClick, ...rest }: RepeatProps): import("react/jsx-runtime").JSX.Element;
+export type RepeatProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    ariaLabel?: string;
+};
+export declare function Repeat({ type, ariaLabel, onClick, ...rest }: RepeatProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Repeat {
     var displayName: string;
 }
-export type NextProps = ButtonHTMLAttributes<HTMLButtonElement>;
-export declare function Next({ type, children, onClick, ...rest }: NextProps): import("react/jsx-runtime").JSX.Element;
+export type NextProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    ariaLabel?: string;
+};
+export declare function Next({ type, children, ariaLabel, onClick, ...rest }: NextProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Next {
     var displayName: string;
 }
-export type PreviousProps = ButtonHTMLAttributes<HTMLButtonElement>;
-export declare function Previous({ type, children, onClick, ...rest }: PreviousProps): import("react/jsx-runtime").JSX.Element;
+export type PreviousProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    ariaLabel?: string;
+};
+export declare function Previous({ type, children, ariaLabel, onClick, ...rest }: PreviousProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Previous {
     var displayName: string;
 }
-export type ShuffleProps = ButtonHTMLAttributes<HTMLButtonElement>;
-export declare function Shuffle({ type, children, onClick, ...rest }: ShuffleProps): import("react/jsx-runtime").JSX.Element;
+export type ShuffleProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    ariaLabel?: string;
+};
+export declare function Shuffle({ type, children, ariaLabel, onClick, ...rest }: ShuffleProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Shuffle {
     var displayName: string;
 }
 export type SeekBarProps = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "onChange" | "onInput" | "min" | "max" | "step"> & {
     /** Remove default width style for fully custom styling. */
     unstyled?: boolean;
+    ariaLabel?: string;
     inputStyle?: CSSProperties;
 };
-export declare function SeekBar({ inputStyle, style, unstyled, ...rest }: SeekBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function SeekBar({ inputStyle, style, unstyled, ariaLabel, ...rest }: SeekBarProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SeekBar {
     var displayName: string;
 }
 export type VolumeProps = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "value" | "onChange" | "onInput" | "min" | "max" | "step"> & {
     /** Remove default width style for fully custom styling. */
     unstyled?: boolean;
+    ariaLabel?: string;
     inputStyle?: CSSProperties;
 };
-export declare function Volume({ inputStyle, style, unstyled, ...rest }: VolumeProps): import("react/jsx-runtime").JSX.Element;
+export declare function Volume({ inputStyle, style, unstyled, ariaLabel, ...rest }: VolumeProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Volume {
     var displayName: string;
 }
 export type MuteProps = ButtonHTMLAttributes<HTMLButtonElement> & {
+    ariaLabel?: string;
     muteLabel?: ReactNode;
     unmuteLabel?: ReactNode;
 };
-export declare function Mute({ muteLabel, unmuteLabel, type, onClick, ...rest }: MuteProps): import("react/jsx-runtime").JSX.Element;
+export declare function Mute({ ariaLabel, muteLabel, unmuteLabel, type, onClick, ...rest }: MuteProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Mute {
     var displayName: string;
 }
 export type PlaybackRateProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, "value" | "onChange"> & {
     /** Playback speed options (default: 0.5 … 2) */
     rates?: readonly number[];
+    ariaLabel?: string;
 };
-export declare function PlaybackRate({ rates, style, ...rest }: PlaybackRateProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlaybackRate({ rates, style, ariaLabel, ...rest }: PlaybackRateProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace PlaybackRate {
     var displayName: string;
 }

package/dist/components/controls/Controls.d.ts.map

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

package/dist/components/current/Chapters.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+import { DisplayBaseProps, GingerState } from '../../types';
+import { GingerChapter } from '../../hooks/useGingerChapters';
+export type ChaptersProps = Omit<DisplayBaseProps, "children"> & {
+    /** Remove default list/row styles for fully custom styling. */
+    unstyled?: boolean;
+    /** Prefix before each chapter title (default: `formatMmSs(startSeconds)`). */
+    formatStart?: (startSeconds: number) => string;
+    children?: (chapter: GingerChapter, index: number, active: boolean, state: GingerState) => ReactNode;
+};
+export declare function Chapters({ className, style, fallback, empty, unstyled, formatStart, children, }: ChaptersProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace Chapters {
+    var displayName: string;
+}
+//# sourceMappingURL=Chapters.d.ts.map

package/dist/components/current/Chapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chapters.d.ts","sourceRoot":"","sources":["../../../src/components/current/Chapters.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGtF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG;IAC/D,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,SAAS,CAAC;CACtG,CAAC;AAEF,wBAAgB,QAAQ,CAAC,EACvB,SAAS,EACT,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,WAAwB,EACxB,QAAQ,GACT,EAAE,aAAa,kDA4Df;yBApEe,QAAQ"}

package/dist/components/current/ChaptersLyricsSynced.test.d.ts

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

package/dist/components/current/ChaptersLyricsSynced.test.d.ts.map

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

package/dist/components/current/LyricsSynced.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+import { DisplayBaseProps, GingerState } from '../../types';
+import { TimedLyricLine } from '../../internal/lyrics';
+export type LyricsSyncedProps = Omit<DisplayBaseProps, "children"> & {
+    unstyled?: boolean;
+    /** Class applied to the line that matches the current playback time. */
+    activeClassName?: string;
+    /** Class applied to every line. */
+    lineClassName?: string;
+    children?: (line: TimedLyricLine, index: number, active: boolean, state: GingerState) => ReactNode;
+};
+export declare function LyricsSynced({ className, style, fallback, empty, unstyled, activeClassName, lineClassName, children, }: LyricsSyncedProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace LyricsSynced {
+    var displayName: string;
+}
+//# sourceMappingURL=LyricsSynced.d.ts.map

package/dist/components/current/LyricsSynced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LyricsSynced.d.ts","sourceRoot":"","sources":["../../../src/components/current/LyricsSynced.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,SAAS,CAAC;CACpG,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,eAAe,EACf,aAAa,EACb,QAAQ,GACT,EAAE,iBAAiB,kDA8CnB;yBAvDe,YAAY"}

package/dist/components/current/index.d.ts

@@ -1,6 +1,10 @@
 export * from './texts';
 export { Year } from './Year';
 export { Lyrics } from './Lyrics';
+export { LyricsSynced } from './LyricsSynced';
+export type { LyricsSyncedProps } from './LyricsSynced';
+export { Chapters } from './Chapters';
+export type { ChaptersProps } from './Chapters';
 export { FileUrl } from './FileUrl';
 export { Artwork } from './Artwork';
 export { QueueIndex, QueueLength, QueuePosition } from './QueueMeta';

package/dist/components/current/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/current/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/current/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/transitions.d.ts

@@ -1,4 +1,6 @@
 import { GingerState, RepeatMode, Track } from '../types';
+/** Fields used by next/prev/ended navigation; avoids coupling helpers to full `GingerState`. */
+export type GingerPlaybackNavigationSlice = Pick<GingerState, "tracks" | "currentIndex" | "repeatMode" | "playbackMode">;
 export type EndedTransition = {
     kind: "replay_same";
 } | {
@@ -11,9 +13,9 @@ export type EndedTransition = {
     kind: "stop";
     nextIndex: number;
 };
-export declare function computeEndedTransition(state: GingerState): EndedTransition;
-export declare function computeNextIndex(state: GingerState): number;
-export declare function computePrevIndex(state: GingerState): number;
+export declare function computeEndedTransition(state: GingerPlaybackNavigationSlice): EndedTransition;
+export declare function computeNextIndex(state: GingerPlaybackNavigationSlice): number;
+export declare function computePrevIndex(state: GingerPlaybackNavigationSlice): number;
 export declare function cycleRepeatMode(mode: RepeatMode): RepeatMode;
 export declare function resolveArtworkUrl(track: Track | null, playlistArtwork?: string | null): string | undefined;
 export declare function resolveAlbumLine(track: Track | null, playlistSubtitle?: string | null): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/core/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG/D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAS1E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAI5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAE1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAE1G"}
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/core/transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG/D,gGAAgG;AAChG,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,WAAW,EACX,QAAQ,GAAG,cAAc,GAAG,YAAY,GAAG,cAAc,CAC1D,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,6BAA6B,GAAG,eAAe,CAS5F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAQ7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAQ7E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAI5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAE1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAE1G"}

package/dist/experimental-gapless/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/experimental-gapless/index.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\n\nexport type ExperimentalGaplessState = {\n  supported: false;\n  reason: string;\n  preloadedTrackIds: string[];\n};\n\n/**\n * Experimental-only helper surface.\n * This does not alter Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(\n    () => ({\n      supported: false as const,\n      reason: \"Gapless playback requires dedicated Web Audio graph orchestration.\",\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    }),\n    [tracks],\n  );\n}\n"],"names":["useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":"0JAaO,SAASA,GAAmD,CACjE,KAAM,CAAE,OAAAC,CAAA,EAAWC,oBAAA,EACnB,OAAOC,EAAAA,QACL,KAAO,CACL,UAAW,GACX,OAAQ,qEACR,kBAAmBF,EAAO,IAAKG,GAAUA,EAAM,IAAMA,EAAM,OAAO,CAAA,GAEpE,CAACH,CAAM,CAAA,CAEX"}
+{"version":3,"file":"index.cjs","sources":["../../src/experimental-gapless/index.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\n\nexport type ExperimentalGaplessState = {\n  supported: false;\n  reason: string;\n  preloadedTrackIds: string[];\n};\n\n/**\n * Experimental-only helper surface.\n *\n * @deprecated This export is intentionally non-production and currently reports capabilities only.\n * It does not alter Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(\n    () => ({\n      supported: false as const,\n      reason: \"Gapless playback requires dedicated Web Audio graph orchestration.\",\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    }),\n    [tracks],\n  );\n}\n"],"names":["useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":"0JAeO,SAASA,GAAmD,CACjE,KAAM,CAAE,OAAAC,CAAA,EAAWC,oBAAA,EACnB,OAAOC,EAAAA,QACL,KAAO,CACL,UAAW,GACX,OAAQ,qEACR,kBAAmBF,EAAO,IAAKG,GAAUA,EAAM,IAAMA,EAAM,OAAO,CAAA,GAEpE,CAACH,CAAM,CAAA,CAEX"}

package/dist/experimental-gapless/index.d.ts

@@ -5,7 +5,9 @@ export type ExperimentalGaplessState = {
 };
 /**
  * Experimental-only helper surface.
- * This does not alter Ginger playback behavior.
+ *
+ * @deprecated This export is intentionally non-production and currently reports capabilities only.
+ * It does not alter Ginger playback behavior.
  */
 export declare function useExperimentalGapless(): ExperimentalGaplessState;
 //# sourceMappingURL=index.d.ts.map

package/dist/experimental-gapless/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experimental-gapless/index.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,wBAAwB,CAUjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experimental-gapless/index.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,wBAAwB,CAUjE"}

package/dist/experimental-gapless/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/experimental-gapless/index.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\n\nexport type ExperimentalGaplessState = {\n  supported: false;\n  reason: string;\n  preloadedTrackIds: string[];\n};\n\n/**\n * Experimental-only helper surface.\n * This does not alter Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(\n    () => ({\n      supported: false as const,\n      reason: \"Gapless playback requires dedicated Web Audio graph orchestration.\",\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    }),\n    [tracks],\n  );\n}\n"],"names":["useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":";;AAaO,SAASA,IAAmD;AACjE,QAAM,EAAE,QAAAC,EAAA,IAAWC,EAAA;AACnB,SAAOC;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,mBAAmBF,EAAO,IAAI,CAACG,MAAUA,EAAM,MAAMA,EAAM,OAAO;AAAA,IAAA;AAAA,IAEpE,CAACH,CAAM;AAAA,EAAA;AAEX;"}
+{"version":3,"file":"index.js","sources":["../../src/experimental-gapless/index.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\n\nexport type ExperimentalGaplessState = {\n  supported: false;\n  reason: string;\n  preloadedTrackIds: string[];\n};\n\n/**\n * Experimental-only helper surface.\n *\n * @deprecated This export is intentionally non-production and currently reports capabilities only.\n * It does not alter Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(\n    () => ({\n      supported: false as const,\n      reason: \"Gapless playback requires dedicated Web Audio graph orchestration.\",\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    }),\n    [tracks],\n  );\n}\n"],"names":["useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":";;AAeO,SAASA,IAAmD;AACjE,QAAM,EAAE,QAAAC,EAAA,IAAWC,EAAA;AACnB,SAAOC;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,mBAAmBF,EAAO,IAAI,CAACG,MAAUA,EAAM,MAAMA,EAAM,OAAO;AAAA,IAAA;AAAA,IAEpE,CAACH,CAAM;AAAA,EAAA;AAEX;"}