react-native-audio-browser 0.2.0 → 1.0.0

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 (1589) hide show
  1. package/AudioBrowser.podspec +2 -2
  2. package/README.md +209 -2
  3. package/android/build.gradle +65 -10
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +29 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +817 -404
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +5 -16
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +143 -97
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +38 -0
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +50 -0
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +571 -490
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +269 -0
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +75 -0
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +104 -45
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +66 -0
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +14 -21
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +44 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +101 -103
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +15 -20
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +64 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +42 -58
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +93 -47
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +136 -0
  41. package/android/src/main/java/com/audiobrowser/player/ConnectionEndSource.kt +145 -0
  42. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  43. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +25 -36
  44. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  45. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +150 -0
  46. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +204 -0
  47. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  48. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  49. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +82 -55
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +809 -266
  51. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +241 -442
  52. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +341 -0
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +119 -0
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +109 -0
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +126 -119
  56. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +60 -0
  57. package/android/src/main/java/com/audiobrowser/player/Player.kt +1024 -965
  58. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +7 -0
  59. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +120 -0
  60. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +225 -107
  61. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  63. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +95 -157
  64. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  66. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  67. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  68. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  69. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +41 -21
  71. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +76 -0
  72. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +96 -66
  73. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +85 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  78. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  94. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  95. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +160 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  97. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +72 -0
  98. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +54 -0
  99. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +363 -0
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +149 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +29 -0
  103. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  105. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  106. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  107. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  108. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +54 -73
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +49 -0
  110. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +33 -0
  111. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +23 -316
  112. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +18 -60
  113. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +26 -25
  114. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +12 -11
  115. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  116. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +204 -0
  117. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +45 -0
  118. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +8 -8
  119. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +13 -0
  120. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  121. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +3 -112
  122. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +21 -10
  123. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +127 -82
  124. package/android/src/main/res/values/strings.xml +26 -2
  125. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  126. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  127. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +59 -0
  128. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  129. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  130. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  131. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  132. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  134. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  135. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  138. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  139. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  140. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +247 -0
  141. package/android/src/test/java/com/audiobrowser/browser/ArtworkResolutionRegistryTest.kt +46 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +39 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +108 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +203 -0
  147. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -4
  148. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +233 -0
  149. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  150. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +53 -0
  151. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  152. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +157 -0
  153. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +2 -7
  154. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  155. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  156. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  157. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  158. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +134 -8
  159. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  160. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  161. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  162. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  163. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +193 -0
  164. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  165. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +55 -0
  166. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +219 -0
  167. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  168. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  169. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  170. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +493 -0
  171. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  172. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +36 -0
  173. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  174. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +672 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +167 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +250 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +135 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +33 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerQueueVersionTest.kt +79 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +738 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  191. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  192. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +365 -0
  193. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +190 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  198. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  199. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  200. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  202. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  203. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  204. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  205. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  206. package/android/src/test/java/com/audiobrowser/player/SleepTimerTest.kt +48 -0
  207. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  208. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +231 -0
  209. package/android/src/test/java/com/audiobrowser/player/VolumeFaderTest.kt +43 -0
  210. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  211. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  212. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  213. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  214. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  223. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  224. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  225. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  226. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  227. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  228. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +273 -0
  229. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +380 -0
  230. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  231. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +152 -0
  232. package/android/src/test/java/com/audiobrowser/tls/CertFixtures.kt +18 -0
  233. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +33 -0
  235. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  236. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +63 -0
  237. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +53 -0
  238. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +53 -0
  239. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +57 -0
  240. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  241. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  242. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  243. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  244. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +36 -0
  245. package/android/src/test/java/com/audiobrowser/util/RatingFavoritesTest.kt +34 -0
  246. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +50 -0
  247. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +61 -0
  248. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +125 -0
  249. package/android/src/test/resources/certs/isrg-root-x1.pem +31 -0
  250. package/android/src/test/resources/certs/letsencrypt-r13.der +0 -0
  251. package/android/src/test/resources/certs/letsencrypt-r13.pem +29 -0
  252. package/android/src/test/resources/certs/stationplaylist-leaf.pem +34 -0
  253. package/android/src/test/resources/sonos/device_description.xml +78 -0
  254. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  255. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  256. package/ios/AVPlayerEngine.swift +385 -0
  257. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  258. package/ios/Browser/BrowseGate.swift +70 -0
  259. package/ios/Browser/BrowserConfig.swift +131 -82
  260. package/ios/Browser/BrowserError.swift +15 -0
  261. package/ios/Browser/BrowserManager.swift +165 -494
  262. package/ios/Browser/BrowserPathHelper.swift +62 -96
  263. package/ios/Browser/FavoriteSet.swift +43 -0
  264. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  265. package/ios/Browser/JsonModels.swift +276 -146
  266. package/ios/Browser/NavigationErrorState.swift +42 -0
  267. package/ios/Browser/PageResolver.swift +132 -0
  268. package/ios/Browser/RequestLayer.swift +185 -0
  269. package/ios/Browser/RequestPipeline.swift +295 -0
  270. package/ios/Browser/SearchDrillIn.swift +38 -0
  271. package/ios/Browser/SectionScope.swift +82 -0
  272. package/ios/Browser/SimpleRouter.swift +76 -154
  273. package/ios/Browser/StyleResolver.swift +41 -0
  274. package/ios/Browser/TabBarEntries.swift +16 -0
  275. package/ios/Browser/TrackIdTemplate.swift +29 -0
  276. package/ios/CarPlay/CPInterfaceController+Safe.swift +167 -0
  277. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  278. package/ios/CarPlay/CarPlayController.swift +47 -717
  279. package/ios/CarPlay/CarPlayImageLoader.swift +88 -126
  280. package/ios/CarPlay/CarPlayListItemFactory.swift +244 -99
  281. package/ios/CarPlay/CarPlayNowPlayingManager.swift +206 -133
  282. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  283. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  284. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  285. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  286. package/ios/CarPlay/CarPlaySession.swift +203 -0
  287. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  288. package/ios/CarPlay/IntentHandlers.swift +94 -0
  289. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  290. package/ios/CarPlay/MediaIntentHandler.swift +68 -0
  291. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  292. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  293. package/ios/CarPlay/RNABAudioBrowser.h +15 -10
  294. package/ios/CarPlay/RNABAudioBrowser.m +8 -15
  295. package/ios/CarPlay/RNABCarPlaySceneDelegate.m +2 -0
  296. package/ios/CarPlay/SectionPresentation.swift +67 -0
  297. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  298. package/ios/Extension/Capability+RemoteCommand.swift +22 -71
  299. package/ios/Extension/ChapterMetadata+AVFoundation.swift +3 -6
  300. package/ios/Extension/CxxVectorConformances.swift +4 -16
  301. package/ios/Extension/NavigationError+Conversion.swift +22 -8
  302. package/ios/Extension/PlayerCapabilities+Favorite.swift +5 -0
  303. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  304. package/ios/Extension/RequestConfig+Copying.swift +27 -0
  305. package/ios/Extension/ResolvedTrack+Copying.swift +20 -22
  306. package/ios/Extension/SearchParams+Query.swift +28 -0
  307. package/ios/Extension/Section+Copying.swift +26 -0
  308. package/ios/Extension/String+IcyCharset.swift +21 -0
  309. package/ios/Extension/TimedMetadata+AVFoundation.swift +11 -15
  310. package/ios/Extension/Track+AVPlayer.swift +5 -22
  311. package/ios/Extension/Track+Copying.swift +18 -20
  312. package/ios/Extension/Track+Identity.swift +20 -0
  313. package/ios/Extension/TrackMetadata+AVFoundation.swift +11 -14
  314. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  315. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  316. package/ios/Extension/URLError+Connectivity.swift +15 -0
  317. package/ios/Extension/Variant+Artwork.swift +35 -0
  318. package/ios/Http/HttpClient.swift +73 -167
  319. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  320. package/ios/HybridAudioBrowser+Options.swift +116 -0
  321. package/ios/HybridAudioBrowser+Player.swift +351 -0
  322. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  323. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  324. package/ios/HybridAudioBrowser.swift +164 -1127
  325. package/ios/Model/NitroTypeStubs.swift +533 -224
  326. package/ios/Model/PlayerUpdateOptions.swift +32 -38
  327. package/ios/Model/RemoteCommand.swift +6 -60
  328. package/ios/Model/TrackPlayerError.swift +73 -18
  329. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +65 -141
  330. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +67 -0
  331. package/ios/Observer/ItemObserver.swift +99 -0
  332. package/ios/Observer/PlayerObserver.swift +59 -0
  333. package/ios/Option/SessionCategories.swift +51 -79
  334. package/ios/PlaybackEvent.swift +4 -2
  335. package/ios/Player/AirPlayStallJudgement.swift +23 -0
  336. package/ios/Player/AudioSessionController.swift +190 -0
  337. package/ios/Player/DeferredSeek.swift +73 -0
  338. package/ios/Player/ErrorStatus.swift +56 -0
  339. package/ios/Player/MediaLoader.swift +94 -93
  340. package/ios/Player/NowPlayingLines.swift +49 -0
  341. package/ios/Player/NowPlayingUpdater.swift +213 -45
  342. package/ios/Player/PersistedPlaybackState.swift +10 -0
  343. package/ios/Player/PlaybackFailure.swift +121 -0
  344. package/ios/Player/PlaybackPersistence.swift +72 -0
  345. package/ios/Player/PlaybackStateMachine.swift +23 -17
  346. package/ios/Player/PlaybackTimer.swift +64 -0
  347. package/ios/Player/Player.swift +1127 -0
  348. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +6 -5
  349. package/ios/Player/PlayerEngine.swift +118 -0
  350. package/ios/Player/PlayerStatusTypes.swift +1 -6
  351. package/ios/Player/QueueManager.swift +137 -138
  352. package/ios/Player/ReconnectPacer.swift +83 -0
  353. package/ios/Player/RetryLoop.swift +374 -0
  354. package/ios/Player/ShuffleOrder.swift +36 -43
  355. package/ios/Player/SilenceBudget.swift +78 -0
  356. package/ios/Player/SleepTimerManager.swift +101 -31
  357. package/ios/Player/VolumeFader.swift +91 -0
  358. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  359. package/ios/RemoteCommand/RemoteCommandController.swift +112 -331
  360. package/ios/Tests/AirPlayStallJudgementTests.swift +52 -0
  361. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  362. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  363. package/ios/Tests/BrowseGateTests.swift +50 -0
  364. package/ios/Tests/BrowserPathHelperTests.swift +99 -0
  365. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  366. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  367. package/ios/Tests/ChapterMetadataAVFoundationTests.swift +2 -2
  368. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  369. package/ios/Tests/ConnectivityTests.swift +13 -0
  370. package/ios/Tests/DeferredSeekTests.swift +76 -0
  371. package/ios/Tests/EmitterTests.swift +22 -39
  372. package/ios/Tests/ErrorStatusTests.swift +50 -0
  373. package/ios/Tests/FavoriteSetTests.swift +61 -0
  374. package/ios/Tests/GenerationMemoTests.swift +178 -0
  375. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  376. package/ios/Tests/JsonModelsTests.swift +244 -0
  377. package/ios/Tests/LRUCacheTests.swift +106 -0
  378. package/ios/Tests/MediaIntentCriteriaTests.swift +176 -0
  379. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  380. package/ios/Tests/MediaLoaderAssetOptionsTests.swift +46 -0
  381. package/ios/Tests/MediaLoaderTests.swift +67 -74
  382. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  383. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  384. package/ios/Tests/ObserverTests.swift +106 -0
  385. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  386. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  387. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  388. package/ios/Tests/PlaybackStateMachineTests.swift +28 -18
  389. package/ios/Tests/PlaybackTimerTests.swift +54 -0
  390. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  391. package/ios/Tests/PlayerPolicyTests.swift +1743 -0
  392. package/ios/Tests/PlayerTests.swift +1677 -0
  393. package/ios/Tests/PlayingStateTests.swift +41 -0
  394. package/ios/Tests/QueueManagerTests.swift +366 -164
  395. package/ios/Tests/ReadyValueTests.swift +73 -0
  396. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  397. package/ios/Tests/RequestLayerTests.swift +228 -0
  398. package/ios/Tests/ResolvedTrackCopyingTests.swift +52 -43
  399. package/ios/Tests/RetryCaseTests.swift +146 -0
  400. package/ios/Tests/RetryLoopTests.swift +486 -0
  401. package/ios/Tests/SearchDrillInTests.swift +62 -0
  402. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  403. package/ios/Tests/SectionPresentationTests.swift +85 -0
  404. package/ios/Tests/SectionScopeTests.swift +164 -0
  405. package/ios/Tests/SimpleRouterTests.swift +39 -8
  406. package/ios/Tests/SleepTimerManagerTests.swift +156 -0
  407. package/ios/Tests/StyleResolverTests.swift +123 -0
  408. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  409. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +42 -0
  410. package/ios/Tests/Support/SilentAudioFile.swift +13 -0
  411. package/ios/Tests/Support/TestTypes.swift +286 -84
  412. package/ios/Tests/Support/TimeLimit.swift +43 -0
  413. package/ios/Tests/TabBarEntriesTests.swift +69 -0
  414. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  415. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  416. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  417. package/ios/Tests/TrackIdentityTests.swift +20 -0
  418. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  419. package/ios/Tests/TrackSelectorTests.swift +171 -48
  420. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  421. package/ios/TrackSelector.swift +70 -80
  422. package/ios/Util/ArtworkFreshness.swift +42 -0
  423. package/ios/Util/ArtworkImageFetcher.swift +147 -8
  424. package/ios/Util/AwaitCallback.swift +80 -0
  425. package/ios/Util/ConcurrentMap.swift +19 -0
  426. package/ios/Util/Connectivity.swift +12 -0
  427. package/ios/Util/Deadline.swift +38 -0
  428. package/ios/Util/Emitter.swift +45 -22
  429. package/ios/Util/GenerationMemo.swift +43 -0
  430. package/ios/Util/LRUCache.swift +23 -159
  431. package/ios/Util/NetworkMonitor.swift +33 -31
  432. package/ios/Util/OutputPicker.swift +48 -0
  433. package/ios/Util/ReadyValue.swift +57 -0
  434. package/ios/Util/SFSymbolRenderer.swift +64 -49
  435. package/ios/Util/SVGProcessor.swift +9 -16
  436. package/ios/Util/SupersedingTask.swift +45 -0
  437. package/lib/commonjs/AudioBrowser.js +8 -8
  438. package/lib/commonjs/AudioBrowser.js.map +1 -1
  439. package/lib/commonjs/CLAUDE.md +57 -0
  440. package/lib/commonjs/features/battery.js +16 -12
  441. package/lib/commonjs/features/battery.js.map +1 -1
  442. package/lib/commonjs/features/browser-config.js +231 -0
  443. package/lib/commonjs/features/browser-config.js.map +1 -0
  444. package/lib/commonjs/features/browser.js +128 -169
  445. package/lib/commonjs/features/browser.js.map +1 -1
  446. package/lib/commonjs/features/carConnection.js +41 -0
  447. package/lib/commonjs/features/carConnection.js.map +1 -0
  448. package/lib/commonjs/features/equalizer.js +10 -6
  449. package/lib/commonjs/features/equalizer.js.map +1 -1
  450. package/lib/commonjs/features/errors.js +59 -13
  451. package/lib/commonjs/features/errors.js.map +1 -1
  452. package/lib/commonjs/features/favorites.js +29 -24
  453. package/lib/commonjs/features/favorites.js.map +1 -1
  454. package/lib/commonjs/features/gate.js +170 -0
  455. package/lib/commonjs/features/gate.js.map +1 -0
  456. package/lib/commonjs/features/index.js +22 -0
  457. package/lib/commonjs/features/index.js.map +1 -1
  458. package/lib/commonjs/features/metadata.js +64 -14
  459. package/lib/commonjs/features/metadata.js.map +1 -1
  460. package/lib/commonjs/features/network.js +6 -2
  461. package/lib/commonjs/features/network.js.map +1 -1
  462. package/lib/commonjs/features/nowPlaying.js +55 -6
  463. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  464. package/lib/commonjs/features/output.js +42 -23
  465. package/lib/commonjs/features/output.js.map +1 -1
  466. package/lib/commonjs/features/playback/controls.js +20 -4
  467. package/lib/commonjs/features/playback/controls.js.map +1 -1
  468. package/lib/commonjs/features/playback/index.js +11 -0
  469. package/lib/commonjs/features/playback/index.js.map +1 -1
  470. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  471. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  472. package/lib/commonjs/features/playback/playing.js +5 -3
  473. package/lib/commonjs/features/playback/playing.js.map +1 -1
  474. package/lib/commonjs/features/playback/progress.js +40 -17
  475. package/lib/commonjs/features/playback/progress.js.map +1 -1
  476. package/lib/commonjs/features/playback/rate.js +8 -1
  477. package/lib/commonjs/features/playback/rate.js.map +1 -1
  478. package/lib/commonjs/features/playback/state.js +5 -6
  479. package/lib/commonjs/features/playback/state.js.map +1 -1
  480. package/lib/commonjs/features/playback/trackPlaybackTime.js +91 -0
  481. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -0
  482. package/lib/commonjs/features/playback/volume.js +6 -5
  483. package/lib/commonjs/features/playback/volume.js.map +1 -1
  484. package/lib/commonjs/features/player/options.js +99 -39
  485. package/lib/commonjs/features/player/options.js.map +1 -1
  486. package/lib/commonjs/features/player/setup.js +258 -4
  487. package/lib/commonjs/features/player/setup.js.map +1 -1
  488. package/lib/commonjs/features/player/validateOptions.js +23 -0
  489. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  490. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  491. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  492. package/lib/commonjs/features/queue/queue.js +77 -24
  493. package/lib/commonjs/features/queue/queue.js.map +1 -1
  494. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  495. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  496. package/lib/commonjs/features/queue/shuffle.js +1 -2
  497. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  498. package/lib/commonjs/features/remoteControls.js +71 -137
  499. package/lib/commonjs/features/remoteControls.js.map +1 -1
  500. package/lib/commonjs/features/sleepTimer.js +33 -11
  501. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  502. package/lib/commonjs/native.js +5 -0
  503. package/lib/commonjs/native.js.map +1 -1
  504. package/lib/commonjs/native.web.js +4 -1
  505. package/lib/commonjs/native.web.js.map +1 -1
  506. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  507. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  508. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -17
  509. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  510. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -19
  511. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  512. package/lib/commonjs/utils/artwork.js +31 -0
  513. package/lib/commonjs/utils/artwork.js.map +1 -0
  514. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  515. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  516. package/lib/commonjs/utils/useDebug.js +16 -3
  517. package/lib/commonjs/utils/useDebug.js.map +1 -1
  518. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  519. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  520. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  521. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  522. package/lib/commonjs/web/NativeAudioBrowser.js +482 -177
  523. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  524. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  525. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  526. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +87 -0
  527. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  528. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js +34 -0
  529. package/lib/commonjs/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  530. package/lib/commonjs/web/TrackPlayer/Player.js +321 -41
  531. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  532. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +21 -0
  533. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  534. package/lib/commonjs/web/TrackPlayer/QueueManager.js +287 -0
  535. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -0
  536. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +178 -0
  537. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -0
  538. package/lib/commonjs/web/TrackPlayer/RepeatMode.js +1 -1
  539. package/lib/commonjs/web/TrackPlayer/RepeatMode.js.map +1 -1
  540. package/lib/commonjs/web/TrackPlayer/SleepTimer.js +34 -3
  541. package/lib/commonjs/web/TrackPlayer/SleepTimer.js.map +1 -1
  542. package/lib/commonjs/web/TrackPlayer/VolumeFader.js +75 -0
  543. package/lib/commonjs/web/TrackPlayer/VolumeFader.js.map +1 -0
  544. package/lib/commonjs/web/TrackPlayer/index.js +13 -5
  545. package/lib/commonjs/web/TrackPlayer/index.js.map +1 -1
  546. package/lib/commonjs/web/browser/BrowserManager.js +341 -140
  547. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  548. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  549. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  550. package/lib/commonjs/web/browser/NavigationErrorManager.js +6 -2
  551. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  552. package/lib/commonjs/web/browser/SearchManager.js +22 -25
  553. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  554. package/lib/commonjs/web/browser/assertBrowsePageShape.js +22 -0
  555. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -0
  556. package/lib/commonjs/web/browser/classifyTrackNavigation.js +41 -0
  557. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -0
  558. package/lib/commonjs/web/browser/parseSearchResponse.js +19 -0
  559. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -0
  560. package/lib/commonjs/web/browser/sections.js +89 -0
  561. package/lib/commonjs/web/browser/sections.js.map +1 -0
  562. package/lib/commonjs/web/http/HttpClient.js +4 -23
  563. package/lib/commonjs/web/http/HttpClient.js.map +1 -1
  564. package/lib/commonjs/web/http/RequestConfigBuilder.js +194 -62
  565. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  566. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  567. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  568. package/lib/commonjs/web/playbackErrorKind.js +57 -0
  569. package/lib/commonjs/web/playbackErrorKind.js.map +1 -0
  570. package/lib/commonjs/web/player/MediaSessionManager.js +121 -0
  571. package/lib/commonjs/web/player/MediaSessionManager.js.map +1 -0
  572. package/lib/commonjs/web/player/NowPlayingManager.js +10 -8
  573. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  574. package/lib/commonjs/web/player/OptionsManager.js +9 -17
  575. package/lib/commonjs/web/player/OptionsManager.js.map +1 -1
  576. package/lib/commonjs/web/player/RemoteCommandController.js +96 -0
  577. package/lib/commonjs/web/player/RemoteCommandController.js.map +1 -0
  578. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  579. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  580. package/lib/module/AudioBrowser.js +2 -1
  581. package/lib/module/AudioBrowser.js.map +1 -1
  582. package/lib/module/CLAUDE.md +57 -0
  583. package/lib/module/features/battery.js +16 -12
  584. package/lib/module/features/battery.js.map +1 -1
  585. package/lib/module/features/browser-config.js +225 -0
  586. package/lib/module/features/browser-config.js.map +1 -0
  587. package/lib/module/features/browser.js +123 -168
  588. package/lib/module/features/browser.js.map +1 -1
  589. package/lib/module/features/carConnection.js +36 -0
  590. package/lib/module/features/carConnection.js.map +1 -0
  591. package/lib/module/features/equalizer.js +10 -6
  592. package/lib/module/features/equalizer.js.map +1 -1
  593. package/lib/module/features/errors.js +59 -13
  594. package/lib/module/features/errors.js.map +1 -1
  595. package/lib/module/features/favorites.js +29 -24
  596. package/lib/module/features/favorites.js.map +1 -1
  597. package/lib/module/features/gate.js +165 -0
  598. package/lib/module/features/gate.js.map +1 -0
  599. package/lib/module/features/index.js +2 -0
  600. package/lib/module/features/index.js.map +1 -1
  601. package/lib/module/features/metadata.js +62 -14
  602. package/lib/module/features/metadata.js.map +1 -1
  603. package/lib/module/features/network.js +6 -2
  604. package/lib/module/features/network.js.map +1 -1
  605. package/lib/module/features/nowPlaying.js +53 -6
  606. package/lib/module/features/nowPlaying.js.map +1 -1
  607. package/lib/module/features/output.js +37 -19
  608. package/lib/module/features/output.js.map +1 -1
  609. package/lib/module/features/playback/controls.js +19 -4
  610. package/lib/module/features/playback/controls.js.map +1 -1
  611. package/lib/module/features/playback/index.js +1 -0
  612. package/lib/module/features/playback/index.js.map +1 -1
  613. package/lib/module/features/playback/playWhenReady.js +6 -5
  614. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  615. package/lib/module/features/playback/playing.js +5 -3
  616. package/lib/module/features/playback/playing.js.map +1 -1
  617. package/lib/module/features/playback/progress.js +40 -17
  618. package/lib/module/features/playback/progress.js.map +1 -1
  619. package/lib/module/features/playback/rate.js +8 -1
  620. package/lib/module/features/playback/rate.js.map +1 -1
  621. package/lib/module/features/playback/state.js +5 -6
  622. package/lib/module/features/playback/state.js.map +1 -1
  623. package/lib/module/features/playback/trackPlaybackTime.js +88 -0
  624. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -0
  625. package/lib/module/features/playback/volume.js +6 -5
  626. package/lib/module/features/playback/volume.js.map +1 -1
  627. package/lib/module/features/player/options.js +99 -39
  628. package/lib/module/features/player/options.js.map +1 -1
  629. package/lib/module/features/player/setup.js +258 -4
  630. package/lib/module/features/player/setup.js.map +1 -1
  631. package/lib/module/features/player/validateOptions.js +19 -0
  632. package/lib/module/features/player/validateOptions.js.map +1 -0
  633. package/lib/module/features/queue/activeTrack.js +15 -5
  634. package/lib/module/features/queue/activeTrack.js.map +1 -1
  635. package/lib/module/features/queue/queue.js +76 -24
  636. package/lib/module/features/queue/queue.js.map +1 -1
  637. package/lib/module/features/queue/repeatMode.js +3 -2
  638. package/lib/module/features/queue/repeatMode.js.map +1 -1
  639. package/lib/module/features/queue/shuffle.js +1 -2
  640. package/lib/module/features/queue/shuffle.js.map +1 -1
  641. package/lib/module/features/remoteControls.js +70 -136
  642. package/lib/module/features/remoteControls.js.map +1 -1
  643. package/lib/module/features/sleepTimer.js +34 -12
  644. package/lib/module/features/sleepTimer.js.map +1 -1
  645. package/lib/module/native.js +5 -0
  646. package/lib/module/native.js.map +1 -1
  647. package/lib/module/native.web.js +4 -1
  648. package/lib/module/native.web.js.map +1 -1
  649. package/lib/module/test-utils/reactNativeStub.js +58 -0
  650. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  651. package/lib/module/utils/LazyNativeEmitter.js +25 -17
  652. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  653. package/lib/module/utils/NativeUpdatedValue.js +32 -19
  654. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  655. package/lib/module/utils/artwork.js +26 -0
  656. package/lib/module/utils/artwork.js.map +1 -0
  657. package/lib/module/utils/getTrackIdentity.js +22 -0
  658. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  659. package/lib/module/utils/useDebug.js +16 -3
  660. package/lib/module/utils/useDebug.js.map +1 -1
  661. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  662. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  663. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  664. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  665. package/lib/module/web/NativeAudioBrowser.js +483 -178
  666. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  667. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  668. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  669. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +83 -0
  670. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -0
  671. package/lib/module/web/TrackPlayer/PlaybackTimer.js +29 -0
  672. package/lib/module/web/TrackPlayer/PlaybackTimer.js.map +1 -0
  673. package/lib/module/web/TrackPlayer/Player.js +321 -41
  674. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  675. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +17 -0
  676. package/lib/module/web/TrackPlayer/PlayingStateFactory.js.map +1 -0
  677. package/lib/module/web/TrackPlayer/QueueManager.js +283 -0
  678. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -0
  679. package/lib/module/web/TrackPlayer/QueuePlayer.js +174 -0
  680. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -0
  681. package/lib/module/web/TrackPlayer/RepeatMode.js +1 -1
  682. package/lib/module/web/TrackPlayer/RepeatMode.js.map +1 -1
  683. package/lib/module/web/TrackPlayer/SleepTimer.js +34 -3
  684. package/lib/module/web/TrackPlayer/SleepTimer.js.map +1 -1
  685. package/lib/module/web/TrackPlayer/VolumeFader.js +70 -0
  686. package/lib/module/web/TrackPlayer/VolumeFader.js.map +1 -0
  687. package/lib/module/web/TrackPlayer/index.js +2 -1
  688. package/lib/module/web/TrackPlayer/index.js.map +1 -1
  689. package/lib/module/web/browser/BrowserManager.js +341 -140
  690. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  691. package/lib/module/web/browser/FavoriteManager.js +31 -21
  692. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  693. package/lib/module/web/browser/NavigationErrorManager.js +6 -2
  694. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  695. package/lib/module/web/browser/SearchManager.js +22 -25
  696. package/lib/module/web/browser/SearchManager.js.map +1 -1
  697. package/lib/module/web/browser/assertBrowsePageShape.js +18 -0
  698. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -0
  699. package/lib/module/web/browser/classifyTrackNavigation.js +38 -0
  700. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -0
  701. package/lib/module/web/browser/parseSearchResponse.js +15 -0
  702. package/lib/module/web/browser/parseSearchResponse.js.map +1 -0
  703. package/lib/module/web/browser/sections.js +83 -0
  704. package/lib/module/web/browser/sections.js.map +1 -0
  705. package/lib/module/web/http/HttpClient.js +4 -23
  706. package/lib/module/web/http/HttpClient.js.map +1 -1
  707. package/lib/module/web/http/RequestConfigBuilder.js +194 -62
  708. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  709. package/lib/module/web/http/followMediaRedirect.js +215 -0
  710. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  711. package/lib/module/web/playbackErrorKind.js +52 -0
  712. package/lib/module/web/playbackErrorKind.js.map +1 -0
  713. package/lib/module/web/player/MediaSessionManager.js +116 -0
  714. package/lib/module/web/player/MediaSessionManager.js.map +1 -0
  715. package/lib/module/web/player/NowPlayingManager.js +11 -8
  716. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  717. package/lib/module/web/player/OptionsManager.js +9 -17
  718. package/lib/module/web/player/OptionsManager.js.map +1 -1
  719. package/lib/module/web/player/RemoteCommandController.js +92 -0
  720. package/lib/module/web/player/RemoteCommandController.js.map +1 -0
  721. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  722. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  723. package/lib/typescript/package.json +1 -0
  724. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  725. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  726. package/lib/typescript/src/features/battery.d.ts +17 -12
  727. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  728. package/lib/typescript/src/features/browser-config.d.ts +12 -0
  729. package/lib/typescript/src/features/browser-config.d.ts.map +1 -0
  730. package/lib/typescript/src/features/browser.d.ts +99 -12
  731. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  732. package/lib/typescript/src/features/carConnection.d.ts +19 -0
  733. package/lib/typescript/src/features/carConnection.d.ts.map +1 -0
  734. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  735. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  736. package/lib/typescript/src/features/errors.d.ts +84 -14
  737. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  738. package/lib/typescript/src/features/favorites.d.ts +29 -24
  739. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  740. package/lib/typescript/src/features/gate.d.ts +99 -0
  741. package/lib/typescript/src/features/gate.d.ts.map +1 -0
  742. package/lib/typescript/src/features/index.d.ts +2 -0
  743. package/lib/typescript/src/features/index.d.ts.map +1 -1
  744. package/lib/typescript/src/features/metadata.d.ts +74 -21
  745. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  746. package/lib/typescript/src/features/network.d.ts +6 -2
  747. package/lib/typescript/src/features/network.d.ts.map +1 -1
  748. package/lib/typescript/src/features/nowPlaying.d.ts +47 -6
  749. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  750. package/lib/typescript/src/features/output.d.ts +33 -18
  751. package/lib/typescript/src/features/output.d.ts.map +1 -1
  752. package/lib/typescript/src/features/playback/controls.d.ts +16 -4
  753. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  754. package/lib/typescript/src/features/playback/index.d.ts +1 -0
  755. package/lib/typescript/src/features/playback/index.d.ts.map +1 -1
  756. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  757. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  758. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  759. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  760. package/lib/typescript/src/features/playback/progress.d.ts +14 -5
  761. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  762. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  763. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  764. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  765. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  766. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +41 -0
  767. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -0
  768. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  769. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  770. package/lib/typescript/src/features/player/options.d.ts +211 -145
  771. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  772. package/lib/typescript/src/features/player/setup.d.ts +288 -186
  773. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  774. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  775. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  776. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  777. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  778. package/lib/typescript/src/features/queue/queue.d.ts +65 -20
  779. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  780. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  781. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  782. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  783. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  784. package/lib/typescript/src/features/remoteControls.d.ts +81 -60
  785. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  786. package/lib/typescript/src/features/sleepTimer.d.ts +34 -11
  787. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  788. package/lib/typescript/src/index.d.ts.map +1 -1
  789. package/lib/typescript/src/native.d.ts +1 -2
  790. package/lib/typescript/src/native.d.ts.map +1 -1
  791. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +16 -225
  792. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  793. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  794. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  795. package/lib/typescript/src/types/browser-native.d.ts +10 -3
  796. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  797. package/lib/typescript/src/types/browser-nodes.d.ts +474 -84
  798. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  799. package/lib/typescript/src/types/browser.d.ts +518 -179
  800. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  801. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -18
  802. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  803. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -22
  804. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  805. package/lib/typescript/src/utils/artwork.d.ts +19 -0
  806. package/lib/typescript/src/utils/artwork.d.ts.map +1 -0
  807. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  808. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  809. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  810. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  811. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  812. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  813. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  814. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  815. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  816. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  817. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +3 -2
  818. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +28 -12
  819. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +8 -8
  820. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -22
  822. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  825. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +43 -6
  826. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +61 -0
  827. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JBrowseResult.hpp +24 -7
  832. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +5 -5
  834. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  835. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  837. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  839. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +16 -5
  840. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  841. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +105 -0
  842. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +5 -4
  843. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +112 -0
  844. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +121 -0
  845. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +128 -0
  846. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  847. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +138 -0
  848. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +126 -0
  849. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +139 -0
  850. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  852. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +16 -5
  853. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +134 -0
  854. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +26 -12
  855. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +16 -4
  856. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  857. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +143 -0
  858. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +16 -5
  863. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +79 -0
  864. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -12
  866. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +13 -11
  867. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +80 -0
  868. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +4 -2
  869. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +16 -5
  870. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +4 -2
  871. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  875. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  881. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  883. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  884. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +12 -12
  885. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  886. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  887. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +23 -5
  888. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  889. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  890. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  891. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +30 -18
  892. package/nitrogen/generated/android/c++/JGate.hpp +62 -0
  893. package/nitrogen/generated/android/c++/JGateDecision.hpp +64 -0
  894. package/nitrogen/generated/android/c++/JGateEvent.hpp +58 -0
  895. package/nitrogen/generated/android/c++/JGateReason.hpp +58 -0
  896. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  897. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  898. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +317 -255
  899. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +30 -25
  900. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  901. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  902. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  903. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  904. package/nitrogen/generated/android/c++/JIOSOptions.hpp +101 -0
  905. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  906. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  907. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  908. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  909. package/nitrogen/generated/android/c++/JMediaReference.hpp +58 -0
  910. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +43 -6
  911. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  912. package/nitrogen/generated/android/c++/{JPartialAndroidSetupPlayerOptions.hpp → JNativeAndroidSetupOptions.hpp} +10 -10
  913. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +100 -40
  914. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +74 -0
  915. package/nitrogen/generated/android/c++/{JPartialIOSSetupPlayerOptions.hpp → JNativeIOSSetupOptions.hpp} +18 -18
  916. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +36 -13
  917. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +191 -0
  918. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +20 -26
  919. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  920. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  921. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  922. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +8 -2
  923. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -22
  924. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +102 -0
  925. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +5 -19
  926. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +9 -5
  927. package/nitrogen/generated/android/c++/JOptions.hpp +18 -16
  928. package/nitrogen/generated/android/c++/{JIosOutput.hpp → JOutput.hpp} +15 -15
  929. package/nitrogen/generated/android/c++/JOutputType.hpp +88 -0
  930. package/nitrogen/generated/android/c++/JPlayback.hpp +4 -2
  931. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +16 -5
  932. package/nitrogen/generated/android/c++/JPlaybackError.hpp +20 -5
  933. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +4 -2
  934. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +76 -0
  935. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  936. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  937. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  938. package/nitrogen/generated/android/c++/JPlaybackState.hpp +5 -5
  939. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +2 -2
  940. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  941. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  942. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +20 -20
  943. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  944. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  945. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  946. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  947. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  948. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  949. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  950. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  951. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  952. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  953. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  954. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +85 -59
  955. package/nitrogen/generated/android/c++/JRetryConfig.hpp +13 -9
  956. package/nitrogen/generated/android/c++/JSearchMode.hpp +29 -11
  957. package/nitrogen/generated/android/c++/JSearchParams.hpp +11 -5
  958. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  959. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  960. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  961. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  962. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  963. package/nitrogen/generated/android/c++/JStallReason.hpp +58 -0
  964. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  965. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  966. package/nitrogen/generated/android/c++/JTrack.hpp +45 -48
  967. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +31 -15
  968. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  969. package/nitrogen/generated/android/c++/JTrackRequest.hpp +93 -0
  970. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  971. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +16 -3
  972. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  973. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  974. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  975. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  976. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  977. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.cpp +41 -0
  978. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +133 -0
  979. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.cpp +26 -0
  980. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +70 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioContentType.kt +4 -4
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -9
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{RatingType.kt → ArtworkRendering.kt} +5 -10
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +47 -4
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +56 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayNowPlayingButton.kt +3 -3
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → CarPlayPlayingIndicatorLocation.kt} +5 -8
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +71 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +17 -2
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +78 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +78 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +78 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +78 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +78 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +78 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +78 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.kt → Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt} +12 -14
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_RemoteSetRatingEvent.kt → Func_void_GateEvent.kt} +9 -11
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Func_void_IosOutput.kt → Func_void_Output.kt} +9 -11
  1026. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  1027. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  1028. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  1032. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  1033. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  1034. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  1035. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  1036. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  1037. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  1038. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  1039. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  1040. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  1041. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  1042. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +9 -11
  1043. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  1044. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  1045. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  1046. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  1047. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  1048. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  1049. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  1050. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +56 -0
  1051. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +56 -0
  1052. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +51 -0
  1053. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateReason.kt +23 -0
  1054. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  1055. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +114 -110
  1056. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +66 -0
  1057. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  1058. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  1059. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  1060. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  1061. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaReference.kt +23 -0
  1062. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +45 -4
  1063. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  1064. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{PartialAndroidSetupPlayerOptions.kt → NativeAndroidSetupOptions.kt} +36 -5
  1065. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +64 -6
  1066. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +61 -0
  1067. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +71 -0
  1068. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +31 -4
  1069. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +100 -0
  1070. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +29 -6
  1071. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  1072. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  1073. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  1074. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorType.kt +3 -1
  1075. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -9
  1076. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +66 -0
  1077. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +32 -6
  1078. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +23 -3
  1079. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +26 -3
  1080. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +61 -0
  1081. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +33 -0
  1082. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  1083. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +33 -3
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorKind.kt +29 -0
  1087. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  1088. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  1089. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  1090. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackState.kt +6 -6
  1091. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +35 -0
  1092. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  1093. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  1094. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButton.kt +26 -0
  1095. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  1096. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  1097. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  1098. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  1099. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  1100. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1101. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1102. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1103. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1104. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1105. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +74 -13
  1106. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +24 -4
  1107. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchMode.kt +12 -6
  1108. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +33 -3
  1109. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1110. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1111. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1112. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1113. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1114. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StallReason.kt +23 -0
  1115. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1116. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1117. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +62 -10
  1118. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1119. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1120. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +61 -0
  1121. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1122. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +38 -4
  1123. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1124. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1125. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1126. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  1127. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +75 -0
  1128. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +62 -0
  1129. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1130. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +162 -42
  1131. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +1476 -684
  1132. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +91 -49
  1133. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +219 -124
  1134. package/nitrogen/generated/ios/swift/AndroidAudioContentType.swift +8 -8
  1135. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -22
  1136. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1137. package/nitrogen/generated/ios/swift/ArtworkRequestConfig.swift +95 -1
  1138. package/nitrogen/generated/ios/swift/ArtworkVariants.swift +34 -0
  1139. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1140. package/nitrogen/generated/ios/swift/CarPlayNowPlayingButton.swift +4 -4
  1141. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1142. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1143. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1144. package/nitrogen/generated/ios/swift/FormatNowPlayingParams.swift +67 -0
  1145. package/nitrogen/generated/ios/swift/FormattedNavigationError.swift +17 -4
  1146. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.swift +54 -0
  1147. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.swift +69 -0
  1148. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_RequestConfig___Track.swift +54 -0
  1149. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.swift +60 -0
  1150. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__optional_std__string____Track.swift +60 -0
  1151. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.swift +61 -0
  1152. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.swift +61 -0
  1153. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1154. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.swift +77 -0
  1155. package/nitrogen/generated/ios/swift/Func_void_GateDecision.swift +46 -0
  1156. package/nitrogen/generated/ios/swift/{Func_void_RemoteSetRatingEvent.swift → Func_void_GateEvent.swift} +10 -10
  1157. package/nitrogen/generated/ios/swift/{Func_void_IosOutput.swift → Func_void_Output.swift} +10 -10
  1158. package/nitrogen/generated/ios/swift/Func_void_TransformableRequestConfig.swift +46 -0
  1159. package/nitrogen/generated/ios/swift/Func_void_bool.swift +5 -5
  1160. package/nitrogen/generated/ios/swift/Func_void_std__optional_NowPlayingUpdate_.swift +46 -0
  1161. package/nitrogen/generated/ios/swift/Func_void_std__optional_std__string_.swift +53 -0
  1162. package/nitrogen/generated/ios/swift/{Func_void_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError___.swift → Func_void_std__shared_ptr_Promise_GateDecision__.swift} +17 -17
  1163. package/nitrogen/generated/ios/swift/Func_void_std__shared_ptr_Promise_TransformableRequestConfig__.swift +66 -0
  1164. package/nitrogen/generated/ios/swift/Func_void_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError____.swift +81 -0
  1165. package/nitrogen/generated/ios/swift/Gate.swift +47 -0
  1166. package/nitrogen/generated/ios/swift/GateDecision.swift +40 -0
  1167. package/nitrogen/generated/ios/swift/GateEvent.swift +29 -0
  1168. package/nitrogen/generated/ios/swift/GateReason.swift +40 -0
  1169. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1170. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +23 -15
  1171. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +262 -199
  1172. package/nitrogen/generated/ios/swift/IOSOptions.swift +56 -0
  1173. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1174. package/nitrogen/generated/ios/swift/MediaReference.swift +40 -0
  1175. package/nitrogen/generated/ios/swift/MediaRequestConfig.swift +107 -1
  1176. package/nitrogen/generated/ios/swift/{PartialAndroidSetupPlayerOptions.swift → NativeAndroidSetupOptions.swift} +5 -5
  1177. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +208 -22
  1178. package/nitrogen/generated/ios/swift/NativeGateRequest.swift +58 -0
  1179. package/nitrogen/generated/ios/swift/{PartialIOSSetupPlayerOptions.swift → NativeIOSSetupOptions.swift} +5 -5
  1180. package/nitrogen/generated/ios/swift/NativeRouteEntry.swift +19 -19
  1181. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +217 -0
  1182. package/nitrogen/generated/ios/swift/NativeUpdateOptions.swift +12 -25
  1183. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1184. package/nitrogen/generated/ios/swift/NavigationErrorType.swift +8 -0
  1185. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -41
  1186. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +101 -0
  1187. package/nitrogen/generated/ios/swift/NowPlayingMetadata.swift +1 -48
  1188. package/nitrogen/generated/ios/swift/NowPlayingUpdate.swift +19 -1
  1189. package/nitrogen/generated/ios/swift/Options.swift +10 -4
  1190. package/nitrogen/generated/ios/swift/{IosOutput.swift → Output.swift} +7 -7
  1191. package/nitrogen/generated/ios/swift/OutputType.swift +80 -0
  1192. package/nitrogen/generated/ios/swift/PlaybackError.swift +43 -2
  1193. package/nitrogen/generated/ios/swift/PlaybackErrorKind.swift +64 -0
  1194. package/nitrogen/generated/ios/swift/PlaybackState.swift +4 -4
  1195. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +10 -10
  1196. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  1197. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1198. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +125 -70
  1199. package/nitrogen/generated/ios/swift/RetryConfig.swift +35 -4
  1200. package/nitrogen/generated/ios/swift/SearchMode.swift +36 -12
  1201. package/nitrogen/generated/ios/swift/SearchParams.swift +7 -2
  1202. package/nitrogen/generated/ios/swift/{ImageRowItem.swift → Section.swift} +33 -27
  1203. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1204. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1205. package/nitrogen/generated/ios/swift/StallReason.swift +40 -0
  1206. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1207. package/nitrogen/generated/ios/swift/Track.swift +91 -60
  1208. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1209. package/nitrogen/generated/ios/swift/TrackRequest.swift +106 -0
  1210. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1211. package/nitrogen/generated/ios/swift/TransformableRequestConfig.swift +60 -1
  1212. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1213. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1214. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1215. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  1216. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +32 -0
  1217. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +30 -0
  1218. package/nitrogen/generated/shared/c++/AndroidAudioContentType.hpp +10 -10
  1219. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -19
  1220. package/nitrogen/generated/shared/c++/ArtworkRendering.hpp +76 -0
  1221. package/nitrogen/generated/shared/c++/ArtworkRequestConfig.hpp +10 -2
  1222. package/nitrogen/generated/shared/c++/{HeartRating.hpp → ArtworkVariants.hpp} +20 -16
  1223. package/nitrogen/generated/shared/c++/CarPlayNowPlayingButton.hpp +6 -6
  1224. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1225. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1226. package/nitrogen/generated/shared/c++/EqualizerSettings.hpp +0 -2
  1227. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1228. package/nitrogen/generated/shared/c++/FormatNowPlayingParams.hpp +110 -0
  1229. package/nitrogen/generated/shared/c++/FormattedNavigationError.hpp +6 -5
  1230. package/nitrogen/generated/shared/c++/{StarRating.hpp → Gate.hpp} +21 -16
  1231. package/nitrogen/generated/shared/c++/{ThumbsRating.hpp → GateDecision.hpp} +23 -17
  1232. package/nitrogen/generated/shared/c++/{PercentageRating.hpp → GateEvent.hpp} +18 -17
  1233. package/nitrogen/generated/shared/c++/GateReason.hpp +76 -0
  1234. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1235. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +24 -19
  1236. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +47 -36
  1237. package/nitrogen/generated/shared/c++/IOSOptions.hpp +98 -0
  1238. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1239. package/nitrogen/generated/shared/c++/MediaReference.hpp +76 -0
  1240. package/nitrogen/generated/shared/c++/MediaRequestConfig.hpp +10 -2
  1241. package/nitrogen/generated/shared/c++/{PartialAndroidSetupPlayerOptions.hpp → NativeAndroidSetupOptions.hpp} +11 -11
  1242. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +35 -15
  1243. package/nitrogen/generated/shared/c++/NativeGateRequest.hpp +97 -0
  1244. package/nitrogen/generated/shared/c++/{PartialIOSSetupPlayerOptions.hpp → NativeIOSSetupOptions.hpp} +11 -11
  1245. package/nitrogen/generated/shared/c++/NativeRouteEntry.hpp +5 -5
  1246. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +145 -0
  1247. package/nitrogen/generated/shared/c++/NativeUpdateOptions.hpp +9 -7
  1248. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1249. package/nitrogen/generated/shared/c++/NavigationErrorType.hpp +8 -0
  1250. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -19
  1251. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +99 -0
  1252. package/nitrogen/generated/shared/c++/NowPlayingMetadata.hpp +3 -19
  1253. package/nitrogen/generated/shared/c++/NowPlayingUpdate.hpp +6 -2
  1254. package/nitrogen/generated/shared/c++/Options.hpp +8 -8
  1255. package/nitrogen/generated/shared/c++/{IosOutput.hpp → Output.hpp} +18 -18
  1256. package/nitrogen/generated/shared/c++/OutputType.hpp +116 -0
  1257. package/nitrogen/generated/shared/c++/PlaybackError.hpp +18 -3
  1258. package/nitrogen/generated/shared/c++/PlaybackErrorKind.hpp +100 -0
  1259. package/nitrogen/generated/shared/c++/PlaybackState.hpp +9 -9
  1260. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +25 -25
  1261. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  1262. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1263. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +52 -37
  1264. package/nitrogen/generated/shared/c++/RetryConfig.hpp +10 -6
  1265. package/nitrogen/generated/shared/c++/SearchMode.hpp +39 -15
  1266. package/nitrogen/generated/shared/c++/SearchParams.hpp +9 -2
  1267. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1268. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1269. package/nitrogen/generated/shared/c++/StallReason.hpp +76 -0
  1270. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1271. package/nitrogen/generated/shared/c++/Track.hpp +37 -30
  1272. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1273. package/nitrogen/generated/shared/c++/TrackRequest.hpp +93 -0
  1274. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1275. package/nitrogen/generated/shared/c++/TransformableRequestConfig.hpp +6 -2
  1276. package/package.json +50 -20
  1277. package/src/AudioBrowser.ts +2 -1
  1278. package/src/CLAUDE.md +57 -0
  1279. package/src/codegen-no-config-variant.test.ts +70 -0
  1280. package/src/docs-floors.test.ts +71 -0
  1281. package/src/features/battery.test.ts +79 -0
  1282. package/src/features/battery.ts +17 -13
  1283. package/src/features/browser-config.test.ts +125 -0
  1284. package/src/features/browser-config.ts +297 -0
  1285. package/src/features/browser.test.ts +19 -0
  1286. package/src/features/browser.ts +119 -213
  1287. package/src/features/carConnection.ts +35 -0
  1288. package/src/features/equalizer.ts +10 -6
  1289. package/src/features/errors.ts +94 -13
  1290. package/src/features/favorites.ts +29 -24
  1291. package/src/features/gate.test.ts +72 -0
  1292. package/src/features/gate.ts +176 -0
  1293. package/src/features/hook-wiring.test.ts +302 -0
  1294. package/src/features/index.ts +2 -0
  1295. package/src/features/metadata.ts +89 -29
  1296. package/src/features/network.ts +6 -2
  1297. package/src/features/nowPlaying.ts +56 -6
  1298. package/src/features/output.ts +40 -22
  1299. package/src/features/playback/controls.ts +19 -4
  1300. package/src/features/playback/index.ts +1 -0
  1301. package/src/features/playback/playWhenReady.ts +6 -5
  1302. package/src/features/playback/playing.ts +16 -3
  1303. package/src/features/playback/progress.test.ts +169 -0
  1304. package/src/features/playback/progress.ts +43 -17
  1305. package/src/features/playback/rate.ts +8 -1
  1306. package/src/features/playback/state.ts +10 -6
  1307. package/src/features/playback/trackPlaybackTime.test.ts +76 -0
  1308. package/src/features/playback/trackPlaybackTime.ts +108 -0
  1309. package/src/features/playback/volume.ts +6 -5
  1310. package/src/features/player/options.test.ts +38 -0
  1311. package/src/features/player/options.ts +254 -128
  1312. package/src/features/player/setup.test.ts +134 -0
  1313. package/src/features/player/setup.ts +481 -194
  1314. package/src/features/player/validateOptions.ts +21 -0
  1315. package/src/features/queue/activeTrack.ts +15 -5
  1316. package/src/features/queue/queue.test.ts +36 -0
  1317. package/src/features/queue/queue.ts +80 -24
  1318. package/src/features/queue/repeatMode.ts +2 -2
  1319. package/src/features/queue/shuffle.ts +1 -2
  1320. package/src/features/remoteControls.ts +70 -148
  1321. package/src/features/sleepTimer.test.ts +171 -0
  1322. package/src/features/sleepTimer.ts +48 -13
  1323. package/src/native.ts +5 -0
  1324. package/src/native.web.ts +4 -1
  1325. package/src/nitro-stub-drift.test.ts +277 -0
  1326. package/src/public-surface.test.ts +147 -0
  1327. package/src/specs/audio-browser.nitro.ts +146 -42
  1328. package/src/style-resolution.test.ts +210 -0
  1329. package/src/test-utils/reactNativeStub.ts +60 -0
  1330. package/src/types/browser-native.ts +24 -7
  1331. package/src/types/browser-nodes.ts +505 -92
  1332. package/src/types/browser.ts +548 -183
  1333. package/src/utils/LazyNativeEmitter.ts +25 -17
  1334. package/src/utils/NativeUpdatedValue.ts +30 -18
  1335. package/src/utils/artwork.ts +30 -0
  1336. package/src/utils/getTrackIdentity.ts +22 -0
  1337. package/src/utils/useDebug.test.ts +182 -0
  1338. package/src/utils/useDebug.ts +16 -3
  1339. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1340. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1341. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1342. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1343. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +564 -0
  1344. package/src/web/NativeAudioBrowser.ts +588 -219
  1345. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1346. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +186 -0
  1347. package/src/web/TrackPlayer/PlaybackStateMachine.ts +98 -0
  1348. package/src/web/TrackPlayer/PlaybackTimer.test.ts +67 -0
  1349. package/src/web/TrackPlayer/PlaybackTimer.ts +33 -0
  1350. package/src/web/TrackPlayer/Player.dispatch.test.ts +274 -0
  1351. package/src/web/TrackPlayer/Player.load.test.ts +222 -0
  1352. package/src/web/TrackPlayer/Player.ts +377 -55
  1353. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +51 -0
  1354. package/src/web/TrackPlayer/PlayingStateFactory.ts +24 -0
  1355. package/src/web/TrackPlayer/QueueManager.test.ts +318 -0
  1356. package/src/web/TrackPlayer/QueueManager.ts +316 -0
  1357. package/src/web/TrackPlayer/QueuePlayer.ts +206 -0
  1358. package/src/web/TrackPlayer/RepeatMode.ts +1 -1
  1359. package/src/web/TrackPlayer/SleepTimer.ts +38 -3
  1360. package/src/web/TrackPlayer/VolumeFader.ts +74 -0
  1361. package/src/web/TrackPlayer/index.ts +2 -1
  1362. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1363. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1364. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1365. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1366. package/src/web/__tests__/retry.test.ts +169 -0
  1367. package/src/web/browser/BrowserManager.ts +421 -154
  1368. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1369. package/src/web/browser/FavoriteManager.ts +28 -23
  1370. package/src/web/browser/NavigationErrorManager.ts +6 -2
  1371. package/src/web/browser/SearchManager.test.ts +75 -0
  1372. package/src/web/browser/SearchManager.ts +26 -33
  1373. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1374. package/src/web/browser/__tests__/layer-resolver.test.ts +104 -0
  1375. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1376. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1377. package/src/web/browser/assertBrowsePageShape.test.ts +27 -0
  1378. package/src/web/browser/assertBrowsePageShape.ts +29 -0
  1379. package/src/web/browser/classifyTrackNavigation.test.ts +43 -0
  1380. package/src/web/browser/classifyTrackNavigation.ts +35 -0
  1381. package/src/web/browser/parseSearchResponse.test.ts +31 -0
  1382. package/src/web/browser/parseSearchResponse.ts +14 -0
  1383. package/src/web/browser/sections.test.ts +91 -0
  1384. package/src/web/browser/sections.ts +72 -0
  1385. package/src/web/http/HttpClient.ts +5 -35
  1386. package/src/web/http/RequestConfigBuilder.test.ts +299 -0
  1387. package/src/web/http/RequestConfigBuilder.ts +230 -66
  1388. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1389. package/src/web/http/followMediaRedirect.ts +253 -0
  1390. package/src/web/playbackErrorKind.test.ts +55 -0
  1391. package/src/web/playbackErrorKind.ts +56 -0
  1392. package/src/web/player/MediaSessionManager.test.ts +220 -0
  1393. package/src/web/player/MediaSessionManager.ts +151 -0
  1394. package/src/web/player/NowPlayingManager.test.ts +46 -0
  1395. package/src/web/player/NowPlayingManager.ts +10 -8
  1396. package/src/web/player/OptionsManager.ts +12 -18
  1397. package/src/web/player/RemoteCommandController.test.ts +171 -0
  1398. package/src/web/player/RemoteCommandController.ts +166 -0
  1399. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1400. package/src/web/util/BrowserPathHelper.ts +68 -13
  1401. package/website/guide/android-auto.md +126 -0
  1402. package/website/guide/android-certificates.md +488 -0
  1403. package/website/guide/artwork.md +300 -0
  1404. package/website/guide/audio-output.md +382 -0
  1405. package/website/guide/automotive.md +91 -0
  1406. package/website/guide/basic-usage.md +154 -0
  1407. package/website/guide/battery.md +142 -0
  1408. package/website/guide/browser.md +674 -0
  1409. package/website/guide/carplay.md +733 -0
  1410. package/website/guide/configuration.md +215 -0
  1411. package/website/guide/equalizer.md +235 -0
  1412. package/website/guide/errors.md +359 -0
  1413. package/website/guide/favorites.md +164 -0
  1414. package/website/guide/gate.md +157 -0
  1415. package/website/guide/getting-started.md +99 -0
  1416. package/website/guide/hooks.md +247 -0
  1417. package/website/guide/live-streams.md +218 -0
  1418. package/website/guide/metadata.md +289 -0
  1419. package/website/guide/migrating-from-track-player.md +289 -0
  1420. package/website/guide/native-callback-fetch.md +137 -0
  1421. package/website/guide/network.md +103 -0
  1422. package/website/guide/now-playing.md +203 -0
  1423. package/website/guide/playback.md +405 -0
  1424. package/website/guide/queue.md +334 -0
  1425. package/website/guide/remote-controls.md +314 -0
  1426. package/website/guide/search.md +270 -0
  1427. package/website/guide/sleep-timer.md +289 -0
  1428. package/website/guide/track.md +271 -0
  1429. package/android/src/main/java/com/audiobrowser/player/PlaybackProgressUpdateManager.kt +0 -59
  1430. package/android/src/main/java/com/audiobrowser/util/RatingFactory.kt +0 -72
  1431. package/android/src/main/java/com/audiobrowser/util/ResolvedTrackFactory.kt +0 -36
  1432. package/android/src/test/java/com/audiobrowser/player/PlaybackProgressUpdateManagerTest.kt +0 -146
  1433. package/ios/Bridge.h +0 -8
  1434. package/ios/Browser/BrowserManager+URLResolution.swift +0 -260
  1435. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -60
  1436. package/ios/CarPlay/Track+CarPlay.swift +0 -63
  1437. package/ios/Model/MediaURL.swift +0 -67
  1438. package/ios/Model/SourceType.swift +0 -6
  1439. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1440. package/ios/NowPlayingInfo/NowPlayingInfoCenter.swift +0 -9
  1441. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1442. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1443. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -79
  1444. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -110
  1445. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1446. package/ios/Observer/PlayerTimeObserver.swift +0 -105
  1447. package/ios/Option/PitchAlgorithms.swift +0 -17
  1448. package/ios/Option/TimeEventFrequency.swift +0 -18
  1449. package/ios/Player/LoadSeekCoordinator.swift +0 -84
  1450. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1451. package/ios/Player/PlaybackCoordinator.swift +0 -520
  1452. package/ios/Player/PlaybackEffectHandler.swift +0 -44
  1453. package/ios/Player/PlaybackErrorHandler.swift +0 -91
  1454. package/ios/Player/PlaybackProgressUpdateManager.swift +0 -68
  1455. package/ios/Player/PlayingStateManager.swift +0 -32
  1456. package/ios/Player/RetryManager.swift +0 -246
  1457. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1458. package/ios/Player/SleepTimerHandling.swift +0 -7
  1459. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1460. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -294
  1461. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -486
  1462. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -213
  1463. package/ios/Tests/PlaybackProgressUpdateManagerTests.swift +0 -166
  1464. package/ios/TrackPlayer.swift +0 -692
  1465. package/ios/TrackPlayerCallbacks.swift +0 -92
  1466. package/ios/Util/MetadataAdapter.swift +0 -131
  1467. package/ios/Util/OnceValue.swift +0 -70
  1468. package/lib/commonjs/features/rating.js +0 -2
  1469. package/lib/commonjs/features/rating.js.map +0 -1
  1470. package/lib/commonjs/types/player.js +0 -2
  1471. package/lib/commonjs/types/player.js.map +0 -1
  1472. package/lib/commonjs/web/SimpleRouter.test.js +0 -174
  1473. package/lib/commonjs/web/SimpleRouter.test.js.map +0 -1
  1474. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js +0 -293
  1475. package/lib/commonjs/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1476. package/lib/module/features/rating.js +0 -2
  1477. package/lib/module/features/rating.js.map +0 -1
  1478. package/lib/module/types/player.js +0 -2
  1479. package/lib/module/types/player.js.map +0 -1
  1480. package/lib/module/web/SimpleRouter.test.js +0 -174
  1481. package/lib/module/web/SimpleRouter.test.js.map +0 -1
  1482. package/lib/module/web/TrackPlayer/PlaylistPlayer.js +0 -288
  1483. package/lib/module/web/TrackPlayer/PlaylistPlayer.js.map +0 -1
  1484. package/lib/typescript/src/features/rating.d.ts +0 -14
  1485. package/lib/typescript/src/features/rating.d.ts.map +0 -1
  1486. package/lib/typescript/src/native.web.d.ts +0 -3
  1487. package/lib/typescript/src/native.web.d.ts.map +0 -1
  1488. package/lib/typescript/src/types/player.d.ts +0 -64
  1489. package/lib/typescript/src/types/player.d.ts.map +0 -1
  1490. package/lib/typescript/src/web/NativeAudioBrowser.d.ts +0 -188
  1491. package/lib/typescript/src/web/NativeAudioBrowser.d.ts.map +0 -1
  1492. package/lib/typescript/src/web/SimpleRouter.d.ts +0 -40
  1493. package/lib/typescript/src/web/SimpleRouter.d.ts.map +0 -1
  1494. package/lib/typescript/src/web/SimpleRouter.test.d.ts +0 -2
  1495. package/lib/typescript/src/web/SimpleRouter.test.d.ts.map +0 -1
  1496. package/lib/typescript/src/web/TrackPlayer/Event.d.ts +0 -11
  1497. package/lib/typescript/src/web/TrackPlayer/Event.d.ts.map +0 -1
  1498. package/lib/typescript/src/web/TrackPlayer/Player.d.ts +0 -59
  1499. package/lib/typescript/src/web/TrackPlayer/Player.d.ts.map +0 -1
  1500. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts +0 -39
  1501. package/lib/typescript/src/web/TrackPlayer/PlaylistPlayer.d.ts.map +0 -1
  1502. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts +0 -6
  1503. package/lib/typescript/src/web/TrackPlayer/RepeatMode.d.ts.map +0 -1
  1504. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts +0 -4
  1505. package/lib/typescript/src/web/TrackPlayer/SetupNotCalledError.d.ts.map +0 -1
  1506. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts +0 -34
  1507. package/lib/typescript/src/web/TrackPlayer/SleepTimer.d.ts.map +0 -1
  1508. package/lib/typescript/src/web/TrackPlayer/State.d.ts +0 -13
  1509. package/lib/typescript/src/web/TrackPlayer/State.d.ts.map +0 -1
  1510. package/lib/typescript/src/web/TrackPlayer/index.d.ts +0 -5
  1511. package/lib/typescript/src/web/TrackPlayer/index.d.ts.map +0 -1
  1512. package/lib/typescript/src/web/browser/BrowserManager.d.ts +0 -154
  1513. package/lib/typescript/src/web/browser/BrowserManager.d.ts.map +0 -1
  1514. package/lib/typescript/src/web/browser/FavoriteManager.d.ts +0 -42
  1515. package/lib/typescript/src/web/browser/FavoriteManager.d.ts.map +0 -1
  1516. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts +0 -40
  1517. package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts.map +0 -1
  1518. package/lib/typescript/src/web/browser/SearchManager.d.ts +0 -22
  1519. package/lib/typescript/src/web/browser/SearchManager.d.ts.map +0 -1
  1520. package/lib/typescript/src/web/http/HttpClient.d.ts +0 -25
  1521. package/lib/typescript/src/web/http/HttpClient.d.ts.map +0 -1
  1522. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts +0 -98
  1523. package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts.map +0 -1
  1524. package/lib/typescript/src/web/player/NowPlayingManager.d.ts +0 -34
  1525. package/lib/typescript/src/web/player/NowPlayingManager.d.ts.map +0 -1
  1526. package/lib/typescript/src/web/player/OptionsManager.d.ts +0 -32
  1527. package/lib/typescript/src/web/player/OptionsManager.d.ts.map +0 -1
  1528. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts +0 -69
  1529. package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map +0 -1
  1530. package/lib/typescript/src/web/util/shuffle.d.ts +0 -8
  1531. package/lib/typescript/src/web/util/shuffle.d.ts.map +0 -1
  1532. package/nitrogen/generated/android/c++/JAndroidUpdateOptions.hpp +0 -86
  1533. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.hpp +0 -147
  1534. package/nitrogen/generated/android/c++/JFunc_void_IosOutput.hpp +0 -80
  1535. package/nitrogen/generated/android/c++/JFunc_void_RemoteSetRatingEvent.hpp +0 -87
  1536. package/nitrogen/generated/android/c++/JHeartRating.hpp +0 -57
  1537. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -75
  1538. package/nitrogen/generated/android/c++/JIosOutputType.hpp +0 -85
  1539. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1540. package/nitrogen/generated/android/c++/JPartialSetupPlayerOptions.hpp +0 -96
  1541. package/nitrogen/generated/android/c++/JPercentageRating.hpp +0 -57
  1542. package/nitrogen/generated/android/c++/JRatingType.hpp +0 -73
  1543. package/nitrogen/generated/android/c++/JRemoteSetRatingEvent.hpp +0 -66
  1544. package/nitrogen/generated/android/c++/JStarRating.hpp +0 -57
  1545. package/nitrogen/generated/android/c++/JThumbsRating.hpp +0 -57
  1546. package/nitrogen/generated/android/c++/JUpdateOptions.hpp +0 -105
  1547. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp +0 -34
  1548. package/nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.hpp +0 -105
  1549. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1550. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1551. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidUpdateOptions.kt +0 -50
  1552. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HeartRating.kt +0 -38
  1553. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -47
  1554. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutput.kt +0 -44
  1555. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IosOutputType.kt +0 -32
  1556. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1557. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialIOSSetupPlayerOptions.kt +0 -50
  1558. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PartialSetupPlayerOptions.kt +0 -47
  1559. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PercentageRating.kt +0 -38
  1560. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSetRatingEvent.kt +0 -38
  1561. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StarRating.kt +0 -38
  1562. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ThumbsRating.kt +0 -38
  1563. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/UpdateOptions.kt +0 -53
  1564. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.kt +0 -77
  1565. package/nitrogen/generated/ios/swift/AndroidUpdateOptions.swift +0 -119
  1566. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError______BrowserSourceCallbackParam.swift +0 -68
  1567. package/nitrogen/generated/ios/swift/HeartRating.swift +0 -29
  1568. package/nitrogen/generated/ios/swift/IosOutputType.swift +0 -76
  1569. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1570. package/nitrogen/generated/ios/swift/PartialSetupPlayerOptions.swift +0 -101
  1571. package/nitrogen/generated/ios/swift/PercentageRating.swift +0 -29
  1572. package/nitrogen/generated/ios/swift/RatingType.swift +0 -60
  1573. package/nitrogen/generated/ios/swift/RemoteSetRatingEvent.swift +0 -58
  1574. package/nitrogen/generated/ios/swift/StarRating.swift +0 -29
  1575. package/nitrogen/generated/ios/swift/ThumbsRating.swift +0 -29
  1576. package/nitrogen/generated/ios/swift/UpdateOptions.swift +0 -143
  1577. package/nitrogen/generated/ios/swift/Variant_HeartRating_ThumbsRating_StarRating_PercentageRating.swift +0 -20
  1578. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1579. package/nitrogen/generated/shared/c++/AndroidUpdateOptions.hpp +0 -109
  1580. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -98
  1581. package/nitrogen/generated/shared/c++/IosOutputType.hpp +0 -112
  1582. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
  1583. package/nitrogen/generated/shared/c++/PartialSetupPlayerOptions.hpp +0 -104
  1584. package/nitrogen/generated/shared/c++/RatingType.hpp +0 -96
  1585. package/nitrogen/generated/shared/c++/RemoteSetRatingEvent.hpp +0 -94
  1586. package/nitrogen/generated/shared/c++/UpdateOptions.hpp +0 -111
  1587. package/src/features/rating.ts +0 -17
  1588. package/src/types/player.ts +0 -69
  1589. package/src/web/TrackPlayer/PlaylistPlayer.ts +0 -346
@@ -2,7 +2,8 @@ import type { NavigationError } from '../features/errors'
2
2
  import type { ResolvedTrack, Track } from './browser-nodes.ts'
3
3
 
4
4
  /**
5
- * Event fired when a track is about to be loaded via navigateTrack.
5
+ * Event fired when a playable track is about to load: a browse-row tap or a
6
+ * `navigate(track)` call.
6
7
  */
7
8
  export interface TrackLoadEvent {
8
9
  /** The track that will be loaded */
@@ -11,16 +12,24 @@ export interface TrackLoadEvent {
11
12
  queue: Track[]
12
13
  /** The index of the track in the queue */
13
14
  startIndex: number
15
+ /**
16
+ * Where an Android media controller asked playback to start, in seconds: the
17
+ * player's current position when it asked to keep it, absent when it asked to
18
+ * reset or sent none.
19
+ */
20
+ startPosition?: number
14
21
  }
15
22
 
16
23
  /**
17
24
  * Callback for handling track load events.
18
- * When set on BrowserConfiguration, navigateTrack() will call this handler
19
- * instead of auto-loading/playing the track. The native side awaits completion
20
- * before proceeding (e.g., showing Now Playing in CarPlay).
25
+ * When set on BrowserConfiguration, loading a playable track — a browse-row
26
+ * tap or a `navigate(track)` call — invokes this handler instead of the
27
+ * library auto-loading/playing it. The native side awaits the returned
28
+ * promise before proceeding (e.g., showing Now Playing in CarPlay).
21
29
  */
22
30
  export type HandleTrackLoadCallback = (event: TrackLoadEvent) => Promise<void>
23
31
 
32
+ /** What a browse callback receives: the path, and the params its route matched. */
24
33
  export type BrowserSourceCallbackParam = {
25
34
  path: string
26
35
  routeParams?: Record<string, string>
@@ -28,7 +37,9 @@ export type BrowserSourceCallbackParam = {
28
37
 
29
38
  /**
30
39
  * Return BrowseError from a browse callback to display an error to the user.
31
- * The error message will be shown in an error dialog in CarPlay and Android Auto.
40
+ * CarPlay and Android Auto show the error in place of the list: as the CarPlay
41
+ * list's message, and as an error row in Android Auto. The title comes from
42
+ * `formatNavigationError` (default "Error"), and your string is the message.
32
43
  *
33
44
  * On the app side, the error is surfaced as a `NavigationError` with
34
45
  * `code: 'callback-error'`. Use `useNavigationError()` to get the error details,
@@ -36,11 +47,13 @@ export type BrowserSourceCallbackParam = {
36
47
  *
37
48
  * @example
38
49
  * ```ts
39
- * browse: async ({ path }) => {
40
- * if (!user.subscribed) {
41
- * return { error: 'Please subscribe to access this content' }
50
+ * routes: {
51
+ * '/premium': async ({ path }) => {
52
+ * if (!user.subscribed) {
53
+ * return { error: 'Please subscribe to access this content' }
54
+ * }
55
+ * return fetchContent(path)
42
56
  * }
43
- * return fetchContent(path)
44
57
  * }
45
58
  * ```
46
59
  */
@@ -54,69 +67,135 @@ export type BrowseError = {
54
67
  */
55
68
  export type BrowseResult = ResolvedTrack | BrowseError
56
69
 
70
+ /** Browse callback: returns the page for a path, or a {@link BrowseError}. */
57
71
  export type BrowserSourceCallback = (
58
72
  param: BrowserSourceCallbackParam
59
- ) => Promise<BrowseResult>
73
+ ) => BrowseResult | Promise<BrowseResult>
60
74
 
61
75
  /**
62
- * Search mode types for structured voice search.
76
+ * Search mode — the *container vertical*: what KIND of result the user asked
77
+ * for. Orthogonal to the filter props (`genre`/`artist`/`album`/`title`/
78
+ * `playlist`), which say *which* item. `mode` is optional: when absent, the
79
+ * request is unstructured (text-search `query`) or unclassified.
80
+ *
81
+ * - `any`: play anything sensible — "play something" / smart shuffle (query
82
+ * empty). Android also maps its generic "play music" focus here, since it
83
+ * can't isolate the music vertical the way iOS can.
84
+ * - `song`: an individual track
85
+ * - `playlist`: a named playlist / mix
86
+ * - `station`: a live radio station / channel
87
+ * - `podcast`: a podcast (series, episode, or station)
88
+ * - `audiobook`: an audiobook
89
+ * - `news`: news content
90
+ * - `music`: the music vertical, as opposed to talk/podcasts/audiobooks
91
+ * ("play music" on iOS, via the music media type)
92
+ * - `music-video` / `movie` / `tv-show` / `tv-show-episode`: video kinds
93
+ * (an audio app cannot play these; surfaced so consumers may special-case —
94
+ * ignoring them degrades to an unstructured search)
63
95
  *
64
- * - `any`: Play any content - smart shuffle or last playlist (query will be empty string)
65
- * - `genre`: Search by genre
66
- * - `artist`: Search by artist
67
- * - `album`: Search by album
68
- * - `song`: Search by song/track title
69
- * - `playlist`: Search by playlist name
96
+ * NOTE: there is intentionally no `genre`/`artist`/`album` member — those are
97
+ * filters, not result shapes. Read them from `SearchParams.genre`/`.artist`/
98
+ * `.album` directly.
70
99
  *
71
100
  * @see BrowserConfiguration.search
72
101
  * @see SearchParams
73
102
  */
74
103
  export type SearchMode =
75
104
  | 'any'
76
- | 'genre'
77
- | 'artist'
78
- | 'album'
79
105
  | 'song'
80
106
  | 'playlist'
107
+ | 'station'
108
+ | 'podcast'
109
+ | 'audiobook'
110
+ | 'news'
111
+ | 'music'
112
+ | 'music-video'
113
+ | 'movie'
114
+ | 'tv-show'
115
+ | 'tv-show-episode'
116
+
117
+ /**
118
+ * The media-reference axis from a voice intent.
119
+ *
120
+ * - `my`: the user's own collection ("play my favorites") — routed to the
121
+ * `search` source so the consumer resolves it against their library.
122
+ * - `unknown`: no reference (the default; Android always emits this).
123
+ *
124
+ * NOTE: "currently playing" ("play this") is resolved natively (resume) and
125
+ * never reaches the consumer, so it is not a value here.
126
+ */
127
+ export type MediaReference = 'my' | 'unknown'
81
128
 
82
129
  /**
83
- * Structured search parameters from voice commands.
84
- *
85
- * Voice commands are parsed by Android into structured parameters:
86
- * - "play something" → mode=null, query="something"
87
- * - "play music" → mode='any', query=""
88
- * - "play jazz" → mode='genre', genre="jazz", query="jazz"
89
- * - "play michael jackson" → mode='artist', artist="michael jackson", query="michael jackson"
90
- * - "play thriller by michael jackson" → mode='album', album="thriller", artist="michael jackson"
91
- * - "play billie jean" → mode='song', title="billie jean", query="billie jean"
130
+ * Structured search parameters normalized from a voice/search intent — one
131
+ * cross-platform shape (iOS SiriKit + Android MediaSession). `mode` is the
132
+ * container vertical; the remaining fields are filters. Example mappings:
133
+ * - "play something" → mode='any', query="" (smart shuffle)
134
+ * - "play music" → mode='music' (iOS) / 'any' (Android), query=""
135
+ * - "play jazz" → genre="jazz", query="jazz" (mode undefined)
136
+ * - "play the radishes" → artist="the radishes", query="the radishes"
137
+ * - "play greens by the radishes" → album="greens", artist="the radishes"
138
+ * - "play sweet pea" → mode='song', title="sweet pea", query="sweet pea"
139
+ * - "play my favorites" → reference='my', query=""
140
+ * - "play a jazz podcast" → mode='podcast', genre="jazz"
92
141
  */
93
142
  export interface SearchParams {
94
- /** The search mode indicating what type of search is being performed, or null for unstructured search */
143
+ /** Container vertical, or undefined for an unstructured / unclassified search. */
95
144
  mode?: SearchMode
96
145
  /**
97
146
  * The original search query string (always present, but may be empty string "").
98
- * When mode='any' with empty string query, return any content you think the user would like
147
+ * With mode='any' and empty query, return any content the user would like
99
148
  * (e.g., recently played, favorites, or smart shuffle).
100
149
  */
101
150
  query: string
102
- /** Genre name for genre-specific search */
151
+ /** Genre filter, when the intent named one. */
103
152
  genre?: string
104
- /** Artist name for artist/album/song search */
153
+ /** Artist filter (artist / album / song intents). */
105
154
  artist?: string
106
- /** Album name for album-specific search */
155
+ /** Album filter. */
107
156
  album?: string
108
- /** Song title for song-specific search */
157
+ /** Track title, for a song intent. */
109
158
  title?: string
110
- /** Playlist name for playlist-specific search */
159
+ /** Playlist name, for a playlist intent. */
111
160
  playlist?: string
161
+ /**
162
+ * Media-reference axis. `'my'` = resolve against the user's own collection
163
+ * ("play my favorites"); `'unknown'` = no reference (the default). Android
164
+ * always emits `'unknown'`.
165
+ *
166
+ * Resolve it however your collection lives: a `SearchSourceCallback` can read
167
+ * `params.reference` and return the matching tracks directly, or — when using
168
+ * an HTTP `TransformableRequestConfig` — branch in `transform` on
169
+ * `request.query.reference === 'my'` to rewrite the request toward a
170
+ * favorites endpoint (e.g. injecting locally-stored identifiers into the body).
171
+ */
172
+ reference: MediaReference
112
173
  }
113
174
 
175
+ /** Search callback: returns the result tracks for a search. */
114
176
  export type SearchSourceCallback = (params: SearchParams) => Promise<Track[]>
177
+
178
+ // Sync and async transforms are SEPARATE fields (`transform` / `transformSync`),
179
+ // never a `T | Promise<T>` union. A union lowers to a Nitro `variant<Struct,
180
+ // Promise<Struct>>`, and an all-optional struct's `canConvert` also accepts a
181
+ // Promise — so the async case is silently misread as an empty config. Two
182
+ // single-typed fields keep both paths unambiguous, and the sync field allocates
183
+ // no Promise. When both are set they run as a pipeline: async first, then sync.
184
+ /**
185
+ * Async `transform`: receives the merged request and the route's params, and
186
+ * returns the request to send.
187
+ */
115
188
  export type RequestConfigTransformer = (
116
189
  request: RequestConfig,
117
190
  routeParams?: Record<string, string>
118
191
  ) => Promise<RequestConfig>
192
+ /** Sync `transformSync`: the {@link RequestConfigTransformer} without a Promise. */
193
+ export type RequestConfigTransformerSync = (
194
+ request: RequestConfig,
195
+ routeParams?: Record<string, string>
196
+ ) => RequestConfig
119
197
 
198
+ /** HTTP method of a request. */
120
199
  export type HttpMethod =
121
200
  | 'GET'
122
201
  | 'POST'
@@ -126,26 +205,50 @@ export type HttpMethod =
126
205
  | 'HEAD'
127
206
  | 'OPTIONS'
128
207
 
208
+ /**
209
+ * One HTTP request's fields. When configs layer, `headers` and `query` merge
210
+ * by key, and every other set field overrides the one below it, unless the
211
+ * layer has a transform, which replaces the config outright.
212
+ */
129
213
  export interface RequestConfig {
214
+ /** HTTP method. Defaults to `'GET'`. */
130
215
  method?: HttpMethod
131
216
  /**
132
217
  * The request path.
133
- * - For browser requests, this is the track's `url`
218
+ * - For browser requests, this is the track's `path`
134
219
  * - For media requests, this is the track's `src` value
135
220
  * - For artwork requests, this is the track's `artwork` URL
221
+ *
222
+ * A static value is ignored on `request`, `browse`, `media` and route
223
+ * layers; change it in a `transform`.
136
224
  */
137
225
  path?: string
226
+ /** URL that a relative `path` is appended to. */
138
227
  baseUrl?: string
228
+ /** Request headers, merged by key with the layers below. */
139
229
  headers?: Record<string, string>
230
+ /** Query parameters, merged by key with the layers below. */
140
231
  query?: Record<string, string>
232
+ /**
233
+ * Request body, sent for POST, PUT and PATCH (and DELETE when set) on iOS
234
+ * and Android; not sent on web.
235
+ */
141
236
  body?: string
237
+ /**
238
+ * Content type of the body on iOS and Android. Defaults to
239
+ * `'application/json'`; not sent on web.
240
+ */
142
241
  contentType?: string
242
+ /**
243
+ * Sent as `User-Agent` on iOS and Android (a `User-Agent` in `headers` wins
244
+ * on iOS); ignored on web.
245
+ */
143
246
  userAgent?: string
144
247
  }
145
248
 
146
249
  /**
147
250
  * Context for image loading requests.
148
- * Provides pixel dimensions and appearance info from Android Auto/CarPlay.
251
+ * Provides pixel dimensions from Android Auto/CarPlay.
149
252
  *
150
253
  * @example
151
254
  * ```typescript
@@ -215,9 +318,14 @@ export interface MediaTransformParams {
215
318
  * }
216
319
  * ```
217
320
  */
321
+ /** Async artwork `transform`: receives `{ request, context }`. */
218
322
  export type MediaRequestConfigTransformer = (
219
323
  params: MediaTransformParams
220
324
  ) => Promise<RequestConfig>
325
+ /** Sync artwork `transformSync`: the {@link MediaRequestConfigTransformer} without a Promise. */
326
+ export type MediaRequestConfigTransformerSync = (
327
+ params: MediaTransformParams
328
+ ) => RequestConfig
221
329
 
222
330
  /**
223
331
  * Request configuration that supports async transformation.
@@ -227,6 +335,11 @@ export type MediaRequestConfigTransformer = (
227
335
  * before the request is made. This is useful for adding dynamic headers,
228
336
  * signing URLs, or other request-time modifications.
229
337
  *
338
+ * Note: when a layer provides a transform, the layer's other static fields
339
+ * are NOT merged — the transform receives the merged config from the layers
340
+ * below it, and its return value replaces that config entirely. Spread the
341
+ * incoming request (`{ ...request, ... }`) to keep its fields.
342
+ *
230
343
  * @example
231
344
  * ```typescript
232
345
  * const config: TransformableRequestConfig = {
@@ -242,68 +355,45 @@ export type MediaRequestConfigTransformer = (
242
355
  * ```
243
356
  */
244
357
  export interface TransformableRequestConfig extends RequestConfig {
358
+ /** Async per-request transform. When both are set, runs BEFORE `transformSync`. */
245
359
  transform?: RequestConfigTransformer
360
+ /** Sync per-request transform (no Promise allocation). When both are set, runs AFTER `transform`. */
361
+ transformSync?: RequestConfigTransformerSync
246
362
  }
247
363
 
248
364
  /**
249
- * Configuration for artwork image requests
250
- *
251
- * ## Configuration Hierarchy
365
+ * Lazily builds the config for a `request` or `browse` layer. Reach for it when
366
+ * the config depends on a value that changes now and then — a base URL, a
367
+ * locale — but not on every request.
252
368
  *
253
- * When a request is made, configs are merged in this order (later overrides earlier):
254
- * 1. `request` (base config) - shared settings like user agent, common headers
255
- * 2. `artwork` config - resource-specific settings
256
- * 3. `resolve(track)` result - per-track overrides (if provided)
257
- * 4. `imageQueryParams` - automatic size query param injection (if configured)
258
- * 5. `transform(request, context)` result - final modifications (if provided)
369
+ * How it differs from a `transform`: **a resolver runs once and its result is
370
+ * cached**, then reused for every browse/search/media/artwork request — whereas a
371
+ * `transform` runs on *every* request. The resolver re-runs only when you call
372
+ * `invalidateAllContent()`, so call that after (say) an environment or locale
373
+ * switch to pick up the new value.
259
374
  *
260
- * ## Usage Patterns
261
- *
262
- * **Simple CDN configuration:**
263
- * ```typescript
264
- * media: {
265
- * baseUrl: 'https://audio.cdn.example.com',
266
- * headers: { 'X-API-Key': 'your-api-key' }
267
- * }
268
- * ```
375
+ * Return the config directly — no `async`/Promise needed in the common case — or
376
+ * a `Promise` when you must await (e.g. fetching a token). The cached config
377
+ * flows through the normal layering, so its `query` merges additively and its
378
+ * `baseUrl` overrides, exactly like a static config; it may also include a
379
+ * `transform` if you additionally need genuine per-request logic.
269
380
  *
270
- * **Per-track URL resolution:**
271
- * ```typescript
272
- * media: {
273
- * resolve: async (track) => ({
274
- * baseUrl: 'https://audio.cdn.example.com',
275
- * path: `/streams/${track.src}`,
276
- * query: { token: await getSignedToken(track.src) }
277
- * })
278
- * }
279
- * ```
280
- *
281
- * **Size-aware transformation (for artwork):**
381
+ * @example
282
382
  * ```typescript
283
- * artwork: {
284
- * baseUrl: 'https://images.cdn.example.com',
285
- * transform: async ({ request, context }) => ({
286
- * ...request,
287
- * query: {
288
- * ...request.query,
289
- * w: context?.width ? String(context.width) : '600',
290
- * sig: await signUrl(request.path)
291
- * }
292
- * })
293
- * }
294
- * ```
383
+ * configureBrowser({
384
+ * // Read once and cached; re-read after the next invalidateAllContent().
385
+ * request: () => ({ baseUrl: currentBaseUrl() }),
386
+ * // Browse-only locale param, merged into every browse request's query.
387
+ * browse: () => ({ query: { hl: currentLocale() } }),
388
+ * })
295
389
  *
296
- * **Simple size params (declarative alternative):**
297
- * ```typescript
298
- * artwork: {
299
- * baseUrl: 'https://images.cdn.example.com',
300
- * imageQueryParams: { width: 'w', height: 'h' }
301
- * }
390
+ * // Async resolver (e.g. awaiting a token) — still runs once, then cached:
391
+ * request: async () => ({ headers: { authorization: await freshToken() } })
302
392
  * ```
303
- *
304
- * @see BrowserConfiguration.media - Audio stream configuration
305
- * @see BrowserConfiguration.artwork - Image/artwork configuration
306
393
  */
394
+ export type RequestConfigResolver = () =>
395
+ | TransformableRequestConfig
396
+ | Promise<TransformableRequestConfig>
307
397
 
308
398
  /**
309
399
  * Query parameter names for automatic context injection from CarPlay/Android Auto.
@@ -317,21 +407,25 @@ export interface ImageQueryParams {
317
407
  }
318
408
 
319
409
  /**
320
- * Configuration for media resource requests (audio streams, artwork images).
410
+ * Configuration for audio stream requests: `media` in BrowserConfiguration.
321
411
  * Extends TransformableRequestConfig with per-track resolution capabilities.
412
+ * For `artwork`, see {@link ArtworkRequestConfig}.
322
413
  *
323
- * Used for both `media` (audio streaming) and `artwork` (image loading) configuration
324
- * in BrowserConfiguration.
325
- *
326
- * ## Configuration Hierarchy
414
+ * ### Configuration Hierarchy
327
415
  *
328
416
  * When a request is made, configs are merged in this order (later overrides earlier):
329
417
  * 1. `request` (base config) - shared settings like user agent, common headers
330
418
  * 2. `media`/`artwork` config - resource-specific settings
331
- * 3. `resolve(track)` result - per-track overrides (if provided)
332
- * 4. `transform(request)` result - final modifications (if provided)
419
+ * 3. the per-track callbacks, in an order that differs by kind:
420
+ * - `artwork`: `resolve(track)`, then `transform(request)` last
421
+ * - `media`: `transform(request)`, then **`resolve(track)` last** — the
422
+ * per-track resolver is the most specific layer and wins over the
423
+ * transform, on every platform
424
+ *
425
+ * So a `media.transform` cannot sign what `resolve` produced: sign inside
426
+ * `resolve`, or sign in `transform` and drop `resolve`.
333
427
  *
334
- * ## Usage Patterns
428
+ * ### Usage Patterns
335
429
  *
336
430
  * **Simple CDN configuration:**
337
431
  * ```typescript
@@ -354,10 +448,10 @@ export interface ImageQueryParams {
354
448
  *
355
449
  * **Dynamic request signing:**
356
450
  * ```typescript
357
- * artwork: {
358
- * baseUrl: 'https://images.cdn.example.com',
451
+ * media: {
359
452
  * transform: async (request) => ({
360
453
  * ...request,
454
+ * baseUrl: 'https://audio.cdn.example.com',
361
455
  * query: { ...request.query, sig: await signUrl(request.path) }
362
456
  * })
363
457
  * }
@@ -368,17 +462,18 @@ export interface ImageQueryParams {
368
462
  */
369
463
  export interface MediaRequestConfig extends TransformableRequestConfig {
370
464
  /**
371
- * Per-track request resolution callback.
465
+ * Async per-track request resolution.
372
466
  *
373
467
  * Called for each track to generate the final request configuration.
374
468
  * Receives the full Track object, allowing URL generation based on
375
- * track metadata (artist, album, src, etc.).
469
+ * track metadata (id, artist, album, src, etc.).
376
470
  *
377
- * The returned config is merged with base configs, then passed to
378
- * `transform` if provided.
471
+ * Runs **last** for media — after `transform`, and winning over it on every
472
+ * field including `path`; artwork runs them the other way round (see
473
+ * {@link MediaRequestConfig}). When `resolveSync` is also set, both run and
474
+ * the `resolveSync` result merges over this one.
379
475
  *
380
476
  * @param track - The track being requested
381
- * @returns Request configuration for this specific track
382
477
  *
383
478
  * @example
384
479
  * ```typescript
@@ -389,17 +484,61 @@ export interface MediaRequestConfig extends TransformableRequestConfig {
389
484
  * ```
390
485
  */
391
486
  resolve?: (track: Track) => Promise<RequestConfig>
487
+ /** Sync per-track resolution (no Promise allocation). When both are set, runs (merged) AFTER `resolve`. */
488
+ resolveSync?: (track: Track) => RequestConfig
392
489
  }
393
490
 
491
+ /**
492
+ * Configuration for artwork image requests: `artwork` and `nowPlayingArtwork`
493
+ * in BrowserConfiguration.
494
+ *
495
+ * ### Configuration Hierarchy
496
+ *
497
+ * Configs merge in this order (later overrides earlier):
498
+ * 1. `request` (base config) - shared settings like user agent, common headers
499
+ * 2. `artwork` (or `nowPlayingArtwork`) config - resource-specific settings
500
+ * 3. `resolve(track)` result - per-track overrides (if provided)
501
+ * 4. `imageQueryParams` - automatic size query params (if configured)
502
+ * 5. `transform({ request, context })` result - final changes (if provided)
503
+ *
504
+ * ### Usage Patterns
505
+ *
506
+ * **Size-aware transformation:**
507
+ * ```typescript
508
+ * artwork: {
509
+ * baseUrl: 'https://images.cdn.example.com',
510
+ * transform: async ({ request, context }) => ({
511
+ * ...request,
512
+ * query: {
513
+ * ...request.query,
514
+ * w: context?.width ? String(context.width) : '600',
515
+ * sig: await signUrl(request.path)
516
+ * }
517
+ * })
518
+ * }
519
+ * ```
520
+ *
521
+ * **Simple size params (declarative alternative):**
522
+ * ```typescript
523
+ * artwork: {
524
+ * baseUrl: 'https://images.cdn.example.com',
525
+ * imageQueryParams: { width: 'w', height: 'h' }
526
+ * }
527
+ * ```
528
+ *
529
+ * @see BrowserConfiguration.artwork - Image/artwork configuration
530
+ * @see BrowserConfiguration.nowPlayingArtwork - Now-playing artwork
531
+ */
394
532
  export interface ArtworkRequestConfig extends RequestConfig {
395
533
  /**
396
- * Per-track request resolution callback.
534
+ * Async per-track request resolution.
397
535
  *
398
536
  * Called for each track to generate the request configuration based on
399
- * track metadata (artist, album, src, etc.).
537
+ * track metadata (id, artist, album, src, etc.).
400
538
  *
401
539
  * The returned config is merged with base configs, then passed to
402
- * `transform` if provided.
540
+ * `transform` if provided. When `resolveSync` is also set, both run and the
541
+ * `resolveSync` result merges over this one.
403
542
  *
404
543
  * @param track - The track being requested
405
544
  * @returns Request configuration for this specific track
@@ -415,20 +554,23 @@ export interface ArtworkRequestConfig extends RequestConfig {
415
554
  * ```
416
555
  */
417
556
  resolve?: (track: Track) => Promise<RequestConfig>
557
+ /** Sync per-track resolution (no Promise allocation). When both are set, runs (merged) AFTER `resolve`. */
558
+ resolveSync?: (track: Track) => RequestConfig
418
559
 
419
560
  /**
420
- * Final transformation callback for media/artwork requests.
561
+ * Async final transform for artwork requests.
421
562
  *
422
563
  * Called after `resolve` (if provided) with the merged request config.
423
564
  * Receives optional ImageContext with size hints from Android Auto/CarPlay.
565
+ * When `transformSync` is also set, it runs after this one on its result.
424
566
  *
425
567
  * Use this for:
426
568
  * - Adding size query params dynamically
427
569
  * - URL signing
428
570
  * - Adding authentication tokens
429
571
  *
430
- * @param request - The merged request configuration
431
- * @param context - Optional image context with size hints
572
+ * @param params - `{ request, context }`: the merged request configuration
573
+ * and the optional image context with size hints
432
574
  * @returns Modified request configuration
433
575
  *
434
576
  * @example
@@ -446,12 +588,15 @@ export interface ArtworkRequestConfig extends RequestConfig {
446
588
  * ```
447
589
  */
448
590
  transform?: MediaRequestConfigTransformer
591
+ /** Sync final transform (no Promise allocation). When both are set, runs AFTER `transform`. */
592
+ transformSync?: MediaRequestConfigTransformerSync
449
593
 
450
594
  /**
451
595
  * Query parameter names for automatic context injection from CarPlay/Android Auto.
452
596
  *
453
- * When configured, the image context (size, color scheme) from CarPlay/Android Auto
454
- * is automatically added as query parameters to artwork URLs.
597
+ * When configured, the image width and height from CarPlay/Android Auto are
598
+ * added as query parameters to artwork URLs, in whole pixels, when the
599
+ * display size is known.
455
600
  *
456
601
  * This is a simpler alternative to using `transform` for context-aware URLs.
457
602
  *
@@ -473,22 +618,39 @@ export interface ArtworkRequestConfig extends RequestConfig {
473
618
  imageQueryParams?: ImageQueryParams
474
619
  }
475
620
 
621
+ /**
622
+ * Source for a browse container's contents.
623
+ *
624
+ * **Response shape (HTTP / `TransformableRequestConfig`):** the endpoint must
625
+ * return a single **page object** — a {@link ResolvedTrack}
626
+ * (`{ title, path?, children: Track[] }`). The `children` array holds the rows
627
+ * shown for the container; each child is a playable leaf (`src`) or a navigable
628
+ * sub-container (`path`). A callback / static `ResolvedTrack` returns the same
629
+ * page object directly.
630
+ *
631
+ * A {@link TabsSource} HTTP endpoint returns this same page shape, with the
632
+ * tabs as its `children`. A {@link SearchSource} HTTP endpoint differs: it
633
+ * returns a bare `Track[]`.
634
+ */
476
635
  export type BrowserSource =
477
636
  | ResolvedTrack
478
637
  | BrowserSourceCallback
479
638
  | TransformableRequestConfig
480
639
 
640
+ /**
641
+ * A callback or an HTTP request config. A route's `browse` takes the wider
642
+ * {@link BrowserSource}, which also accepts a static {@link ResolvedTrack}.
643
+ */
481
644
  export type RouteSource = BrowserSourceCallback | TransformableRequestConfig
482
645
 
483
646
  /**
484
- * Route configuration with per-route media and artwork overrides.
647
+ * Route configuration with per-route browse and artwork overrides.
485
648
  *
486
649
  * @example
487
650
  * ```typescript
488
651
  * routes: {
489
652
  * '/premium': {
490
653
  * browse: async () => fetchPremiumContent(),
491
- * media: { baseUrl: 'https://premium-audio.cdn.com' },
492
654
  * artwork: { baseUrl: 'https://premium-images.cdn.com' }
493
655
  * }
494
656
  * }
@@ -497,18 +659,28 @@ export type RouteSource = BrowserSourceCallback | TransformableRequestConfig
497
659
  export type RouteConfig = {
498
660
  /** Override browse config for this route. */
499
661
  browse?: BrowserSource
500
- /** Override media config for this route. */
662
+ /**
663
+ * Not applied on any platform: media always resolves from the top-level
664
+ * `media` config.
665
+ */
501
666
  media?: MediaRequestConfig
502
667
  /** Override artwork config for this route. */
503
668
  artwork?: ArtworkRequestConfig
504
669
  }
505
670
 
506
- export type TabsSourceCallback = () => Promise<Track[]>
671
+ /** Tabs callback: returns the tab tracks. */
672
+ export type TabsSourceCallback = () => Track[] | Promise<Track[]>
673
+
507
674
  /**
508
675
  * Tab source configuration for navigation tabs.
509
676
  *
510
- * When using API configuration (TransformableRequestConfig), the request path defaults to '/'
511
- * and should return an array of Track objects with urls representing the tabs.
677
+ * When using API configuration (TransformableRequestConfig), the web requests
678
+ * path '/', but iOS and Android request an internal placeholder path instead.
679
+ * A static `path` is ignored, so set the path in a `transform` for the same
680
+ * request on every platform. The endpoint must return a page object
681
+ * `{ title?, children: Track[] }` whose `children` are the tabs — the same
682
+ * shape a browse endpoint returns. Callback/static sources provide `Track[]`
683
+ * directly.
512
684
  */
513
685
  export type TabsSource =
514
686
  | Track[]
@@ -518,30 +690,74 @@ export type TabsSource =
518
690
  /**
519
691
  * Search source configuration for handling search requests.
520
692
  *
693
+ * **Response shape (HTTP / `TransformableRequestConfig`):** the endpoint must
694
+ * return a bare `Track[]` of result rows, not the page object a browse
695
+ * endpoint returns. (The web implementation also accepts a page object
696
+ * `{ children: Track[] }`; iOS and Android do not.) Callback sources return
697
+ * `Track[]` directly.
698
+ *
521
699
  * @see BrowserConfiguration.search
522
700
  */
523
701
  export type SearchSource = SearchSourceCallback | TransformableRequestConfig
524
702
 
703
+ /**
704
+ * The browser's configuration: requests, routes, tabs, search and the car
705
+ * surfaces. Pass it to `configureBrowser`.
706
+ */
525
707
  export type BrowserConfiguration = {
526
708
  /**
527
- * Initial navigation path. Setting this triggers initial navigation to the specified path.
709
+ * Initial navigation path. Setting this triggers initial navigation to the
710
+ * specified path. When unset, the first tab's path is used; when there are
711
+ * no tabs either, `/`.
528
712
  */
529
713
  path?: string | undefined
530
714
 
531
715
  // ─── Request Defaults (applied to all requests) ────────────────────────────
532
716
 
533
717
  /**
534
- * Shared request settings applied to all HTTP requests (browse, search, media, artwork).
535
- * Specific configs override these defaults.
718
+ * Shared request settings applied to every HTTP request (browse, search,
719
+ * media, artwork). Layered before the per-kind config and (for browse) the
720
+ * route — so request → `<kind>` → route. Specific configs override these
721
+ * defaults.
722
+ *
723
+ * Either a static {@link TransformableRequestConfig} (its optional `transform`
724
+ * runs per request), or a {@link RequestConfigResolver} thunk resolved once per
725
+ * content generation and re-resolved on `invalidateAllContent()`. Reach for the
726
+ * resolver when a value changes rarely (a base URL, an auth host) so it is read
727
+ * once per generation and merged natively — rather than recomputed on every
728
+ * browse/search/media/artwork request via a `transform`.
536
729
  */
537
- request?: TransformableRequestConfig
730
+ request?: TransformableRequestConfig | RequestConfigResolver
538
731
 
539
- // ─── Content Configuration ─────────────────────────────────────────────────
732
+ // ─── Per-kind request configuration ─────────────────────────────────────────
540
733
 
541
- /** Default browse source when no matching route is found. */
542
- browse?: BrowserSource
734
+ /**
735
+ * Request shaping applied to every browse request (all routes, including the
736
+ * implicit default), layered between `request` and the matched route:
737
+ * `request` → `browse` → route. This is the browse-kind analogue of `media`
738
+ * and `artwork` — the place for browse-only concerns (e.g. a content-type
739
+ * marker query, or a locale param) that should not leak onto media/artwork.
740
+ *
741
+ * A browse path with no matching `routes` entry is fetched using
742
+ * `request` + `browse` applied to the path, so this also defines the default
743
+ * browse behaviour. Register a `routes['*']` entry only to override that
744
+ * default with a callback / static / bespoke config.
745
+ *
746
+ * Like `request`, this may be a static {@link TransformableRequestConfig} or a
747
+ * {@link RequestConfigResolver} thunk (resolved once per content generation) —
748
+ * e.g. a locale query param that only changes when `invalidateAllContent()` is
749
+ * called. A resolver's `query` is merged additively into each browse request's
750
+ * query, exactly as a static `query` would be.
751
+ */
752
+ browse?: TransformableRequestConfig | RequestConfigResolver
543
753
 
544
- /** Media/audio stream request configuration. */
754
+ /**
755
+ * Media/audio stream request configuration.
756
+ *
757
+ * Unlike `request`/`browse`, this does not accept a resolver thunk. For
758
+ * values that change at runtime, use the shared `request` resolver (it
759
+ * applies to media requests too), a per-track `resolve`, or a `transform`.
760
+ */
545
761
  media?: MediaRequestConfig
546
762
 
547
763
  /**
@@ -552,8 +768,9 @@ export type BrowserConfiguration = {
552
768
  * Artwork URLs are transformed when tracks are processed (before being passed to media controllers
553
769
  * like Android Auto). This is different from media requests which are transformed at playback time.
554
770
  *
555
- * Note: Since media controllers load images directly from URLs, HTTP headers cannot be applied
556
- * to artwork requests. Use query parameters for authentication tokens if your CDN supports it.
771
+ * Headers ARE applied to artwork requests: the library fetches CarPlay and
772
+ * Android Auto images in-process, and in-app consumers receive them via
773
+ * `artworkSource` (which carries the headers for React Native's `<Image>`).
557
774
  *
558
775
  * @example
559
776
  * ```typescript
@@ -575,41 +792,86 @@ export type BrowserConfiguration = {
575
792
  */
576
793
  artwork?: ArtworkRequestConfig
577
794
 
795
+ /**
796
+ * Artwork configuration for the NOW-PLAYING surface only (lock screen / CarPlay /
797
+ * Android Auto now-playing) — distinct from `artwork`, which configures browse-list
798
+ * thumbnails. When set, the now-playing artwork is resolved from THIS config instead of
799
+ * `artwork`; browse lists never read it, so they're unaffected. When unset, now-playing
800
+ * falls back to `artwork` / the track's own `artwork`.
801
+ *
802
+ * Being a full `RequestConfig`, it supports `path`, `query`, and `headers`. The token
803
+ * `{id}` in any of those values is replaced with the track's `id` during resolution, and
804
+ * the result flows through the shared `request` layer (so a relative path gets `baseUrl`
805
+ * prepended). For logic that can't be expressed as a template, use `resolve(track)`.
806
+ *
807
+ * The same `{id}` templating applies to every artwork config (`artwork`,
808
+ * a route's `artwork`, `nowPlayingArtwork`) on iOS and Android. Neither
809
+ * `{id}` nor `nowPlayingArtwork` is implemented by the web implementation.
810
+ *
811
+ * @example
812
+ * // 302-redirect endpoint keyed by the track id:
813
+ * nowPlayingArtwork: { path: '/artwork/{id}' }
814
+ */
815
+ nowPlayingArtwork?: ArtworkRequestConfig
816
+
578
817
  // ─── Navigation ────────────────────────────────────────────────────────────
579
818
 
580
819
  /**
581
820
  * Configuration for search functionality.
582
821
  * Enables search capabilities in the media browser, typically accessed through voice commands or search UI.
583
822
  *
823
+ * See the [Search guide](https://audiobrowser.dev/guide/search) for a walkthrough of
824
+ * modes, filters, the `reference` axis, and mixed audio/video.
825
+ *
584
826
  * Optional - if not provided, search functionality will be disabled.
585
827
  * Required for Android Auto/CarPlay voice search integration with support for structured voice commands.
586
828
  *
587
829
  * Search receives structured parameters from voice commands like:
588
- * - "play music" → mode='any', query=""
589
- * - "play jazz" → mode='genre', genre="jazz", query="jazz"
590
- * - "play michael jackson" → mode='artist', artist="michael jackson", query="michael jackson"
591
- * - "play thriller by michael jackson" → mode='album', album="thriller", artist="michael jackson"
592
- * - "play billie jean" → mode='song', title="billie jean", query="billie jean"
830
+ * - "play something" → mode='any', query="" (smart shuffle)
831
+ * - "play music" → mode='music' (iOS) / 'any' (Android), query=""
832
+ * - "play jazz" → genre="jazz", query="jazz" (genre is a filter, no mode)
833
+ * - "play the radishes" → artist="the radishes", query="the radishes"
834
+ * - "play sweet pea" → mode='song', title="sweet pea", query="sweet pea"
835
+ * - "play my favorites" → reference='my', query=""
593
836
  *
594
837
  * Can be either:
595
- * - SearchSourceCallback: Receives SearchParams with query, and optional mode/artist/album/genre/title/playlist fields
596
- * - TransformableRequestConfig: API endpoint where all search parameters are automatically added to request.query:
838
+ * - SearchSourceCallback: Receives SearchParams with query + reference, plus the
839
+ * optional container-vertical `mode` and the genre/artist/album/title/playlist filters
840
+ * - TransformableRequestConfig: API endpoint where search parameters are automatically added to request.query:
597
841
  * - q: search query string (always present)
598
- * - mode: search mode (any/genre/artist/album/song/playlist) - omitted for unstructured search
599
- * - artist, album, genre, title, playlist: included when present
842
+ * - mode: container vertical (any/song/playlist/station/podcast/audiobook/news/music/
843
+ * music-video/movie/tv-show/tv-show-episode) - omitted for unstructured search
844
+ * - reference: 'my' when the user asked for their own collection ("play my
845
+ * favorites"); omitted otherwise
846
+ * - artist, album, genre, title, playlist: filters, included when present
847
+ *
848
+ * These query-param keys are fixed (not configurable). If your endpoint
849
+ * expects different names, rename them in `transform` — it receives the params
850
+ * already on `request.query`, e.g. `query: { search: request.query?.q }`.
851
+ *
852
+ * Response shape: the endpoint must return a bare `Track[]` — see
853
+ * {@link SearchSource}.
600
854
  *
601
855
  * @example
602
856
  * ```typescript
603
857
  * // Callback approach - direct access to structured parameters
604
858
  * search: async (params) => {
605
- * // Use structured fields for precise searches
606
- * if (params.mode === 'artist' && params.artist) {
607
- * return await db.query('SELECT * FROM tracks WHERE artist = ?', [params.artist]);
859
+ * // "play my favorites" → resolve against the user's own collection
860
+ * if (params.reference === 'my') return await getFavorites();
861
+ * // Filters are read directly from their props (not derived from `mode`)
862
+ * if (params.album && params.artist) {
863
+ * return await db.query(
864
+ * 'SELECT * FROM tracks WHERE album = ? AND artist = ?',
865
+ * [params.album, params.artist]
866
+ * );
608
867
  * }
609
- * if (params.mode === 'album' && params.album && params.artist) {
610
- * return await db.query('SELECT * FROM tracks WHERE album = ? AND artist = ?',
611
- * [params.album, params.artist]);
868
+ * if (params.artist) {
869
+ * return await db.query('SELECT * FROM tracks WHERE artist = ?', [
870
+ * params.artist,
871
+ * ]);
612
872
  * }
873
+ * // `mode` is the container vertical — narrow by it when present
874
+ * if (params.mode === 'podcast') return await searchPodcasts(params.query);
613
875
  * // Fall back to full-text search
614
876
  * return await searchByQuery(params.query);
615
877
  * }
@@ -617,11 +879,11 @@ export type BrowserConfiguration = {
617
879
  * // API configuration - parameters automatically added to query string
618
880
  * search: {
619
881
  * baseUrl: 'https://api.example.com/search',
620
- * // GET /search?q=thriller&mode=album&album=thriller&artist=michael+jackson&limit=20
621
- * transform(request) {
882
+ * // GET /search?q=greens&album=greens&artist=the+radishes&limit=20
883
+ * transformSync(request) {
622
884
  * return {
623
885
  * ...request,
624
- * query: { ...request.query, limit: 20 }
886
+ * query: { ...request.query, limit: '20' }
625
887
  * };
626
888
  * }
627
889
  * }
@@ -631,30 +893,62 @@ export type BrowserConfiguration = {
631
893
 
632
894
  /**
633
895
  * Configuration for navigation tabs in the media browser.
634
- * The first tab's URL is automatically loaded when the browser starts.
896
+ * The first tab's path is automatically loaded when the browser starts.
635
897
  *
636
898
  * Optional - if not provided, no tab navigation will be available.
637
- * Limited to maximum 4 tabs for automotive platform compatibility (Android Auto/CarPlay).
899
+ * Car surfaces show only the first tabs: Android Auto shows 4, CarPlay
900
+ * shows up to `CPTabBarTemplate.maximumTabCount`. `getTabs` and `useTabs`
901
+ * still return every tab, and `configureBrowser` warns in development when
902
+ * a static array has more than Android Auto shows. See
903
+ * [Tabs and the initial path](/guide/browser#tabs-and-the-initial-path).
638
904
  *
639
- * Can provide static array of Track objects with urls as tabs, API configuration, or custom callback.
905
+ * Can provide static array of Track objects with paths as tabs, API configuration, or custom callback.
640
906
  */
641
907
  tabs?: TabsSource
642
908
 
643
909
  /**
644
- * Route-specific configurations. Maps URL paths to browse sources.
645
- * Routes match by prefix, most specific (most slashes) wins.
910
+ * Route-specific configurations. Maps path patterns to browse sources.
911
+ *
912
+ * ### Matching
913
+ *
914
+ * Patterns match on **exact segment count** — `/artists` does NOT match
915
+ * `/artists/123`. Segments may be:
916
+ * - a constant: `/favorites`
917
+ * - a parameter: `/albums/{id}` — captured into `routeParams.id` and passed
918
+ * to callbacks and transforms
919
+ * - a single-segment wildcard: `*`
920
+ * - a tail wildcard: `/files/**` — matches any depth; the remainder is
921
+ * captured into `routeParams.tail`
922
+ *
923
+ * When several patterns match, the most specific wins
924
+ * (constants > parameters > wildcards > tail wildcard).
925
+ *
926
+ * ### Defaults and reserved keys
927
+ *
928
+ * A path matching no route is fetched over HTTP via the `request` →
929
+ * `browse` layers with the path applied — most APIs only need explicit
930
+ * routes for exceptions. The special key `'*'` overrides that default with
931
+ * its own source. Keys starting with `__` are reserved for internal use.
646
932
  *
647
- * Can be a simple `BrowserSource` or extended `RouteConfig` with media/artwork overrides.
933
+ * Note: a static `path` on a route's request config does not rewrite the
934
+ * request path (the navigated path is used); remap paths in a `transform`,
935
+ * which receives `routeParams` as its second argument.
936
+ *
937
+ * Values can be a `BrowserSource` (callback, request config, or static page
938
+ * object) or a `RouteConfig` with per-route `browse`/`artwork` overrides.
648
939
  *
649
940
  * @example
650
941
  * ```typescript
651
942
  * routes: {
652
- * '/favorites': async () => getFavorites(),
653
- * '/artists': { baseUrl: 'https://music-api.com' },
943
+ * '/favorites': async () => getFavoritesPage(),
944
+ * '/albums/{id}': async ({ routeParams }) =>
945
+ * fetchAlbumPage(routeParams?.id),
654
946
  * '/premium': {
655
- * browse: { baseUrl: 'https://premium-api.com' },
656
- * artwork: { baseUrl: 'https://premium-images.cdn.com' }
657
- * }
947
+ * browse: { baseUrl: 'https://premium-api.example.com' },
948
+ * artwork: { baseUrl: 'https://premium-images.example.com' }
949
+ * },
950
+ * // Custom default for anything no other route matches:
951
+ * '*': { baseUrl: 'https://api.example.com' }
658
952
  * }
659
953
  * ```
660
954
  */
@@ -672,7 +966,9 @@ export type BrowserConfiguration = {
672
966
 
673
967
  /**
674
968
  * Custom handler for track load events.
675
- * When set, navigateTrack() will call this handler instead of auto-loading/playing the track.
969
+ * When set, loading a playable track (a browse-row tap or a
970
+ * `navigate(track)` call) invokes this handler instead of auto-loading and
971
+ * playing the track.
676
972
  * Pass undefined to restore default behavior.
677
973
  *
678
974
  * @param event - The track load event containing the track, queue, and startIndex
@@ -693,49 +989,84 @@ export type BrowserConfiguration = {
693
989
  */
694
990
  androidControllerOfflineError?: boolean
695
991
 
696
- // ─── CarPlay Options ──────────────────────────────────────────────────────────
992
+ /**
993
+ * Titles the "view more" row Android Auto appends to a `Section` that
994
+ * carries a `Section.path`, one string for every section.
995
+ *
996
+ * It is re-resolved once per content generation, so
997
+ * `invalidateAllContent()` after an in-app language switch picks up the new
998
+ * copy without reconfiguring the browser.
999
+ *
1000
+ * For wording that varies by section, leave `Section.path` unset and append
1001
+ * your own browsable {@link Track} to `children`; that Track shows on every
1002
+ * surface. See [Android Auto](https://audiobrowser.dev/guide/android-auto).
1003
+ *
1004
+ * @default 'View more'
1005
+ *
1006
+ * @example
1007
+ * ```typescript
1008
+ * viewMoreTitle: () => t('View more')
1009
+ * ```
1010
+ *
1011
+ * @platform android
1012
+ */
1013
+ viewMoreTitle?: ViewMoreTitleCallback
697
1014
 
698
1015
  /**
699
- * Enable the "Up Next" button on the CarPlay Now Playing screen.
1016
+ * Title shown (as the list's centered empty state) on CarPlay screens whose
1017
+ * content is still loading — browse destinations while they resolve, and the
1018
+ * startup screen while tabs load. Supply your app's localized "Loading…"
1019
+ * string. On iOS 18.4+ the system loading spinner is shown instead.
700
1020
  *
701
- * When enabled, tapping "Up Next" shows the current playback queue,
702
- * allowing users to see upcoming tracks and jump to a specific position.
1021
+ * When unset, loading screens are left blank (apart from the spinner on
1022
+ * iOS 18.4+) rather than showing un-localized copy.
703
1023
  *
704
- * The button is automatically hidden when the queue has only one track.
1024
+ * @example
1025
+ * ```typescript
1026
+ * carPlayLoadingTitle: t('loading')
1027
+ * ```
705
1028
  *
706
- * @default true
707
1029
  * @platform ios
708
1030
  */
709
- carPlayUpNextButton?: boolean
1031
+ carPlayLoadingTitle?: string
710
1032
 
711
1033
  /**
712
- * Configure up to 5 buttons on the CarPlay Now Playing screen. These buttons
713
- * are arranged using the array order from left to right.
1034
+ * Called when the active track changes and it has no {@link Track.albumPath}.
1035
+ * Return a browse path to make the album line on the CarPlay Now Playing
1036
+ * screen tappable: a tap navigates the CarPlay browse stack there. Return
1037
+ * `undefined` to leave the album line untappable for this track.
1038
+ *
1039
+ * The library calls it ahead of any tap, so the album line is tappable only
1040
+ * when there is somewhere to go.
714
1041
  *
715
1042
  * @example
716
1043
  * ```typescript
717
- * carPlayNowPlayingButtons: ['repeat']
1044
+ * resolveAlbumPath: (track) =>
1045
+ * track.album ? `/album/${slugify(track.album)}` : undefined
718
1046
  * ```
719
1047
  *
720
- * @default []
721
1048
  * @platform ios
722
1049
  */
723
- carPlayNowPlayingButtons?: CarPlayNowPlayingButton[]
1050
+ resolveAlbumPath?: ResolveAlbumPathCallback
724
1051
 
725
1052
  /**
726
1053
  * Callback to customize error messages for navigation errors.
727
- * Used by CarPlay and available via `useFormattedNavigationError()` for app UI.
1054
+ * Used by CarPlay and Android Auto, and available via
1055
+ * `useFormattedNavigationError()` for app UI.
728
1056
  *
729
1057
  * If not provided or returns undefined, default English messages are used.
730
1058
  *
731
1059
  * @example
732
1060
  * ```typescript
733
- * formatNavigationError: (error) => ({
734
- * title: t(`error.${error.code}`),
735
- * message: error.code === 'http-error'
736
- * ? t('error.httpMessage', { status: error.statusCode })
737
- * : error.message
738
- * })
1061
+ * formatNavigationError: ({ error, defaultFormatted }) => {
1062
+ * if (error.code === 'http-error') {
1063
+ * return {
1064
+ * title: t('error.serverError'),
1065
+ * message: t('error.httpMessage', { status: error.statusCode })
1066
+ * }
1067
+ * }
1068
+ * return defaultFormatted
1069
+ * }
739
1070
  * ```
740
1071
  */
741
1072
  formatNavigationError?: FormatNavigationErrorCallback
@@ -757,6 +1088,17 @@ export type CarPlayNowPlayingButton =
757
1088
  | 'favorite'
758
1089
  | 'playback-rate'
759
1090
 
1091
+ /**
1092
+ * Where the now-playing indicator draws on a CarPlay list row.
1093
+ *
1094
+ * - `'leading'`: in the artwork slot, replacing the row's artwork while it
1095
+ * plays (the system default, as Apple Music does)
1096
+ * - `'trailing'`: at the end of the row, keeping the artwork visible
1097
+ *
1098
+ * @platform ios
1099
+ */
1100
+ export type CarPlayPlayingIndicatorLocation = 'leading' | 'trailing'
1101
+
760
1102
  /**
761
1103
  * Position of the "Ask Siri to Play Audio" assistant cell on a CarPlay list template.
762
1104
  *
@@ -770,24 +1112,33 @@ export type CarPlaySiriListButtonPosition = 'top' | 'bottom'
770
1112
  */
771
1113
  export type FormattedNavigationError = {
772
1114
  /**
773
- * Title shown in the error action sheet header.
1115
+ * Title of the error.
774
1116
  *
775
1117
  * Default values:
776
1118
  * - `'content-not-found'`: "Content Not Found" (English)
777
1119
  * - `'network-error'`: "Network Error" (English)
778
- * - `'http-error'`: System-localized status text (e.g., "Not Found", "Service Unavailable")
1120
+ * - `'http-error'`: the status text, system-localized on iOS (e.g. "Not
1121
+ * Found", "Service Unavailable"); on Android an English name for common
1122
+ * codes. "Server Error" when there is no status code, for codes Android
1123
+ * does not name, and always on web
779
1124
  * - `'callback-error'`: "Error" (English)
1125
+ * - `'empty-content'`: "Nothing here" (English)
1126
+ * - `'timeout'`: "Couldn't load" (English)
780
1127
  * - `'unknown-error'`: "Error" (English)
781
1128
  */
782
1129
  title: string
783
1130
  /**
784
- * Message body shown below the title in the error action sheet.
1131
+ * Optional second line — the subtitle in the browse error/empty view. Omit it
1132
+ * to show a title only.
785
1133
  *
786
- * Default value: `error.message`
1134
+ * Default value: `error.message` (omitted when that is empty).
787
1135
  */
788
- message: string
1136
+ message?: string
789
1137
  }
790
1138
 
1139
+ /** What was being requested when a navigation error occurred. */
1140
+ export type NavigationErrorKind = 'browse' | 'search'
1141
+
791
1142
  /**
792
1143
  * Parameters passed to the formatNavigationError callback.
793
1144
  */
@@ -798,6 +1149,8 @@ export type FormatNavigationErrorParams = {
798
1149
  defaultFormatted: FormattedNavigationError
799
1150
  /** The path that was being navigated to when the error occurred */
800
1151
  path: string
1152
+ /** Whether the failed request was a browse or a search */
1153
+ kind: NavigationErrorKind
801
1154
  }
802
1155
 
803
1156
  /**
@@ -810,7 +1163,10 @@ export type FormatNavigationErrorParams = {
810
1163
  * @example
811
1164
  * ```typescript
812
1165
  * // Override only specific error types or routes
813
- * formatNavigationError: ({ error, defaultFormatted, path }) => {
1166
+ * formatNavigationError: ({ error, defaultFormatted, path, kind }) => {
1167
+ * if (error.code === 'empty-content' && kind === 'search') {
1168
+ * return { title: 'No results found' }
1169
+ * }
814
1170
  * // Custom message for local server routes
815
1171
  * if (error.code === 'network-error' && path.startsWith('/errors')) {
816
1172
  * return {
@@ -826,3 +1182,12 @@ export type FormatNavigationErrorParams = {
826
1182
  export type FormatNavigationErrorCallback = (
827
1183
  params: FormatNavigationErrorParams
828
1184
  ) => FormattedNavigationError | undefined
1185
+
1186
+ /**
1187
+ * Maps the active track to a browse path for the CarPlay album line, or
1188
+ * `undefined` to leave the line untappable. See {@link BrowserConfiguration.resolveAlbumPath | resolveAlbumPath}.
1189
+ */
1190
+ export type ResolveAlbumPathCallback = (track: Track) => string | undefined
1191
+
1192
+ /** Supplies the title of the appended "view more" row. See `viewMoreTitle`. */
1193
+ export type ViewMoreTitleCallback = () => string