react-native-audio-browser 0.2.0-next.5 → 0.2.0-next.51

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 (1092) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +215 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +546 -283
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  9. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  10. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +165 -0
  11. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  12. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  13. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  15. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  16. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  17. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  18. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  19. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  20. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  21. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  22. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  23. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  24. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  25. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  26. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  27. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +16 -0
  28. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  29. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  30. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  31. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +4 -1
  32. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  33. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  34. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  35. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  36. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  37. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  38. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  39. package/android/src/main/java/com/audiobrowser/player/Player.kt +333 -186
  40. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  41. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  42. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +33 -16
  43. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  44. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  45. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +10 -13
  46. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +64 -0
  47. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +98 -0
  48. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  49. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +110 -0
  50. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +696 -0
  51. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +113 -0
  52. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  53. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  54. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +92 -0
  55. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +105 -0
  56. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  57. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  58. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +550 -0
  59. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +99 -0
  60. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +201 -0
  61. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  62. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +66 -0
  63. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  64. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +63 -0
  65. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +63 -0
  66. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +68 -0
  67. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  68. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  69. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  70. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  71. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  72. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  73. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  74. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  75. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  76. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  77. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  78. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  79. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +23 -1
  80. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  81. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  82. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  83. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  84. package/android/src/main/res/values/strings.xml +25 -5
  85. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +18 -0
  86. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  87. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  88. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  89. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  90. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  91. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  92. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  93. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  94. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  95. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  96. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  97. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  98. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  99. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  100. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  101. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  102. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  103. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  104. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  105. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  106. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  107. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  108. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -0
  109. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  110. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  111. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  112. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  113. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  114. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  115. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  116. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +136 -0
  117. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  118. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  119. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +213 -0
  120. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  121. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  122. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  123. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  124. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +275 -0
  125. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  126. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  127. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  128. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +815 -0
  129. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +203 -0
  130. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +73 -0
  132. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +135 -0
  133. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +170 -0
  134. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +174 -0
  135. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +691 -0
  136. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  137. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +165 -0
  138. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  139. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +204 -0
  140. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +99 -0
  141. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  142. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  143. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  144. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  145. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  146. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  147. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  148. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  149. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  150. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  151. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  152. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  153. package/android/src/test/resources/sonos/device_description.xml +78 -0
  154. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  155. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +79 -0
  156. package/ios/AVPlayerEngine.swift +362 -0
  157. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  158. package/ios/Browser/BrowseGate.swift +58 -0
  159. package/ios/Browser/BrowserConfig.swift +115 -81
  160. package/ios/Browser/BrowserError.swift +16 -0
  161. package/ios/Browser/BrowserManager.swift +155 -654
  162. package/ios/Browser/BrowserPathHelper.swift +68 -51
  163. package/ios/Browser/FavoriteSet.swift +46 -0
  164. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  165. package/ios/Browser/JsonModels.swift +270 -321
  166. package/ios/Browser/NavigationErrorState.swift +41 -0
  167. package/ios/Browser/PageResolver.swift +147 -0
  168. package/ios/Browser/RequestLayer.swift +185 -0
  169. package/ios/Browser/RequestPipeline.swift +303 -0
  170. package/ios/Browser/SearchDrillIn.swift +7 -7
  171. package/ios/Browser/SectionScope.swift +82 -23
  172. package/ios/Browser/SimpleRouter.swift +73 -144
  173. package/ios/Browser/StyleResolver.swift +58 -0
  174. package/ios/Browser/TabBarEntries.swift +9 -3
  175. package/ios/Browser/TrackIdTemplate.swift +37 -0
  176. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  177. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  178. package/ios/CarPlay/CarPlayController.swift +37 -1297
  179. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  180. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  181. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  182. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  183. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  184. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  185. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  186. package/ios/CarPlay/CarPlaySession.swift +207 -0
  187. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  188. package/ios/CarPlay/IntentHandlers.swift +96 -0
  189. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  190. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  191. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  192. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  193. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  194. package/ios/CarPlay/SectionPresentation.swift +77 -0
  195. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  196. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  197. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  198. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  199. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  200. package/ios/Extension/SearchParams+Query.swift +28 -0
  201. package/ios/Extension/Section+Copying.swift +29 -0
  202. package/ios/Extension/String+IcyCharset.swift +21 -0
  203. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  204. package/ios/Extension/Track+AVPlayer.swift +0 -16
  205. package/ios/Extension/Track+Copying.swift +11 -13
  206. package/ios/Extension/Track+Identity.swift +25 -0
  207. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  208. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  209. package/ios/Extension/URLError+Connectivity.swift +15 -0
  210. package/ios/Http/HttpClient.swift +71 -165
  211. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  212. package/ios/HybridAudioBrowser+Options.swift +105 -0
  213. package/ios/HybridAudioBrowser+Player.swift +341 -0
  214. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  215. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  216. package/ios/HybridAudioBrowser.swift +131 -1652
  217. package/ios/Model/NitroTypeStubs.swift +239 -24
  218. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  219. package/ios/Model/RemoteCommand.swift +6 -60
  220. package/ios/Model/TrackPlayerError.swift +6 -2
  221. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  222. package/ios/Observer/ItemObserver.swift +90 -0
  223. package/ios/Observer/PlayerObserver.swift +59 -0
  224. package/ios/Option/SessionCategories.swift +42 -92
  225. package/ios/Player/AudioSessionController.swift +191 -0
  226. package/ios/Player/DeferredSeek.swift +70 -0
  227. package/ios/Player/ErrorStatus.swift +50 -0
  228. package/ios/Player/MediaLoader.swift +66 -87
  229. package/ios/Player/NowPlayingLines.swift +52 -0
  230. package/ios/Player/NowPlayingUpdater.swift +182 -85
  231. package/ios/Player/PlaybackFailure.swift +125 -0
  232. package/ios/Player/PlaybackPersistence.swift +73 -0
  233. package/ios/Player/PlaybackTimer.swift +8 -2
  234. package/ios/Player/Player.swift +975 -0
  235. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  236. package/ios/Player/PlayerEngine.swift +104 -0
  237. package/ios/Player/PlayerStatusTypes.swift +2 -6
  238. package/ios/Player/QueueManager.swift +93 -67
  239. package/ios/Player/RetryLoop.swift +291 -0
  240. package/ios/Player/ShuffleOrder.swift +33 -0
  241. package/ios/Player/SleepTimerManager.swift +14 -16
  242. package/ios/Player/VolumeFader.swift +5 -0
  243. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  244. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  245. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  246. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  247. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  248. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  249. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  250. package/ios/Tests/DeferredSeekTests.swift +70 -0
  251. package/ios/Tests/EmitterTests.swift +22 -38
  252. package/ios/Tests/ErrorStatusTests.swift +50 -0
  253. package/ios/Tests/FavoriteSetTests.swift +60 -0
  254. package/ios/Tests/GenerationMemoTests.swift +121 -0
  255. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  256. package/ios/Tests/JsonModelsTests.swift +194 -1
  257. package/ios/Tests/LRUCacheTests.swift +110 -0
  258. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  259. package/ios/Tests/MediaLoaderTests.swift +36 -67
  260. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  261. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  262. package/ios/Tests/ObserverTests.swift +88 -0
  263. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  264. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  265. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  266. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  267. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  268. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  269. package/ios/Tests/PlayingStateTests.swift +42 -0
  270. package/ios/Tests/QueueManagerTests.swift +196 -115
  271. package/ios/Tests/ReadyValueTests.swift +73 -0
  272. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  273. package/ios/Tests/RequestLayerTests.swift +228 -0
  274. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  275. package/ios/Tests/RetryLoopTests.swift +305 -0
  276. package/ios/Tests/SearchDrillInTests.swift +16 -16
  277. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  278. package/ios/Tests/SectionPresentationTests.swift +98 -0
  279. package/ios/Tests/SectionScopeTests.swift +139 -54
  280. package/ios/Tests/SimpleRouterTests.swift +38 -3
  281. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  282. package/ios/Tests/StyleResolverTests.swift +132 -0
  283. package/ios/Tests/Support/TestTypes.swift +146 -101
  284. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  285. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  286. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  287. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  288. package/ios/Tests/TrackIdentityTests.swift +20 -0
  289. package/ios/Tests/TrackSelectorTests.swift +168 -33
  290. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  291. package/ios/TrackSelector.swift +62 -65
  292. package/ios/Util/ArtworkFreshness.swift +42 -0
  293. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  294. package/ios/Util/ConcurrentMap.swift +19 -0
  295. package/ios/Util/Emitter.swift +40 -12
  296. package/ios/Util/GenerationMemo.swift +36 -0
  297. package/ios/Util/LRUCache.swift +23 -159
  298. package/ios/Util/NetworkMonitor.swift +32 -32
  299. package/ios/Util/OutputPicker.swift +48 -0
  300. package/ios/Util/ReadyValue.swift +56 -0
  301. package/ios/Util/SFSymbolRenderer.swift +59 -31
  302. package/ios/Util/SVGProcessor.swift +9 -12
  303. package/lib/commonjs/AudioBrowser.js +8 -8
  304. package/lib/commonjs/AudioBrowser.js.map +1 -1
  305. package/lib/commonjs/CLAUDE.md +52 -0
  306. package/lib/commonjs/features/browser-config.js +12 -8
  307. package/lib/commonjs/features/browser-config.js.map +1 -1
  308. package/lib/commonjs/features/browser.js +11 -3
  309. package/lib/commonjs/features/browser.js.map +1 -1
  310. package/lib/commonjs/features/carConnection.js +1 -1
  311. package/lib/commonjs/features/equalizer.js +1 -1
  312. package/lib/commonjs/features/errors.js +3 -3
  313. package/lib/commonjs/features/favorites.js +14 -11
  314. package/lib/commonjs/features/favorites.js.map +1 -1
  315. package/lib/commonjs/features/gate.js +16 -1
  316. package/lib/commonjs/features/gate.js.map +1 -1
  317. package/lib/commonjs/features/metadata.js +20 -3
  318. package/lib/commonjs/features/metadata.js.map +1 -1
  319. package/lib/commonjs/features/network.js +1 -1
  320. package/lib/commonjs/features/nowPlaying.js +1 -1
  321. package/lib/commonjs/features/output.js +4 -3
  322. package/lib/commonjs/features/output.js.map +1 -1
  323. package/lib/commonjs/features/playback/controls.js +4 -2
  324. package/lib/commonjs/features/playback/controls.js.map +1 -1
  325. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  326. package/lib/commonjs/features/playback/playing.js +1 -1
  327. package/lib/commonjs/features/playback/progress.js +3 -2
  328. package/lib/commonjs/features/playback/progress.js.map +1 -1
  329. package/lib/commonjs/features/playback/rate.js +8 -1
  330. package/lib/commonjs/features/playback/rate.js.map +1 -1
  331. package/lib/commonjs/features/playback/state.js +3 -4
  332. package/lib/commonjs/features/playback/state.js.map +1 -1
  333. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  334. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  335. package/lib/commonjs/features/playback/volume.js +1 -1
  336. package/lib/commonjs/features/player/options.js +3 -19
  337. package/lib/commonjs/features/player/options.js.map +1 -1
  338. package/lib/commonjs/features/player/setup.js +7 -3
  339. package/lib/commonjs/features/player/setup.js.map +1 -1
  340. package/lib/commonjs/features/player/validateOptions.js +23 -0
  341. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  342. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  343. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  344. package/lib/commonjs/features/queue/queue.js +13 -6
  345. package/lib/commonjs/features/queue/queue.js.map +1 -1
  346. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  347. package/lib/commonjs/features/queue/shuffle.js +1 -1
  348. package/lib/commonjs/features/remoteControls.js +13 -92
  349. package/lib/commonjs/features/remoteControls.js.map +1 -1
  350. package/lib/commonjs/features/sleepTimer.js +13 -1
  351. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  352. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  353. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  354. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  355. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  356. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  357. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  358. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  359. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  360. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  361. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  362. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  363. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  364. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  365. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  366. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  367. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  368. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  369. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  370. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  371. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  372. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  373. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  374. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  375. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  376. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  377. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  378. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  379. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  380. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  381. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  382. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  383. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  384. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  385. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  386. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  387. package/lib/commonjs/web/browser/sections.js +89 -0
  388. package/lib/commonjs/web/browser/sections.js.map +1 -0
  389. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  390. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  391. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  392. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  393. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  394. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  395. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  396. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  397. package/lib/module/AudioBrowser.js +2 -1
  398. package/lib/module/AudioBrowser.js.map +1 -1
  399. package/lib/module/CLAUDE.md +52 -0
  400. package/lib/module/features/browser-config.js +12 -8
  401. package/lib/module/features/browser-config.js.map +1 -1
  402. package/lib/module/features/browser.js +11 -3
  403. package/lib/module/features/browser.js.map +1 -1
  404. package/lib/module/features/carConnection.js +1 -1
  405. package/lib/module/features/equalizer.js +1 -1
  406. package/lib/module/features/errors.js +3 -3
  407. package/lib/module/features/favorites.js +14 -11
  408. package/lib/module/features/favorites.js.map +1 -1
  409. package/lib/module/features/gate.js +16 -1
  410. package/lib/module/features/gate.js.map +1 -1
  411. package/lib/module/features/metadata.js +20 -3
  412. package/lib/module/features/metadata.js.map +1 -1
  413. package/lib/module/features/network.js +1 -1
  414. package/lib/module/features/nowPlaying.js +1 -1
  415. package/lib/module/features/output.js +4 -3
  416. package/lib/module/features/output.js.map +1 -1
  417. package/lib/module/features/playback/controls.js +4 -2
  418. package/lib/module/features/playback/controls.js.map +1 -1
  419. package/lib/module/features/playback/playWhenReady.js +1 -1
  420. package/lib/module/features/playback/playing.js +1 -1
  421. package/lib/module/features/playback/progress.js +3 -2
  422. package/lib/module/features/playback/progress.js.map +1 -1
  423. package/lib/module/features/playback/rate.js +8 -1
  424. package/lib/module/features/playback/rate.js.map +1 -1
  425. package/lib/module/features/playback/state.js +3 -4
  426. package/lib/module/features/playback/state.js.map +1 -1
  427. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  428. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  429. package/lib/module/features/playback/volume.js +1 -1
  430. package/lib/module/features/player/options.js +2 -17
  431. package/lib/module/features/player/options.js.map +1 -1
  432. package/lib/module/features/player/setup.js +6 -2
  433. package/lib/module/features/player/setup.js.map +1 -1
  434. package/lib/module/features/player/validateOptions.js +19 -0
  435. package/lib/module/features/player/validateOptions.js.map +1 -0
  436. package/lib/module/features/queue/activeTrack.js +15 -4
  437. package/lib/module/features/queue/activeTrack.js.map +1 -1
  438. package/lib/module/features/queue/queue.js +13 -6
  439. package/lib/module/features/queue/queue.js.map +1 -1
  440. package/lib/module/features/queue/repeatMode.js +1 -1
  441. package/lib/module/features/queue/shuffle.js +1 -1
  442. package/lib/module/features/remoteControls.js +13 -92
  443. package/lib/module/features/remoteControls.js.map +1 -1
  444. package/lib/module/features/sleepTimer.js +13 -1
  445. package/lib/module/features/sleepTimer.js.map +1 -1
  446. package/lib/module/test-utils/reactNativeStub.js +58 -0
  447. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  448. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  449. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  450. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  451. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  452. package/lib/module/utils/getTrackIdentity.js +20 -0
  453. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  454. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  455. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  456. package/lib/module/web/NativeAudioBrowser.js +202 -77
  457. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  458. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  459. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  460. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  461. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  462. package/lib/module/web/TrackPlayer/Player.js +254 -39
  463. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  464. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  465. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  466. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  467. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  468. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  469. package/lib/module/web/browser/BrowserManager.js +175 -100
  470. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  471. package/lib/module/web/browser/FavoriteManager.js +31 -21
  472. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  473. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  474. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  475. package/lib/module/web/browser/SearchManager.js +18 -23
  476. package/lib/module/web/browser/SearchManager.js.map +1 -1
  477. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  478. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  479. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  480. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  481. package/lib/module/web/browser/sections.js +83 -0
  482. package/lib/module/web/browser/sections.js.map +1 -0
  483. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  484. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  485. package/lib/module/web/http/followMediaRedirect.js +215 -0
  486. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  487. package/lib/module/web/player/NowPlayingManager.js +4 -3
  488. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  489. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  490. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  491. package/lib/typescript/package.json +1 -0
  492. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  493. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  494. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  495. package/lib/typescript/src/features/browser.d.ts +10 -2
  496. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  497. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  498. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  499. package/lib/typescript/src/features/errors.d.ts +3 -3
  500. package/lib/typescript/src/features/favorites.d.ts +14 -11
  501. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  502. package/lib/typescript/src/features/gate.d.ts +18 -2
  503. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  504. package/lib/typescript/src/features/metadata.d.ts +20 -3
  505. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  506. package/lib/typescript/src/features/network.d.ts +1 -1
  507. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  508. package/lib/typescript/src/features/output.d.ts +4 -3
  509. package/lib/typescript/src/features/output.d.ts.map +1 -1
  510. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  511. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  512. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  513. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  514. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  515. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  516. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  517. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  518. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  519. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  520. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  521. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  522. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  523. package/lib/typescript/src/features/player/options.d.ts +24 -21
  524. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  525. package/lib/typescript/src/features/player/setup.d.ts +46 -1
  526. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  527. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  528. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  529. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  530. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  531. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  532. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  533. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  534. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  535. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  536. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  537. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  538. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  539. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  540. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  541. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  542. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  543. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  544. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  545. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  546. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  547. package/lib/typescript/src/types/browser.d.ts +93 -61
  548. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  549. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  550. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  551. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  552. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  553. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  554. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  555. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  556. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  557. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  558. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  559. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  560. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  561. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  567. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  568. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  574. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  577. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  579. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  581. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  582. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  583. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  584. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  587. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  588. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  589. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  590. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  591. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  593. 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
  594. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  595. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  597. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  598. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  599. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  600. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  605. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  609. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  610. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  612. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  630. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  633. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  634. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  639. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  641. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  645. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  647. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  649. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  650. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  651. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  653. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  655. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  656. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  657. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  658. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  659. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  660. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  661. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  663. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  664. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  665. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  666. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  667. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  668. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  669. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  670. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  671. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  672. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  673. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  674. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  682. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  686. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  689. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  697. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  701. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  702. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  703. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  704. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  707. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  709. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  713. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  715. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  716. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  717. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  718. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  719. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  739. 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 +0 -2
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  746. 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
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  749. 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
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  805. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  806. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  807. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  808. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  809. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  810. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  811. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  812. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  813. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  814. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  815. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  816. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  817. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  818. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  819. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  820. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  821. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  822. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  823. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  824. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  825. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  826. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  827. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  828. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  829. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  830. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  831. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  832. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  858. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  859. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  860. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  861. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  862. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  863. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  864. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  865. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  866. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  867. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  868. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  869. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  870. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  871. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  872. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  873. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  874. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  875. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  876. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  877. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  878. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  879. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  880. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  881. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  882. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  883. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  884. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  885. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  886. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  887. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  888. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  889. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  890. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  891. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  892. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  893. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  894. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  895. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  896. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  897. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  898. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  899. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  900. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  901. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  902. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  903. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  904. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  905. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  906. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  907. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  908. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  909. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  910. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  911. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  912. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  913. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  914. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  915. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  916. package/package.json +24 -11
  917. package/src/AudioBrowser.ts +2 -1
  918. package/src/CLAUDE.md +52 -0
  919. package/src/features/battery.test.ts +79 -0
  920. package/src/features/browser-config.test.ts +21 -6
  921. package/src/features/browser-config.ts +12 -8
  922. package/src/features/browser.test.ts +1 -1
  923. package/src/features/browser.ts +11 -3
  924. package/src/features/carConnection.ts +1 -1
  925. package/src/features/equalizer.ts +1 -1
  926. package/src/features/errors.ts +3 -3
  927. package/src/features/favorites.ts +14 -11
  928. package/src/features/gate.ts +16 -1
  929. package/src/features/hook-wiring.test.ts +302 -0
  930. package/src/features/metadata.ts +20 -3
  931. package/src/features/network.ts +1 -1
  932. package/src/features/nowPlaying.ts +1 -1
  933. package/src/features/output.ts +4 -3
  934. package/src/features/playback/controls.ts +4 -2
  935. package/src/features/playback/playWhenReady.ts +1 -1
  936. package/src/features/playback/playing.ts +1 -1
  937. package/src/features/playback/progress.test.ts +169 -0
  938. package/src/features/playback/progress.ts +3 -2
  939. package/src/features/playback/rate.ts +8 -1
  940. package/src/features/playback/state.ts +3 -4
  941. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  942. package/src/features/playback/trackPlaybackTime.ts +1 -6
  943. package/src/features/playback/volume.ts +1 -1
  944. package/src/features/player/options.ts +31 -40
  945. package/src/features/player/setup.test.ts +12 -3
  946. package/src/features/player/setup.ts +58 -5
  947. package/src/features/player/validateOptions.ts +21 -0
  948. package/src/features/queue/activeTrack.ts +15 -4
  949. package/src/features/queue/queue.ts +13 -6
  950. package/src/features/queue/repeatMode.ts +1 -1
  951. package/src/features/queue/shuffle.ts +1 -1
  952. package/src/features/remoteControls.ts +13 -92
  953. package/src/features/sleepTimer.test.ts +172 -0
  954. package/src/features/sleepTimer.ts +9 -1
  955. package/src/nitro-stub-drift.test.ts +277 -0
  956. package/src/public-surface.test.ts +147 -0
  957. package/src/specs/audio-browser.nitro.ts +10 -8
  958. package/src/style-resolution.test.ts +210 -0
  959. package/src/test-utils/reactNativeStub.ts +60 -0
  960. package/src/types/browser-native.ts +7 -3
  961. package/src/types/browser-nodes.ts +403 -134
  962. package/src/types/browser.ts +97 -63
  963. package/src/utils/LazyNativeEmitter.ts +28 -15
  964. package/src/utils/NativeUpdatedValue.ts +29 -13
  965. package/src/utils/getTrackIdentity.ts +20 -0
  966. package/src/utils/useDebug.test.ts +182 -0
  967. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  968. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  969. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  970. package/src/web/NativeAudioBrowser.ts +241 -84
  971. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  972. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  973. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  974. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  975. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  976. package/src/web/TrackPlayer/Player.ts +284 -37
  977. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  978. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  979. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  980. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  981. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  982. package/src/web/__tests__/lifecycle.test.ts +345 -0
  983. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  984. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  985. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  986. package/src/web/__tests__/retry.test.ts +169 -0
  987. package/src/web/browser/BrowserManager.ts +209 -111
  988. package/src/web/browser/FavoriteManager.test.ts +84 -0
  989. package/src/web/browser/FavoriteManager.ts +28 -23
  990. package/src/web/browser/NavigationErrorManager.ts +3 -1
  991. package/src/web/browser/SearchManager.test.ts +75 -0
  992. package/src/web/browser/SearchManager.ts +25 -28
  993. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  994. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  995. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  996. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  997. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  998. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  999. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1000. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1001. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1002. package/src/web/browser/sections.test.ts +91 -0
  1003. package/src/web/browser/sections.ts +72 -0
  1004. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1005. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1006. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1007. package/src/web/http/followMediaRedirect.ts +253 -0
  1008. package/src/web/player/NowPlayingManager.ts +4 -3
  1009. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1010. package/src/web/util/BrowserPathHelper.ts +70 -13
  1011. package/website/guide/android-auto.md +114 -0
  1012. package/website/guide/android-certificates.md +409 -0
  1013. package/website/guide/artwork.md +255 -0
  1014. package/website/guide/audio-output.md +339 -0
  1015. package/website/guide/automotive.md +86 -0
  1016. package/website/guide/basic-usage.md +151 -0
  1017. package/website/guide/battery.md +115 -0
  1018. package/website/guide/browser.md +587 -0
  1019. package/website/guide/carplay.md +650 -0
  1020. package/website/guide/configuration.md +179 -0
  1021. package/website/guide/equalizer.md +231 -0
  1022. package/website/guide/errors.md +310 -0
  1023. package/website/guide/favorites.md +154 -0
  1024. package/website/guide/gate.md +143 -0
  1025. package/website/guide/getting-started.md +46 -0
  1026. package/website/guide/hooks.md +238 -0
  1027. package/website/guide/live-streams.md +125 -0
  1028. package/website/guide/metadata.md +239 -0
  1029. package/website/guide/migrating-from-track-player.md +244 -0
  1030. package/website/guide/native-callback-fetch.md +127 -0
  1031. package/website/guide/network.md +86 -0
  1032. package/website/guide/now-playing.md +175 -0
  1033. package/website/guide/playback.md +328 -0
  1034. package/website/guide/queue.md +300 -0
  1035. package/website/guide/remote-controls.md +256 -0
  1036. package/website/guide/search.md +255 -0
  1037. package/website/guide/sleep-timer.md +268 -0
  1038. package/website/guide/track.md +247 -0
  1039. package/ios/Bridge.h +0 -8
  1040. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1041. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1042. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1043. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1044. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1045. package/ios/Model/MediaURL.swift +0 -67
  1046. package/ios/Model/SourceType.swift +0 -6
  1047. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1048. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1049. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1050. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1051. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1052. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1053. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1054. package/ios/Option/PitchAlgorithms.swift +0 -17
  1055. package/ios/Option/TimeEventFrequency.swift +0 -18
  1056. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1057. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1058. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1059. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1060. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1061. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1062. package/ios/Player/PlaybackStateStore.swift +0 -27
  1063. package/ios/Player/PlayingStateManager.swift +0 -33
  1064. package/ios/Player/RetryManager.swift +0 -322
  1065. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1066. package/ios/Player/SleepTimerHandling.swift +0 -15
  1067. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1068. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1069. package/ios/Tests/MediaResolveTests.swift +0 -126
  1070. package/ios/Tests/OnceValueTests.swift +0 -79
  1071. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1072. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1073. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1074. package/ios/Tests/RetryManagerTests.swift +0 -89
  1075. package/ios/TrackPlayer.swift +0 -1014
  1076. package/ios/TrackPlayerCallbacks.swift +0 -86
  1077. package/ios/Util/MetadataAdapter.swift +0 -131
  1078. package/ios/Util/OnceValue.swift +0 -104
  1079. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1080. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1081. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1082. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1083. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1087. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1088. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1089. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1090. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1091. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1092. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,255 @@
1
+ ---
2
+ description: 'Set Track.artwork once and render it everywhere: the fetch and transform pipeline, per-surface sizing, SF Symbols, tinting, light/dark pairs, Android vector icons, and SVG.'
3
+ ---
4
+
5
+ # Artwork
6
+
7
+ **Artwork** is the image shown for a track — the thumbnail in a browse list, the cover on the lock screen, the icon on a CarPlay row. You set one field, `artwork`, on a [`Track`](/guide/track); the library resolves and transforms it per surface and per requested size, and hands the ready-to-render result back on `artworkSource`.
8
+
9
+ This guide covers the mental model (the two configs and the output field), **which artwork renders where**, the **transform pipeline** that turns your URL into a sized request, and the platform-specific bits: SF Symbols on iOS, tinting, light/dark artwork, Android vector icons, and SVG.
10
+
11
+ ## Mental model
12
+
13
+ Three names do all the work:
14
+
15
+ | Name | What it is | You |
16
+ | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
17
+ | `Track.artwork` | The image **you set** — an `https` URL, an `sf:` symbol (iOS), a platform URI, or a `{ light, dark }` pair. | set it |
18
+ | `artwork` / `nowPlayingArtwork` config | How the library **fetches** that image (base URL, headers, signing, sizing). | configure once (override per route / for now-playing) |
19
+ | `Track.artworkSource` | The resolved, ready-to-render [`ImageSource`](/api/types/browser-nodes/#imagesource) (URL + headers) the library **produces**. | read it |
20
+
21
+ `artwork` is the only field you set per track. `artworkSource` is **output-only** — the library populates it; never set it yourself.
22
+
23
+ ```tsx
24
+ import { useActiveTrack } from 'react-native-audio-browser'
25
+ import { Image } from 'react-native'
26
+
27
+ function Cover() {
28
+ const track = useActiveTrack()
29
+ // artworkSource is the transformed result, shaped for <Image>
30
+ return <Image source={track?.artworkSource} />
31
+ }
32
+ ```
33
+
34
+ ## Which artwork renders where
35
+
36
+ The library publishes art to several surfaces; each gets its image from a field/config and (where the surface knows its display size) a size hint:
37
+
38
+ | Surface | Image from | Size hint | Tinting |
39
+ | ----------------------------------------------- | --------------------------------------------- | --------- | ------------------------------------------------------------------------------ |
40
+ | **Browse rows / tabs** (CarPlay / Android Auto) | `artwork` (per-route override allowed) | no | CarPlay: `style: { artworkRendering: 'stencil' }`, or a `{ light, dark }` pair |
41
+ | **In-app `<Image>`** | `artworkSource` (output) | no | your UI |
42
+ | **iOS lock screen / Control Center** | `nowPlayingArtwork` → falls back to `artwork` | yes | — |
43
+ | **CarPlay Now Playing** | `nowPlayingArtwork` → `artwork` | yes | — |
44
+ | **Android notification / Android Auto** | `nowPlayingArtwork` → `artwork` | yes | — (Android Auto is dark-only) |
45
+ | **CarPlay tile sections** (`display: 'grid'`) | `artwork` (each tile is a Track) | yes | CarPlay: `style: { artworkRendering: 'stencil' }`, or a `{ light, dark }` pair |
46
+
47
+ **Size hint** = the surface tells the library the pixels it needs, delivered as an [`ImageContext`](/api/types/browser/#imagecontext) to your `transform` / `imageQueryParams`. Browse-time resolution has none.
48
+
49
+ Two things to take from the table:
50
+
51
+ - **One image by default.** With only `artwork` set, the same source feeds browse rows _and_ every now-playing surface. Set `nowPlayingArtwork` only when the now-playing image should differ (a larger, lock-screen-quality cover without bloating list thumbnails).
52
+ - **Size hints exist only where the surface knows its size.** Browse-time resolution has no size, so `imageQueryParams` and `context` (below) do nothing there; they kick in at load time on CarPlay / Android Auto / now-playing.
53
+ - **Tinting is for browse icons only.** `artworkRendering: 'stencil'` is applied when CarPlay renders browse content — list rows, tabs, and tiles — not to now-playing cover art.
54
+
55
+ ## The transform pipeline
56
+
57
+ `artwork` is an [`ArtworkRequestConfig`](/api/types/browser/#artworkrequestconfig). When the library needs a track's image, it builds the request in layers, each overriding the last:
58
+
59
+ 1. **`request`** — shared base config (user agent, common headers).
60
+ 2. **`artwork`** — the static image config (`baseUrl`, `headers`, …).
61
+ 3. **`resolve(track)` / `resolveSync(track)`** — per-track overrides built from the track's metadata.
62
+ 4. **`imageQueryParams`** — appends the surface's requested size (when it reports one).
63
+ 5. **`transform({ request, context })` / `transformSync`** — final tweak, with the requested size in `context`.
64
+
65
+ To build a per-track URL, use `resolve` (the track is the argument). The `{id}` token is **not** a general feature — only `nowPlayingArtwork` templates it (see below); static values in `artwork` are sent verbatim.
66
+
67
+ A typical CDN setup never needs more than `baseUrl` plus `imageQueryParams`:
68
+
69
+ ```ts
70
+ import { configureBrowser } from 'react-native-audio-browser'
71
+
72
+ configureBrowser({
73
+ // ...the rest of your config (tabs, routes, …)
74
+ artwork: {
75
+ baseUrl: 'https://images.example.com',
76
+ // tell the library which query params carry the requested size
77
+ imageQueryParams: { width: 'w', height: 'h' }
78
+ }
79
+ })
80
+ ```
81
+
82
+ With [`imageQueryParams`](/api/types/browser/#imagequeryparams) the requested size from CarPlay / Android Auto is appended automatically — `?w=200&h=200` — so each surface gets right-sized art. Omit `height` to send width only. This only fires on surfaces that report a size; browse rows (no size hint) get the URL without these params.
83
+
84
+ For anything `imageQueryParams` can't express — per-track paths, signed URLs — use `resolve` and `transform` (or their sync variants):
85
+
86
+ ```ts
87
+ import { configureBrowser } from 'react-native-audio-browser'
88
+ import HmacSHA256 from 'crypto-js/hmac-sha256' // add: yarn add crypto-js
89
+
90
+ const CDN_KEY = process.env.CDN_KEY ?? '' // your CDN signing key
91
+
92
+ // sign the path locally with your key — a pure, sync function
93
+ const signUrl = (path: string) => HmacSHA256(path, CDN_KEY).toString()
94
+
95
+ configureBrowser({
96
+ artwork: {
97
+ baseUrl: 'https://images.example.com',
98
+ // build the path from the track (sync — no await needed)
99
+ resolveSync: (track) => ({ path: `/covers/${track.id}.jpg` }),
100
+ // then sign it + size it. both are sync, so no Promise is
101
+ // allocated per image
102
+ transformSync: ({ request, context }) => ({
103
+ ...request,
104
+ query: {
105
+ ...request.query,
106
+ w: context?.width ? String(context.width) : '600',
107
+ // request.path is optional — guard it before signing
108
+ sig: signUrl(request.path ?? '')
109
+ }
110
+ })
111
+ }
112
+ })
113
+ ```
114
+
115
+ A `transform` (or `transformSync`) **replaces** the request — it doesn't merge — so spread `...request` (and `...request.query`) or you'll drop the `baseUrl` and other layers. The [`context`](/api/types/browser/#imagecontext) is an `ImageContext` with `width` / `height` in **pixels**, present only when the surface knows its display size (so guard with `context?.width`). `request.path` is also optional — it's only set if a `resolve` ran first — so guard it before signing (as above).
116
+
117
+ `resolveSync` / `transformSync` are no-Promise variants of `resolve` / `transform`. Reach for them when the per-track config or final tweak needs no `await` — a synced query param, a locally-computed path — to skip a Promise allocation per image (the example above is fully sync for that reason). If you set _both_ the sync and async form of the **same** stage (e.g. `transform` _and_ `transformSync`), the async one runs first and the sync one tweaks its result; `resolve` and `transform` are independent stages that both always run.
118
+
119
+ ::: tip Per-route artwork
120
+ A route can override the global `artwork` with its own config — `routes: { '/premium': { artwork: { baseUrl: '…' } } }` — so different content can load images from different hosts. See the [Browser](/guide/browser) guide.
121
+ :::
122
+
123
+ ## SF Symbols (iOS)
124
+
125
+ Prefix `artwork` with `sf:` to render an Apple [SF Symbol](https://developer.apple.com/sf-symbols/) instead of fetching an image — ideal for tab and category icons. Optional `bg` (background, transparent if omitted) and `fg` (symbol color, black if omitted) query params set the colors:
126
+
127
+ ```ts
128
+ {
129
+ title: 'Favorites',
130
+ path: '/favorites',
131
+ artwork: 'sf:heart.fill?bg=#FF0090&fg=#fff'
132
+ }
133
+ ```
134
+
135
+ On CarPlay, an SF Symbol with **no explicit colors** is handed to CarPlay untinted, so CarPlay renders it in the appearance's own color (adapting to light/dark); give it a `bg`/`fg` and you get exactly those colors instead. The library renders the symbol to an image on device and caches it. This is iOS-only; on Android an `sf:` value is not a valid image.
136
+
137
+ ## Tinting and platform icons
138
+
139
+ For monochrome **icons** (not full-color album art), let the system tint them to stay legible on either appearance:
140
+
141
+ - **iOS CarPlay** — declare [`style: { artworkRendering: 'stencil' }`](/api/types/browser-nodes/#trackstyle) on the track. Inside a page it's an inherited style property (a section- or page-wide value covers every item); tabs render without a section context, so a tab icon needs the declaration on the tab track itself. CarPlay tints the glyph per appearance: black in light mode, white in dark.
142
+ - **Android Auto** is dark-only, so there's no per-appearance tinting — ship an appropriately colored (e.g. white) icon. When a layout is declared (`display` on the section, page, or parent item), an `android.resource://…/drawable/…` artwork URI switches Android Auto to the **category** variant of that layout (which adds icon margins and lets Android Auto render it as an icon). The library only sets the category style; the visual treatment is Android Auto's — see [Browse display](/guide/android-auto#browse-display).
143
+
144
+ ```ts
145
+ {
146
+ title: 'Settings',
147
+ path: '/settings',
148
+ artwork: 'sf:gear',
149
+ style: { artworkRendering: 'stencil' }
150
+ }
151
+ ```
152
+
153
+ **SVG** is supported on both platforms and detected by a `.svg` URL suffix — serve SVGs with a path ending in `.svg` and they decode as vectors rather than raster images.
154
+
155
+ ## Light and dark artwork
156
+
157
+ Tinting recolors _one_ image. When the two appearances need genuinely **different** images — a logo whose colors change, a mark with a light-on-dark counterpart — set `artwork` to an [`ArtworkVariants`](/api/types/browser-nodes/#artworkvariants) pair instead of a URL:
158
+
159
+ ```ts
160
+ {
161
+ title: 'Playlists',
162
+ path: '/playlists',
163
+ artwork: {
164
+ light: 'https://images.example.com/playlists-light.png',
165
+ dark: 'https://images.example.com/playlists-dark.png'
166
+ }
167
+ }
168
+ ```
169
+
170
+ Both fields are required — a pair with one side missing has no sensible fallback at render time.
171
+
172
+ On CarPlay browse rows and tabs the library fetches both and registers them as a single adaptive image, so switching appearance mid-drive swaps the image **in place** — no re-fetch, and no re-query of the browse tree. Each URL runs through the [transform pipeline](#the-transform-pipeline) independently, so `baseUrl`, headers, `imageQueryParams` and `resolve` / `transform` apply to both.
173
+
174
+ Everywhere a single image is required, a pair resolves to its `dark` URL:
175
+
176
+ | Surface | Uses |
177
+ | ---------------------------------------- | ----------------------------- |
178
+ | **CarPlay browse rows / tabs** | both, adapting per appearance |
179
+ | **Android Auto** | `dark` (dark-only platform) |
180
+ | **Now-playing** (all platforms) | `dark` |
181
+ | **`artworkSource`** (your own `<Image>`) | `dark` |
182
+
183
+ ::: tip Pair or tint?
184
+ Prefer [`artworkRendering: 'stencil'`](#tinting-and-platform-icons) when recoloring the same shape gives the right result: it's one fetch instead of two, the variants can't drift apart, and it works from the image's alpha so the source color is irrelevant. Reach for a pair only when the appearances need different artwork.
185
+ :::
186
+
187
+ ::: warning Android Auto fetches only `http(s)` artwork
188
+ Browse artwork is served to Android Auto through an internal content provider that only fetches `http`/`https` URLs. `android.resource://` and `file://` URIs pass through and render directly; other custom schemes won't load there.
189
+ :::
190
+
191
+ ## Now-playing artwork
192
+
193
+ By default the now-playing image (lock screen, Control Center, CarPlay / Android Auto Now Playing) is the active track's `artwork` — the same image as its browse-row thumbnail. To resolve it differently, set `nowPlayingArtwork`, which builds the now-playing image from its **own** request and uniquely supports an `{id}` template filled from the active track's `id`:
194
+
195
+ ```ts
196
+ import { configureBrowser } from 'react-native-audio-browser'
197
+
198
+ configureBrowser({
199
+ nowPlayingArtwork: {
200
+ baseUrl: 'https://images.example.com',
201
+ // {id} is replaced with the active track's id
202
+ path: '/artwork/{id}',
203
+ // ask the CDN for a lock-screen-quality variant
204
+ imageQueryParams: { width: 'w', height: 'h' }
205
+ }
206
+ })
207
+ ```
208
+
209
+ Now-playing surfaces request a **much larger** image than list thumbnails — on iOS, up to the screen width in pixels, capped at 1200px — so with `imageQueryParams` set you fetch a fittingly large variant rather than upscaling a tiny thumbnail.
210
+
211
+ Two separate ideas here: the **`{id}` template** is replaced with the active track's `id`; and if you _don't_ set `nowPlayingArtwork` at all, now-playing surfaces fall back to the `artwork` config (and to `track.artwork`).
212
+
213
+ `nowPlayingArtwork` is an `ArtworkRequestConfig` like `artwork`, so it takes the same `resolve` / `transform` / `imageQueryParams`. It is **native-only**: the `{id}` template and the `nowPlayingArtwork` config are not applied by the web implementation, where now-playing artwork simply uses the `artwork` config like any other surface. Artwork is also the one now-playing field the text layers can't touch — the formatter / override / flash carry only `title` / `artist` / `album`. See [Now Playing](/guide/now-playing#now-playing-artwork) for the metadata side.
214
+
215
+ ::: warning Now-playing artwork follows the active track
216
+ Now-playing artwork is resolved **once per active track**, keyed on its `id` — so it won't re-resolve while the same track keeps playing. There is no imperative way to swap _only_ the image mid-stream: `updateNowPlaying()` overrides `title` / `artist` / `album`, not artwork. Changing it means making a _new_ active track (a different `id` plus the new `artwork`) the current one, which reloads playback — so it's not a fit for, say, updating live-radio cover art on each song. An in-place update API is tracked in [issue #76](https://github.com/radio-garden/react-native-audio-browser/issues/76).
217
+ :::
218
+
219
+ ## Tile sections
220
+
221
+ A page's [`Section`](/api/types/browser-nodes/#section) can render its tracks as tappable artwork tiles by declaring `style: { display: 'grid' }` (wrapping; add `gridWrap: false` for a single line of tiles):
222
+
223
+ ```ts
224
+ {
225
+ path: '/home',
226
+ title: 'Home',
227
+ sections: [
228
+ {
229
+ title: 'Featured',
230
+ style: { display: 'grid', gridWrap: false },
231
+ path: '/browse/featured', // header / "view all" target
232
+ children: [
233
+ { title: 'Jazz', path: '/browse/jazz', artwork: 'https://…/jazz.jpg' },
234
+ { title: 'Rock', path: '/browse/rock', artwork: 'https://…/rock.jpg' }
235
+ ]
236
+ }
237
+ ]
238
+ }
239
+ ```
240
+
241
+ Each tile is an ordinary Track, so its `artwork` runs through the same pipeline as any other. Tile styles presume artwork: a track without any renders as a placeholder tile plus its title — the artwork `resolve` hook is the place to supply fallback art. On CarPlay a single-line grid (`gridWrap: false`) shows the tiles that fit on one line (seven on a wide screen, or two condensed cells; the rest are truncated) and a wrapping grid takes as many lines as it needs on iOS 26+ (rendering as a list before that); Android Auto's grid always wraps, so it renders both identically. See [Browser → Presentation](/guide/browser#presentation) for the full per-surface rundown.
242
+
243
+ ## API summary
244
+
245
+ | Symbol | Purpose |
246
+ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
247
+ | [`Track.artwork`](/api/types/browser-nodes/#track) | The image you set — `https` URL, `sf:` symbol (iOS), or platform URI. |
248
+ | [`Track.artworkSource`](/api/types/browser-nodes/#track) | Output-only resolved `ImageSource` for your own `<Image>`. |
249
+ | [`TrackStyle.artworkRendering`](/api/types/browser-nodes/#trackstyle) | `'stencil'` tints a monochrome icon per CarPlay light/dark (iOS only). |
250
+ | [`ArtworkVariants`](/api/types/browser-nodes/#artworkvariants) | A `{ light, dark }` pair set on `artwork` when the appearances need different images. |
251
+ | [`artwork`](/api/types/browser/#artworkrequestconfig) | Config for browse-row image requests (and the default everywhere). |
252
+ | `nowPlayingArtwork` | Separate config for now-playing art; supports `{id}`; native-only. |
253
+ | [`imageQueryParams`](/api/types/browser/#imagequeryparams) | Map the surface's requested size to your CDN's query params. |
254
+ | [`ImageContext`](/api/types/browser/#imagecontext) | Requested `width`/`height` in pixels, passed to `transform`. |
255
+ | [`Section.style`](/api/types/browser-nodes/#sectionstyle) | `display: 'grid'` (± `gridWrap: false`) renders a section's tracks as artwork tiles. |
@@ -0,0 +1,339 @@
1
+ ---
2
+ description: 'Read where audio is currently playing (speaker, Bluetooth, AirPlay, the car), react when the route changes, and open the system output switcher.'
3
+ ---
4
+
5
+ # Audio Output
6
+
7
+ Read where audio is currently playing (speaker, Bluetooth, AirPlay, the car…),
8
+ react when it changes, and open the system output switcher so the listener can
9
+ move playback to another device. Both layers are **cross-platform**:
10
+
11
+ - **Reading the current output** — `getOutput()` / `useOutput()` /
12
+ `onOutputChanged`. iOS reports the active route while a session is active;
13
+ Android reports the active output route from `AudioManager` (the `type` is
14
+ coarse — e.g. wired headphones may report as `speaker`).
15
+ - **Opening the switcher** — `openOutputPicker()` / `supportsOutputSwitcher()`:
16
+ the system route picker on iOS, the system Output Switcher on Android 11+.
17
+
18
+ ::: tip Gate the switcher button on `supportsOutputSwitcher()`
19
+ Surface your output button only when `supportsOutputSwitcher()` is `true` — it's
20
+ `true` on iOS and Android 11+ (API 30), `false` on older Android and web.
21
+ Reading the current output works more broadly, but `getOutput()` can still be
22
+ `undefined` (before playback, or when unknown) — so guard for it.
23
+ :::
24
+
25
+ The UI snippets import `Text` / `Button` from `react-native`; everything else is
26
+ from `react-native-audio-browser`.
27
+
28
+ ## The current output
29
+
30
+ [`useOutput()`](/api/features/output/#useoutput) returns the active output and
31
+ re-renders whenever it changes (AirPods connect, headphones unplug, a Bluetooth
32
+ speaker is selected):
33
+
34
+ ```tsx
35
+ import { Text } from 'react-native'
36
+ import { useOutput } from 'react-native-audio-browser'
37
+
38
+ function OutputLabel() {
39
+ const output = useOutput()
40
+ if (!output) return null // not yet known
41
+ return <Text>Playing on {output.name}</Text>
42
+ }
43
+ ```
44
+
45
+ An [`Output`](/api/features/output/#output) is:
46
+
47
+ | Field | Type | Meaning |
48
+ | ---------- | ------------ | ------------------------------------------------------------------------------- |
49
+ | `name` | `string` | Human-readable device name, e.g. `"AirPods Pro"`, `"Kitchen speaker"`. |
50
+ | `type` | `OutputType` | The output kind (see below). |
51
+ | `external` | `boolean` | `false` only for the built-in speaker/receiver; `true` for everything external. |
52
+
53
+ `type` is one of `'speaker'`, `'receiver'` (the iOS earpiece), `'headphones'`,
54
+ `'bluetooth'`, `'airplay'`, `'car'`, `'hdmi'`, `'usb'`, `'cast'` and `'sonos'`
55
+ (see below), `'remote'` (a remote speaker or TV, see below), or `'other'`. Both platforms map their native ports/routes into
56
+ this shared set — e.g. iOS's separate Bluetooth ports all collapse to
57
+ `'bluetooth'`.
58
+
59
+ ::: warning Android reports a coarser type
60
+ On Android the type comes from the system route and is coarser: wired headphones
61
+ often report as `'speaker'` (the built-in route), and really only `'bluetooth'`
62
+ is reliably distinguished from it. The device **name** still comes through.
63
+ :::
64
+
65
+ ### Remote outputs (Android)
66
+
67
+ With `remoteOutputs: {}` in [`setupPlayer`](/guide/configuration), the system
68
+ Output Switcher (Android 11+) also lists the speakers and TVs of media route
69
+ providers, and the one the listener selects becomes the output, with
70
+ `type: 'remote'`. While one is selected, the switcher offers **Stop casting**
71
+ rather than the phone's own outputs; stopping reports the local device again.
72
+
73
+ The switcher moves the session only for an app that declares AndroidX's
74
+ `MediaTransferReceiver` in its own manifest. The library leaves it out, because
75
+ it turns on transfer for any MediaRouter in the app, Cast's included:
76
+
77
+ ```xml
78
+ <!-- android/app/src/main/AndroidManifest.xml, inside <application> -->
79
+ <receiver android:name="androidx.mediarouter.media.MediaTransferReceiver" />
80
+ ```
81
+
82
+ Without it, the switcher lists only the phone's own outputs, and the library
83
+ logs a warning saying the receiver is missing.
84
+
85
+ Each `setupPlayer` sets the remote outputs: a call that leaves `remoteOutputs`
86
+ out turns them off, and playback on one comes back to the phone.
87
+
88
+ ::: tip Migrating from `remoteOutputs: true`
89
+ `remoteOutputs` was a boolean; it is now an object, with a flag for each output
90
+ the library plays on. `remoteOutputs: true` becomes `remoteOutputs: {}`.
91
+ :::
92
+
93
+ A provider offers its routes by declaring the library's control category,
94
+ `com.audiobrowser.RemoteOutputs.CATEGORY`, in their control filters. Only the
95
+ selection is reported: the library keeps playing locally, and rendering the
96
+ audio on the speaker is the provider's job.
97
+
98
+ ### Google Cast (Android)
99
+
100
+ With `remoteOutputs: { cast: true }`, selecting a Cast device in the switcher
101
+ moves playback there, through Google's Default Media Receiver, or the receiver
102
+ `castReceiverApplicationId` names. The output
103
+ reports `type: 'cast'`, and the queue, the position and the play intent move
104
+ across both ways: **Stop casting** brings playback back to the phone, at the
105
+ same track.
106
+
107
+ ```ts
108
+ await setupPlayer({ remoteOutputs: { cast: true } })
109
+ ```
110
+
111
+ Cast is opt-in at build time, so apps that don't cast don't ship Google Play
112
+ services' Cast framework. Turn it on in the app's `gradle.properties`:
113
+
114
+ ```properties
115
+ # android/gradle.properties
116
+ AudioBrowser_castEnabled=true
117
+ ```
118
+
119
+ The device and its notifications show the receiver's name: "Default Media
120
+ Receiver" for Google's. To show the app's own, register a Styled Media Receiver
121
+ in the [Google Cast SDK Developer Console](https://cast.google.com/publish) and
122
+ pass its ID; Cast takes it once per app process, so a change takes effect after
123
+ a restart:
124
+
125
+ ```ts
126
+ await setupPlayer({
127
+ remoteOutputs: { cast: true, castReceiverApplicationId: 'ABCD1234' }
128
+ })
129
+ ```
130
+
131
+ The app also declares `MediaTransferReceiver`, as above. Without the build
132
+ property, or on a device without Google Play services, playback stays on the
133
+ phone and the library logs a warning.
134
+
135
+ The receiver fetches the stream itself:
136
+
137
+ - It gets the URL your media transform resolves, without its headers, so a
138
+ stream that needs request headers won't play on it.
139
+ - A track without a file extension is sent as `audio/mpeg`; the receiver works
140
+ out the real codec. A track with `live: true` loads as a live stream.
141
+ - The receiver shows the track's title, artist and artwork. It doesn't read
142
+ song titles from the stream, so the live song doesn't update while casting.
143
+
144
+ While casting, what only makes sense on the phone steps aside:
145
+
146
+ - `setVolume` moves the receiver's volume;
147
+ - the equalizer and the skip-silence setting wait for playback to come back;
148
+ - the sleep timer pauses the receiver without fading;
149
+ - load retries and stall recovery are the receiver's own, and a receiver error
150
+ reaches the app as a playback error.
151
+
152
+ Known limits:
153
+
154
+ - No live song titles on the receiver or the phone while casting: the Default
155
+ Media Receiver keeps the metadata it was loaded with.
156
+ - The receiver is one that takes the same media as the Default Media Receiver:
157
+ Google's own, or a Styled Media Receiver registered for the app.
158
+ - Android only. On iOS, the route picker lists AirPlay devices.
159
+ - A receiver error is not retried; the app decides what to do with it.
160
+
161
+ ### Sonos (Android)
162
+
163
+ With `remoteOutputs: { sonos: true }`, the switcher lists the Sonos rooms on the
164
+ local network, and selecting one moves playback there. The output reports
165
+ `type: 'sonos'` and the room's name.
166
+
167
+ ```ts
168
+ await setupPlayer({ remoteOutputs: { sonos: true } })
169
+ ```
170
+
171
+ The app declares `MediaTransferReceiver`, as above, and the permission to hold
172
+ a Wi-Fi multicast lock while it looks for rooms. No build property is needed:
173
+ the library talks to the speakers itself.
174
+
175
+ ```xml
176
+ <!-- android/app/src/main/AndroidManifest.xml -->
177
+ <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
178
+ ```
179
+
180
+ Without the permission, the library logs a warning and looks for rooms without
181
+ the lock, so a room can be missed while the phone saves power on Wi-Fi.
182
+
183
+ Local network access: the library finds and controls the rooms itself, over
184
+ the local network. An app that targets SDK 36 or lower has that access through
185
+ `INTERNET`, and needs nothing more. From target SDK 37 (Android 17), Android
186
+ blocks the local network until the app is granted the runtime permission
187
+ `ACCESS_LOCAL_NETWORK`, which the library doesn't request yet. Without it, rooms
188
+ don't appear and can't be controlled. Android exempts apps that use the Output
189
+ Switcher for Cast, whose discovery the system runs; its docs don't yet say
190
+ whether that covers rooms the library finds itself, so plan for the permission.
191
+ See Android's
192
+ [local network permission](https://developer.android.com/privacy-and-security/local-network-permission).
193
+
194
+ ::: warning Sonos support is a bonus, not a promise
195
+ The library controls the speakers over UPnP, on port 1400 of each speaker. Sonos
196
+ calls UPnP unsupported and no longer maintained, and lets the listener switch it
197
+ off in the Sonos app (Account › Privacy & Security). When it is off, or Sonos
198
+ removes it, the rooms don't appear in the switcher. The library doesn't use
199
+ Sonos's cloud or local Control APIs, which need Sonos's approval.
200
+ :::
201
+
202
+ What plays:
203
+
204
+ - The speaker fetches the stream itself, from the URL your media transform
205
+ resolves, without its headers. A live stream goes as a radio stream: the
206
+ speaker follows redirects and works out the codec, so MP3, AAC and HLS
207
+ streams play, over `https` and plain `http`. A track goes as a file, in a
208
+ format the speaker plays, so the speaker knows its duration and can seek in it.
209
+ - The speaker is sent the track's title, artist and artwork to show.
210
+ - The speaker reads song titles from the stream (ICY titles, and the ID3 titles
211
+ of HLS streams). The library polls them and reports them through
212
+ `onTimedMetadata`, as it does for local playback, so the live song keeps
213
+ updating.
214
+ - Play, pause, skip and the volume act on the speaker. A live stream that
215
+ refuses to pause is stopped instead, and playing it again restarts it.
216
+ - A track shows the position and duration the speaker reports.
217
+ - Pausing or stopping in the Sonos app shows up as paused here.
218
+
219
+ Grouping:
220
+
221
+ - The switcher lists rooms, not speakers. A stereo pair or a home theatre is one
222
+ room.
223
+ - Rooms grouped in the Sonos app are listed once, named after the room that
224
+ leads the group: "Kitchen + 2". Playing there plays in every room of the group,
225
+ and the volume is the group's, as the Sonos app's group volume is.
226
+ - The library doesn't group or ungroup rooms; the listener does that in the
227
+ Sonos app.
228
+
229
+ While on Sonos, local-only behaviour steps aside as it does for Cast: the
230
+ volume is the speaker's, the equalizer waits for the phone, and a speaker error
231
+ reaches the app as a playback error, as does a speaker that stops answering.
232
+
233
+ Known limits:
234
+
235
+ - Rooms are found by SSDP multicast on the local network, so the phone and the
236
+ speakers must share it; guest and isolated Wi-Fi networks hide them.
237
+ - A track that needs request headers won't play.
238
+ - The state is polled every two seconds, so a change made in the Sonos app shows
239
+ up here after a moment.
240
+ - If another app or the Sonos app starts something else on the room, this app
241
+ reads as paused and leaves the room alone; playing again loads its own track.
242
+ - Android only. On iOS, a Sonos speaker with AirPlay 2 appears in the route
243
+ picker as an AirPlay target.
244
+
245
+ ### On every remote output
246
+
247
+ Cast and Sonos play the queue the same way:
248
+
249
+ - The queue stays in the app. The receiver is sent one item at a time, at the
250
+ position it plays from, and the app sends the next when one ends, as the
251
+ repeat mode says. Editing the queue reaches the receiver only when the
252
+ current item changes.
253
+ - The shuffle mode is kept and comes back to the phone, but a remote output
254
+ plays the queue in list order
255
+ ([#210](https://github.com/radio-garden/react-native-audio-browser/issues/210)).
256
+ - Selecting an output moves the queue, the position, the play intent and the
257
+ repeat mode there. The phone plays on until the current item's URL is
258
+ resolved for the receiver, and the output already reports `'cast'` or
259
+ `'sonos'` meanwhile.
260
+ - Moving from one room or Cast device to another goes straight there, without
261
+ the phone in between.
262
+ - A receiver that fails to play reaches the app as a playback error with code
263
+ `remote-error`, as does an item whose URL can't be resolved for it, and one
264
+ the receiver hasn't started within 30 seconds of being sent or played.
265
+ Playing again loads the item there anew.
266
+
267
+ The library's Sonos route provider service is exported, as the Output Switcher
268
+ needs to bind it: another app on the phone can bind it too, list the rooms,
269
+ select one and set its volume, as through any media route provider.
270
+
271
+ Outside React, read a snapshot with `getOutput()` or subscribe with
272
+ [`onOutputChanged`](/api/features/output/#onoutputchanged):
273
+
274
+ ```ts
275
+ import { getOutput, onOutputChanged } from 'react-native-audio-browser'
276
+
277
+ getOutput() // Output | undefined
278
+
279
+ const unsubscribe = onOutputChanged.addListener((output) => {
280
+ console.log('now playing on', output.name)
281
+ })
282
+
283
+ // later:
284
+ unsubscribe()
285
+ ```
286
+
287
+ ## Opening the output picker
288
+
289
+ [`openOutputPicker()`](/api/features/output/#openoutputpicker) presents the
290
+ system output switcher — the AirPlay / Bluetooth / speaker chooser on iOS, and
291
+ the Bluetooth / speaker / Cast switcher on Android (11+). Wire it to your own
292
+ output button, shown only when
293
+ [`supportsOutputSwitcher()`](/api/features/output/#supportsoutputswitcher) is
294
+ `true`:
295
+
296
+ ```tsx
297
+ import { Button } from 'react-native'
298
+ import {
299
+ openOutputPicker,
300
+ supportsOutputSwitcher
301
+ } from 'react-native-audio-browser'
302
+
303
+ function OutputButton() {
304
+ if (!supportsOutputSwitcher()) return null // older Android / web
305
+ return <Button title="Output" onPress={() => openOutputPicker()} />
306
+ }
307
+ ```
308
+
309
+ `openOutputPicker()` is safe to call unconditionally — it's a no-op where no
310
+ switcher exists — but gating the button on `supportsOutputSwitcher()` keeps you
311
+ from showing a control that would do nothing.
312
+
313
+ On Android the switcher is the system one (the picker from the media
314
+ notification); selecting a Bluetooth speaker there routes audio at the OS level.
315
+ The library can't force playback to a _specific_ Bluetooth device itself — route
316
+ selection is the system's job, which is what this hands off to. Sonos appears on
317
+ iOS as an AirPlay target, and on Android with `remoteOutputs: { sonos: true }`.
318
+
319
+ ## You may not need this for unplug handling
320
+
321
+ When the current output **disappears** — headphones unplugged, a Bluetooth
322
+ speaker powered off — the player **pauses automatically** rather than blaring out
323
+ of the built-in speaker (the convention every media app follows). It's a
324
+ deliberate pause: the listener presses play again when ready. So you don't need
325
+ to watch `onOutputChanged` just to handle unplugging — reach for these APIs to
326
+ _display_ the output or to _offer_ a switcher.
327
+
328
+ ## API summary
329
+
330
+ | API | Platforms | Purpose |
331
+ | -------------------------- | ---------------- | -------------------------------------------------------------------------- |
332
+ | `openOutputPicker()` | iOS, Android 11+ | Present the system output switcher (Bluetooth / AirPlay / speaker / Cast). |
333
+ | `supportsOutputSwitcher()` | all | Whether a switcher can be shown — gate your output button on it. |
334
+ | `useOutput()` | iOS, Android | Reactive current output (`Output \| undefined`). |
335
+ | `getOutput()` | iOS, Android | One-off snapshot of the current output. |
336
+ | `onOutputChanged` | iOS, Android | Subscribe outside React; `addListener(cb)` returns an unsubscribe fn. |
337
+
338
+ The whole API is cross-platform; only the switcher needs Android 11+ (gate on
339
+ `supportsOutputSwitcher()`), and Android reports coarser output `type`s than iOS.