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
@@ -18,7 +18,8 @@ exports.skipToPrevious = skipToPrevious;
18
18
  exports.useQueue = useQueue;
19
19
  var _native = require("../../native");
20
20
  var _NativeUpdatedValue = require("../../utils/NativeUpdatedValue");
21
- var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
21
+ var _useNativeValueRefreshedBy = require("../../utils/useNativeValueRefreshedBy");
22
+ var _favorites = require("../favorites");
22
23
  // MARK: - Types
23
24
 
24
25
  /**
@@ -32,6 +33,8 @@ var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
32
33
  * @param tracks - The tracks to add to the queue.
33
34
  * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
34
35
  * By default the tracks will be added to the end of the queue.
36
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
37
+ * Android and the web treat `-1` as append; iOS throws on it.
35
38
  */
36
39
 
37
40
  /**
@@ -39,6 +42,8 @@ var _useNativeUpdatedValue = require("../../utils/useNativeUpdatedValue");
39
42
  * @param track - The track to add to the queue.
40
43
  * @param insertBeforeIndex - (Optional) The index to insert the track before.
41
44
  * By default the track will be added to the end of the queue.
45
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
46
+ * Android and the web treat `-1` as append; iOS throws on it.
42
47
  */
43
48
 
44
49
  function add(tracks, insertBeforeIndex) {
@@ -51,6 +56,7 @@ function add(tracks, insertBeforeIndex) {
51
56
  /**
52
57
  * Replaces the current track or loads the track as the first in the queue.
53
58
  * @param track - The track to load.
59
+ * @throws If called before `setupPlayer`.
54
60
  */
55
61
  function load(track) {
56
62
  _native.nativeBrowser.load(track);
@@ -59,8 +65,10 @@ function load(track) {
59
65
  /**
60
66
  * Move a track within the queue.
61
67
  * @param fromIndex - The index of the track to be moved.
62
- * @param toIndex - The index to move the track to. If the index is larger than
63
- * the size of the queue, then the track is moved to the end of the queue.
68
+ * @param toIndex - The index to move the track to. On iOS and Android an index
69
+ * past the end moves the track to the end of the queue; the web throws.
70
+ * @throws If `fromIndex` is outside the queue or `toIndex` is negative (on the
71
+ * web, also if `toIndex` is past the last index).
64
72
  */
65
73
  function move(fromIndex, toIndex) {
66
74
  _native.nativeBrowser.move(fromIndex, toIndex);
@@ -69,21 +77,32 @@ function move(fromIndex, toIndex) {
69
77
  /**
70
78
  * Removes multiple tracks from the queue by their indexes.
71
79
  *
72
- * If the current track is removed, the next track will activated. If the
73
- * current track was the last track in the queue, the first track will be
74
- * activated.
80
+ * If the active track is removed, the track after it becomes active. On iOS
81
+ * and the web that is the next index, wrapping to the first track. On Android
82
+ * it is the next track in playback order (shuffle and repeat apply), and
83
+ * removing the last track with repeat `off` makes the first track active but
84
+ * ends playback.
75
85
  *
76
86
  * @param indexes - The indexes of the tracks to be removed.
87
+ * @throws If an index is outside the queue. Android checks every index before
88
+ * removing any, and also throws if an index appears twice. iOS removes from the
89
+ * highest index down, so an invalid index can throw after some tracks are gone,
90
+ * and a repeated index also removes the track that moved into its place. The
91
+ * web skips invalid and repeated indexes without throwing.
77
92
  */
78
93
 
79
94
  /**
80
95
  * Removes a track from the queue by its index.
81
96
  *
82
- * If the current track is removed, the next track will activated. If the
83
- * current track was the last track in the queue, the first track will be
84
- * activated.
97
+ * If the active track is removed, the track after it becomes active. On iOS
98
+ * and the web that is the next index, wrapping to the first track. On Android
99
+ * it is the next track in playback order (shuffle and repeat apply), and
100
+ * removing the last track with repeat `off` makes the first track active but
101
+ * ends playback.
85
102
  *
86
103
  * @param index - The index of the track to be removed.
104
+ * @throws If `index` is outside the queue, on iOS and Android; the web
105
+ * ignores it.
87
106
  */
88
107
 
89
108
  function remove(indexOrIndexes) {
@@ -91,7 +110,8 @@ function remove(indexOrIndexes) {
91
110
  }
92
111
 
93
112
  /**
94
- * Clears any upcoming tracks from the queue.
113
+ * Removes every track after the active track's index in the queue. With
114
+ * shuffle on, this is queue order, not the shuffled play order.
95
115
  */
96
116
  function removeUpcomingTracks() {
97
117
  _native.nativeBrowser.removeUpcomingTracks();
@@ -101,6 +121,7 @@ function removeUpcomingTracks() {
101
121
  * Skips to a track in the queue.
102
122
  * @param index - The index of the track to skip to.
103
123
  * @param initialPosition - (Optional) The initial position to seek to in seconds.
124
+ * @throws If `index` is outside the queue.
104
125
  */
105
126
  function skip(index, initialPosition) {
106
127
  _native.nativeBrowser.skip(index, initialPosition);
@@ -108,7 +129,9 @@ function skip(index, initialPosition) {
108
129
 
109
130
  /**
110
131
  * Skips to the next track in the queue.
111
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
132
+ * @param initialPosition - (Optional) The position in seconds to start the next
133
+ * track from. On iOS and Android, with no next track the active track seeks to
134
+ * it instead; on the web the call does nothing.
112
135
  */
113
136
  function skipToNext(initialPosition) {
114
137
  _native.nativeBrowser.skipToNext(initialPosition);
@@ -116,7 +139,9 @@ function skipToNext(initialPosition) {
116
139
 
117
140
  /**
118
141
  * Skips to the previous track in the queue.
119
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
142
+ * @param initialPosition - (Optional) The position in seconds to start the
143
+ * previous track from. On iOS and Android, with no previous track the active
144
+ * track seeks to it instead; on the web the call does nothing.
120
145
  */
121
146
  function skipToPrevious(initialPosition) {
122
147
  _native.nativeBrowser.skipToPrevious(initialPosition);
@@ -125,12 +150,15 @@ function skipToPrevious(initialPosition) {
125
150
  /**
126
151
  * Sets (replaces) the queue.
127
152
  *
128
- * This does not change the play/pause state: the player keeps playing if it was
129
- * playing and stays paused if it was paused. Call `play` explicitly to
130
- * start playback.
153
+ * On iOS and Android this does not change the play/pause state: the player
154
+ * keeps playing if it was playing and stays paused if it was paused. On the
155
+ * web it stops playback. Call `play` after it to start playback.
131
156
  *
132
157
  * @param tracks - The tracks to set as the queue.
133
158
  * @param startIndex - (Optional) The index of the track to make active.
159
+ * Defaults to 0 on iOS and Android; on the web, omitting it leaves no track
160
+ * active. iOS clamps an out-of-range index into the queue, Android throws, and
161
+ * the web ignores it.
134
162
  * @param startPosition - (Optional) The position in seconds to start the active track from.
135
163
  */
136
164
  function setQueue(tracks, startIndex, startPosition) {
@@ -158,27 +186,34 @@ function getQueue() {
158
186
  // MARK: - Event Callbacks
159
187
 
160
188
  /**
161
- * Subscribes to playback queue ended events.
162
- * @param callback - Called when playback has paused due to reaching the end of the queue
189
+ * Subscribes to playback queue ended events: fires when the last track in
190
+ * playback order finishes with repeat mode `off` and the playback state
191
+ * becomes `ended`. Never fires under `track` or `queue` repeat.
163
192
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
164
193
  */
165
194
  const onQueueEnded = exports.onQueueEnded = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackQueueEnded = cb);
166
195
 
167
196
  /**
168
197
  * Subscribes to queue change events.
169
- * Called when tracks are added, removed, reordered, or when track metadata changes.
170
- * @param callback - Called with the updated queue
198
+ * Called when tracks are added, removed, or reordered. On iOS and Android a
199
+ * favorite toggle also fires it, alongside `onFavoriteChanged`. On web a
200
+ * favorite toggle fires only `onFavoriteChanged`. {@link useQueue} subscribes
201
+ * to both.
171
202
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
172
203
  */
173
204
  const onQueueChanged = exports.onQueueChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackQueueChanged = cb);
174
205
 
175
206
  // MARK: - Hooks
176
207
 
208
+ // Module-level so the hook's subscription identity is stable across renders.
209
+ const queueInvalidators = [onQueueChanged, _favorites.onFavoriteChanged];
210
+
177
211
  /**
178
- * Hook that returns the current queue and updates when it changes.
212
+ * Hook that returns the current queue, updating on queue changes AND on
213
+ * in-place mutations of queued tracks (favorite toggles).
179
214
  * @returns The current queue
180
215
  */
181
216
  function useQueue() {
182
- return (0, _useNativeUpdatedValue.useNativeUpdatedValue)(getQueue, onQueueChanged);
217
+ return (0, _useNativeValueRefreshedBy.useNativeValueRefreshedBy)(getQueue, queueInvalidators);
183
218
  }
184
219
  //# sourceMappingURL=queue.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","nativeBrowser","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","exports","NativeUpdatedValue","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","useQueue","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeValueRefreshedBy","_favorites","add","tracks","insertBeforeIndex","addTracks","Array","isArray","length","nativeBrowser","load","track","move","fromIndex","toIndex","remove","indexOrIndexes","removeUpcomingTracks","skip","index","initialPosition","skipToNext","skipToPrevious","setQueue","startIndex","startPosition","getTrack","getQueue","onQueueEnded","exports","NativeUpdatedValue","emitterize","cb","onPlaybackQueueEnded","onQueueChanged","onPlaybackQueueChanged","queueInvalidators","onFavoriteChanged","useQueue","useNativeValueRefreshedBy"],"sourceRoot":"../../../../src","sources":["features/queue/queue.ts"],"mappings":"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","ignoreList":[]}
@@ -39,9 +39,10 @@ function setRepeatMode(repeatMode) {
39
39
 
40
40
  // MARK: - Event Callbacks
41
41
 
42
+ /** Event data for when the repeat mode changes. */
43
+
42
44
  /**
43
45
  * Subscribes to repeat mode changes.
44
- * @param callback - Called when repeat mode changes
45
46
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
46
47
  */
47
48
  const onRepeatModeChanged = exports.onRepeatModeChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackRepeatModeChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getRepeatMode","nativeBrowser","setRepeatMode","repeatMode","onRepeatModeChanged","exports","NativeUpdatedValue","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACO,SAASG,aAAaA,CAAA,EAAe;EAC1C,OAAOC,qBAAa,CAACD,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAACC,UAAsB,EAAE;EACpDF,qBAAa,CAACC,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAOA;AACA;AACA;AACA;AACA;AACO,MAAMC,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAC9BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMP,qBAAa,CAACQ,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAO,IAAAC,4CAAqB,EAACX,aAAa,EAAEI,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
1
+ {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getRepeatMode","nativeBrowser","setRepeatMode","repeatMode","onRepeatModeChanged","exports","NativeUpdatedValue","emitterize","cb","onPlaybackRepeatModeChanged","useRepeatMode","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/repeatMode.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACO,SAASG,aAAaA,CAAA,EAAe;EAC1C,OAAOC,qBAAa,CAACD,aAAa,CAAC,CAAC;AACtC;;AAEA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAACC,UAAsB,EAAE;EACpDF,qBAAa,CAACC,aAAa,CAACC,UAAU,CAAC;AACzC;;AAEA;;AAEA;;AAMA;AACA;AACA;AACA;AACO,MAAMC,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAC9BE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMP,qBAAa,CAACQ,2BAA2B,GAAGD,EACvD,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAAA,EAAe;EAC1C,OAAO,IAAAC,4CAAqB,EAACX,aAAa,EAAEI,mBAAmB,EAAE,YAAY,CAAC;AAChF","ignoreList":[]}
@@ -40,7 +40,6 @@ function toggleShuffle() {
40
40
 
41
41
  /**
42
42
  * Subscribes to shuffle mode changes.
43
- * @param callback - Called when shuffle mode changes
44
43
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
45
44
  */
46
45
  const onShuffleChanged = exports.onShuffleChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onPlaybackShuffleModeChanged = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getShuffle","nativeBrowser","getShuffleEnabled","setShuffle","enabled","setShuffleEnabled","toggleShuffle","onShuffleChanged","exports","NativeUpdatedValue","emitterize","cb","onPlaybackShuffleModeChanged","useShuffle","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/shuffle.ts"],"mappings":";;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACO,SAASG,UAAUA,CAAA,EAAY;EACpC,OAAOC,qBAAa,CAACC,iBAAiB,CAAC,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAACC,OAAgB,EAAQ;EACjDH,qBAAa,CAACI,iBAAiB,CAACD,OAAO,CAAC;AAC1C;;AAEA;AACA;AACA;AACO,SAASE,aAAaA,CAAA,EAAS;EACpCH,UAAU,CAAC,CAACH,UAAU,CAAC,CAAC,CAAC;AAC3B;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAMO,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC1DC,EAAE,IAAMV,qBAAa,CAACW,4BAA4B,GAAGD,EACxD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAO,IAAAC,4CAAqB,EAACd,UAAU,EAAEO,gBAAgB,CAAC;AAC5D","ignoreList":[]}
1
+ {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getShuffle","nativeBrowser","getShuffleEnabled","setShuffle","enabled","setShuffleEnabled","toggleShuffle","onShuffleChanged","exports","NativeUpdatedValue","emitterize","cb","onPlaybackShuffleModeChanged","useShuffle","useNativeUpdatedValue"],"sourceRoot":"../../../../src","sources":["features/queue/shuffle.ts"],"mappings":";;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACO,SAASG,UAAUA,CAAA,EAAY;EACpC,OAAOC,qBAAa,CAACC,iBAAiB,CAAC,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,UAAUA,CAACC,OAAgB,EAAQ;EACjDH,qBAAa,CAACI,iBAAiB,CAACD,OAAO,CAAC;AAC1C;;AAEA;AACA;AACA;AACO,SAASE,aAAaA,CAAA,EAAS;EACpCH,UAAU,CAAC,CAACH,UAAU,CAAC,CAAC,CAAC;AAC3B;;AAEA;;AAEA;AACA;AACA;AACA;AACO,MAAMO,gBAAgB,GAAAC,OAAA,CAAAD,gBAAA,GAAGE,sCAAkB,CAACC,UAAU,CAC1DC,EAAE,IAAMV,qBAAa,CAACW,4BAA4B,GAAGD,EACxD,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACO,SAASE,UAAUA,CAAA,EAAY;EACpC,OAAO,IAAAC,4CAAqB,EAACd,UAAU,EAAEO,gBAAgB,CAAC;AAC5D","ignoreList":[]}
@@ -25,11 +25,11 @@ var _LazyNativeEmitter = require("../utils/LazyNativeEmitter");
25
25
  */
26
26
 
27
27
  /**
28
- * Remote play ID event (Android only).
28
+ * Payload of {@link onRemotePlayId}. No platform emits it.
29
29
  */
30
30
 
31
31
  /**
32
- * Remote play search event (Android only).
32
+ * Payload of {@link onRemotePlaySearch}. No platform emits it.
33
33
  */
34
34
 
35
35
  /**
@@ -37,18 +37,17 @@ var _LazyNativeEmitter = require("../utils/LazyNativeEmitter");
37
37
  */
38
38
 
39
39
  /**
40
- * Remote skip event (Android only).
40
+ * Payload of {@link onRemoteSkip}. No platform emits it.
41
41
  */
42
42
 
43
43
  // MARK: - Handler Override Functions
44
- //
45
- // Use these functions when you want to OVERRIDE the default remote control behavior.
46
- // These will replace the default handlers with your custom logic.
47
- // If you just want to listen to events for debugging/logging, use the onRemote* emitters below.
48
44
 
49
45
  /**
50
46
  * Sets a custom handler for remote play events, overriding the default behavior.
51
- * @param callback - Called when the user presses the play button. Pass undefined to disable.
47
+ * `onRemote*` listeners still fire.
48
+ *
49
+ * @param callback - Called when the user presses the play button. Pass
50
+ * `undefined` to restore the default behavior.
52
51
  */
53
52
  function handleRemotePlay(callback) {
54
53
  _native.nativeBrowser.handleRemotePlay = callback;
@@ -56,7 +55,10 @@ function handleRemotePlay(callback) {
56
55
 
57
56
  /**
58
57
  * Sets a custom handler for remote pause events, overriding the default behavior.
59
- * @param callback - Called when the user presses the pause button. Pass undefined to disable.
58
+ * `onRemote*` listeners still fire.
59
+ *
60
+ * @param callback - Called when the user presses the pause button. Pass
61
+ * `undefined` to restore the default behavior.
60
62
  */
61
63
  function handleRemotePause(callback) {
62
64
  _native.nativeBrowser.handleRemotePause = callback;
@@ -64,7 +66,10 @@ function handleRemotePause(callback) {
64
66
 
65
67
  /**
66
68
  * Sets a custom handler for remote next events, overriding the default behavior.
67
- * @param callback - Called when the user presses the next track button. Pass undefined to disable.
69
+ * `onRemote*` listeners still fire.
70
+ *
71
+ * @param callback - Called when the user presses the next track button. Pass
72
+ * `undefined` to restore the default behavior.
68
73
  */
69
74
  function handleRemoteNext(callback) {
70
75
  _native.nativeBrowser.handleRemoteNext = callback;
@@ -72,7 +77,10 @@ function handleRemoteNext(callback) {
72
77
 
73
78
  /**
74
79
  * Sets a custom handler for remote previous events, overriding the default behavior.
75
- * @param callback - Called when the user presses the previous track button. Pass undefined to disable.
80
+ * `onRemote*` listeners still fire.
81
+ *
82
+ * @param callback - Called when the user presses the previous track button. Pass
83
+ * `undefined` to restore the default behavior.
76
84
  */
77
85
  function handleRemotePrevious(callback) {
78
86
  _native.nativeBrowser.handleRemotePrevious = callback;
@@ -80,7 +88,10 @@ function handleRemotePrevious(callback) {
80
88
 
81
89
  /**
82
90
  * Sets a custom handler for remote stop events, overriding the default behavior.
83
- * @param callback - Called when the user presses the stop button. Pass undefined to disable.
91
+ * `onRemote*` listeners still fire.
92
+ *
93
+ * @param callback - Called when the user presses the stop button. Pass
94
+ * `undefined` to restore the default behavior.
84
95
  */
85
96
  function handleRemoteStop(callback) {
86
97
  _native.nativeBrowser.handleRemoteStop = callback;
@@ -88,7 +99,10 @@ function handleRemoteStop(callback) {
88
99
 
89
100
  /**
90
101
  * Sets a custom handler for remote seek events, overriding the default behavior.
91
- * @param callback - Called when the user changes the position of the timeline. Pass undefined to disable.
102
+ * `onRemote*` listeners still fire.
103
+ *
104
+ * @param callback - Called when the user changes the position of the timeline. Pass
105
+ * `undefined` to restore the default behavior.
92
106
  */
93
107
  function handleRemoteSeek(callback) {
94
108
  _native.nativeBrowser.handleRemoteSeek = callback;
@@ -96,7 +110,10 @@ function handleRemoteSeek(callback) {
96
110
 
97
111
  /**
98
112
  * Sets a custom handler for remote jump forward events, overriding the default behavior.
99
- * @param callback - Called when the user presses the jump forward button. Pass undefined to disable.
113
+ * `onRemote*` listeners still fire.
114
+ *
115
+ * @param callback - Called when the user presses the jump forward button. Pass
116
+ * `undefined` to restore the default behavior.
100
117
  */
101
118
  function handleRemoteJumpForward(callback) {
102
119
  _native.nativeBrowser.handleRemoteJumpForward = callback;
@@ -104,92 +121,99 @@ function handleRemoteJumpForward(callback) {
104
121
 
105
122
  /**
106
123
  * Sets a custom handler for remote jump backward events, overriding the default behavior.
107
- * @param callback - Called when the user presses the jump backward button. Pass undefined to disable.
124
+ * `onRemote*` listeners still fire.
125
+ *
126
+ * @param callback - Called when the user presses the jump backward button. Pass
127
+ * `undefined` to restore the default behavior.
108
128
  */
109
129
  function handleRemoteJumpBackward(callback) {
110
130
  _native.nativeBrowser.handleRemoteJumpBackward = callback;
111
131
  }
112
132
 
113
- // MARK: - Event Callbacks (for listening/debugging only)
114
- //
115
- // Use these emitters when you want to LISTEN to remote control events without overriding
116
- // the default behavior. These are perfect for logging, analytics, or debugging.
117
- // Multiple listeners can be registered for the same event.
118
- // To override the default behavior, use the handleRemote* functions above.
133
+ // MARK: - Event Callbacks
119
134
 
120
135
  /**
121
136
  * Subscribes to remote jump backward events.
122
- * @param callback - Called when the user presses the jump backward button
137
+ * Fires when the user presses the jump backward button, including when a
138
+ * `handleRemoteJumpBackward` override is set.
123
139
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
124
140
  */
125
141
  const onRemoteJumpBackward = exports.onRemoteJumpBackward = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteJumpBackward = cb);
126
142
 
127
143
  /**
128
144
  * Subscribes to remote jump forward events.
129
- * @param callback - Called when the user presses the jump forward button
145
+ * Fires when the user presses the jump forward button, including when a
146
+ * `handleRemoteJumpForward` override is set.
130
147
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
131
148
  */
132
149
  const onRemoteJumpForward = exports.onRemoteJumpForward = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteJumpForward = cb);
133
150
 
134
151
  /**
135
152
  * Subscribes to remote next events.
136
- * @param callback - Called when the user presses the next track button
153
+ * Fires when the user presses the next track button, including when a
154
+ * `handleRemoteNext` override is set.
137
155
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
138
156
  */
139
157
  const onRemoteNext = exports.onRemoteNext = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteNext = cb);
140
158
 
141
159
  /**
142
160
  * Subscribes to remote pause events.
143
- * @param callback - Called when the user presses the pause button
161
+ * Fires when the user presses the pause button, including when a
162
+ * `handleRemotePause` override is set.
144
163
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
145
164
  */
146
165
  const onRemotePause = exports.onRemotePause = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemotePause = cb);
147
166
 
148
167
  /**
149
168
  * Subscribes to remote play events.
150
- * @param callback - Called when the user presses the play button
169
+ * Fires when the user presses the play button, including when a
170
+ * `handleRemotePlay` override is set.
151
171
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
152
172
  */
153
173
  const onRemotePlay = exports.onRemotePlay = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemotePlay = cb);
154
174
 
155
175
  /**
156
- * Subscribes to remote play ID events (Android only).
157
- * @param callback - Called when the user selects a track from an external device
176
+ * Subscribes to remote play ID events. Never fires: no platform (iOS,
177
+ * Android or web) emits them yet.
158
178
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
159
179
  */
160
180
  const onRemotePlayId = exports.onRemotePlayId = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemotePlayId = cb);
161
181
 
162
182
  /**
163
- * Subscribes to remote play search events (Android only).
164
- * @param callback - Called when the user searches for a track (usually voice search)
183
+ * Subscribes to remote play search events. Never fires: no platform (iOS,
184
+ * Android or web) emits them yet. Voice search goes through the `search`
185
+ * source passed to `configureBrowser`.
165
186
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
166
187
  */
167
188
  const onRemotePlaySearch = exports.onRemotePlaySearch = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemotePlaySearch = cb);
168
189
 
169
190
  /**
170
191
  * Subscribes to remote previous events.
171
- * @param callback - Called when the user presses the previous track button
192
+ * Fires when the user presses the previous track button, including when a
193
+ * `handleRemotePrevious` override is set.
172
194
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
173
195
  */
174
196
  const onRemotePrevious = exports.onRemotePrevious = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemotePrevious = cb);
175
197
 
176
198
  /**
177
199
  * Subscribes to remote seek events.
178
- * @param callback - Called when the user changes the position of the timeline
200
+ * Fires when the user changes the position of the timeline, including when a
201
+ * `handleRemoteSeek` override is set.
179
202
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
180
203
  */
181
204
  const onRemoteSeek = exports.onRemoteSeek = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteSeek = cb);
182
205
 
183
206
  /**
184
- * Subscribes to remote skip events (Android only).
185
- * @param callback - Called when the user presses the skip button
207
+ * Subscribes to remote skip events. Never fires: no platform (iOS, Android
208
+ * or web) emits them yet.
186
209
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
187
210
  */
188
211
  const onRemoteSkip = exports.onRemoteSkip = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteSkip = cb);
189
212
 
190
213
  /**
191
214
  * Subscribes to remote stop events.
192
- * @param callback - Called when the user presses the stop button
215
+ * Fires when the user presses the stop button, including when a
216
+ * `handleRemoteStop` override is set.
193
217
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
194
218
  */
195
219
  const onRemoteStop = exports.onRemoteStop = _LazyNativeEmitter.LazyNativeEmitter.emitterize(cb => _native.nativeBrowser.onRemoteStop = cb);
@@ -1 +1 @@
1
- {"version":3,"names":["_native","require","_LazyNativeEmitter","handleRemotePlay","callback","nativeBrowser","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","exports","LazyNativeEmitter","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":["_native","require","_LazyNativeEmitter","handleRemotePlay","callback","nativeBrowser","handleRemotePause","handleRemoteNext","handleRemotePrevious","handleRemoteStop","handleRemoteSeek","handleRemoteJumpForward","handleRemoteJumpBackward","onRemoteJumpBackward","exports","LazyNativeEmitter","emitterize","cb","onRemoteJumpForward","onRemoteNext","onRemotePause","onRemotePlay","onRemotePlayId","onRemotePlaySearch","onRemotePrevious","onRemoteSeek","onRemoteSkip","onRemoteStop"],"sourceRoot":"../../../src","sources":["features/remoteControls.ts"],"mappings":";;;;;;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,kBAAA,GAAAD,OAAA;AAEA;;AAEA;AACA;AACA;;AAMA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AAMA;AACA;AACA;;AAMA;AACA;AACA;;AAMA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,gBAAgBA,CAACC,QAAkC,EAAE;EACnEC,qBAAa,CAACF,gBAAgB,GAAGC,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,iBAAiBA,CAACF,QAAkC,EAAE;EACpEC,qBAAa,CAACC,iBAAiB,GAAGF,QAAQ;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,gBAAgBA,CAACH,QAAkC,EAAE;EACnEC,qBAAa,CAACE,gBAAgB,GAAGH,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,oBAAoBA,CAACJ,QAAkC,EAAE;EACvEC,qBAAa,CAACG,oBAAoB,GAAGJ,QAAQ;AAC/C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,gBAAgBA,CAACL,QAAkC,EAAE;EACnEC,qBAAa,CAACI,gBAAgB,GAAGL,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASM,gBAAgBA,CAC9BN,QAAwD,EACxD;EACAC,qBAAa,CAACK,gBAAgB,GAAGN,QAAQ;AAC3C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASO,uBAAuBA,CACrCP,QAA+D,EAC/D;EACAC,qBAAa,CAACM,uBAAuB,GAAGP,QAAQ;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,wBAAwBA,CACtCR,QAAgE,EAChE;EACAC,qBAAa,CAACO,wBAAwB,GAAGR,QAAQ;AACnD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMS,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAC/BE,oCAAiB,CAACC,UAAU,CACzBC,EAAE,IAAMZ,qBAAa,CAACQ,oBAAoB,GAAGI,EAChD,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,mBAAmB,GAAAJ,OAAA,CAAAI,mBAAA,GAC9BH,oCAAiB,CAACC,UAAU,CACzBC,EAAE,IAAMZ,qBAAa,CAACa,mBAAmB,GAAGD,EAC/C,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACO,MAAME,YAAY,GAAAL,OAAA,CAAAK,YAAA,GAAGJ,oCAAiB,CAACC,UAAU,CACrDC,EAAE,IAAMZ,qBAAa,CAACc,YAAY,GAAGF,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMG,aAAa,GAAAN,OAAA,CAAAM,aAAA,GAAGL,oCAAiB,CAACC,UAAU,CACtDC,EAAE,IAAMZ,qBAAa,CAACe,aAAa,GAAGH,EACzC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMI,YAAY,GAAAP,OAAA,CAAAO,YAAA,GAAGN,oCAAiB,CAACC,UAAU,CACrDC,EAAE,IAAMZ,qBAAa,CAACgB,YAAY,GAAGJ,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,MAAMK,cAAc,GAAAR,OAAA,CAAAQ,cAAA,GAAGP,oCAAiB,CAACC,UAAU,CACvDC,EAAE,IAAMZ,qBAAa,CAACiB,cAAc,GAAGL,EAC1C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMM,kBAAkB,GAAAT,OAAA,CAAAS,kBAAA,GAC7BR,oCAAiB,CAACC,UAAU,CACzBC,EAAE,IAAMZ,qBAAa,CAACkB,kBAAkB,GAAGN,EAC9C,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACO,MAAMO,gBAAgB,GAAAV,OAAA,CAAAU,gBAAA,GAAGT,oCAAiB,CAACC,UAAU,CACzDC,EAAE,IAAMZ,qBAAa,CAACmB,gBAAgB,GAAGP,EAC5C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMQ,YAAY,GAAAX,OAAA,CAAAW,YAAA,GAAGV,oCAAiB,CAACC,UAAU,CACrDC,EAAE,IAAMZ,qBAAa,CAACoB,YAAY,GAAGR,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,MAAMS,YAAY,GAAAZ,OAAA,CAAAY,YAAA,GAAGX,oCAAiB,CAACC,UAAU,CACrDC,EAAE,IAAMZ,qBAAa,CAACqB,YAAY,GAAGT,EACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACO,MAAMU,YAAY,GAAAb,OAAA,CAAAa,YAAA,GAAGZ,oCAAiB,CAACC,UAAU,CACrDC,EAAE,IAAMZ,qBAAa,CAACsB,YAAY,GAAGV,EACxC,CAAC","ignoreList":[]}
@@ -16,20 +16,25 @@ var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
16
16
  // MARK: - Types
17
17
 
18
18
  /**
19
- * Time-based sleep timer that stops playback after a specific time.
19
+ * Time-based sleep timer that pauses playback after a specific time.
20
20
  */
21
21
 
22
22
  /**
23
- * End-of-track sleep timer that stops playback when current track finishes.
23
+ * End-of-track sleep timer that pauses playback when current track finishes.
24
24
  */
25
25
 
26
26
  /**
27
27
  * Sleep timer configuration:
28
- * - `SleepTimerTime`: Stop playback after a specific time
29
- * - `SleepTimerEndOfTrack`: Stop playback after current track finishes
28
+ * - `SleepTimerTime`: Pause playback after a specific time
29
+ * - `SleepTimerEndOfTrack`: Pause playback after current track finishes
30
30
  * - `null`: No sleep timer active
31
31
  */
32
32
 
33
+ /**
34
+ * Payload of `onSleepTimerChanged`: the new timer, or `null` once it is
35
+ * cleared or has fired.
36
+ */
37
+
33
38
  // MARK: - Getters and Setters
34
39
 
35
40
  /**
@@ -53,7 +58,12 @@ function setSleepTimer(seconds, options) {
53
58
  }
54
59
 
55
60
  /**
56
- * Sets a sleep timer to stop playback when the current track finishes playing.
61
+ * Sets a sleep timer to pause playback when the current track finishes playing.
62
+ * A live stream never ends, so on one this timer never fires; use
63
+ * `setSleepTimer` instead. On iOS a change of current track before it ends
64
+ * (skip, new queue) cancels the timer. On Android and web it stays set until a
65
+ * track plays to its end. On Android it never fires while the repeat mode is
66
+ * `track`.
57
67
  */
58
68
  function setSleepTimerToEndOfTrack() {
59
69
  _native.nativeBrowser.setSleepTimerToEndOfTrack();
@@ -71,7 +81,6 @@ function clearSleepTimer() {
71
81
 
72
82
  /**
73
83
  * Subscribes to sleep timer changes.
74
- * @param callback - Called when the sleep timer state changes
75
84
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
76
85
  */
77
86
  const onSleepTimerChanged = exports.onSleepTimerChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onSleepTimerChanged = cb);
@@ -85,8 +94,12 @@ const onSleepTimerChanged = exports.onSleepTimerChanged = _NativeUpdatedValue.Na
85
94
  * @returns true if any sleep timer is active, false otherwise
86
95
  */
87
96
  function useSleepTimerActive() {
97
+ const eventCountAtRender = (0, _react.useRef)(onSleepTimerChanged.eventCount);
88
98
  const [isActive, setIsActive] = (0, _react.useState)(() => getSleepTimer() !== null);
89
99
  (0, _react.useEffect)(() => {
100
+ if (onSleepTimerChanged.eventCount !== eventCountAtRender.current) {
101
+ setIsActive(getSleepTimer() !== null);
102
+ }
90
103
  return onSleepTimerChanged.addListener(timer => {
91
104
  setIsActive(timer !== null);
92
105
  });
@@ -107,12 +120,16 @@ function useSleepTimerActive() {
107
120
  function useSleepTimer(params) {
108
121
  const updateInterval = params?.updateInterval ?? 1000;
109
122
  const inactive = params?.inactive ?? false;
123
+ const eventCountAtRender = (0, _react.useRef)(onSleepTimerChanged.eventCount);
110
124
  const [state, setState] = (0, _react.useState)(() => {
111
125
  const timerState = getSleepTimer();
112
126
  return addSecondsLeft(timerState);
113
127
  });
114
128
  const time = state && 'time' in state ? state.time : undefined;
115
129
  (0, _react.useEffect)(() => {
130
+ if (onSleepTimerChanged.eventCount !== eventCountAtRender.current) {
131
+ setState(addSecondsLeft(getSleepTimer()));
132
+ }
116
133
  return onSleepTimerChanged.addListener(event => {
117
134
  setState(addSecondsLeft(event));
118
135
  });
@@ -1 +1 @@
1
- {"version":3,"names":["_react","require","_native","_NativeUpdatedValue","getSleepTimer","nativeBrowser","setSleepTimer","seconds","options","fadeDuration","setSleepTimerToEndOfTrack","clearSleepTimer","onSleepTimerChanged","exports","NativeUpdatedValue","emitterize","cb","useSleepTimerActive","isActive","setIsActive","useState","useEffect","addListener","timer","useSleepTimer","params","updateInterval","inactive","state","setState","timerState","addSecondsLeft","time","undefined","event","update","sleepTimer","result","secondsLeft","clear","initialTimeoutId","setTimeout","intervalId","setInterval","clearTimeout","clearInterval","Math","max","round","Date","now"],"sourceRoot":"../../../src","sources":["features/sleepTimer.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["_react","require","_native","_NativeUpdatedValue","getSleepTimer","nativeBrowser","setSleepTimer","seconds","options","fadeDuration","setSleepTimerToEndOfTrack","clearSleepTimer","onSleepTimerChanged","exports","NativeUpdatedValue","emitterize","cb","useSleepTimerActive","eventCountAtRender","useRef","eventCount","isActive","setIsActive","useState","useEffect","current","addListener","timer","useSleepTimer","params","updateInterval","inactive","state","setState","timerState","addSecondsLeft","time","undefined","event","update","sleepTimer","result","secondsLeft","clear","initialTimeoutId","setTimeout","intervalId","setInterval","clearTimeout","clearInterval","Math","max","round","Date","now"],"sourceRoot":"../../../src","sources":["features/sleepTimer.ts"],"mappings":"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","ignoreList":[]}