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
@@ -1,23 +1,35 @@
1
1
  package com.audiobrowser.browser
2
2
 
3
3
  import android.util.LruCache
4
+ import androidx.media3.common.C
4
5
  import androidx.media3.common.MediaItem
5
6
  import androidx.media3.session.MediaSession
7
+ import com.audiobrowser.extension.identity
6
8
  import com.audiobrowser.http.HttpClient
7
9
  import com.audiobrowser.http.RequestConfigBuilder
8
10
  import com.audiobrowser.util.BrowserPathHelper
11
+ import com.audiobrowser.util.FALLBACK_TIMEOUT
9
12
  import com.audiobrowser.util.TrackFactory
13
+ import com.audiobrowser.util.artworkOf
14
+ import com.audiobrowser.util.awaitCancellable
15
+ import com.audiobrowser.util.awaitNested
16
+ import com.audiobrowser.util.awaitOrTimeout
10
17
  import com.margelo.nitro.audiobrowser.ArtworkRequestConfig
11
18
  import com.margelo.nitro.audiobrowser.BrowserSourceCallbackParam
19
+ import com.margelo.nitro.audiobrowser.Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____
12
20
  import com.margelo.nitro.audiobrowser.ImageContext
13
- import com.margelo.nitro.audiobrowser.ImageSource
21
+ import com.margelo.nitro.audiobrowser.MediaReference
14
22
  import com.margelo.nitro.audiobrowser.MediaRequestConfig
15
23
  import com.margelo.nitro.audiobrowser.NativeRouteEntry
16
24
  import com.margelo.nitro.audiobrowser.RequestConfig
17
25
  import com.margelo.nitro.audiobrowser.ResolvedTrack
18
26
  import com.margelo.nitro.audiobrowser.SearchParams
27
+ import com.margelo.nitro.audiobrowser.Section
28
+ import com.margelo.nitro.audiobrowser.StyleDisplay
19
29
  import com.margelo.nitro.audiobrowser.Track
20
30
  import com.margelo.nitro.audiobrowser.TransformableRequestConfig
31
+ import com.margelo.nitro.core.Promise
32
+ import kotlinx.coroutines.CancellationException
21
33
  import kotlinx.coroutines.Dispatchers
22
34
  import kotlinx.coroutines.async
23
35
  import kotlinx.coroutines.awaitAll
@@ -26,15 +38,6 @@ import kotlinx.coroutines.withContext
26
38
  import kotlinx.serialization.json.Json
27
39
  import timber.log.Timber
28
40
 
29
- /**
30
- * Core browser manager that handles navigation, search, and media browsing.
31
- *
32
- * This class contains the main business logic for:
33
- * - Route resolution and path matching with parameter extraction
34
- * - HTTP API requests and response processing
35
- * - JavaScript callback invocation
36
- * - Fallback handling and error management
37
- */
38
41
  class BrowserManager {
39
42
  private val router = SimpleRouter()
40
43
  private val httpClient = HttpClient()
@@ -46,6 +49,7 @@ class BrowserManager {
46
49
  private var onPathChanged: ((String) -> Unit)? = null
47
50
  private var onContentChanged: ((ResolvedTrack?) -> Unit)? = null
48
51
  private var onTabsChanged: ((Array<Track>) -> Unit)? = null
52
+ private var onArtworkRegistriesCleared: (() -> Unit)? = null
49
53
 
50
54
  private var path: String = "/"
51
55
  set(value) {
@@ -70,7 +74,6 @@ class BrowserManager {
70
74
  set(value) {
71
75
  val previous = field
72
76
  field = value
73
- // Arrays need contentEquals for comparison
74
77
  if (value != null && !value.contentEquals(previous)) {
75
78
  onTabsChanged?.invoke(value)
76
79
  } else if (value == null && previous != null) {
@@ -78,131 +81,174 @@ class BrowserManager {
78
81
  }
79
82
  }
80
83
 
81
- // LRU cache for individual tracks - keyed by both url and src for O(1) lookup
84
+ // Keyed by id, path and src (see cacheTrack), so one track takes up to three entries.
82
85
  private val trackCache = LruCache<String, Track>(3000)
83
86
 
84
- // LRU cache for resolved content - keyed by path
85
- // Keeps recently visited paths cached for fast back navigation and tab switching
86
- // Invalidated via invalidateContentCache() when content changes
87
87
  private val contentCache = LruCache<String, ResolvedTrack>(20)
88
88
 
89
- // Cache for search results - keyed by query string
90
- private var lastSearchQuery: String? = null
91
- private var lastSearchResults: Array<Track>? = null
89
+ // Moves on clearContentCache, so a fetch that outlives one caches nothing; [pageGenerations]
90
+ // does the same for one path, and is cleared only together with a move of this. Separate from
91
+ // layerGeneration, which also moves on every path change. Car browses run on IO threads and
92
+ // the clear on the JS thread: each check and its write hold [cacheLock].
93
+ @Volatile private var contentGeneration = 0
94
+ private val pageGenerations = HashMap<String, Int>()
95
+ private var tabsGeneration = -1
96
+ private val cacheLock = Any()
92
97
 
93
- // Set of favorited track identifiers (src)
98
+ // Query and results stored as one pair, so a concurrent reader never matches one query with
99
+ // another query's results.
100
+ @Volatile private var lastSearch: Pair<String, Array<Track>>? = null
101
+
102
+ // Track identities: id when non-blank, else src (ADR 0008).
94
103
  private var favoriteIds = setOf<String>()
95
104
 
96
- // Navigation tracking to prevent race conditions
105
+ private var favoriteEnabled: Boolean = false
106
+
97
107
  @Volatile private var currentNavigationId = 0
98
108
 
99
109
  /**
100
- * Browser configuration containing routes, search, tabs, and request settings. This can be
101
- * updated dynamically when the configuration changes.
110
+ * Setting a new config re-resolves the request/browse resolver layers and the "view more" title
111
+ * on the next request, and clears the artwork registries: their registrations pin the previous
112
+ * config's JS callback handles.
102
113
  */
103
114
  var config: BrowserConfig = BrowserConfig()
115
+ set(value) {
116
+ field = value
117
+ layerGeneration += 1
118
+ artworkResolutions.clear()
119
+ onArtworkRegistriesCleared?.invoke()
120
+ }
104
121
 
105
- /**
106
- * Callback to transform artwork URLs for tracks. Takes a track and optional per-route artwork
107
- * config, returns ImageSource or null. Injected by AudioBrowser when artwork config is set.
108
- * The ImageContext parameter provides size hints for CDN URL generation.
109
- */
110
- var artworkUrlResolver: (suspend (Track, ArtworkRequestConfig?, ImageContext?) -> ImageSource?)? = null
122
+ // Request/browse resolver layers, resolved once per generation and merged per request. The
123
+ // generation moves on a new config or clearContentCache (invalidateAllContent).
124
+ private var layerGeneration = 0
125
+ private var resolvedLayerGeneration = -1
126
+ private var resolvedRequestLayer: TransformableRequestConfig? = null
127
+ private var resolvedBrowseLayer: TransformableRequestConfig? = null
128
+
129
+ // Cached on the same generation, but resolved lazily: only a browse that appends a "view more"
130
+ // row asks for it.
131
+ private var resolvedViewMoreTitleGeneration = -1
132
+ private var resolvedViewMoreTitle = DEFAULT_VIEW_MORE_TITLE
133
+
134
+ internal val layerGenerationForTest: Int
135
+ get() = layerGeneration
136
+
137
+ internal val resolvedLayerGenerationForTest: Int
138
+ get() = resolvedLayerGeneration
139
+
140
+ internal val resolvedRequestLayerForTest: TransformableRequestConfig?
141
+ get() = resolvedRequestLayer
142
+
143
+ internal val resolvedBrowseLayerForTest: TransformableRequestConfig?
144
+ get() = resolvedBrowseLayer
111
145
 
112
146
  /**
113
- * Sets the favorited track identifiers. Tracks will have their favorited field hydrated based on
114
- * this list during browsing.
147
+ * Maps produced artwork URIs back to the track and config that made them, so display-time loading
148
+ * (which gets only a URI from Media3) can re-resolve with a size. See
149
+ * [ArtworkResolutionRegistry].
115
150
  */
151
+ val artworkResolutions = ArtworkResolutionRegistry()
152
+
153
+ /** Sets the favorited track identities (id when non-blank, else src). */
116
154
  fun setFavorites(favorites: List<String>) {
117
155
  favoriteIds = favorites.toSet()
118
156
  Timber.d("Set ${favoriteIds.size} favorite IDs")
119
157
  }
120
158
 
121
- /**
122
- * Updates the favorite state for a single track identifier. Called when the heart button is
123
- * tapped in media controllers.
124
- */
125
- fun updateFavorite(id: String, favorited: Boolean) {
159
+ fun setFavoriteEnabled(enabled: Boolean) {
160
+ favoriteEnabled = enabled
161
+ }
162
+
163
+ fun updateFavorite(identity: String, favorited: Boolean) {
126
164
  favoriteIds =
127
165
  if (favorited) {
128
- favoriteIds + id
166
+ favoriteIds + identity
129
167
  } else {
130
- favoriteIds - id
168
+ favoriteIds - identity
131
169
  }
132
- Timber.d("Updated favorite for '$id' to $favorited (total: ${favoriteIds.size})")
170
+ Timber.d("Updated favorite for '$identity' to $favorited (total: ${favoriteIds.size})")
133
171
  }
134
172
 
135
173
  /**
136
- * Hydrates the favorited field on a track based on the favoriteIds set. Only hydrates if
137
- * track.favorited is null (doesn't overwrite API-provided values). Only tracks with src can be
138
- * favorited.
174
+ * Sets `favorited` to true or false, so a track that isn't a favorite still shows an empty heart.
175
+ * A value the source already set wins; a track without an identity is left unset.
139
176
  */
140
177
  private fun hydrateFavorite(track: Track): Track {
141
- // Don't overwrite API-provided favorites
178
+ if (!favoriteEnabled) return track
142
179
  if (track.favorited != null) return track
143
- if (favoriteIds.isEmpty()) return track
144
-
145
- val isFavorited = track.src?.let { favoriteIds.contains(it) } ?: false
146
- if (!isFavorited) return track
147
-
148
- return Track(
149
- url = track.url,
150
- src = track.src,
151
- artwork = track.artwork,
152
- artworkSource = track.artworkSource,
153
- artworkCarPlayTinted = track.artworkCarPlayTinted,
154
- title = track.title,
155
- subtitle = track.subtitle,
156
- artist = track.artist,
157
- album = track.album,
158
- description = track.description,
159
- genre = track.genre,
160
- duration = track.duration,
161
- style = track.style,
162
- childrenStyle = track.childrenStyle,
163
- favorited = true,
164
- groupTitle = track.groupTitle,
165
- live = track.live,
166
- imageRow = track.imageRow,
167
- )
180
+ if (track.identity == null) return track
181
+
182
+ return track.copy(favorited = isFavorite(track))
168
183
  }
169
184
 
170
- /** Hydrates favorites on all children of a ResolvedTrack. */
185
+ private fun isFavorite(track: Track): Boolean =
186
+ track.identity?.let { favoriteIds.contains(it) } == true
187
+
188
+ // Pages arrive normalized (ADR 0010): `sections` is the only structure to walk.
171
189
  private fun hydrateChildren(resolvedTrack: ResolvedTrack): ResolvedTrack {
172
- val children = resolvedTrack.children ?: return resolvedTrack
173
- val hydratedChildren = children.map { hydrateFavorite(it) }.toTypedArray()
174
- return resolvedTrack.copy(children = hydratedChildren)
190
+ val sections = resolvedTrack.sections ?: return resolvedTrack
191
+ return resolvedTrack.copy(
192
+ sections =
193
+ sections
194
+ .map { section ->
195
+ section.copy(children = section.children.map { hydrateFavorite(it) }.toTypedArray())
196
+ }
197
+ .toTypedArray()
198
+ )
175
199
  }
176
200
 
177
- /** Cache a track by both url and src for O(1) lookup from either key. */
178
201
  private fun cacheTrack(track: Track) {
179
- track.url?.let { trackCache.put(it, track) }
202
+ track.id?.takeUnless { it.isBlank() }?.let { trackCache.put(it, track) }
203
+ track.path?.let { trackCache.put(it, track) }
180
204
  track.src?.let { trackCache.put(it, track) }
181
205
  }
182
206
 
183
207
  private fun cacheChildren(resolvedTrack: ResolvedTrack) {
184
- resolvedTrack.children?.forEach { track -> cacheTrack(track) }
208
+ resolvedTrack.flattenedChildren?.forEach { cacheTrack(it) }
185
209
  }
186
210
 
211
+ // Warns once per page: the check runs again on every onGetChildren serve. Concurrent: those
212
+ // serves run several at once on the IO pool.
213
+ private val promiseWarnedPaths = java.util.concurrent.ConcurrentHashMap.newKeySet<String>()
214
+
187
215
  /**
188
- * Get a cached Track by mediaId (url or src), or null if not cached. Used by Media3 to rehydrate
189
- * MediaItem shells with full track metadata. Re-hydrates favorites in case setFavoriteStates was
190
- * called after caching.
216
+ * Dev diagnostic (ADR 0011): an all-grid page under a browsable handle that declares no
217
+ * `style.display` renders as a list on Android Auto, which takes the layout from the parent-level
218
+ * hint, emitted only when the handle declares it. A handle missing from the cache (cold start
219
+ * straight into the page) skips the check. A mixed page never warns: the parent hint lays out the
220
+ * whole page, so grid would tile its list sections too.
221
+ */
222
+ fun warnIfGridPageLacksPromise(path: String, sections: List<Section>) {
223
+ if (sections.isEmpty() || !sections.all { it.style?.display == StyleDisplay.GRID }) return
224
+ val handle = trackCache.get(path) ?: return
225
+ if (handle.src != null) return // rendered playable: opens no page
226
+ if (handle.style?.display == null && promiseWarnedPaths.add(path)) {
227
+ Timber.w(
228
+ "Page '%s' serves grid sections, but its browsable handle declares no style.display — " +
229
+ "Android Auto's parent-level hint was not emitted, so this page renders as a list " +
230
+ "there. Declare `style: { display: 'grid' }` on the handle track.",
231
+ path,
232
+ )
233
+ }
234
+ }
235
+
236
+ /**
237
+ * Returns the cached track for a mediaId (id, path or src, or a contextual path's trackId), with
238
+ * favorites re-hydrated, or null when it isn't cached.
191
239
  */
192
240
  fun getCachedTrack(mediaId: String): Track? {
193
- // Try direct lookup first (matches url or src)
194
241
  trackCache.get(mediaId)?.let { track ->
195
242
  val hydratedTrack = hydrateFavorite(track)
196
243
  Timber.d("Cache HIT for mediaId='$mediaId' → '${track.title}'")
197
244
  return hydratedTrack
198
245
  }
199
246
 
200
- // Try extracting src from contextual URL
201
247
  val trackId = BrowserPathHelper.extractTrackId(mediaId)
202
248
  if (trackId != null) {
203
249
  trackCache.get(trackId)?.let { track ->
204
250
  val hydratedTrack = hydrateFavorite(track)
205
- Timber.d("Cache HIT (extracted src) for mediaId='$mediaId' → '${track.title}'")
251
+ Timber.d("Cache HIT (extracted identity) for mediaId='$mediaId' → '${track.title}'")
206
252
  return hydratedTrack
207
253
  }
208
254
  }
@@ -212,75 +258,107 @@ class BrowserManager {
212
258
  }
213
259
 
214
260
  /**
215
- * Resolves multiple media IDs from cache. Throws IllegalStateException if any mediaId is not
216
- * found in cache.
261
+ * The contextual path to expand a queue from, or null. A stable-id mediaId resolves through the
262
+ * track cache to the container it was most recently browsed in: a legacy car controller
263
+ * round-trips only the mediaId, so the cache is what remembers which list the row came from.
264
+ */
265
+ fun contextualPathFor(mediaId: String): String? {
266
+ if (BrowserPathHelper.isContextual(mediaId)) return mediaId
267
+ return getCachedTrack(mediaId)?.path?.takeIf { BrowserPathHelper.isContextual(it) }
268
+ }
269
+
270
+ /**
271
+ * A cache miss is reachable: a controller can replay a mediaId this process never browsed (a
272
+ * search result after process death). When the mediaId is a playable URL, or the item's
273
+ * requestMetadata carries the playable uri (stamped by TrackFactory), it builds a minimal track
274
+ * from the item's metadata.
217
275
  *
218
- * @param mediaIds The media IDs to resolve
219
- * @return List of Track objects
276
+ * @throws IllegalStateException when the mediaId is not cached and no playable URL is available
220
277
  */
221
- fun resolveMediaIdsFromCache(mediaIds: List<String>): List<Track> {
222
- return mediaIds.map { mediaId ->
223
- Timber.d("=== Resolving from cache: mediaId='$mediaId' ===")
278
+ private fun resolveMediaItemToTrack(mediaItem: MediaItem): Track {
279
+ val mediaId = mediaItem.mediaId
224
280
 
225
- getCachedTrack(mediaId)?.let { cachedTrack ->
226
- Timber.d("→ Found cached Track: '${cachedTrack.title}'")
227
- return@map cachedTrack
228
- }
281
+ getCachedTrack(mediaId)?.let { cachedTrack ->
282
+ Timber.d("Resolved mediaId='$mediaId' from cache: '${cachedTrack.title}'")
283
+ return cachedTrack
284
+ }
229
285
 
230
- // Cache miss - this indicates a bug in our caching system
231
- Timber.e("→ Cache MISS for mediaId='$mediaId' - this should not happen")
232
- throw IllegalStateException(
233
- "MediaItem not found in cache: $mediaId. This indicates a bug in the caching system."
286
+ val fallbackSrc =
287
+ if (mediaId.startsWith("http://") || mediaId.startsWith("https://")) {
288
+ mediaId
289
+ } else {
290
+ mediaItem.requestMetadata.mediaUri?.toString()
291
+ }
292
+ if (fallbackSrc != null) {
293
+ Timber.w("Cache MISS for mediaId='$mediaId' - building minimal track from media item")
294
+ val metadata = mediaItem.mediaMetadata
295
+ return hydrateFavorite(
296
+ Track(
297
+ // A mediaId distinct from the playable uri is the stable id; keeping it lets the car's
298
+ // now-playing row match.
299
+ id = mediaId.takeIf { it != fallbackSrc },
300
+ path = null,
301
+ src = fallbackSrc,
302
+ artwork = artworkOf(metadata.artworkUri?.toString()),
303
+ artworkSource = null,
304
+ request = null,
305
+ title = metadata.title?.toString() ?: mediaId,
306
+ subtitle = metadata.artist?.toString(),
307
+ artist = null,
308
+ albumPath = null,
309
+ album = metadata.albumTitle?.toString(),
310
+ description = metadata.description?.toString(),
311
+ genre = metadata.genre?.toString(),
312
+ duration = null,
313
+ style = null,
314
+ disabled = null,
315
+ favorited = null,
316
+ live = null,
317
+ icyCharset = null,
318
+ )
234
319
  )
235
320
  }
321
+
322
+ throw IllegalStateException("MediaItem not found in cache: $mediaId")
236
323
  }
237
324
 
238
325
  /**
239
- * **Media3/Android Auto Integration Entry Point**
240
- *
241
- * Resolves Media3 MediaItems for playback, with special handling for Android Auto queue
242
- * expansion. Called exclusively from `MediaSessionCallback.onSetMediaItems()`.
326
+ * Resolves the items `MediaSessionCallback.onSetMediaItems()` receives. A single item with a
327
+ * search query plays the search results from that item; a single contextual item expands to the
328
+ * tapped section's queue. Otherwise each item resolves through the track cache. Disabled tracks
329
+ * are dropped and the start index shifts to match.
243
330
  *
244
- * Behavior:
245
- * - Single item: Attempts queue expansion (Android Auto album/playlist restoration)
246
- * - Multiple items OR expansion fails: Falls back to cache resolution
247
- *
248
- * @param mediaItems List of Media3 MediaItems requested for playback
249
- * @param startIndex Index of the item to start playing
250
- * @param startPositionMs Position within the start item to begin playback
251
- * @return MediaSession.MediaItemsWithStartPosition ready for Media3
252
- * @throws IllegalStateException if any mediaId is not found in cache
331
+ * @throws IllegalStateException when the start track is disabled, every track is disabled, or a
332
+ * mediaId is neither cached nor a playable URL
253
333
  */
254
334
  suspend fun resolveMediaItemsForPlayback(
255
335
  mediaItems: List<MediaItem>,
256
336
  startIndex: Int,
257
337
  startPositionMs: Long,
258
338
  ): MediaSession.MediaItemsWithStartPosition {
259
- // Android Auto queue expansion: single track → full album/playlist
260
339
  if (mediaItems.size == 1) {
261
340
  val mediaItem = mediaItems[0]
262
341
 
263
- // Handle search query - user initiated playback from search results
264
342
  val searchQuery = mediaItem.requestMetadata.searchQuery
265
343
  if (searchQuery != null) {
266
344
  Timber.d("Handling search playback request for query: $searchQuery")
267
345
 
268
- // Execute search (will hit cache if already performed)
269
346
  val searchResults = search(searchQuery)
270
- val searchTracks = searchResults.children
347
+ val searchTracks =
348
+ searchResults.flattenedChildren?.filterNot { it.disabled == true }?.toTypedArray()
271
349
 
272
350
  if (searchTracks != null && searchTracks.isNotEmpty()) {
273
- // Find the selected track in search results
274
351
  val mediaId = mediaItem.mediaId
275
352
  val selectedIndex =
276
- searchTracks.indexOfFirst { track -> track.url == mediaId || track.src == mediaId }
353
+ searchTracks.indexOfFirst { track ->
354
+ track.id == mediaId || track.path == mediaId || track.src == mediaId
355
+ }
277
356
 
278
357
  if (selectedIndex >= 0) {
279
358
  Timber.d(
280
359
  "Playing search result at index $selectedIndex of ${searchTracks.size} results"
281
360
  )
282
361
 
283
- // Convert to Media3 MediaItems
284
362
  val searchMediaItems = searchTracks.map { track -> TrackFactory.toMedia3(track) }
285
363
 
286
364
  return MediaSession.MediaItemsWithStartPosition(
@@ -296,17 +374,19 @@ class BrowserManager {
296
374
  }
297
375
  }
298
376
 
377
+ // A failed search match falls through to plain resolution, never to browse expansion: the
378
+ // user asked for that one result, not a browsed list.
299
379
  val mediaId = mediaItems[0].mediaId
380
+ val contextualPath = if (searchQuery == null) contextualPathFor(mediaId) else null
300
381
 
301
- if (BrowserPathHelper.isContextual(mediaId)) {
302
- Timber.d("Attempting queue expansion for mediaId='$mediaId'")
382
+ if (contextualPath != null) {
383
+ Timber.d("Attempting queue expansion for mediaId='$mediaId' via '$contextualPath'")
303
384
 
304
- val expanded = expandQueueFromContextualUrl(mediaId)
385
+ val expanded = expandQueueFromContextualPath(contextualPath)
305
386
 
306
387
  if (expanded != null) {
307
388
  val (tracks, selectedIndex) = expanded
308
389
 
309
- // Convert to Media3 MediaItems
310
390
  val expandedMediaItems = tracks.map { track -> TrackFactory.toMedia3(track) }
311
391
 
312
392
  return MediaSession.MediaItemsWithStartPosition(
@@ -318,204 +398,220 @@ class BrowserManager {
318
398
  }
319
399
  }
320
400
 
321
- // No expansion - resolve from cache
322
- val mediaIds = mediaItems.map { it.mediaId }
323
- val cachedTracks = resolveMediaIdsFromCache(mediaIds)
401
+ val resolvedTracks = mediaItems.map { resolveMediaItemToTrack(it) }
402
+
403
+ // Refusal fails the future: Media3 surfaces an error to the controller and current playback
404
+ // stays untouched, where an empty item list would clear the timeline. Android Auto and
405
+ // Assistant request playback through Media3's legacy path, which passes C.INDEX_UNSET for
406
+ // "the first item": normalize before the guard, or the refusal misses the cars.
407
+ val effectiveStartIndex = if (startIndex == C.INDEX_UNSET) 0 else startIndex
408
+ val startTrack = resolvedTracks.getOrNull(effectiveStartIndex)
409
+ if (startTrack != null && startTrack.disabled == true) {
410
+ Timber.w("Refusing playback of disabled track: ${startTrack.title}")
411
+ throw IllegalStateException("Refusing playback of disabled track: ${startTrack.title}")
412
+ }
413
+ val playableTracks = resolvedTracks.filterNot { it.disabled == true }
414
+ if (playableTracks.isEmpty()) {
415
+ Timber.w("Refusing playback: every requested track is disabled")
416
+ throw IllegalStateException("Refusing playback: every requested track is disabled")
417
+ }
418
+ // Positional, not indexOf: value equality would map a duplicated track to its first copy.
419
+ val adjustedStartIndex =
420
+ when {
421
+ startIndex == C.INDEX_UNSET -> C.INDEX_UNSET
422
+ startTrack == null -> 0
423
+ else -> resolvedTracks.take(effectiveStartIndex).count { it.disabled != true }
424
+ }
324
425
 
325
- // Convert to Media3 MediaItems
326
- val resolvedMediaItems = cachedTracks.map { track -> TrackFactory.toMedia3(track) }
426
+ val resolvedMediaItems = playableTracks.map { track -> TrackFactory.toMedia3(track) }
327
427
 
328
- return MediaSession.MediaItemsWithStartPosition(resolvedMediaItems, startIndex, startPositionMs)
428
+ return MediaSession.MediaItemsWithStartPosition(
429
+ resolvedMediaItems,
430
+ adjustedStartIndex,
431
+ startPositionMs,
432
+ )
329
433
  }
330
434
 
331
- /**
332
- * Validates that a track has either url or src for stable identification. Throws
333
- * IllegalStateException if validation fails.
334
- */
335
435
  private fun validateTrack(track: Track, context: String) {
336
- if (track.url == null && track.src == null) {
436
+ if (track.path == null && track.src == null) {
337
437
  throw IllegalStateException(
338
- "$context must have either 'url' or 'src' property for stable identification. Track: ${track.title}"
438
+ "$context must have either 'path' or 'src' property for stable identification. Track: ${track.title}"
339
439
  )
340
440
  }
341
441
  }
342
442
 
443
+ /** Resolves the page at [path]; a contextual path resolves its parent container. */
343
444
  suspend fun resolve(path: String, useCache: Boolean = true): ResolvedTrack {
344
445
  Timber.d("=== RESOLVE: path='$path' (useCache=$useCache) ===")
345
446
 
346
- // Strip __trackId from contextual URLs (e.g., "/library/radio?__trackId=song.mp3" →
347
- // "/library/radio")
348
- // This allows resolving the parent container for tracks referenced by contextual URL
349
447
  val normalizedPath = BrowserPathHelper.stripTrackId(path)
350
448
  if (normalizedPath != path) {
351
- Timber.d("Stripped __trackId from contextual URL: '$normalizedPath'")
449
+ Timber.d("Stripped __trackId from contextual path: '$normalizedPath'")
352
450
  }
353
451
 
354
- // Check content cache first
355
452
  if (useCache) {
356
453
  contentCache.get(normalizedPath)?.let { cached ->
357
454
  Timber.d("Content cache HIT for path='$normalizedPath'")
358
- // Re-hydrate favorites in case they changed since caching
455
+ // Re-key the track cache on a hit too: contextualPathFor must see the most recently
456
+ // browsed container.
457
+ cacheChildren(cached)
359
458
  return hydrateChildren(cached)
360
459
  }
361
460
  Timber.d("Content cache MISS for path='$normalizedPath'")
362
461
  }
363
462
 
463
+ val generation = synchronized(cacheLock) { pageGeneration(normalizedPath) }
364
464
  val resolvedTrack = resolveUncached(normalizedPath)
365
465
 
366
- // Cache the resolved content for future navigation
367
- contentCache.put(normalizedPath, resolvedTrack)
466
+ synchronized(cacheLock) {
467
+ if (generation == pageGeneration(normalizedPath)) {
468
+ contentCache.put(normalizedPath, resolvedTrack)
469
+ }
470
+ }
368
471
 
369
- // Cache children for Media3 track lookups (getCachedTrack)
370
472
  cacheChildren(resolvedTrack)
371
473
 
372
474
  return hydrateChildren(resolvedTrack)
373
475
  }
374
476
 
375
- /**
376
- * Invalidates the content cache for a specific path. Called when content at that path has changed
377
- * (e.g., via notifyContentChanged).
378
- *
379
- * @param path The container path to invalidate (e.g., "/library/radio")
380
- * @throws IllegalArgumentException if passed a contextual URL (contains __trackId)
381
- */
477
+ /** @throws IllegalArgumentException when [path] is contextual rather than a container path */
382
478
  fun invalidateContentCache(path: String) {
383
479
  require(!BrowserPathHelper.isContextual(path)) {
384
- "invalidateContentCache() expects a container path, not a contextual URL: $path"
480
+ "invalidateContentCache() expects a container path, not a contextual path: $path"
481
+ }
482
+ synchronized(cacheLock) {
483
+ pageGenerations[path] = (pageGenerations[path] ?: 0) + 1
484
+ contentCache.remove(path)
385
485
  }
386
- contentCache.remove(path)
387
486
  Timber.d("Invalidated content cache for path='$path'")
388
487
  }
389
488
 
390
- /** Clears all cached content. Used when artwork resolver is wired up to force re-fetch. */
489
+ private fun pageGeneration(path: String) = contentGeneration to pageGenerations[path]
490
+
491
+ /**
492
+ * Clears every cached page and the last search, which nothing else evicts, and re-resolves the
493
+ * tabs, resolver layers and "view more" title on the next request. A fetch in flight caches
494
+ * nothing.
495
+ */
391
496
  fun clearContentCache() {
392
- contentCache.evictAll()
497
+ synchronized(cacheLock) {
498
+ contentGeneration += 1
499
+ pageGenerations.clear()
500
+ contentCache.evictAll()
501
+ lastSearch = null
502
+ }
503
+ layerGeneration += 1
504
+ artworkResolutions.clear()
505
+ onArtworkRegistriesCleared?.invoke()
393
506
  Timber.d("Cleared all content cache")
394
507
  }
395
508
 
396
509
  private suspend fun resolveUncached(path: String): ResolvedTrack {
397
- val routes = config.routes
398
- if (routes.isNullOrEmpty()) {
399
- Timber.e("No routes configured for path: $path")
400
- throw ContentNotFoundException(path)
510
+ // With no route matched, the implicit default fetches the path via the request + browse config.
511
+ val match = config.routes?.let { findBestRouteMatch(path, it) }
512
+
513
+ val resolvedTrack: ResolvedTrack
514
+ val effectiveArtworkConfig: ArtworkRequestConfig?
515
+ if (match != null) {
516
+ val (routeEntry, routeParams) = match
517
+ Timber.d("Matched route: ${routeEntry.path} with params: $routeParams")
518
+ resolvedTrack = resolveRouteEntry(routeEntry, path, routeParams)
519
+ effectiveArtworkConfig = routeEntry.artwork ?: config.artwork
520
+ } else {
521
+ Timber.d("No route matched for path: $path — using implicit default")
522
+ resolvedTrack = executeApiRequest(null, path, mapOf("path" to path))
523
+ effectiveArtworkConfig = config.artwork
401
524
  }
402
525
 
403
- // Find best matching route
404
- val (routeEntry, routeParams) =
405
- findBestRouteMatch(path, routes)
406
- ?: run {
407
- Timber.e("No route matched for path: $path")
408
- throw ContentNotFoundException(path)
409
- }
410
-
411
- Timber.d("Matched route: ${routeEntry.path} with params: $routeParams")
412
-
413
- // Resolve the track from the route
414
- val resolvedTrack = resolveRouteEntry(routeEntry, path, routeParams)
415
-
416
- // Get effective artwork config: per-route overrides global
417
- val effectiveArtworkConfig = routeEntry.artwork ?: config.artwork
418
-
419
- // Transform children: generate contextual URLs and transform artwork URLs
420
- val transformedChildren =
421
- resolvedTrack.children?.let { children ->
422
- coroutineScope {
423
- children
424
- .mapIndexed { index, track ->
526
+ val sections = resolvedTrack.normalizedSections ?: return resolvedTrack
527
+ // Before the sections are folded, while each level is still attributable.
528
+ InertStyleDiagnostic.warn(path, resolvedTrack.style, sections)
529
+ // The contextual index is the flat page position: children in section order (ADR 0009).
530
+ var flatIndex = 0
531
+ // One scope for the page: every child's artwork transform launches up front, so a slow section
532
+ // doesn't hold up the ones after it.
533
+ val transformedSections = coroutineScope {
534
+ sections
535
+ .map { section ->
536
+ val base = flatIndex
537
+ flatIndex += section.children.size
538
+ section to
539
+ section.children.mapIndexed { offset, track ->
425
540
  async {
426
- // Validate that track has stable identifier
541
+ val index = base + offset
427
542
  validateTrack(track, "Child track")
428
543
 
429
544
  var transformedTrack = track
430
545
 
431
- // Generate contextual URLs for playable tracks
432
- // Always regenerate to reflect the current browsing context, not the original
433
- // context
434
- // (e.g., a track favorited from an album should use /favorites context when browsed
435
- // there)
436
- if (track.src != null) {
437
- val contextualUrl = BrowserPathHelper.build(path, track.src)
438
- transformedTrack = transformedTrack.copy(url = contextualUrl)
546
+ val trackIdentity = track.identity
547
+ // Regenerated on every browse so the path names the container it was browsed in;
548
+ // the flat position breaks ties between duplicate identities.
549
+ if (track.src != null && trackIdentity != null) {
550
+ val contextualPath = BrowserPathHelper.build(path, trackIdentity, index)
551
+ transformedTrack = transformedTrack.copy(path = contextualPath)
439
552
 
440
553
  Timber.d(
441
- "[$path] Child[$index] '${track.title}': Playable, contextualUrl=$contextualUrl (src=${track.src})"
554
+ "[$path] Child[$index] '${track.title}': Playable, contextualPath=$contextualPath (identity=$trackIdentity)"
442
555
  )
443
556
  } else {
444
557
  Timber.d(
445
- "[$path] Child[$index] '${track.title}': Browsable with url=${track.url}"
558
+ "[$path] Child[$index] '${track.title}': Browsable with path=${track.path}"
446
559
  )
447
560
  }
448
561
 
449
- // Transform artwork URL if resolver is configured
450
- // At browse-time, we don't have display size info
451
- val resolver = artworkUrlResolver
452
- if (resolver != null) {
453
- val browseContext = ImageContext(null, null)
454
- transformedTrack =
455
- transformArtworkUrl(
456
- transformedTrack,
457
- effectiveArtworkConfig,
458
- resolver,
459
- path,
460
- index,
461
- browseContext,
462
- )
463
- }
464
-
465
- transformedTrack
562
+ // No display size at browse time.
563
+ transformArtworkUrl(
564
+ transformedTrack,
565
+ effectiveArtworkConfig,
566
+ path,
567
+ index,
568
+ ImageContext(null, null),
569
+ )
466
570
  }
467
571
  }
468
- .awaitAll()
469
572
  }
470
- }
471
-
472
- // Return resolved track with transformed children
473
- return if (transformedChildren != null) {
474
- resolvedTrack.copy(children = transformedChildren.toTypedArray())
475
- } else {
476
- resolvedTrack
573
+ .map { (section, transformedChildren) ->
574
+ section.copy(children = transformedChildren.awaitAll().toTypedArray())
575
+ }
477
576
  }
577
+
578
+ return resolvedTrack.copy(sections = transformedSections.toTypedArray(), children = null)
478
579
  }
479
580
 
480
- /**
481
- * Transforms a track's artwork using the configured resolver. Populates artworkSource with the
482
- * transformed ImageSource, keeping artwork unchanged. Handles all edge cases: undefined returns,
483
- * errors, missing artwork.
484
- *
485
- * @param imageContext Optional size context for CDN URL generation (null at browse-time)
486
- */
487
581
  private suspend fun transformArtworkUrl(
488
582
  track: Track,
489
583
  artworkConfig: ArtworkRequestConfig?,
490
- resolver: suspend (Track, ArtworkRequestConfig?, ImageContext?) -> ImageSource?,
491
584
  path: String,
492
585
  index: Int,
493
586
  imageContext: ImageContext? = null,
494
587
  ): Track {
495
- // No artwork config and no track.artwork - nothing to transform
496
588
  if (artworkConfig == null && track.artwork == null) {
497
589
  return track
498
590
  }
499
591
 
500
592
  return try {
501
- val imageSource = resolver(track, artworkConfig, imageContext)
593
+ val imageSource = resolveArtworkUrl(track, artworkConfig, imageContext)
502
594
 
503
595
  when {
504
- // resolve returned null → no artwork source
505
596
  imageSource == null -> {
506
597
  Timber.d(
507
598
  "[$path] Child[$index] '${track.title}': Artwork resolver returned null, no artworkSource"
508
599
  )
509
600
  track.copy(artworkSource = null)
510
601
  }
511
- // resolve returned ImageSource → set artworkSource
512
602
  else -> {
513
603
  Timber.d("[$path] Child[$index] '${track.title}': artworkSource set: ${imageSource.uri}")
604
+ // Registers a per-route config only, so display-time resolution reads the current
605
+ // config.artwork rather than a stale global.
606
+ artworkResolutions.register(
607
+ imageSource.uri,
608
+ track,
609
+ artworkConfig?.takeIf { it !== config.artwork },
610
+ )
514
611
  track.copy(artworkSource = imageSource)
515
612
  }
516
613
  }
517
614
  } catch (e: Exception) {
518
- // resolve threw → log error, clear artworkSource to avoid broken images
519
615
  Timber.e(
520
616
  e,
521
617
  "[$path] Child[$index] '${track.title}': Artwork transform failed, clearing artworkSource",
@@ -525,97 +621,96 @@ class BrowserManager {
525
621
  }
526
622
 
527
623
  /**
528
- * Expands a contextual URL into a queue of playable tracks.
529
- *
530
- * Used when navigating to a track to load it with its full album/playlist context. Returns only
531
- * the selected track if singleTrack is true.
532
- *
533
- * @param contextualUrl The contextual URL (e.g., "/album?__trackId=song.mp3")
534
- * @return Pair of (tracks array, selected track index), or null if expansion fails
624
+ * Expands a contextual path into the playable, enabled tracks of the tapped section (ADR 0006)
625
+ * and the start index, or only the tapped track when `singleTrack` is set. Returns null when the
626
+ * path is not contextual, the tapped identity is no longer on the page or is disabled, or
627
+ * resolution fails; the caller then plays the stored single track.
535
628
  */
536
- suspend fun expandQueueFromContextualUrl(contextualUrl: String): Pair<Array<Track>, Int>? {
537
- val trackId = BrowserPathHelper.extractTrackId(contextualUrl) ?: return null
629
+ suspend fun expandQueueFromContextualPath(contextualPath: String): Pair<Array<Track>, Int>? {
630
+ val trackId = BrowserPathHelper.extractTrackId(contextualPath) ?: return null
538
631
 
539
- Timber.d("Expanding queue from contextual URL: $contextualUrl (trackId=$trackId)")
632
+ Timber.d("Expanding queue from contextual path: $contextualPath (trackId=$trackId)")
540
633
 
541
634
  try {
542
- // Resolve the parent container to get all siblings
543
- val parentPath = BrowserPathHelper.stripTrackId(contextualUrl)
635
+ val parentPath = BrowserPathHelper.stripTrackId(contextualPath)
544
636
  val parentResolvedTrack = resolve(parentPath)
545
- val children = parentResolvedTrack.children
637
+ val sections = parentResolvedTrack.normalizedSections
546
638
 
547
- if (children.isNullOrEmpty()) {
639
+ if (sections.isNullOrEmpty()) {
548
640
  Timber.w("Parent has no children, cannot expand queue")
549
641
  return null
550
642
  }
551
643
 
552
- // Filter to only playable tracks (tracks with src)
553
- val playableTracks = children.filter { track -> track.src != null }
644
+ // The stamped flat index pins which section and which copy was tapped; a stale index falls
645
+ // back to the first identity match. A vanished identity aborts: queueing the changed list
646
+ // would resume the wrong station.
647
+ val tappedIndex = BrowserPathHelper.extractIndex(contextualPath)
648
+ val scoped = SectionScope.scoped(sections, trackId, tappedIndex) ?: return null
649
+ val sectionTracks = scoped.section.children.toList()
650
+ val tappedOffset = scoped.tappedOffset
651
+
652
+ val playableTracks =
653
+ sectionTracks.filter { track -> track.src != null && track.disabled != true }
554
654
 
555
655
  if (playableTracks.isEmpty()) {
556
656
  Timber.w("Parent has no playable tracks, cannot expand queue")
557
657
  return null
558
658
  }
559
659
 
560
- // Find the index of the selected track in the playable tracks array
561
- val selectedIndex = playableTracks.indexOfFirst { track -> track.src == trackId }
660
+ val selectedIndex =
661
+ if (
662
+ tappedOffset != null &&
663
+ sectionTracks[tappedOffset].src != null &&
664
+ sectionTracks[tappedOffset].disabled != true
665
+ ) {
666
+ sectionTracks.take(tappedOffset + 1).count { it.src != null && it.disabled != true } - 1
667
+ } else {
668
+ playableTracks.indexOfFirst { track -> track.identity == trackId }
669
+ }
562
670
 
563
671
  if (selectedIndex < 0) {
564
- Timber.w("Track with src='$trackId' not found in playable children")
672
+ Timber.w("Track with identity='$trackId' not found in playable children")
565
673
  return null
566
674
  }
567
675
 
568
- // Check singleTrack setting - if true, return only the selected track
569
676
  if (config.singleTrack) {
570
677
  Timber.d("singleTrack=true - returning single track at index $selectedIndex")
571
678
  return Pair(arrayOf(playableTracks[selectedIndex]), 0)
572
679
  }
573
680
 
574
681
  Timber.d(
575
- "singleTrack=false - returning ${playableTracks.size} playable tracks (from ${children.size} total), starting at index $selectedIndex"
682
+ "singleTrack=false - returning ${playableTracks.size} playable tracks (from ${sectionTracks.size} in section), starting at index $selectedIndex"
576
683
  )
577
684
  return Pair(playableTracks.toTypedArray(), selectedIndex)
685
+ } catch (e: CancellationException) {
686
+ throw e
578
687
  } catch (e: Exception) {
579
- Timber.e(e, "Error expanding queue from contextual URL: $contextualUrl")
688
+ Timber.e(e, "Error expanding queue from contextual path: $contextualPath")
580
689
  return null
581
690
  }
582
691
  }
583
692
 
584
693
  /**
585
- * Navigate to a path and return browser content.
586
- *
587
- * Uses a navigation ID to prevent race conditions when multiple navigations overlap. Only the
588
- * most recent navigation's result is applied.
589
- *
590
- * @param path The path to navigate to (e.g., "/artists/123")
591
- * @return ResolvedTrack containing the navigation result
694
+ * Sets the path and clears the content at once, then resolves. Only the latest navigation or
695
+ * refresh publishes its content; an overtaken one still returns its result.
592
696
  */
593
697
  suspend fun navigate(path: String): ResolvedTrack {
594
698
  Timber.d("Navigating to path: $path")
595
699
 
596
- // Increment navigation ID and capture for this navigation
597
700
  val navigationId = ++currentNavigationId
598
701
 
599
702
  this.path = path
600
- this.content = null // Clear content immediately to show loading state
703
+ this.content = null
601
704
  val content = resolve(path)
602
705
 
603
- // Only apply result if this is still the current navigation
604
706
  if (navigationId == currentNavigationId) {
605
707
  this.content = content
606
708
  }
607
709
  return content
608
710
  }
609
711
 
610
- /**
611
- * Refresh the current path's content without changing navigation state. Used for background
612
- * refreshes (e.g., when content changes via notifyContentChanged). Bypasses content cache to
613
- * fetch fresh data. Errors are silently ignored.
614
- *
615
- * Uses navigation ID tracking to prevent race conditions.
616
- */
712
+ /** Re-resolves the current path, bypassing the cache. Errors are logged, never thrown. */
617
713
  suspend fun refresh() {
618
- // Increment navigation ID and capture for this refresh
619
714
  val navigationId = ++currentNavigationId
620
715
 
621
716
  val currentPath = path
@@ -625,7 +720,6 @@ class BrowserManager {
625
720
  contentCache.remove(currentPath)
626
721
  val content = resolve(currentPath, useCache = false)
627
722
 
628
- // Only apply result if this is still the current navigation
629
723
  if (navigationId == currentNavigationId) {
630
724
  this.content = content
631
725
  }
@@ -634,24 +728,13 @@ class BrowserManager {
634
728
  }
635
729
  }
636
730
 
637
- /**
638
- * Get cached search results for a query. Used by Media3 onGetSearchResult() callback to retrieve
639
- * previously executed search.
640
- *
641
- * @param query The search query string
642
- * @return Array of Track results, or null if not found
643
- */
731
+ /** Returns the results of the most recent search when [query] matches it, else null. */
644
732
  fun getCachedSearchResults(query: String): Array<Track>? {
645
- if (query != lastSearchQuery) return null
646
- return lastSearchResults?.map { hydrateFavorite(it) }?.toTypedArray()
733
+ val (cachedQuery, cachedResults) = lastSearch ?: return null
734
+ if (query != cachedQuery) return null
735
+ return cachedResults.map { hydrateFavorite(it) }.toTypedArray()
647
736
  }
648
737
 
649
- /**
650
- * Search for tracks and return playable results.
651
- *
652
- * @param query The search query string
653
- * @return Array of playable tracks, or null if no results or search not configured
654
- */
655
738
  suspend fun searchPlayable(query: String): Array<Track>? {
656
739
  return searchPlayable(
657
740
  SearchParams(
@@ -662,21 +745,21 @@ class BrowserManager {
662
745
  album = null,
663
746
  title = null,
664
747
  playlist = null,
748
+ reference = MediaReference.UNKNOWN,
665
749
  )
666
750
  )
667
751
  }
668
752
 
669
753
  /**
670
- * Search for tracks and return playable results. If the first result is browsable, resolves it
671
- * and returns its children. If the first result is playable, returns it. Used for voice search
672
- * "play X" commands.
754
+ * Returns the playable results, or null when there are none. A browsable first result plays its
755
+ * children instead.
673
756
  *
674
- * @param params The structured search parameters
675
- * @return Array of playable tracks, or null if no results or search not configured
757
+ * @throws Exception when the search callback fails; a failed API search returns null
676
758
  */
677
759
  suspend fun searchPlayable(params: SearchParams): Array<Track>? {
678
760
  val searchResults = search(params)
679
- val tracks = searchResults.children
761
+ // Disabled tracks go before the first result is picked, so one can't capture the play.
762
+ val tracks = searchResults.flattenedChildren?.filter { it.disabled != true }?.toTypedArray()
680
763
 
681
764
  if (tracks.isNullOrEmpty()) {
682
765
  return null
@@ -684,14 +767,13 @@ class BrowserManager {
684
767
 
685
768
  val firstResult = tracks[0]
686
769
 
687
- // Check if result is browsable-only (container/route) vs playable
688
- // If it's browsable but also playable (has src or playable=true), treat it as playable
770
+ val firstResultPath = firstResult.path
689
771
  val tracksToFilter =
690
- if (firstResult.src == null) {
691
- Timber.d("First search result is browsable-only, resolving: ${firstResult.url}")
692
- val resolvedTrack = resolve(firstResult.url!!)
693
- resolvedTrack.children
694
- ?.filter { it.src != null }
772
+ if (firstResult.src == null && firstResultPath != null) {
773
+ Timber.d("First search result is browsable-only, resolving: $firstResultPath")
774
+ val resolvedTrack = resolve(firstResultPath)
775
+ resolvedTrack.flattenedChildren
776
+ ?.filter { it.src != null && it.disabled != true }
695
777
  ?.takeIf { it.isNotEmpty() }
696
778
  ?.toTypedArray() ?: tracks
697
779
  } else {
@@ -701,12 +783,6 @@ class BrowserManager {
701
783
  return tracksToFilter.filter { it.src != null }.takeIf { it.isNotEmpty() }?.toTypedArray()
702
784
  }
703
785
 
704
- /**
705
- * Search for tracks using the configured search source.
706
- *
707
- * @param query The search query string
708
- * @return ResolvedTrack containing search results as children
709
- */
710
786
  suspend fun search(query: String): ResolvedTrack {
711
787
  return search(
712
788
  SearchParams(
@@ -717,38 +793,49 @@ class BrowserManager {
717
793
  album = null,
718
794
  title = null,
719
795
  playlist = null,
796
+ reference = MediaReference.UNKNOWN,
720
797
  )
721
798
  )
722
799
  }
723
800
 
724
801
  /**
725
- * Search for tracks using the configured search source. Returns a ResolvedTrack at the path
726
- * /__search?q=query with children containing results. Always executes a fresh search and caches
727
- * results for onGetSearchResult() retrieval.
802
+ * Runs a fresh search and keeps its results for [getCachedSearchResults].
728
803
  *
729
- * @param params The structured search parameters
730
- * @return ResolvedTrack containing search results as children
804
+ * @throws Exception when the search callback fails; a failed API search yields no results
731
805
  */
732
806
  suspend fun search(params: SearchParams): ResolvedTrack {
733
807
  Timber.d("Executing fresh search for: ${params.query} (mode=${params.mode})")
734
808
 
735
809
  val searchPath = BrowserPathHelper.createSearchPath(params.query)
810
+ val generation = contentGeneration
736
811
 
737
812
  try {
738
- // Execute search
739
- val searchResults = resolveSearch(params)
813
+ // Search results skip validateTrack, so one without a path or src is dropped here:
814
+ // TrackFactory.toMedia3 needs one.
815
+ val searchResults =
816
+ resolveSearch(params)
817
+ .filter { track ->
818
+ val valid = track.path != null || track.src != null
819
+ if (!valid) {
820
+ Timber.w("Dropping search result without path or src: '${track.title}'")
821
+ }
822
+ valid
823
+ }
824
+ .toTypedArray()
740
825
 
741
- // Create ResolvedTrack
742
826
  val searchResolvedTrack =
743
827
  ResolvedTrack(
744
- url = searchPath,
828
+ id = null,
829
+ path = searchPath,
745
830
  title = "Search: ${params.query}",
746
- children = searchResults,
831
+ sections = arrayOf(untitledSection(searchResults)),
832
+ children = null,
747
833
  carPlaySiriListButton = null,
748
834
  artwork = null,
749
835
  artworkSource = null,
750
- artworkCarPlayTinted = null,
836
+ request = null,
751
837
  artist = null,
838
+ albumPath = null,
752
839
  description = null,
753
840
  subtitle = null,
754
841
  album = null,
@@ -756,18 +843,16 @@ class BrowserManager {
756
843
  duration = null,
757
844
  src = null,
758
845
  style = null,
759
- childrenStyle = null,
846
+ disabled = null,
760
847
  favorited = null,
761
- groupTitle = null,
762
848
  live = null,
763
- imageRow = null,
849
+ icyCharset = null,
764
850
  )
765
851
 
766
- // Cache search results for getCachedSearchResults()
767
- lastSearchQuery = params.query
768
- lastSearchResults = searchResults
852
+ synchronized(cacheLock) {
853
+ if (generation == contentGeneration) lastSearch = params.query to searchResults
854
+ }
769
855
 
770
- // Cache individual tracks for Media3 lookups
771
856
  cacheChildren(searchResolvedTrack)
772
857
  Timber.d(
773
858
  "Cached search results for query: ${params.query} with ${searchResults.size} results"
@@ -775,134 +860,95 @@ class BrowserManager {
775
860
 
776
861
  return searchResolvedTrack
777
862
  } catch (e: Exception) {
863
+ // Propagates, like iOS `search`: a caller must tell a failed search from an empty one.
778
864
  Timber.e(e, "Error during search for query: ${params.query}")
779
-
780
- // Return empty search result on error
781
- val emptySearchResult =
782
- ResolvedTrack(
783
- url = searchPath,
784
- title = "Search: ${params.query}",
785
- children = emptyArray(),
786
- carPlaySiriListButton = null,
787
- artwork = null,
788
- artworkSource = null,
789
- artworkCarPlayTinted = null,
790
- artist = null,
791
- description = null,
792
- subtitle = null,
793
- album = null,
794
- genre = null,
795
- duration = null,
796
- src = null,
797
- style = null,
798
- childrenStyle = null,
799
- favorited = null,
800
- groupTitle = null,
801
- live = null,
802
- imageRow = null,
803
- )
804
-
805
- return emptySearchResult
865
+ throw e
806
866
  }
807
867
  }
808
868
 
809
- /**
810
- * Get the current navigation path.
811
- *
812
- * @return Current path string
813
- */
814
869
  fun getPath(): String {
815
870
  return path
816
871
  }
817
872
 
818
- /**
819
- * Get the current loaded content.
820
- *
821
- * @return Current ResolvedTrack content or null if none loaded
822
- */
823
873
  fun getContent(): ResolvedTrack? {
824
874
  return content
825
875
  }
826
876
 
827
- /**
828
- * Get the current cached tabs.
829
- *
830
- * @return Current tabs array or null if none loaded
831
- */
832
877
  fun getTabs(): Array<Track>? {
833
878
  return tabs
834
879
  }
835
880
 
836
- /** Set callback for path changes. */
837
881
  fun setOnPathChanged(callback: (String) -> Unit) {
838
882
  onPathChanged = callback
839
883
  }
840
884
 
841
- /** Set callback for content changes. */
842
885
  fun setOnContentChanged(callback: (ResolvedTrack?) -> Unit) {
843
886
  onContentChanged = callback
844
887
  }
845
888
 
846
- /** Set callback for tabs changes. */
847
889
  fun setOnTabsChanged(callback: (Array<Track>) -> Unit) {
848
890
  onTabsChanged = callback
849
891
  }
850
892
 
851
893
  /**
852
- * Query navigation tabs from the configured tabs source. This is an async operation that resolves
853
- * the tabs configuration.
854
- *
855
- * @return Array of Track objects representing tabs
894
+ * Called whenever [artworkResolutions] and the browse-artwork registry are cleared. The caller
895
+ * clears any [BrowseArtworkRegistry] it owns.
896
+ */
897
+ fun setOnArtworkRegistriesCleared(callback: () -> Unit) {
898
+ onArtworkRegistriesCleared = callback
899
+ }
900
+
901
+ /**
902
+ * Resolves the tabs once per [clearContentCache]; later calls return that result. The previous
903
+ * tabs stay until new ones resolve.
856
904
  */
857
905
  suspend fun queryTabs(): Array<Track> {
858
- // Return cached tabs if available
859
- this.tabs?.let {
860
- return it
861
- }
906
+ val generation = contentGeneration
907
+ synchronized(cacheLock) { tabs.takeIf { tabsGeneration == generation } }
908
+ ?.let {
909
+ return it
910
+ }
862
911
 
863
912
  Timber.d("Getting navigation tabs")
864
913
 
865
914
  val tabs = resolveTabs()
866
915
 
867
- // Validate tabs have stable identifiers
868
916
  tabs.forEachIndexed { index, tab ->
869
917
  validateTrack(tab, "Tab")
870
- Timber.d("[TABS] Tab[$index] '${tab.title}': url=${tab.url}")
918
+ Timber.d("[TABS] Tab[$index] '${tab.title}': path=${tab.path}")
871
919
  }
872
920
 
873
- this.tabs = tabs
921
+ synchronized(cacheLock) {
922
+ if (generation == contentGeneration) {
923
+ this.tabs = tabs
924
+ tabsGeneration = generation
925
+ }
926
+ }
874
927
  return tabs
875
928
  }
876
929
 
877
930
  companion object {
878
- /** Internal path used for the default/root browse source */
879
931
  internal const val DEFAULT_ROUTE_PATH = "__default__"
880
932
 
881
- /** Internal path used for navigation tabs */
882
933
  internal const val TABS_ROUTE_PATH = "__tabs__"
883
934
 
884
- /** Internal path used for search */
885
935
  internal const val SEARCH_ROUTE_PATH = "__search__"
936
+
937
+ // English, like defaultFormattedError's copy: it still resolves when the JS runtime is gone.
938
+ internal const val DEFAULT_VIEW_MORE_TITLE = "View more"
886
939
  }
887
940
 
888
- /**
889
- * Find the best matching route entry for a path. Uses SimpleRouter for pattern matching, with
890
- * __default__ as lowest priority fallback.
891
- */
892
941
  private fun findBestRouteMatch(
893
942
  path: String,
894
943
  routes: Array<NativeRouteEntry>,
895
944
  ): Pair<NativeRouteEntry, Map<String, String>>? {
896
- // Convert to map for router compatibility, excluding default fallback
897
945
  val routeMap = routes.filter { it.path != DEFAULT_ROUTE_PATH }.associateBy { it.path }
898
946
 
899
- // Try to find a specific route match
900
947
  router.findBestMatch(path, routeMap)?.let { (routePattern, match) ->
901
948
  val routeEntry = routeMap[routePattern]!!
902
949
  return Pair(routeEntry, match.params)
903
950
  }
904
951
 
905
- // Fall back to default route if present
906
952
  routes
907
953
  .find { it.path == DEFAULT_ROUTE_PATH }
908
954
  ?.let { defaultRoute ->
@@ -912,28 +958,30 @@ class BrowserManager {
912
958
  return null
913
959
  }
914
960
 
915
- /**
916
- * Resolve a NativeRouteEntry into a ResolvedTrack. The entry has flattened browse options:
917
- * callback, config, or static.
918
- */
919
961
  private suspend fun resolveRouteEntry(
920
962
  entry: NativeRouteEntry,
921
963
  path: String,
922
964
  routeParams: Map<String, String>,
923
965
  ): ResolvedTrack {
924
- // Priority: callback > config > static
925
966
  entry.browseCallback?.let { callback ->
926
967
  Timber.d("Resolving route via callback")
927
968
  val param = BrowserSourceCallbackParam(path, routeParams)
928
- val promise = callback.invoke(param)
929
- val innerPromise = promise.await()
930
- val result = innerPromise.await()
931
-
932
- // Handle BrowseResult variant: either ResolvedTrack or BrowseError
933
- return result.match(
934
- first = { resolvedTrack -> resolvedTrack },
935
- second = { browseError -> throw CallbackException(browseError.error) }
936
- )
969
+ // Nitro flattens `(ResolvedTrack | BrowseError) | Promise<BrowseResult>` into three arms.
970
+ return callback
971
+ .invoke(param)
972
+ .awaitCancellable()
973
+ .match(
974
+ first = { resolvedTrack -> resolvedTrack },
975
+ second = { browseError -> throw CallbackException(browseError.error) },
976
+ third = { promise ->
977
+ promise
978
+ .awaitCancellable()
979
+ .match(
980
+ first = { resolvedTrack -> resolvedTrack },
981
+ second = { browseError -> throw CallbackException(browseError.error) },
982
+ )
983
+ },
984
+ )
937
985
  }
938
986
 
939
987
  entry.browseConfig?.let { apiConfig ->
@@ -949,13 +997,9 @@ class BrowserManager {
949
997
  throw ContentNotFoundException(path)
950
998
  }
951
999
 
952
- /**
953
- * Resolve search via the __search__ route entry. The entry has searchCallback or searchConfig.
954
- */
955
1000
  private suspend fun resolveSearch(params: SearchParams): Array<Track> {
956
1001
  val routes = config.routes ?: return emptyArray()
957
1002
 
958
- // Find the __search__ route entry
959
1003
  val searchEntry = routes.find { it.path == SEARCH_ROUTE_PATH }
960
1004
  if (searchEntry == null) {
961
1005
  Timber.w("No search route configured")
@@ -964,9 +1008,7 @@ class BrowserManager {
964
1008
 
965
1009
  searchEntry.searchCallback?.let { callback ->
966
1010
  Timber.d("Resolving search via callback")
967
- val promise = callback.invoke(params)
968
- val innerPromise = promise.await()
969
- return innerPromise.await()
1011
+ return callback.invoke(params).awaitNested()
970
1012
  }
971
1013
 
972
1014
  searchEntry.searchConfig?.let { apiConfig ->
@@ -978,14 +1020,9 @@ class BrowserManager {
978
1020
  return emptyArray()
979
1021
  }
980
1022
 
981
- /**
982
- * Resolve tabs via the __tabs__ route entry. Returns children of the resolved track, or empty
983
- * array if no tabs configured.
984
- */
985
1023
  private suspend fun resolveTabs(): Array<Track> {
986
1024
  val routes = config.routes ?: return emptyArray()
987
1025
 
988
- // Find the __tabs__ route entry
989
1026
  val tabsEntry = routes.find { it.path == TABS_ROUTE_PATH }
990
1027
  if (tabsEntry == null) {
991
1028
  Timber.d("No tabs route configured")
@@ -995,44 +1032,119 @@ class BrowserManager {
995
1032
  Timber.d("Resolving tabs via route entry")
996
1033
  val resolvedTrack = resolveRouteEntry(tabsEntry, TABS_ROUTE_PATH, emptyMap())
997
1034
 
998
- return resolvedTrack.children ?: emptyArray()
1035
+ return resolvedTrack.flattenedChildren?.toTypedArray() ?: emptyArray()
1036
+ }
1037
+
1038
+ private suspend fun resolveLayer(
1039
+ staticConfig: TransformableRequestConfig?,
1040
+ resolver: Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____?,
1041
+ ): TransformableRequestConfig? {
1042
+ if (resolver == null) return staticConfig
1043
+ // The TS layer wraps the thunk in Promise.resolve: await the bridge promise, then the JS one.
1044
+ return resolver.invoke().awaitNested()
1045
+ }
1046
+
1047
+ // No in-flight dedupe: concurrent first requests may both resolve, which is harmless, and a
1048
+ // resolver that throws caches nothing, so the next request retries.
1049
+ internal suspend fun ensureLayersResolved() {
1050
+ if (resolvedLayerGeneration == layerGeneration) return
1051
+ val generation = layerGeneration
1052
+ val req = resolveLayer(config.request, config.requestResolver)
1053
+ val brw = resolveLayer(config.browse, config.browseResolver)
1054
+ if (generation != layerGeneration) return
1055
+ resolvedRequestLayer = req
1056
+ resolvedBrowseLayer = brw
1057
+ resolvedLayerGeneration = generation
1058
+ }
1059
+
1060
+ /**
1061
+ * The request layer for the current generation. Media URLs and artwork read it through here,
1062
+ * never `config.request`, which a resolver-only config leaves unset.
1063
+ */
1064
+ internal suspend fun resolvedRequestConfig(): TransformableRequestConfig? {
1065
+ ensureLayersResolved()
1066
+ return resolvedRequestLayer
1067
+ }
1068
+
1069
+ /**
1070
+ * The title of the "view more" row appended to a pathed section where the header can't be tapped
1071
+ * (Android Auto). Re-read once per generation, so invalidateAllContent picks up a new language.
1072
+ * Falls back to [DEFAULT_VIEW_MORE_TITLE] when unset, blank, throwing or outrunning
1073
+ * [FALLBACK_TIMEOUT].
1074
+ */
1075
+ internal suspend fun viewMoreTitle(): String {
1076
+ val generation = layerGeneration
1077
+ if (resolvedViewMoreTitleGeneration == generation) return resolvedViewMoreTitle
1078
+ val title =
1079
+ try {
1080
+ config.viewMoreTitle?.invoke()?.awaitOrTimeout()?.takeIf { it.isNotBlank() }
1081
+ } catch (e: CancellationException) {
1082
+ throw e
1083
+ } catch (e: Exception) {
1084
+ Timber.e(e, "viewMoreTitle callback failed; falling back to the default")
1085
+ null
1086
+ } ?: DEFAULT_VIEW_MORE_TITLE
1087
+ if (generation != layerGeneration) return title
1088
+ resolvedViewMoreTitle = title
1089
+ resolvedViewMoreTitleGeneration = generation
1090
+ return title
999
1091
  }
1000
1092
 
1001
1093
  /**
1002
- * Execute an API request for browser content. Handles URL parameter substitution, config merging,
1003
- * and transforms.
1094
+ * Layers request → kind (browse/search) → route; each transform receives the previous output.
1095
+ * [path] seeds the base because no layer's static path ever applies; [initialQuery] seeds it
1096
+ * because a layer with a transform receives only the base, so its static query never applies.
1097
+ * Mirrors iOS `buildApiRequest`.
1098
+ *
1099
+ * @throws ContentNotFoundException when no layer supplies a baseUrl
1004
1100
  */
1101
+ internal suspend fun buildApiRequest(
1102
+ kindConfig: TransformableRequestConfig?,
1103
+ routeConfig: TransformableRequestConfig?,
1104
+ path: String?,
1105
+ params: Map<String, String>,
1106
+ initialQuery: Map<String, String>? = null,
1107
+ ): HttpClient.HttpRequest {
1108
+ ensureLayersResolved()
1109
+
1110
+ var merged =
1111
+ RequestConfig(
1112
+ method = null,
1113
+ path = path,
1114
+ baseUrl = null,
1115
+ headers = null,
1116
+ query = null,
1117
+ body = null,
1118
+ contentType = null,
1119
+ userAgent = null,
1120
+ )
1121
+ resolvedRequestLayer?.let { merged = RequestConfigBuilder.mergeConfig(merged, it, params) }
1122
+ if (!initialQuery.isNullOrEmpty()) {
1123
+ merged = merged.copy(query = (merged.query ?: emptyMap()) + initialQuery)
1124
+ }
1125
+ kindConfig?.let { merged = RequestConfigBuilder.mergeConfig(merged, it, params) }
1126
+ routeConfig?.let { merged = RequestConfigBuilder.mergeConfig(merged, it, params) }
1127
+
1128
+ if (merged.baseUrl.isNullOrBlank()) {
1129
+ throw ContentNotFoundException(path ?: "")
1130
+ }
1131
+ return RequestConfigBuilder.buildHttpRequest(merged)
1132
+ }
1133
+
1005
1134
  private suspend fun executeApiRequest(
1006
- apiConfig: TransformableRequestConfig,
1135
+ apiConfig: TransformableRequestConfig?,
1007
1136
  path: String,
1008
1137
  routeParams: Map<String, String>,
1009
1138
  ): ResolvedTrack {
1010
1139
  return withContext(Dispatchers.IO) {
1011
- // 1. Start with base config, using the navigation path as default
1012
- val baseConfig =
1013
- config.request?.let { req ->
1014
- RequestConfigBuilder.toRequestConfig(req).copy(path = req.path ?: path)
1015
- }
1016
- ?: RequestConfig(
1017
- path = path,
1018
- method = null,
1019
- baseUrl = null,
1020
- headers = null,
1021
- query = null,
1022
- body = null,
1023
- contentType = null,
1024
- userAgent = null,
1025
- )
1026
- val mergedConfig = RequestConfigBuilder.mergeConfig(baseConfig, apiConfig, routeParams)
1027
-
1028
- // 2. Build and execute HTTP request
1029
- val httpRequest = RequestConfigBuilder.buildHttpRequest(mergedConfig)
1140
+ ensureLayersResolved()
1141
+ // apiConfig is null for the implicit default.
1142
+ val httpRequest = buildApiRequest(resolvedBrowseLayer, apiConfig, path, routeParams)
1030
1143
  val response = httpClient.request(httpRequest)
1031
1144
 
1032
1145
  response.fold(
1033
1146
  onSuccess = { httpResponse ->
1034
1147
  if (httpResponse.isSuccessful) {
1035
- // 3. Parse response as ResolvedTrack
1036
1148
  val jsonResolvedTrack = json.decodeFromString<JsonResolvedTrack>(httpResponse.body)
1037
1149
  jsonResolvedTrack.toNitro()
1038
1150
  } else {
@@ -1050,40 +1162,16 @@ class BrowserManager {
1050
1162
  }
1051
1163
  }
1052
1164
 
1053
- /**
1054
- * Execute an API request for search results. Automatically adds search parameters to request
1055
- * query:
1056
- * - q: The search query string (always included)
1057
- * - mode: The search mode (any, genre, artist, album, song, playlist) - omitted for unstructured
1058
- * search
1059
- * - genre, artist, album, title, playlist: Included only when non-null
1060
- *
1061
- * Transform callbacks can access and modify all parameters as needed.
1062
- */
1063
1165
  private suspend fun executeSearchApiRequest(
1064
1166
  apiConfig: TransformableRequestConfig,
1065
1167
  params: SearchParams,
1066
1168
  ): Array<Track> {
1067
1169
  return withContext(Dispatchers.IO) {
1068
1170
  try {
1069
- // 1. Start with base config
1070
- val baseConfig =
1071
- config.request?.let { RequestConfigBuilder.toRequestConfig(it) }
1072
- ?: RequestConfig(
1073
- method = null,
1074
- path = null,
1075
- baseUrl = null,
1076
- headers = null,
1077
- query = null,
1078
- body = null,
1079
- contentType = null,
1080
- userAgent = null,
1081
- )
1082
-
1083
- // 2. Build query parameters from SearchParams
1084
1171
  val searchQueryParams = buildMap {
1085
1172
  put("q", params.query)
1086
1173
  params.mode?.let { put("mode", it.toString().lowercase()) }
1174
+ if (params.reference == MediaReference.MY) put("reference", "my")
1087
1175
  params.genre?.let { put("genre", it) }
1088
1176
  params.artist?.let { put("artist", it) }
1089
1177
  params.album?.let { put("album", it) }
@@ -1091,31 +1179,22 @@ class BrowserManager {
1091
1179
  params.playlist?.let { put("playlist", it) }
1092
1180
  }
1093
1181
 
1094
- // 3. Create a copy of API config with added search parameters
1095
- val searchConfig =
1096
- TransformableRequestConfig(
1097
- transform = apiConfig.transform,
1098
- method = apiConfig.method,
1182
+ // No browse layer and no route: search is its own kind.
1183
+ val httpRequest =
1184
+ buildApiRequest(
1185
+ kindConfig = apiConfig,
1186
+ routeConfig = null,
1187
+ // A layer's static path never applies, so the search config's path seeds the base.
1099
1188
  path = apiConfig.path,
1100
- baseUrl = apiConfig.baseUrl,
1101
- headers = apiConfig.headers,
1102
- query = (apiConfig.query ?: emptyMap()) + searchQueryParams,
1103
- body = apiConfig.body,
1104
- contentType = apiConfig.contentType,
1105
- userAgent = apiConfig.userAgent,
1189
+ params = emptyMap(),
1190
+ initialQuery = searchQueryParams,
1106
1191
  )
1107
-
1108
- // 3. Merge configs and apply transform if provided
1109
- var mergedConfig = RequestConfigBuilder.mergeConfig(baseConfig, searchConfig, emptyMap())
1110
-
1111
- // 4. Build and execute HTTP request
1112
- val httpRequest = RequestConfigBuilder.buildHttpRequest(mergedConfig)
1113
1192
  val response = httpClient.request(httpRequest)
1114
1193
 
1115
1194
  response.fold(
1116
1195
  onSuccess = { httpResponse ->
1117
1196
  if (httpResponse.isSuccessful) {
1118
- // 4. Parse response as Track array
1197
+ // A bare Track array, unlike browse's page object.
1119
1198
  val jsonTracks = json.decodeFromString<List<JsonTrack>>(httpResponse.body)
1120
1199
  jsonTracks.map { it.toNitro() }.toTypedArray()
1121
1200
  } else {
@@ -1138,34 +1217,36 @@ class BrowserManager {
1138
1217
  }
1139
1218
  }
1140
1219
 
1141
- /** Exception thrown when no content is configured for a requested path. */
1142
1220
  class ContentNotFoundException(val path: String) : Exception("Content not found")
1143
1221
 
1144
- /** Exception thrown when an HTTP request fails with a non-2xx status code. */
1145
1222
  class HttpStatusException(val statusCode: Int, message: String) : Exception(message)
1146
1223
 
1147
- /** Exception thrown when a network request fails (connection error, timeout, etc). */
1148
1224
  class NetworkException(message: String, cause: Throwable? = null) : Exception(message, cause)
1149
1225
 
1150
- /** Exception thrown when a browse callback returns an error message. */
1151
1226
  class CallbackException(message: String) : Exception(message)
1152
1227
 
1153
- /**
1154
- * Configuration object that holds all browser settings. Uses flattened structure matching
1155
- * NativeBrowserConfiguration from JS.
1156
- */
1228
+ /** Mirrors NativeBrowserConfiguration from JS. */
1157
1229
  data class BrowserConfig(
1158
1230
  val request: TransformableRequestConfig? = null,
1231
+ // Resolved once per content generation and merged per request. When set, it replaces `request`,
1232
+ // which is then ignored (the JS bridge sets only one of the two).
1233
+ val requestResolver:
1234
+ Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____? =
1235
+ null,
1236
+ val browse: TransformableRequestConfig? = null,
1237
+ val browseResolver:
1238
+ Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____? =
1239
+ null,
1159
1240
  val media: MediaRequestConfig? = null,
1160
1241
  val artwork: ArtworkRequestConfig? = null,
1161
- // Routes as array with flattened entries (includes __tabs__, __search__, and __default__ special
1162
- // routes)
1242
+ // Falls back to `artwork` when null.
1243
+ val nowPlayingArtwork: ArtworkRequestConfig? = null,
1244
+ // Includes the special __tabs__, __search__ and __default__ routes.
1163
1245
  val routes: Array<NativeRouteEntry>? = null,
1164
- // Behavior
1165
1246
  val singleTrack: Boolean = false,
1166
1247
  val androidControllerOfflineError: Boolean = true,
1248
+ val viewMoreTitle: (() -> Promise<String>)? = null,
1167
1249
  ) {
1168
- /** Returns true if search functionality is configured (either callback or config). */
1169
1250
  val hasSearch: Boolean
1170
1251
  get() {
1171
1252
  val searchEntry = routes?.find { it.path == BrowserManager.SEARCH_ROUTE_PATH }