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

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
@@ -14,7 +14,7 @@ export interface RemoteJumpForwardEvent {
14
14
  interval: number;
15
15
  }
16
16
  /**
17
- * Remote play ID event (Android only).
17
+ * Payload of {@link onRemotePlayId}. No platform emits it.
18
18
  */
19
19
  export interface RemotePlayIdEvent {
20
20
  /** The ID of the track to play */
@@ -23,7 +23,7 @@ export interface RemotePlayIdEvent {
23
23
  index?: number;
24
24
  }
25
25
  /**
26
- * Remote play search event (Android only).
26
+ * Payload of {@link onRemotePlaySearch}. No platform emits it.
27
27
  */
28
28
  export interface RemotePlaySearchEvent {
29
29
  /** The search query */
@@ -37,7 +37,7 @@ export interface RemoteSeekEvent {
37
37
  position: number;
38
38
  }
39
39
  /**
40
- * Remote skip event (Android only).
40
+ * Payload of {@link onRemoteSkip}. No platform emits it.
41
41
  */
42
42
  export interface RemoteSkipEvent {
43
43
  /** The index to skip to */
@@ -45,107 +45,140 @@ export interface RemoteSkipEvent {
45
45
  }
46
46
  /**
47
47
  * Sets a custom handler for remote play events, overriding the default behavior.
48
- * @param callback - Called when the user presses the play button. Pass undefined to disable.
48
+ * `onRemote*` listeners still fire.
49
+ *
50
+ * @param callback - Called when the user presses the play button. Pass
51
+ * `undefined` to restore the default behavior.
49
52
  */
50
53
  export declare function handleRemotePlay(callback: (() => void) | undefined): void;
51
54
  /**
52
55
  * Sets a custom handler for remote pause events, overriding the default behavior.
53
- * @param callback - Called when the user presses the pause button. Pass undefined to disable.
56
+ * `onRemote*` listeners still fire.
57
+ *
58
+ * @param callback - Called when the user presses the pause button. Pass
59
+ * `undefined` to restore the default behavior.
54
60
  */
55
61
  export declare function handleRemotePause(callback: (() => void) | undefined): void;
56
62
  /**
57
63
  * Sets a custom handler for remote next events, overriding the default behavior.
58
- * @param callback - Called when the user presses the next track button. Pass undefined to disable.
64
+ * `onRemote*` listeners still fire.
65
+ *
66
+ * @param callback - Called when the user presses the next track button. Pass
67
+ * `undefined` to restore the default behavior.
59
68
  */
60
69
  export declare function handleRemoteNext(callback: (() => void) | undefined): void;
61
70
  /**
62
71
  * Sets a custom handler for remote previous events, overriding the default behavior.
63
- * @param callback - Called when the user presses the previous track button. Pass undefined to disable.
72
+ * `onRemote*` listeners still fire.
73
+ *
74
+ * @param callback - Called when the user presses the previous track button. Pass
75
+ * `undefined` to restore the default behavior.
64
76
  */
65
77
  export declare function handleRemotePrevious(callback: (() => void) | undefined): void;
66
78
  /**
67
79
  * Sets a custom handler for remote stop events, overriding the default behavior.
68
- * @param callback - Called when the user presses the stop button. Pass undefined to disable.
80
+ * `onRemote*` listeners still fire.
81
+ *
82
+ * @param callback - Called when the user presses the stop button. Pass
83
+ * `undefined` to restore the default behavior.
69
84
  */
70
85
  export declare function handleRemoteStop(callback: (() => void) | undefined): void;
71
86
  /**
72
87
  * Sets a custom handler for remote seek events, overriding the default behavior.
73
- * @param callback - Called when the user changes the position of the timeline. Pass undefined to disable.
88
+ * `onRemote*` listeners still fire.
89
+ *
90
+ * @param callback - Called when the user changes the position of the timeline. Pass
91
+ * `undefined` to restore the default behavior.
74
92
  */
75
93
  export declare function handleRemoteSeek(callback: ((event: RemoteSeekEvent) => void) | undefined): void;
76
94
  /**
77
95
  * Sets a custom handler for remote jump forward events, overriding the default behavior.
78
- * @param callback - Called when the user presses the jump forward button. Pass undefined to disable.
96
+ * `onRemote*` listeners still fire.
97
+ *
98
+ * @param callback - Called when the user presses the jump forward button. Pass
99
+ * `undefined` to restore the default behavior.
79
100
  */
80
101
  export declare function handleRemoteJumpForward(callback: ((event: RemoteJumpForwardEvent) => void) | undefined): void;
81
102
  /**
82
103
  * Sets a custom handler for remote jump backward events, overriding the default behavior.
83
- * @param callback - Called when the user presses the jump backward button. Pass undefined to disable.
104
+ * `onRemote*` listeners still fire.
105
+ *
106
+ * @param callback - Called when the user presses the jump backward button. Pass
107
+ * `undefined` to restore the default behavior.
84
108
  */
85
109
  export declare function handleRemoteJumpBackward(callback: ((event: RemoteJumpBackwardEvent) => void) | undefined): void;
86
110
  /**
87
111
  * Subscribes to remote jump backward events.
88
- * @param callback - Called when the user presses the jump backward button
112
+ * Fires when the user presses the jump backward button, including when a
113
+ * `handleRemoteJumpBackward` override is set.
89
114
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
90
115
  */
91
116
  export declare const onRemoteJumpBackward: LazyNativeEmitter<RemoteJumpBackwardEvent>;
92
117
  /**
93
118
  * Subscribes to remote jump forward events.
94
- * @param callback - Called when the user presses the jump forward button
119
+ * Fires when the user presses the jump forward button, including when a
120
+ * `handleRemoteJumpForward` override is set.
95
121
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
96
122
  */
97
123
  export declare const onRemoteJumpForward: LazyNativeEmitter<RemoteJumpForwardEvent>;
98
124
  /**
99
125
  * Subscribes to remote next events.
100
- * @param callback - Called when the user presses the next track button
126
+ * Fires when the user presses the next track button, including when a
127
+ * `handleRemoteNext` override is set.
101
128
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
102
129
  */
103
130
  export declare const onRemoteNext: LazyNativeEmitter<void>;
104
131
  /**
105
132
  * Subscribes to remote pause events.
106
- * @param callback - Called when the user presses the pause button
133
+ * Fires when the user presses the pause button, including when a
134
+ * `handleRemotePause` override is set.
107
135
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
108
136
  */
109
137
  export declare const onRemotePause: LazyNativeEmitter<void>;
110
138
  /**
111
139
  * Subscribes to remote play events.
112
- * @param callback - Called when the user presses the play button
140
+ * Fires when the user presses the play button, including when a
141
+ * `handleRemotePlay` override is set.
113
142
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
114
143
  */
115
144
  export declare const onRemotePlay: LazyNativeEmitter<void>;
116
145
  /**
117
- * Subscribes to remote play ID events (Android only).
118
- * @param callback - Called when the user selects a track from an external device
146
+ * Subscribes to remote play ID events. Never fires: no platform (iOS,
147
+ * Android or web) emits them yet.
119
148
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
120
149
  */
121
150
  export declare const onRemotePlayId: LazyNativeEmitter<RemotePlayIdEvent>;
122
151
  /**
123
- * Subscribes to remote play search events (Android only).
124
- * @param callback - Called when the user searches for a track (usually voice search)
152
+ * Subscribes to remote play search events. Never fires: no platform (iOS,
153
+ * Android or web) emits them yet. Voice search goes through the `search`
154
+ * source passed to `configureBrowser`.
125
155
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
126
156
  */
127
157
  export declare const onRemotePlaySearch: LazyNativeEmitter<RemotePlaySearchEvent>;
128
158
  /**
129
159
  * Subscribes to remote previous events.
130
- * @param callback - Called when the user presses the previous track button
160
+ * Fires when the user presses the previous track button, including when a
161
+ * `handleRemotePrevious` override is set.
131
162
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
132
163
  */
133
164
  export declare const onRemotePrevious: LazyNativeEmitter<void>;
134
165
  /**
135
166
  * Subscribes to remote seek events.
136
- * @param callback - Called when the user changes the position of the timeline
167
+ * Fires when the user changes the position of the timeline, including when a
168
+ * `handleRemoteSeek` override is set.
137
169
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
138
170
  */
139
171
  export declare const onRemoteSeek: LazyNativeEmitter<RemoteSeekEvent>;
140
172
  /**
141
- * Subscribes to remote skip events (Android only).
142
- * @param callback - Called when the user presses the skip button
173
+ * Subscribes to remote skip events. Never fires: no platform (iOS, Android
174
+ * or web) emits them yet.
143
175
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
144
176
  */
145
177
  export declare const onRemoteSkip: LazyNativeEmitter<RemoteSkipEvent>;
146
178
  /**
147
179
  * Subscribes to remote stop events.
148
- * @param callback - Called when the user presses the stop button
180
+ * Fires when the user presses the stop button, including when a
181
+ * `handleRemoteStop` override is set.
149
182
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
150
183
  */
151
184
  export declare const onRemoteStop: LazyNativeEmitter<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"remoteControls.d.ts","sourceRoot":"","sources":["../../../../src/features/remoteControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAI9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAQD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAEnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,QAGzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,SAAS,QAGhE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC,GAAG,SAAS,QAGjE;AASD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,4CAG9B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,2CAG7B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,yBAEzB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,sCAE1B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,0CAG5B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,yBAE5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,oCAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,oCAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA"}
1
+ {"version":3,"file":"remoteControls.d.ts","sourceRoot":"","sources":["../../../../src/features/remoteControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAI9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,QAElE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,QAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,SAAS,QAGhE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC,GAAG,SAAS,QAGjE;AAID;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,4CAG9B,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,2CAG7B,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,yBAEzB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,sCAE1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,0CAG5B,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,yBAE5B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,oCAExB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,oCAExB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,yBAExB,CAAA"}
@@ -1,13 +1,13 @@
1
1
  import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
2
2
  /**
3
- * Time-based sleep timer that stops playback after a specific time.
3
+ * Time-based sleep timer that pauses playback after a specific time.
4
4
  */
5
5
  export type SleepTimerTime = {
6
- /** Time when playback should stop (milliseconds since epoch) */
6
+ /** Time when playback should pause (milliseconds since epoch) */
7
7
  time: number;
8
8
  };
9
9
  /**
10
- * End-of-track sleep timer that stops playback when current track finishes.
10
+ * End-of-track sleep timer that pauses playback when current track finishes.
11
11
  */
12
12
  export type SleepTimerEndOfTrack = {
13
13
  /** Whether to sleep when current track finishes playing */
@@ -15,11 +15,15 @@ export type SleepTimerEndOfTrack = {
15
15
  };
16
16
  /**
17
17
  * Sleep timer configuration:
18
- * - `SleepTimerTime`: Stop playback after a specific time
19
- * - `SleepTimerEndOfTrack`: Stop playback after current track finishes
18
+ * - `SleepTimerTime`: Pause playback after a specific time
19
+ * - `SleepTimerEndOfTrack`: Pause playback after current track finishes
20
20
  * - `null`: No sleep timer active
21
21
  */
22
22
  export type SleepTimer = SleepTimerTime | SleepTimerEndOfTrack | null;
23
+ /**
24
+ * Payload of `onSleepTimerChanged`: the new timer, or `null` once it is
25
+ * cleared or has fired.
26
+ */
23
27
  export type SleepTimerChangedEvent = SleepTimer;
24
28
  /**
25
29
  * Gets the current sleep timer state.
@@ -46,7 +50,12 @@ export type SleepTimerOptions = {
46
50
  */
47
51
  export declare function setSleepTimer(seconds: number, options?: SleepTimerOptions): void;
48
52
  /**
49
- * Sets a sleep timer to stop playback when the current track finishes playing.
53
+ * Sets a sleep timer to pause playback when the current track finishes playing.
54
+ * A live stream never ends, so on one this timer never fires; use
55
+ * `setSleepTimer` instead. On iOS a change of current track before it ends
56
+ * (skip, new queue) cancels the timer. On Android and web it stays set until a
57
+ * track plays to its end. On Android it never fires while the repeat mode is
58
+ * `track`.
50
59
  */
51
60
  export declare function setSleepTimerToEndOfTrack(): void;
52
61
  /**
@@ -56,7 +65,6 @@ export declare function setSleepTimerToEndOfTrack(): void;
56
65
  export declare function clearSleepTimer(): boolean;
57
66
  /**
58
67
  * Subscribes to sleep timer changes.
59
- * @param callback - Called when the sleep timer state changes
60
68
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
61
69
  */
62
70
  export declare const onSleepTimerChanged: NativeUpdatedValue<SleepTimer>;
@@ -1 +1 @@
1
- {"version":3,"file":"sleepTimer.d.ts","sourceRoot":"","sources":["../../../../src/features/sleepTimer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAA;AAErE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAA;AAI/C;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,gCAE/B,CAAA;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAe7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,eAAe,GAAG,SAAS,CA0D9B;AAID;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,CAAA"}
1
+ {"version":3,"file":"sleepTimer.d.ts","sourceRoot":"","sources":["../../../../src/features/sleepTimer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,oBAAoB,GAAG,IAAI,CAAA;AAErE;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAA;AAI/C;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gCAE/B,CAAA;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAe7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,eAAe,GAAG,SAAS,CA0D9B;AAID;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,CAAA"}
@@ -29,10 +29,6 @@ export type ArtworkRendering = 'original' | 'stencil';
29
29
  * - `'circular'` — the standard presentation for *people* (artists, hosts,
30
30
  * DJs). Shape encodes the kind of item, so mixed grids legitimately
31
31
  * render circular artists next to rounded albums.
32
- *
33
- * Named after Apple's `imageShape` parameter (a platform passthrough), and
34
- * deliberately without a grid prefix: every tile presentation that takes a
35
- * shape reads the same property.
36
32
  */
37
33
  export type ImageShape = 'circular' | 'rounded-rectangle';
38
34
  /**
@@ -52,7 +48,7 @@ export type ImageShape = 'circular' | 'rounded-rectangle';
52
48
  * {@link TrackStyle.accessorySymbol}.
53
49
  *
54
50
  * Element families are mutually exclusive within a container, so this is
55
- * a container property — hence the enum, and the `grid` prefix.
51
+ * a container property.
56
52
  */
57
53
  export type GridTile = 'plain' | 'image' | 'card' | 'condensed';
58
54
  /**
@@ -63,9 +59,6 @@ export type GridTile = 'plain' | 'image' | 'card' | 'condensed';
63
59
  * - `'background'` — the image fills the card full-height with the labels
64
60
  * overlaid; `cardTint` fades in behind them. Selects the larger artwork
65
61
  * target size.
66
- *
67
- * An enum rather than a boolean: it names the card's image mode and
68
- * leaves room for future modes.
69
62
  */
70
63
  export type CardImage = 'normal' | 'background';
71
64
  /**
@@ -146,9 +139,7 @@ export interface TrackStyle {
146
139
  * surface); plain and card tiles have no slot for one. A resolved
147
140
  * symbol replaces the derived accessory (the disclosure chevron a
148
141
  * browsable row gets); `'none'` clears an inherited value, restoring
149
- * the derived behavior — inheritance has no other escape, and no SF
150
- * Symbol is named `none`, so the sentinel is collision-free. Inert off
151
- * CarPlay.
142
+ * the derived accessory. Inert off CarPlay.
152
143
  *
153
144
  * @platform carplay
154
145
  */
@@ -239,12 +230,12 @@ export interface ImageSource {
239
230
  body?: string;
240
231
  }
241
232
  /**
242
- * Per-track override applied as the most-specific layer of THIS track's media
243
- * request (after the shared `request` and `media` layers). Deliberately narrow:
244
- * a track may customize HOW its request is made (identity, auth, signed-URL
245
- * params), not WHERE it goes — `baseUrl`/`path`/`method`/`body` are intentionally
246
- * absent so a (often server-sourced) track can't repoint its own host or verb.
247
- * Carried verbatim on the Track and round-tripped like any other field.
233
+ * Per-track request fields, carried verbatim on the Track and round-tripped like
234
+ * any other field. Not applied: no platform merges them into the track's
235
+ * media request, so they set no header, user agent or query. For per-track
236
+ * headers or query, return them from `media.resolve` / `resolveSync(track)`.
237
+ * `baseUrl`/`path`/`method`/`body` are absent so a (often server-sourced)
238
+ * track can't repoint its own host or verb.
248
239
  */
249
240
  export interface TrackRequest {
250
241
  userAgent?: string;
@@ -255,15 +246,16 @@ export interface TrackRequest {
255
246
  * Artwork URLs for a track that ships a different image per appearance.
256
247
  *
257
248
  * Both are required: a pair with one side missing has no sensible fallback at
258
- * render time, and making that unrepresentable is the reason this is a pair
259
- * rather than two optional fields.
249
+ * render time.
260
250
  *
261
- * Android Auto is dark-only and takes `dark`.
251
+ * The pair adapts to appearance only on CarPlay browse rows and tabs. Every
252
+ * other surface takes `dark` whatever the appearance: now-playing and the lock
253
+ * screen on every platform, Android Auto, and {@link Track.artworkSource}.
262
254
  */
263
255
  export interface ArtworkVariants {
264
- /** Shown in light mode. */
256
+ /** Shown on CarPlay in light mode. */
265
257
  light: string;
266
- /** Shown in dark mode, and on Android Auto. */
258
+ /** Shown on CarPlay in dark mode, and on every other surface. */
267
259
  dark: string;
268
260
  }
269
261
  /** A single artwork URL, or one per appearance. */
@@ -279,10 +271,8 @@ export interface Section {
279
271
  title?: string;
280
272
  /**
281
273
  * Presentation, separated from content. Each surface renders the
282
- * declared layout's nearest supported form; on CarPlay
283
- * a wrapping grid requires iOS 26+ and renders a list before that,
284
- * since CarPlay's only earlier tile container truncates at a width the
285
- * system doesn't report. Use the artwork `resolve` hook to supply
274
+ * declared layout's nearest supported form (CarPlay's grid limits:
275
+ * {@link StyleDisplay}). Use the artwork `resolve` hook to supply
286
276
  * fallback art for tile layouts.
287
277
  */
288
278
  style?: SectionStyle;
@@ -291,7 +281,7 @@ export interface Section {
291
281
  * fuller page this section is a teaser for. Absent = a self-contained
292
282
  * section: the header is a plain label, not a link.
293
283
  *
294
- * The surface picks the form (ADR 0010), and each carries the copy
284
+ * The surface picks the form, and each carries the copy
295
285
  * itself — a `path` never adds words to the section:
296
286
  *
297
287
  * - **CarPlay** — a tile section's row draws a disclosure chevron and
@@ -300,7 +290,7 @@ export interface Section {
300
290
  * spend an item from the template's cap.
301
291
  * - **Android Auto** — no header is tappable at any display, so the
302
292
  * section gets an appended browsable row, titled by the global
303
- * `viewMoreTitle` browser option ("View more" by default).
293
+ * `viewMoreTitle` browser option.
304
294
  */
305
295
  path?: string;
306
296
  /** The section's tracks. */
@@ -319,8 +309,9 @@ export interface Track {
319
309
  /**
320
310
  * Opaque, stable identifier for this track.
321
311
  *
322
- * A track's **identity** is `id` when set (non-blank), falling back to
323
- * `src`. That single rule drives every comparison the library makes:
312
+ * A track's **identity** is `id` when set (non-empty), falling back to
313
+ * `src`; Android also treats a whitespace-only `id` as unset, so never
314
+ * send one. That single rule drives every comparison the library makes:
324
315
  * favorites matching (`setFavorites`), the CarPlay / Android Auto
325
316
  * "now playing" row indicator, section scoping and skip-in-place, and the
326
317
  * contextual queue re-expansion. Two tracks refer to the same item iff
@@ -378,8 +369,9 @@ export interface Track {
378
369
  * with the `sf:` prefix and optional color params:
379
370
  * `sf:heart.fill?bg=#FF0090&fg=#fff`. `bg` sets the background color
380
371
  * (transparent if omitted), `fg` sets the symbol color (black if omitted).
381
- * On CarPlay, SF Symbols without explicit colors automatically adapt to
382
- * light/dark mode.
372
+ * CarPlay rows key off `fg` instead: without it, the symbol is drawn black
373
+ * or white to match light/dark mode over a grey tile, and `bg` is ignored;
374
+ * with it, an omitted `bg` is a grey tile. CarPlay tabs ignore both.
383
375
  */
384
376
  artwork?: TrackArtwork;
385
377
  /**
@@ -393,11 +385,12 @@ export interface Track {
393
385
  *
394
386
  * @example
395
387
  * ```tsx
396
- * <Image source={audioBrowser.activeTrack?.artworkSource} />
388
+ * const track = useActiveTrack()
389
+ * <Image source={track?.artworkSource} />
397
390
  * ```
398
391
  */
399
392
  readonly artworkSource?: ImageSource;
400
- /** Per-track media-request override; merged last (request → media → track.request). */
393
+ /** Per-track request fields, round-tripped verbatim; see {@link TrackRequest} for whether they reach the media request. */
401
394
  request?: TrackRequest;
402
395
  /** Primary line shown for this item, in both browse lists and now-playing. */
403
396
  title: string;
@@ -465,25 +458,26 @@ export interface Track {
465
458
  */
466
459
  style?: TrackStyle;
467
460
  /**
468
- * Unavailable — a content-state fact beside `favorited` and `live`,
469
- * with full behavioral weight (content facts may carry behavior; style
470
- * never does): a disabled track never plays — tap refused, queue
471
- * expansion excludes it, voice search won't match it.
461
+ * Marks the track unavailable: the library never plays it — taps and
462
+ * voice selection are refused, queue expansion and resume exclude it. A
463
+ * queue you pass to `setQueue` is not filtered, and your own UI must
464
+ * honor the flag itself.
472
465
  *
473
- * Rendering ladder, never a trap: **grayed + inert** where the surface
474
- * can draw it (CarPlay) → **hidden** where it can't (Android Auto) —
475
- * never a normal-looking dead control. Hiding is behavior-safe because
476
- * the track is inert everywhere regardless; the cost is losing the
477
- * "Available at 9 PM" tease on surfaces that hide, so put the reason
478
- * in the title for the ones that gray. Applied at page (re-)serve,
479
- * like style.
466
+ * Drawn **grayed + inert** where the surface can (CarPlay list rows and
467
+ * iOS 26+ tiles), **hidden** where it can't (CarPlay tile rows before
468
+ * iOS 26, CarPlay tabs, Android Auto). Surfaces that hide lose any
469
+ * "Available at 9 PM" tease, so put the reason in the title for the ones
470
+ * that gray. Applied when the page is (re-)served, like style.
480
471
  *
481
472
  * @default false
482
473
  */
483
474
  disabled?: boolean;
484
475
  /**
485
- * Whether this track is favorited. When the `favorite` capability is enabled,
486
- * displays a filled/empty heart icon in media controllers (notification, Android Auto).
476
+ * Whether this track is favorited. It fills or empties the heart on
477
+ * CarPlay now-playing when `ios.carPlayNowPlayingButtons` includes
478
+ * `'favorite'`. When the `favorite` capability is enabled, it does the
479
+ * same on Android in the notification, Android Auto, the system media
480
+ * controls and playable browse rows. iOS Control Center shows no heart.
487
481
  */
488
482
  favorited?: boolean;
489
483
  /**
@@ -499,14 +493,17 @@ export interface Track {
499
493
  * track declared live — without the declaration it is a no-op.
500
494
  * - **Persistence** (iOS): no position is stored, so a cold-start resume
501
495
  * rejoins the current broadcast instead of seeking a stale timestamp.
502
- * - **Now-playing** (iOS): the live indicator and live-style
503
- * (non-scrubbing) progress UI.
504
- *
505
- * The iOS-heavy list is deliberate, not a gap: on Android, ExoPlayer's
506
- * own classification already covers these — a dropped live connection
507
- * surfaces as a load error (never end-of-stream), and persistence keys
508
- * off its detected liveness — so the declaration's only Android reader
509
- * is the `seekToLiveEdge()` gate. Android Auto has no live badge.
496
+ * - **Now-playing** (iOS and Android): non-scrubbing controls; on iOS
497
+ * also the live indicator. On Android the seek command is removed from
498
+ * media controllers, so the notification and Android Auto draw no
499
+ * scrubber.
500
+ * - **Casting** (Android): a cast receiver loads the item as a live
501
+ * stream, at the live edge.
502
+ *
503
+ * On Android, ExoPlayer's own liveness detection covers end of stream
504
+ * and persistence: a dropped live connection surfaces as a load error
505
+ * (never end-of-stream), and persistence keys off the detected liveness.
506
+ * Android Auto has no live badge.
510
507
  *
511
508
  * Omitting it never breaks playback — it silently breaks these judgment
512
509
  * calls. Declare it on every live track.
@@ -554,8 +551,8 @@ export interface ResolvedTrack extends Track {
554
551
  * block widens to {@link SectionStyle}: the declaration for the whole
555
552
  * page. Item properties set here are inherited by every item on the
556
553
  * page unless a section or track declares its own; the container
557
- * property (`gridWrap`) and the positional `display` are the page-wide
558
- * values a section overrides for its own children.
554
+ * properties (`gridWrap`, `gridTile`) and the positional `display` are
555
+ * the page-wide values a section overrides for its own children.
559
556
  */
560
557
  style?: SectionStyle;
561
558
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"browser-nodes.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-nodes.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"browser-nodes.d.ts","sourceRoot":"","sources":["../../../../src/types/browser-nodes.ts"],"names":[],"mappings":"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"}