react-native-audio-browser 0.1.0 → 0.2.0-next.1

package/lib/typescript/src/specs/audio-browser.nitro.d.ts

@@ -1,19 +1,3 @@
-import { type HybridObject } from 'react-native-nitro-modules';
-import type { BatteryOptimizationStatus, BatteryOptimizationStatusChangedEvent, BatteryWarningPendingChangedEvent, FavoriteChangedEvent } from '../features';
-import type { NavigationError, NavigationErrorEvent, FormattedNavigationError, PlaybackError, PlaybackErrorEvent } from '../features/errors';
-import type { ChapterMetadata, NowPlayingMetadata, NowPlayingUpdate, TimedMetadata, TrackMetadata } from '../features/metadata';
-import type { PlayingState } from '../features/playback/playing';
-import type { PlaybackPlayWhenReadyChangedEvent } from '../features/playback/playWhenReady';
-import type { PlaybackProgressUpdatedEvent, Progress } from '../features/playback/progress';
-import type { Playback } from '../features/playback/state';
-import type { NativeUpdateOptions, Options, PartialSetupPlayerOptions, UpdateOptions } from '../features/player';
-import type { PlaybackActiveTrackChangedEvent } from '../features/queue/activeTrack';
-import type { PlaybackQueueEndedEvent } from '../features/queue/queue';
-import type { RepeatMode, RepeatModeChangedEvent } from '../features/queue/repeatMode';
-import type { RemoteJumpBackwardEvent, RemoteJumpForwardEvent, RemotePlayIdEvent, RemotePlaySearchEvent, RemoteSeekEvent, RemoteSetRatingEvent, RemoteSkipEvent } from '../features/remoteControls';
-import type { SleepTimer, SleepTimerChangedEvent } from '../features/sleepTimer';
-import type { ResolvedTrack, Track } from '../types';
-import type { NativeBrowserConfiguration } from '../types/browser-native';
 export type EqualizerSettings = {
     activePreset?: string;
     bandCount: number;
@@ -24,219 +8,27 @@ export type EqualizerSettings = {
     presets: string[];
     upperBandLevelLimit: number;
 };
-export type IosOutputType = 'built-in-speaker' | 'built-in-receiver' | 'airplay' | 'bluetooth-a2dp' | 'bluetooth-hfp' | 'bluetooth-le' | 'headphones' | 'car-audio' | 'hdmi' | 'usb-audio' | 'other';
 /**
- * Audio output information (iOS only).
+ * Cross-platform audio output kind. Each platform maps its native ports into
+ * this shared set: iOS's granular Bluetooth ports (`bluetoothA2DP`/`HFP`/`LE`)
+ * all collapse to `'bluetooth'`. Note Android's *reading* (`getOutput`) reports
+ * the active local route only — `'airplay'`/`'cast'` come from iOS / are
+ * reserved for remote destinations and don't appear from Android reads.
  */
-export type IosOutput = {
-    /** The output port type */
-    type: IosOutputType;
-    /** Human-readable device name (e.g., "AirPods Pro", "iPhone Speaker") */
+export type OutputType = 'speaker' | 'receiver' | 'headphones' | 'bluetooth' | 'airplay' | 'car' | 'hdmi' | 'usb' | 'cast' | 'other';
+/**
+ * The current audio output. Read via `getOutput()` / `useOutput()` on every
+ * platform: iOS always reports one while a session is active; Android reports the
+ * actively-routed device on all versions (the `type` is accurate on API 33+ and
+ * coarse below that). Only the output *switcher* (`openOutputPicker`) is gated to
+ * Android 11+ — check `supportsOutputSwitcher()`.
+ */
+export type Output = {
+    /** The output kind */
+    type: OutputType;
+    /** Human-readable device name (e.g., "AirPods Pro", "Kitchen speaker") */
     name: string;
     /** Whether this is an external output (false for built-in speaker/receiver) */
     external: boolean;
 };
-export interface AudioBrowser extends HybridObject<{
-    ios: 'swift';
-    android: 'kotlin';
-}> {
-    path: string | undefined;
-    tabs: Track[] | undefined;
-    navigatePath(path: string): void;
-    navigateTrack(track: Track): void;
-    onSearch(query: string): Promise<Track[]>;
-    getContent(): ResolvedTrack | undefined;
-    onPathChanged: (path: string) => void;
-    onContentChanged: (content: ResolvedTrack | undefined) => void;
-    onTabsChanged: (tabs: Track[]) => void;
-    onNavigationError: (data: NavigationErrorEvent) => void;
-    getNavigationError(): NavigationError | undefined;
-    onFormattedNavigationError: (formattedError: FormattedNavigationError | undefined) => void;
-    getFormattedNavigationError(): FormattedNavigationError | undefined;
-    notifyContentChanged(path: string): void;
-    setFavorites(favorites: string[]): void;
-    configuration: NativeBrowserConfiguration;
-    setupPlayer(options: PartialSetupPlayerOptions): Promise<void>;
-    updateOptions(options: NativeUpdateOptions): void;
-    getOptions(): UpdateOptions;
-    onChapterMetadata: (chapters: ChapterMetadata[]) => void;
-    onTrackMetadata: (metadata: TrackMetadata) => void;
-    onTimedMetadata: (metadata: TimedMetadata) => void;
-    onPlaybackActiveTrackChanged: (data: PlaybackActiveTrackChangedEvent) => void;
-    onPlaybackError: (data: PlaybackErrorEvent) => void;
-    onPlaybackPlayWhenReadyChanged: (data: PlaybackPlayWhenReadyChangedEvent) => void;
-    onPlaybackPlayingState: (data: PlayingState) => void;
-    onPlaybackProgressUpdated: (data: PlaybackProgressUpdatedEvent) => void;
-    onPlaybackQueueEnded: (data: PlaybackQueueEndedEvent) => void;
-    onPlaybackQueueChanged: (queue: Track[]) => void;
-    onPlaybackRepeatModeChanged: (data: RepeatModeChangedEvent) => void;
-    onPlaybackShuffleModeChanged: (enabled: boolean) => void;
-    onSleepTimerChanged: (data: SleepTimerChangedEvent) => void;
-    onPlaybackChanged: (data: Playback) => void;
-    onRemoteBookmark: () => void;
-    onRemoteDislike: () => void;
-    onRemoteJumpBackward: (event: RemoteJumpBackwardEvent) => void;
-    onRemoteJumpForward: (event: RemoteJumpForwardEvent) => void;
-    onRemoteLike: () => void;
-    onRemoteNext: () => void;
-    onRemotePause: () => void;
-    onRemotePlay: () => void;
-    onRemotePlayId: (event: RemotePlayIdEvent) => void;
-    onRemotePlaySearch: (event: RemotePlaySearchEvent) => void;
-    onRemotePrevious: () => void;
-    onRemoteSeek: (event: RemoteSeekEvent) => void;
-    onRemoteSetRating: (event: RemoteSetRatingEvent) => void;
-    onRemoteSkip: (event: RemoteSkipEvent) => void;
-    onRemoteStop: () => void;
-    onOptionsChanged: (event: Options) => void;
-    onFavoriteChanged: (event: FavoriteChangedEvent) => void;
-    onNowPlayingChanged: (metadata: NowPlayingMetadata) => void;
-    handleRemoteBookmark: (() => void) | undefined;
-    handleRemoteDislike: (() => void) | undefined;
-    handleRemoteJumpBackward: ((event: RemoteJumpBackwardEvent) => void) | undefined;
-    handleRemoteJumpForward: ((event: RemoteJumpForwardEvent) => void) | undefined;
-    handleRemoteLike: (() => void) | undefined;
-    handleRemoteNext: (() => void) | undefined;
-    handleRemotePause: (() => void) | undefined;
-    handleRemotePlay: (() => void) | undefined;
-    handleRemotePlayId: ((event: RemotePlayIdEvent) => void) | undefined;
-    handleRemotePlaySearch: ((event: RemotePlaySearchEvent) => void) | undefined;
-    handleRemotePrevious: (() => void) | undefined;
-    handleRemoteSeek: ((event: RemoteSeekEvent) => void) | undefined;
-    handleRemoteSkip: (() => void) | undefined;
-    handleRemoteStop: (() => void) | undefined;
-    load(track: Track): void;
-    reset(): void;
-    play(): void;
-    pause(): void;
-    togglePlayback(): void;
-    stop(): void;
-    setPlayWhenReady(playWhenReady: boolean): void;
-    getPlayWhenReady(): boolean;
-    seekTo(position: number): void;
-    seekBy(offset: number): void;
-    setVolume(level: number): void;
-    getVolume(): number;
-    setRate(rate: number): void;
-    getRate(): number;
-    getProgress(): Progress;
-    getPlayback(): Playback;
-    getPlayingState(): PlayingState;
-    getRepeatMode(): RepeatMode;
-    setRepeatMode(mode: RepeatMode): void;
-    getShuffleEnabled(): boolean;
-    setShuffleEnabled(enabled: boolean): void;
-    getPlaybackError(): PlaybackError | undefined;
-    retry(): void;
-    getSleepTimer(): SleepTimer;
-    setSleepTimer(seconds: number): void;
-    setSleepTimerToEndOfTrack(): void;
-    clearSleepTimer(): boolean;
-    add(tracks: Track[], insertBeforeIndex?: number): void;
-    move(fromIndex: number, toIndex: number): void;
-    remove(indexes: number[]): void;
-    removeUpcomingTracks(): void;
-    skip(index: number, initialPosition?: number): void;
-    skipToNext(initialPosition?: number): void;
-    skipToPrevious(initialPosition?: number): void;
-    /**
-     * Sets the favorited state of the currently playing track.
-     * Updates the heart icon in media controllers (notification, Android Auto, CarPlay).
-     */
-    setActiveTrackFavorited(favorited: boolean): void;
-    /**
-     * Toggles the favorited state of the currently playing track.
-     */
-    toggleActiveTrackFavorited(): void;
-    setQueue(tracks: Track[], startIndex?: number, startPositionMs?: number): void;
-    getQueue(): Track[];
-    getTrack(index: number): Track | undefined;
-    getActiveTrackIndex(): number | undefined;
-    getActiveTrack(): Track | undefined;
-    /**
-     * Updates the now playing notification metadata.
-     * Pass null to clear overrides and revert to track metadata.
-     */
-    updateNowPlaying(update: NowPlayingUpdate | undefined): void;
-    /**
-     * Gets the current now playing metadata (override if set, else track metadata).
-     */
-    getNowPlaying(): NowPlayingMetadata | undefined;
-    getOnline(): boolean;
-    onOnlineChanged: (online: boolean) => void;
-    /**
-     * Gets the current system volume (0.0 to 1.0).
-     */
-    getSystemVolume(): number;
-    /**
-     * Sets the system volume (0.0 to 1.0).
-     * Note: On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
-     */
-    setSystemVolume(volume: number): void;
-    /**
-     * Called when the system volume changes.
-     */
-    onSystemVolumeChanged: (volume: number) => void;
-    /**
-     * Gets the current audio output info.
-     * Always returns a value on iOS, undefined on Android.
-     */
-    getIosOutput(): IosOutput | undefined;
-    /**
-     * Called when audio output changes (iOS only).
-     * Never fires on Android.
-     */
-    onIosOutputChanged: (output: IosOutput) => void;
-    /**
-     * Opens the system output picker (iOS only).
-     * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
-     * No-op on Android.
-     */
-    openIosOutputPicker(): void;
-    getEqualizerSettings(): EqualizerSettings | undefined;
-    setEqualizerEnabled(enabled: boolean): void;
-    setEqualizerPreset(preset: string): void;
-    setEqualizerLevels(levels: number[]): void;
-    onEqualizerChanged: (settings: EqualizerSettings) => void;
-    /**
-     * Check if a battery warning is pending.
-     * Returns true if a foreground service start was blocked and the user hasn't dismissed
-     * the warning or fixed their battery settings.
-     * Auto-clears when battery status becomes unrestricted.
-     * Always returns false on iOS.
-     */
-    getBatteryWarningPending(): boolean;
-    /**
-     * Get the current battery optimization status.
-     * - `unrestricted`: App can run freely in background
-     * - `optimized`: System may limit background work (default)
-     * - `restricted`: Background services blocked
-     * Always returns `unrestricted` on iOS.
-     */
-    getBatteryOptimizationStatus(): BatteryOptimizationStatus;
-    /**
-     * Dismiss the battery warning without fixing settings.
-     * Call this when the user chooses to ignore the warning.
-     * No-op on iOS.
-     */
-    dismissBatteryWarning(): void;
-    /**
-     * Open the system battery settings for this app.
-     * No-op on iOS.
-     */
-    openBatterySettings(): void;
-    /**
-     * Called when battery warning pending state changes.
-     * Fires when: failure occurs (true), dismissBatteryWarning() called (false),
-     * or status becomes unrestricted (false).
-     * Never fires on iOS.
-     */
-    onBatteryWarningPendingChanged: (event: BatteryWarningPendingChangedEvent) => void;
-    /**
-     * Called when battery optimization status changes.
-     * Fires when user returns from settings with a different status.
-     * Never fires on iOS.
-     */
-    onBatteryOptimizationStatusChanged: (event: BatteryOptimizationStatusChangedEvent) => void;
-}
 //# sourceMappingURL=audio-browser.nitro.d.ts.map

package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-browser.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/audio-browser.nitro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audio-browser.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/audio-browser.nitro.ts"],"names":[],"mappings":"AAyDA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,WAAW,GACX,SAAS,GACT,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,CAAA;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAA;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA"}

package/lib/typescript/src/types/browser-native.d.ts

@@ -5,8 +5,9 @@
  * into separate optional properties to reduce generated code complexity.
  * Users should use BrowserConfiguration, not these types directly.
  */
-import type { ArtworkRequestConfig, BrowserSourceCallback, CarPlayNowPlayingButton, FormatNavigationErrorCallback, HandleTrackLoadCallback, MediaRequestConfig, SearchSourceCallback, TransformableRequestConfig } from './browser';
+import type { ArtworkRequestConfig, BrowserSourceCallback, ResolveAlbumUrlCallback, FormatNavigationErrorCallback, HandleTrackLoadCallback, MediaRequestConfig, SearchSourceCallback, TransformableRequestConfig } from './browser';
 import type { ResolvedTrack } from './browser-nodes';
+type NativeRequestConfigResolver = () => Promise<TransformableRequestConfig>;
 /**
  * Flattened route entry for native bridge.
  */
@@ -27,14 +28,19 @@ export interface NativeRouteEntry {
 export interface NativeBrowserConfiguration {
     path?: string;
     request?: TransformableRequestConfig;
+    requestResolver?: NativeRequestConfigResolver;
+    browse?: TransformableRequestConfig;
+    browseResolver?: NativeRequestConfigResolver;
     media?: MediaRequestConfig;
     artwork?: ArtworkRequestConfig;
+    nowPlayingArtwork?: ArtworkRequestConfig;
     routes?: NativeRouteEntry[];
     singleTrack?: boolean;
     handleTrackLoad?: HandleTrackLoadCallback;
     androidControllerOfflineError?: boolean;
-    carPlayUpNextButton?: boolean;
-    carPlayNowPlayingButtons?: CarPlayNowPlayingButton[];
+    carPlayLoadingTitle?: string;
+    resolveAlbumUrl?: ResolveAlbumUrlCallback;
     formatNavigationError?: FormatNavigationErrorCallback;
 }
+export {};
 //# sourceMappingURL=browser-native.d.ts.map

package/lib/typescript/src/types/browser-native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-native.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IAEZ,cAAc,CAAC,EAAE,qBAAqB,CAAA;IACtC,YAAY,CAAC,EAAE,0BAA0B,CAAA;IACzC,YAAY,CAAC,EAAE,aAAa,CAAA;IAE5B,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,YAAY,CAAC,EAAE,0BAA0B,CAAA;IAEzC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IAGb,OAAO,CAAC,EAAE,0BAA0B,CAAA;IAGpC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAA;IAO9B,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAG3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,6BAA6B,CAAC,EAAE,OAAO,CAAA;IAGvC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,wBAAwB,CAAC,EAAE,uBAAuB,EAAE,CAAA;IACpD,qBAAqB,CAAC,EAAE,6BAA6B,CAAA;CACtD"}
+{"version":3,"file":"browser-native.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAMpD,KAAK,2BAA2B,GAAG,MAAM,OAAO,CAAC,0BAA0B,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IAEZ,cAAc,CAAC,EAAE,qBAAqB,CAAA;IACtC,YAAY,CAAC,EAAE,0BAA0B,CAAA;IACzC,YAAY,CAAC,EAAE,aAAa,CAAA;IAE5B,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,YAAY,CAAC,EAAE,0BAA0B,CAAA;IAEzC,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IAKb,OAAO,CAAC,EAAE,0BAA0B,CAAA;IACpC,eAAe,CAAC,EAAE,2BAA2B,CAAA;IAG7C,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC,cAAc,CAAC,EAAE,2BAA2B,CAAA;IAC5C,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAA;IAC9B,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;IAQxC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAG3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,6BAA6B,CAAC,EAAE,OAAO,CAAA;IAGvC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,qBAAqB,CAAC,EAAE,6BAA6B,CAAA;CACtD"}

package/lib/typescript/src/types/browser-nodes.d.ts

@@ -20,17 +20,97 @@ export interface ImageSource {
     /** HTTP body for POST requests (rare for images) */
     body?: string;
 }
+/**
+ * Per-track override applied as the most-specific layer of THIS track's media
+ * request (after the shared `request` and `media` layers). Deliberately narrow:
+ * a track may customize HOW its request is made (identity, auth, signed-URL
+ * params), not WHERE it goes — `baseUrl`/`path`/`method`/`body` are intentionally
+ * absent so a (often server-sourced) track can't repoint its own host or verb.
+ * Carried verbatim on the Track and round-tripped like any other field.
+ */
+export interface TrackRequest {
+    userAgent?: string;
+    headers?: Record<string, string>;
+    query?: Record<string, string>;
+}
+/**
+ * Artwork URLs for a track that ships a different image per appearance.
+ *
+ * Both are required: a pair with one side missing has no sensible fallback at
+ * render time, and making that unrepresentable is the reason this is a pair
+ * rather than two optional fields.
+ *
+ * Android Auto is dark-only and takes `dark`.
+ */
+export interface ArtworkVariants {
+    /** Shown in light mode. */
+    light: string;
+    /** Shown in dark mode, and on Android Auto. */
+    dark: string;
+}
+/** A single artwork URL, or one per appearance. */
+export type TrackArtwork = string | ArtworkVariants;
 export interface ImageRowItem {
+    /**
+     * Opaque, stable identifier for this item's track. Round-tripped like
+     * `Track.id` when the thumbnail is played (see `src`).
+     */
+    id?: string;
     /** Navigation path. Tapping this thumbnail navigates to this URL. */
     url?: string;
+    /**
+     * Direct audio source. When present, tapping this thumbnail plays it
+     * immediately (same selection path as a playable list row) instead of
+     * navigating. Takes precedence over `url`.
+     */
+    src?: string;
     /** Artwork URL for the thumbnail image. */
     artwork?: string;
     /** Output only — populated by the artwork transform pipeline. */
     readonly artworkSource?: ImageSource;
-    /** Title of this item. Used for identification and accessibility. */
+    /** Title of this item. Shown as the thumbnail caption; used for identification and accessibility. */
     title: string;
+    /** Now-playing secondary line when played via `src` (mirrors `Track.artist`). */
+    artist?: string;
+    /** Now-playing album line when played via `src` (mirrors `Track.album`). */
+    album?: string;
+    /** Navigation target of the album line when played via `src` (mirrors `Track.albumUrl`). */
+    albumUrl?: string;
+    /** Live stream indicator when played via `src` (mirrors `Track.live`). */
+    live?: boolean;
+    /** Per-item media-request override when played via `src` (mirrors `Track.request`). */
+    request?: TrackRequest;
 }
 export interface Track {
+    /**
+     * Opaque, stable identifier for this track.
+     *
+     * The library never parses or derives anything from this value — it is
+     * round-tripped verbatim through `setQueue`, `getActiveTrack`, the queue, and
+     * `onActiveTrackChanged`, so consumers can recognise which item became active
+     * after an external transport change (lock screen / CarPlay / Android Auto /
+     * Bluetooth next-previous) without parsing the playable `src`.
+     *
+     * When present on a playable track it is also the track's *identity* on car
+     * browse surfaces: CarPlay's and Android Auto's "now playing" row indicator
+     * match the active track to browse rows by `id` (falling back to exact `src`
+     * equality for tracks without one). Assign ids when your playable `src`
+     * strings for the same item can differ between browse rows and loaded tracks
+     * (absolute vs relative URLs, volatile query params) — otherwise the
+     * indicator never matches.
+     *
+     * It is also handed to the per-track `MediaRequestConfig.resolve` and
+     * `ArtworkRequestConfig.resolve` hooks, so requests can be built from a stable
+     * id (e.g. supply tracks with only an `id` and synthesise `src` in `resolve`).
+     *
+     * Optional: consumers whose `url`/`src` strings are already stable across
+     * surfaces can ignore it.
+     *
+     * Note: an Android Auto item selected directly from the browse tree that the
+     * consumer never queued is identified only by `url`/`src`, so `id` may be
+     * undefined on that specific path.
+     */
+    id?: string;
     /**
      * Navigation path. When present, this track is a container (tab, album, playlist, folder)
      * that can be navigated into to view its contents.
@@ -49,12 +129,17 @@ export interface Track {
      */
     src?: string;
     /**
-     * Artwork URL for the item.
+     * Artwork URL for the item, or a URL per appearance.
      *
      * The artwork URL is also returned by native in the `artworkSource` property
      * for use in an `<Image>` component, which will contain the transformed version
      * if `artwork` configuration is set in `BrowserConfiguration` or a route.
      *
+     * Pass an {@link ArtworkVariants} pair to supply genuinely different images
+     * per appearance — a logo that changes colour, say. For a monochrome glyph
+     * that only needs recolouring, prefer a single URL plus
+     * {@link Track.artworkCarPlayTinted}, which is one fetch instead of two.
+     *
      * **iOS:** supports {@link https://developer.apple.com/sf-symbols/ | SF Symbols}
      * with the `sf:` prefix and optional color params:
      * `sf:heart.fill?bg=#FF0090&fg=#fff`. `bg` sets the background color
@@ -62,7 +147,7 @@ export interface Track {
      * On CarPlay, SF Symbols without explicit colors automatically adapt to
      * light/dark mode.
      */
-    artwork?: string;
+    artwork?: TrackArtwork;
     /**
      * Ready-to-use image source for React Native's `<Image>` component.
      *
@@ -78,6 +163,8 @@ export interface Track {
      * ```
      */
     readonly artworkSource?: ImageSource;
+    /** Per-track media-request override; merged last (request → media → track.request). */
+    request?: TrackRequest;
     /**
      * Whether this artwork should be tinted based on CarPlay's current appearance (light/dark mode).
      *
@@ -94,12 +181,46 @@ export interface Track {
      * @default false
      */
     artworkCarPlayTinted?: boolean;
+    /** Primary line shown for this item, in both browse lists and now-playing. */
     title: string;
+    /**
+     * Secondary line shown for this item in **browse lists** (CarPlay list detail
+     * text, Android Auto list subtitle). Free-form, per-context display text — set
+     * it to whatever the row should show, or leave it unset for a blank line. It is
+     * *not* shown on the now-playing screen; use {@link artist} for that.
+     */
     subtitle?: string;
+    /**
+     * Secondary line shown on the **now-playing / lock-screen** UI, and the value
+     * sent to Bluetooth / car head units — it maps to the platform's "artist"
+     * metadata slot.
+     *
+     * Distinct from {@link subtitle}: `artist` drives the now-playing line,
+     * `subtitle` drives browse-list rows. Neither falls back to the other — set
+     * each for the surface you want it on.
+     */
     artist?: string;
+    /**
+     * Browse path the {@link album} line navigates to (same path namespace as
+     * {@link url}). On CarPlay, when the active track has an `albumUrl`, its
+     * album line on the Now Playing screen becomes tappable and navigates the
+     * browse stack there. See also `resolveAlbumUrl` in the browser
+     * configuration for a dynamic fallback.
+     *
+     * Requires {@link album} to be set: CarPlay renders the tappable line from
+     * the album metadata — without an album there is no line to tap.
+     *
+     * @platform ios
+     */
+    albumUrl?: string;
     album?: string;
     description?: string;
     genre?: string;
+    /**
+     * Duration in seconds, as catalog metadata for app UI (e.g. an episode
+     * list). Does not drive the now-playing scrubber — every platform surface
+     * derives elapsed/duration from the player itself.
+     */
     duration?: number;
     /**
      * Display style for this item in Android Auto/AAOS.
@@ -126,7 +247,7 @@ export interface Track {
      */
     childrenStyle?: TrackStyle;
     /**
-     * Whether this track is favorited. When the `set-rating` capability is enabled,
+     * Whether this track is favorited. When the `favorite` capability is enabled,
      * displays a filled/empty heart icon in media controllers (notification, Android Auto).
      */
     favorited?: boolean;
@@ -147,13 +268,18 @@ export interface Track {
      *
      * - Track.title → row header text
      * - Track.url → navigated when header is tapped (optional)
-     * - Each ImageRowItem → one thumbnail in the horizontal row
+     * - Each ImageRowItem → one thumbnail in the horizontal row; a thumbnail
+     *   with `src` plays immediately on tap, otherwise its `url` is navigated
      *
      * On CarPlay: maps to CPListImageRowItem. Limits visible images by display
-     * width (~4-5). Excess silently truncated.
+     * width (~4-5). Excess silently truncated. A row whose track has no `url`
+     * is a pure preview: its header is not tappable.
      *
-     * On Android Auto: ignored; the parent Track renders as a regular
-     * browsable item using its own artwork/title/url.
+     * On Android Auto: there is no image-row rendering, so the row expands into
+     * its items as grid-styled rows (artwork tiles where the host honors the
+     * per-item content-style hint, list rows otherwise) grouped under the
+     * track's title, followed by the track itself as a browsable "view all"
+     * link when it has a `url`.
      *
      * On app side: consumable by React Native UI for horizontal thumbnail layouts.
      */
@@ -167,10 +293,13 @@ export interface Track {
  *
  * @example
  * ```ts
- * const resolved = await audioBrowser.navigate('albums/abbey-road');
- * console.log(resolved.url); // "albums/abbey-road"
- * console.log(resolved.title); // "Abbey Road"
- * console.log(resolved.children); // Array of tracks in this album
+ * // navigate() is fire-and-forget (returns void); read the resolved page
+ * // from getContent() / useContent() / onContentChanged.
+ * navigate('albums/abbey-road');
+ * const resolved = getContent();
+ * console.log(resolved?.url); // "albums/abbey-road"
+ * console.log(resolved?.title); // "Abbey Road"
+ * console.log(resolved?.children); // Array of tracks in this album
  * ```
  */
 export interface ResolvedTrack extends Track {
@@ -185,7 +314,10 @@ export interface ResolvedTrack extends Track {
     children?: Track[];
     /**
      * Shows the "Ask Siri to Play Audio" assistant cell on the CarPlay list template
-     * for this content. Requires an Intents Extension to be configured in the app.
+     * for this content. Requires the Siri entitlement, the `INPlayMediaIntent` keys in
+     * Info.plist, and an in-app intent handler in your `AppDelegate`
+     * (`application(_:handlerFor:)`) — no separate Intents Extension is needed. See the
+     * setup guide for the full wiring.
      *
      * - `'top'`: Shows at the top of the list
      * - `'bottom'`: Shows at the bottom of the list

package/lib/typescript/src/types/browser-nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-nodes.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE1E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,2CAA2C;IAC3C,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAQD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAA;IACpC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,KAAK;IACpB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAA;IAEpC;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAG9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;IAElB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,UAAU,CAAA;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAA;IAElB;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,6BAA6B,CAAA;CACtD"}
+{"version":3,"file":"browser-nodes.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-nodes.ts"],"names":[],"mappings":"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"}