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
@@ -13,12 +13,22 @@ vi.mock('../queue/activeTrack', () => ({
13
13
  onActiveTrackChanged: { addListener: vi.fn(() => () => {}) }
14
14
  }))
15
15
 
16
- import { trackPlaybackTime, __emitTickForTests } from './trackPlaybackTime'
16
+ import { trackPlaybackTime } from './trackPlaybackTime'
17
17
 
18
18
  beforeEach(() => {
19
19
  nativeMock.setPlaybackIntervalEnabled.mockClear()
20
20
  })
21
21
 
22
+ /** Ticks through the slot `install()` assigns, so this covers that wiring too. */
23
+ function tick(times = 1) {
24
+ for (let i = 0; i < times; i++) {
25
+ if (!nativeMock.onPlaybackInterval) {
26
+ throw new Error('trackPlaybackTime never installed onPlaybackInterval')
27
+ }
28
+ nativeMock.onPlaybackInterval()
29
+ }
30
+ }
31
+
22
32
  describe('trackPlaybackTime', () => {
23
33
  it('enables native tick on first subscriber, disables on last', () => {
24
34
  const a = trackPlaybackTime(() => {}, 5)
@@ -38,17 +48,17 @@ describe('trackPlaybackTime', () => {
38
48
  (e) => calls.push({ total: e.total, sinceLast: e.sinceLast }),
39
49
  3
40
50
  )
41
- __emitTickForTests(2)
51
+ tick(2)
42
52
  expect(calls).toEqual([])
43
- __emitTickForTests(1) // total now 3 → fires
53
+ tick(1) // total now 3 → fires
44
54
  expect(calls).toEqual([{ total: 3, sinceLast: 3 }])
45
- __emitTickForTests(3) // total now 6 → fires again
55
+ tick(3) // total now 6 → fires again
46
56
  expect(calls).toEqual([
47
57
  { total: 3, sinceLast: 3 },
48
58
  { total: 6, sinceLast: 3 }
49
59
  ])
50
60
  cancel()
51
- __emitTickForTests(3)
61
+ tick(3)
52
62
  expect(calls).toHaveLength(2) // cancelled
53
63
  })
54
64
 
@@ -57,7 +67,7 @@ describe('trackPlaybackTime', () => {
57
67
  const slow: number[] = []
58
68
  const cancelFast = trackPlaybackTime((e) => fast.push(e.total), 1)
59
69
  const cancelSlow = trackPlaybackTime((e) => slow.push(e.total), 2)
60
- __emitTickForTests(2)
70
+ tick(2)
61
71
  expect(fast).toEqual([1, 2])
62
72
  expect(slow).toEqual([2])
63
73
  cancelFast()
@@ -9,7 +9,7 @@ export interface PlaybackElapsed {
9
9
  total: number
10
10
  /** Seconds played since the previous callback (≈ `period`). */
11
11
  sinceLast: number
12
- /** The currently playing track (id / src / url / title …), if any. */
12
+ /** The currently playing track (id / src / path / title …), if any. */
13
13
  track?: Track
14
14
  }
15
15
 
@@ -99,8 +99,3 @@ export function trackPlaybackTime(
99
99
  if (handles.size === 0) nativeBrowser.setPlaybackIntervalEnabled(false)
100
100
  }
101
101
  }
102
-
103
- /** @internal test hook — drives the fan-out without a native tick. */
104
- export function __emitTickForTests(ticks = 1) {
105
- for (let i = 0; i < ticks; i++) onTick()
106
- }
@@ -42,7 +42,7 @@ export function setSystemVolume(level: number): void {
42
42
  /**
43
43
  * Subscribes to system volume changes.
44
44
  * @param callback - Called when the system volume changes
45
- * @returns Cleanup function to unsubscribe
45
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
46
46
  */
47
47
  export const onSystemVolumeChanged = NativeUpdatedValue.emitterize<number>(
48
48
  (cb) => (nativeBrowser.onSystemVolumeChanged = cb)
@@ -1,8 +1,11 @@
1
- import type { FavoriteConfig } from '../../types'
2
- import type { CarPlayNowPlayingButton } from '../../types/browser'
1
+ import type {
2
+ CarPlayNowPlayingButton,
3
+ CarPlayPlayingIndicatorLocation
4
+ } from '../../types/browser'
3
5
  import { nativeBrowser } from '../../native'
4
6
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue'
5
7
  import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
8
+ import { validateIOSUpdateOptions } from './validateOptions'
6
9
 
7
10
  // MARK: - Types
8
11
 
@@ -70,34 +73,26 @@ export interface PlayerCapabilities {
70
73
  *
71
74
  * Turns on the favorite/like heart across all surfaces:
72
75
  * - iOS: Control Center + CarPlay now-playing.
73
- * - Android: notification button slot + Android Auto now-playing, and an
76
+ * - Android: a place in the {@link RemoteButtonLayout} — the notification,
77
+ * Android Auto and the Android 13+ system media controls — and an
74
78
  * (empty or filled) heart on playable browse rows.
75
79
  *
76
- * `match` controls how the ids from `setFavorites` are
77
- * compared against a track's `src` to decide its `favorited` state
78
- * (see `FavoritesMatchMode`); `true` is shorthand for `'exact'`.
79
- *
80
- * - `false` / omitted: favoriting off everywhere.
81
- * - `true`: on, with `'exact'` id matching.
82
- * - `{ match }`: on, with the given match mode.
80
+ * The ids passed to `setFavorites` are matched exactly against a track's
81
+ * *identity* — its `id` when set, falling back to `src`. Store favorites as
82
+ * the same stable identifier you put in `Track.id` (or as the full `src`
83
+ * for tracks without an id).
83
84
  *
84
85
  * @example
85
86
  * ```ts
86
- * // 'exact': a favorite id must equal the track's src.
87
- * favorite: { match: 'exact' }
88
- * setFavorites(['https://cdn.example.com/audio/track-42.mp3'])
89
- * // → favorited when src === 'https://cdn.example.com/audio/track-42.mp3'
90
- *
91
- * // 'partial': a favorite id matches when it is a full path segment of src.
92
- * favorite: { match: 'partial' }
87
+ * favorite: true
93
88
  * setFavorites(['track-42'])
94
- * // → favorited when src is '/library/track-42' or '/stream/track-42?hq=1',
95
- * // but NOT '/library/track-420'
89
+ * // → favorited when track.id === 'track-42'
90
+ * // (or, for id-less tracks, when track.src === 'track-42')
96
91
  * ```
97
92
  *
98
93
  * @default false
99
94
  */
100
- favorite?: boolean | FavoriteConfig
95
+ favorite?: boolean
101
96
  /**
102
97
  * Enable shuffle mode toggle.
103
98
  * @default true
@@ -293,6 +288,13 @@ export interface IOSOptions {
293
288
  * @default []
294
289
  */
295
290
  carPlayNowPlayingButtons: CarPlayNowPlayingButton[]
291
+
292
+ /**
293
+ * Where the now-playing indicator draws on CarPlay list rows.
294
+ * See {@link CarPlayPlayingIndicatorLocation}.
295
+ * @default 'leading'
296
+ */
297
+ carPlayPlayingIndicatorLocation: CarPlayPlayingIndicatorLocation
296
298
  }
297
299
 
298
300
  export interface AndroidOptions {
@@ -389,6 +391,13 @@ export interface IOSUpdateOptions {
389
391
  * @default []
390
392
  */
391
393
  carPlayNowPlayingButtons?: CarPlayNowPlayingButton[]
394
+
395
+ /**
396
+ * Where the now-playing indicator draws on CarPlay list rows.
397
+ * See {@link CarPlayPlayingIndicatorLocation}.
398
+ * @default 'leading'
399
+ */
400
+ carPlayPlayingIndicatorLocation?: CarPlayPlayingIndicatorLocation
392
401
  }
393
402
 
394
403
  /**
@@ -399,6 +408,7 @@ export interface NitroIOSUpdateOptions {
399
408
  playbackRates?: number[]
400
409
  carPlayUpNextButton?: boolean
401
410
  carPlayNowPlayingButtons?: CarPlayNowPlayingButton[]
411
+ carPlayPlayingIndicatorLocation?: CarPlayPlayingIndicatorLocation
402
412
  }
403
413
 
404
414
  /**
@@ -523,25 +533,6 @@ export interface NativeUpdateOptions {
523
533
 
524
534
  // MARK: - Functions
525
535
 
526
- const MAX_CARPLAY_NOW_PLAYING_BUTTONS = 5
527
-
528
- /**
529
- * Warns when more CarPlay now-playing buttons are configured than CarPlay renders.
530
- * Shared by {@link updateOptions} and `setupPlayer` (both can carry `ios` options).
531
- *
532
- * @internal Validation helper, not public API — `stripInternal` removes it from
533
- * the published types and typedoc hides it from the docs.
534
- */
535
- export function validateIOSUpdateOptions(ios?: IOSUpdateOptions): void {
536
- const buttons = ios?.carPlayNowPlayingButtons
537
- if (buttons && buttons.length > MAX_CARPLAY_NOW_PLAYING_BUTTONS) {
538
- console.warn(
539
- `[react-native-audio-browser] ${buttons.length} CarPlay now-playing ` +
540
- `buttons configured; CarPlay shows at most ${MAX_CARPLAY_NOW_PLAYING_BUTTONS}.`
541
- )
542
- }
543
- }
544
-
545
536
  /**
546
537
  * Updates the configuration for the components.
547
538
  * Pass only the properties you want to change - all properties are optional.
@@ -586,7 +577,7 @@ export function getOptions(): Options {
586
577
  /**
587
578
  * Subscribes to player options changes.
588
579
  * @param callback - Called when the player options change
589
- * @returns Cleanup function to unsubscribe
580
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
590
581
  */
591
582
  export const onOptionsChanged = NativeUpdatedValue.emitterize<Options>(
592
583
  (cb) => (nativeBrowser.onOptionsChanged = cb)
@@ -74,14 +74,23 @@ describe('setupPlayer wire regrouping', () => {
74
74
  })
75
75
  })
76
76
 
77
- it('moves ios playbackRates into the runtime options', async () => {
77
+ it('moves ios runtime fields into the runtime options', async () => {
78
78
  await setupPlayer({
79
- ios: { category: 'playback', playbackRates: [0.5, 1, 2] }
79
+ ios: {
80
+ category: 'playback',
81
+ playbackRates: [0.5, 1, 2],
82
+ carPlayPlayingIndicatorLocation: 'trailing'
83
+ }
80
84
  })
81
85
 
82
86
  const sent = payload()
83
87
  expect(sent.ios).toEqual({ category: 'playback' })
84
- expect(sent.options).toEqual({ ios: { playbackRates: [0.5, 1, 2] } })
88
+ expect(sent.options).toEqual({
89
+ ios: {
90
+ playbackRates: [0.5, 1, 2],
91
+ carPlayPlayingIndicatorLocation: 'trailing'
92
+ }
93
+ })
85
94
  })
86
95
 
87
96
  it('omits a platform bag that only carried runtime fields', async () => {
@@ -11,7 +11,7 @@ import type {
11
11
  UpdateOptions
12
12
  } from './options'
13
13
  import { nativeBrowser } from '../../native'
14
- import { validateIOSUpdateOptions } from './options'
14
+ import { validateIOSUpdateOptions } from './validateOptions'
15
15
 
16
16
  /**
17
17
  * Parameters passed to the {@link FormatNowPlayingCallback}.
@@ -25,7 +25,10 @@ import { validateIOSUpdateOptions } from './options'
25
25
  export type FormatNowPlayingParams = {
26
26
  /** The currently playing track. */
27
27
  track: Track
28
- /** Timed metadata (ICY / ID3 "now playing song") received during playback, if any. */
28
+ /**
29
+ * Timed metadata (ICY / ID3 "now playing song") received during playback, if any.
30
+ * Always `undefined` on web — see `onTimedMetadata` for why.
31
+ */
29
32
  timedMetadata?: TimedMetadata
30
33
  /** The play/pause intent — `false` while paused. Stays `true` through buffers, so the song line won't flicker. */
31
34
  playWhenReady: boolean
@@ -480,6 +483,33 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
480
483
  categoryPolicy?: IOSCategoryPolicy
481
484
  }
482
485
 
486
+ /** Which remote outputs `setupPlayer({ remoteOutputs })` turns on. */
487
+ export interface RemoteOutputsOptions {
488
+ /**
489
+ * Plays on Cast devices selected in the Output Switcher, through the Default Media Receiver:
490
+ * the receiver fetches the track's media URL itself, so it gets the URL the media transform
491
+ * resolves, without its headers. Needs the app built with `AudioBrowser_castEnabled=true` in
492
+ * its `gradle.properties` and Google Play services on the device; without either, playback
493
+ * stays on the phone and a warning is logged.
494
+ * @default false
495
+ */
496
+ cast?: boolean
497
+ /**
498
+ * The Cast receiver application `cast` loads, as registered in the Google Cast SDK Developer
499
+ * Console: a Styled Media Receiver shows the app's own name on the device and in its
500
+ * notifications. Cast takes it once per app process: a change takes effect after a restart.
501
+ * @default the Default Media Receiver, `'CC1AD845'`
502
+ */
503
+ castReceiverApplicationId?: string
504
+ /**
505
+ * Plays on Sonos rooms selected in the Output Switcher, over the speakers' UPnP control: the
506
+ * speaker fetches the media URL the media transform resolves, without its headers. Sonos calls
507
+ * UPnP unsupported and lets the listener switch it off; then no rooms are listed.
508
+ * @default false
509
+ */
510
+ sonos?: boolean
511
+ }
512
+
483
513
  /**
484
514
  * @internal The wire shape `setupPlayer` sends across the bridge: the platform bags hold only
485
515
  * construction fields, the runtime options nest under `options`, and the public `nowPlaying`
@@ -487,7 +517,11 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
487
517
  */
488
518
  export interface NativeSetupPlayerOptions extends Pick<
489
519
  SetupPlayerOptions,
490
- 'playWhenReady' | 'repeatMode' | 'retry' | 'keepSessionAliveOnError'
520
+ | 'playWhenReady'
521
+ | 'repeatMode'
522
+ | 'retry'
523
+ | 'keepSessionAliveOnError'
524
+ | 'remoteOutputs'
491
525
  > {
492
526
  /** Android-specific configuration options for setup */
493
527
  android?: NativeAndroidSetupOptions
@@ -496,7 +530,7 @@ export interface NativeSetupPlayerOptions extends Pick<
496
530
 
497
531
  /**
498
532
  * Player options to apply atomically with setup. They're stored before the player is
499
- * constructed, so e.g. Android's media session derives its notification buttons from
533
+ * constructed, so e.g. Android's media session derives its remote button layout from
500
534
  * `capabilities` the moment the service connects — no window with default controls.
501
535
  * Normalized from the flat fields on {@link SetupPlayerOptions}.
502
536
  */
@@ -597,6 +631,23 @@ export type SetupPlayerOptions = Pick<
597
631
  */
598
632
  keepSessionAliveOnError?: boolean
599
633
 
634
+ /**
635
+ * Offers remote speakers and TVs in the system Output Switcher (`openOutputPicker`), and
636
+ * reports the selected one as the `Output`, with `type: 'remote'`, or `'cast'` for a Cast
637
+ * device and `'sonos'` for a Sonos room. `{}` reports the selection only: the library keeps
638
+ * playing locally, and rendering the audio on the speaker is the provider's job. The speakers
639
+ * come from media route providers that declare the library's remote-output control category
640
+ * (`RemoteOutputs.CATEGORY` on Android). The app declares AndroidX's `MediaTransferReceiver` in
641
+ * its manifest for the switcher to move the session.
642
+ *
643
+ * Each `setupPlayer` sets it: left out, remote outputs are off, and playback on one comes back
644
+ * to the phone.
645
+ *
646
+ * Android 11+ only for now; ignored on iOS, whose route picker already lists AirPlay devices.
647
+ * @default off
648
+ */
649
+ remoteOutputs?: RemoteOutputsOptions
650
+
600
651
  /** Android-specific options: engine construction and runtime, merged. */
601
652
  android?: AndroidSetupOptions
602
653
  /** iOS-specific options: audio session and runtime, merged. */
@@ -738,12 +789,14 @@ export async function setupPlayer(
738
789
  playbackRates,
739
790
  carPlayUpNextButton,
740
791
  carPlayNowPlayingButtons,
792
+ carPlayPlayingIndicatorLocation,
741
793
  ...iosSetup
742
794
  } = ios
743
795
  const iosUpdate = definedFields({
744
796
  playbackRates,
745
797
  carPlayUpNextButton,
746
- carPlayNowPlayingButtons
798
+ carPlayNowPlayingButtons,
799
+ carPlayPlayingIndicatorLocation
747
800
  })
748
801
  validateIOSUpdateOptions(iosUpdate)
749
802
 
@@ -0,0 +1,21 @@
1
+ import type { IOSUpdateOptions } from './options'
2
+
3
+ const MAX_CARPLAY_NOW_PLAYING_BUTTONS = 5
4
+
5
+ /**
6
+ * Warns when more CarPlay now-playing buttons are configured than CarPlay renders.
7
+ * Shared by `updateOptions` and `setupPlayer` (both can carry `ios` options).
8
+ * Kept out of `options.ts`, which the barrel re-exports — see
9
+ * public-surface.test.ts.
10
+ *
11
+ * @internal
12
+ */
13
+ export function validateIOSUpdateOptions(ios?: IOSUpdateOptions): void {
14
+ const buttons = ios?.carPlayNowPlayingButtons
15
+ if (buttons && buttons.length > MAX_CARPLAY_NOW_PLAYING_BUTTONS) {
16
+ console.warn(
17
+ `[react-native-audio-browser] ${buttons.length} CarPlay now-playing ` +
18
+ `buttons configured; CarPlay shows at most ${MAX_CARPLAY_NOW_PLAYING_BUTTONS}.`
19
+ )
20
+ }
21
+ }
@@ -1,7 +1,8 @@
1
1
  import type { Track } from '../../types'
2
2
  import { nativeBrowser } from '../../native'
3
3
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue'
4
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
4
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy'
5
+ import { onFavoriteChanged } from '../favorites'
5
6
 
6
7
  /**
7
8
  * Event data for when the active track changes.
@@ -40,8 +41,14 @@ export function getActiveTrackIndex(): number | undefined {
40
41
 
41
42
  /**
42
43
  * Subscribes to active track change events.
44
+ *
45
+ * Fires on **transitions only** — selection, queue advance, skip. In-place
46
+ * metadata mutations of the active track (a favorite toggle) emit
47
+ * {@link onFavoriteChanged} instead; {@link useActiveTrack} subscribes to
48
+ * both, so UI bound through the hook still re-renders on a heart toggle.
49
+ *
43
50
  * @param callback - Called when the active track changes
44
- * @returns Cleanup function to unsubscribe
51
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
45
52
  */
46
53
  export const onActiveTrackChanged =
47
54
  NativeUpdatedValue.emitterize<PlaybackActiveTrackChangedEvent>(
@@ -50,10 +57,14 @@ export const onActiveTrackChanged =
50
57
 
51
58
  // MARK: - Hooks
52
59
 
60
+ // Module-level so the hook's subscription identity is stable across renders.
61
+ const activeTrackInvalidators = [onActiveTrackChanged, onFavoriteChanged]
62
+
53
63
  /**
54
- * Hook that returns the current active track and updates when it changes.
64
+ * Hook that returns the current active track, updating on transitions AND on
65
+ * in-place mutations of the active track (favorite toggles).
55
66
  * @returns The current active track or undefined
56
67
  */
57
68
  export function useActiveTrack(): Track | undefined {
58
- return useNativeUpdatedValue(getActiveTrack, onActiveTrackChanged, 'track')
69
+ return useNativeValueRefreshedBy(getActiveTrack, activeTrackInvalidators)
59
70
  }
@@ -1,7 +1,8 @@
1
1
  import type { Track } from '../../types'
2
2
  import { nativeBrowser } from '../../native'
3
3
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue'
4
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
4
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy'
5
+ import { onFavoriteChanged } from '../favorites'
5
6
 
6
7
  // MARK: - Types
7
8
 
@@ -156,7 +157,7 @@ export function getQueue(): Track[] {
156
157
  /**
157
158
  * Subscribes to playback queue ended events.
158
159
  * @param callback - Called when playback has paused due to reaching the end of the queue
159
- * @returns Cleanup function to unsubscribe
160
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
160
161
  */
161
162
  export const onQueueEnded =
162
163
  NativeUpdatedValue.emitterize<PlaybackQueueEndedEvent>(
@@ -165,9 +166,11 @@ export const onQueueEnded =
165
166
 
166
167
  /**
167
168
  * Subscribes to queue change events.
168
- * Called when tracks are added, removed, reordered, or when track metadata changes.
169
+ * Called when tracks are added, removed, or reordered. An in-place mutation of
170
+ * a queued track's metadata (a favorite toggle) emits `onFavoriteChanged`
171
+ * instead; {@link useQueue} subscribes to both.
169
172
  * @param callback - Called with the updated queue
170
- * @returns Cleanup function to unsubscribe
173
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
171
174
  */
172
175
  export const onQueueChanged = NativeUpdatedValue.emitterize<Track[]>(
173
176
  (cb) => (nativeBrowser.onPlaybackQueueChanged = cb)
@@ -175,10 +178,14 @@ export const onQueueChanged = NativeUpdatedValue.emitterize<Track[]>(
175
178
 
176
179
  // MARK: - Hooks
177
180
 
181
+ // Module-level so the hook's subscription identity is stable across renders.
182
+ const queueInvalidators = [onQueueChanged, onFavoriteChanged]
183
+
178
184
  /**
179
- * Hook that returns the current queue and updates when it changes.
185
+ * Hook that returns the current queue, updating on queue changes AND on
186
+ * in-place mutations of queued tracks (favorite toggles).
180
187
  * @returns The current queue
181
188
  */
182
189
  export function useQueue(): Track[] {
183
- return useNativeUpdatedValue(getQueue, onQueueChanged)
190
+ return useNativeValueRefreshedBy(getQueue, queueInvalidators)
184
191
  }
@@ -40,7 +40,7 @@ export interface RepeatModeChangedEvent {
40
40
  /**
41
41
  * Subscribes to repeat mode changes.
42
42
  * @param callback - Called when repeat mode changes
43
- * @returns Cleanup function to unsubscribe
43
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
44
44
  */
45
45
  export const onRepeatModeChanged =
46
46
  NativeUpdatedValue.emitterize<RepeatModeChangedEvent>(
@@ -32,7 +32,7 @@ export function toggleShuffle(): void {
32
32
  /**
33
33
  * Subscribes to shuffle mode changes.
34
34
  * @param callback - Called when shuffle mode changes
35
- * @returns Cleanup function to unsubscribe
35
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
36
36
  */
37
37
  export const onShuffleChanged = NativeUpdatedValue.emitterize<boolean>(
38
38
  (cb) => (nativeBrowser.onPlaybackShuffleModeChanged = cb)