react-native-audio-browser 0.2.0-next.9 → 0.2.0-next.90

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 (1271) 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 +578 -456
  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 +101 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +15 -17
  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 +113 -50
  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 +75 -65
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +590 -343
  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 +119 -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 +686 -600
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +18 -28
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +171 -178
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +65 -210
  63. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  64. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  66. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  67. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  68. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  69. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  71. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  72. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  94. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  95. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  97. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  98. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  99. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  103. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  105. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  106. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  107. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  108. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  110. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  111. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  112. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  113. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  114. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  115. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  116. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  117. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  118. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  119. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  120. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  121. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  122. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  123. package/android/src/main/res/values/strings.xml +25 -5
  124. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  125. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  126. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +32 -0
  127. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  128. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  129. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  130. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  132. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  133. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  134. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +24 -4
  135. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  136. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  137. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  138. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  139. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  140. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  141. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  142. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  146. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  147. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  148. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  149. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  150. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  151. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  152. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  153. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  154. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  155. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  156. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  157. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  158. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  159. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  160. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  161. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  162. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  163. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  164. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +182 -0
  165. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  166. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +316 -0
  167. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  168. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  169. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  170. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  171. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  173. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  174. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  176. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  178. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  180. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  182. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +607 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +354 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  189. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  190. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  191. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +93 -200
  192. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  193. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  194. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +176 -0
  196. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  197. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  198. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  199. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  200. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  201. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  202. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  203. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  204. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  205. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  206. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  207. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  208. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  209. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  210. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  211. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  212. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  213. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  214. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  221. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  222. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  223. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  224. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  225. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  226. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  227. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  228. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  229. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  230. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  231. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  232. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  233. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  234. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  235. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  236. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  237. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  238. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  239. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  240. package/android/src/test/resources/sonos/device_description.xml +78 -0
  241. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  242. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  243. package/ios/AVPlayerEngine.swift +363 -0
  244. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  245. package/ios/Browser/BrowseGate.swift +70 -0
  246. package/ios/Browser/BrowserConfig.swift +123 -104
  247. package/ios/Browser/BrowserError.swift +15 -0
  248. package/ios/Browser/BrowserManager.swift +153 -675
  249. package/ios/Browser/BrowserPathHelper.swift +54 -117
  250. package/ios/Browser/FavoriteSet.swift +43 -0
  251. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  252. package/ios/Browser/JsonModels.swift +244 -335
  253. package/ios/Browser/NavigationErrorState.swift +42 -0
  254. package/ios/Browser/PageResolver.swift +132 -0
  255. package/ios/Browser/RequestLayer.swift +185 -0
  256. package/ios/Browser/RequestPipeline.swift +295 -0
  257. package/ios/Browser/SearchDrillIn.swift +10 -16
  258. package/ios/Browser/SectionScope.swift +73 -26
  259. package/ios/Browser/SimpleRouter.swift +76 -154
  260. package/ios/Browser/StyleResolver.swift +41 -0
  261. package/ios/Browser/TabBarEntries.swift +8 -7
  262. package/ios/Browser/TrackIdTemplate.swift +29 -0
  263. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  264. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  265. package/ios/CarPlay/CarPlayController.swift +37 -1297
  266. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  267. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  268. package/ios/CarPlay/CarPlayNowPlayingManager.swift +147 -218
  269. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  270. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  271. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  272. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  273. package/ios/CarPlay/CarPlaySession.swift +203 -0
  274. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  275. package/ios/CarPlay/IntentHandlers.swift +94 -0
  276. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  277. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +15 -17
  278. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  279. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  280. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  281. package/ios/CarPlay/SectionPresentation.swift +67 -0
  282. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  283. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  284. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  285. package/ios/Extension/CxxVectorConformances.swift +4 -16
  286. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  287. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  288. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  289. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  290. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  291. package/ios/Extension/SearchParams+Query.swift +28 -0
  292. package/ios/Extension/Section+Copying.swift +26 -0
  293. package/ios/Extension/String+IcyCharset.swift +21 -0
  294. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  295. package/ios/Extension/Track+AVPlayer.swift +1 -18
  296. package/ios/Extension/Track+Copying.swift +13 -21
  297. package/ios/Extension/Track+Identity.swift +20 -0
  298. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  299. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  300. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  301. package/ios/Extension/URLError+Connectivity.swift +15 -0
  302. package/ios/Extension/Variant+Artwork.swift +8 -22
  303. package/ios/Http/HttpClient.swift +73 -167
  304. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  305. package/ios/HybridAudioBrowser+Options.swift +116 -0
  306. package/ios/HybridAudioBrowser+Player.swift +347 -0
  307. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  308. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  309. package/ios/HybridAudioBrowser.swift +147 -1718
  310. package/ios/Model/NitroTypeStubs.swift +265 -32
  311. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  312. package/ios/Model/RemoteCommand.swift +6 -78
  313. package/ios/Model/TrackPlayerError.swift +12 -21
  314. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  315. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  316. package/ios/Observer/ItemObserver.swift +92 -0
  317. package/ios/Observer/PlayerObserver.swift +59 -0
  318. package/ios/Option/SessionCategories.swift +41 -92
  319. package/ios/PlaybackEvent.swift +4 -2
  320. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  321. package/ios/Player/AudioSessionController.swift +190 -0
  322. package/ios/Player/DeferredSeek.swift +73 -0
  323. package/ios/Player/ErrorStatus.swift +56 -0
  324. package/ios/Player/MediaLoader.swift +73 -98
  325. package/ios/Player/NowPlayingLines.swift +49 -0
  326. package/ios/Player/NowPlayingUpdater.swift +180 -105
  327. package/ios/Player/PersistedPlaybackState.swift +1 -2
  328. package/ios/Player/PlaybackFailure.swift +121 -0
  329. package/ios/Player/PlaybackPersistence.swift +72 -0
  330. package/ios/Player/PlaybackStateMachine.swift +15 -14
  331. package/ios/Player/PlaybackTimer.swift +11 -8
  332. package/ios/Player/Player.swift +1030 -0
  333. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  334. package/ios/Player/PlayerEngine.swift +109 -0
  335. package/ios/Player/PlayerStatusTypes.swift +1 -6
  336. package/ios/Player/QueueManager.swift +80 -98
  337. package/ios/Player/ReconnectPacer.swift +83 -0
  338. package/ios/Player/RetryLoop.swift +374 -0
  339. package/ios/Player/ShuffleOrder.swift +36 -43
  340. package/ios/Player/SilenceBudget.swift +78 -0
  341. package/ios/Player/SleepTimerManager.swift +25 -42
  342. package/ios/Player/VolumeFader.swift +20 -15
  343. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  344. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  345. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  346. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  347. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  348. package/ios/Tests/BrowseGateTests.swift +50 -0
  349. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  350. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  351. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  352. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  353. package/ios/Tests/ConnectivityTests.swift +13 -0
  354. package/ios/Tests/DeferredSeekTests.swift +76 -0
  355. package/ios/Tests/EmitterTests.swift +22 -39
  356. package/ios/Tests/ErrorStatusTests.swift +50 -0
  357. package/ios/Tests/FavoriteSetTests.swift +61 -0
  358. package/ios/Tests/GenerationMemoTests.swift +178 -0
  359. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  360. package/ios/Tests/JsonModelsTests.swift +189 -3
  361. package/ios/Tests/LRUCacheTests.swift +106 -0
  362. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  363. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  364. package/ios/Tests/MediaLoaderTests.swift +38 -78
  365. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  366. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  367. package/ios/Tests/ObserverTests.swift +88 -0
  368. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  369. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  370. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  371. package/ios/Tests/PlaybackStateMachineTests.swift +7 -22
  372. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  373. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  374. package/ios/Tests/PlayerPolicyTests.swift +1386 -0
  375. package/ios/Tests/PlayerTests.swift +1677 -0
  376. package/ios/Tests/PlayingStateTests.swift +41 -0
  377. package/ios/Tests/QueueManagerTests.swift +205 -174
  378. package/ios/Tests/ReadyValueTests.swift +73 -0
  379. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  380. package/ios/Tests/RequestLayerTests.swift +228 -0
  381. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  382. package/ios/Tests/RetryCaseTests.swift +146 -0
  383. package/ios/Tests/RetryLoopTests.swift +486 -0
  384. package/ios/Tests/SearchDrillInTests.swift +16 -17
  385. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  386. package/ios/Tests/SectionPresentationTests.swift +85 -0
  387. package/ios/Tests/SectionScopeTests.swift +136 -54
  388. package/ios/Tests/SimpleRouterTests.swift +39 -8
  389. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  390. package/ios/Tests/StyleResolverTests.swift +123 -0
  391. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  392. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  393. package/ios/Tests/Support/TestTypes.swift +236 -93
  394. package/ios/Tests/Support/TimeLimit.swift +43 -0
  395. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  396. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  397. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  398. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  399. package/ios/Tests/TrackIdentityTests.swift +20 -0
  400. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  401. package/ios/Tests/TrackSelectorTests.swift +157 -34
  402. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  403. package/ios/TrackSelector.swift +62 -77
  404. package/ios/Util/ArtworkFreshness.swift +42 -0
  405. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  406. package/ios/Util/AwaitCallback.swift +80 -0
  407. package/ios/Util/ConcurrentMap.swift +19 -0
  408. package/ios/Util/Connectivity.swift +12 -0
  409. package/ios/Util/Deadline.swift +38 -0
  410. package/ios/Util/Emitter.swift +45 -22
  411. package/ios/Util/GenerationMemo.swift +43 -0
  412. package/ios/Util/LRUCache.swift +23 -159
  413. package/ios/Util/NetworkMonitor.swift +31 -33
  414. package/ios/Util/OutputPicker.swift +48 -0
  415. package/ios/Util/ReadyValue.swift +57 -0
  416. package/ios/Util/SFSymbolRenderer.swift +64 -49
  417. package/ios/Util/SVGProcessor.swift +9 -16
  418. package/ios/Util/SupersedingTask.swift +45 -0
  419. package/lib/commonjs/AudioBrowser.js +11 -0
  420. package/lib/commonjs/AudioBrowser.js.map +1 -1
  421. package/lib/commonjs/CLAUDE.md +57 -0
  422. package/lib/commonjs/features/battery.js +16 -12
  423. package/lib/commonjs/features/battery.js.map +1 -1
  424. package/lib/commonjs/features/browser-config.js +13 -9
  425. package/lib/commonjs/features/browser-config.js.map +1 -1
  426. package/lib/commonjs/features/browser.js +78 -20
  427. package/lib/commonjs/features/browser.js.map +1 -1
  428. package/lib/commonjs/features/carConnection.js +3 -4
  429. package/lib/commonjs/features/carConnection.js.map +1 -1
  430. package/lib/commonjs/features/equalizer.js +9 -5
  431. package/lib/commonjs/features/equalizer.js.map +1 -1
  432. package/lib/commonjs/features/errors.js +35 -21
  433. package/lib/commonjs/features/errors.js.map +1 -1
  434. package/lib/commonjs/features/favorites.js +28 -23
  435. package/lib/commonjs/features/favorites.js.map +1 -1
  436. package/lib/commonjs/features/gate.js +27 -6
  437. package/lib/commonjs/features/gate.js.map +1 -1
  438. package/lib/commonjs/features/metadata.js +61 -11
  439. package/lib/commonjs/features/metadata.js.map +1 -1
  440. package/lib/commonjs/features/network.js +5 -1
  441. package/lib/commonjs/features/network.js.map +1 -1
  442. package/lib/commonjs/features/nowPlaying.js +28 -14
  443. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  444. package/lib/commonjs/features/output.js +9 -4
  445. package/lib/commonjs/features/output.js.map +1 -1
  446. package/lib/commonjs/features/playback/controls.js +13 -6
  447. package/lib/commonjs/features/playback/controls.js.map +1 -1
  448. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  449. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  450. package/lib/commonjs/features/playback/playing.js +5 -3
  451. package/lib/commonjs/features/playback/playing.js.map +1 -1
  452. package/lib/commonjs/features/playback/progress.js +13 -6
  453. package/lib/commonjs/features/playback/progress.js.map +1 -1
  454. package/lib/commonjs/features/playback/rate.js +8 -1
  455. package/lib/commonjs/features/playback/rate.js.map +1 -1
  456. package/lib/commonjs/features/playback/state.js +5 -6
  457. package/lib/commonjs/features/playback/state.js.map +1 -1
  458. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  459. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  460. package/lib/commonjs/features/playback/volume.js +6 -5
  461. package/lib/commonjs/features/playback/volume.js.map +1 -1
  462. package/lib/commonjs/features/player/options.js +20 -10
  463. package/lib/commonjs/features/player/options.js.map +1 -1
  464. package/lib/commonjs/features/player/setup.js +44 -43
  465. package/lib/commonjs/features/player/setup.js.map +1 -1
  466. package/lib/commonjs/features/player/validateOptions.js +3 -4
  467. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  468. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  469. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  470. package/lib/commonjs/features/queue/queue.js +56 -21
  471. package/lib/commonjs/features/queue/queue.js.map +1 -1
  472. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  473. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  474. package/lib/commonjs/features/queue/shuffle.js +0 -1
  475. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  476. package/lib/commonjs/features/remoteControls.js +59 -35
  477. package/lib/commonjs/features/remoteControls.js.map +1 -1
  478. package/lib/commonjs/features/sleepTimer.js +23 -6
  479. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  480. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  481. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  482. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  483. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  484. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  485. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  486. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  487. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  488. package/lib/commonjs/utils/useDebug.js +16 -3
  489. package/lib/commonjs/utils/useDebug.js.map +1 -1
  490. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  491. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  492. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  493. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  494. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  495. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  496. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  497. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  498. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  499. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  500. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  501. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  502. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  503. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  504. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  505. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  506. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  507. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  508. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  509. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  510. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  511. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  512. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  513. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  514. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  515. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  516. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  517. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  518. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  519. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  520. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  521. package/lib/commonjs/web/browser/sections.js +89 -0
  522. package/lib/commonjs/web/browser/sections.js.map +1 -0
  523. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  524. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  525. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  526. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  527. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  528. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  529. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  530. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  531. package/lib/module/AudioBrowser.js +2 -4
  532. package/lib/module/AudioBrowser.js.map +1 -1
  533. package/lib/module/CLAUDE.md +57 -0
  534. package/lib/module/features/battery.js +16 -12
  535. package/lib/module/features/battery.js.map +1 -1
  536. package/lib/module/features/browser-config.js +13 -9
  537. package/lib/module/features/browser-config.js.map +1 -1
  538. package/lib/module/features/browser.js +78 -20
  539. package/lib/module/features/browser.js.map +1 -1
  540. package/lib/module/features/carConnection.js +3 -4
  541. package/lib/module/features/carConnection.js.map +1 -1
  542. package/lib/module/features/equalizer.js +9 -5
  543. package/lib/module/features/equalizer.js.map +1 -1
  544. package/lib/module/features/errors.js +35 -21
  545. package/lib/module/features/errors.js.map +1 -1
  546. package/lib/module/features/favorites.js +28 -23
  547. package/lib/module/features/favorites.js.map +1 -1
  548. package/lib/module/features/gate.js +27 -6
  549. package/lib/module/features/gate.js.map +1 -1
  550. package/lib/module/features/metadata.js +59 -11
  551. package/lib/module/features/metadata.js.map +1 -1
  552. package/lib/module/features/network.js +5 -1
  553. package/lib/module/features/network.js.map +1 -1
  554. package/lib/module/features/nowPlaying.js +28 -14
  555. package/lib/module/features/nowPlaying.js.map +1 -1
  556. package/lib/module/features/output.js +9 -4
  557. package/lib/module/features/output.js.map +1 -1
  558. package/lib/module/features/playback/controls.js +13 -6
  559. package/lib/module/features/playback/controls.js.map +1 -1
  560. package/lib/module/features/playback/playWhenReady.js +6 -5
  561. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  562. package/lib/module/features/playback/playing.js +5 -3
  563. package/lib/module/features/playback/playing.js.map +1 -1
  564. package/lib/module/features/playback/progress.js +13 -6
  565. package/lib/module/features/playback/progress.js.map +1 -1
  566. package/lib/module/features/playback/rate.js +8 -1
  567. package/lib/module/features/playback/rate.js.map +1 -1
  568. package/lib/module/features/playback/state.js +5 -6
  569. package/lib/module/features/playback/state.js.map +1 -1
  570. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  571. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  572. package/lib/module/features/playback/volume.js +6 -5
  573. package/lib/module/features/playback/volume.js.map +1 -1
  574. package/lib/module/features/player/options.js +20 -10
  575. package/lib/module/features/player/options.js.map +1 -1
  576. package/lib/module/features/player/setup.js +44 -43
  577. package/lib/module/features/player/setup.js.map +1 -1
  578. package/lib/module/features/player/validateOptions.js +3 -4
  579. package/lib/module/features/player/validateOptions.js.map +1 -1
  580. package/lib/module/features/queue/activeTrack.js +14 -4
  581. package/lib/module/features/queue/activeTrack.js.map +1 -1
  582. package/lib/module/features/queue/queue.js +56 -21
  583. package/lib/module/features/queue/queue.js.map +1 -1
  584. package/lib/module/features/queue/repeatMode.js +2 -1
  585. package/lib/module/features/queue/repeatMode.js.map +1 -1
  586. package/lib/module/features/queue/shuffle.js +0 -1
  587. package/lib/module/features/queue/shuffle.js.map +1 -1
  588. package/lib/module/features/remoteControls.js +59 -35
  589. package/lib/module/features/remoteControls.js.map +1 -1
  590. package/lib/module/features/sleepTimer.js +24 -7
  591. package/lib/module/features/sleepTimer.js.map +1 -1
  592. package/lib/module/test-utils/reactNativeStub.js +58 -0
  593. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  594. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  595. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  596. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  597. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  598. package/lib/module/utils/getTrackIdentity.js +22 -0
  599. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  600. package/lib/module/utils/useDebug.js +16 -3
  601. package/lib/module/utils/useDebug.js.map +1 -1
  602. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  603. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  604. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  605. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  606. package/lib/module/web/NativeAudioBrowser.js +207 -84
  607. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  608. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  609. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  610. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  611. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  612. package/lib/module/web/TrackPlayer/Player.js +256 -40
  613. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  614. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  615. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  616. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  617. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  618. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  619. package/lib/module/web/browser/BrowserManager.js +175 -100
  620. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  621. package/lib/module/web/browser/FavoriteManager.js +31 -21
  622. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  623. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  624. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  625. package/lib/module/web/browser/SearchManager.js +18 -23
  626. package/lib/module/web/browser/SearchManager.js.map +1 -1
  627. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  628. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  629. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  630. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  631. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  632. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  633. package/lib/module/web/browser/sections.js +83 -0
  634. package/lib/module/web/browser/sections.js.map +1 -0
  635. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  636. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  637. package/lib/module/web/http/followMediaRedirect.js +215 -0
  638. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  639. package/lib/module/web/player/NowPlayingManager.js +4 -3
  640. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  641. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  642. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  643. package/lib/typescript/package.json +1 -0
  644. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  645. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  646. package/lib/typescript/src/features/battery.d.ts +17 -12
  647. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  648. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  649. package/lib/typescript/src/features/browser.d.ts +67 -19
  650. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  651. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  652. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  653. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  654. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  655. package/lib/typescript/src/features/errors.d.ts +37 -22
  656. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  657. package/lib/typescript/src/features/favorites.d.ts +28 -23
  658. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  659. package/lib/typescript/src/features/gate.d.ts +29 -8
  660. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  661. package/lib/typescript/src/features/metadata.d.ts +65 -14
  662. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  663. package/lib/typescript/src/features/network.d.ts +5 -1
  664. package/lib/typescript/src/features/network.d.ts.map +1 -1
  665. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  666. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  667. package/lib/typescript/src/features/output.d.ts +9 -4
  668. package/lib/typescript/src/features/output.d.ts.map +1 -1
  669. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  670. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  671. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  672. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  673. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  674. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  675. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  676. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  677. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  678. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  679. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  680. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  681. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  682. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  683. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  684. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  685. package/lib/typescript/src/features/player/options.d.ts +73 -56
  686. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  687. package/lib/typescript/src/features/player/setup.d.ts +129 -73
  688. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  689. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  690. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  691. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  692. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  693. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  694. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  695. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  696. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  697. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  698. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  699. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  700. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  701. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  702. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  703. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  704. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  705. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  706. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  707. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  708. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  709. package/lib/typescript/src/types/browser.d.ts +242 -173
  710. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  711. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  712. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  713. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  714. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  715. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  716. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  717. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  718. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  719. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  720. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  721. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  722. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  723. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  724. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  725. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  726. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  727. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  733. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  740. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  743. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  745. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  747. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  748. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  749. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  750. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  753. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  754. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  755. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  757. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  759. 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
  760. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  761. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  763. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  764. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  765. 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
  766. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  771. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  773. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  775. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  778. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  796. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  799. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  800. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  805. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  807. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  808. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  813. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  816. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  819. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  822. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  824. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  825. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  826. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  827. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  830. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  832. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  833. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  836. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  838. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  840. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  845. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  846. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  848. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  850. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  852. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  853. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  854. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  855. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  857. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  863. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  864. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  865. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  866. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  867. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  868. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  869. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  870. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  871. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  873. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  875. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  876. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  877. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  878. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  879. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  881. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  882. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  883. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  884. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  885. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  905. 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
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  912. 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
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  915. 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
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  918. 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
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1024. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1025. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1026. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1027. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1028. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1029. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1030. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1031. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1032. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1033. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1034. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1035. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1036. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1037. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1038. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1039. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1040. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1041. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1042. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1043. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1044. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1045. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1046. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1047. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1048. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1049. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1050. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1051. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1052. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1053. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1054. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1055. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1056. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1057. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1058. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1059. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1060. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1061. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1062. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1063. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1064. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1065. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1066. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1067. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1068. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1069. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1070. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1071. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1072. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1073. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1074. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1075. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1076. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1077. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1078. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1079. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1080. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1081. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1082. package/package.json +26 -13
  1083. package/src/AudioBrowser.ts +2 -4
  1084. package/src/CLAUDE.md +57 -0
  1085. package/src/docs-floors.test.ts +71 -0
  1086. package/src/features/battery.test.ts +79 -0
  1087. package/src/features/battery.ts +17 -13
  1088. package/src/features/browser-config.test.ts +21 -6
  1089. package/src/features/browser-config.ts +13 -9
  1090. package/src/features/browser.test.ts +1 -1
  1091. package/src/features/browser.ts +69 -20
  1092. package/src/features/carConnection.ts +3 -4
  1093. package/src/features/equalizer.ts +9 -5
  1094. package/src/features/errors.ts +37 -22
  1095. package/src/features/favorites.ts +28 -23
  1096. package/src/features/gate.ts +29 -8
  1097. package/src/features/hook-wiring.test.ts +302 -0
  1098. package/src/features/metadata.ts +80 -14
  1099. package/src/features/network.ts +5 -1
  1100. package/src/features/nowPlaying.ts +28 -14
  1101. package/src/features/output.ts +9 -4
  1102. package/src/features/playback/controls.ts +13 -6
  1103. package/src/features/playback/playWhenReady.ts +6 -5
  1104. package/src/features/playback/playing.ts +16 -3
  1105. package/src/features/playback/progress.test.ts +169 -0
  1106. package/src/features/playback/progress.ts +13 -6
  1107. package/src/features/playback/rate.ts +8 -1
  1108. package/src/features/playback/state.ts +10 -6
  1109. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1110. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1111. package/src/features/playback/volume.ts +6 -5
  1112. package/src/features/player/options.ts +81 -62
  1113. package/src/features/player/setup.test.ts +12 -3
  1114. package/src/features/player/setup.ts +141 -76
  1115. package/src/features/player/validateOptions.ts +3 -4
  1116. package/src/features/queue/activeTrack.ts +14 -4
  1117. package/src/features/queue/queue.ts +56 -21
  1118. package/src/features/queue/repeatMode.ts +1 -1
  1119. package/src/features/queue/shuffle.ts +0 -1
  1120. package/src/features/remoteControls.ts +59 -35
  1121. package/src/features/sleepTimer.test.ts +171 -0
  1122. package/src/features/sleepTimer.ts +24 -8
  1123. package/src/nitro-stub-drift.test.ts +277 -0
  1124. package/src/public-surface.test.ts +48 -24
  1125. package/src/specs/audio-browser.nitro.ts +15 -8
  1126. package/src/style-resolution.test.ts +210 -0
  1127. package/src/test-utils/reactNativeStub.ts +60 -0
  1128. package/src/types/browser-native.ts +7 -3
  1129. package/src/types/browser-nodes.ts +417 -151
  1130. package/src/types/browser.ts +248 -177
  1131. package/src/utils/LazyNativeEmitter.ts +17 -10
  1132. package/src/utils/NativeUpdatedValue.ts +30 -16
  1133. package/src/utils/getTrackIdentity.ts +22 -0
  1134. package/src/utils/useDebug.test.ts +182 -0
  1135. package/src/utils/useDebug.ts +16 -3
  1136. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1137. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1138. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1139. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1140. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1141. package/src/web/NativeAudioBrowser.ts +247 -92
  1142. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1143. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1144. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1145. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1146. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1147. package/src/web/TrackPlayer/Player.ts +286 -38
  1148. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1149. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1150. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1151. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1152. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1153. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1154. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1155. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1156. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1157. package/src/web/__tests__/retry.test.ts +169 -0
  1158. package/src/web/browser/BrowserManager.ts +209 -111
  1159. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1160. package/src/web/browser/FavoriteManager.ts +28 -23
  1161. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1162. package/src/web/browser/SearchManager.test.ts +75 -0
  1163. package/src/web/browser/SearchManager.ts +25 -28
  1164. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1165. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1166. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1167. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1168. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1169. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1170. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1171. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1172. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1173. package/src/web/browser/parseSearchResponse.ts +3 -4
  1174. package/src/web/browser/sections.test.ts +91 -0
  1175. package/src/web/browser/sections.ts +72 -0
  1176. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1177. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1178. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1179. package/src/web/http/followMediaRedirect.ts +253 -0
  1180. package/src/web/player/NowPlayingManager.ts +4 -3
  1181. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1182. package/src/web/util/BrowserPathHelper.ts +68 -13
  1183. package/website/guide/android-auto.md +126 -0
  1184. package/website/guide/android-certificates.md +488 -0
  1185. package/website/guide/artwork.md +300 -0
  1186. package/website/guide/audio-output.md +357 -0
  1187. package/website/guide/automotive.md +91 -0
  1188. package/website/guide/basic-usage.md +154 -0
  1189. package/website/guide/battery.md +142 -0
  1190. package/website/guide/browser.md +674 -0
  1191. package/website/guide/carplay.md +733 -0
  1192. package/website/guide/configuration.md +215 -0
  1193. package/website/guide/equalizer.md +235 -0
  1194. package/website/guide/errors.md +359 -0
  1195. package/website/guide/favorites.md +164 -0
  1196. package/website/guide/gate.md +157 -0
  1197. package/website/guide/getting-started.md +99 -0
  1198. package/website/guide/hooks.md +247 -0
  1199. package/website/guide/live-streams.md +189 -0
  1200. package/website/guide/metadata.md +289 -0
  1201. package/website/guide/migrating-from-track-player.md +289 -0
  1202. package/website/guide/native-callback-fetch.md +137 -0
  1203. package/website/guide/network.md +103 -0
  1204. package/website/guide/now-playing.md +203 -0
  1205. package/website/guide/playback.md +405 -0
  1206. package/website/guide/queue.md +334 -0
  1207. package/website/guide/remote-controls.md +314 -0
  1208. package/website/guide/search.md +270 -0
  1209. package/website/guide/sleep-timer.md +289 -0
  1210. package/website/guide/track.md +271 -0
  1211. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +0 -50
  1212. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1213. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +0 -40
  1214. package/ios/Bridge.h +0 -8
  1215. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1216. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1217. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1218. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1219. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1220. package/ios/Model/MediaURL.swift +0 -67
  1221. package/ios/Model/SourceType.swift +0 -6
  1222. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1223. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1224. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1225. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1226. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1227. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1228. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1229. package/ios/Option/PitchAlgorithms.swift +0 -17
  1230. package/ios/Option/TimeEventFrequency.swift +0 -18
  1231. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1232. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1233. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1234. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1235. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1236. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1237. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1238. package/ios/Player/PlaybackStateStore.swift +0 -27
  1239. package/ios/Player/PlayingStateManager.swift +0 -33
  1240. package/ios/Player/RetryManager.swift +0 -323
  1241. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1242. package/ios/Player/SleepTimerHandling.swift +0 -15
  1243. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1244. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1245. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1246. package/ios/Tests/MediaResolveTests.swift +0 -126
  1247. package/ios/Tests/OnceValueTests.swift +0 -79
  1248. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1249. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1250. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1251. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1252. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1253. package/ios/Tests/RetryManagerTests.swift +0 -89
  1254. package/ios/TrackPlayer.swift +0 -1014
  1255. package/ios/TrackPlayerCallbacks.swift +0 -53
  1256. package/ios/Util/MetadataAdapter.swift +0 -131
  1257. package/ios/Util/OnceValue.swift +0 -104
  1258. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1259. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1260. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1261. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1262. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1263. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1264. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1265. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1266. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1267. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1268. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1269. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1270. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1271. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -7,15 +7,19 @@ import type { AndroidUpdateOptions, IOSUpdateOptions, UpdateOptions } from './op
7
7
  * Parameters passed to the {@link FormatNowPlayingCallback}.
8
8
  *
9
9
  * The formatter owns every line shown on the now-playing surface — the track text, the live song,
10
- * *and* any transient status (reconnecting / error). The library no longer renders status copy
11
- * itself, so these fields give you what you need to render (and localize) it yourself. The formatter
10
+ * *and* any transient status (reconnecting / error). The library renders no status text; these
11
+ * fields let you render (and localize) it yourself. The formatter
12
12
  * is re-invoked on track change, each timed-metadata update, play/pause + error/rebuffer
13
13
  * transitions, and device connectivity changes.
14
14
  */
15
15
  export type FormatNowPlayingParams = {
16
16
  /** The currently playing track. */
17
17
  track: Track;
18
- /** Timed metadata (ICY / ID3 "now playing song") received during playback, if any. */
18
+ /**
19
+ * Timed metadata (ICY / ID3 "now playing song") received during playback, if any.
20
+ * On iOS, also a file's own tags when the file has no chapters.
21
+ * Always `undefined` on web — see `onTimedMetadata` for why.
22
+ */
19
23
  timedMetadata?: TimedMetadata;
20
24
  /** The play/pause intent — `false` while paused. Stays `true` through buffers, so the song line won't flicker. */
21
25
  playWhenReady: boolean;
@@ -42,44 +46,28 @@ export type StallReason = 'buffering' | 'offline';
42
46
  * Customizes what's rendered on the now-playing surface — lock screen, notification, Control Center,
43
47
  * CarPlay, and Android Auto — for the currently playing track.
44
48
  *
45
- * Configure it via {@link SetupPlayerOptions.nowPlaying}. Where the default behavior
46
- * simply publishes the track's own `title` / `artist`, the formatter hands you the two now-playing
47
- * text lines outright: render the live timed metadata (the ICY / ID3 "now playing song"), surface a
48
- * transient status line ("Reconnecting…", an error message), drop the song while paused — anything
49
- * you can derive from the {@link FormatNowPlayingParams} for that moment.
50
- *
51
- * The callback is **synchronous** and should stay cheap: it's a pure formatting function, run on the
52
- * JS thread and awaited natively. Don't do I/O in it. If you need asynchronously-fetched data (e.g.
53
- * album art), resolve it out-of-band and stamp it imperatively rather than awaiting inside here.
54
- *
55
- * ### When it's invoked
56
- * The player re-invokes the formatter whenever the now-playing could change:
57
- * - on track change (a new item becomes current);
58
- * - on each timed-metadata update ({@link FormatNowPlayingParams.timedMetadata} arrives or changes);
59
- * - on every playback transition — play / pause, a stall starting or recovering, an error.
49
+ * Configure it via {@link SetupPlayerOptions.nowPlaying}. It is re-invoked on track change, each
50
+ * timed-metadata update and every playback transition; identical results are de-duplicated
51
+ * natively, so they don't flicker the surface.
60
52
  *
61
- * Identical results are de-duplicated natively before they reach the media session, so returning the
62
- * same fields across a rapid burst of transitions is cheap and won't flicker the surface.
63
- *
64
- * ### What to return
65
- * Return a {@link NowPlayingUpdate} with the fields to display. Each field falls back **independently**
66
- * to the track's own value when omitted — so `{ artist: 'Some Song' }` replaces only the secondary
67
- * line and leaves the title as the track's title. Return `undefined` (or `{}`) to use the library
68
- * default entirely (the track's own `title` / `artist`).
69
- *
70
- * @param params - The current track, latest timed metadata, and playback signals for this moment
71
- * ({@link FormatNowPlayingParams}), including a {@link StallReason} that already classifies an
72
- * offline stall — no separate connectivity read needed for the now-playing line.
73
- * @returns The now-playing fields to display, or `undefined` to fall back to the track's own
74
- * `title` / `artist`.
53
+ * The callback is **synchronous**, run on the JS thread and awaited natively: no I/O in it.
54
+ * Each returned field falls back **independently** to the track's own value, so
55
+ * `{ artist: 'Some Song' }` replaces only the secondary line; `undefined` (or `{}`) keeps the
56
+ * track's own `title` / `artist`. See the [Now playing guide](https://audiobrowser.dev/guide/now-playing).
75
57
  *
76
58
  * @example
77
59
  * ```ts
78
60
  * setupPlayer({
79
61
  * nowPlaying: ({ timedMetadata, playWhenReady, stalled, error }) => {
80
62
  * if (error) return { artist: error.message ?? 'Playback error' }
81
- * if (stalled) return { artist: stalled === 'offline' ? 'No internet connection' : 'Reconnecting…' }
82
- * // Show the live song only while actually playing; otherwise fall back to the track default.
63
+ * if (stalled) {
64
+ * return {
65
+ * artist: stalled === 'offline'
66
+ * ? 'No internet connection'
67
+ * : 'Reconnecting…'
68
+ * }
69
+ * }
70
+ * // Show the live song only while playing; else use the track default.
83
71
  * if (!playWhenReady || !timedMetadata?.title) return
84
72
  * return {
85
73
  * artist: timedMetadata.artist
@@ -128,7 +116,8 @@ export type AndroidAudioContentType = 'music' | 'speech' | 'sonification' | 'mov
128
116
  * - `'ambient'`: The category for an app in which sound playback is nonprimary
129
117
  * — that is, your app also works with the sound turned off. See
130
118
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616560-ambient
131
- * - `'soloAmbient'`: The default audio session category. See
119
+ * - `'soloAmbient'`: The system's default audio session category; the library
120
+ * uses `'playback'` when `category` is omitted. See
132
121
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616488-soloambient
133
122
  * - `'record'`: The category for recording audio while also silencing playback
134
123
  * audio. See
@@ -202,17 +191,23 @@ export type IOSCategoryOptions = 'mixWithOthers' | 'duckOthers' | 'interruptSpok
202
191
  * https://developer.apple.com/documentation/avfoundation/avaudiosession/routesharingpolicy/longformvideo
203
192
  */
204
193
  export type IOSCategoryPolicy = 'default' | 'longFormAudio' | 'longFormVideo';
194
+ /**
195
+ * Requirements for Android audio offload; see `audioOffload`.
196
+ * @platform android
197
+ */
205
198
  export interface AndroidAudioOffloadSettings {
206
199
  /**
207
200
  * Whether gapless playback support is required for offload.
208
201
  * Enables smooth transitions between tracks without silence gaps.
209
- * @default true
202
+ * Omitting it here means not required; `audioOffload: true` requires it.
203
+ * @default false
210
204
  */
211
205
  gaplessSupportRequired?: boolean;
212
206
  /**
213
207
  * Whether playback rate change support is required for offload.
214
208
  * Enables variable playback speeds (0.5x, 1.25x, 2x, etc.) during offload.
215
- * @default true
209
+ * Omitting it here means not required; `audioOffload: true` requires it.
210
+ * @default false
216
211
  */
217
212
  rateChangeSupportRequired?: boolean;
218
213
  }
@@ -226,10 +221,11 @@ export interface AndroidAudioOffloadSettings {
226
221
  * `firstConnectMaxRetryDurationMs`. A stream that fails before ever playing
227
222
  * is usually dead, and the listener is actively waiting for a verdict —
228
223
  * seconds, not minutes.
229
- * - **Recovery** (the load played, then failed): retries are bounded by
230
- * `maxRetryDurationMs`. Playback proved the stream works; drops are usually
231
- * transient (tunnels, network handovers, a station's encoder restarting)
232
- * and patience is what recovers them unattended.
224
+ * - **Recovery**: the player gives up once it has been silent for
225
+ * `maxRetryDurationMs`; only 5 s of audio in a row ends a silence. Playback
226
+ * proved the stream works; drops are usually transient (tunnels, network
227
+ * handovers, a station's encoder restarting) and patience is what recovers
228
+ * them unattended.
233
229
  *
234
230
  * While the device is offline, the first-connect budget does not apply: the
235
231
  * player waits for connectivity to return (bounded by `maxRetryDurationMs`),
@@ -241,22 +237,26 @@ export interface AndroidAudioOffloadSettings {
241
237
  */
242
238
  export type RetryConfig = {
243
239
  /**
244
- * Maximum number of retry attempts before giving up. Omit to retry without an attempt
245
- * limit, bounded only by the duration budgets.
240
+ * The connections in a row that may deliver no audio before the player gives
241
+ * up. One that delivered audio starts the count over, so a stream that played
242
+ * and dropped reconnects once more than this. On Android, a failure media3
243
+ * retries within its connection (an HLS segment, a file of known length) is
244
+ * not a connection, and only the duration budgets bound it. Omit for no
245
+ * limit.
246
246
  */
247
247
  maxRetries?: number;
248
248
  /**
249
- * Maximum duration in milliseconds to keep retrying a load that had been
250
- * playing before it failed, and any load while the device is offline.
251
- * This prevents surprising playback resumption after long periods offline.
249
+ * How long in milliseconds the player may stay silent, the listener wanting
250
+ * audio and hearing none, before it gives up. Time offline counts, so
251
+ * playback never resumes by surprise after a long time offline.
252
252
  *
253
253
  * @default 120000 (2 minutes)
254
254
  */
255
255
  maxRetryDurationMs?: number;
256
256
  /**
257
- * Maximum duration in milliseconds to keep retrying a load that has never
258
- * produced audio, while the device is online. When it runs out, the terminal
259
- * error carries the real diagnosis (`unreachable`, `not-found`, …).
257
+ * How long in milliseconds a load that has never produced audio keeps
258
+ * retrying after its first failure while online. When it runs out, the
259
+ * terminal error carries the real diagnosis (`unreachable`, `not-found`, …).
260
260
  *
261
261
  * @default 12000 (12 seconds)
262
262
  */
@@ -280,8 +280,8 @@ export type AndroidPlayerWakeMode = 'none' | 'local' | 'network';
280
280
  export interface AndroidSetupOptions extends AndroidUpdateOptions {
281
281
  /**
282
282
  * Minimum duration of media that the player will attempt to buffer in ms.
283
+ * Has no effect: the player keeps loading until `maxBuffer` is buffered.
283
284
  *
284
- * @throws Will throw if min buffer is higher than max buffer.
285
285
  * @default 50000
286
286
  */
287
287
  minBuffer?: number;
@@ -293,17 +293,16 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
293
293
  *
294
294
  * - `true`: Enable with default settings (gapless + rate change support required)
295
295
  * - `false`/`undefined`: Disabled
296
- * - `{ gaplessSupportRequired: boolean, rateChangeSupportRequired: boolean }`:
297
- * Enable with specific requirements for gapless playback and playback rate changes
296
+ * - `{ gaplessSupportRequired?: boolean, rateChangeSupportRequired?: boolean }`:
297
+ * Enable with specific requirements for gapless playback and playback rate changes;
298
+ * an omitted field is not required, so `{}` enables offload with no requirements
298
299
  *
299
300
  * @default false
300
301
  */
301
302
  audioOffload?: boolean | AndroidAudioOffloadSettings;
302
303
  /**
303
304
  * Maximum duration of media that the player will attempt to buffer in ms.
304
- * Max buffer may not be lower than min buffer.
305
305
  *
306
- * @throws Will throw if max buffer is lower than min buffer.
307
306
  * @default 50000
308
307
  */
309
308
  maxBuffer?: number;
@@ -318,7 +317,7 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
318
317
  * Duration of media in ms that must be buffered for playback to start or
319
318
  * resume following a user action such as a seek.
320
319
  *
321
- * @default 2500
320
+ * @default 1000 (media3's `DEFAULT_BUFFER_FOR_PLAYBACK_MS`)
322
321
  */
323
322
  playBuffer?: number;
324
323
  /**
@@ -328,7 +327,6 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
328
327
  * When null (the default), uses automatic mode:
329
328
  * - Starts at `playBuffer` value
330
329
  * - On rebuffer, measures how fast the buffer drained
331
- * - Calculates how much buffer is needed to sustain 60s of playback
332
330
  * - Increases threshold accordingly (up to 8000ms max)
333
331
  * - Resets when changing tracks
334
332
  *
@@ -349,11 +347,11 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
349
347
  * The audio content type indicates to the android system how
350
348
  * you intend to use audio in your app.
351
349
  *
352
- * With `audioContentType: AndroidAudioContentType.Speech`, the audio will be
350
+ * With `audioContentType: 'speech'`, the audio will be
353
351
  * paused during short interruptions, such as when a message arrives.
354
352
  * Otherwise the playback volume is reduced while the notification is playing.
355
353
  *
356
- * @default AndroidAudioContentType.Music
354
+ * @default 'music'
357
355
  */
358
356
  audioContentType?: AndroidAudioContentType;
359
357
  /**
@@ -388,7 +386,10 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
388
386
  buffer?: number;
389
387
  /**
390
388
  * [AVAudioSession.Category](https://developer.apple.com/documentation/avfoundation/avaudiosession/1616615-category)
391
- * for iOS. Sets on `play()`.
389
+ * for iOS. Applied at `setupPlayer`; the session is activated when playback
390
+ * starts.
391
+ *
392
+ * @default 'playback'
392
393
  */
393
394
  category?: IOSCategory;
394
395
  /**
@@ -396,22 +397,54 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
396
397
  * indicates to the system how you intend to use audio in your app. You can use
397
398
  * a mode to configure the audio system for specific use cases such as video
398
399
  * recording, voice or video chat, or audio analysis.
399
- * Sets on `play()`.
400
+ * Applied at `setupPlayer`; the session is activated when playback starts.
400
401
  *
401
402
  * See https://developer.apple.com/documentation/avfoundation/avaudiosession/1616508-mode
403
+ *
404
+ * @default 'default'
402
405
  */
403
406
  categoryMode?: IOSCategoryMode;
404
407
  /**
405
408
  * [AVAudioSession.CategoryOptions](https://developer.apple.com/documentation/avfoundation/avaudiosession/1616503-categoryoptions) for iOS.
406
- * Sets on `play()`.
409
+ * Applied at `setupPlayer`; the session is activated when playback starts.
410
+ *
411
+ * @default []
407
412
  */
408
413
  categoryOptions?: IOSCategoryOptions[];
409
414
  /**
410
415
  * [AVAudioSession.RouteSharingPolicy](https://developer.apple.com/documentation/AVFAudio/AVAudioSession/RouteSharingPolicy-swift.enum) for iOS.
411
- * Sets on `play()`.
416
+ * Applied at `setupPlayer`; the session is activated when playback starts.
417
+ *
418
+ * @default 'default'
412
419
  */
413
420
  categoryPolicy?: IOSCategoryPolicy;
414
421
  }
422
+ /** Which remote outputs `setupPlayer({ remoteOutputs })` turns on. */
423
+ export interface RemoteOutputsOptions {
424
+ /**
425
+ * Plays on Cast devices selected in the Output Switcher, through the Default Media Receiver:
426
+ * the receiver fetches the track's media URL itself, so it gets the URL the media transform
427
+ * resolves, without its headers. Needs the app built with `AudioBrowser_castEnabled=true` in
428
+ * its `gradle.properties` and Google Play services on the device; without either, playback
429
+ * stays on the phone and a warning is logged.
430
+ * @default false
431
+ */
432
+ cast?: boolean;
433
+ /**
434
+ * The Cast receiver application `cast` loads, as registered in the Google Cast SDK Developer
435
+ * Console: a Styled Media Receiver shows the app's own name on the device and in its
436
+ * notifications. Cast takes it once per app process: a change takes effect after a restart.
437
+ * @default the Default Media Receiver, `'CC1AD845'`
438
+ */
439
+ castReceiverApplicationId?: string;
440
+ /**
441
+ * Plays on Sonos rooms selected in the Output Switcher, over the speakers' UPnP control: the
442
+ * speaker fetches the media URL the media transform resolves, without its headers. Sonos calls
443
+ * UPnP unsupported and lets the listener switch it off; then no rooms are listed.
444
+ * @default false
445
+ */
446
+ sonos?: boolean;
447
+ }
415
448
  /**
416
449
  * Public setup options: the full launch description of a player in one bag — engine
417
450
  * construction, runtime options (`capabilities`, jump intervals, …), and initial player state
@@ -440,20 +473,23 @@ export type SetupPlayerOptions = Pick<UpdateOptions, 'capabilities' | 'forwardJu
440
473
  /**
441
474
  * Retry policy for load errors (network failures, timeouts, etc.)
442
475
  * - `true`: Retry indefinitely with exponential backoff, under the default
443
- * duration budgets (12s before first audio, 2 minutes after — see
444
- * {@link RetryConfig})
445
- * - `false`/`undefined`: No automatic retry (default)
446
- * - `{ maxRetries: n }`: Retry up to n times with exponential backoff
476
+ * duration budgets of {@link RetryConfig}
477
+ * - `false`/`undefined`: no library retry. Android keeps media3's default
478
+ * handling, which retries a failed load a few times before surfacing the
479
+ * error; iOS fails at once.
480
+ * - `{ maxRetries: n }`: give up when a connection delivers no audio after
481
+ * n such connections in a row
447
482
  * - `RetryConfig`: custom attempt and duration budgets
448
483
  *
449
- * Exponential backoff delays: 1s → 1.5s → 2.3s → 3.4s → 5s (capped)
484
+ * Backoff timing and budgets: see the
485
+ * [Errors guide](https://audiobrowser.dev/guide/errors#two-duration-budgets).
450
486
  *
451
487
  * @default false
452
488
  */
453
489
  retry?: boolean | RetryConfig;
454
490
  /**
455
491
  * Keep the media session alive and controllable through a terminal playback error (e.g. a dead
456
- * stream), so external controllers (Android Auto / CarPlay) keep their transport controls
492
+ * stream), so External Surfaces such as Android Auto keep their transport controls
457
493
  * (next / previous) instead of tearing the session down. The error is still reported via
458
494
  * `onPlaybackError` / `playbackState`; this only affects what the OS media session observes.
459
495
  *
@@ -463,6 +499,22 @@ export type SetupPlayerOptions = Pick<UpdateOptions, 'capabilities' | 'forwardJu
463
499
  * @default true
464
500
  */
465
501
  keepSessionAliveOnError?: boolean;
502
+ /**
503
+ * Offers remote speakers and TVs in the system Output Switcher (`openOutputPicker`), and
504
+ * reports the selected one as the `Output`, with `type: 'remote'`, or `'cast'` for a Cast
505
+ * device and `'sonos'` for a Sonos room. `{}` reports the selection only: the library keeps
506
+ * playing locally, and rendering the audio on the speaker is the provider's job. The speakers
507
+ * come from media route providers that declare the library's remote-output control category
508
+ * (`RemoteOutputs.CATEGORY` on Android). The app declares AndroidX's `MediaTransferReceiver` in
509
+ * its manifest for the switcher to move the session.
510
+ *
511
+ * Each `setupPlayer` sets it: left out, remote outputs are off, and playback on one comes back
512
+ * to the phone.
513
+ *
514
+ * Android 11+; ignored on iOS, whose route picker already lists AirPlay devices.
515
+ * @default off
516
+ */
517
+ remoteOutputs?: RemoteOutputsOptions;
466
518
  /** Android-specific options: engine construction and runtime, merged. */
467
519
  android?: AndroidSetupOptions;
468
520
  /** iOS-specific options: audio session and runtime, merged. */
@@ -474,8 +526,7 @@ export type SetupPlayerOptions = Pick<UpdateOptions, 'capabilities' | 'forwardJu
474
526
  * - `true` (default): publish the track's own title / artist.
475
527
  * - `false`: don't manage the now-playing metadata at all.
476
528
  * - a {@link FormatNowPlayingCallback}: render it yourself — the callback owns every line,
477
- * including any transient status (buffering / reconnecting / offline / error), which the
478
- * library no longer renders on your behalf.
529
+ * including any transient status (buffering / reconnecting / offline / error).
479
530
  *
480
531
  * @default true
481
532
  */
@@ -488,9 +539,14 @@ export type SetupPlayerOptions = Pick<UpdateOptions, 'capabilities' | 'forwardJu
488
539
  * natively as part of setup itself, so there is no setup-then-command ordering for consumers
489
540
  * to know about, and no window where the player exists without its options.
490
541
  *
491
- * Calling it again reconfigures the player in place: newly provided fields are merged over
492
- * the previous ones, and the audio engine is rebuilt when construction-bound fields (buffers,
493
- * wake mode, …) changed.
542
+ * Calling it again is how a setup-only option changes after launch, and works differently per
543
+ * platform. On Android, newly provided fields are merged over the previous ones, except
544
+ * `remoteOutputs`, which is off when left out, and `nowPlaying`, which is on when left out
545
+ * and keeps an earlier formatter until a call passes another one. The audio engine is rebuilt
546
+ * only when construction-bound fields (buffers, wake mode, …) changed. On iOS, each call
547
+ * replaces the player: the queue is cleared, and setup-only fields you omit (`ios` session
548
+ * category and `buffer`, `retry`, …) go back to their defaults. Runtime options set earlier
549
+ * carry over on both.
494
550
  *
495
551
  * @param options - The options to initialize the player with.
496
552
  *
@@ -1 +1 @@
1
- {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../../src/features/player/setup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEhB,aAAa,EACd,MAAM,WAAW,CAAA;AAIlB;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAA;IACZ,sFAAsF;IACtF,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,kHAAkH;IAClH,aAAa,EAAE,OAAO,CAAA;IACtB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,sBAAsB,KAC3B,gBAAgB,GAAG,SAAS,CAAA;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,QAAQ,GACR,cAAc,GACd,OAAO,GACP,SAAS,CAAA;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,SAAS,GACT,aAAa,GACb,QAAQ,CAAA;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,UAAU,GACV,aAAa,GACb,eAAe,GACf,aAAa,GACb,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,CAAA;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,YAAY,GACZ,sCAAsC,GACtC,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,CAAA;AAEtB;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,eAAe,GAAG,eAAe,CAAA;AAE7E,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;;;;OAMG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAA;CACxC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,2BAA2B,CAAA;IAEpD;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;IAE1C;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAElC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CACjC;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAA;IAEtB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,eAAe,CAAA;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAEtC;;;OAGG;IACH,cAAc,CAAC,EAAE,iBAAiB,CAAA;CACnC;AA0DD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,aAAa,EACX,cAAc,GACd,qBAAqB,GACrB,sBAAsB,GACtB,6BAA6B,CAChC,GAAG;IACF;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;IAE7B;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IAEjC,yEAAyE;IACzE,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,eAAe,CAAA;IACrB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,wBAAwB,CAAA;CAChD,CAAA;AAiED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyDf"}
1
+ {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../../src/features/player/setup.ts"],"names":[],"mappings":"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"}
@@ -26,12 +26,18 @@ export declare function getActiveTrack(): Track | undefined;
26
26
  export declare function getActiveTrackIndex(): number | undefined;
27
27
  /**
28
28
  * Subscribes to active track change events.
29
- * @param callback - Called when the active track changes
29
+ *
30
+ * Fires on **transitions only** — selection, queue advance, skip. In-place
31
+ * metadata mutations of the active track (a favorite toggle) emit
32
+ * {@link onFavoriteChanged} instead; {@link useActiveTrack} subscribes to
33
+ * both, so UI bound through the hook still re-renders on a heart toggle.
34
+ *
30
35
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
31
36
  */
32
37
  export declare const onActiveTrackChanged: NativeUpdatedValue<PlaybackActiveTrackChangedEvent>;
33
38
  /**
34
- * Hook that returns the current active track and updates when it changes.
39
+ * Hook that returns the current active track, updating on transitions AND on
40
+ * in-place mutations of the active track (favorite toggles).
35
41
  * @returns The current active track or undefined
36
42
  */
37
43
  export declare function useActiveTrack(): Track | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"activeTrack.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/activeTrack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAGnE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAA;IACpB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAID;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,GAAG,SAAS,CAElD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAID;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qDAG9B,CAAA;AAIH;;;GAGG;AACH,wBAAgB,cAAc,IAAI,KAAK,GAAG,SAAS,CAElD"}
1
+ {"version":3,"file":"activeTrack.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/activeTrack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAInE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAA;IACpB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAID;;GAEG;AACH,wBAAgB,cAAc,IAAI,KAAK,GAAG,SAAS,CAElD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,qDAG9B,CAAA;AAOH;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,KAAK,GAAG,SAAS,CAElD"}
@@ -14,6 +14,8 @@ export interface PlaybackQueueEndedEvent {
14
14
  * @param tracks - The tracks to add to the queue.
15
15
  * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
16
16
  * By default the tracks will be added to the end of the queue.
17
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
18
+ * Android and the web treat `-1` as append; iOS throws on it.
17
19
  */
18
20
  export declare function add(tracks: Track[], insertBeforeIndex?: number): void;
19
21
  /**
@@ -21,69 +23,94 @@ export declare function add(tracks: Track[], insertBeforeIndex?: number): void;
21
23
  * @param track - The track to add to the queue.
22
24
  * @param insertBeforeIndex - (Optional) The index to insert the track before.
23
25
  * By default the track will be added to the end of the queue.
26
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
27
+ * Android and the web treat `-1` as append; iOS throws on it.
24
28
  */
25
29
  export declare function add(track: Track, insertBeforeIndex?: number): void;
26
30
  /**
27
31
  * Replaces the current track or loads the track as the first in the queue.
28
32
  * @param track - The track to load.
33
+ * @throws If called before `setupPlayer`.
29
34
  */
30
35
  export declare function load(track: Track): void;
31
36
  /**
32
37
  * Move a track within the queue.
33
38
  * @param fromIndex - The index of the track to be moved.
34
- * @param toIndex - The index to move the track to. If the index is larger than
35
- * the size of the queue, then the track is moved to the end of the queue.
39
+ * @param toIndex - The index to move the track to. On iOS and Android an index
40
+ * past the end moves the track to the end of the queue; the web throws.
41
+ * @throws If `fromIndex` is outside the queue or `toIndex` is negative (on the
42
+ * web, also if `toIndex` is past the last index).
36
43
  */
37
44
  export declare function move(fromIndex: number, toIndex: number): void;
38
45
  /**
39
46
  * Removes multiple tracks from the queue by their indexes.
40
47
  *
41
- * If the current track is removed, the next track will activated. If the
42
- * current track was the last track in the queue, the first track will be
43
- * activated.
48
+ * If the active track is removed, the track after it becomes active. On iOS
49
+ * and the web that is the next index, wrapping to the first track. On Android
50
+ * it is the next track in playback order (shuffle and repeat apply), and
51
+ * removing the last track with repeat `off` makes the first track active but
52
+ * ends playback.
44
53
  *
45
54
  * @param indexes - The indexes of the tracks to be removed.
55
+ * @throws If an index is outside the queue. Android checks every index before
56
+ * removing any, and also throws if an index appears twice. iOS removes from the
57
+ * highest index down, so an invalid index can throw after some tracks are gone,
58
+ * and a repeated index also removes the track that moved into its place. The
59
+ * web skips invalid and repeated indexes without throwing.
46
60
  */
47
61
  export declare function remove(indexes: number[]): void;
48
62
  /**
49
63
  * Removes a track from the queue by its index.
50
64
  *
51
- * If the current track is removed, the next track will activated. If the
52
- * current track was the last track in the queue, the first track will be
53
- * activated.
65
+ * If the active track is removed, the track after it becomes active. On iOS
66
+ * and the web that is the next index, wrapping to the first track. On Android
67
+ * it is the next track in playback order (shuffle and repeat apply), and
68
+ * removing the last track with repeat `off` makes the first track active but
69
+ * ends playback.
54
70
  *
55
71
  * @param index - The index of the track to be removed.
72
+ * @throws If `index` is outside the queue, on iOS and Android; the web
73
+ * ignores it.
56
74
  */
57
75
  export declare function remove(index: number): void;
58
76
  /**
59
- * Clears any upcoming tracks from the queue.
77
+ * Removes every track after the active track's index in the queue. With
78
+ * shuffle on, this is queue order, not the shuffled play order.
60
79
  */
61
80
  export declare function removeUpcomingTracks(): void;
62
81
  /**
63
82
  * Skips to a track in the queue.
64
83
  * @param index - The index of the track to skip to.
65
84
  * @param initialPosition - (Optional) The initial position to seek to in seconds.
85
+ * @throws If `index` is outside the queue.
66
86
  */
67
87
  export declare function skip(index: number, initialPosition?: number): void;
68
88
  /**
69
89
  * Skips to the next track in the queue.
70
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
90
+ * @param initialPosition - (Optional) The position in seconds to start the next
91
+ * track from. On iOS and Android, with no next track the active track seeks to
92
+ * it instead; on the web the call does nothing.
71
93
  */
72
94
  export declare function skipToNext(initialPosition?: number): void;
73
95
  /**
74
96
  * Skips to the previous track in the queue.
75
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
97
+ * @param initialPosition - (Optional) The position in seconds to start the
98
+ * previous track from. On iOS and Android, with no previous track the active
99
+ * track seeks to it instead; on the web the call does nothing.
76
100
  */
77
101
  export declare function skipToPrevious(initialPosition?: number): void;
78
102
  /**
79
103
  * Sets (replaces) the queue.
80
104
  *
81
- * This does not change the play/pause state: the player keeps playing if it was
82
- * playing and stays paused if it was paused. Call `play` explicitly to
83
- * start playback.
105
+ * On iOS and Android this does not change the play/pause state: the player
106
+ * keeps playing if it was playing and stays paused if it was paused. On the
107
+ * web it stops playback. Call `play` after it to start playback.
84
108
  *
85
109
  * @param tracks - The tracks to set as the queue.
86
110
  * @param startIndex - (Optional) The index of the track to make active.
111
+ * Defaults to 0 on iOS and Android; on the web, omitting it leaves no track
112
+ * active. iOS clamps an out-of-range index into the queue, Android throws, and
113
+ * the web ignores it.
87
114
  * @param startPosition - (Optional) The position in seconds to start the active track from.
88
115
  */
89
116
  export declare function setQueue(tracks: Track[], startIndex?: number, startPosition?: number): void;
@@ -98,20 +125,24 @@ export declare function getTrack(index: number): Track | undefined;
98
125
  */
99
126
  export declare function getQueue(): Track[];
100
127
  /**
101
- * Subscribes to playback queue ended events.
102
- * @param callback - Called when playback has paused due to reaching the end of the queue
128
+ * Subscribes to playback queue ended events: fires when the last track in
129
+ * playback order finishes with repeat mode `off` and the playback state
130
+ * becomes `ended`. Never fires under `track` or `queue` repeat.
103
131
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
104
132
  */
105
133
  export declare const onQueueEnded: NativeUpdatedValue<PlaybackQueueEndedEvent>;
106
134
  /**
107
135
  * Subscribes to queue change events.
108
- * Called when tracks are added, removed, reordered, or when track metadata changes.
109
- * @param callback - Called with the updated queue
136
+ * Called when tracks are added, removed, or reordered. On iOS and Android a
137
+ * favorite toggle also fires it, alongside `onFavoriteChanged`. On web a
138
+ * favorite toggle fires only `onFavoriteChanged`. {@link useQueue} subscribes
139
+ * to both.
110
140
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
111
141
  */
112
142
  export declare const onQueueChanged: NativeUpdatedValue<Track[]>;
113
143
  /**
114
- * Hook that returns the current queue and updates when it changes.
144
+ * Hook that returns the current queue, updating on queue changes AND on
145
+ * in-place mutations of queued tracks (favorite toggles).
115
146
  * @returns The current queue
116
147
  */
117
148
  export declare function useQueue(): Track[];
@@ -1 +1 @@
1
- {"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAA;CACjB;AAID;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;AACtE;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;AAQnE;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;AAC/C;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;AAO3C;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,KAAK,EAAE,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAEN;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,EAAE,CAElC;AAID;;;;GAIG;AACH,eAAO,MAAM,YAAY,6CAGtB,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,6BAE1B,CAAA;AAID;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,KAAK,EAAE,CAElC"}
1
+ {"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAMnE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAA;CACjB;AAID;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;AACtE;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;AAQnE;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;AAC/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;AAO3C;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,KAAK,EAAE,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAEN;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,EAAE,CAElC;AAID;;;;;GAKG;AACH,eAAO,MAAM,YAAY,6CAGtB,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,6BAE1B,CAAA;AAOD;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,KAAK,EAAE,CAElC"}
@@ -16,13 +16,13 @@ export declare function getRepeatMode(): RepeatMode;
16
16
  * @param repeatMode - The repeat mode to set
17
17
  */
18
18
  export declare function setRepeatMode(repeatMode: RepeatMode): void;
19
+ /** Event data for when the repeat mode changes. */
19
20
  export interface RepeatModeChangedEvent {
20
21
  /** The new repeat mode */
21
22
  repeatMode: RepeatMode;
22
23
  }
23
24
  /**
24
25
  * Subscribes to repeat mode changes.
25
- * @param callback - Called when repeat mode changes
26
26
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
27
27
  */
28
28
  export declare const onRepeatModeChanged: NativeUpdatedValue<RepeatModeChangedEvent>;
@@ -1 +1 @@
1
- {"version":3,"file":"repeatMode.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/repeatMode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;AAIlD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,QAEnD;AAID,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,4CAG7B,CAAA;AAIH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}
1
+ {"version":3,"file":"repeatMode.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/repeatMode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;AAIlD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,QAEnD;AAID,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,4CAG7B,CAAA;AAIH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}
@@ -15,7 +15,6 @@ export declare function setShuffle(enabled: boolean): void;
15
15
  export declare function toggleShuffle(): void;
16
16
  /**
17
17
  * Subscribes to shuffle mode changes.
18
- * @param callback - Called when shuffle mode changes
19
18
  * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
20
19
  */
21
20
  export declare const onShuffleChanged: NativeUpdatedValue<boolean>;
@@ -1 +1 @@
1
- {"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/shuffle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,6BAE5B,CAAA;AAID;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}
1
+ {"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../../../../src/features/queue/shuffle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAID;;;GAGG;AACH,eAAO,MAAM,gBAAgB,6BAE5B,CAAA;AAID;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}