react-native-audio-browser 0.2.0-next.6 → 0.2.0-next.61

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 (1213) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +550 -435
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +61 -72
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +334 -536
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +14 -31
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +96 -113
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +41 -35
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +123 -136
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +397 -562
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +63 -114
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +42 -101
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +690 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  118. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  119. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +201 -0
  121. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  122. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  123. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +158 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  129. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  130. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  131. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  132. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  133. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  134. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  135. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  137. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  138. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  139. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  140. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  141. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  142. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  143. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  144. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  145. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  146. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  147. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  149. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +223 -20
  150. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +45 -33
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  154. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  155. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +48 -0
  157. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  158. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  159. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +179 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  164. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +22 -65
  165. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  166. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  167. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  168. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  169. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  170. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +285 -0
  171. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  172. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  173. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  174. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  175. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  176. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  186. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  187. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  188. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  189. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  190. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  191. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  192. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  193. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  194. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  195. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  196. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  197. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  198. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  199. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  200. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  201. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  202. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  203. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  204. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  205. package/android/src/test/resources/sonos/device_description.xml +78 -0
  206. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  207. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  208. package/ios/AVPlayerEngine.swift +354 -0
  209. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  210. package/ios/Browser/BrowseGate.swift +57 -0
  211. package/ios/Browser/BrowserConfig.swift +123 -104
  212. package/ios/Browser/BrowserError.swift +15 -0
  213. package/ios/Browser/BrowserManager.swift +139 -676
  214. package/ios/Browser/BrowserPathHelper.swift +54 -117
  215. package/ios/Browser/FavoriteSet.swift +43 -0
  216. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  217. package/ios/Browser/JsonModels.swift +244 -335
  218. package/ios/Browser/NavigationErrorState.swift +42 -0
  219. package/ios/Browser/PageResolver.swift +137 -0
  220. package/ios/Browser/RequestLayer.swift +181 -0
  221. package/ios/Browser/RequestPipeline.swift +293 -0
  222. package/ios/Browser/SearchDrillIn.swift +11 -17
  223. package/ios/Browser/SectionScope.swift +73 -26
  224. package/ios/Browser/SimpleRouter.swift +76 -154
  225. package/ios/Browser/StyleResolver.swift +41 -0
  226. package/ios/Browser/TabBarEntries.swift +8 -7
  227. package/ios/Browser/TrackIdTemplate.swift +29 -0
  228. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  229. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  230. package/ios/CarPlay/CarPlayController.swift +37 -1297
  231. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  232. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  233. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  234. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  235. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  236. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  237. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  238. package/ios/CarPlay/CarPlaySession.swift +203 -0
  239. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  240. package/ios/CarPlay/IntentHandlers.swift +94 -0
  241. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  242. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  243. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  244. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  245. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  246. package/ios/CarPlay/SectionPresentation.swift +67 -0
  247. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  248. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  249. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  250. package/ios/Extension/CxxVectorConformances.swift +4 -16
  251. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  252. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  253. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  254. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  255. package/ios/Extension/SearchParams+Query.swift +28 -0
  256. package/ios/Extension/Section+Copying.swift +26 -0
  257. package/ios/Extension/String+IcyCharset.swift +21 -0
  258. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  259. package/ios/Extension/Track+AVPlayer.swift +1 -18
  260. package/ios/Extension/Track+Copying.swift +13 -21
  261. package/ios/Extension/Track+Identity.swift +20 -0
  262. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  263. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  264. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  265. package/ios/Extension/URLError+Connectivity.swift +15 -0
  266. package/ios/Extension/Variant+Artwork.swift +8 -22
  267. package/ios/Http/HttpClient.swift +73 -167
  268. package/ios/HybridAudioBrowser+Browser.swift +130 -0
  269. package/ios/HybridAudioBrowser+Options.swift +102 -0
  270. package/ios/HybridAudioBrowser+Player.swift +333 -0
  271. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  272. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  273. package/ios/HybridAudioBrowser.swift +138 -1684
  274. package/ios/Model/NitroTypeStubs.swift +240 -32
  275. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  276. package/ios/Model/RemoteCommand.swift +6 -60
  277. package/ios/Model/TrackPlayerError.swift +14 -23
  278. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  279. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  280. package/ios/Observer/ItemObserver.swift +92 -0
  281. package/ios/Observer/PlayerObserver.swift +59 -0
  282. package/ios/Option/SessionCategories.swift +42 -92
  283. package/ios/PlaybackEvent.swift +4 -2
  284. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  285. package/ios/Player/AudioSessionController.swift +190 -0
  286. package/ios/Player/DeferredSeek.swift +70 -0
  287. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  288. package/ios/Player/ErrorStatus.swift +52 -0
  289. package/ios/Player/MediaLoader.swift +73 -98
  290. package/ios/Player/NowPlayingLines.swift +49 -0
  291. package/ios/Player/NowPlayingUpdater.swift +176 -105
  292. package/ios/Player/PersistedPlaybackState.swift +1 -2
  293. package/ios/Player/PlaybackFailure.swift +121 -0
  294. package/ios/Player/PlaybackPersistence.swift +72 -0
  295. package/ios/Player/PlaybackStateMachine.swift +11 -11
  296. package/ios/Player/PlaybackTimer.swift +11 -8
  297. package/ios/Player/Player.swift +987 -0
  298. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  299. package/ios/Player/PlayerEngine.swift +104 -0
  300. package/ios/Player/PlayerStatusTypes.swift +1 -6
  301. package/ios/Player/QueueManager.swift +80 -98
  302. package/ios/Player/RetryLoop.swift +274 -0
  303. package/ios/Player/ShuffleOrder.swift +36 -43
  304. package/ios/Player/SleepTimerManager.swift +25 -42
  305. package/ios/Player/VolumeFader.swift +20 -15
  306. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  307. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  308. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  309. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  310. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  311. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  312. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  313. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  314. package/ios/Tests/DeferredSeekTests.swift +68 -0
  315. package/ios/Tests/EmitterTests.swift +22 -39
  316. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  317. package/ios/Tests/ErrorStatusTests.swift +50 -0
  318. package/ios/Tests/FavoriteSetTests.swift +61 -0
  319. package/ios/Tests/GenerationMemoTests.swift +121 -0
  320. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  321. package/ios/Tests/JsonModelsTests.swift +189 -3
  322. package/ios/Tests/LRUCacheTests.swift +106 -0
  323. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  324. package/ios/Tests/MediaLoaderTests.swift +38 -78
  325. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  326. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  327. package/ios/Tests/ObserverTests.swift +88 -0
  328. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  329. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  330. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  331. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  332. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  333. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  334. package/ios/Tests/PlayerPolicyTests.swift +461 -0
  335. package/ios/Tests/PlayerTests.swift +1542 -0
  336. package/ios/Tests/PlayingStateTests.swift +41 -0
  337. package/ios/Tests/QueueManagerTests.swift +205 -174
  338. package/ios/Tests/ReadyValueTests.swift +73 -0
  339. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  340. package/ios/Tests/RequestLayerTests.swift +228 -0
  341. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  342. package/ios/Tests/RetryLoopTests.swift +282 -0
  343. package/ios/Tests/SearchDrillInTests.swift +16 -17
  344. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  345. package/ios/Tests/SectionPresentationTests.swift +85 -0
  346. package/ios/Tests/SectionScopeTests.swift +136 -54
  347. package/ios/Tests/SimpleRouterTests.swift +39 -8
  348. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  349. package/ios/Tests/StyleResolverTests.swift +123 -0
  350. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  351. package/ios/Tests/Support/TestTypes.swift +135 -100
  352. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  353. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  354. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  355. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  356. package/ios/Tests/TrackIdentityTests.swift +20 -0
  357. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  358. package/ios/Tests/TrackSelectorTests.swift +157 -34
  359. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  360. package/ios/TrackSelector.swift +62 -77
  361. package/ios/Util/ArtworkFreshness.swift +42 -0
  362. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  363. package/ios/Util/ConcurrentMap.swift +19 -0
  364. package/ios/Util/Emitter.swift +45 -22
  365. package/ios/Util/GenerationMemo.swift +36 -0
  366. package/ios/Util/LRUCache.swift +23 -159
  367. package/ios/Util/NetworkMonitor.swift +31 -33
  368. package/ios/Util/OutputPicker.swift +48 -0
  369. package/ios/Util/ReadyValue.swift +57 -0
  370. package/ios/Util/SFSymbolRenderer.swift +64 -49
  371. package/ios/Util/SVGProcessor.swift +9 -16
  372. package/lib/commonjs/AudioBrowser.js +8 -8
  373. package/lib/commonjs/AudioBrowser.js.map +1 -1
  374. package/lib/commonjs/CLAUDE.md +57 -0
  375. package/lib/commonjs/features/battery.js +16 -12
  376. package/lib/commonjs/features/battery.js.map +1 -1
  377. package/lib/commonjs/features/browser-config.js +13 -9
  378. package/lib/commonjs/features/browser-config.js.map +1 -1
  379. package/lib/commonjs/features/browser.js +78 -20
  380. package/lib/commonjs/features/browser.js.map +1 -1
  381. package/lib/commonjs/features/carConnection.js +3 -4
  382. package/lib/commonjs/features/carConnection.js.map +1 -1
  383. package/lib/commonjs/features/equalizer.js +10 -6
  384. package/lib/commonjs/features/equalizer.js.map +1 -1
  385. package/lib/commonjs/features/errors.js +35 -21
  386. package/lib/commonjs/features/errors.js.map +1 -1
  387. package/lib/commonjs/features/favorites.js +29 -24
  388. package/lib/commonjs/features/favorites.js.map +1 -1
  389. package/lib/commonjs/features/gate.js +28 -7
  390. package/lib/commonjs/features/gate.js.map +1 -1
  391. package/lib/commonjs/features/metadata.js +33 -14
  392. package/lib/commonjs/features/metadata.js.map +1 -1
  393. package/lib/commonjs/features/network.js +6 -2
  394. package/lib/commonjs/features/network.js.map +1 -1
  395. package/lib/commonjs/features/nowPlaying.js +29 -15
  396. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  397. package/lib/commonjs/features/output.js +10 -5
  398. package/lib/commonjs/features/output.js.map +1 -1
  399. package/lib/commonjs/features/playback/controls.js +13 -6
  400. package/lib/commonjs/features/playback/controls.js.map +1 -1
  401. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  402. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  403. package/lib/commonjs/features/playback/playing.js +5 -3
  404. package/lib/commonjs/features/playback/playing.js.map +1 -1
  405. package/lib/commonjs/features/playback/progress.js +13 -6
  406. package/lib/commonjs/features/playback/progress.js.map +1 -1
  407. package/lib/commonjs/features/playback/rate.js +8 -1
  408. package/lib/commonjs/features/playback/rate.js.map +1 -1
  409. package/lib/commonjs/features/playback/state.js +5 -6
  410. package/lib/commonjs/features/playback/state.js.map +1 -1
  411. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  412. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  413. package/lib/commonjs/features/playback/volume.js +6 -5
  414. package/lib/commonjs/features/playback/volume.js.map +1 -1
  415. package/lib/commonjs/features/player/options.js +23 -29
  416. package/lib/commonjs/features/player/options.js.map +1 -1
  417. package/lib/commonjs/features/player/setup.js +41 -41
  418. package/lib/commonjs/features/player/setup.js.map +1 -1
  419. package/lib/commonjs/features/player/validateOptions.js +23 -0
  420. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  421. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  422. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  423. package/lib/commonjs/features/queue/queue.js +58 -23
  424. package/lib/commonjs/features/queue/queue.js.map +1 -1
  425. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  426. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  427. package/lib/commonjs/features/queue/shuffle.js +1 -2
  428. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  429. package/lib/commonjs/features/remoteControls.js +70 -125
  430. package/lib/commonjs/features/remoteControls.js.map +1 -1
  431. package/lib/commonjs/features/sleepTimer.js +28 -7
  432. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  433. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  434. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  435. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  436. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  437. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -12
  438. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  439. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  440. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  441. package/lib/commonjs/utils/useDebug.js +16 -3
  442. package/lib/commonjs/utils/useDebug.js.map +1 -1
  443. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  444. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  445. package/lib/commonjs/web/NativeAudioBrowser.js +204 -81
  446. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  447. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  448. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  449. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  450. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  452. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  453. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  454. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  455. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  456. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  457. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  458. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  459. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  460. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  461. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  462. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  463. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  465. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  466. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  467. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  468. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  469. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  470. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  471. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  472. package/lib/commonjs/web/browser/sections.js +89 -0
  473. package/lib/commonjs/web/browser/sections.js.map +1 -0
  474. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  475. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  476. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  477. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  478. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  479. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  480. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  481. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  482. package/lib/module/AudioBrowser.js +2 -1
  483. package/lib/module/AudioBrowser.js.map +1 -1
  484. package/lib/module/CLAUDE.md +57 -0
  485. package/lib/module/features/battery.js +16 -12
  486. package/lib/module/features/battery.js.map +1 -1
  487. package/lib/module/features/browser-config.js +13 -9
  488. package/lib/module/features/browser-config.js.map +1 -1
  489. package/lib/module/features/browser.js +78 -20
  490. package/lib/module/features/browser.js.map +1 -1
  491. package/lib/module/features/carConnection.js +3 -4
  492. package/lib/module/features/carConnection.js.map +1 -1
  493. package/lib/module/features/equalizer.js +10 -6
  494. package/lib/module/features/equalizer.js.map +1 -1
  495. package/lib/module/features/errors.js +35 -21
  496. package/lib/module/features/errors.js.map +1 -1
  497. package/lib/module/features/favorites.js +29 -24
  498. package/lib/module/features/favorites.js.map +1 -1
  499. package/lib/module/features/gate.js +28 -7
  500. package/lib/module/features/gate.js.map +1 -1
  501. package/lib/module/features/metadata.js +33 -14
  502. package/lib/module/features/metadata.js.map +1 -1
  503. package/lib/module/features/network.js +6 -2
  504. package/lib/module/features/network.js.map +1 -1
  505. package/lib/module/features/nowPlaying.js +29 -15
  506. package/lib/module/features/nowPlaying.js.map +1 -1
  507. package/lib/module/features/output.js +10 -5
  508. package/lib/module/features/output.js.map +1 -1
  509. package/lib/module/features/playback/controls.js +13 -6
  510. package/lib/module/features/playback/controls.js.map +1 -1
  511. package/lib/module/features/playback/playWhenReady.js +6 -5
  512. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  513. package/lib/module/features/playback/playing.js +5 -3
  514. package/lib/module/features/playback/playing.js.map +1 -1
  515. package/lib/module/features/playback/progress.js +13 -6
  516. package/lib/module/features/playback/progress.js.map +1 -1
  517. package/lib/module/features/playback/rate.js +8 -1
  518. package/lib/module/features/playback/rate.js.map +1 -1
  519. package/lib/module/features/playback/state.js +5 -6
  520. package/lib/module/features/playback/state.js.map +1 -1
  521. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  522. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  523. package/lib/module/features/playback/volume.js +6 -5
  524. package/lib/module/features/playback/volume.js.map +1 -1
  525. package/lib/module/features/player/options.js +22 -27
  526. package/lib/module/features/player/options.js.map +1 -1
  527. package/lib/module/features/player/setup.js +40 -40
  528. package/lib/module/features/player/setup.js.map +1 -1
  529. package/lib/module/features/player/validateOptions.js +19 -0
  530. package/lib/module/features/player/validateOptions.js.map +1 -0
  531. package/lib/module/features/queue/activeTrack.js +15 -5
  532. package/lib/module/features/queue/activeTrack.js.map +1 -1
  533. package/lib/module/features/queue/queue.js +58 -23
  534. package/lib/module/features/queue/queue.js.map +1 -1
  535. package/lib/module/features/queue/repeatMode.js +3 -2
  536. package/lib/module/features/queue/repeatMode.js.map +1 -1
  537. package/lib/module/features/queue/shuffle.js +1 -2
  538. package/lib/module/features/queue/shuffle.js.map +1 -1
  539. package/lib/module/features/remoteControls.js +70 -125
  540. package/lib/module/features/remoteControls.js.map +1 -1
  541. package/lib/module/features/sleepTimer.js +28 -7
  542. package/lib/module/features/sleepTimer.js.map +1 -1
  543. package/lib/module/test-utils/reactNativeStub.js +58 -0
  544. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  545. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  546. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  547. package/lib/module/utils/NativeUpdatedValue.js +31 -12
  548. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  549. package/lib/module/utils/getTrackIdentity.js +22 -0
  550. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  551. package/lib/module/utils/useDebug.js +16 -3
  552. package/lib/module/utils/useDebug.js.map +1 -1
  553. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  554. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  555. package/lib/module/web/NativeAudioBrowser.js +204 -81
  556. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  557. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  558. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  559. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  560. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  561. package/lib/module/web/TrackPlayer/Player.js +254 -39
  562. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  563. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  564. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  565. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  566. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  567. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  568. package/lib/module/web/browser/BrowserManager.js +175 -100
  569. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  570. package/lib/module/web/browser/FavoriteManager.js +31 -21
  571. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  572. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  573. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  574. package/lib/module/web/browser/SearchManager.js +18 -23
  575. package/lib/module/web/browser/SearchManager.js.map +1 -1
  576. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  577. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  578. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  579. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  580. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  581. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  582. package/lib/module/web/browser/sections.js +83 -0
  583. package/lib/module/web/browser/sections.js.map +1 -0
  584. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  585. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  586. package/lib/module/web/http/followMediaRedirect.js +215 -0
  587. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  588. package/lib/module/web/player/NowPlayingManager.js +4 -3
  589. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  590. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  591. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  592. package/lib/typescript/package.json +1 -0
  593. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  594. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  595. package/lib/typescript/src/features/battery.d.ts +17 -12
  596. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  597. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  598. package/lib/typescript/src/features/browser.d.ts +67 -19
  599. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  600. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  601. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  602. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  603. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  604. package/lib/typescript/src/features/errors.d.ts +37 -22
  605. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  606. package/lib/typescript/src/features/favorites.d.ts +29 -24
  607. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  608. package/lib/typescript/src/features/gate.d.ts +32 -10
  609. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  610. package/lib/typescript/src/features/metadata.d.ts +54 -17
  611. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  612. package/lib/typescript/src/features/network.d.ts +6 -2
  613. package/lib/typescript/src/features/network.d.ts.map +1 -1
  614. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  615. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  616. package/lib/typescript/src/features/output.d.ts +10 -5
  617. package/lib/typescript/src/features/output.d.ts.map +1 -1
  618. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  619. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  620. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  621. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  622. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  623. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  625. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  627. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  629. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  631. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  632. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  633. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  634. package/lib/typescript/src/features/player/options.d.ts +74 -57
  635. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  636. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  637. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  638. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  639. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  640. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  641. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  642. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  643. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  644. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  645. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  646. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  647. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  648. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  649. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  650. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  651. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  652. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  653. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  654. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  655. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  656. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  657. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  658. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  659. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  660. package/lib/typescript/src/types/browser.d.ts +242 -173
  661. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  662. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  663. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  664. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -18
  665. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  666. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  667. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  668. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  669. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  671. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  672. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  673. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  674. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  675. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  676. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  682. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  683. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  689. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  692. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  694. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  696. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  697. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  698. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  699. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  701. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  702. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  703. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  704. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  705. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  706. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  708. 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
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  713. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  714. 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
  715. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  718. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  720. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  722. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  724. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  725. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  727. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  745. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  748. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  749. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  754. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  756. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  757. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  762. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  765. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  768. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  771. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  773. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  774. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  775. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  776. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  779. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  782. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  785. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  787. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  789. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  797. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  801. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  804. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  812. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  816. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  817. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  818. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  822. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  824. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  825. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  826. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  828. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  830. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  831. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  832. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  833. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  834. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  854. 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
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  861. 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
  862. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  864. 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
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  867. 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
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  973. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  974. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  975. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  976. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  977. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  978. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  979. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  980. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  981. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  982. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  983. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  984. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  985. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  986. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  987. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  988. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  989. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  990. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  991. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  992. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  993. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  994. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  995. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  996. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  997. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  998. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  999. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1000. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1001. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1002. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1003. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1004. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1005. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1006. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1007. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1008. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1009. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1010. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1011. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1012. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1013. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1014. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  1015. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  1016. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1017. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1018. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1019. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1020. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1021. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1022. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1023. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1024. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1025. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1026. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1027. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1028. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1029. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1030. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1031. package/package.json +26 -12
  1032. package/src/AudioBrowser.ts +2 -1
  1033. package/src/CLAUDE.md +57 -0
  1034. package/src/docs-floors.test.ts +71 -0
  1035. package/src/features/battery.test.ts +79 -0
  1036. package/src/features/battery.ts +17 -13
  1037. package/src/features/browser-config.test.ts +21 -6
  1038. package/src/features/browser-config.ts +13 -9
  1039. package/src/features/browser.test.ts +1 -1
  1040. package/src/features/browser.ts +69 -20
  1041. package/src/features/carConnection.ts +3 -4
  1042. package/src/features/equalizer.ts +10 -6
  1043. package/src/features/errors.ts +37 -22
  1044. package/src/features/favorites.ts +29 -24
  1045. package/src/features/gate.ts +30 -9
  1046. package/src/features/hook-wiring.test.ts +302 -0
  1047. package/src/features/metadata.ts +54 -17
  1048. package/src/features/network.ts +6 -2
  1049. package/src/features/nowPlaying.ts +29 -15
  1050. package/src/features/output.ts +10 -5
  1051. package/src/features/playback/controls.ts +13 -6
  1052. package/src/features/playback/playWhenReady.ts +6 -5
  1053. package/src/features/playback/playing.ts +16 -3
  1054. package/src/features/playback/progress.test.ts +169 -0
  1055. package/src/features/playback/progress.ts +13 -6
  1056. package/src/features/playback/rate.ts +8 -1
  1057. package/src/features/playback/state.ts +10 -6
  1058. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1059. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1060. package/src/features/playback/volume.ts +6 -5
  1061. package/src/features/player/options.ts +83 -82
  1062. package/src/features/player/setup.test.ts +12 -3
  1063. package/src/features/player/setup.ts +123 -64
  1064. package/src/features/player/validateOptions.ts +21 -0
  1065. package/src/features/queue/activeTrack.ts +15 -5
  1066. package/src/features/queue/queue.ts +58 -23
  1067. package/src/features/queue/repeatMode.ts +2 -2
  1068. package/src/features/queue/shuffle.ts +1 -2
  1069. package/src/features/remoteControls.ts +70 -125
  1070. package/src/features/sleepTimer.test.ts +172 -0
  1071. package/src/features/sleepTimer.ts +24 -8
  1072. package/src/nitro-stub-drift.test.ts +277 -0
  1073. package/src/public-surface.test.ts +147 -0
  1074. package/src/specs/audio-browser.nitro.ts +10 -8
  1075. package/src/style-resolution.test.ts +210 -0
  1076. package/src/test-utils/reactNativeStub.ts +60 -0
  1077. package/src/types/browser-native.ts +7 -3
  1078. package/src/types/browser-nodes.ts +417 -151
  1079. package/src/types/browser.ts +248 -177
  1080. package/src/utils/LazyNativeEmitter.ts +25 -15
  1081. package/src/utils/NativeUpdatedValue.ts +29 -12
  1082. package/src/utils/getTrackIdentity.ts +22 -0
  1083. package/src/utils/useDebug.test.ts +182 -0
  1084. package/src/utils/useDebug.ts +16 -3
  1085. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  1086. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  1087. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1088. package/src/web/NativeAudioBrowser.ts +243 -88
  1089. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1090. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1091. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1092. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  1093. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1094. package/src/web/TrackPlayer/Player.ts +284 -37
  1095. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1096. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1097. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1098. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1099. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  1100. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1101. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1102. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1103. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1104. package/src/web/__tests__/retry.test.ts +169 -0
  1105. package/src/web/browser/BrowserManager.ts +209 -111
  1106. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1107. package/src/web/browser/FavoriteManager.ts +28 -23
  1108. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1109. package/src/web/browser/SearchManager.test.ts +75 -0
  1110. package/src/web/browser/SearchManager.ts +25 -28
  1111. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1112. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1113. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1114. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1115. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1116. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1117. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1118. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1119. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1120. package/src/web/browser/parseSearchResponse.ts +3 -4
  1121. package/src/web/browser/sections.test.ts +91 -0
  1122. package/src/web/browser/sections.ts +72 -0
  1123. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1124. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1125. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1126. package/src/web/http/followMediaRedirect.ts +253 -0
  1127. package/src/web/player/NowPlayingManager.ts +4 -3
  1128. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1129. package/src/web/util/BrowserPathHelper.ts +68 -13
  1130. package/website/guide/android-auto.md +126 -0
  1131. package/website/guide/android-certificates.md +488 -0
  1132. package/website/guide/artwork.md +300 -0
  1133. package/website/guide/audio-output.md +357 -0
  1134. package/website/guide/automotive.md +91 -0
  1135. package/website/guide/basic-usage.md +154 -0
  1136. package/website/guide/battery.md +142 -0
  1137. package/website/guide/browser.md +674 -0
  1138. package/website/guide/carplay.md +733 -0
  1139. package/website/guide/configuration.md +215 -0
  1140. package/website/guide/equalizer.md +235 -0
  1141. package/website/guide/errors.md +352 -0
  1142. package/website/guide/favorites.md +164 -0
  1143. package/website/guide/gate.md +157 -0
  1144. package/website/guide/getting-started.md +99 -0
  1145. package/website/guide/hooks.md +244 -0
  1146. package/website/guide/live-streams.md +156 -0
  1147. package/website/guide/metadata.md +273 -0
  1148. package/website/guide/migrating-from-track-player.md +289 -0
  1149. package/website/guide/native-callback-fetch.md +137 -0
  1150. package/website/guide/network.md +102 -0
  1151. package/website/guide/now-playing.md +203 -0
  1152. package/website/guide/playback.md +405 -0
  1153. package/website/guide/queue.md +334 -0
  1154. package/website/guide/remote-controls.md +314 -0
  1155. package/website/guide/search.md +270 -0
  1156. package/website/guide/sleep-timer.md +289 -0
  1157. package/website/guide/track.md +271 -0
  1158. package/ios/Bridge.h +0 -8
  1159. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1160. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1161. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1162. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1163. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1164. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1165. package/ios/Model/MediaURL.swift +0 -67
  1166. package/ios/Model/SourceType.swift +0 -6
  1167. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1168. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1169. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1170. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1171. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1172. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1173. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1174. package/ios/Option/PitchAlgorithms.swift +0 -17
  1175. package/ios/Option/TimeEventFrequency.swift +0 -18
  1176. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1177. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1178. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1179. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1180. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1181. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1182. package/ios/Player/PlaybackStateStore.swift +0 -27
  1183. package/ios/Player/PlayingStateManager.swift +0 -33
  1184. package/ios/Player/RetryManager.swift +0 -322
  1185. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1186. package/ios/Player/SleepTimerHandling.swift +0 -15
  1187. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1188. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1189. package/ios/Tests/MediaResolveTests.swift +0 -126
  1190. package/ios/Tests/OnceValueTests.swift +0 -79
  1191. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1192. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1193. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1194. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1195. package/ios/Tests/RetryManagerTests.swift +0 -89
  1196. package/ios/TrackPlayer.swift +0 -1014
  1197. package/ios/TrackPlayerCallbacks.swift +0 -86
  1198. package/ios/Util/MetadataAdapter.swift +0 -131
  1199. package/ios/Util/OnceValue.swift +0 -104
  1200. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1201. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1202. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1203. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1204. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1205. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1206. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1207. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1208. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1209. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1210. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1211. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1212. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1213. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -9,9 +9,10 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
9
9
  /**
10
10
  * Normalized, cross-platform classification of a playback failure.
11
11
  *
12
- * Both platforms map their native failure onto this set, so consumers can
13
- * branch on it without knowing whether the error came from AVFoundation or
14
- * ExoPlayer. Use this — not `code` — for anything user-visible.
12
+ * Every platform (AVFoundation on iOS, ExoPlayer on Android, Shaka on web)
13
+ * maps its native failure onto this set, so consumers can branch on it without
14
+ * knowing where the error came from. Use this — not `code` — for anything
15
+ * user-visible.
15
16
  *
16
17
  * - `'offline'` - The device had no network connection at the moment of
17
18
  * failure. The stream itself may be fine.
@@ -19,16 +20,21 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
19
20
  * connection refused, timed out, or the connection dropped while loading.
20
21
  * - `'not-found'` - The server said this stream is gone (HTTP 404 / 410).
21
22
  * Retrying will not help; the station is dead.
22
- * - `'rejected'` - The server refused the request (HTTP 401 / 403), e.g.
23
- * geo-blocking or an expired token.
23
+ * - `'rejected'` - The server refused the request: any HTTP 4xx other than
24
+ * 404 / 410 (auth, geo-blocking, rate limiting), a DRM or licence refusal
25
+ * (Android and web), or a region, account or parental-control refusal
26
+ * (Android).
24
27
  * - `'server-error'` - The server responded with 5xx. Usually transient.
25
- * - `'unplayable'` - The stream was fetched but cannot be played: unknown
26
- * container, unsupported codec, or a decoder failure.
28
+ * - `'unplayable'` - The stream cannot be played: an invalid source URL, a
29
+ * blocked cleartext URL (Android), an unknown container, an unsupported
30
+ * codec, or a decoder failure.
27
31
  * - `'stalled'` - Playback had started and then stopped, and the player
28
32
  * exhausted its recovery budget without recovering.
29
33
  * - `'unknown'` - The failure could not be classified. Inspect `code`.
30
34
  */
31
35
 
36
+ /** A classified playback failure: branch on `kind`, log `code`. */
37
+
32
38
  /**
33
39
  * Emitted when a playback error occurs.
34
40
  *
@@ -50,11 +56,15 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
50
56
  * Use this for business logic errors like authentication failures or subscription requirements.
51
57
  * - `'unknown-error'` - An unexpected error occurred (e.g., invalid configuration).
52
58
  * - `'empty-content'` - The path resolved successfully but the container has no children (e.g. an
53
- * empty Favorites tab, a search with no results).
59
+ * empty Favorites tab, a search with no results). Reaches only the `formatNavigationError`
60
+ * callback, for car-surface copy, never `useNavigationError`.
54
61
  * - `'timeout'` - The resolve did not complete within the allotted time (a stalled request or
55
- * unresponsive bridge). Surfaced on External surfaces that render their own browse list.
62
+ * unresponsive bridge). CarPlay only, and like `'empty-content'` it reaches only the
63
+ * `formatNavigationError` callback, never `useNavigationError`.
56
64
  */
57
65
 
66
+ /** A failed browse or search resolve. */
67
+
58
68
  /**
59
69
  * Emitted when a navigation error occurs.
60
70
  */
@@ -72,9 +82,9 @@ export function getPlaybackError() {
72
82
  // MARK: - Event Callbacks
73
83
 
74
84
  /**
75
- * Subscribes to playback error events.
76
- * @param callback - Called when a playback error occurs
77
- * @returns Cleanup function to unsubscribe
85
+ * Emits when the playback error is set or cleared (`error` is `undefined`
86
+ * when it clears). Subscribe with `addListener`, which returns the
87
+ * unsubscribe function.
78
88
  */
79
89
  export const onPlaybackError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onPlaybackError = cb);
80
90
 
@@ -100,9 +110,9 @@ export function getNavigationError() {
100
110
  }
101
111
 
102
112
  /**
103
- * Subscribes to navigation error events.
104
- * @param callback - Called when a navigation error occurs
105
- * @returns Cleanup function to unsubscribe
113
+ * Emits when the navigation error is set or cleared (`error` is `undefined`
114
+ * when it clears). Subscribe with `addListener`, which returns the
115
+ * unsubscribe function.
106
116
  */
107
117
  export const onNavigationError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onNavigationError = cb);
108
118
 
@@ -128,9 +138,8 @@ export function getFormattedNavigationError() {
128
138
  }
129
139
 
130
140
  /**
131
- * Subscribes to formatted navigation error changes.
132
- * @param callback - Called when the formatted navigation error changes
133
- * @returns Cleanup function to unsubscribe
141
+ * Emits each time the formatted navigation error changes. Subscribe with
142
+ * `addListener`, which returns the unsubscribe function.
134
143
  */
135
144
  export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => nativeBrowser.onFormattedNavigationError = cb);
136
145
 
@@ -138,10 +147,15 @@ export const onFormattedNavigationError = NativeUpdatedValue.emitterize(cb => na
138
147
  * Hook that returns the current navigation error formatted for display.
139
148
  *
140
149
  * Native formats the error using the `formatNavigationError` callback configured
141
- * in `BrowserConfiguration`, or falls back to default English messages.
150
+ * in `BrowserConfiguration`, or falls back to built-in English titles with the
151
+ * error's own message. An HTTP error's title is its status text,
152
+ * system-localized on iOS; on Android an English name for common codes. It is
153
+ * `Server Error` when there is no status code, for codes Android does not
154
+ * name, and always on web.
142
155
  *
143
- * The same formatted error is used by CarPlay and Android Auto error dialogs,
144
- * ensuring consistent error presentation across your app and external controllers.
156
+ * CarPlay and Android Auto format their own browse errors with the same
157
+ * `formatNavigationError` callback, so the copy matches across your app and
158
+ * the car.
145
159
  *
146
160
  * @returns Formatted error with title and message, or undefined if no error
147
161
  *
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlaybackError","onPlaybackError","emitterize","cb","usePlaybackError","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BH,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOL,qBAAqB,CAACC,gBAAgB,EAAEC,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,aAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BV,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACW,iBAAiB,GAAGL,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA,OAAO,SAASM,kBAAkBA,CAAA,EAAgC;EAChE,OAAOV,qBAAqB,CAACM,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,aAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,0BAA0B,GAAGb,kBAAkB,CAACI,UAAU,CAEpEC,EAAE,IAAMN,aAAa,CAACc,0BAA0B,GAAGR,EAAG,CAAC;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAqB,CAC1BW,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getPlaybackError","onPlaybackError","emitterize","cb","usePlaybackError","getNavigationError","error","undefined","onNavigationError","useNavigationError","getFormattedNavigationError","onFormattedNavigationError","useFormattedNavigationError"],"sourceRoot":"../../../src","sources":["features/errors.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;;AA+BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;;AAWA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BH,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAA8B;EAC5D,OAAOL,qBAAqB,CAACC,gBAAgB,EAAEC,eAAe,EAAE,OAAO,CAAC;AAC1E;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASI,kBAAkBA,CAAA,EAAgC;EAChE,MAAMC,KAAK,GAAGT,aAAa,CAACQ,kBAAkB,CAAC,CAAC;EAChD,OAAOC,KAAK,IAAIC,SAAS;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BV,kBAAkB,CAACI,UAAU,CAC1BC,EAAE,IAAMN,aAAa,CAACW,iBAAiB,GAAGL,EAC7C,CAAC;;AAEH;AACA;AACA;AACA;AACA,OAAO,SAASM,kBAAkBA,CAAA,EAAgC;EAChE,OAAOV,qBAAqB,CAACM,kBAAkB,EAAEG,iBAAiB,EAAE,OAAO,CAAC;AAC9E;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,aAAa,CAACa,2BAA2B,CAAC,CAAC,IAAIH,SAAS;AACjE;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMI,0BAA0B,GAAGb,kBAAkB,CAACI,UAAU,CAEpEC,EAAE,IAAMN,aAAa,CAACc,0BAA0B,GAAGR,EAAG,CAAC;;AAE1D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASS,2BAA2BA,CAAA,EAE7B;EACZ,OAAOb,qBAAqB,CAC1BW,2BAA2B,EAC3BC,0BACF,CAAC;AACH","ignoreList":[]}
@@ -6,12 +6,12 @@ import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
6
6
  // MARK: - Setters
7
7
 
8
8
  /**
9
- * Sets the favorited state of the currently playing track.
10
- * Updates the heart icon in media controllers (notification, Android Auto).
9
+ * Sets the favorited state of the Active Track.
10
+ * Updates the heart icon in media controllers (notification, Android Auto, CarPlay).
11
11
  *
12
- * Use this for programmatic favorite changes (e.g., from a favorite button in your app).
13
- * For heart button taps from media controllers, use `onFavoriteChanged` instead -
14
- * the native side handles those automatically.
12
+ * Use this for favorite changes from your app, such as a favorite button.
13
+ * It emits `onFavoriteChanged`, so persist the change there, not again in your
14
+ * button handler.
15
15
  *
16
16
  * @param favorited - Whether the track is favorited
17
17
  *
@@ -25,7 +25,7 @@ export function setActiveTrackFavorited(favorited) {
25
25
  }
26
26
 
27
27
  /**
28
- * Toggles the favorited state of the currently playing track.
28
+ * Toggles the favorited state of the Active Track. Emits `onFavoriteChanged`.
29
29
  *
30
30
  * @example
31
31
  * ```ts
@@ -38,26 +38,29 @@ export function toggleActiveTrackFavorited() {
38
38
  }
39
39
 
40
40
  /**
41
- * Sets the list of favorited track source identifiers.
41
+ * Sets the list of favorited track identifiers.
42
42
  *
43
43
  * This syncs your app's favorites with the native favorites cache, enabling
44
44
  * the heart button in media controllers (notification, Android Auto, CarPlay)
45
45
  * to show the correct state.
46
46
  *
47
- * Note: This is only needed if the tracks provided to AudioBrowser do not
48
- * include the `favorited` field. If your API already includes favorite state in
49
- * track responses, the native favorites cache is populated automatically during browsing.
47
+ * Each identifier is matched **exactly** against a track's *identity* — its
48
+ * `id` when set, falling back to `src`. Store favorites as the same stable
49
+ * identifier you put in `Track.id` (or as the full `src` for id-less tracks).
50
50
  *
51
- * When the heart button is tapped in media controllers or when you call
52
- * `setActiveTrackFavorited()`, the native favorites cache is automatically
53
- * updated. You only need to call this on app launch to hydrate the cache.
51
+ * A track whose response already carries `favorited` keeps that value on
52
+ * display surfaces — a caller-set flag wins over cache hydration. The cache
53
+ * itself is written only by this call and by heart toggles
54
+ * (`setActiveTrackFavorited()` / media-controller taps), so you only need to
55
+ * call this on app launch — and again whenever the collection changes outside
56
+ * the player (a sync from another device, say).
54
57
  *
55
- * @param favorites - Array of favorited track `src` values
58
+ * @param favorites - Array of favorited track identities (`id`, or `src` for id-less tracks)
56
59
  *
57
60
  * @example
58
61
  * ```ts
59
- * const favoriteSrcs = await loadFavoritesFromStorage()
60
- * setFavorites(favoriteSrcs)
62
+ * const favoriteIds = await loadFavoritesFromStorage()
63
+ * setFavorites(favoriteIds)
61
64
  * ```
62
65
  */
63
66
  export function setFavorites(favorites) {
@@ -67,17 +70,19 @@ export function setFavorites(favorites) {
67
70
  // MARK: - Event Callbacks
68
71
 
69
72
  /**
70
- * Event data for when the favorite state of the active track changes.
71
- * Emitted when the user taps the heart button in a media controller (notification, Android Auto, CarPlay).
73
+ * Event data for when the favorite state of the Active Track changes.
74
+ * Emitted on every change: a heart tap in a media controller (notification,
75
+ * Android Auto, CarPlay), a Siri request (iOS), `setActiveTrackFavorited` or
76
+ * `toggleActiveTrackFavorited`.
72
77
  */
73
78
 
74
79
  /**
75
- * Subscribes to favorite state change events.
76
- * Called when the user taps the heart button in a media controller.
77
- * The native side has already updated the track's favorite state and UI.
78
- *
79
- * @param callback - Called with the track and its new favorite state
80
- * @returns Cleanup function to unsubscribe
80
+ * Subscribes to favorite changes of the Active Track, with the track and its
81
+ * new favorite state. Fires on every change: a heart tap in a media controller,
82
+ * a Siri request (iOS), `setActiveTrackFavorited` or
83
+ * `toggleActiveTrackFavorited`. Persist favorites here, in one place. The
84
+ * native side has already updated the track's favorite state and UI.
85
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
81
86
  *
82
87
  * @example
83
88
  * ```ts
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","setActiveTrackFavorited","favorited","toggleActiveTrackFavorited","setFavorites","favorites","onFavoriteChanged","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/favorites.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,SAAkB,EAAQ;EAChEH,aAAa,CAACE,uBAAuB,CAACC,SAAS,CAAC;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAS;EACjDJ,aAAa,CAACI,0BAA0B,CAAC,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,SAAmB,EAAQ;EACtDN,aAAa,CAACK,YAAY,CAACC,SAAS,CAAC;AACvC;;AAEA;;AAEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACO,iBAAiB,GAAGE,EAC7C,CAAC","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","setActiveTrackFavorited","favorited","toggleActiveTrackFavorited","setFavorites","favorites","onFavoriteChanged","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/favorites.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,SAAkB,EAAQ;EAChEH,aAAa,CAACE,uBAAuB,CAACC,SAAS,CAAC;AAClD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CAAA,EAAS;EACjDJ,aAAa,CAACI,0BAA0B,CAAC,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACC,SAAmB,EAAQ;EACtDN,aAAa,CAACK,YAAY,CAACC,SAAS,CAAC;AACvC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAC5BN,kBAAkB,CAACO,UAAU,CAC1BC,EAAE,IAAMT,aAAa,CAACO,iBAAiB,GAAGE,EAC7C,CAAC","ignoreList":[]}
@@ -32,12 +32,15 @@ import { LazyNativeEmitter } from '../utils/LazyNativeEmitter';
32
32
  /**
33
33
  * A gate's chrome (title and optional message).
34
34
  *
35
- * While the gate is active, every browse or search request on car surfaces
36
- * (CarPlay, Android Auto) shows this page instead of the real content.
37
- * Playback, the queue, and now-playing are unaffected.
35
+ * While the gate is up, a gated browse or search on CarPlay or Android Auto
36
+ * shows this page instead of the content, and a gated voice search (Siri on
37
+ * iOS, Google Assistant on Android, including from the phone) is refused.
38
+ * Playback and the queue are unaffected.
38
39
  *
39
- * - **CarPlay**: plain centered message page.
40
- * - **Android Auto**: one non-playable list tile (message not shown).
40
+ * - **CarPlay**: plain centered message page. Now Playing keeps its transport
41
+ * controls but hides the `carPlayNowPlayingButtons`.
42
+ * - **Android Auto**: one non-playable list tile, with the title as its main
43
+ * line and the message as its subtitle.
41
44
  */
42
45
 
43
46
  /**
@@ -56,6 +59,8 @@ import { LazyNativeEmitter } from '../utils/LazyNativeEmitter';
56
59
  * - Return a {@link Gate} to gate with specific chrome for this request.
57
60
  * - Return `true` to gate using the default chrome (or the built-in fallback).
58
61
  * - Return `false` to allow the request through.
62
+ * - If the resolver throws, the request is gated (fails closed): only `false`
63
+ * lets a request through.
59
64
  */
60
65
 
61
66
  // MARK: - Internal state
@@ -110,12 +115,20 @@ nativeBrowser.resolveGate = async req => {
110
115
  * some surfaces (CarPlay) any gate change pops pushed navigation back to root,
111
116
  * so a page the user had drilled into is reset to the tab root. Set the gate
112
117
  * before the car connects and it'll be there the moment it does.
118
+ *
119
+ * @platform ios android
120
+ * A no-op on web, which has no CarPlay or Android Auto surfaces for the gate to
121
+ * cover. Nothing is lost: the gate never covered in-app browse UI on any
122
+ * platform — that stays yours to gate.
113
123
  */
114
124
 
115
125
  /**
116
126
  * Raises the gate with a resolver only (no default chrome).
117
127
  * The resolver must return a {@link Gate} or `true` for gated requests;
118
128
  * native uses the built-in fallback chrome when `true` and no default is set.
129
+ *
130
+ * @platform ios android
131
+ * A no-op on web — the resolver is never consulted there.
119
132
  */
120
133
 
121
134
  export function setGate(a, b) {
@@ -129,7 +142,11 @@ export function setGate(a, b) {
129
142
  }
130
143
 
131
144
  /**
132
- * Drops the gate — the real content comes back, and the current tab is kept.
145
+ * Drops the gate — the real content comes back. Android Auto keeps the current
146
+ * tab; CarPlay rebuilds its tab bar on the first tab.
147
+ *
148
+ * @platform ios android
149
+ * A no-op on web, where no gate was ever raised.
133
150
  */
134
151
  export function clearGate() {
135
152
  resolver = undefined;
@@ -138,7 +155,11 @@ export function clearGate() {
138
155
 
139
156
  /**
140
157
  * Subscribes to gate events (fired when a request is gated).
141
- * @returns Cleanup function to unsubscribe.
158
+ *
159
+ * @platform ios android
160
+ * Never fires on web — there are no gated serves to report.
161
+ *
162
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
142
163
  */
143
164
  export const onGate = LazyNativeEmitter.emitterize(cb => nativeBrowser.onGate = cb);
144
165
  //# sourceMappingURL=gate.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","LazyNativeEmitter","resolver","toPublicRequest","req","reason","kind","path","params","search","_exhaustive","Error","String","resolveGate","result","gated","gate","setGate","a","b","undefined","clearGate","onGate","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/gate.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,iBAAiB,QAAQ,4BAA4B;;AAE9D;;AAEA;;AAGA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA,IAAIC,QAAkC;AAEtC,SAASC,eAAeA,CAACC,GAAsB,EAAe;EAC5D,QAAQA,GAAG,CAACC,MAAM;IAChB,KAAK,QAAQ;MACX,OAAO;QAAEC,IAAI,EAAE,QAAQ;QAAEC,IAAI,EAAEH,GAAG,CAACG,IAAI,IAAI;MAAG,CAAC;IACjD,KAAK,QAAQ;MACX;MACA;MACA;MACA;MACA,OAAO;QAAED,IAAI,EAAE,QAAQ;QAAEE,MAAM,EAAEJ,GAAG,CAACK;MAAQ,CAAC;IAChD;MAAS;QACP,MAAMC,WAAkB,GAAGN,GAAG,CAACC,MAAM;QACrC,MAAM,IAAIM,KAAK,CAAC,yBAAyBC,MAAM,CAACF,WAAW,CAAC,EAAE,CAAC;MACjE;EACF;AACF;;AAEA;AACA;AACAV,aAAa,CAACa,WAAW,GAAG,MAC1BT,GAAsB,IACI;EAC1B,MAAMU,MAAM,GAAGZ,QAAQ,GAAGA,QAAQ,CAACC,eAAe,CAACC,GAAG,CAAC,CAAC,GAAG,IAAI;EAC/D,IAAIU,MAAM,KAAK,KAAK,EAAE,OAAO;IAAEC,KAAK,EAAE;EAAM,CAAC;EAC7C,IAAID,MAAM,KAAK,IAAI,EAAE,OAAO;IAAEC,KAAK,EAAE;EAAK,CAAC;EAC3C,OAAO;IAAEA,KAAK,EAAE,IAAI;IAAEC,IAAI,EAAEF;EAAO,CAAC;AACtC,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASG,OAAOA,CAACC,CAAsB,EAAEC,CAAgB,EAAQ;EACtE,IAAI,OAAOD,CAAC,KAAK,UAAU,EAAE;IAC3BhB,QAAQ,GAAGgB,CAAC;IACZlB,aAAa,CAACiB,OAAO,CAACG,SAAS,EAAE,IAAI,CAAC;EACxC,CAAC,MAAM;IACLlB,QAAQ,GAAGiB,CAAC;IACZnB,aAAa,CAACiB,OAAO,CAACC,CAAC,EAAEC,CAAC,IAAI,IAAI,CAAC;EACrC;AACF;;AAEA;AACA;AACA;AACA,OAAO,SAASE,SAASA,CAAA,EAAS;EAChCnB,QAAQ,GAAGkB,SAAS;EACpBpB,aAAa,CAACqB,SAAS,CAAC,CAAC;AAC3B;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMC,MAAM,GAAGrB,iBAAiB,CAACsB,UAAU,CAC/CC,EAAE,IAAMxB,aAAa,CAACsB,MAAM,GAAGE,EAClC,CAAC","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","LazyNativeEmitter","resolver","toPublicRequest","req","reason","kind","path","params","search","_exhaustive","Error","String","resolveGate","result","gated","gate","setGate","a","b","undefined","clearGate","onGate","emitterize","cb"],"sourceRoot":"../../../src","sources":["features/gate.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,iBAAiB,QAAQ,4BAA4B;;AAE9D;;AAEA;;AAGA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAEA,IAAIC,QAAkC;AAEtC,SAASC,eAAeA,CAACC,GAAsB,EAAe;EAC5D,QAAQA,GAAG,CAACC,MAAM;IAChB,KAAK,QAAQ;MACX,OAAO;QAAEC,IAAI,EAAE,QAAQ;QAAEC,IAAI,EAAEH,GAAG,CAACG,IAAI,IAAI;MAAG,CAAC;IACjD,KAAK,QAAQ;MACX;MACA;MACA;MACA;MACA,OAAO;QAAED,IAAI,EAAE,QAAQ;QAAEE,MAAM,EAAEJ,GAAG,CAACK;MAAQ,CAAC;IAChD;MAAS;QACP,MAAMC,WAAkB,GAAGN,GAAG,CAACC,MAAM;QACrC,MAAM,IAAIM,KAAK,CAAC,yBAAyBC,MAAM,CAACF,WAAW,CAAC,EAAE,CAAC;MACjE;EACF;AACF;;AAEA;AACA;AACAV,aAAa,CAACa,WAAW,GAAG,MAC1BT,GAAsB,IACI;EAC1B,MAAMU,MAAM,GAAGZ,QAAQ,GAAGA,QAAQ,CAACC,eAAe,CAACC,GAAG,CAAC,CAAC,GAAG,IAAI;EAC/D,IAAIU,MAAM,KAAK,KAAK,EAAE,OAAO;IAAEC,KAAK,EAAE;EAAM,CAAC;EAC7C,IAAID,MAAM,KAAK,IAAI,EAAE,OAAO;IAAEC,KAAK,EAAE;EAAK,CAAC;EAC3C,OAAO;IAAEA,KAAK,EAAE,IAAI;IAAEC,IAAI,EAAEF;EAAO,CAAC;AACtC,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASG,OAAOA,CAACC,CAAsB,EAAEC,CAAgB,EAAQ;EACtE,IAAI,OAAOD,CAAC,KAAK,UAAU,EAAE;IAC3BhB,QAAQ,GAAGgB,CAAC;IACZlB,aAAa,CAACiB,OAAO,CAACG,SAAS,EAAE,IAAI,CAAC;EACxC,CAAC,MAAM;IACLlB,QAAQ,GAAGiB,CAAC;IACZnB,aAAa,CAACiB,OAAO,CAACC,CAAC,EAAEC,CAAC,IAAI,IAAI,CAAC;EACrC;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,SAASA,CAAA,EAAS;EAChCnB,QAAQ,GAAGkB,SAAS;EACpBpB,aAAa,CAACqB,SAAS,CAAC,CAAC;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,MAAM,GAAGrB,iBAAiB,CAACsB,UAAU,CAC/CC,EAAE,IAAMxB,aAAa,CAACsB,MAAM,GAAGE,EAClC,CAAC","ignoreList":[]}
@@ -5,20 +5,23 @@ import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
5
5
 
6
6
  // MARK: - Types
7
7
 
8
+ /** The track fields {@link NowPlayingMetadata} carries. */
9
+
8
10
  /**
9
11
  * Metadata update for the now playing notification.
10
- * Pass to `updateNowPlaying()` to override what's shown in the notification/lock screen.
11
- * Pass `null` to clear overrides and revert to track metadata.
12
+ * Pass to `updateNowPlaying()` to override what's shown in the
13
+ * notification/lock screen; pass it `null` to clear the override.
12
14
  */
13
15
 
14
16
  /**
15
- * Timed metadata received during playback.
16
- * Contains metadata from ICY streams (radio) or ID3 frames.
17
+ * Timed metadata received during playback: ICY (radio) or ID3 frames.
18
+ * On iOS, also a file's own tags, once on load, when the file has no chapters.
17
19
  */
18
20
 
19
21
  /**
20
- * Static track metadata from the media file.
21
- * Contains standardized metadata fields.
22
+ * Static track metadata. On iOS, the media file's own tags. On Android,
23
+ * Media3's merged metadata, where the Track's fields and the now-playing lines win over
24
+ * the file's tags. `compilation` and `url` are never set.
22
25
  */
23
26
 
24
27
  /**
@@ -30,22 +33,38 @@ import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
30
33
 
31
34
  /**
32
35
  * Subscribes to chapter metadata events.
33
- * @param callback - Called when chapter metadata is received
34
- * @returns Cleanup function to unsubscribe
36
+ *
37
+ * @platform ios android
38
+ * Never fires on web — the web player does not read chapter markers. See
39
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
40
+ *
41
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
35
42
  */
36
43
  export const onChapterMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onChapterMetadata = cb);
37
44
 
38
45
  /**
39
- * Subscribes to track metadata events.
40
- * @param callback - Called when static track metadata is received
41
- * @returns Cleanup function to unsubscribe
46
+ * Subscribes to track metadata events. On iOS it fires once on load, when the
47
+ * file has tags. On Android it fires whenever the player's merged metadata
48
+ * changes.
49
+ *
50
+ * @platform ios android
51
+ * Never fires on web — the web player does not read embedded file tags. See
52
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
53
+ *
54
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
42
55
  */
43
56
  export const onTrackMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTrackMetadata = cb);
44
57
 
45
58
  /**
46
- * Subscribes to timed metadata events (ICY/ID3 from live streams).
47
- * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
48
- * @returns Cleanup function to unsubscribe
59
+ * Subscribes to timed metadata events (ICY/ID3 from live streams). On iOS it
60
+ * also fires on load with a file's own tags when the file has no chapters.
61
+ *
62
+ * @platform ios android
63
+ * Never fires on web: the browser strips ICY metadata before the player sees
64
+ * it, and the web player does not read in-band ID3 from HLS. See
65
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
66
+ *
67
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
49
68
  */
50
69
  export const onTimedMetadata = NativeUpdatedValue.emitterize(cb => nativeBrowser.onTimedMetadata = cb);
51
70
  //# sourceMappingURL=metadata.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","onChapterMetadata","emitterize","cb","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAyBA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;;AAoBA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,kBAAkB,CAACE,UAAU,CAE3DC,EAAE,IAAMJ,aAAa,CAACE,iBAAiB,GAAGE,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGJ,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACK,eAAe,GAAGD,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,eAAe,GAAGL,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACM,eAAe,GAAGF,EAC3C,CAAC","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","onChapterMetadata","emitterize","cb","onTrackMetadata","onTimedMetadata"],"sourceRoot":"../../../src","sources":["features/metadata.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;;AAEhE;;AAEA;;AAiCA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;;AA8BA;AACA;AACA;AACA;;AAYA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,kBAAkB,CAACE,UAAU,CAE3DC,EAAE,IAAMJ,aAAa,CAACE,iBAAiB,GAAGE,EAAG,CAAC;;AAEjD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGJ,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACK,eAAe,GAAGD,EAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,eAAe,GAAGL,kBAAkB,CAACE,UAAU,CACzDC,EAAE,IAAMJ,aAAa,CAACM,eAAe,GAAGF,EAC3C,CAAC","ignoreList":[]}
@@ -8,6 +8,8 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
8
8
 
9
9
  /**
10
10
  * Gets the current network connectivity state.
11
+ * On Android it reads `true` before `setupPlayer` has connected the player, and
12
+ * while its service restarts.
11
13
  * @returns true if the device is online, false otherwise
12
14
  */
13
15
  export function getOnline() {
@@ -18,8 +20,9 @@ export function getOnline() {
18
20
 
19
21
  /**
20
22
  * Subscribes to network connectivity changes.
21
- * @param callback - Called when network state changes
22
- * @returns Cleanup function to unsubscribe
23
+ * On Android it fires nothing until `setupPlayer` has connected the player, and then
24
+ * fires once with the current state.
25
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
23
26
  */
24
27
  export const onOnlineChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOnlineChanged = cb);
25
28
 
@@ -27,6 +30,7 @@ export const onOnlineChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser
27
30
 
28
31
  /**
29
32
  * Hook that returns the current network connectivity state and updates when it changes.
33
+ * On Android it reads `true` until `setupPlayer` has connected the player.
30
34
  * @returns true if the device is online, false otherwise
31
35
  */
32
36
  export function useOnline() {
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getOnline","onOnlineChanged","emitterize","cb","useOnline"],"sourceRoot":"../../../src","sources":["features/network.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAY;EACnC,OAAOH,aAAa,CAACG,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGH,kBAAkB,CAACI,UAAU,CACzDC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAY;EACnC,OAAOL,qBAAqB,CAACC,SAAS,EAAEC,eAAe,CAAC;AAC1D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","getOnline","onOnlineChanged","emitterize","cb","useOnline"],"sourceRoot":"../../../src","sources":["features/network.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAY;EACnC,OAAOH,aAAa,CAACG,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGH,kBAAkB,CAACI,UAAU,CACzDC,EAAE,IAAMN,aAAa,CAACI,eAAe,GAAGE,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAY;EACnC,OAAOL,qBAAqB,CAACC,SAAS,EAAEC,eAAe,CAAC;AAC1D","ignoreList":[]}
@@ -8,7 +8,11 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
8
8
 
9
9
  /**
10
10
  * Updates the now playing notification metadata.
11
- * Pass null/undefined to clear overrides and revert to track metadata.
11
+ *
12
+ * Lasts until you pass `null`, which clears it, or the active track changes. A `nowPlaying`
13
+ * formatter's fields win over it. With `nowPlaying: false` the iOS and
14
+ * Android surface ignores it, though `getNowPlaying` still reports it; web
15
+ * ignores `nowPlaying`.
12
16
  *
13
17
  * @example
14
18
  * ```ts
@@ -18,7 +22,7 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue';
18
22
  * artist: streamMetadata.artist,
19
23
  * })
20
24
  *
21
- * // Clear overrides, revert to track metadata
25
+ * // Clear the override
22
26
  * updateNowPlaying(null)
23
27
  * ```
24
28
  */
@@ -27,7 +31,10 @@ export function updateNowPlaying(update) {
27
31
  }
28
32
 
29
33
  /**
30
- * Gets the current now playing metadata (override if set, else track metadata).
34
+ * Returns what the now-playing surface shows: flash, formatter output,
35
+ * override or track fields, in that priority. `undefined` when there is no
36
+ * active track. With `nowPlaying: false`, it returns the flash, override or
37
+ * track fields, regardless of what the surface shows.
31
38
  */
32
39
  export function getNowPlaying() {
33
40
  return nativeBrowser.getNowPlaying() ?? undefined;
@@ -35,15 +42,19 @@ export function getNowPlaying() {
35
42
 
36
43
  /**
37
44
  * Temporarily replaces now-playing fields for `durationMs`, then reverts to
38
- * the live metadata. The flash outranks the now-playing formatter and the
39
- * `updateNowPlaying` override while active (live metadata can't stomp it),
40
- * and the revert runs on a native timer — JS timers pause in a backgrounded
41
- * host (the lock screen case) — so it fires reliably. A track change clears
42
- * the flash early; repeated calls restart the window.
45
+ * the live metadata. While active it outranks the `nowPlaying` formatter
46
+ * ({@link features/player!FormatNowPlayingCallback | FormatNowPlayingCallback}) and the `updateNowPlaying` override.
47
+ * The revert runs on a native timer, so it fires while the app is
48
+ * backgrounded. A track change clears the flash early; repeated calls
49
+ * restart the window.
50
+ *
51
+ * On web the flash is a plain `updateNowPlaying` override on a JS timer. It
52
+ * replaces any override you set, the revert clears the override instead of
53
+ * restoring it, and a track change does not cancel the timer, so the revert
54
+ * can also clear an override set for the next track. With
55
+ * `nowPlaying: false`, Android ignores the flash; iOS still shows it.
43
56
  *
44
- * The feedback channel for refused remote commands: external surfaces have
45
- * no toast primitive, so a transient metadata swap is the only way to talk
46
- * to the user there.
57
+ * See the [Now playing guide](https://audiobrowser.dev/guide/now-playing#the-flash-transient-top-priority).
47
58
  *
48
59
  * @example
49
60
  * ```ts
@@ -60,7 +71,8 @@ export function flashNowPlaying(update, durationMs) {
60
71
 
61
72
  /**
62
73
  * Clears an active flash immediately, reverting to the live metadata.
63
- * No-op when no flash is active.
74
+ * No-op when no flash is active. On web it also clears the
75
+ * `updateNowPlaying` override.
64
76
  */
65
77
  export function clearNowPlayingFlash() {
66
78
  nativeBrowser.clearNowPlayingFlash();
@@ -70,9 +82,11 @@ export function clearNowPlayingFlash() {
70
82
 
71
83
  /**
72
84
  * Subscribes to now playing metadata change events.
73
- * Fires when updateNowPlaying is called or when the track changes.
74
- * @param callback - Called when now playing metadata changes
75
- * @returns Cleanup function to unsubscribe
85
+ * Fires when the now-playing lines change: track change, `updateNowPlaying`,
86
+ * a flash starting or ending, or a new formatter result. On iOS and
87
+ * Android, an update that leaves the lines unchanged does not fire; on web
88
+ * every `updateNowPlaying` call, flash start and revert fires.
89
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
76
90
  */
77
91
  export const onNowPlayingChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onNowPlayingChanged = cb);
78
92
 
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateNowPlaying","update","undefined","getNowPlaying","flashNowPlaying","durationMs","clearNowPlayingFlash","onNowPlayingChanged","emitterize","cb","useNowPlaying"],"sourceRoot":"../../../src","sources":["features/nowPlaying.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,MAA+B,EAAQ;EACtEJ,aAAa,CAACG,gBAAgB,CAACC,MAAM,IAAIC,SAAS,CAAC;AACrD;;AAEA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAON,aAAa,CAACM,aAAa,CAAC,CAAC,IAAID,SAAS;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,eAAeA,CAC7BH,MAAwB,EACxBI,UAAkB,EACZ;EACNR,aAAa,CAACO,eAAe,CAACH,MAAM,EAAEI,UAAU,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAS;EAC3CT,aAAa,CAACS,oBAAoB,CAAC,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BT,kBAAkB,CAACU,UAAU,CAC1BC,EAAE,IAAMZ,aAAa,CAACU,mBAAmB,GAAGE,EAC/C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAOX,qBAAqB,CAACI,aAAa,EAAEI,mBAAmB,CAAC;AAClE","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","updateNowPlaying","update","undefined","getNowPlaying","flashNowPlaying","durationMs","clearNowPlayingFlash","onNowPlayingChanged","emitterize","cb","useNowPlaying"],"sourceRoot":"../../../src","sources":["features/nowPlaying.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;;AAEtE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,MAA+B,EAAQ;EACtEJ,aAAa,CAACG,gBAAgB,CAACC,MAAM,IAAIC,SAAS,CAAC;AACrD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAON,aAAa,CAACM,aAAa,CAAC,CAAC,IAAID,SAAS;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,eAAeA,CAC7BH,MAAwB,EACxBI,UAAkB,EACZ;EACNR,aAAa,CAACO,eAAe,CAACH,MAAM,EAAEI,UAAU,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAS;EAC3CT,aAAa,CAACS,oBAAoB,CAAC,CAAC;AACtC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAC9BT,kBAAkB,CAACU,UAAU,CAC1BC,EAAE,IAAMZ,aAAa,CAACU,mBAAmB,GAAGE,EAC/C,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAmC;EAC9D,OAAOX,qBAAqB,CAACI,aAAa,EAAEI,mBAAmB,CAAC;AAClE","ignoreList":[]}
@@ -31,9 +31,12 @@ export function supportsOutputSwitcher() {
31
31
 
32
32
  /**
33
33
  * The current audio output, or `undefined` when unknown. iOS reports one while a
34
- * session is active; Android reports the active output route via AudioManager
35
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
36
- * for `undefined`.
34
+ * session is active. Android reports the device media is routed to, from
35
+ * AudioManager, or the remote output selected in the Output Switcher when
36
+ * `remoteOutputs` is on. On Android 13+ (API 33) the route is exact and follows
37
+ * manual reroutes. Below that it is picked from the connected devices and misses
38
+ * a reroute while a device stays connected.
39
+ * Guard for `undefined`.
37
40
  */
38
41
  export function getOutput() {
39
42
  return nativeBrowser.getOutput();
@@ -43,8 +46,10 @@ export function getOutput() {
43
46
 
44
47
  /**
45
48
  * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
46
- * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
47
- * @returns Cleanup function to unsubscribe.
49
+ * connected, AirPlay/route selected). Fires on iOS and Android; never on web.
50
+ * On Android below 13 it cannot see a manual reroute between two connected
51
+ * devices.
52
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
48
53
  */
49
54
  export const onOutputChanged = NativeUpdatedValue.emitterize(cb => nativeBrowser.onOutputChanged = cb);
50
55
 
@@ -1 +1 @@
1
- {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","openOutputPicker","supportsOutputSwitcher","getOutput","onOutputChanged","emitterize","cb","useOutput"],"sourceRoot":"../../../src","sources":["features/output.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;AAItE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAS;EACvCH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOJ,aAAa,CAACI,sBAAsB,CAAC,CAAC;AAC/C;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOL,aAAa,CAACK,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGL,kBAAkB,CAACM,UAAU,CACzDC,EAAE,IAAMR,aAAa,CAACM,eAAe,GAAGE,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOP,qBAAqB,CAACG,SAAS,EAAEC,eAAe,CAAC;AAC1D","ignoreList":[]}
1
+ {"version":3,"names":["nativeBrowser","NativeUpdatedValue","useNativeUpdatedValue","openOutputPicker","supportsOutputSwitcher","getOutput","onOutputChanged","emitterize","cb","useOutput"],"sourceRoot":"../../../src","sources":["features/output.ts"],"mappings":";;AACA,SAASA,aAAa,QAAQ,WAAW;AACzC,SAASC,kBAAkB,QAAQ,6BAA6B;AAChE,SAASC,qBAAqB,QAAQ,gCAAgC;AAItE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAS;EACvCH,aAAa,CAACG,gBAAgB,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAY;EAChD,OAAOJ,aAAa,CAACI,sBAAsB,CAAC,CAAC;AAC/C;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOL,aAAa,CAACK,SAAS,CAAC,CAAC;AAClC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGL,kBAAkB,CAACM,UAAU,CACzDC,EAAE,IAAMR,aAAa,CAACM,eAAe,GAAGE,EAC3C,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAAA,EAAuB;EAC9C,OAAOP,qBAAqB,CAACG,SAAS,EAAEC,eAAe,CAAC;AAC1D","ignoreList":[]}
@@ -33,16 +33,20 @@ export function togglePlayback() {
33
33
  }
34
34
 
35
35
  /**
36
- * Stops playback and resets position to the beginning.
37
- * The track remains loaded and can be resumed with play().
38
- * For live streams, position is not reset.
36
+ * Stops playback. The track stays current, and play() starts it again.
37
+ * iOS rewinds a non-live track to the start; Android and web keep the
38
+ * position, so play() resumes where it stopped.
39
39
  */
40
40
  export function stop() {
41
41
  nativeBrowser.stop();
42
42
  }
43
43
 
44
44
  /**
45
- * Retries playing the current item when the playback state is `'error'`.
45
+ * Retries playing the current item. Meant for the `'error'` state, but not
46
+ * gated on it: on iOS it reloads the current item in any state, even while
47
+ * playing. On Android and web it reloads whenever the player is stopped or
48
+ * failed, without setting the play intent, so after stop() it loads the item
49
+ * but does not play it.
46
50
  *
47
51
  * @see {@link PlaybackState}
48
52
  * @see {@link usePlayback}
@@ -60,8 +64,11 @@ export function seekTo(position) {
60
64
  }
61
65
 
62
66
  /**
63
- * Jump to the live edge of the current track. No-op for non-live tracks; for
64
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
67
+ * Jump to the live edge of the current track; no-op unless the track
68
+ * declares `live: true`. A stream with a seekable live window (HLS) seeks
69
+ * to the window's edge; a non-seekable stream (e.g. ICY radio) reconnects
70
+ * to rejoin live. iOS re-runs `media.resolve` on the reconnect; Android
71
+ * reuses the resolved URL and re-resolves only after it fails to open.
65
72
  */
66
73
  export function seekToLiveEdge() {
67
74
  nativeBrowser.seekToLiveEdge();