react-native-audio-browser 0.2.0-next.8 → 0.2.0

package/src/features/queue/queue.ts

@@ -115,22 +115,11 @@ export function skipToPrevious(initialPosition?: number): void {
 }
 
 /**
- * Sets (replaces) the queue.
- *
- * This does not change the play/pause state: the player keeps playing if it was
- * playing and stays paused if it was paused. Call `play` explicitly to
- * start playback.
- *
+ * Sets the queue.
  * @param tracks - The tracks to set as the queue.
- * @param startIndex - (Optional) The index of the track to make active.
- * @param startPosition - (Optional) The position in seconds to start the active track from.
- */
-export function setQueue(
-  tracks: Track[],
-  startIndex?: number,
-  startPosition?: number
-): void {
-  nativeBrowser.setQueue(tracks, startIndex, startPosition)
+ */
+export function setQueue(tracks: Track[]): void {
+  nativeBrowser.setQueue(tracks)
 }
 
 // MARK: - Getters
@@ -156,7 +145,7 @@ export function getQueue(): Track[] {
 /**
  * Subscribes to playback queue ended events.
  * @param callback - Called when playback has paused due to reaching the end of the queue
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onQueueEnded =
   NativeUpdatedValue.emitterize<PlaybackQueueEndedEvent>(
@@ -167,7 +156,7 @@ export const onQueueEnded =
  * Subscribes to queue change events.
  * Called when tracks are added, removed, reordered, or when track metadata changes.
  * @param callback - Called with the updated queue
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onQueueChanged = NativeUpdatedValue.emitterize<Track[]>(
   (cb) => (nativeBrowser.onPlaybackQueueChanged = cb)

package/src/features/queue/repeatMode.ts

@@ -40,7 +40,7 @@ export interface RepeatModeChangedEvent {
 /**
  * Subscribes to repeat mode changes.
  * @param callback - Called when repeat mode changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRepeatModeChanged =
   NativeUpdatedValue.emitterize<RepeatModeChangedEvent>(

package/src/features/queue/shuffle.ts

@@ -32,7 +32,7 @@ export function toggleShuffle(): void {
 /**
  * Subscribes to shuffle mode changes.
  * @param callback - Called when shuffle mode changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onShuffleChanged = NativeUpdatedValue.emitterize<boolean>(
   (cb) => (nativeBrowser.onPlaybackShuffleModeChanged = cb)

package/src/features/rating.ts

@@ -0,0 +1,17 @@
+export interface HeartRating {
+  hasHeart: boolean
+}
+
+export interface ThumbsRating {
+  isThumbsUp: boolean
+}
+
+export interface StarRating {
+  stars: number
+}
+
+export interface PercentageRating {
+  percentage: number
+}
+
+export type Rating = HeartRating | ThumbsRating | StarRating | PercentageRating

package/src/features/remoteControls.ts

@@ -1,3 +1,9 @@
+import type {
+  HeartRating,
+  PercentageRating,
+  StarRating,
+  ThumbsRating
+} from './rating'
 import { nativeBrowser } from '../native'
 import { LazyNativeEmitter } from '../utils/LazyNativeEmitter'
 
@@ -45,6 +51,13 @@ export interface RemoteSeekEvent {
   position: number
 }
 
+/**
+ * Remote set rating event.
+ */
+export interface RemoteSetRatingEvent {
+  rating: HeartRating | ThumbsRating | StarRating | PercentageRating
+}
+
 /**
  * Remote skip event (Android only).
  */
@@ -53,11 +66,90 @@ export interface RemoteSkipEvent {
   index: number
 }
 
+// MARK: - Default Handlers
+
+// Install remote control handlers with default behavior immediately when module loads
+// Custom handlers can override the defaults using handleRemote* functions
+
+// Basic playback controls
+// AudioBrowser.onRemotePlay(() => {
+//   const customHandler = customHandlers.get('play')
+//   if (customHandler) {
+//     customHandler()
+//   } else {
+//     play()
+//   }
+// })
+
+// AudioBrowser.onRemotePause(() => {
+//   const customHandler = customHandlers.get('pause')
+//   if (customHandler) {
+//     customHandler()
+//   } else {
+//     pause()
+//   }
+// })
+
+// AudioBrowser.onRemoteNext(() => {
+//   const customHandler = customHandlers.get('next')
+//   if (customHandler) {
+//     customHandler()
+//   } else {
+//     skipToNext()
+//   }
+// })
+
+// AudioBrowser.onRemotePrevious(() => {
+//   const customHandler = customHandlers.get('previous')
+//   if (customHandler) {
+//     customHandler()
+//   } else {
+//     skipToPrevious()
+//   }
+// })
+
+// AudioBrowser.onRemoteStop(() => {
+//   const customHandler = customHandlers.get('stop')
+//   if (customHandler) {
+//     customHandler()
+//   } else {
+//     stop()
+//   }
+// })
+
+// // Seek controls
+// AudioBrowser.onRemoteSeek((event: any) => {
+//   const customHandler = customHandlers.get('seek')
+//   if (customHandler) {
+//     customHandler(event)
+//   } else {
+//     seekTo(event.position)
+//   }
+// })
+
+// AudioBrowser.onRemoteJumpForward((event: any) => {
+//   const customHandler = customHandlers.get('jumpForward')
+//   if (customHandler) {
+//     customHandler(event)
+//   } else {
+//     seekBy(event.interval)
+//   }
+// })
+
+// AudioBrowser.onRemoteJumpBackward((event: any) => {
+//   const customHandler = customHandlers.get('jumpBackward')
+//   if (customHandler) {
+//     customHandler(event)
+//   } else {
+//     seekBy(-event.interval)
+//   }
+// })
+
 // MARK: - Handler Override Functions
 //
 // Use these functions when you want to OVERRIDE the default remote control behavior.
 // These will replace the default handlers with your custom logic.
-// If you just want to listen to events for debugging/logging, use the onRemote* emitters below.
+// If you just want to listen to events for debugging/logging, use the onRemote* functions below.
 
 /**
  * Sets a custom handler for remote play events, overriding the default behavior.
@@ -131,7 +223,7 @@ export function handleRemoteJumpBackward(
 
 // MARK: - Event Callbacks (for listening/debugging only)
 //
-// Use these emitters when you want to LISTEN to remote control events without overriding
+// Use these functions when you want to LISTEN to remote control events without overriding
 // the default behavior. These are perfect for logging, analytics, or debugging.
 // Multiple listeners can be registered for the same event.
 // To override the default behavior, use the handleRemote* functions above.
@@ -139,7 +231,7 @@ export function handleRemoteJumpBackward(
 /**
  * Subscribes to remote jump backward events.
  * @param callback - Called when the user presses the jump backward button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteJumpBackward =
   LazyNativeEmitter.emitterize<RemoteJumpBackwardEvent>(
@@ -149,7 +241,7 @@ export const onRemoteJumpBackward =
 /**
  * Subscribes to remote jump forward events.
  * @param callback - Called when the user presses the jump forward button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteJumpForward =
   LazyNativeEmitter.emitterize<RemoteJumpForwardEvent>(
@@ -159,7 +251,7 @@ export const onRemoteJumpForward =
 /**
  * Subscribes to remote next events.
  * @param callback - Called when the user presses the next track button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteNext = LazyNativeEmitter.emitterize<void>(
   (cb) => (nativeBrowser.onRemoteNext = cb)
@@ -168,7 +260,7 @@ export const onRemoteNext = LazyNativeEmitter.emitterize<void>(
 /**
  * Subscribes to remote pause events.
  * @param callback - Called when the user presses the pause button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemotePause = LazyNativeEmitter.emitterize<void>(
   (cb) => (nativeBrowser.onRemotePause = cb)
@@ -177,7 +269,7 @@ export const onRemotePause = LazyNativeEmitter.emitterize<void>(
 /**
  * Subscribes to remote play events.
  * @param callback - Called when the user presses the play button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemotePlay = LazyNativeEmitter.emitterize<void>(
   (cb) => (nativeBrowser.onRemotePlay = cb)
@@ -186,7 +278,7 @@ export const onRemotePlay = LazyNativeEmitter.emitterize<void>(
 /**
  * Subscribes to remote play ID events (Android only).
  * @param callback - Called when the user selects a track from an external device
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemotePlayId = LazyNativeEmitter.emitterize<RemotePlayIdEvent>(
   (cb) => (nativeBrowser.onRemotePlayId = cb)
@@ -195,7 +287,7 @@ export const onRemotePlayId = LazyNativeEmitter.emitterize<RemotePlayIdEvent>(
 /**
  * Subscribes to remote play search events (Android only).
  * @param callback - Called when the user searches for a track (usually voice search)
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemotePlaySearch =
   LazyNativeEmitter.emitterize<RemotePlaySearchEvent>(
@@ -205,7 +297,7 @@ export const onRemotePlaySearch =
 /**
  * Subscribes to remote previous events.
  * @param callback - Called when the user presses the previous track button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemotePrevious = LazyNativeEmitter.emitterize<void>(
   (cb) => (nativeBrowser.onRemotePrevious = cb)
@@ -214,16 +306,26 @@ export const onRemotePrevious = LazyNativeEmitter.emitterize<void>(
 /**
  * Subscribes to remote seek events.
  * @param callback - Called when the user changes the position of the timeline
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteSeek = LazyNativeEmitter.emitterize<RemoteSeekEvent>(
   (cb) => (nativeBrowser.onRemoteSeek = cb)
 )
 
+/**
+ * Subscribes to remote set rating events.
+ * @param callback - Called when the user changes the rating for the track remotely
+ * @returns Cleanup function to unsubscribe
+ */
+export const onRemoteSetRating =
+  LazyNativeEmitter.emitterize<RemoteSetRatingEvent>(
+    (cb) => (nativeBrowser.onRemoteSetRating = cb)
+  )
+
 /**
  * Subscribes to remote skip events (Android only).
  * @param callback - Called when the user presses the skip button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteSkip = LazyNativeEmitter.emitterize<RemoteSkipEvent>(
   (cb) => (nativeBrowser.onRemoteSkip = cb)
@@ -232,7 +334,7 @@ export const onRemoteSkip = LazyNativeEmitter.emitterize<RemoteSkipEvent>(
 /**
  * Subscribes to remote stop events.
  * @param callback - Called when the user presses the stop button
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onRemoteStop = LazyNativeEmitter.emitterize<void>(
   (cb) => (nativeBrowser.onRemoteStop = cb)

package/src/features/sleepTimer.ts

@@ -40,30 +40,11 @@ export function getSleepTimer(): SleepTimer {
 }
 
 /**
- * Options for `setSleepTimer`.
+ * Sets a sleep timer to stop playback after the specified duration.
+ * @param seconds - Number of seconds until playback stops
  */
-export type SleepTimerOptions = {
-  /**
-   * Seconds over which to fade the volume out before the timer completes.
-   * The fade ends exactly at the deadline (clamped to the timer duration if
-   * longer), playback is paused, and the pre-fade volume is restored so the
-   * next play starts at normal loudness. During the fade the timer wins:
-   * skips and seeks play into the remaining ramp; only pausing or
-   * clearing/replacing the timer cancels it.
-   */
-  fadeDuration?: number
-}
-
-/**
- * Sets a sleep timer to pause playback after the specified duration.
- * @param seconds - Number of seconds until playback pauses
- * @param options - Optional fade-out configuration
- */
-export function setSleepTimer(
-  seconds: number,
-  options?: SleepTimerOptions
-): void {
-  nativeBrowser.setSleepTimer(seconds, options?.fadeDuration)
+export function setSleepTimer(seconds: number): void {
+  nativeBrowser.setSleepTimer(seconds)
 }
 
 /**
@@ -86,7 +67,7 @@ export function clearSleepTimer(): boolean {
 /**
  * Subscribes to sleep timer changes.
  * @param callback - Called when the sleep timer state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export const onSleepTimerChanged = NativeUpdatedValue.emitterize<SleepTimer>(
   (cb) => (nativeBrowser.onSleepTimerChanged = cb)

package/src/native.ts

@@ -1,10 +1,5 @@
 import { NitroModules } from 'react-native-nitro-modules'
 import type { AudioBrowser as AudioBrowserSpec } from './specs/audio-browser.nitro.ts'
 
-/**
- * The raw Nitro hybrid object — the bridge itself. Feature modules wrap it;
- * consumers use those wrappers.
- * @internal
- */
 export const nativeBrowser =
   NitroModules.createHybridObject<AudioBrowserSpec>('AudioBrowser')

package/src/native.web.ts

@@ -1,7 +1,4 @@
 import { NativeAudioBrowser } from './web/NativeAudioBrowser'
 
-/**
- * Web implementation: AudioBrowser is a unified browser + player.
- * @internal
- */
+// Web implementation: AudioBrowser is a unified browser + player
 export const nativeBrowser = new NativeAudioBrowser()

package/src/specs/audio-browser.nitro.ts

@@ -12,12 +12,6 @@ import type {
   PlaybackError,
   PlaybackErrorEvent
 } from '../features/errors'
-import type {
-  NativeGate,
-  NativeGateRequest,
-  GateDecision,
-  GateEvent
-} from '../features/gate'
 import type {
   ChapterMetadata,
   NowPlayingMetadata,
@@ -33,9 +27,10 @@ import type {
 } from '../features/playback/progress'
 import type { Playback } from '../features/playback/state'
 import type {
-  NativeSetupPlayerOptions,
   NativeUpdateOptions,
-  Options
+  Options,
+  PartialSetupPlayerOptions,
+  UpdateOptions
 } from '../features/player'
 import type { PlaybackActiveTrackChangedEvent } from '../features/queue/activeTrack'
 import type { PlaybackQueueEndedEvent } from '../features/queue/queue'
@@ -49,6 +44,7 @@ import type {
   RemotePlayIdEvent,
   RemotePlaySearchEvent,
   RemoteSeekEvent,
+  RemoteSetRatingEvent,
   RemoteSkipEvent
 } from '../features/remoteControls'
 import type { SleepTimer, SleepTimerChangedEvent } from '../features/sleepTimer'
@@ -66,46 +62,31 @@ export type EqualizerSettings = {
   upperBandLevelLimit: number
 }
 
-/**
- * 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 OutputType =
-  | 'speaker' // built-in loudspeaker
-  | 'receiver' // built-in earpiece (iOS)
-  | 'headphones' // wired headphones / headset
-  | 'bluetooth' // any Bluetooth audio
-  | 'airplay' // AirPlay (iOS)
-  | 'car' // car audio (CarPlay / Android Auto / car Bluetooth)
+export type IosOutputType =
+  | 'built-in-speaker'
+  | 'built-in-receiver'
+  | 'airplay'
+  | 'bluetooth-a2dp'
+  | 'bluetooth-hfp'
+  | 'bluetooth-le'
+  | 'headphones'
+  | 'car-audio'
   | 'hdmi'
-  | 'usb'
-  | 'cast' // remote speaker / TV (reserved)
+  | 'usb-audio'
   | '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()`.
+ * Audio output information (iOS only).
  */
-export type Output = {
-  /** The output kind */
-  type: OutputType
-  /** Human-readable device name (e.g., "AirPods Pro", "Kitchen speaker") */
+export type IosOutput = {
+  /** The output port type */
+  type: IosOutputType
+  /** Human-readable device name (e.g., "AirPods Pro", "iPhone Speaker") */
   name: string
   /** Whether this is an external output (false for built-in speaker/receiver) */
   external: boolean
 }
 
-/**
- * The Nitro hybrid-object spec — the bridge surface itself. Not consumer API;
- * feature modules wrap every method.
- * @internal
- */
 export interface AudioBrowser extends HybridObject<{
   ios: 'swift'
   android: 'kotlin'
@@ -127,41 +108,13 @@ export interface AudioBrowser extends HybridObject<{
   ) => void
   getFormattedNavigationError(): FormattedNavigationError | undefined
   notifyContentChanged(path: string): void
-  invalidateAllContent(): void
   setFavorites(favorites: string[]): void
   configuration: NativeBrowserConfiguration
 
-  // MARK: gate
-  /**
-   * Records the gate's default chrome (undefined for resolver-only) and whether
-   * a per-request resolver is active. While a gate is set, the four car
-   * enforcement sites consult `resolveGate` per request (skipping the JS hop
-   * when `hasResolver` is false — every request is gated with the default).
-   */
-  setGate(gate: NativeGate | undefined, hasResolver: boolean): void
-  /** Clears the gate, restoring tab content and keeping selection. */
-  clearGate(): void
-  /** Per-request decision, set by JS; native awaits it at a serve site. */
-  resolveGate: (request: NativeGateRequest) => Promise<GateDecision>
-  /** Fired when a request is gated (the gate was served). */
-  onGate: (event: GateEvent) => void
-
-  // MARK: car connection
-  /**
-   * Whether a car is currently connected: a CarPlay scene on iOS, an
-   * Android Auto / Android Automotive connection on Android (via the
-   * androidx.car.app CarConnection provider).
-   */
-  isCarConnected(): boolean
-  /**
-   * Called when the car connects or disconnects.
-   */
-  onCarConnectedChanged: (connected: boolean) => void
-
   // MARK: player init and config
-  setupPlayer(options: NativeSetupPlayerOptions): Promise<void>
+  setupPlayer(options: PartialSetupPlayerOptions): Promise<void>
   updateOptions(options: NativeUpdateOptions): void
-  getOptions(): Options
+  getOptions(): UpdateOptions
 
   // // MARK: player events
   onChapterMetadata: (chapters: ChapterMetadata[]) => void
@@ -174,21 +127,17 @@ export interface AudioBrowser extends HybridObject<{
   ) => void
   onPlaybackPlayingState: (data: PlayingState) => void
   onPlaybackProgressUpdated: (data: PlaybackProgressUpdatedEvent) => void
-  /**
-   * Fired on a fixed internal cadence while playback is `playing`, once enabled
-   * via `setPlaybackIntervalEnabled`. Carries no payload — it is a tick, not a
-   * progress/position update. Independent of `onPlaybackProgressUpdated` and the
-   * `progressUpdateEventInterval` option.
-   */
-  onPlaybackInterval: () => 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
@@ -196,6 +145,7 @@ export interface AudioBrowser extends HybridObject<{
   onRemotePlaySearch: (event: RemotePlaySearchEvent) => void
   onRemotePrevious: () => void
   onRemoteSeek: (event: RemoteSeekEvent) => void
+  onRemoteSetRating: (event: RemoteSetRatingEvent) => void
   onRemoteSkip: (event: RemoteSkipEvent) => void
   onRemoteStop: () => void
   onOptionsChanged: (event: Options) => void
@@ -203,10 +153,13 @@ export interface AudioBrowser extends HybridObject<{
   onNowPlayingChanged: (metadata: NowPlayingMetadata) => void
 
   // MARK: remote handlers
+  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
@@ -228,22 +181,11 @@ export interface AudioBrowser extends HybridObject<{
   getPlayWhenReady(): boolean
   seekTo(position: number): void
   seekBy(offset: number): void
-  /**
-   * Jump to the live edge of the current track. No-op for non-live tracks.
-   * Live with a seekable window (HLS): seeks to the window end. Live without a
-   * window (non-seekable, e.g. ICY): reconnects to rejoin live.
-   */
-  seekToLiveEdge(): void
   setVolume(level: number): void
   getVolume(): number
   setRate(rate: number): void
   getRate(): number
   getProgress(): Progress
-  /**
-   * Enables or disables the internal playback tick that drives
-   * `onPlaybackInterval`. When disabled (default), no tick is emitted.
-   */
-  setPlaybackIntervalEnabled(enabled: boolean): void
   getPlayback(): Playback
   getPlayingState(): PlayingState
   getRepeatMode(): RepeatMode
@@ -253,12 +195,7 @@ export interface AudioBrowser extends HybridObject<{
   getPlaybackError(): PlaybackError | undefined
   retry(): void
   getSleepTimer(): SleepTimer
-  /**
-   * Stops playback after `seconds`. When `fadeDuration` is given, the volume
-   * ramps down over the final `fadeDuration` seconds so silence lands exactly
-   * at the deadline; the pre-fade volume is restored after pausing.
-   */
-  setSleepTimer(seconds: number, fadeDuration?: number): void
+  setSleepTimer(seconds: number): void
   setSleepTimerToEndOfTrack(): void
   clearSleepTimer(): boolean
 
@@ -279,7 +216,7 @@ export interface AudioBrowser extends HybridObject<{
    * Toggles the favorited state of the currently playing track.
    */
   toggleActiveTrackFavorited(): void
-  setQueue(tracks: Track[], startIndex?: number, startPosition?: number): void
+  setQueue(tracks: Track[], startIndex?: number, startPositionMs?: number): void
   getQueue(): Track[]
   getTrack(index: number): Track | undefined
   getActiveTrackIndex(): number | undefined
@@ -291,18 +228,6 @@ export interface AudioBrowser extends HybridObject<{
    * Pass null to clear overrides and revert to track metadata.
    */
   updateNowPlaying(update: NowPlayingUpdate | undefined): void
-  /**
-   * Temporarily replaces now-playing fields for `durationMs`, then reverts.
-   * Outranks the formatter and the `updateNowPlaying` override while active,
-   * and is reverted by a native timer (JS timers pause in a backgrounded
-   * host). Cleared early on track change. Repeated calls restart the window.
-   */
-  flashNowPlaying(update: NowPlayingUpdate, durationMs: number): void
-  /**
-   * Clears an active flash immediately, reverting to the live metadata.
-   * No-op when no flash is active.
-   */
-  clearNowPlayingFlash(): void
   /**
    * Gets the current now playing metadata (override if set, else track metadata).
    */
@@ -327,38 +252,23 @@ export interface AudioBrowser extends HybridObject<{
    */
   onSystemVolumeChanged: (volume: number) => void
 
-  // MARK: external audio output
-  /**
-   * The current audio output, or undefined when unknown. iOS reports one while a
-   * session is active; Android reports the actively-routed media device via
-   * AudioManager — accurate on API 33+ (reflects manual reroutes); on older
-   * Android the `type` is coarse and can't detect a reroute while a device stays
-   * connected.
-   */
-  getOutput(): Output | undefined
+  // MARK: external audio output (iOS only)
   /**
-   * Called when the current audio output changes (headphones unplugged, a
-   * Bluetooth speaker connected, AirPlay/route selected). Fires on iOS and
-   * Android; never on web.
+   * Gets the current audio output info.
+   * Always returns a value on iOS, undefined on Android.
    */
-  onOutputChanged: (output: Output) => void
+  getIosOutput(): IosOutput | undefined
   /**
-   * Presents the system audio output switcher so the listener can move playback
-   * to another output — Bluetooth, AirPlay/Sonos-via-AirPlay, speaker (iOS), or
-   * the Bluetooth / speaker / Cast device list (Android). Cross-platform.
-   *
-   * iOS: the system route picker (always available).
-   * Android: the system Output Switcher (Android 11+); no-op below that — gate
-   * on `supportsOutputSwitcher()`.
-   * Web: no-op.
+   * Called when audio output changes (iOS only).
+   * Never fires on Android.
    */
-  openOutputPicker(): void
+  onIosOutputChanged: (output: IosOutput) => void
   /**
-   * Whether `openOutputPicker()` can present a system output switcher on this
-   * device — surface the output control in the UI only when this is true.
-   * iOS: true. Android: true on Android 11+ (API 30). Web: false.
+   * Opens the system output picker (iOS only).
+   * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
+   * No-op on Android.
    */
-  supportsOutputSwitcher(): boolean
+  openIosOutputPicker(): void
 
   // MARK: equalizer (Android only)
   getEqualizerSettings(): EqualizerSettings | undefined