react-native-audio-browser 0.2.0-next.8 → 0.2.0-next.81

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 (1247) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +588 -441
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +84 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +10 -18
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +93 -52
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +50 -33
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +121 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +490 -581
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  62. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  63. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  65. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  66. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  67. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  68. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  90. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  92. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  93. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  94. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  98. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  99. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  100. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  101. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  102. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  103. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  105. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  106. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  107. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  108. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  109. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  110. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  111. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  112. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  113. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  114. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  115. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  116. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  117. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  118. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  119. package/android/src/main/res/values/strings.xml +25 -5
  120. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  121. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  122. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  123. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  124. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  125. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  126. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  127. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  129. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  130. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  131. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  137. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  138. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  139. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  140. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  141. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  142. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  143. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  144. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  146. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  147. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  148. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  149. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  150. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  151. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  152. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  153. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  154. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  155. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  157. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  159. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  161. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  162. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  166. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  167. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  170. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  171. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  180. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  181. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  183. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  184. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  185. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  186. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  187. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  188. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  192. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  205. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  206. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  207. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  209. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  211. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  212. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  213. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  215. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  216. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  217. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  218. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  219. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  220. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  221. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  224. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  225. package/android/src/test/resources/sonos/device_description.xml +78 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  227. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  228. package/ios/AVPlayerEngine.swift +363 -0
  229. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  230. package/ios/Browser/BrowseGate.swift +57 -0
  231. package/ios/Browser/BrowserConfig.swift +123 -104
  232. package/ios/Browser/BrowserError.swift +15 -0
  233. package/ios/Browser/BrowserManager.swift +153 -675
  234. package/ios/Browser/BrowserPathHelper.swift +54 -117
  235. package/ios/Browser/FavoriteSet.swift +43 -0
  236. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  237. package/ios/Browser/JsonModels.swift +244 -335
  238. package/ios/Browser/NavigationErrorState.swift +42 -0
  239. package/ios/Browser/PageResolver.swift +132 -0
  240. package/ios/Browser/RequestLayer.swift +185 -0
  241. package/ios/Browser/RequestPipeline.swift +295 -0
  242. package/ios/Browser/SearchDrillIn.swift +10 -16
  243. package/ios/Browser/SectionScope.swift +73 -26
  244. package/ios/Browser/SimpleRouter.swift +76 -154
  245. package/ios/Browser/StyleResolver.swift +41 -0
  246. package/ios/Browser/TabBarEntries.swift +8 -7
  247. package/ios/Browser/TrackIdTemplate.swift +29 -0
  248. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  249. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  250. package/ios/CarPlay/CarPlayController.swift +37 -1297
  251. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  252. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  253. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  254. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  255. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  256. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  257. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  258. package/ios/CarPlay/CarPlaySession.swift +203 -0
  259. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  260. package/ios/CarPlay/IntentHandlers.swift +94 -0
  261. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  262. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  263. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  264. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  265. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  266. package/ios/CarPlay/SectionPresentation.swift +67 -0
  267. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  268. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  269. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  270. package/ios/Extension/CxxVectorConformances.swift +4 -16
  271. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  272. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  273. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  274. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  275. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  276. package/ios/Extension/SearchParams+Query.swift +28 -0
  277. package/ios/Extension/Section+Copying.swift +26 -0
  278. package/ios/Extension/String+IcyCharset.swift +21 -0
  279. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  280. package/ios/Extension/Track+AVPlayer.swift +1 -18
  281. package/ios/Extension/Track+Copying.swift +13 -21
  282. package/ios/Extension/Track+Identity.swift +20 -0
  283. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  284. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  285. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  286. package/ios/Extension/URLError+Connectivity.swift +15 -0
  287. package/ios/Extension/Variant+Artwork.swift +8 -22
  288. package/ios/Http/HttpClient.swift +73 -167
  289. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  290. package/ios/HybridAudioBrowser+Options.swift +116 -0
  291. package/ios/HybridAudioBrowser+Player.swift +347 -0
  292. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  293. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  294. package/ios/HybridAudioBrowser.swift +148 -1689
  295. package/ios/Model/NitroTypeStubs.swift +240 -32
  296. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  297. package/ios/Model/RemoteCommand.swift +6 -78
  298. package/ios/Model/TrackPlayerError.swift +12 -21
  299. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  300. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  301. package/ios/Observer/ItemObserver.swift +92 -0
  302. package/ios/Observer/PlayerObserver.swift +59 -0
  303. package/ios/Option/SessionCategories.swift +41 -92
  304. package/ios/PlaybackEvent.swift +4 -2
  305. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  306. package/ios/Player/AudioSessionController.swift +190 -0
  307. package/ios/Player/DeferredSeek.swift +73 -0
  308. package/ios/Player/ErrorStatus.swift +52 -0
  309. package/ios/Player/MediaLoader.swift +73 -98
  310. package/ios/Player/NowPlayingLines.swift +49 -0
  311. package/ios/Player/NowPlayingUpdater.swift +180 -105
  312. package/ios/Player/PersistedPlaybackState.swift +1 -2
  313. package/ios/Player/PlaybackFailure.swift +121 -0
  314. package/ios/Player/PlaybackPersistence.swift +72 -0
  315. package/ios/Player/PlaybackStateMachine.swift +11 -11
  316. package/ios/Player/PlaybackTimer.swift +11 -8
  317. package/ios/Player/Player.swift +1010 -0
  318. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  319. package/ios/Player/PlayerEngine.swift +109 -0
  320. package/ios/Player/PlayerStatusTypes.swift +1 -6
  321. package/ios/Player/QueueManager.swift +80 -98
  322. package/ios/Player/ReconnectPacer.swift +83 -0
  323. package/ios/Player/RetryLoop.swift +334 -0
  324. package/ios/Player/ShuffleOrder.swift +36 -43
  325. package/ios/Player/SilenceBudget.swift +78 -0
  326. package/ios/Player/SleepTimerManager.swift +25 -42
  327. package/ios/Player/VolumeFader.swift +20 -15
  328. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  329. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  330. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  331. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  332. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  333. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  334. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  335. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  336. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  337. package/ios/Tests/DeferredSeekTests.swift +76 -0
  338. package/ios/Tests/EmitterTests.swift +22 -39
  339. package/ios/Tests/ErrorStatusTests.swift +50 -0
  340. package/ios/Tests/FavoriteSetTests.swift +61 -0
  341. package/ios/Tests/GenerationMemoTests.swift +178 -0
  342. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  343. package/ios/Tests/JsonModelsTests.swift +189 -3
  344. package/ios/Tests/LRUCacheTests.swift +106 -0
  345. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  346. package/ios/Tests/MediaLoaderTests.swift +38 -78
  347. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  348. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  349. package/ios/Tests/ObserverTests.swift +88 -0
  350. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  351. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  352. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  353. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  354. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  355. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  356. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  357. package/ios/Tests/PlayerTests.swift +1719 -0
  358. package/ios/Tests/PlayingStateTests.swift +41 -0
  359. package/ios/Tests/QueueManagerTests.swift +205 -174
  360. package/ios/Tests/ReadyValueTests.swift +73 -0
  361. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  362. package/ios/Tests/RequestLayerTests.swift +228 -0
  363. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  364. package/ios/Tests/RetryCaseTests.swift +146 -0
  365. package/ios/Tests/RetryLoopTests.swift +307 -0
  366. package/ios/Tests/SearchDrillInTests.swift +16 -17
  367. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  368. package/ios/Tests/SectionPresentationTests.swift +85 -0
  369. package/ios/Tests/SectionScopeTests.swift +136 -54
  370. package/ios/Tests/SimpleRouterTests.swift +39 -8
  371. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  372. package/ios/Tests/StyleResolverTests.swift +123 -0
  373. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  374. package/ios/Tests/Support/TestTypes.swift +152 -100
  375. package/ios/Tests/Support/TimeLimit.swift +43 -0
  376. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  377. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  378. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  379. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  380. package/ios/Tests/TrackIdentityTests.swift +20 -0
  381. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  382. package/ios/Tests/TrackSelectorTests.swift +157 -34
  383. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  384. package/ios/TrackSelector.swift +62 -77
  385. package/ios/Util/ArtworkFreshness.swift +42 -0
  386. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  387. package/ios/Util/AwaitCallback.swift +80 -0
  388. package/ios/Util/ConcurrentMap.swift +19 -0
  389. package/ios/Util/Emitter.swift +45 -22
  390. package/ios/Util/GenerationMemo.swift +43 -0
  391. package/ios/Util/LRUCache.swift +23 -159
  392. package/ios/Util/NetworkMonitor.swift +31 -33
  393. package/ios/Util/OutputPicker.swift +48 -0
  394. package/ios/Util/ReadyValue.swift +57 -0
  395. package/ios/Util/SFSymbolRenderer.swift +64 -49
  396. package/ios/Util/SVGProcessor.swift +9 -16
  397. package/lib/commonjs/AudioBrowser.js +11 -0
  398. package/lib/commonjs/AudioBrowser.js.map +1 -1
  399. package/lib/commonjs/CLAUDE.md +57 -0
  400. package/lib/commonjs/features/battery.js +16 -12
  401. package/lib/commonjs/features/battery.js.map +1 -1
  402. package/lib/commonjs/features/browser-config.js +13 -9
  403. package/lib/commonjs/features/browser-config.js.map +1 -1
  404. package/lib/commonjs/features/browser.js +78 -20
  405. package/lib/commonjs/features/browser.js.map +1 -1
  406. package/lib/commonjs/features/carConnection.js +3 -4
  407. package/lib/commonjs/features/carConnection.js.map +1 -1
  408. package/lib/commonjs/features/equalizer.js +9 -5
  409. package/lib/commonjs/features/equalizer.js.map +1 -1
  410. package/lib/commonjs/features/errors.js +35 -21
  411. package/lib/commonjs/features/errors.js.map +1 -1
  412. package/lib/commonjs/features/favorites.js +28 -23
  413. package/lib/commonjs/features/favorites.js.map +1 -1
  414. package/lib/commonjs/features/gate.js +27 -6
  415. package/lib/commonjs/features/gate.js.map +1 -1
  416. package/lib/commonjs/features/metadata.js +61 -11
  417. package/lib/commonjs/features/metadata.js.map +1 -1
  418. package/lib/commonjs/features/network.js +5 -1
  419. package/lib/commonjs/features/network.js.map +1 -1
  420. package/lib/commonjs/features/nowPlaying.js +28 -14
  421. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  422. package/lib/commonjs/features/output.js +9 -4
  423. package/lib/commonjs/features/output.js.map +1 -1
  424. package/lib/commonjs/features/playback/controls.js +13 -6
  425. package/lib/commonjs/features/playback/controls.js.map +1 -1
  426. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  427. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  428. package/lib/commonjs/features/playback/playing.js +5 -3
  429. package/lib/commonjs/features/playback/playing.js.map +1 -1
  430. package/lib/commonjs/features/playback/progress.js +13 -6
  431. package/lib/commonjs/features/playback/progress.js.map +1 -1
  432. package/lib/commonjs/features/playback/rate.js +8 -1
  433. package/lib/commonjs/features/playback/rate.js.map +1 -1
  434. package/lib/commonjs/features/playback/state.js +5 -6
  435. package/lib/commonjs/features/playback/state.js.map +1 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  437. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  438. package/lib/commonjs/features/playback/volume.js +6 -5
  439. package/lib/commonjs/features/playback/volume.js.map +1 -1
  440. package/lib/commonjs/features/player/options.js +21 -11
  441. package/lib/commonjs/features/player/options.js.map +1 -1
  442. package/lib/commonjs/features/player/setup.js +39 -39
  443. package/lib/commonjs/features/player/setup.js.map +1 -1
  444. package/lib/commonjs/features/player/validateOptions.js +3 -4
  445. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  446. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  447. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  448. package/lib/commonjs/features/queue/queue.js +56 -21
  449. package/lib/commonjs/features/queue/queue.js.map +1 -1
  450. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  451. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  452. package/lib/commonjs/features/queue/shuffle.js +0 -1
  453. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  454. package/lib/commonjs/features/remoteControls.js +59 -35
  455. package/lib/commonjs/features/remoteControls.js.map +1 -1
  456. package/lib/commonjs/features/sleepTimer.js +23 -6
  457. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  458. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  459. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  460. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  461. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  462. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  463. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  464. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  465. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  466. package/lib/commonjs/utils/useDebug.js +16 -3
  467. package/lib/commonjs/utils/useDebug.js.map +1 -1
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  469. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  471. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  472. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  473. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  475. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  477. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  478. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  479. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  480. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  482. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  484. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  485. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  486. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  487. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  488. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  490. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  491. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  492. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  494. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  496. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  497. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  498. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  499. package/lib/commonjs/web/browser/sections.js +89 -0
  500. package/lib/commonjs/web/browser/sections.js.map +1 -0
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  502. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  503. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  504. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  505. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  506. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  507. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  508. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  509. package/lib/module/AudioBrowser.js +2 -4
  510. package/lib/module/AudioBrowser.js.map +1 -1
  511. package/lib/module/CLAUDE.md +57 -0
  512. package/lib/module/features/battery.js +16 -12
  513. package/lib/module/features/battery.js.map +1 -1
  514. package/lib/module/features/browser-config.js +13 -9
  515. package/lib/module/features/browser-config.js.map +1 -1
  516. package/lib/module/features/browser.js +78 -20
  517. package/lib/module/features/browser.js.map +1 -1
  518. package/lib/module/features/carConnection.js +3 -4
  519. package/lib/module/features/carConnection.js.map +1 -1
  520. package/lib/module/features/equalizer.js +9 -5
  521. package/lib/module/features/equalizer.js.map +1 -1
  522. package/lib/module/features/errors.js +35 -21
  523. package/lib/module/features/errors.js.map +1 -1
  524. package/lib/module/features/favorites.js +28 -23
  525. package/lib/module/features/favorites.js.map +1 -1
  526. package/lib/module/features/gate.js +27 -6
  527. package/lib/module/features/gate.js.map +1 -1
  528. package/lib/module/features/metadata.js +59 -11
  529. package/lib/module/features/metadata.js.map +1 -1
  530. package/lib/module/features/network.js +5 -1
  531. package/lib/module/features/network.js.map +1 -1
  532. package/lib/module/features/nowPlaying.js +28 -14
  533. package/lib/module/features/nowPlaying.js.map +1 -1
  534. package/lib/module/features/output.js +9 -4
  535. package/lib/module/features/output.js.map +1 -1
  536. package/lib/module/features/playback/controls.js +13 -6
  537. package/lib/module/features/playback/controls.js.map +1 -1
  538. package/lib/module/features/playback/playWhenReady.js +6 -5
  539. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  540. package/lib/module/features/playback/playing.js +5 -3
  541. package/lib/module/features/playback/playing.js.map +1 -1
  542. package/lib/module/features/playback/progress.js +13 -6
  543. package/lib/module/features/playback/progress.js.map +1 -1
  544. package/lib/module/features/playback/rate.js +8 -1
  545. package/lib/module/features/playback/rate.js.map +1 -1
  546. package/lib/module/features/playback/state.js +5 -6
  547. package/lib/module/features/playback/state.js.map +1 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  549. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  550. package/lib/module/features/playback/volume.js +6 -5
  551. package/lib/module/features/playback/volume.js.map +1 -1
  552. package/lib/module/features/player/options.js +21 -11
  553. package/lib/module/features/player/options.js.map +1 -1
  554. package/lib/module/features/player/setup.js +39 -39
  555. package/lib/module/features/player/setup.js.map +1 -1
  556. package/lib/module/features/player/validateOptions.js +3 -4
  557. package/lib/module/features/player/validateOptions.js.map +1 -1
  558. package/lib/module/features/queue/activeTrack.js +14 -4
  559. package/lib/module/features/queue/activeTrack.js.map +1 -1
  560. package/lib/module/features/queue/queue.js +56 -21
  561. package/lib/module/features/queue/queue.js.map +1 -1
  562. package/lib/module/features/queue/repeatMode.js +2 -1
  563. package/lib/module/features/queue/repeatMode.js.map +1 -1
  564. package/lib/module/features/queue/shuffle.js +0 -1
  565. package/lib/module/features/queue/shuffle.js.map +1 -1
  566. package/lib/module/features/remoteControls.js +59 -35
  567. package/lib/module/features/remoteControls.js.map +1 -1
  568. package/lib/module/features/sleepTimer.js +24 -7
  569. package/lib/module/features/sleepTimer.js.map +1 -1
  570. package/lib/module/test-utils/reactNativeStub.js +58 -0
  571. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  572. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  573. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  574. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  575. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  576. package/lib/module/utils/getTrackIdentity.js +22 -0
  577. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  578. package/lib/module/utils/useDebug.js +16 -3
  579. package/lib/module/utils/useDebug.js.map +1 -1
  580. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  581. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  582. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  583. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  584. package/lib/module/web/NativeAudioBrowser.js +207 -84
  585. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  587. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  589. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  590. package/lib/module/web/TrackPlayer/Player.js +256 -40
  591. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  592. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  593. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  594. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  596. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  597. package/lib/module/web/browser/BrowserManager.js +175 -100
  598. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  599. package/lib/module/web/browser/FavoriteManager.js +31 -21
  600. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  602. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  603. package/lib/module/web/browser/SearchManager.js +18 -23
  604. package/lib/module/web/browser/SearchManager.js.map +1 -1
  605. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  606. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  607. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  608. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  609. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  610. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  611. package/lib/module/web/browser/sections.js +83 -0
  612. package/lib/module/web/browser/sections.js.map +1 -0
  613. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  614. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  615. package/lib/module/web/http/followMediaRedirect.js +215 -0
  616. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  617. package/lib/module/web/player/NowPlayingManager.js +4 -3
  618. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  619. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  620. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  621. package/lib/typescript/package.json +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  623. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  624. package/lib/typescript/src/features/battery.d.ts +17 -12
  625. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  627. package/lib/typescript/src/features/browser.d.ts +67 -19
  628. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  629. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  630. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  631. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  632. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  633. package/lib/typescript/src/features/errors.d.ts +37 -22
  634. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  635. package/lib/typescript/src/features/favorites.d.ts +28 -23
  636. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  637. package/lib/typescript/src/features/gate.d.ts +29 -8
  638. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  639. package/lib/typescript/src/features/metadata.d.ts +65 -14
  640. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  641. package/lib/typescript/src/features/network.d.ts +5 -1
  642. package/lib/typescript/src/features/network.d.ts.map +1 -1
  643. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  644. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  645. package/lib/typescript/src/features/output.d.ts +9 -4
  646. package/lib/typescript/src/features/output.d.ts.map +1 -1
  647. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  648. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  650. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  651. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  652. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  653. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  654. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  656. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  657. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  658. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  660. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  661. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  662. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  663. package/lib/typescript/src/features/player/options.d.ts +73 -56
  664. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  665. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  666. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  668. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  669. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  670. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  672. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  674. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  675. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  676. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  677. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  678. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  680. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  682. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  683. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  684. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  685. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  686. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  687. package/lib/typescript/src/types/browser.d.ts +242 -173
  688. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  690. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  692. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  694. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  696. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  697. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  698. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  700. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  702. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  703. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  704. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  710. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  711. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  712. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  718. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  721. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  722. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  723. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  725. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  726. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  727. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  728. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  737. 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
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  742. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  743. 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
  744. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  749. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  753. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  774. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  777. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  778. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  783. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  785. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  786. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  791. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  794. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  797. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  800. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  802. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  803. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  804. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  805. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  808. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  811. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  814. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  816. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  818. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  826. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  830. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  832. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  833. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  840. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  841. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  845. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  846. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  847. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  850. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  851. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  853. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  854. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  857. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  862. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  863. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  883. 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
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  890. 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
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  893. 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
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  896. 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
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1002. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1005. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1006. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1007. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1008. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1009. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1011. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1012. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1013. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1015. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1016. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1017. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1018. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1019. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1020. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1021. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1022. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1023. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1024. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1025. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1026. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1027. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1028. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1029. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1030. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1031. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1036. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1037. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1038. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1039. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1041. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1042. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1044. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1045. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1046. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1047. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1048. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1049. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1050. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1051. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1052. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1053. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1054. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1055. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1056. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1057. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1058. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1059. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1060. package/package.json +26 -13
  1061. package/src/AudioBrowser.ts +2 -4
  1062. package/src/CLAUDE.md +57 -0
  1063. package/src/docs-floors.test.ts +71 -0
  1064. package/src/features/battery.test.ts +79 -0
  1065. package/src/features/battery.ts +17 -13
  1066. package/src/features/browser-config.test.ts +21 -6
  1067. package/src/features/browser-config.ts +13 -9
  1068. package/src/features/browser.test.ts +1 -1
  1069. package/src/features/browser.ts +69 -20
  1070. package/src/features/carConnection.ts +3 -4
  1071. package/src/features/equalizer.ts +9 -5
  1072. package/src/features/errors.ts +37 -22
  1073. package/src/features/favorites.ts +28 -23
  1074. package/src/features/gate.ts +29 -8
  1075. package/src/features/hook-wiring.test.ts +302 -0
  1076. package/src/features/metadata.ts +80 -14
  1077. package/src/features/network.ts +5 -1
  1078. package/src/features/nowPlaying.ts +28 -14
  1079. package/src/features/output.ts +9 -4
  1080. package/src/features/playback/controls.ts +13 -6
  1081. package/src/features/playback/playWhenReady.ts +6 -5
  1082. package/src/features/playback/playing.ts +16 -3
  1083. package/src/features/playback/progress.test.ts +169 -0
  1084. package/src/features/playback/progress.ts +13 -6
  1085. package/src/features/playback/rate.ts +8 -1
  1086. package/src/features/playback/state.ts +10 -6
  1087. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1088. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1089. package/src/features/playback/volume.ts +6 -5
  1090. package/src/features/player/options.ts +82 -63
  1091. package/src/features/player/setup.test.ts +12 -3
  1092. package/src/features/player/setup.ts +122 -63
  1093. package/src/features/player/validateOptions.ts +3 -4
  1094. package/src/features/queue/activeTrack.ts +14 -4
  1095. package/src/features/queue/queue.ts +56 -21
  1096. package/src/features/queue/repeatMode.ts +1 -1
  1097. package/src/features/queue/shuffle.ts +0 -1
  1098. package/src/features/remoteControls.ts +59 -35
  1099. package/src/features/sleepTimer.test.ts +171 -0
  1100. package/src/features/sleepTimer.ts +24 -8
  1101. package/src/nitro-stub-drift.test.ts +277 -0
  1102. package/src/public-surface.test.ts +56 -25
  1103. package/src/specs/audio-browser.nitro.ts +15 -8
  1104. package/src/style-resolution.test.ts +210 -0
  1105. package/src/test-utils/reactNativeStub.ts +60 -0
  1106. package/src/types/browser-native.ts +7 -3
  1107. package/src/types/browser-nodes.ts +417 -151
  1108. package/src/types/browser.ts +248 -177
  1109. package/src/utils/LazyNativeEmitter.ts +17 -10
  1110. package/src/utils/NativeUpdatedValue.ts +30 -16
  1111. package/src/utils/getTrackIdentity.ts +22 -0
  1112. package/src/utils/useDebug.test.ts +182 -0
  1113. package/src/utils/useDebug.ts +16 -3
  1114. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1115. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1116. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1117. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1118. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1119. package/src/web/NativeAudioBrowser.ts +247 -92
  1120. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1122. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1123. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1124. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1125. package/src/web/TrackPlayer/Player.ts +286 -38
  1126. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1127. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1128. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1129. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1130. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1131. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1132. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1133. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1134. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1135. package/src/web/__tests__/retry.test.ts +169 -0
  1136. package/src/web/browser/BrowserManager.ts +209 -111
  1137. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1138. package/src/web/browser/FavoriteManager.ts +28 -23
  1139. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1140. package/src/web/browser/SearchManager.test.ts +75 -0
  1141. package/src/web/browser/SearchManager.ts +25 -28
  1142. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1143. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1144. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1145. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1146. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1147. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1148. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1149. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1150. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1151. package/src/web/browser/parseSearchResponse.ts +3 -4
  1152. package/src/web/browser/sections.test.ts +91 -0
  1153. package/src/web/browser/sections.ts +72 -0
  1154. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1155. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1156. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1157. package/src/web/http/followMediaRedirect.ts +253 -0
  1158. package/src/web/player/NowPlayingManager.ts +4 -3
  1159. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1160. package/src/web/util/BrowserPathHelper.ts +68 -13
  1161. package/website/guide/android-auto.md +126 -0
  1162. package/website/guide/android-certificates.md +488 -0
  1163. package/website/guide/artwork.md +300 -0
  1164. package/website/guide/audio-output.md +357 -0
  1165. package/website/guide/automotive.md +91 -0
  1166. package/website/guide/basic-usage.md +154 -0
  1167. package/website/guide/battery.md +142 -0
  1168. package/website/guide/browser.md +674 -0
  1169. package/website/guide/carplay.md +733 -0
  1170. package/website/guide/configuration.md +215 -0
  1171. package/website/guide/equalizer.md +235 -0
  1172. package/website/guide/errors.md +355 -0
  1173. package/website/guide/favorites.md +164 -0
  1174. package/website/guide/gate.md +157 -0
  1175. package/website/guide/getting-started.md +99 -0
  1176. package/website/guide/hooks.md +247 -0
  1177. package/website/guide/live-streams.md +156 -0
  1178. package/website/guide/metadata.md +289 -0
  1179. package/website/guide/migrating-from-track-player.md +289 -0
  1180. package/website/guide/native-callback-fetch.md +137 -0
  1181. package/website/guide/network.md +102 -0
  1182. package/website/guide/now-playing.md +203 -0
  1183. package/website/guide/playback.md +405 -0
  1184. package/website/guide/queue.md +334 -0
  1185. package/website/guide/remote-controls.md +314 -0
  1186. package/website/guide/search.md +270 -0
  1187. package/website/guide/sleep-timer.md +289 -0
  1188. package/website/guide/track.md +271 -0
  1189. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1190. package/ios/Bridge.h +0 -8
  1191. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1192. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1193. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1194. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1195. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1196. package/ios/Model/MediaURL.swift +0 -67
  1197. package/ios/Model/SourceType.swift +0 -6
  1198. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1199. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1200. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1201. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1202. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1203. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1204. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1205. package/ios/Option/PitchAlgorithms.swift +0 -17
  1206. package/ios/Option/TimeEventFrequency.swift +0 -18
  1207. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1208. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1209. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1210. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1211. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1212. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1213. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1214. package/ios/Player/PlaybackStateStore.swift +0 -27
  1215. package/ios/Player/PlayingStateManager.swift +0 -33
  1216. package/ios/Player/RetryManager.swift +0 -323
  1217. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1218. package/ios/Player/SleepTimerHandling.swift +0 -15
  1219. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1220. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1221. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1222. package/ios/Tests/MediaResolveTests.swift +0 -126
  1223. package/ios/Tests/OnceValueTests.swift +0 -79
  1224. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1225. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1226. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1227. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1228. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1229. package/ios/Tests/RetryManagerTests.swift +0 -89
  1230. package/ios/TrackPlayer.swift +0 -1014
  1231. package/ios/TrackPlayerCallbacks.swift +0 -53
  1232. package/ios/Util/MetadataAdapter.swift +0 -131
  1233. package/ios/Util/OnceValue.swift +0 -104
  1234. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1236. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1238. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1241. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1242. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1243. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1244. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1245. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1246. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1247. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,7 +2,8 @@
2
2
 
3
3
  import { nativeBrowser } from '../../native';
4
4
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
5
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
5
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy';
6
+ import { onFavoriteChanged } from '../favorites';
6
7
 
7
8
  /**
8
9
  * Event data for when the active track changes.
@@ -29,18 +30,27 @@ export function getActiveTrackIndex() {
29
30
 
30
31
  /**
31
32
  * Subscribes to active track change events.
32
- * @param callback - Called when the active track changes
33
+ *
34
+ * Fires on **transitions only** — selection, queue advance, skip. In-place
35
+ * metadata mutations of the active track (a favorite toggle) emit
36
+ * {@link onFavoriteChanged} instead; {@link useActiveTrack} subscribes to
37
+ * both, so UI bound through the hook still re-renders on a heart toggle.
38
+ *
33
39
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
34
40
  */
35
41
  export const onActiveTrackChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackActiveTrackChanged = cb);
36
42
 
37
43
  // MARK: - Hooks
38
44
 
45
+ // Module-level so the hook's subscription identity is stable across renders.
46
+ const activeTrackInvalidators = [onActiveTrackChanged, onFavoriteChanged];
47
+
39
48
  /**
40
- * Hook that returns the current active track and updates when it changes.
49
+ * Hook that returns the current active track, updating on transitions AND on
50
+ * in-place mutations of the active track (favorite toggles).
41
51
  * @returns The current active track or undefined
42
52
  */
43
53
  export function useActiveTrack() {
44
- return useNativeUpdatedValue(getActiveTrack, onActiveTrackChanged, 'track');
54
+ return useNativeValueRefreshedBy(getActiveTrack, activeTrackInvalidators);
45
55
  }
46
56
  //# sourceMappingURL=activeTrack.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getActiveTrack","undefined","getActiveTrackIndex","onActiveTrackChanged","emitterize","cb","onPlaybackActiveTrackChanged","useActiveTrack"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAsB;EAClD,OAAOH,aAAa,CAACG,cAAc,CAAC,CAAC,IAAIC,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAOL,aAAa,CAACK,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAC/BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAAA,EAAsB;EAClD,OAAOR,qBAAqB,CAACC,cAAc,EAAEG,oBAAoB,EAAE,OAAO,CAAC;AAC7E","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","getActiveTrack","undefined","getActiveTrackIndex","onActiveTrackChanged","emitterize","cb","onPlaybackActiveTrackChanged","activeTrackInvalidators","useActiveTrack"],"sourceRoot":"../../../../src","sources":["features/queue/activeTrack.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,yBAAyB,QAAQ,uCAAuC;AACjF,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;;AAcA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAsB;EAClD,OAAOJ,aAAa,CAACI,cAAc,CAAC,CAAC,IAAIC,SAAS;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAA,EAAuB;EACxD,OAAON,aAAa,CAACM,mBAAmB,CAAC,CAAC,IAAID,SAAS;AACzD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAC/BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACU,4BAA4B,GAAGD,EACxD,CAAC;;AAEH;;AAEA;AACA,MAAME,uBAAuB,GAAG,CAACJ,oBAAoB,EAAEJ,iBAAiB,CAAC;;AAEzE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,cAAcA,CAAA,EAAsB;EAClD,OAAOV,yBAAyB,CAACE,cAAc,EAAEO,uBAAuB,CAAC;AAC3E","ignoreList":[]}
@@ -2,7 +2,8 @@
2
2
 
3
3
  import { nativeBrowser } from '../../native';
4
4
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
5
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
5
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy';
6
+ import { onFavoriteChanged } from '../favorites';
6
7
 
7
8
  // MARK: - Types
8
9
 
@@ -17,6 +18,8 @@ import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
17
18
  * @param tracks - The tracks to add to the queue.
18
19
  * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
19
20
  * By default the tracks will be added to the end of the queue.
21
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
22
+ * Android and the web treat `-1` as append; iOS throws on it.
20
23
  */
21
24
 
22
25
  /**
@@ -24,6 +27,8 @@ import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue';
24
27
  * @param track - The track to add to the queue.
25
28
  * @param insertBeforeIndex - (Optional) The index to insert the track before.
26
29
  * By default the track will be added to the end of the queue.
30
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
31
+ * Android and the web treat `-1` as append; iOS throws on it.
27
32
  */
28
33
 
29
34
  export function add(tracks, insertBeforeIndex) {
@@ -36,6 +41,7 @@ export function add(tracks, insertBeforeIndex) {
36
41
  /**
37
42
  * Replaces the current track or loads the track as the first in the queue.
38
43
  * @param track - The track to load.
44
+ * @throws If called before `setupPlayer`.
39
45
  */
40
46
  export function load(track) {
41
47
  nativeBrowser.load(track);
@@ -44,8 +50,10 @@ export function load(track) {
44
50
  /**
45
51
  * Move a track within the queue.
46
52
  * @param fromIndex - The index of the track to be moved.
47
- * @param toIndex - The index to move the track to. If the index is larger than
48
- * the size of the queue, then the track is moved to the end of the queue.
53
+ * @param toIndex - The index to move the track to. On iOS and Android an index
54
+ * past the end moves the track to the end of the queue; the web throws.
55
+ * @throws If `fromIndex` is outside the queue or `toIndex` is negative (on the
56
+ * web, also if `toIndex` is past the last index).
49
57
  */
50
58
  export function move(fromIndex, toIndex) {
51
59
  nativeBrowser.move(fromIndex, toIndex);
@@ -54,21 +62,32 @@ export function move(fromIndex, toIndex) {
54
62
  /**
55
63
  * Removes multiple tracks from the queue by their indexes.
56
64
  *
57
- * If the current track is removed, the next track will activated. If the
58
- * current track was the last track in the queue, the first track will be
59
- * activated.
65
+ * If the active track is removed, the track after it becomes active. On iOS
66
+ * and the web that is the next index, wrapping to the first track. On Android
67
+ * it is the next track in playback order (shuffle and repeat apply), and
68
+ * removing the last track with repeat `off` makes the first track active but
69
+ * ends playback.
60
70
  *
61
71
  * @param indexes - The indexes of the tracks to be removed.
72
+ * @throws If an index is outside the queue. Android checks every index before
73
+ * removing any, and also throws if an index appears twice. iOS removes from the
74
+ * highest index down, so an invalid index can throw after some tracks are gone,
75
+ * and a repeated index also removes the track that moved into its place. The
76
+ * web skips invalid and repeated indexes without throwing.
62
77
  */
63
78
 
64
79
  /**
65
80
  * Removes a track from the queue by its index.
66
81
  *
67
- * If the current track is removed, the next track will activated. If the
68
- * current track was the last track in the queue, the first track will be
69
- * activated.
82
+ * If the active track is removed, the track after it becomes active. On iOS
83
+ * and the web that is the next index, wrapping to the first track. On Android
84
+ * it is the next track in playback order (shuffle and repeat apply), and
85
+ * removing the last track with repeat `off` makes the first track active but
86
+ * ends playback.
70
87
  *
71
88
  * @param index - The index of the track to be removed.
89
+ * @throws If `index` is outside the queue, on iOS and Android; the web
90
+ * ignores it.
72
91
  */
73
92
 
74
93
  export function remove(indexOrIndexes) {
@@ -76,7 +95,8 @@ export function remove(indexOrIndexes) {
76
95
  }
77
96
 
78
97
  /**
79
- * Clears any upcoming tracks from the queue.
98
+ * Removes every track after the active track's index in the queue. With
99
+ * shuffle on, this is queue order, not the shuffled play order.
80
100
  */
81
101
  export function removeUpcomingTracks() {
82
102
  nativeBrowser.removeUpcomingTracks();
@@ -86,6 +106,7 @@ export function removeUpcomingTracks() {
86
106
  * Skips to a track in the queue.
87
107
  * @param index - The index of the track to skip to.
88
108
  * @param initialPosition - (Optional) The initial position to seek to in seconds.
109
+ * @throws If `index` is outside the queue.
89
110
  */
90
111
  export function skip(index, initialPosition) {
91
112
  nativeBrowser.skip(index, initialPosition);
@@ -93,7 +114,9 @@ export function skip(index, initialPosition) {
93
114
 
94
115
  /**
95
116
  * Skips to the next track in the queue.
96
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
117
+ * @param initialPosition - (Optional) The position in seconds to start the next
118
+ * track from. On iOS and Android, with no next track the active track seeks to
119
+ * it instead; on the web the call does nothing.
97
120
  */
98
121
  export function skipToNext(initialPosition) {
99
122
  nativeBrowser.skipToNext(initialPosition);
@@ -101,7 +124,9 @@ export function skipToNext(initialPosition) {
101
124
 
102
125
  /**
103
126
  * Skips to the previous track in the queue.
104
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
127
+ * @param initialPosition - (Optional) The position in seconds to start the
128
+ * previous track from. On iOS and Android, with no previous track the active
129
+ * track seeks to it instead; on the web the call does nothing.
105
130
  */
106
131
  export function skipToPrevious(initialPosition) {
107
132
  nativeBrowser.skipToPrevious(initialPosition);
@@ -110,12 +135,15 @@ export function skipToPrevious(initialPosition) {
110
135
  /**
111
136
  * Sets (replaces) the queue.
112
137
  *
113
- * This does not change the play/pause state: the player keeps playing if it was
114
- * playing and stays paused if it was paused. Call `play` explicitly to
115
- * start playback.
138
+ * On iOS and Android this does not change the play/pause state: the player
139
+ * keeps playing if it was playing and stays paused if it was paused. On the
140
+ * web it stops playback. Call `play` after it to start playback.
116
141
  *
117
142
  * @param tracks - The tracks to set as the queue.
118
143
  * @param startIndex - (Optional) The index of the track to make active.
144
+ * Defaults to 0 on iOS and Android; on the web, omitting it leaves no track
145
+ * active. iOS clamps an out-of-range index into the queue, Android throws, and
146
+ * the web ignores it.
119
147
  * @param startPosition - (Optional) The position in seconds to start the active track from.
120
148
  */
121
149
  export function setQueue(tracks, startIndex, startPosition) {
@@ -143,27 +171,34 @@ export function getQueue() {
143
171
  // MARK: - Event Callbacks
144
172
 
145
173
  /**
146
- * Subscribes to playback queue ended events.
147
- * @param callback - Called when playback has paused due to reaching the end of the queue
174
+ * Subscribes to playback queue ended events: fires when the last track in
175
+ * playback order finishes with repeat mode `off` and the playback state
176
+ * becomes `ended`. Never fires under `track` or `queue` repeat.
148
177
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
149
178
  */
150
179
  export const onQueueEnded = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueEnded = cb);
151
180
 
152
181
  /**
153
182
  * Subscribes to queue change events.
154
- * Called when tracks are added, removed, reordered, or when track metadata changes.
155
- * @param callback - Called with the updated queue
183
+ * Called when tracks are added, removed, or reordered. On iOS and Android a
184
+ * favorite toggle also fires it, alongside `onFavoriteChanged`. On web a
185
+ * favorite toggle fires only `onFavoriteChanged`. {@link useQueue} subscribes
186
+ * to both.
156
187
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
157
188
  */
158
189
  export const onQueueChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackQueueChanged = cb);
159
190
 
160
191
  // MARK: - Hooks
161
192
 
193
+ // Module-level so the hook's subscription identity is stable across renders.
194
+ const queueInvalidators = [onQueueChanged, onFavoriteChanged];
195
+
162
196
  /**
163
- * Hook that returns the current queue and updates when it changes.
197
+ * Hook that returns the current queue, updating on queue changes AND on
198
+ * in-place mutations of queued tracks (favorite toggles).
164
199
  * @returns The current queue
165
200
  */
166
201
  export function useQueue() {
167
- return useNativeUpdatedValue(getQueue, onQueueChanged);
202
+ return useNativeValueRefreshedBy(getQueue, queueInvalidators);
168
203
  }
169
204
  //# sourceMappingURL=queue.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","useQueue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeValueRefreshedBy","onFavoriteChanged","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","queueInvalidators","useQueue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
@@ -33,9 +33,10 @@ export function setRepeatMode(repeatMode) {
33
33
 
34
34
  // MARK: - Event Callbacks
35
35
 
36
+ /** Event data for when the repeat mode changes. */
37
+
36
38
  /**
37
39
  * Subscribes to repeat mode changes.
38
- * @param callback - Called when repeat mode changes
39
40
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
40
41
  */
41
42
  export const onRepeatModeChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackRepeatModeChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getRepeatMode","setRepeatMode","repeatMode","onRepeatModeChanged","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOH,aAAa,CAACG,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAsB,EAAE;EACpDL,aAAa,CAACI,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAOA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAOR,qBAAqB,CAACC,aAAa,EAAEG,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getRepeatMode","setRepeatMode","repeatMode","onRepeatModeChanged","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAe;EAC1C,OAAOH,aAAa,CAACG,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAsB,EAAE;EACpDL,aAAa,CAACI,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAEA;;AAMA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BL,kBAAkB,CAACM,UAAU,CAC1BC,EAAE,IAAMR,aAAa,CAACS,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAOR,qBAAqB,CAACC,aAAa,EAAEG,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
@@ -33,7 +33,6 @@ export function toggleShuffle() {
33
33
 
34
34
  /**
35
35
  * Subscribes to shuffle mode changes.
36
- * @param callback - Called when shuffle mode changes
37
36
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
38
37
  */
39
38
  export const onShuffleChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackShuffleModeChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getShuffle","getShuffleEnabled","setShuffle","enabled","setShuffleEnabled","toggleShuffle","onShuffleChanged","emitterize","cb","onPlaybackShuffleModeChanged","useShuffle"],"sourceRoot":"../../../../src","sources":["features/queue/shuffle.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOH,aAAa,CAACI,iBAAiB,CAAC,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,OAAgB,EAAQ;EACjDN,aAAa,CAACO,iBAAiB,CAACD,OAAO,CAAC;AAC1C;;AAEA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAS;EACpCH,UAAU,CAAC,CAACF,UAAU,CAAC,CAAC,CAAC;AAC3B;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,gBAAgB,GAAGR,kBAAkB,CAACS,UAAU,CAC1DC,EAAE,IAAMX,aAAa,CAACY,4BAA4B,GAAGD,EACxD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOX,qBAAqB,CAACC,UAAU,EAAEM,gBAAgB,CAAC;AAC5D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getShuffle","getShuffleEnabled","setShuffle","enabled","setShuffleEnabled","toggleShuffle","onShuffleChanged","emitterize","cb","onPlaybackShuffleModeChanged","useShuffle"],"sourceRoot":"../../../../src","sources":["features/queue/shuffle.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAC5C,SAASC,kBAAkB,QAAQ,gCAAgC;AACnE,SAASC,qBAAqB,QAAQ,mCAAmC;;AAEzE;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAY;EACpC,OAAOH,aAAa,CAACI,iBAAiB,CAAC,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,OAAgB,EAAQ;EACjDN,aAAa,CAACO,iBAAiB,CAACD,OAAO,CAAC;AAC1C;;AAEA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAS;EACpCH,UAAU,CAAC,CAACF,UAAU,CAAC,CAAC,CAAC;AAC3B;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMM,gBAAgB,GAAGR,kBAAkB,CAACS,UAAU,CAC1DC,EAAE,IAAMX,aAAa,CAACY,4BAA4B,GAAGD,EACxD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAOX,qBAAqB,CAACC,UAAU,EAAEM,gBAAgB,CAAC;AAC5D","ignoreList":[]}
@@ -14,11 +14,11 @@ import { LazyNativeEmitter } from '../utils/LazyNativeEmitter';
14
14
  */
15
15
 
16
16
  /**
17
- * Remote play ID event (Android only).
17
+ * Payload of {@link onRemotePlayId}. No platform emits it.
18
18
  */
19
19
 
20
20
  /**
21
- * Remote play search event (Android only).
21
+ * Payload of {@link onRemotePlaySearch}. No platform emits it.
22
22
  */
23
23
 
24
24
  /**
@@ -26,18 +26,17 @@ import { LazyNativeEmitter } from '../utils/LazyNativeEmitter';
26
26
  */
27
27
 
28
28
  /**
29
- * Remote skip event (Android only).
29
+ * Payload of {@link onRemoteSkip}. No platform emits it.
30
30
  */
31
31
 
32
32
  // MARK: - Handler Override Functions
33
- //
34
- // Use these functions when you want to OVERRIDE the default remote control behavior.
35
- // These will replace the default handlers with your custom logic.
36
- // If you just want to listen to events for debugging/logging, use the onRemote* emitters below.
37
33
 
38
34
  /**
39
35
  * Sets a custom handler for remote play events, overriding the default behavior.
40
- * @param callback - Called when the user presses the play button. Pass undefined to disable.
36
+ * `onRemote*` listeners still fire.
37
+ *
38
+ * @param callback - Called when the user presses the play button. Pass
39
+ * `undefined` to restore the default behavior.
41
40
  */
42
41
  export function handleRemotePlay(callback) {
43
42
  nativeBrowser.handleRemotePlay = callback;
@@ -45,7 +44,10 @@ export function handleRemotePlay(callback) {
45
44
 
46
45
  /**
47
46
  * Sets a custom handler for remote pause events, overriding the default behavior.
48
- * @param callback - Called when the user presses the pause button. Pass undefined to disable.
47
+ * `onRemote*` listeners still fire.
48
+ *
49
+ * @param callback - Called when the user presses the pause button. Pass
50
+ * `undefined` to restore the default behavior.
49
51
  */
50
52
  export function handleRemotePause(callback) {
51
53
  nativeBrowser.handleRemotePause = callback;
@@ -53,7 +55,10 @@ export function handleRemotePause(callback) {
53
55
 
54
56
  /**
55
57
  * Sets a custom handler for remote next events, overriding the default behavior.
56
- * @param callback - Called when the user presses the next track button. Pass undefined to disable.
58
+ * `onRemote*` listeners still fire.
59
+ *
60
+ * @param callback - Called when the user presses the next track button. Pass
61
+ * `undefined` to restore the default behavior.
57
62
  */
58
63
  export function handleRemoteNext(callback) {
59
64
  nativeBrowser.handleRemoteNext = callback;
@@ -61,7 +66,10 @@ export function handleRemoteNext(callback) {
61
66
 
62
67
  /**
63
68
  * Sets a custom handler for remote previous events, overriding the default behavior.
64
- * @param callback - Called when the user presses the previous track button. Pass undefined to disable.
69
+ * `onRemote*` listeners still fire.
70
+ *
71
+ * @param callback - Called when the user presses the previous track button. Pass
72
+ * `undefined` to restore the default behavior.
65
73
  */
66
74
  export function handleRemotePrevious(callback) {
67
75
  nativeBrowser.handleRemotePrevious = callback;
@@ -69,7 +77,10 @@ export function handleRemotePrevious(callback) {
69
77
 
70
78
  /**
71
79
  * Sets a custom handler for remote stop events, overriding the default behavior.
72
- * @param callback - Called when the user presses the stop button. Pass undefined to disable.
80
+ * `onRemote*` listeners still fire.
81
+ *
82
+ * @param callback - Called when the user presses the stop button. Pass
83
+ * `undefined` to restore the default behavior.
73
84
  */
74
85
  export function handleRemoteStop(callback) {
75
86
  nativeBrowser.handleRemoteStop = callback;
@@ -77,7 +88,10 @@ export function handleRemoteStop(callback) {
77
88
 
78
89
  /**
79
90
  * Sets a custom handler for remote seek events, overriding the default behavior.
80
- * @param callback - Called when the user changes the position of the timeline. Pass undefined to disable.
91
+ * `onRemote*` listeners still fire.
92
+ *
93
+ * @param callback - Called when the user changes the position of the timeline. Pass
94
+ * `undefined` to restore the default behavior.
81
95
  */
82
96
  export function handleRemoteSeek(callback) {
83
97
  nativeBrowser.handleRemoteSeek = callback;
@@ -85,7 +99,10 @@ export function handleRemoteSeek(callback) {
85
99
 
86
100
  /**
87
101
  * Sets a custom handler for remote jump forward events, overriding the default behavior.
88
- * @param callback - Called when the user presses the jump forward button. Pass undefined to disable.
102
+ * `onRemote*` listeners still fire.
103
+ *
104
+ * @param callback - Called when the user presses the jump forward button. Pass
105
+ * `undefined` to restore the default behavior.
89
106
  */
90
107
  export function handleRemoteJumpForward(callback) {
91
108
  nativeBrowser.handleRemoteJumpForward = callback;
@@ -93,92 +110,99 @@ export function handleRemoteJumpForward(callback) {
93
110
 
94
111
  /**
95
112
  * Sets a custom handler for remote jump backward events, overriding the default behavior.
96
- * @param callback - Called when the user presses the jump backward button. Pass undefined to disable.
113
+ * `onRemote*` listeners still fire.
114
+ *
115
+ * @param callback - Called when the user presses the jump backward button. Pass
116
+ * `undefined` to restore the default behavior.
97
117
  */
98
118
  export function handleRemoteJumpBackward(callback) {
99
119
  nativeBrowser.handleRemoteJumpBackward = callback;
100
120
  }
101
121
 
102
- // MARK: - Event Callbacks (for listening/debugging only)
103
- //
104
- // Use these emitters when you want to LISTEN to remote control events without overriding
105
- // the default behavior. These are perfect for logging, analytics, or debugging.
106
- // Multiple listeners can be registered for the same event.
107
- // To override the default behavior, use the handleRemote* functions above.
122
+ // MARK: - Event Callbacks
108
123
 
109
124
  /**
110
125
  * Subscribes to remote jump backward events.
111
- * @param callback - Called when the user presses the jump backward button
126
+ * Fires when the user presses the jump backward button, including when a
127
+ * `handleRemoteJumpBackward` override is set.
112
128
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
113
129
  */
114
130
  export const onRemoteJumpBackward = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteJumpBackward = cb);
115
131
 
116
132
  /**
117
133
  * Subscribes to remote jump forward events.
118
- * @param callback - Called when the user presses the jump forward button
134
+ * Fires when the user presses the jump forward button, including when a
135
+ * `handleRemoteJumpForward` override is set.
119
136
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
120
137
  */
121
138
  export const onRemoteJumpForward = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteJumpForward = cb);
122
139
 
123
140
  /**
124
141
  * Subscribes to remote next events.
125
- * @param callback - Called when the user presses the next track button
142
+ * Fires when the user presses the next track button, including when a
143
+ * `handleRemoteNext` override is set.
126
144
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
127
145
  */
128
146
  export const onRemoteNext = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteNext = cb);
129
147
 
130
148
  /**
131
149
  * Subscribes to remote pause events.
132
- * @param callback - Called when the user presses the pause button
150
+ * Fires when the user presses the pause button, including when a
151
+ * `handleRemotePause` override is set.
133
152
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
134
153
  */
135
154
  export const onRemotePause = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePause = cb);
136
155
 
137
156
  /**
138
157
  * Subscribes to remote play events.
139
- * @param callback - Called when the user presses the play button
158
+ * Fires when the user presses the play button, including when a
159
+ * `handleRemotePlay` override is set.
140
160
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
141
161
  */
142
162
  export const onRemotePlay = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlay = cb);
143
163
 
144
164
  /**
145
- * Subscribes to remote play ID events (Android only).
146
- * @param callback - Called when the user selects a track from an external device
165
+ * Subscribes to remote play ID events. Never fires: no platform (iOS,
166
+ * Android or web) emits them yet.
147
167
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
148
168
  */
149
169
  export const onRemotePlayId = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlayId = cb);
150
170
 
151
171
  /**
152
- * Subscribes to remote play search events (Android only).
153
- * @param callback - Called when the user searches for a track (usually voice search)
172
+ * Subscribes to remote play search events. Never fires: no platform (iOS,
173
+ * Android or web) emits them yet. Voice search goes through the `search`
174
+ * source passed to `configureBrowser`.
154
175
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
155
176
  */
156
177
  export const onRemotePlaySearch = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePlaySearch = cb);
157
178
 
158
179
  /**
159
180
  * Subscribes to remote previous events.
160
- * @param callback - Called when the user presses the previous track button
181
+ * Fires when the user presses the previous track button, including when a
182
+ * `handleRemotePrevious` override is set.
161
183
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
162
184
  */
163
185
  export const onRemotePrevious = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemotePrevious = cb);
164
186
 
165
187
  /**
166
188
  * Subscribes to remote seek events.
167
- * @param callback - Called when the user changes the position of the timeline
189
+ * Fires when the user changes the position of the timeline, including when a
190
+ * `handleRemoteSeek` override is set.
168
191
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
169
192
  */
170
193
  export const onRemoteSeek = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteSeek = cb);
171
194
 
172
195
  /**
173
- * Subscribes to remote skip events (Android only).
174
- * @param callback - Called when the user presses the skip button
196
+ * Subscribes to remote skip events. Never fires: no platform (iOS, Android
197
+ * or web) emits them yet.
175
198
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
176
199
  */
177
200
  export const onRemoteSkip = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteSkip = cb);
178
201
 
179
202
  /**
180
203
  * Subscribes to remote stop events.
181
- * @param callback - Called when the user presses the stop button
204
+ * Fires when the user presses the stop button, including when a
205
+ * `handleRemoteStop` override is set.
182
206
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
183
207
  */
184
208
  export const onRemoteStop = LazyNativeEmitter.emitterize(cb => nativeBrowser.onRemoteStop = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","LazyNativeEmitter","handleRemotePlay","callback","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","emitterize","cb","onRemoteJumpForward","onRemoteNext","onRemotePause","onRemotePlay","onRemotePlayId","onRemotePlaySearch","onRemotePrevious","onRemoteSeek","onRemoteSkip","onRemoteStop"],"sourceRoot":"../../../src","sources":["features/remoteControls.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","LazyNativeEmitter","handleRemotePlay","callback","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","emitterize","cb","onRemoteJumpForward","onRemoteNext","onRemotePause","onRemotePlay","onRemotePlayId","onRemotePlaySearch","onRemotePrevious","onRemoteSeek","onRemoteSkip","onRemoteStop"],"sourceRoot":"../../../src","sources":["features/remoteControls.ts"],"mappings":"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","ignoreList":[]}
@@ -1,26 +1,31 @@
1
1
  "use strict";
2
2
 
3
- import { useEffect, useState } from 'react';
3
+ import { useEffect, useRef, useState } from 'react';
4
4
  import { nativeBrowser } from '../native';
5
5
  import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
6
6
 
7
7
  // MARK: - Types
8
8
 
9
9
  /**
10
- * Time-based sleep timer that stops playback after a specific time.
10
+ * Time-based sleep timer that pauses playback after a specific time.
11
11
  */
12
12
 
13
13
  /**
14
- * End-of-track sleep timer that stops playback when current track finishes.
14
+ * End-of-track sleep timer that pauses playback when current track finishes.
15
15
  */
16
16
 
17
17
  /**
18
18
  * Sleep timer configuration:
19
- * - `SleepTimerTime`: Stop playback after a specific time
20
- * - `SleepTimerEndOfTrack`: Stop playback after current track finishes
19
+ * - `SleepTimerTime`: Pause playback after a specific time
20
+ * - `SleepTimerEndOfTrack`: Pause playback after current track finishes
21
21
  * - `null`: No sleep timer active
22
22
  */
23
23
 
24
+ /**
25
+ * Payload of `onSleepTimerChanged`: the new timer, or `null` once it is
26
+ * cleared or has fired.
27
+ */
28
+
24
29
  // MARK: - Getters and Setters
25
30
 
26
31
  /**
@@ -44,7 +49,12 @@ export function setSleepTimer(seconds, options) {
44
49
  }
45
50
 
46
51
  /**
47
- * Sets a sleep timer to stop playback when the current track finishes playing.
52
+ * Sets a sleep timer to pause playback when the current track finishes playing.
53
+ * A live stream never ends, so on one this timer never fires; use
54
+ * `setSleepTimer` instead. On iOS a change of current track before it ends
55
+ * (skip, new queue) cancels the timer. On Android and web it stays set until a
56
+ * track plays to its end. On Android it never fires while the repeat mode is
57
+ * `track`.
48
58
  */
49
59
  export function setSleepTimerToEndOfTrack() {
50
60
  nativeBrowser.setSleepTimerToEndOfTrack();
@@ -62,7 +72,6 @@ export function clearSleepTimer() {
62
72
 
63
73
  /**
64
74
  * Subscribes to sleep timer changes.
65
- * @param callback - Called when the sleep timer state changes
66
75
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
67
76
  */
68
77
  export const onSleepTimerChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onSleepTimerChanged = cb);
@@ -76,8 +85,12 @@ export const onSleepTimerChanged = NativeUpdatedValue.emitterize(cb => nativeBro
76
85
  * @returns true if any sleep timer is active, false otherwise
77
86
  */
78
87
  export function useSleepTimerActive() {
88
+ const eventCountAtRender = useRef(onSleepTimerChanged.eventCount);
79
89
  const [isActive, setIsActive] = useState(() => getSleepTimer() !== null);
80
90
  useEffect(() => {
91
+ if (onSleepTimerChanged.eventCount !== eventCountAtRender.current) {
92
+ setIsActive(getSleepTimer() !== null);
93
+ }
81
94
  return onSleepTimerChanged.addListener(timer => {
82
95
  setIsActive(timer !== null);
83
96
  });
@@ -98,12 +111,16 @@ export function useSleepTimerActive() {
98
111
  export function useSleepTimer(params) {
99
112
  const updateInterval = params?.updateInterval ?? 1000;
100
113
  const inactive = params?.inactive ?? false;
114
+ const eventCountAtRender = useRef(onSleepTimerChanged.eventCount);
101
115
  const [state, setState] = useState(() => {
102
116
  const timerState = getSleepTimer();
103
117
  return addSecondsLeft(timerState);
104
118
  });
105
119
  const time = state && 'time' in state ? state.time : undefined;
106
120
  useEffect(() => {
121
+ if (onSleepTimerChanged.eventCount !== eventCountAtRender.current) {
122
+ setState(addSecondsLeft(getSleepTimer()));
123
+ }
107
124
  return onSleepTimerChanged.addListener(event => {
108
125
  setState(addSecondsLeft(event));
109
126
  });