react-native-audio-browser 0.2.0-next.54 → 0.2.0-next.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/README.md +32 -19
  2. package/lib/commonjs/CLAUDE.md +7 -2
  3. package/lib/commonjs/features/battery.js +16 -12
  4. package/lib/commonjs/features/battery.js.map +1 -1
  5. package/lib/commonjs/features/browser-config.js +1 -1
  6. package/lib/commonjs/features/browser.js +74 -24
  7. package/lib/commonjs/features/browser.js.map +1 -1
  8. package/lib/commonjs/features/carConnection.js +3 -4
  9. package/lib/commonjs/features/carConnection.js.map +1 -1
  10. package/lib/commonjs/features/equalizer.js +9 -5
  11. package/lib/commonjs/features/equalizer.js.map +1 -1
  12. package/lib/commonjs/features/errors.js +35 -21
  13. package/lib/commonjs/features/errors.js.map +1 -1
  14. package/lib/commonjs/features/favorites.js +15 -13
  15. package/lib/commonjs/features/favorites.js.map +1 -1
  16. package/lib/commonjs/features/gate.js +12 -6
  17. package/lib/commonjs/features/gate.js.map +1 -1
  18. package/lib/commonjs/features/metadata.js +16 -14
  19. package/lib/commonjs/features/metadata.js.map +1 -1
  20. package/lib/commonjs/features/network.js +5 -1
  21. package/lib/commonjs/features/network.js.map +1 -1
  22. package/lib/commonjs/features/nowPlaying.js +28 -14
  23. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  24. package/lib/commonjs/features/output.js +8 -4
  25. package/lib/commonjs/features/output.js.map +1 -1
  26. package/lib/commonjs/features/playback/controls.js +10 -5
  27. package/lib/commonjs/features/playback/controls.js.map +1 -1
  28. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  29. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  30. package/lib/commonjs/features/playback/playing.js +5 -3
  31. package/lib/commonjs/features/playback/playing.js.map +1 -1
  32. package/lib/commonjs/features/playback/progress.js +11 -5
  33. package/lib/commonjs/features/playback/progress.js.map +1 -1
  34. package/lib/commonjs/features/playback/state.js +3 -3
  35. package/lib/commonjs/features/playback/state.js.map +1 -1
  36. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  37. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  38. package/lib/commonjs/features/playback/volume.js +6 -5
  39. package/lib/commonjs/features/playback/volume.js.map +1 -1
  40. package/lib/commonjs/features/player/options.js +20 -10
  41. package/lib/commonjs/features/player/options.js.map +1 -1
  42. package/lib/commonjs/features/player/setup.js +34 -38
  43. package/lib/commonjs/features/player/setup.js.map +1 -1
  44. package/lib/commonjs/features/queue/activeTrack.js +0 -1
  45. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  46. package/lib/commonjs/features/queue/queue.js +48 -20
  47. package/lib/commonjs/features/queue/queue.js.map +1 -1
  48. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  49. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  50. package/lib/commonjs/features/queue/shuffle.js +0 -1
  51. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  52. package/lib/commonjs/features/remoteControls.js +59 -35
  53. package/lib/commonjs/features/remoteControls.js.map +1 -1
  54. package/lib/commonjs/features/sleepTimer.js +15 -6
  55. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  56. package/lib/commonjs/utils/LazyNativeEmitter.js +6 -9
  57. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  58. package/lib/commonjs/utils/NativeUpdatedValue.js +13 -12
  59. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  60. package/lib/commonjs/utils/getTrackIdentity.js +6 -4
  61. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -1
  62. package/lib/commonjs/utils/useDebug.js +16 -3
  63. package/lib/commonjs/utils/useDebug.js.map +1 -1
  64. package/lib/commonjs/web/NativeAudioBrowser.js +2 -4
  65. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  66. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  67. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  68. package/lib/commonjs/web/browser/sections.js +1 -1
  69. package/lib/commonjs/web/util/BrowserPathHelper.js +1 -3
  70. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  71. package/lib/module/CLAUDE.md +7 -2
  72. package/lib/module/features/battery.js +16 -12
  73. package/lib/module/features/battery.js.map +1 -1
  74. package/lib/module/features/browser-config.js +1 -1
  75. package/lib/module/features/browser.js +74 -24
  76. package/lib/module/features/browser.js.map +1 -1
  77. package/lib/module/features/carConnection.js +3 -4
  78. package/lib/module/features/carConnection.js.map +1 -1
  79. package/lib/module/features/equalizer.js +9 -5
  80. package/lib/module/features/equalizer.js.map +1 -1
  81. package/lib/module/features/errors.js +35 -21
  82. package/lib/module/features/errors.js.map +1 -1
  83. package/lib/module/features/favorites.js +15 -13
  84. package/lib/module/features/favorites.js.map +1 -1
  85. package/lib/module/features/gate.js +12 -6
  86. package/lib/module/features/gate.js.map +1 -1
  87. package/lib/module/features/metadata.js +16 -14
  88. package/lib/module/features/metadata.js.map +1 -1
  89. package/lib/module/features/network.js +5 -1
  90. package/lib/module/features/network.js.map +1 -1
  91. package/lib/module/features/nowPlaying.js +28 -14
  92. package/lib/module/features/nowPlaying.js.map +1 -1
  93. package/lib/module/features/output.js +8 -4
  94. package/lib/module/features/output.js.map +1 -1
  95. package/lib/module/features/playback/controls.js +10 -5
  96. package/lib/module/features/playback/controls.js.map +1 -1
  97. package/lib/module/features/playback/playWhenReady.js +6 -5
  98. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  99. package/lib/module/features/playback/playing.js +5 -3
  100. package/lib/module/features/playback/playing.js.map +1 -1
  101. package/lib/module/features/playback/progress.js +11 -5
  102. package/lib/module/features/playback/progress.js.map +1 -1
  103. package/lib/module/features/playback/state.js +3 -3
  104. package/lib/module/features/playback/state.js.map +1 -1
  105. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  106. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  107. package/lib/module/features/playback/volume.js +6 -5
  108. package/lib/module/features/playback/volume.js.map +1 -1
  109. package/lib/module/features/player/options.js +20 -10
  110. package/lib/module/features/player/options.js.map +1 -1
  111. package/lib/module/features/player/setup.js +34 -38
  112. package/lib/module/features/player/setup.js.map +1 -1
  113. package/lib/module/features/queue/activeTrack.js +0 -1
  114. package/lib/module/features/queue/activeTrack.js.map +1 -1
  115. package/lib/module/features/queue/queue.js +48 -20
  116. package/lib/module/features/queue/queue.js.map +1 -1
  117. package/lib/module/features/queue/repeatMode.js +2 -1
  118. package/lib/module/features/queue/repeatMode.js.map +1 -1
  119. package/lib/module/features/queue/shuffle.js +0 -1
  120. package/lib/module/features/queue/shuffle.js.map +1 -1
  121. package/lib/module/features/remoteControls.js +59 -35
  122. package/lib/module/features/remoteControls.js.map +1 -1
  123. package/lib/module/features/sleepTimer.js +15 -6
  124. package/lib/module/features/sleepTimer.js.map +1 -1
  125. package/lib/module/utils/LazyNativeEmitter.js +6 -9
  126. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  127. package/lib/module/utils/NativeUpdatedValue.js +13 -12
  128. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  129. package/lib/module/utils/getTrackIdentity.js +6 -4
  130. package/lib/module/utils/getTrackIdentity.js.map +1 -1
  131. package/lib/module/utils/useDebug.js +16 -3
  132. package/lib/module/utils/useDebug.js.map +1 -1
  133. package/lib/module/web/NativeAudioBrowser.js +2 -4
  134. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  135. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  136. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  137. package/lib/module/web/browser/sections.js +1 -1
  138. package/lib/module/web/util/BrowserPathHelper.js +1 -3
  139. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  140. package/lib/typescript/src/features/battery.d.ts +17 -12
  141. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  142. package/lib/typescript/src/features/browser.d.ts +64 -24
  143. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  144. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  145. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  146. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  147. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  148. package/lib/typescript/src/features/errors.d.ts +37 -22
  149. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  150. package/lib/typescript/src/features/favorites.d.ts +15 -13
  151. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  152. package/lib/typescript/src/features/gate.d.ts +14 -8
  153. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  154. package/lib/typescript/src/features/metadata.d.ts +37 -17
  155. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  156. package/lib/typescript/src/features/network.d.ts +5 -1
  157. package/lib/typescript/src/features/network.d.ts.map +1 -1
  158. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  159. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  160. package/lib/typescript/src/features/output.d.ts +8 -4
  161. package/lib/typescript/src/features/output.d.ts.map +1 -1
  162. package/lib/typescript/src/features/playback/controls.d.ts +10 -5
  163. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  164. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  165. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  166. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  167. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  168. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  169. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  170. package/lib/typescript/src/features/playback/state.d.ts +8 -3
  171. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  172. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  173. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  174. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  175. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  176. package/lib/typescript/src/features/player/options.d.ts +52 -37
  177. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  178. package/lib/typescript/src/features/player/setup.d.ts +65 -60
  179. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  180. package/lib/typescript/src/features/queue/activeTrack.d.ts +0 -1
  181. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  182. package/lib/typescript/src/features/queue/queue.d.ts +48 -20
  183. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  184. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  185. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  186. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  187. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  188. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  189. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  190. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  191. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  192. package/lib/typescript/src/types/browser-nodes.d.ts +54 -57
  193. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  194. package/lib/typescript/src/types/browser.d.ts +181 -144
  195. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  196. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +6 -9
  197. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  198. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +13 -12
  199. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  200. package/lib/typescript/src/utils/getTrackIdentity.d.ts +6 -4
  201. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -1
  202. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  203. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  204. package/package.json +1 -1
  205. package/src/CLAUDE.md +7 -2
  206. package/src/docs-floors.test.ts +71 -0
  207. package/src/features/battery.ts +17 -13
  208. package/src/features/browser-config.ts +1 -1
  209. package/src/features/browser.ts +65 -24
  210. package/src/features/carConnection.ts +3 -4
  211. package/src/features/equalizer.ts +9 -5
  212. package/src/features/errors.ts +37 -22
  213. package/src/features/favorites.ts +15 -13
  214. package/src/features/gate.ts +14 -8
  215. package/src/features/metadata.ts +37 -17
  216. package/src/features/network.ts +5 -1
  217. package/src/features/nowPlaying.ts +28 -14
  218. package/src/features/output.ts +8 -4
  219. package/src/features/playback/controls.ts +10 -5
  220. package/src/features/playback/playWhenReady.ts +6 -5
  221. package/src/features/playback/playing.ts +16 -3
  222. package/src/features/playback/progress.ts +11 -5
  223. package/src/features/playback/state.ts +8 -3
  224. package/src/features/playback/trackPlaybackTime.ts +9 -2
  225. package/src/features/playback/volume.ts +6 -5
  226. package/src/features/player/options.ts +54 -43
  227. package/src/features/player/setup.ts +67 -61
  228. package/src/features/queue/activeTrack.ts +0 -1
  229. package/src/features/queue/queue.ts +48 -20
  230. package/src/features/queue/repeatMode.ts +1 -1
  231. package/src/features/queue/shuffle.ts +0 -1
  232. package/src/features/remoteControls.ts +59 -35
  233. package/src/features/sleepTimer.ts +15 -7
  234. package/src/types/browser-nodes.ts +54 -57
  235. package/src/types/browser.ts +183 -146
  236. package/src/utils/LazyNativeEmitter.ts +6 -9
  237. package/src/utils/NativeUpdatedValue.ts +13 -12
  238. package/src/utils/getTrackIdentity.ts +6 -4
  239. package/src/utils/useDebug.ts +16 -3
  240. package/src/web/NativeAudioBrowser.ts +2 -4
  241. package/src/web/browser/parseSearchResponse.ts +3 -4
  242. package/src/web/browser/sections.ts +1 -1
  243. package/src/web/util/BrowserPathHelper.ts +1 -3
  244. package/website/guide/android-auto.md +25 -13
  245. package/website/guide/android-certificates.md +199 -120
  246. package/website/guide/artwork.md +93 -48
  247. package/website/guide/audio-output.md +86 -68
  248. package/website/guide/automotive.md +15 -10
  249. package/website/guide/basic-usage.md +5 -2
  250. package/website/guide/battery.md +50 -23
  251. package/website/guide/browser.md +155 -68
  252. package/website/guide/carplay.md +132 -49
  253. package/website/guide/configuration.md +85 -49
  254. package/website/guide/equalizer.md +36 -32
  255. package/website/guide/errors.md +106 -64
  256. package/website/guide/favorites.md +41 -31
  257. package/website/guide/gate.md +24 -10
  258. package/website/guide/getting-started.md +55 -2
  259. package/website/guide/hooks.md +53 -47
  260. package/website/guide/live-streams.md +80 -49
  261. package/website/guide/metadata.md +87 -53
  262. package/website/guide/migrating-from-track-player.md +94 -49
  263. package/website/guide/native-callback-fetch.md +46 -36
  264. package/website/guide/network.md +36 -20
  265. package/website/guide/now-playing.md +72 -44
  266. package/website/guide/playback.md +112 -35
  267. package/website/guide/queue.md +77 -43
  268. package/website/guide/remote-controls.md +87 -29
  269. package/website/guide/search.md +37 -22
  270. package/website/guide/sleep-timer.md +35 -14
  271. package/website/guide/track.md +59 -35
@@ -27,18 +27,24 @@ export function getProgress() {
27
27
  // MARK: - Event Callbacks
28
28
 
29
29
  /**
30
- * Subscribes to playback progress updates.
31
- * @param callback - Called periodically with playback progress updates
32
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
30
+ * Emits the progress every `progressUpdateEventInterval` seconds while the
31
+ * player is loading, buffering or playing. Off by default (the interval is
32
+ * `null`). Subscribe with `onProgressUpdated.addListener(cb)`, which returns
33
+ * an unsubscribe function.
33
34
  */
34
35
  export const onProgressUpdated = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackProgressUpdated = cb);
35
36
 
36
37
  // MARK: - Hooks
37
38
 
38
39
  /**
39
- * Hook that returns the current playback progress and updates when it changes.
40
+ * Hook that returns the current playback progress and updates on each
41
+ * progress event.
40
42
  *
41
- * Progress update frequency is controlled globally via `updateOptions({ progressUpdateEventInterval })`.
43
+ * Progress events are off by default (`progressUpdateEventInterval: null`), so
44
+ * this hook does not update until you set an interval in `setupPlayer` or
45
+ * `updateOptions`. Events fire only while loading, buffering or playing, so a
46
+ * seek while paused does not show. For updates without configuration, use
47
+ * {@link usePolledProgress}.
42
48
  * @returns The current playback progress
43
49
  */
44
50
  export function useProgress() {
@@ -1 +1 @@
1
- {"version":3,"names":["useEffect","useState","AppState","nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","onPlaybackChanged","getProgress","onProgressUpdated","emitterize","cb","onPlaybackProgressUpdated","useProgress","usePolledProgress","updateInterval","state","setState","position","duration","buffered","timer","unsubscribeState","update","currentState","poll","setTimeout","start","undefined","addListener","stop","clearTimeout","appStateSub","addEventListener","next","remove"],"sourceRoot":"../../../../src","sources":["features/playback/progress.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["useEffect","useState","AppState","nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","onPlaybackChanged","getProgress","onProgressUpdated","emitterize","cb","onPlaybackProgressUpdated","useProgress","usePolledProgress","updateInterval","state","setState","position","duration","buffered","timer","unsubscribeState","update","currentState","poll","setTimeout","start","undefined","addListener","stop","clearTimeout","appStateSub","addEventListener","next","remove"],"sourceRoot":"../../../../src","sources":["features/playback/progress.ts"],"mappings":"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","ignoreList":[]}
@@ -38,9 +38,9 @@ export function getPlayback() {
38
38
  // MARK: - Event Callbacks
39
39
 
40
40
  /**
41
- * Subscribes to playback state changes.
42
- * @param callback - Called when the playback state changes
43
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
41
+ * Emits the {@link Playback} each time the playback state or error changes.
42
+ * Subscribe with `onPlaybackChanged.addListener(cb)`, which returns an
43
+ * unsubscribe function.
44
44
  */
45
45
  export const onPlaybackChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackChanged = cb);
46
46
 
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlayback","onPlaybackChanged","emitterize","cb","usePlayback"],"sourceRoot":"../../../../src","sources":["features/playback/state.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOH,aAAa,CAACG,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGH,kBAAkB,CAACI,UAAU,CAC3DC,EAAE,IAAMN,aAAa,CAACI,iBAAiB,GAAGE,EAC7C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOL,qBAAqB,CAACC,WAAW,EAAEC,iBAAiB,CAAC;AAC9D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlayback","onPlaybackChanged","emitterize","cb","usePlayback"],"sourceRoot":"../../../../src","sources":["features/playback/state.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOH,aAAa,CAACG,WAAW,CAAC,CAAC;AACpC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGH,kBAAkB,CAACI,UAAU,CAC3DC,EAAE,IAAMN,aAAa,CAACI,iBAAiB,GAAGE,EAC7C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAa;EACtC,OAAOL,qBAAqB,CAACC,WAAW,EAAEC,iBAAiB,CAAC;AAC9D","ignoreList":[]}
@@ -5,6 +5,8 @@ import { onActiveTrackChanged } from '../queue/activeTrack';
5
5
 
6
6
  // MARK: - Types
7
7
 
8
+ /** What a {@link trackPlaybackTime} callback receives each period. */
9
+
8
10
  // MARK: - State
9
11
 
10
12
  const handles = new Set();
@@ -56,8 +58,11 @@ function install() {
56
58
  * subscribe to {@link onActiveTrackChanged} and cancel + re-subscribe here on each
57
59
  * change, so every track gets a fresh `total` starting at zero.
58
60
  *
61
+ * On Android, subscribe after `setupPlayer` resolves. After a service restart
62
+ * no callback fires until every subscription is cancelled and a new one is made.
63
+ *
59
64
  * @param callback Invoked once per elapsed `period`, with cumulative play time
60
- * and the currently playing track.
65
+ * and the active track (see {@link PlaybackElapsed.track}).
61
66
  * @param period Seconds of playback between calls. Must be >= 1.
62
67
  * @returns A function that cancels this subscription (idempotent — safe to call
63
68
  * more than once).
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","onActiveTrackChanged","handles","Set","installed","currentTrack","onTick","handle","totalSeconds","sinceLast","lastFireSeconds","period","callback","total","track","install","onPlaybackInterval","addListener","event","trackPlaybackTime","Error","add","size","setPlaybackIntervalEnabled","delete"],"sourceRoot":"../../../../src","sources":["features/playback/trackPlaybackTime.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,oBAAoB,QAAQ,sBAAsB;;AAE3D;;AAkBA;;AAEA,MAAMC,OAAO,GAAG,IAAIC,GAAG,CAAS,CAAC;AACjC,IAAIC,SAAS,GAAG,KAAK;AACrB,IAAIC,YAA+B;;AAEnC;AACA;AACA;AACA,SAASC,MAAMA,CAAA,EAAG;EAChB,KAAK,MAAMC,MAAM,IAAIL,OAAO,EAAE;IAC5BK,MAAM,CAACC,YAAY,IAAI,CAAC;IACxB,MAAMC,SAAS,GAAGF,MAAM,CAACC,YAAY,GAAGD,MAAM,CAACG,eAAe;IAC9D,IAAID,SAAS,IAAIF,MAAM,CAACI,MAAM,EAAE;MAC9BJ,MAAM,CAACG,eAAe,GAAGH,MAAM,CAACC,YAAY;MAC5CD,MAAM,CAACK,QAAQ,CAAC;QACdC,KAAK,EAAEN,MAAM,CAACC,YAAY;QAC1BC,SAAS;QACTK,KAAK,EAAET;MACT,CAAC,CAAC;IACJ;EACF;AACF;AAEA,SAASU,OAAOA,CAAA,EAAG;EACjB,IAAIX,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBJ,aAAa,CAACgB,kBAAkB,GAAGV,MAAM;EACzCL,oBAAoB,CAACgB,WAAW,CAAEC,KAAK,IAAK;IAC1Cb,YAAY,GAAGa,KAAK,CAACJ,KAAK;EAC5B,CAAC,CAAC;AACJ;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAC/BP,QAA4C,EAC5CD,MAAc,EACF;EACZ,IAAI,EAAEA,MAAM,IAAI,CAAC,CAAC,EAAE;IAClB,MAAM,IAAIS,KAAK,CAAC,wCAAwC,CAAC;EAC3D;EACAL,OAAO,CAAC,CAAC;EACT,MAAMR,MAAc,GAAG;IACrBI,MAAM;IACNH,YAAY,EAAE,CAAC;IACfE,eAAe,EAAE,CAAC;IAClBE;EACF,CAAC;EACDV,OAAO,CAACmB,GAAG,CAACd,MAAM,CAAC;EACnB,IAAIL,OAAO,CAACoB,IAAI,KAAK,CAAC,EAAEtB,aAAa,CAACuB,0BAA0B,CAAC,IAAI,CAAC;EACtE,OAAO,MAAM;IACX,IAAI,CAACrB,OAAO,CAACsB,MAAM,CAACjB,MAAM,CAAC,EAAE;IAC7B,IAAIL,OAAO,CAACoB,IAAI,KAAK,CAAC,EAAEtB,aAAa,CAACuB,0BAA0B,CAAC,KAAK,CAAC;EACzE,CAAC;AACH","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","onActiveTrackChanged","handles","Set","installed","currentTrack","onTick","handle","totalSeconds","sinceLast","lastFireSeconds","period","callback","total","track","install","onPlaybackInterval","addListener","event","trackPlaybackTime","Error","add","size","setPlaybackIntervalEnabled","delete"],"sourceRoot":"../../../../src","sources":["features/playback/trackPlaybackTime.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,oBAAoB,QAAQ,sBAAsB;;AAE3D;;AAEA;;AAoBA;;AAEA,MAAMC,OAAO,GAAG,IAAIC,GAAG,CAAS,CAAC;AACjC,IAAIC,SAAS,GAAG,KAAK;AACrB,IAAIC,YAA+B;;AAEnC;AACA;AACA;AACA,SAASC,MAAMA,CAAA,EAAG;EAChB,KAAK,MAAMC,MAAM,IAAIL,OAAO,EAAE;IAC5BK,MAAM,CAACC,YAAY,IAAI,CAAC;IACxB,MAAMC,SAAS,GAAGF,MAAM,CAACC,YAAY,GAAGD,MAAM,CAACG,eAAe;IAC9D,IAAID,SAAS,IAAIF,MAAM,CAACI,MAAM,EAAE;MAC9BJ,MAAM,CAACG,eAAe,GAAGH,MAAM,CAACC,YAAY;MAC5CD,MAAM,CAACK,QAAQ,CAAC;QACdC,KAAK,EAAEN,MAAM,CAACC,YAAY;QAC1BC,SAAS;QACTK,KAAK,EAAET;MACT,CAAC,CAAC;IACJ;EACF;AACF;AAEA,SAASU,OAAOA,CAAA,EAAG;EACjB,IAAIX,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBJ,aAAa,CAACgB,kBAAkB,GAAGV,MAAM;EACzCL,oBAAoB,CAACgB,WAAW,CAAEC,KAAK,IAAK;IAC1Cb,YAAY,GAAGa,KAAK,CAACJ,KAAK;EAC5B,CAAC,CAAC;AACJ;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAC/BP,QAA4C,EAC5CD,MAAc,EACF;EACZ,IAAI,EAAEA,MAAM,IAAI,CAAC,CAAC,EAAE;IAClB,MAAM,IAAIS,KAAK,CAAC,wCAAwC,CAAC;EAC3D;EACAL,OAAO,CAAC,CAAC;EACT,MAAMR,MAAc,GAAG;IACrBI,MAAM;IACNH,YAAY,EAAE,CAAC;IACfE,eAAe,EAAE,CAAC;IAClBE;EACF,CAAC;EACDV,OAAO,CAACmB,GAAG,CAACd,MAAM,CAAC;EACnB,IAAIL,OAAO,CAACoB,IAAI,KAAK,CAAC,EAAEtB,aAAa,CAACuB,0BAA0B,CAAC,IAAI,CAAC;EACtE,OAAO,MAAM;IACX,IAAI,CAACrB,OAAO,CAACsB,MAAM,CAACjB,MAAM,CAAC,EAAE;IAC7B,IAAIL,OAAO,CAACoB,IAAI,KAAK,CAAC,EAAEtB,aAAa,CAACuB,0BAA0B,CAAC,KAAK,CAAC;EACzE,CAAC;AACH","ignoreList":[]}
@@ -14,7 +14,7 @@ export function getVolume() {
14
14
  }
15
15
 
16
16
  /**
17
- * Gets the current system volume as a number between 0 and 1.
17
+ * Gets the current system volume as a number between 0 and 1. On web, always 1.
18
18
  */
19
19
  export function getSystemVolume() {
20
20
  return nativeBrowser.getSystemVolume();
@@ -33,7 +33,7 @@ export function setVolume(level) {
33
33
  /**
34
34
  * Sets the system volume.
35
35
  * @param level - The volume as a number between 0 and 1.
36
- * @remarks On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
36
+ * @remarks A no-op on iOS, which has no public API for it, and on web.
37
37
  */
38
38
  export function setSystemVolume(level) {
39
39
  nativeBrowser.setSystemVolume(level);
@@ -42,9 +42,9 @@ export function setSystemVolume(level) {
42
42
  // MARK: - Event Callbacks
43
43
 
44
44
  /**
45
- * Subscribes to system volume changes.
46
- * @param callback - Called when the system volume changes
47
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
45
+ * Emits the system volume (0 to 1) each time it changes. Never fires on web.
46
+ * Subscribe with `onSystemVolumeChanged.addListener(cb)`, which returns an
47
+ * unsubscribe function.
48
48
  */
49
49
  export const onSystemVolumeChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onSystemVolumeChanged = cb);
50
50
 
@@ -52,6 +52,7 @@ export const onSystemVolumeChanged = NativeUpdatedValue.emitterize(cb => nativeB
52
52
 
53
53
  /**
54
54
  * Hook that returns the current system volume and updates when it changes.
55
+ * On web, always 1.
55
56
  * @returns The current system volume (0 to 1)
56
57
  */
57
58
  export function useSystemVolume() {
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getVolume","getSystemVolume","setVolume","level","setSystemVolume","onSystemVolumeChanged","emitterize","cb","useSystemVolume"],"sourceRoot":"../../../../src","sources":["features/playback/volume.ts"],"mappings":";;AAAA;;AAEA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAW;EAClC,OAAOH,aAAa,CAACG,SAAS,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAOJ,aAAa,CAACI,eAAe,CAAC,CAAC;AACxC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,KAAa,EAAQ;EAC7CN,aAAa,CAACK,SAAS,CAACC,KAAK,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACD,KAAa,EAAQ;EACnDN,aAAa,CAACO,eAAe,CAACD,KAAK,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,qBAAqB,GAAGP,kBAAkB,CAACQ,UAAU,CAC/DC,EAAE,IAAMV,aAAa,CAACQ,qBAAqB,GAAGE,EACjD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAOT,qBAAqB,CAACE,eAAe,EAAEI,qBAAqB,CAAC;AACtE","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getVolume","getSystemVolume","setVolume","level","setSystemVolume","onSystemVolumeChanged","emitterize","cb","useSystemVolume"],"sourceRoot":"../../../../src","sources":["features/playback/volume.ts"],"mappings":";;AAAA;;AAEA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAW;EAClC,OAAOH,aAAa,CAACG,SAAS,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAOJ,aAAa,CAACI,eAAe,CAAC,CAAC;AACxC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,KAAa,EAAQ;EAC7CN,aAAa,CAACK,SAAS,CAACC,KAAK,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACD,KAAa,EAAQ;EACnDN,aAAa,CAACO,eAAe,CAACD,KAAK,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,qBAAqB,GAAGP,kBAAkB,CAACQ,UAAU,CAC/DC,EAAE,IAAMV,aAAa,CAACQ,qBAAqB,GAAGE,EACjD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAW;EACxC,OAAOT,qBAAqB,CAACE,eAAe,EAAEI,qBAAqB,CAAC;AACtE","ignoreList":[]}
@@ -91,26 +91,27 @@ import { validateIOSUpdateOptions } from './validateOptions';
91
91
  * AppKilledPlaybackBehavior options:
92
92
  * - `'continue-playback'`: This option will continue playing audio in the
93
93
  * background when the app is removed from recents. The notification remains.
94
- * This is the default.
95
94
  * - `'pause-playback'`: This option will pause playing audio in the background
96
95
  * when the app is removed from recents. The notification remains and can be
97
96
  * used to resume playback.
98
97
  * - `'stop-playback-and-remove-notification'`: This option will stop playing
99
98
  * audio in the background when the app is removed from recents. The
100
99
  * notification is removed and can't be used to resume playback. Users would
101
- * need to open the app again to start playing audio.
100
+ * need to open the app again to start playing audio. This is the default.
102
101
  */
103
102
 
104
103
  /**
105
- * Current player options with resolved defaults.
106
- * This is what you receive from getOptions() - all properties are present with their current values.
104
+ * Current player options, as {@link getOptions} reports them. The intervals and the platform
105
+ * block come with their defaults filled in; `capabilities` holds the values set, plus,
106
+ * on Android and iOS, `jumpForward` and `jumpBackward`, which are `false` until set.
107
107
  * Platform-specific properties (android/ios) are only available on their respective platforms.
108
108
  *
109
109
  * @example
110
110
  * ```typescript
111
111
  * const options = getOptions();
112
112
  * console.log(options.forwardJumpInterval); // 15
113
- * console.log(options.capabilities); // { shuffleMode: false } - only disabled caps shown
113
+ * console.log(options.capabilities);
114
+ * // { jumpForward: false, jumpBackward: false, shuffleMode: false }
114
115
  * console.log(options.android?.skipSilence); // true (Android only)
115
116
  * ```
116
117
  */
@@ -120,6 +121,16 @@ import { validateIOSUpdateOptions } from './validateOptions';
120
121
  * Only present on iOS.
121
122
  */
122
123
 
124
+ /**
125
+ * Android runtime options as {@link getOptions} reports them.
126
+ * @platform android
127
+ */
128
+
129
+ /**
130
+ * Android options {@link updateOptions} can change at runtime.
131
+ * @platform android
132
+ */
133
+
123
134
  /**
124
135
  * Wire shape of {@link AndroidUpdateOptions} — what crosses the Nitro bridge.
125
136
  * @internal
@@ -189,10 +200,10 @@ export function updateOptions(options) {
189
200
  // MARK: - Getters
190
201
 
191
202
  /**
192
- * Gets the current player options with resolved defaults.
193
- * Returns all current option values - use this to read the current state.
203
+ * Gets the current player options. `capabilities` holds the values set, plus, on Android
204
+ * and iOS, `jumpForward` and `jumpBackward` (`false` until set); a missing capability
205
+ * means its default.
194
206
  *
195
- * @returns The current player options with all properties resolved to their current values
196
207
  * @example
197
208
  * ```typescript
198
209
  * const options = getOptions();
@@ -208,8 +219,7 @@ export function getOptions() {
208
219
  // MARK: - Event Callbacks
209
220
 
210
221
  /**
211
- * Subscribes to player options changes.
212
- * @param callback - Called when the player options change
222
+ * Emits each time the player options change.
213
223
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
214
224
  */
215
225
  export const onOptionsChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOptionsChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","validateIOSUpdateOptions","updateOptions","options","ios","getOptions","onOptionsChanged","emitterize","cb","useOptions"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;AAIA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;AACzE,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuFA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA4CA;AACA;AACA;AACA;;AAmFA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAoCA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuDA;AACA;AACA;AACA;;AAwCA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAsB,EAAQ;EAC1DF,wBAAwB,CAACE,OAAO,CAACC,GAAG,CAAC;EACrCN,aAAa,CAACI,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOP,aAAa,CAACO,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,GAAGP,kBAAkB,CAACQ,UAAU,CAC1DC,EAAE,IAAMV,aAAa,CAACQ,gBAAgB,GAAGE,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOT,qBAAqB,CAACK,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","validateIOSUpdateOptions","updateOptions","options","ios","getOptions","onOptionsChanged","emitterize","cb","useOptions"],"sourceRoot":"../../../../src","sources":["features/player/options.ts"],"mappings":";;AAIA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;AACzE,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyFA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgDA;AACA;AACA;AACA;;AA6BA;AACA;AACA;AACA;;AA6BA;AACA;AACA;AACA;;AA6BA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAqCA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAqDA;AACA;AACA;AACA;;AAoCA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAsB,EAAQ;EAC1DF,wBAAwB,CAACE,OAAO,CAACC,GAAG,CAAC;EACrCN,aAAa,CAACI,aAAa,CAACC,OAAO,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOP,aAAa,CAACO,UAAU,CAAC,CAAC;AACnC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,GAAGP,kBAAkB,CAACQ,UAAU,CAC1DC,EAAE,IAAMV,aAAa,CAACQ,gBAAgB,GAAGE,EAC5C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOT,qBAAqB,CAACK,UAAU,EAAEC,gBAAgB,CAAC;AAC5D","ignoreList":[]}
@@ -9,8 +9,8 @@ import { validateIOSUpdateOptions } from './validateOptions';
9
9
  * Parameters passed to the {@link FormatNowPlayingCallback}.
10
10
  *
11
11
  * The formatter owns every line shown on the now-playing surface — the track text, the live song,
12
- * *and* any transient status (reconnecting / error). The library no longer renders status copy
13
- * itself, so these fields give you what you need to render (and localize) it yourself. The formatter
12
+ * *and* any transient status (reconnecting / error). The library renders no status text; these
13
+ * fields let you render (and localize) it yourself. The formatter
14
14
  * is re-invoked on track change, each timed-metadata update, play/pause + error/rebuffer
15
15
  * transitions, and device connectivity changes.
16
16
  */
@@ -25,44 +25,28 @@ import { validateIOSUpdateOptions } from './validateOptions';
25
25
  * Customizes what's rendered on the now-playing surface — lock screen, notification, Control Center,
26
26
  * CarPlay, and Android Auto — for the currently playing track.
27
27
  *
28
- * Configure it via {@link SetupPlayerOptions.nowPlaying}. Where the default behavior
29
- * simply publishes the track's own `title` / `artist`, the formatter hands you the two now-playing
30
- * text lines outright: render the live timed metadata (the ICY / ID3 "now playing song"), surface a
31
- * transient status line ("Reconnecting…", an error message), drop the song while paused — anything
32
- * you can derive from the {@link FormatNowPlayingParams} for that moment.
28
+ * Configure it via {@link SetupPlayerOptions.nowPlaying}. It is re-invoked on track change, each
29
+ * timed-metadata update and every playback transition; identical results are de-duplicated
30
+ * natively, so they don't flicker the surface.
33
31
  *
34
- * The callback is **synchronous** and should stay cheap: it's a pure formatting function, run on the
35
- * JS thread and awaited natively. Don't do I/O in it. If you need asynchronously-fetched data (e.g.
36
- * album art), resolve it out-of-band and stamp it imperatively rather than awaiting inside here.
37
- *
38
- * ### When it's invoked
39
- * The player re-invokes the formatter whenever the now-playing could change:
40
- * - on track change (a new item becomes current);
41
- * - on each timed-metadata update ({@link FormatNowPlayingParams.timedMetadata} arrives or changes);
42
- * - on every playback transition — play / pause, a stall starting or recovering, an error.
43
- *
44
- * Identical results are de-duplicated natively before they reach the media session, so returning the
45
- * same fields across a rapid burst of transitions is cheap and won't flicker the surface.
46
- *
47
- * ### What to return
48
- * Return a {@link NowPlayingUpdate} with the fields to display. Each field falls back **independently**
49
- * to the track's own value when omitted — so `{ artist: 'Some Song' }` replaces only the secondary
50
- * line and leaves the title as the track's title. Return `undefined` (or `{}`) to use the library
51
- * default entirely (the track's own `title` / `artist`).
52
- *
53
- * @param params - The current track, latest timed metadata, and playback signals for this moment
54
- * ({@link FormatNowPlayingParams}), including a {@link StallReason} that already classifies an
55
- * offline stall — no separate connectivity read needed for the now-playing line.
56
- * @returns The now-playing fields to display, or `undefined` to fall back to the track's own
57
- * `title` / `artist`.
32
+ * The callback is **synchronous**, run on the JS thread and awaited natively: no I/O in it.
33
+ * Each returned field falls back **independently** to the track's own value, so
34
+ * `{ artist: 'Some Song' }` replaces only the secondary line; `undefined` (or `{}`) keeps the
35
+ * track's own `title` / `artist`. See the [Now playing guide](https://audiobrowser.dev/guide/now-playing).
58
36
  *
59
37
  * @example
60
38
  * ```ts
61
39
  * setupPlayer({
62
40
  * nowPlaying: ({ timedMetadata, playWhenReady, stalled, error }) => {
63
41
  * if (error) return { artist: error.message ?? 'Playback error' }
64
- * if (stalled) return { artist: stalled === 'offline' ? 'No internet connection' : 'Reconnecting…' }
65
- * // Show the live song only while actually playing; otherwise fall back to the track default.
42
+ * if (stalled) {
43
+ * return {
44
+ * artist: stalled === 'offline'
45
+ * ? 'No internet connection'
46
+ * : 'Reconnecting…'
47
+ * }
48
+ * }
49
+ * // Show the live song only while playing; else use the track default.
66
50
  * if (!playWhenReady || !timedMetadata?.title) return
67
51
  * return {
68
52
  * artist: timedMetadata.artist
@@ -111,7 +95,8 @@ import { validateIOSUpdateOptions } from './validateOptions';
111
95
  * - `'ambient'`: The category for an app in which sound playback is nonprimary
112
96
  * — that is, your app also works with the sound turned off. See
113
97
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616560-ambient
114
- * - `'soloAmbient'`: The default audio session category. See
98
+ * - `'soloAmbient'`: The system's default audio session category; the library
99
+ * uses `'playback'` when `category` is omitted. See
115
100
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616488-soloambient
116
101
  * - `'record'`: The category for recording audio while also silencing playback
117
102
  * audio. See
@@ -185,6 +170,11 @@ import { validateIOSUpdateOptions } from './validateOptions';
185
170
  * https://developer.apple.com/documentation/avfoundation/avaudiosession/routesharingpolicy/longformvideo
186
171
  */
187
172
 
173
+ /**
174
+ * Requirements for Android audio offload; see `audioOffload`.
175
+ * @platform android
176
+ */
177
+
188
178
  /**
189
179
  * Configuration for retry behavior.
190
180
  *
@@ -290,7 +280,8 @@ function wrapNowPlayingFormatter(formatter) {
290
280
  /**
291
281
  * The object's entries whose values aren't `undefined`. `null` stays: it's meaningful on some
292
282
  * fields (`progressUpdateEventInterval: null` disables progress events, `remoteButtonLayout:
293
- * null` empties the layout), so only `undefined` means "not provided".
283
+ * null` goes back to the layout derived from capabilities), so only `undefined` means "not
284
+ * provided".
294
285
  */
295
286
  function definedFields(obj) {
296
287
  const out = {};
@@ -314,9 +305,14 @@ function nonEmpty(key, value) {
314
305
  * natively as part of setup itself, so there is no setup-then-command ordering for consumers
315
306
  * to know about, and no window where the player exists without its options.
316
307
  *
317
- * Calling it again reconfigures the player in place: newly provided fields are merged over
318
- * the previous ones, and the audio engine is rebuilt when construction-bound fields (buffers,
319
- * wake mode, …) changed.
308
+ * Calling it again is how a setup-only option changes after launch, and works differently per
309
+ * platform. On Android, newly provided fields are merged over the previous ones, except
310
+ * `remoteOutputs`, which is off when left out, and `nowPlaying`, which is on when left out
311
+ * and keeps an earlier formatter until a call passes another one. The audio engine is rebuilt
312
+ * only when construction-bound fields (buffers, wake mode, …) changed. On iOS, each call
313
+ * replaces the player: the queue is cleared, and setup-only fields you omit (`ios` session
314
+ * category and `buffer`, `retry`, …) go back to their defaults. Runtime options set earlier
315
+ * carry over on both.
320
316
  *
321
317
  * @param options - The options to initialize the player with.
322
318
  *
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","validateIOSUpdateOptions","resolveNowPlaying","value","autoUpdateNowPlayingMetadata","nowPlayingMetadataFormatter","wrapNowPlayingFormatter","undefined","formatter","params","definedFields","obj","out","key","nonEmpty","Object","keys","length","setupPlayer","options","nowPlaying","capabilities","forwardJumpInterval","backwardJumpInterval","progressUpdateEventInterval","android","ios","nativeSetup","appKilledPlaybackBehavior","skipSilence","remoteButtonLayout","androidSetup","playbackRates","carPlayUpNextButton","carPlayNowPlayingButtons","carPlayPlayingIndicatorLocation","iosSetup","iosUpdate","updates"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;AAAA;;AAYA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA2BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AA2GA;;AA4CA;;AA2BA;AACA;AACA;AACA;AACA;;AAoCA;;AAEA;AACA;AACA;AACA;;AAMA;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","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","validateIOSUpdateOptions","resolveNowPlaying","value","autoUpdateNowPlayingMetadata","nowPlayingMetadataFormatter","wrapNowPlayingFormatter","undefined","formatter","params","definedFields","obj","out","key","nonEmpty","Object","keys","length","setupPlayer","options","nowPlaying","capabilities","forwardJumpInterval","backwardJumpInterval","progressUpdateEventInterval","android","ios","nativeSetup","appKilledPlaybackBehavior","skipSilence","remoteButtonLayout","androidSetup","playbackRates","carPlayUpNextButton","carPlayNowPlayingButtons","carPlayPlayingIndicatorLocation","iosSetup","iosUpdate","updates"],"sourceRoot":"../../../../src","sources":["features/player/setup.ts"],"mappings":";;AAAA;;AAYA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,wBAAwB,QAAQ,mBAAmB;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA2BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAyGA;;AAqDA;;AA2BA;AACA;AACA;AACA;AACA;;AAoCA;;AAEA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;;AA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","ignoreList":[]}
@@ -36,7 +36,6 @@ export function getActiveTrackIndex() {
36
36
  * {@link onFavoriteChanged} instead; {@link useActiveTrack} subscribes to
37
37
  * both, so UI bound through the hook still re-renders on a heart toggle.
38
38
  *
39
- * @param callback - Called when the active track changes
40
39
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
41
40
  */
42
41
  export const onActiveTrackChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackActiveTrackChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","getActiveTrack","undefined","getActiveTrackIndex","onActiveTrackChanged","emitterize","cb","onPlaybackActiveTrackChanged","activeTrackInvalidators","useActiveTrack"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,yBAAyB,QAAQ,uCAAuC;AACjF,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAsB;EAClD,OAAOJ,aAAa,CAACI,cAAc,CAAC,CAAC,IAAIC,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAON,aAAa,CAACM,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAC/BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACU,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA,MAAME,uBAAuB,GAAG,CAACJ,oBAAoB,EAAEJ,iBAAiB,CAAC;;AAEzE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,cAAcA,CAAA,EAAsB;EAClD,OAAOV,yBAAyB,CAACE,cAAc,EAAEO,uBAAuB,CAAC;AAC3E","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","getActiveTrack","undefined","getActiveTrackIndex","onActiveTrackChanged","emitterize","cb","onPlaybackActiveTrackChanged","activeTrackInvalidators","useActiveTrack"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,yBAAyB,QAAQ,uCAAuC;AACjF,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAsB;EAClD,OAAOJ,aAAa,CAACI,cAAc,CAAC,CAAC,IAAIC,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAON,aAAa,CAACM,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAC/BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACU,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA,MAAME,uBAAuB,GAAG,CAACJ,oBAAoB,EAAEJ,iBAAiB,CAAC;;AAEzE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,cAAcA,CAAA,EAAsB;EAClD,OAAOV,yBAAyB,CAACE,cAAc,EAAEO,uBAAuB,CAAC;AAC3E","ignoreList":[]}
@@ -18,6 +18,8 @@ import { onFavoriteChanged } from '../favorites';
18
18
  * @param tracks - The tracks to add to the queue.
19
19
  * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
20
20
  * By default the tracks will be added to the end of the queue.
21
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
22
+ * Android and the web treat `-1` as append; iOS throws on it.
21
23
  */
22
24
 
23
25
  /**
@@ -25,6 +27,8 @@ import { onFavoriteChanged } from '../favorites';
25
27
  * @param track - The track to add to the queue.
26
28
  * @param insertBeforeIndex - (Optional) The index to insert the track before.
27
29
  * By default the track will be added to the end of the queue.
30
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
31
+ * Android and the web treat `-1` as append; iOS throws on it.
28
32
  */
29
33
 
30
34
  export function add(tracks, insertBeforeIndex) {
@@ -37,6 +41,7 @@ export function add(tracks, insertBeforeIndex) {
37
41
  /**
38
42
  * Replaces the current track or loads the track as the first in the queue.
39
43
  * @param track - The track to load.
44
+ * @throws If called before `setupPlayer`.
40
45
  */
41
46
  export function load(track) {
42
47
  nativeBrowser.load(track);
@@ -45,8 +50,10 @@ export function load(track) {
45
50
  /**
46
51
  * Move a track within the queue.
47
52
  * @param fromIndex - The index of the track to be moved.
48
- * @param toIndex - The index to move the track to. If the index is larger than
49
- * the size of the queue, then the track is moved to the end of the queue.
53
+ * @param toIndex - The index to move the track to. On iOS and Android an index
54
+ * past the end moves the track to the end of the queue; the web throws.
55
+ * @throws If `fromIndex` is outside the queue or `toIndex` is negative (on the
56
+ * web, also if `toIndex` is past the last index).
50
57
  */
51
58
  export function move(fromIndex, toIndex) {
52
59
  nativeBrowser.move(fromIndex, toIndex);
@@ -55,21 +62,32 @@ export function move(fromIndex, toIndex) {
55
62
  /**
56
63
  * Removes multiple tracks from the queue by their indexes.
57
64
  *
58
- * If the current track is removed, the next track will activated. If the
59
- * current track was the last track in the queue, the first track will be
60
- * activated.
65
+ * If the active track is removed, the track after it becomes active. On iOS
66
+ * and the web that is the next index, wrapping to the first track. On Android
67
+ * it is the next track in playback order (shuffle and repeat apply), and
68
+ * removing the last track with repeat `off` makes the first track active but
69
+ * ends playback.
61
70
  *
62
71
  * @param indexes - The indexes of the tracks to be removed.
72
+ * @throws If an index is outside the queue. Android checks every index before
73
+ * removing any, and also throws if an index appears twice. iOS removes from the
74
+ * highest index down, so an invalid index can throw after some tracks are gone,
75
+ * and a repeated index also removes the track that moved into its place. The
76
+ * web skips invalid and repeated indexes without throwing.
63
77
  */
64
78
 
65
79
  /**
66
80
  * Removes a track from the queue by its index.
67
81
  *
68
- * If the current track is removed, the next track will activated. If the
69
- * current track was the last track in the queue, the first track will be
70
- * activated.
82
+ * If the active track is removed, the track after it becomes active. On iOS
83
+ * and the web that is the next index, wrapping to the first track. On Android
84
+ * it is the next track in playback order (shuffle and repeat apply), and
85
+ * removing the last track with repeat `off` makes the first track active but
86
+ * ends playback.
71
87
  *
72
88
  * @param index - The index of the track to be removed.
89
+ * @throws If `index` is outside the queue, on iOS and Android; the web
90
+ * ignores it.
73
91
  */
74
92
 
75
93
  export function remove(indexOrIndexes) {
@@ -77,7 +95,8 @@ export function remove(indexOrIndexes) {
77
95
  }
78
96
 
79
97
  /**
80
- * Clears any upcoming tracks from the queue.
98
+ * Removes every track after the active track's index in the queue. With
99
+ * shuffle on, this is queue order, not the shuffled play order.
81
100
  */
82
101
  export function removeUpcomingTracks() {
83
102
  nativeBrowser.removeUpcomingTracks();
@@ -87,6 +106,7 @@ export function removeUpcomingTracks() {
87
106
  * Skips to a track in the queue.
88
107
  * @param index - The index of the track to skip to.
89
108
  * @param initialPosition - (Optional) The initial position to seek to in seconds.
109
+ * @throws If `index` is outside the queue.
90
110
  */
91
111
  export function skip(index, initialPosition) {
92
112
  nativeBrowser.skip(index, initialPosition);
@@ -94,7 +114,9 @@ export function skip(index, initialPosition) {
94
114
 
95
115
  /**
96
116
  * Skips to the next track in the queue.
97
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
117
+ * @param initialPosition - (Optional) The position in seconds to start the next
118
+ * track from. On iOS and Android, with no next track the active track seeks to
119
+ * it instead; on the web the call does nothing.
98
120
  */
99
121
  export function skipToNext(initialPosition) {
100
122
  nativeBrowser.skipToNext(initialPosition);
@@ -102,7 +124,9 @@ export function skipToNext(initialPosition) {
102
124
 
103
125
  /**
104
126
  * Skips to the previous track in the queue.
105
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
127
+ * @param initialPosition - (Optional) The position in seconds to start the
128
+ * previous track from. On iOS and Android, with no previous track the active
129
+ * track seeks to it instead; on the web the call does nothing.
106
130
  */
107
131
  export function skipToPrevious(initialPosition) {
108
132
  nativeBrowser.skipToPrevious(initialPosition);
@@ -111,12 +135,15 @@ export function skipToPrevious(initialPosition) {
111
135
  /**
112
136
  * Sets (replaces) the queue.
113
137
  *
114
- * This does not change the play/pause state: the player keeps playing if it was
115
- * playing and stays paused if it was paused. Call `play` explicitly to
116
- * start playback.
138
+ * On iOS and Android this does not change the play/pause state: the player
139
+ * keeps playing if it was playing and stays paused if it was paused. On the
140
+ * web it stops playback. Call `play` after it to start playback.
117
141
  *
118
142
  * @param tracks - The tracks to set as the queue.
119
143
  * @param startIndex - (Optional) The index of the track to make active.
144
+ * Defaults to 0 on iOS and Android; on the web, omitting it leaves no track
145
+ * active. iOS clamps an out-of-range index into the queue, Android throws, and
146
+ * the web ignores it.
120
147
  * @param startPosition - (Optional) The position in seconds to start the active track from.
121
148
  */
122
149
  export function setQueue(tracks, startIndex, startPosition) {
@@ -144,18 +171,19 @@ export function getQueue() {
144
171
  // MARK: - Event Callbacks
145
172
 
146
173
  /**
147
- * Subscribes to playback queue ended events.
148
- * @param callback - Called when playback has paused due to reaching the end of the queue
174
+ * Subscribes to playback queue ended events: fires when the last track in
175
+ * playback order finishes with repeat mode `off` and the playback state
176
+ * becomes `ended`. Never fires under `track` or `queue` repeat.
149
177
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
150
178
  */
151
179
  export const onQueueEnded = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueEnded = cb);
152
180
 
153
181
  /**
154
182
  * Subscribes to queue change events.
155
- * Called when tracks are added, removed, or reordered. An in-place mutation of
156
- * a queued track's metadata (a favorite toggle) emits `onFavoriteChanged`
157
- * instead; {@link useQueue} subscribes to both.
158
- * @param callback - Called with the updated queue
183
+ * Called when tracks are added, removed, or reordered. On iOS and Android a
184
+ * favorite toggle also fires it, alongside `onFavoriteChanged`. On web a
185
+ * favorite toggle fires only `onFavoriteChanged`. {@link useQueue} subscribes
186
+ * to both.
159
187
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
160
188
  */
161
189
  export const onQueueChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","queueInvalidators","useQueue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,yBAAyB,QAAQ,uCAAuC;AACjF,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;;AAEA;AACA;AACA;;AAQA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,GAAGA,CAACC,MAAuB,EAAEC,iBAA0B,EAAQ;EAC7E,MAAMC,SAAS,GAAGC,KAAK,CAACC,OAAO,CAACJ,MAAM,CAAC,GAAGA,MAAM,GAAG,CAACA,MAAM,CAAC;EAC3D,IAAIE,SAAS,CAACG,MAAM,GAAG,CAAC,EAAE;IACxBV,aAAa,CAACI,GAAG,CAACG,SAAS,EAAED,iBAAiB,CAAC;EACjD;AACF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,IAAIA,CAACC,KAAY,EAAQ;EACvCZ,aAAa,CAACW,IAAI,CAACC,KAAK,CAAC;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAACC,SAAiB,EAAEC,OAAe,EAAQ;EAC7Df,aAAa,CAACa,IAAI,CAACC,SAAS,EAAEC,OAAO,CAAC;AACxC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,MAAMA,CAACC,cAAiC,EAAQ;EAC9DjB,aAAa,CAACgB,MAAM,CAClBR,KAAK,CAACC,OAAO,CAACQ,cAAc,CAAC,GAAGA,cAAc,GAAG,CAACA,cAAc,CAClE,CAAC;AACH;;AAEA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAS;EAC3ClB,aAAa,CAACkB,oBAAoB,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAACC,KAAa,EAAEC,eAAwB,EAAQ;EAClErB,aAAa,CAACmB,IAAI,CAACC,KAAK,EAAEC,eAAe,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACD,eAAwB,EAAQ;EACzDrB,aAAa,CAACsB,UAAU,CAACD,eAAe,CAAC;AAC3C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAACF,eAAwB,EAAQ;EAC7DrB,aAAa,CAACuB,cAAc,CAACF,eAAe,CAAC;AAC/C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,QAAQA,CACtBnB,MAAe,EACfoB,UAAmB,EACnBC,aAAsB,EAChB;EACN1B,aAAa,CAACwB,QAAQ,CAACnB,MAAM,EAAEoB,UAAU,EAAEC,aAAa,CAAC;AAC3D;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAACP,KAAa,EAAqB;EACzD,OAAOpB,aAAa,CAAC2B,QAAQ,CAACP,KAAK,CAAC;AACtC;;AAEA;AACA;AACA;AACA,OAAO,SAASQ,QAAQA,CAAA,EAAY;EAClC,OAAO5B,aAAa,CAAC4B,QAAQ,CAAC,CAAC;AACjC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,GACvB5B,kBAAkB,CAAC6B,UAAU,CAC1BC,EAAE,IAAM/B,aAAa,CAACgC,oBAAoB,GAAGD,EAChD,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,cAAc,GAAGhC,kBAAkB,CAAC6B,UAAU,CACxDC,EAAE,IAAM/B,aAAa,CAACkC,sBAAsB,GAAGH,EAClD,CAAC;;AAED;;AAEA;AACA,MAAMI,iBAAiB,GAAG,CAACF,cAAc,EAAE9B,iBAAiB,CAAC;;AAE7D;AACA;AACA;AACA;AACA;AACA,OAAO,SAASiC,QAAQA,CAAA,EAAY;EAClC,OAAOlC,yBAAyB,CAAC0B,QAAQ,EAAEO,iBAAiB,CAAC;AAC/D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","queueInvalidators","useQueue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
@@ -33,9 +33,10 @@ export function setRepeatMode(repeatMode) {
33
33
 
34
34
  // MARK: - Event Callbacks
35
35
 
36
+ /** Event data for when the repeat mode changes. */
37
+
36
38
  /**
37
39
  * Subscribes to repeat mode changes.
38
- * @param callback - Called when repeat mode changes
39
40
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
40
41
  */
41
42
  export const onRepeatModeChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackRepeatModeChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getRepeatMode","setRepeatMode","repeatMode","onRepeatModeChanged","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOH,aAAa,CAACG,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAsB,EAAE;EACpDL,aAAa,CAACI,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAOA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAOR,qBAAqB,CAACC,aAAa,EAAEG,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getRepeatMode","setRepeatMode","repeatMode","onRepeatModeChanged","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOH,aAAa,CAACG,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAsB,EAAE;EACpDL,aAAa,CAACI,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAEA;;AAMA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAOR,qBAAqB,CAACC,aAAa,EAAEG,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
@@ -33,7 +33,6 @@ export function toggleShuffle() {
33
33
 
34
34
  /**
35
35
  * Subscribes to shuffle mode changes.
36
- * @param callback - Called when shuffle mode changes
37
36
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
38
37
  */
39
38
  export const onShuffleChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackShuffleModeChanged = cb);