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

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 (1211) 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 +543 -419
  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 +125 -133
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +396 -561
  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 +59 -113
  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 +682 -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 +150 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  157. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +179 -0
  159. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  162. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +22 -65
  163. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  164. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  165. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  166. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  167. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  168. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +279 -0
  169. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  170. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  171. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  172. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  173. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  174. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  175. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  176. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  186. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  187. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  188. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  189. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  190. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  191. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  192. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  193. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  194. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  195. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  196. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  197. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  198. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  199. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  200. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  201. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  202. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  203. package/android/src/test/resources/sonos/device_description.xml +78 -0
  204. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  205. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  206. package/ios/AVPlayerEngine.swift +354 -0
  207. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  208. package/ios/Browser/BrowseGate.swift +57 -0
  209. package/ios/Browser/BrowserConfig.swift +123 -104
  210. package/ios/Browser/BrowserError.swift +15 -0
  211. package/ios/Browser/BrowserManager.swift +139 -676
  212. package/ios/Browser/BrowserPathHelper.swift +54 -117
  213. package/ios/Browser/FavoriteSet.swift +43 -0
  214. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  215. package/ios/Browser/JsonModels.swift +244 -335
  216. package/ios/Browser/NavigationErrorState.swift +42 -0
  217. package/ios/Browser/PageResolver.swift +137 -0
  218. package/ios/Browser/RequestLayer.swift +181 -0
  219. package/ios/Browser/RequestPipeline.swift +293 -0
  220. package/ios/Browser/SearchDrillIn.swift +11 -17
  221. package/ios/Browser/SectionScope.swift +73 -26
  222. package/ios/Browser/SimpleRouter.swift +76 -154
  223. package/ios/Browser/StyleResolver.swift +41 -0
  224. package/ios/Browser/TabBarEntries.swift +8 -7
  225. package/ios/Browser/TrackIdTemplate.swift +29 -0
  226. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  227. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  228. package/ios/CarPlay/CarPlayController.swift +37 -1297
  229. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  230. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  231. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  232. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  233. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  234. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  235. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  236. package/ios/CarPlay/CarPlaySession.swift +203 -0
  237. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  238. package/ios/CarPlay/IntentHandlers.swift +94 -0
  239. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  240. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  241. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  242. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  243. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  244. package/ios/CarPlay/SectionPresentation.swift +67 -0
  245. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  246. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  247. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  248. package/ios/Extension/CxxVectorConformances.swift +4 -16
  249. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  250. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  251. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  252. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  253. package/ios/Extension/SearchParams+Query.swift +28 -0
  254. package/ios/Extension/Section+Copying.swift +26 -0
  255. package/ios/Extension/String+IcyCharset.swift +21 -0
  256. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  257. package/ios/Extension/Track+AVPlayer.swift +1 -18
  258. package/ios/Extension/Track+Copying.swift +13 -21
  259. package/ios/Extension/Track+Identity.swift +20 -0
  260. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  261. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  262. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  263. package/ios/Extension/URLError+Connectivity.swift +15 -0
  264. package/ios/Extension/Variant+Artwork.swift +8 -22
  265. package/ios/Http/HttpClient.swift +73 -167
  266. package/ios/HybridAudioBrowser+Browser.swift +130 -0
  267. package/ios/HybridAudioBrowser+Options.swift +102 -0
  268. package/ios/HybridAudioBrowser+Player.swift +333 -0
  269. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  270. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  271. package/ios/HybridAudioBrowser.swift +138 -1684
  272. package/ios/Model/NitroTypeStubs.swift +240 -32
  273. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  274. package/ios/Model/RemoteCommand.swift +6 -60
  275. package/ios/Model/TrackPlayerError.swift +14 -23
  276. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  277. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  278. package/ios/Observer/ItemObserver.swift +92 -0
  279. package/ios/Observer/PlayerObserver.swift +59 -0
  280. package/ios/Option/SessionCategories.swift +42 -92
  281. package/ios/PlaybackEvent.swift +2 -2
  282. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  283. package/ios/Player/AudioSessionController.swift +190 -0
  284. package/ios/Player/DeferredSeek.swift +70 -0
  285. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  286. package/ios/Player/ErrorStatus.swift +51 -0
  287. package/ios/Player/MediaLoader.swift +73 -98
  288. package/ios/Player/NowPlayingLines.swift +49 -0
  289. package/ios/Player/NowPlayingUpdater.swift +176 -105
  290. package/ios/Player/PersistedPlaybackState.swift +1 -2
  291. package/ios/Player/PlaybackFailure.swift +121 -0
  292. package/ios/Player/PlaybackPersistence.swift +72 -0
  293. package/ios/Player/PlaybackStateMachine.swift +8 -11
  294. package/ios/Player/PlaybackTimer.swift +11 -8
  295. package/ios/Player/Player.swift +968 -0
  296. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  297. package/ios/Player/PlayerEngine.swift +104 -0
  298. package/ios/Player/PlayerStatusTypes.swift +1 -6
  299. package/ios/Player/QueueManager.swift +80 -98
  300. package/ios/Player/RetryLoop.swift +280 -0
  301. package/ios/Player/ShuffleOrder.swift +36 -43
  302. package/ios/Player/SleepTimerManager.swift +25 -42
  303. package/ios/Player/VolumeFader.swift +20 -15
  304. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  305. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  306. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  307. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  308. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  309. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  310. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  311. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  312. package/ios/Tests/DeferredSeekTests.swift +68 -0
  313. package/ios/Tests/EmitterTests.swift +22 -39
  314. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  315. package/ios/Tests/ErrorStatusTests.swift +50 -0
  316. package/ios/Tests/FavoriteSetTests.swift +61 -0
  317. package/ios/Tests/GenerationMemoTests.swift +121 -0
  318. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  319. package/ios/Tests/JsonModelsTests.swift +189 -3
  320. package/ios/Tests/LRUCacheTests.swift +106 -0
  321. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  322. package/ios/Tests/MediaLoaderTests.swift +38 -78
  323. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  324. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  325. package/ios/Tests/ObserverTests.swift +88 -0
  326. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  327. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  328. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  329. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  330. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  331. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  332. package/ios/Tests/PlayerPolicyTests.swift +444 -0
  333. package/ios/Tests/PlayerTests.swift +1403 -0
  334. package/ios/Tests/PlayingStateTests.swift +41 -0
  335. package/ios/Tests/QueueManagerTests.swift +205 -174
  336. package/ios/Tests/ReadyValueTests.swift +73 -0
  337. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  338. package/ios/Tests/RequestLayerTests.swift +228 -0
  339. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  340. package/ios/Tests/RetryLoopTests.swift +282 -0
  341. package/ios/Tests/SearchDrillInTests.swift +16 -17
  342. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  343. package/ios/Tests/SectionPresentationTests.swift +85 -0
  344. package/ios/Tests/SectionScopeTests.swift +136 -54
  345. package/ios/Tests/SimpleRouterTests.swift +39 -8
  346. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  347. package/ios/Tests/StyleResolverTests.swift +123 -0
  348. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  349. package/ios/Tests/Support/TestTypes.swift +135 -100
  350. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  351. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  352. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  353. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  354. package/ios/Tests/TrackIdentityTests.swift +20 -0
  355. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  356. package/ios/Tests/TrackSelectorTests.swift +157 -34
  357. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  358. package/ios/TrackSelector.swift +62 -77
  359. package/ios/Util/ArtworkFreshness.swift +42 -0
  360. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  361. package/ios/Util/ConcurrentMap.swift +19 -0
  362. package/ios/Util/Emitter.swift +45 -22
  363. package/ios/Util/GenerationMemo.swift +36 -0
  364. package/ios/Util/LRUCache.swift +23 -159
  365. package/ios/Util/NetworkMonitor.swift +31 -33
  366. package/ios/Util/OutputPicker.swift +48 -0
  367. package/ios/Util/ReadyValue.swift +57 -0
  368. package/ios/Util/SFSymbolRenderer.swift +64 -49
  369. package/ios/Util/SVGProcessor.swift +9 -16
  370. package/lib/commonjs/AudioBrowser.js +8 -8
  371. package/lib/commonjs/AudioBrowser.js.map +1 -1
  372. package/lib/commonjs/CLAUDE.md +57 -0
  373. package/lib/commonjs/features/battery.js +16 -12
  374. package/lib/commonjs/features/battery.js.map +1 -1
  375. package/lib/commonjs/features/browser-config.js +13 -9
  376. package/lib/commonjs/features/browser-config.js.map +1 -1
  377. package/lib/commonjs/features/browser.js +78 -20
  378. package/lib/commonjs/features/browser.js.map +1 -1
  379. package/lib/commonjs/features/carConnection.js +3 -4
  380. package/lib/commonjs/features/carConnection.js.map +1 -1
  381. package/lib/commonjs/features/equalizer.js +10 -6
  382. package/lib/commonjs/features/equalizer.js.map +1 -1
  383. package/lib/commonjs/features/errors.js +35 -21
  384. package/lib/commonjs/features/errors.js.map +1 -1
  385. package/lib/commonjs/features/favorites.js +29 -24
  386. package/lib/commonjs/features/favorites.js.map +1 -1
  387. package/lib/commonjs/features/gate.js +28 -7
  388. package/lib/commonjs/features/gate.js.map +1 -1
  389. package/lib/commonjs/features/metadata.js +33 -14
  390. package/lib/commonjs/features/metadata.js.map +1 -1
  391. package/lib/commonjs/features/network.js +6 -2
  392. package/lib/commonjs/features/network.js.map +1 -1
  393. package/lib/commonjs/features/nowPlaying.js +29 -15
  394. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  395. package/lib/commonjs/features/output.js +10 -5
  396. package/lib/commonjs/features/output.js.map +1 -1
  397. package/lib/commonjs/features/playback/controls.js +13 -6
  398. package/lib/commonjs/features/playback/controls.js.map +1 -1
  399. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  400. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  401. package/lib/commonjs/features/playback/playing.js +5 -3
  402. package/lib/commonjs/features/playback/playing.js.map +1 -1
  403. package/lib/commonjs/features/playback/progress.js +13 -6
  404. package/lib/commonjs/features/playback/progress.js.map +1 -1
  405. package/lib/commonjs/features/playback/rate.js +8 -1
  406. package/lib/commonjs/features/playback/rate.js.map +1 -1
  407. package/lib/commonjs/features/playback/state.js +5 -6
  408. package/lib/commonjs/features/playback/state.js.map +1 -1
  409. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  410. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  411. package/lib/commonjs/features/playback/volume.js +6 -5
  412. package/lib/commonjs/features/playback/volume.js.map +1 -1
  413. package/lib/commonjs/features/player/options.js +23 -29
  414. package/lib/commonjs/features/player/options.js.map +1 -1
  415. package/lib/commonjs/features/player/setup.js +41 -41
  416. package/lib/commonjs/features/player/setup.js.map +1 -1
  417. package/lib/commonjs/features/player/validateOptions.js +23 -0
  418. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  419. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  420. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  421. package/lib/commonjs/features/queue/queue.js +58 -23
  422. package/lib/commonjs/features/queue/queue.js.map +1 -1
  423. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  424. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  425. package/lib/commonjs/features/queue/shuffle.js +1 -2
  426. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  427. package/lib/commonjs/features/remoteControls.js +70 -125
  428. package/lib/commonjs/features/remoteControls.js.map +1 -1
  429. package/lib/commonjs/features/sleepTimer.js +28 -7
  430. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  431. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  432. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  433. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  434. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  435. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -12
  436. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  437. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  438. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  439. package/lib/commonjs/utils/useDebug.js +16 -3
  440. package/lib/commonjs/utils/useDebug.js.map +1 -1
  441. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  442. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  443. package/lib/commonjs/web/NativeAudioBrowser.js +204 -81
  444. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  445. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  446. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  447. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  448. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  449. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  450. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  452. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  453. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  454. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  455. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  456. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  457. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  458. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  459. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  460. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  461. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  462. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  463. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  465. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  466. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  467. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  468. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  469. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  470. package/lib/commonjs/web/browser/sections.js +89 -0
  471. package/lib/commonjs/web/browser/sections.js.map +1 -0
  472. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  473. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  474. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  475. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  476. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  477. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  478. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  479. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  480. package/lib/module/AudioBrowser.js +2 -1
  481. package/lib/module/AudioBrowser.js.map +1 -1
  482. package/lib/module/CLAUDE.md +57 -0
  483. package/lib/module/features/battery.js +16 -12
  484. package/lib/module/features/battery.js.map +1 -1
  485. package/lib/module/features/browser-config.js +13 -9
  486. package/lib/module/features/browser-config.js.map +1 -1
  487. package/lib/module/features/browser.js +78 -20
  488. package/lib/module/features/browser.js.map +1 -1
  489. package/lib/module/features/carConnection.js +3 -4
  490. package/lib/module/features/carConnection.js.map +1 -1
  491. package/lib/module/features/equalizer.js +10 -6
  492. package/lib/module/features/equalizer.js.map +1 -1
  493. package/lib/module/features/errors.js +35 -21
  494. package/lib/module/features/errors.js.map +1 -1
  495. package/lib/module/features/favorites.js +29 -24
  496. package/lib/module/features/favorites.js.map +1 -1
  497. package/lib/module/features/gate.js +28 -7
  498. package/lib/module/features/gate.js.map +1 -1
  499. package/lib/module/features/metadata.js +33 -14
  500. package/lib/module/features/metadata.js.map +1 -1
  501. package/lib/module/features/network.js +6 -2
  502. package/lib/module/features/network.js.map +1 -1
  503. package/lib/module/features/nowPlaying.js +29 -15
  504. package/lib/module/features/nowPlaying.js.map +1 -1
  505. package/lib/module/features/output.js +10 -5
  506. package/lib/module/features/output.js.map +1 -1
  507. package/lib/module/features/playback/controls.js +13 -6
  508. package/lib/module/features/playback/controls.js.map +1 -1
  509. package/lib/module/features/playback/playWhenReady.js +6 -5
  510. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  511. package/lib/module/features/playback/playing.js +5 -3
  512. package/lib/module/features/playback/playing.js.map +1 -1
  513. package/lib/module/features/playback/progress.js +13 -6
  514. package/lib/module/features/playback/progress.js.map +1 -1
  515. package/lib/module/features/playback/rate.js +8 -1
  516. package/lib/module/features/playback/rate.js.map +1 -1
  517. package/lib/module/features/playback/state.js +5 -6
  518. package/lib/module/features/playback/state.js.map +1 -1
  519. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  520. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  521. package/lib/module/features/playback/volume.js +6 -5
  522. package/lib/module/features/playback/volume.js.map +1 -1
  523. package/lib/module/features/player/options.js +22 -27
  524. package/lib/module/features/player/options.js.map +1 -1
  525. package/lib/module/features/player/setup.js +40 -40
  526. package/lib/module/features/player/setup.js.map +1 -1
  527. package/lib/module/features/player/validateOptions.js +19 -0
  528. package/lib/module/features/player/validateOptions.js.map +1 -0
  529. package/lib/module/features/queue/activeTrack.js +15 -5
  530. package/lib/module/features/queue/activeTrack.js.map +1 -1
  531. package/lib/module/features/queue/queue.js +58 -23
  532. package/lib/module/features/queue/queue.js.map +1 -1
  533. package/lib/module/features/queue/repeatMode.js +3 -2
  534. package/lib/module/features/queue/repeatMode.js.map +1 -1
  535. package/lib/module/features/queue/shuffle.js +1 -2
  536. package/lib/module/features/queue/shuffle.js.map +1 -1
  537. package/lib/module/features/remoteControls.js +70 -125
  538. package/lib/module/features/remoteControls.js.map +1 -1
  539. package/lib/module/features/sleepTimer.js +28 -7
  540. package/lib/module/features/sleepTimer.js.map +1 -1
  541. package/lib/module/test-utils/reactNativeStub.js +58 -0
  542. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  543. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  544. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  545. package/lib/module/utils/NativeUpdatedValue.js +31 -12
  546. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  547. package/lib/module/utils/getTrackIdentity.js +22 -0
  548. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  549. package/lib/module/utils/useDebug.js +16 -3
  550. package/lib/module/utils/useDebug.js.map +1 -1
  551. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  552. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  553. package/lib/module/web/NativeAudioBrowser.js +204 -81
  554. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  555. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  556. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  557. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  558. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  559. package/lib/module/web/TrackPlayer/Player.js +254 -39
  560. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  561. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  562. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  563. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  564. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  565. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  566. package/lib/module/web/browser/BrowserManager.js +175 -100
  567. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  568. package/lib/module/web/browser/FavoriteManager.js +31 -21
  569. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  570. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  571. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  572. package/lib/module/web/browser/SearchManager.js +18 -23
  573. package/lib/module/web/browser/SearchManager.js.map +1 -1
  574. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  575. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  576. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  577. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  578. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  579. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  580. package/lib/module/web/browser/sections.js +83 -0
  581. package/lib/module/web/browser/sections.js.map +1 -0
  582. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  583. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  584. package/lib/module/web/http/followMediaRedirect.js +215 -0
  585. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  586. package/lib/module/web/player/NowPlayingManager.js +4 -3
  587. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  588. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  589. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  590. package/lib/typescript/package.json +1 -0
  591. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  592. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  593. package/lib/typescript/src/features/battery.d.ts +17 -12
  594. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  595. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  596. package/lib/typescript/src/features/browser.d.ts +67 -19
  597. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  598. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  599. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  600. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  601. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  602. package/lib/typescript/src/features/errors.d.ts +37 -22
  603. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  604. package/lib/typescript/src/features/favorites.d.ts +29 -24
  605. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  606. package/lib/typescript/src/features/gate.d.ts +32 -10
  607. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  608. package/lib/typescript/src/features/metadata.d.ts +54 -17
  609. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  610. package/lib/typescript/src/features/network.d.ts +6 -2
  611. package/lib/typescript/src/features/network.d.ts.map +1 -1
  612. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  613. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  614. package/lib/typescript/src/features/output.d.ts +10 -5
  615. package/lib/typescript/src/features/output.d.ts.map +1 -1
  616. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  617. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  618. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  619. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  620. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  621. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  622. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  623. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  625. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  627. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  629. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  631. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  632. package/lib/typescript/src/features/player/options.d.ts +74 -57
  633. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  634. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  635. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  636. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  637. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  638. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  639. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  640. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  641. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  642. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  643. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  644. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  645. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  646. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  647. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  649. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  650. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  651. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  652. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  653. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  654. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  655. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  656. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  657. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  658. package/lib/typescript/src/types/browser.d.ts +242 -173
  659. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  660. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  661. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  662. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -18
  663. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  664. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  665. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  666. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  667. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  669. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  671. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  672. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  673. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  674. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  680. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  681. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  682. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  687. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  692. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  694. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  695. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  696. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  697. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  700. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  701. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  702. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  703. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  704. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  706. 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
  707. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  712. 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
  713. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  722. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  743. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  746. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  747. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  752. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  754. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  755. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  760. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  763. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  766. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  769. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  771. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  772. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  773. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  774. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  777. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  780. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  783. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  785. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  787. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  795. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  799. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  802. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  810. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  814. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  815. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  816. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  820. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  822. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  823. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  826. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  828. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  829. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  830. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  831. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  832. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  852. 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
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  859. 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
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  862. 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
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  865. 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
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  971. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  972. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  973. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  974. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  975. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  976. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  977. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  978. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  979. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  980. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  981. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  982. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  983. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  984. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  985. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  986. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  987. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  988. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  989. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  990. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  991. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  992. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  993. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  994. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  995. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  996. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  997. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  998. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  999. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1000. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1001. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1002. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1003. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1004. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1005. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1006. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1007. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1008. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1009. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1010. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1011. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1012. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  1013. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  1014. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1015. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1016. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1017. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1018. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1020. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1021. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1022. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1023. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1024. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1025. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1026. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1027. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1028. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1029. package/package.json +26 -12
  1030. package/src/AudioBrowser.ts +2 -1
  1031. package/src/CLAUDE.md +57 -0
  1032. package/src/docs-floors.test.ts +71 -0
  1033. package/src/features/battery.test.ts +79 -0
  1034. package/src/features/battery.ts +17 -13
  1035. package/src/features/browser-config.test.ts +21 -6
  1036. package/src/features/browser-config.ts +13 -9
  1037. package/src/features/browser.test.ts +1 -1
  1038. package/src/features/browser.ts +69 -20
  1039. package/src/features/carConnection.ts +3 -4
  1040. package/src/features/equalizer.ts +10 -6
  1041. package/src/features/errors.ts +37 -22
  1042. package/src/features/favorites.ts +29 -24
  1043. package/src/features/gate.ts +30 -9
  1044. package/src/features/hook-wiring.test.ts +302 -0
  1045. package/src/features/metadata.ts +54 -17
  1046. package/src/features/network.ts +6 -2
  1047. package/src/features/nowPlaying.ts +29 -15
  1048. package/src/features/output.ts +10 -5
  1049. package/src/features/playback/controls.ts +13 -6
  1050. package/src/features/playback/playWhenReady.ts +6 -5
  1051. package/src/features/playback/playing.ts +16 -3
  1052. package/src/features/playback/progress.test.ts +169 -0
  1053. package/src/features/playback/progress.ts +13 -6
  1054. package/src/features/playback/rate.ts +8 -1
  1055. package/src/features/playback/state.ts +10 -6
  1056. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1057. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1058. package/src/features/playback/volume.ts +6 -5
  1059. package/src/features/player/options.ts +83 -82
  1060. package/src/features/player/setup.test.ts +12 -3
  1061. package/src/features/player/setup.ts +123 -64
  1062. package/src/features/player/validateOptions.ts +21 -0
  1063. package/src/features/queue/activeTrack.ts +15 -5
  1064. package/src/features/queue/queue.ts +58 -23
  1065. package/src/features/queue/repeatMode.ts +2 -2
  1066. package/src/features/queue/shuffle.ts +1 -2
  1067. package/src/features/remoteControls.ts +70 -125
  1068. package/src/features/sleepTimer.test.ts +172 -0
  1069. package/src/features/sleepTimer.ts +24 -8
  1070. package/src/nitro-stub-drift.test.ts +277 -0
  1071. package/src/public-surface.test.ts +147 -0
  1072. package/src/specs/audio-browser.nitro.ts +10 -8
  1073. package/src/style-resolution.test.ts +210 -0
  1074. package/src/test-utils/reactNativeStub.ts +60 -0
  1075. package/src/types/browser-native.ts +7 -3
  1076. package/src/types/browser-nodes.ts +417 -151
  1077. package/src/types/browser.ts +248 -177
  1078. package/src/utils/LazyNativeEmitter.ts +25 -15
  1079. package/src/utils/NativeUpdatedValue.ts +29 -12
  1080. package/src/utils/getTrackIdentity.ts +22 -0
  1081. package/src/utils/useDebug.test.ts +182 -0
  1082. package/src/utils/useDebug.ts +16 -3
  1083. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  1084. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  1085. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1086. package/src/web/NativeAudioBrowser.ts +243 -88
  1087. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1088. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1089. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1090. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  1091. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1092. package/src/web/TrackPlayer/Player.ts +284 -37
  1093. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1094. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1095. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1096. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1097. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  1098. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1099. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1100. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1101. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1102. package/src/web/__tests__/retry.test.ts +169 -0
  1103. package/src/web/browser/BrowserManager.ts +209 -111
  1104. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1105. package/src/web/browser/FavoriteManager.ts +28 -23
  1106. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1107. package/src/web/browser/SearchManager.test.ts +75 -0
  1108. package/src/web/browser/SearchManager.ts +25 -28
  1109. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1110. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1111. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1112. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1113. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1114. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1115. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1116. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1117. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1118. package/src/web/browser/parseSearchResponse.ts +3 -4
  1119. package/src/web/browser/sections.test.ts +91 -0
  1120. package/src/web/browser/sections.ts +72 -0
  1121. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1122. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1123. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1124. package/src/web/http/followMediaRedirect.ts +253 -0
  1125. package/src/web/player/NowPlayingManager.ts +4 -3
  1126. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1127. package/src/web/util/BrowserPathHelper.ts +68 -13
  1128. package/website/guide/android-auto.md +126 -0
  1129. package/website/guide/android-certificates.md +488 -0
  1130. package/website/guide/artwork.md +300 -0
  1131. package/website/guide/audio-output.md +357 -0
  1132. package/website/guide/automotive.md +91 -0
  1133. package/website/guide/basic-usage.md +154 -0
  1134. package/website/guide/battery.md +142 -0
  1135. package/website/guide/browser.md +674 -0
  1136. package/website/guide/carplay.md +733 -0
  1137. package/website/guide/configuration.md +215 -0
  1138. package/website/guide/equalizer.md +235 -0
  1139. package/website/guide/errors.md +352 -0
  1140. package/website/guide/favorites.md +164 -0
  1141. package/website/guide/gate.md +157 -0
  1142. package/website/guide/getting-started.md +99 -0
  1143. package/website/guide/hooks.md +244 -0
  1144. package/website/guide/live-streams.md +156 -0
  1145. package/website/guide/metadata.md +273 -0
  1146. package/website/guide/migrating-from-track-player.md +289 -0
  1147. package/website/guide/native-callback-fetch.md +137 -0
  1148. package/website/guide/network.md +102 -0
  1149. package/website/guide/now-playing.md +203 -0
  1150. package/website/guide/playback.md +405 -0
  1151. package/website/guide/queue.md +334 -0
  1152. package/website/guide/remote-controls.md +314 -0
  1153. package/website/guide/search.md +270 -0
  1154. package/website/guide/sleep-timer.md +289 -0
  1155. package/website/guide/track.md +271 -0
  1156. package/ios/Bridge.h +0 -8
  1157. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1158. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1159. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1160. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1161. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1162. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1163. package/ios/Model/MediaURL.swift +0 -67
  1164. package/ios/Model/SourceType.swift +0 -6
  1165. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1166. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1167. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1168. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1169. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1170. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1171. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1172. package/ios/Option/PitchAlgorithms.swift +0 -17
  1173. package/ios/Option/TimeEventFrequency.swift +0 -18
  1174. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1175. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1176. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1177. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1178. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1179. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1180. package/ios/Player/PlaybackStateStore.swift +0 -27
  1181. package/ios/Player/PlayingStateManager.swift +0 -33
  1182. package/ios/Player/RetryManager.swift +0 -322
  1183. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1184. package/ios/Player/SleepTimerHandling.swift +0 -15
  1185. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1186. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1187. package/ios/Tests/MediaResolveTests.swift +0 -126
  1188. package/ios/Tests/OnceValueTests.swift +0 -79
  1189. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1190. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1191. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1192. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1193. package/ios/Tests/RetryManagerTests.swift +0 -89
  1194. package/ios/TrackPlayer.swift +0 -1014
  1195. package/ios/TrackPlayerCallbacks.swift +0 -86
  1196. package/ios/Util/MetadataAdapter.swift +0 -131
  1197. package/ios/Util/OnceValue.swift +0 -104
  1198. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1199. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1200. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1201. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1202. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1203. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1204. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1205. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1206. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1207. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1208. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1209. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1210. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1211. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -3,6 +3,7 @@ import { NativeUpdatedValue } from '../utils/NativeUpdatedValue'
3
3
 
4
4
  // MARK: - Types
5
5
 
6
+ /** The track fields {@link NowPlayingMetadata} carries. */
6
7
  export interface TrackMetadataBase {
7
8
  /** The track title */
8
9
  title?: string
@@ -16,20 +17,29 @@ export interface TrackMetadataBase {
16
17
  artwork?: string
17
18
  /** track description */
18
19
  description?: string
19
- /** track mediaId */
20
+ /**
21
+ * The track's `src`, or its `path` when it has none, on iOS and Android.
22
+ * On web, the track's Identity (`id` when set, else `src`), or its `path`:
23
+ * a track with an `id` reports different values on web and native.
24
+ */
20
25
  mediaId?: string
21
26
  /** The track genre */
22
27
  genre?: string
23
28
  }
24
29
 
25
30
  export interface NowPlayingMetadata extends TrackMetadataBase {
31
+ /**
32
+ * Playback position in seconds when this metadata was emitted or read, not
33
+ * a live value. iOS only; absent on Android and web. For a live position use
34
+ * `useProgress`.
35
+ */
26
36
  elapsedTime?: number
27
37
  }
28
38
 
29
39
  /**
30
40
  * Metadata update for the now playing notification.
31
- * Pass to `updateNowPlaying()` to override what's shown in the notification/lock screen.
32
- * Pass `null` to clear overrides and revert to track metadata.
41
+ * Pass to `updateNowPlaying()` to override what's shown in the
42
+ * notification/lock screen; pass it `null` to clear the override.
33
43
  */
34
44
  export type NowPlayingUpdate = {
35
45
  /** Title shown in notification */
@@ -45,8 +55,8 @@ export type NowPlayingUpdate = {
45
55
  }
46
56
 
47
57
  /**
48
- * Timed metadata received during playback.
49
- * Contains metadata from ICY streams (radio) or ID3 frames.
58
+ * Timed metadata received during playback: ICY (radio) or ID3 frames.
59
+ * On iOS, also a file's own tags, once on load, when the file has no chapters.
50
60
  */
51
61
  export interface TimedMetadata {
52
62
  title?: string
@@ -57,8 +67,9 @@ export interface TimedMetadata {
57
67
  }
58
68
 
59
69
  /**
60
- * Static track metadata from the media file.
61
- * Contains standardized metadata fields.
70
+ * Static track metadata. On iOS, the media file's own tags. On Android,
71
+ * Media3's merged metadata, where the Track's fields and the now-playing lines win over
72
+ * the file's tags. `compilation` and `url` are never set.
62
73
  */
63
74
  export interface TrackMetadata {
64
75
  title?: string
@@ -66,14 +77,24 @@ export interface TrackMetadata {
66
77
  albumTitle?: string
67
78
  subtitle?: string
68
79
  description?: string
80
+ /**
81
+ * Android only: the artwork URL published for the Track, not embedded
82
+ * cover art.
83
+ */
69
84
  artworkUri?: string
70
85
  trackNumber?: string
71
86
  composer?: string
72
87
  conductor?: string
73
88
  genre?: string
74
89
  compilation?: string
90
+ /** Android only: the station name from a Shoutcast / Icecast stream. */
75
91
  station?: string
92
+ /** Android only: a Media3 `MEDIA_TYPE_*` constant, as a number string. */
76
93
  mediaType?: string
94
+ /**
95
+ * iOS: the tag's date string. Android: day and month only, as `DDMM` (or
96
+ * `DD` or `MM`), no year.
97
+ */
77
98
  creationDate?: string
78
99
  creationYear?: string
79
100
  url?: string
@@ -88,9 +109,9 @@ export interface ChapterMetadata {
88
109
  startTime: number
89
110
  /** Chapter end time in seconds */
90
111
  endTime: number
91
- /** Chapter title */
112
+ /** Chapter title. Android falls back to the chapter's element ID. */
92
113
  title?: string
93
- /** URL associated with the chapter */
114
+ /** URL associated with the chapter. Android only. */
94
115
  url?: string
95
116
  }
96
117
 
@@ -98,26 +119,42 @@ export interface ChapterMetadata {
98
119
 
99
120
  /**
100
121
  * Subscribes to chapter metadata events.
101
- * @param callback - Called when chapter metadata is received
102
- * @returns Cleanup function to unsubscribe
122
+ *
123
+ * @platform ios android
124
+ * Never fires on web — the web player does not read chapter markers. See
125
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
126
+ *
127
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
103
128
  */
104
129
  export const onChapterMetadata = NativeUpdatedValue.emitterize<
105
130
  ChapterMetadata[]
106
131
  >((cb) => (nativeBrowser.onChapterMetadata = cb))
107
132
 
108
133
  /**
109
- * Subscribes to track metadata events.
110
- * @param callback - Called when static track metadata is received
111
- * @returns Cleanup function to unsubscribe
134
+ * Subscribes to track metadata events. On iOS it fires once on load, when the
135
+ * file has tags. On Android it fires whenever the player's merged metadata
136
+ * changes.
137
+ *
138
+ * @platform ios android
139
+ * Never fires on web — the web player does not read embedded file tags. See
140
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
141
+ *
142
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
112
143
  */
113
144
  export const onTrackMetadata = NativeUpdatedValue.emitterize<TrackMetadata>(
114
145
  (cb) => (nativeBrowser.onTrackMetadata = cb)
115
146
  )
116
147
 
117
148
  /**
118
- * Subscribes to timed metadata events (ICY/ID3 from live streams).
119
- * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
120
- * @returns Cleanup function to unsubscribe
149
+ * Subscribes to timed metadata events (ICY/ID3 from live streams). On iOS it
150
+ * also fires on load with a file's own tags when the file has no chapters.
151
+ *
152
+ * @platform ios android
153
+ * Never fires on web: the browser strips ICY metadata before the player sees
154
+ * it, and the web player does not read in-band ID3 from HLS. See
155
+ * {@link https://github.com/radio-garden/react-native-audio-browser/issues/118 | #118}.
156
+ *
157
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
121
158
  */
122
159
  export const onTimedMetadata = NativeUpdatedValue.emitterize<TimedMetadata>(
123
160
  (cb) => (nativeBrowser.onTimedMetadata = cb)
@@ -6,6 +6,8 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
6
6
 
7
7
  /**
8
8
  * Gets the current network connectivity state.
9
+ * On Android it reads `true` before `setupPlayer` has connected the player, and
10
+ * while its service restarts.
9
11
  * @returns true if the device is online, false otherwise
10
12
  */
11
13
  export function getOnline(): boolean {
@@ -16,8 +18,9 @@ export function getOnline(): boolean {
16
18
 
17
19
  /**
18
20
  * Subscribes to network connectivity changes.
19
- * @param callback - Called when network state changes
20
- * @returns Cleanup function to unsubscribe
21
+ * On Android it fires nothing until `setupPlayer` has connected the player, and then
22
+ * fires once with the current state.
23
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
21
24
  */
22
25
  export const onOnlineChanged = NativeUpdatedValue.emitterize<boolean>(
23
26
  (cb) => (nativeBrowser.onOnlineChanged = cb)
@@ -27,6 +30,7 @@ export const onOnlineChanged = NativeUpdatedValue.emitterize<boolean>(
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(): boolean {
@@ -7,7 +7,11 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
7
7
 
8
8
  /**
9
9
  * Updates the now playing notification metadata.
10
- * Pass null/undefined to clear overrides and revert to track metadata.
10
+ *
11
+ * Lasts until you pass `null`, which clears it, or the active track changes. A `nowPlaying`
12
+ * formatter's fields win over it. With `nowPlaying: false` the iOS and
13
+ * Android surface ignores it, though `getNowPlaying` still reports it; web
14
+ * ignores `nowPlaying`.
11
15
  *
12
16
  * @example
13
17
  * ```ts
@@ -17,7 +21,7 @@ import { useNativeUpdatedValue } from '../utils/useNativeUpdatedValue'
17
21
  * artist: streamMetadata.artist,
18
22
  * })
19
23
  *
20
- * // Clear overrides, revert to track metadata
24
+ * // Clear the override
21
25
  * updateNowPlaying(null)
22
26
  * ```
23
27
  */
@@ -26,7 +30,10 @@ export function updateNowPlaying(update: NowPlayingUpdate | null): void {
26
30
  }
27
31
 
28
32
  /**
29
- * Gets the current now playing metadata (override if set, else track metadata).
33
+ * Returns what the now-playing surface shows: flash, formatter output,
34
+ * override or track fields, in that priority. `undefined` when there is no
35
+ * active track. With `nowPlaying: false`, it returns the flash, override or
36
+ * track fields, regardless of what the surface shows.
30
37
  */
31
38
  export function getNowPlaying(): NowPlayingMetadata | undefined {
32
39
  return nativeBrowser.getNowPlaying() ?? undefined
@@ -34,15 +41,19 @@ export function getNowPlaying(): NowPlayingMetadata | undefined {
34
41
 
35
42
  /**
36
43
  * Temporarily replaces now-playing fields for `durationMs`, then reverts to
37
- * the live metadata. The flash outranks the now-playing formatter and the
38
- * `updateNowPlaying` override while active (live metadata can't stomp it),
39
- * and the revert runs on a native timer — JS timers pause in a backgrounded
40
- * host (the lock screen case) — so it fires reliably. A track change clears
41
- * the flash early; repeated calls restart the window.
44
+ * the live metadata. While active it outranks the `nowPlaying` formatter
45
+ * ({@link features/player!FormatNowPlayingCallback | FormatNowPlayingCallback}) and the `updateNowPlaying` override.
46
+ * The revert runs on a native timer, so it fires while the app is
47
+ * backgrounded. A track change clears the flash early; repeated calls
48
+ * restart the window.
49
+ *
50
+ * On web the flash is a plain `updateNowPlaying` override on a JS timer. It
51
+ * replaces any override you set, the revert clears the override instead of
52
+ * restoring it, and a track change does not cancel the timer, so the revert
53
+ * can also clear an override set for the next track. With
54
+ * `nowPlaying: false`, Android ignores the flash; iOS still shows it.
42
55
  *
43
- * The feedback channel for refused remote commands: external surfaces have
44
- * no toast primitive, so a transient metadata swap is the only way to talk
45
- * to the user there.
56
+ * See the [Now playing guide](https://audiobrowser.dev/guide/now-playing#the-flash-transient-top-priority).
46
57
  *
47
58
  * @example
48
59
  * ```ts
@@ -62,7 +73,8 @@ export function flashNowPlaying(
62
73
 
63
74
  /**
64
75
  * Clears an active flash immediately, reverting to the live metadata.
65
- * No-op when no flash is active.
76
+ * No-op when no flash is active. On web it also clears the
77
+ * `updateNowPlaying` override.
66
78
  */
67
79
  export function clearNowPlayingFlash(): void {
68
80
  nativeBrowser.clearNowPlayingFlash()
@@ -72,9 +84,11 @@ export function clearNowPlayingFlash(): void {
72
84
 
73
85
  /**
74
86
  * Subscribes to now playing metadata change events.
75
- * Fires when updateNowPlaying is called or when the track changes.
76
- * @param callback - Called when now playing metadata changes
77
- * @returns Cleanup function to unsubscribe
87
+ * Fires when the now-playing lines change: track change, `updateNowPlaying`,
88
+ * a flash starting or ending, or a new formatter result. On iOS and
89
+ * Android, an update that leaves the lines unchanged does not fire; on web
90
+ * every `updateNowPlaying` call, flash start and revert fires.
91
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
78
92
  */
79
93
  export const onNowPlayingChanged =
80
94
  NativeUpdatedValue.emitterize<NowPlayingMetadata>(
@@ -33,9 +33,12 @@ export function supportsOutputSwitcher(): boolean {
33
33
 
34
34
  /**
35
35
  * The current audio output, or `undefined` when unknown. iOS reports one while a
36
- * session is active; Android reports the active output route via AudioManager
37
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
38
- * for `undefined`.
36
+ * session is active. Android reports the device media is routed to, from
37
+ * AudioManager, or the remote output selected in the Output Switcher when
38
+ * `remoteOutputs` is on. On Android 13+ (API 33) the route is exact and follows
39
+ * manual reroutes. Below that it is picked from the connected devices and misses
40
+ * a reroute while a device stays connected.
41
+ * Guard for `undefined`.
39
42
  */
40
43
  export function getOutput(): Output | undefined {
41
44
  return nativeBrowser.getOutput()
@@ -45,8 +48,10 @@ export function getOutput(): Output | undefined {
45
48
 
46
49
  /**
47
50
  * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
48
- * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
49
- * @returns Cleanup function to unsubscribe.
51
+ * connected, AirPlay/route selected). Fires on iOS and Android; never on web.
52
+ * On Android below 13 it cannot see a manual reroute between two connected
53
+ * devices.
54
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
50
55
  */
51
56
  export const onOutputChanged = NativeUpdatedValue.emitterize<Output>(
52
57
  (cb) => (nativeBrowser.onOutputChanged = cb)
@@ -31,16 +31,20 @@ export function togglePlayback(): void {
31
31
  }
32
32
 
33
33
  /**
34
- * Stops playback and resets position to the beginning.
35
- * The track remains loaded and can be resumed with play().
36
- * For live streams, position is not reset.
34
+ * Stops playback. The track stays current, and play() starts it again.
35
+ * iOS rewinds a non-live track to the start; Android and web keep the
36
+ * position, so play() resumes where it stopped.
37
37
  */
38
38
  export function stop(): void {
39
39
  nativeBrowser.stop()
40
40
  }
41
41
 
42
42
  /**
43
- * Retries playing the current item when the playback state is `'error'`.
43
+ * Retries playing the current item. Meant for the `'error'` state, but not
44
+ * gated on it: on iOS it reloads the current item in any state, even while
45
+ * playing. On Android and web it reloads whenever the player is stopped or
46
+ * failed, without setting the play intent, so after stop() it loads the item
47
+ * but does not play it.
44
48
  *
45
49
  * @see {@link PlaybackState}
46
50
  * @see {@link usePlayback}
@@ -58,8 +62,11 @@ export function seekTo(position: number): void {
58
62
  }
59
63
 
60
64
  /**
61
- * Jump to the live edge of the current track. No-op for non-live tracks; for
62
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
65
+ * Jump to the live edge of the current track; no-op unless the track
66
+ * declares `live: true`. A stream with a seekable live window (HLS) seeks
67
+ * to the window's edge; a non-seekable stream (e.g. ICY radio) reconnects
68
+ * to rejoin live. iOS re-runs `media.resolve` on the reconnect; Android
69
+ * reuses the resolved URL and re-resolves only after it fails to open.
63
70
  */
64
71
  export function seekToLiveEdge(): void {
65
72
  nativeBrowser.seekToLiveEdge()
@@ -23,8 +23,9 @@ export function getPlayWhenReady(): boolean {
23
23
 
24
24
  /**
25
25
  * Sets whether the player will play automatically when it is ready to do so.
26
- * This is the equivalent of calling `play()` when `playWhenReady = true`
27
- * or `pause()` when `playWhenReady = false`.
26
+ * Before setupPlayer resolves, the value is kept and applied at setup, while
27
+ * play() is dropped on iOS and Android. On Android, `true` does not restart a
28
+ * stopped or failed player; call play() or retry() for that.
28
29
  */
29
30
  export function setPlayWhenReady(playWhenReady: boolean): void {
30
31
  nativeBrowser.setPlayWhenReady(playWhenReady)
@@ -33,9 +34,9 @@ export function setPlayWhenReady(playWhenReady: boolean): void {
33
34
  // MARK: - Event Callbacks
34
35
 
35
36
  /**
36
- * Subscribes to play when ready changes.
37
- * @param callback - Called when playWhenReady changes
38
- * @returns Cleanup function to unsubscribe
37
+ * Emits each time `playWhenReady` changes. Subscribe with
38
+ * `onPlayWhenReadyChanged.addListener(cb)`, which returns an unsubscribe
39
+ * function.
39
40
  */
40
41
  export const onPlayWhenReadyChanged =
41
42
  NativeUpdatedValue.emitterize<PlaybackPlayWhenReadyChangedEvent>(
@@ -4,8 +4,21 @@ import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
4
4
 
5
5
  // MARK: - Types
6
6
 
7
+ /** Whether the player is playing, and whether it is buffering while it does. */
7
8
  export type PlayingState = {
9
+ /**
10
+ * True while the player intends to play and can: `playWhenReady` is set and
11
+ * the state is not `'none'`, `'stopped'`, `'ended'` or `'error'`. Also true
12
+ * while loading or buffering, so it does not mean sound is audible. On
13
+ * Android, also false while a transient audio-focus loss holds output back,
14
+ * though `playWhenReady` stays true.
15
+ */
8
16
  playing: boolean
17
+ /**
18
+ * True while the player intends to play and the state is `'loading'` or
19
+ * `'buffering'`. On Android, also false while a transient audio-focus loss
20
+ * holds output back, though `playWhenReady` stays true.
21
+ */
9
22
  buffering: boolean
10
23
  }
11
24
 
@@ -21,9 +34,9 @@ export function getPlayingState(): PlayingState {
21
34
  // MARK: - Event Callbacks
22
35
 
23
36
  /**
24
- * Subscribes to playing state changes.
25
- * @param callback - Called when playing or buffering state changes
26
- * @returns Cleanup function to unsubscribe
37
+ * Emits the {@link PlayingState} each time `playing` or `buffering` changes.
38
+ * Subscribe with `onPlayingState.addListener(cb)`, which returns an
39
+ * unsubscribe function.
27
40
  */
28
41
  export const onPlayingState = NativeUpdatedValue.emitterize<PlayingState>(
29
42
  (cb) => (nativeBrowser.onPlaybackPlayingState = cb)
@@ -0,0 +1,169 @@
1
+ /** @vitest-environment happy-dom */
2
+
3
+ import { renderHook, act, cleanup } from '@testing-library/react'
4
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
5
+ import type { Progress } from './progress'
6
+ import {
7
+ appStateListenerCount,
8
+ resetAppState,
9
+ setAppState
10
+ } from '../../test-utils/reactNativeStub'
11
+
12
+ const native = vi.hoisted(() => ({
13
+ getProgress: vi.fn<() => Progress>(() => ({
14
+ position: 0,
15
+ duration: 0,
16
+ buffered: 0
17
+ })),
18
+ onPlaybackChanged: undefined as ((event: unknown) => void) | undefined,
19
+ onPlaybackProgressUpdated: undefined as ((event: unknown) => void) | undefined
20
+ }))
21
+
22
+ vi.mock('../../native', () => ({ nativeBrowser: native }))
23
+
24
+ const { usePolledProgress } = await import('./progress')
25
+
26
+ const at = (position: number): Progress => ({
27
+ position,
28
+ duration: 300,
29
+ buffered: position + 10
30
+ })
31
+
32
+ beforeEach(() => {
33
+ vi.useFakeTimers()
34
+ resetAppState()
35
+ native.getProgress.mockReturnValue(at(0))
36
+ })
37
+
38
+ afterEach(() => {
39
+ cleanup()
40
+ vi.useRealTimers()
41
+ })
42
+
43
+ describe('usePolledProgress', () => {
44
+ it('starts at zero and polls the first value in', () => {
45
+ native.getProgress.mockReturnValue(at(12))
46
+ const { result } = renderHook(() => usePolledProgress())
47
+ // The initial poll runs inside the effect, so the zeroed useState default is
48
+ // never observable to a caller.
49
+ expect(result.current).toEqual(at(12))
50
+ })
51
+
52
+ it('polls on the given interval', () => {
53
+ const { result } = renderHook(() => usePolledProgress(500))
54
+ native.getProgress.mockReturnValue(at(1))
55
+ act(() => {
56
+ vi.advanceTimersByTime(500)
57
+ })
58
+ expect(result.current).toEqual(at(1))
59
+
60
+ native.getProgress.mockReturnValue(at(2))
61
+ act(() => {
62
+ vi.advanceTimersByTime(500)
63
+ })
64
+ expect(result.current).toEqual(at(2))
65
+ })
66
+
67
+ it('does not poll before the interval elapses', () => {
68
+ renderHook(() => usePolledProgress(1000))
69
+ native.getProgress.mockClear()
70
+ act(() => {
71
+ vi.advanceTimersByTime(999)
72
+ })
73
+ expect(native.getProgress).not.toHaveBeenCalled()
74
+ })
75
+
76
+ it('keeps the same object when nothing changed', () => {
77
+ const { result } = renderHook(() => usePolledProgress(500))
78
+ const first = result.current
79
+ act(() => {
80
+ vi.advanceTimersByTime(500)
81
+ })
82
+ // Identity, not equality: the hook returns the previous state object so a
83
+ // consumer's useEffect/memo on progress does not re-fire every tick.
84
+ expect(result.current).toBe(first)
85
+ })
86
+
87
+ it('updates immediately when playback changes, without waiting for a tick', () => {
88
+ const { result } = renderHook(() => usePolledProgress(10_000))
89
+ native.getProgress.mockReturnValue(at(7))
90
+ act(() => {
91
+ native.onPlaybackChanged?.({ state: 'playing' })
92
+ })
93
+ expect(result.current).toEqual(at(7))
94
+ })
95
+
96
+ it('survives a getter that throws before setup', () => {
97
+ native.getProgress.mockImplementation(() => {
98
+ throw new Error('not set up')
99
+ })
100
+ const { result } = renderHook(() => usePolledProgress(500))
101
+ expect(result.current).toEqual({ position: 0, duration: 0, buffered: 0 })
102
+ expect(() => act(() => vi.advanceTimersByTime(500))).not.toThrow()
103
+ })
104
+
105
+ it('stops polling in the background and resumes on return', () => {
106
+ const { result } = renderHook(() => usePolledProgress(500))
107
+
108
+ act(() => {
109
+ setAppState('background')
110
+ })
111
+ native.getProgress.mockReturnValue(at(99))
112
+ act(() => {
113
+ vi.advanceTimersByTime(5_000)
114
+ })
115
+ expect(result.current).toEqual(at(0))
116
+
117
+ // Returning to the foreground updates once immediately rather than leaving
118
+ // a stale position on screen until the next interval.
119
+ act(() => {
120
+ setAppState('active')
121
+ })
122
+ expect(result.current).toEqual(at(99))
123
+ })
124
+
125
+ it('ignores playback events while backgrounded', () => {
126
+ const { result } = renderHook(() => usePolledProgress(500))
127
+ act(() => {
128
+ setAppState('background')
129
+ })
130
+ native.getProgress.mockReturnValue(at(42))
131
+ act(() => {
132
+ native.onPlaybackChanged?.({ state: 'playing' })
133
+ })
134
+ expect(result.current).toEqual(at(0))
135
+ })
136
+
137
+ it('does not stack pollers when backgrounded twice', () => {
138
+ renderHook(() => usePolledProgress(500))
139
+ act(() => {
140
+ setAppState('background')
141
+ })
142
+ act(() => {
143
+ setAppState('active')
144
+ })
145
+ act(() => {
146
+ setAppState('active')
147
+ })
148
+
149
+ native.getProgress.mockClear()
150
+ act(() => {
151
+ vi.advanceTimersByTime(500)
152
+ })
153
+ expect(native.getProgress).toHaveBeenCalledTimes(1)
154
+ })
155
+
156
+ it('tears down its timer and subscriptions on unmount', () => {
157
+ const { unmount } = renderHook(() => usePolledProgress(500))
158
+ expect(appStateListenerCount()).toBe(1)
159
+
160
+ unmount()
161
+ expect(appStateListenerCount()).toBe(0)
162
+
163
+ native.getProgress.mockClear()
164
+ act(() => {
165
+ vi.advanceTimersByTime(5_000)
166
+ })
167
+ expect(native.getProgress).not.toHaveBeenCalled()
168
+ })
169
+ })
@@ -44,9 +44,10 @@ export function getProgress(): Progress {
44
44
  // MARK: - Event Callbacks
45
45
 
46
46
  /**
47
- * Subscribes to playback progress updates.
48
- * @param callback - Called periodically with playback progress updates
49
- * @returns Cleanup function to unsubscribe
47
+ * Emits the progress every `progressUpdateEventInterval` seconds while the
48
+ * player is loading, buffering or playing. Off by default (the interval is
49
+ * `null`). Subscribe with `onProgressUpdated.addListener(cb)`, which returns
50
+ * an unsubscribe function.
50
51
  */
51
52
  export const onProgressUpdated =
52
53
  NativeUpdatedValue.emitterize<PlaybackProgressUpdatedEvent>(
@@ -56,9 +57,14 @@ export const onProgressUpdated =
56
57
  // MARK: - Hooks
57
58
 
58
59
  /**
59
- * Hook that returns the current playback progress and updates when it changes.
60
+ * Hook that returns the current playback progress and updates on each
61
+ * progress event.
60
62
  *
61
- * Progress update frequency is controlled globally via `updateOptions({ progressUpdateEventInterval })`.
63
+ * Progress events are off by default (`progressUpdateEventInterval: null`), so
64
+ * this hook does not update until you set an interval in `setupPlayer` or
65
+ * `updateOptions`. Events fire only while loading, buffering or playing, so a
66
+ * seek while paused does not show. For updates without configuration, use
67
+ * {@link usePolledProgress}.
62
68
  * @returns The current playback progress
63
69
  */
64
70
  export function useProgress(): Progress {
@@ -118,7 +124,8 @@ export function usePolledProgress(updateInterval = 1000): Progress {
118
124
  }
119
125
 
120
126
  const stop = () => {
121
- clearTimeout(timer)
127
+ // Guarded: React Native types clearTimeout(handle: number) — no undefined.
128
+ if (timer !== undefined) clearTimeout(timer)
122
129
  timer = undefined
123
130
  unsubscribeState?.()
124
131
  unsubscribeState = undefined
@@ -14,8 +14,15 @@ export function getRate(): number {
14
14
 
15
15
  /**
16
16
  * Sets the playback rate.
17
+ *
18
+ * The rate is a speed multiplier, not a transport control — it is independent
19
+ * of play/pause, and setting it while paused never starts playback. Use
20
+ * {@link play} / {@link pause} for that.
21
+ *
17
22
  * @param rate - The playback rate to change to, where 0.5 would be half speed,
18
- * 1 would be regular speed, 2 would be double speed etc.
23
+ * 1 would be regular speed, 2 would be double speed etc. Must be greater than
24
+ * zero; platforms disagree on what a non-positive rate does (iOS ignores it,
25
+ * Android throws, web stalls the element), so treat it as unsupported.
19
26
  */
20
27
  export function setRate(rate: number): void {
21
28
  nativeBrowser.setRate(rate)
@@ -18,9 +18,8 @@ import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
18
18
  * - `'buffering'`: Indicates that the player is currently loading more data
19
19
  * before it can continue playing or is ready to start playing.
20
20
  * - `'error'`: Indicates that playback of the current item failed. Call
21
- * `AudioBrowser.getError()` to get more information on the type of error that
22
- * occurred. Call `AudioBrowser.retry()` or `AudioBrowser.play()` to try to play
23
- * the item again.
21
+ * `getPlaybackError()` (or subscribe via `usePlaybackError()`) for the
22
+ * error details. Call `retry()` or `play()` to try to play the item again.
24
23
  * - `'ended'`: Indicates that playback stopped due to the end of the queue
25
24
  * being reached.
26
25
  */
@@ -37,6 +36,11 @@ export type PlaybackState =
37
36
 
38
37
  export type Playback = {
39
38
  state: PlaybackState
39
+ /**
40
+ * What made playback fail, in the `'error'` state. On iOS and Android, also
41
+ * a failure still being retried (`retrying: true`) while loading, buffering
42
+ * or paused.
43
+ */
40
44
  error?: PlaybackError
41
45
  }
42
46
 
@@ -53,9 +57,9 @@ export function getPlayback(): Playback {
53
57
  // MARK: - Event Callbacks
54
58
 
55
59
  /**
56
- * Subscribes to playback state changes.
57
- * @param callback - Called when the playback state changes
58
- * @returns Cleanup function to unsubscribe
60
+ * Emits the {@link Playback} each time the playback state or error changes.
61
+ * Subscribe with `onPlaybackChanged.addListener(cb)`, which returns an
62
+ * unsubscribe function.
59
63
  */
60
64
  export const onPlaybackChanged = NativeUpdatedValue.emitterize<Playback>(
61
65
  (cb) => (nativeBrowser.onPlaybackChanged = cb)