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
@@ -11,21 +11,25 @@ import type {
11
11
  UpdateOptions
12
12
  } from './options'
13
13
  import { nativeBrowser } from '../../native'
14
- import { validateIOSUpdateOptions } from './options'
14
+ import { validateIOSUpdateOptions } from './validateOptions'
15
15
 
16
16
  /**
17
17
  * Parameters passed to the {@link FormatNowPlayingCallback}.
18
18
  *
19
19
  * The formatter owns every line shown on the now-playing surface — the track text, the live song,
20
- * *and* any transient status (reconnecting / error). The library no longer renders status copy
21
- * itself, so these fields give you what you need to render (and localize) it yourself. The formatter
20
+ * *and* any transient status (reconnecting / error). The library renders no status text; these
21
+ * fields let you render (and localize) it yourself. The formatter
22
22
  * is re-invoked on track change, each timed-metadata update, play/pause + error/rebuffer
23
23
  * transitions, and device connectivity changes.
24
24
  */
25
25
  export type FormatNowPlayingParams = {
26
26
  /** The currently playing track. */
27
27
  track: Track
28
- /** Timed metadata (ICY / ID3 "now playing song") received during playback, if any. */
28
+ /**
29
+ * Timed metadata (ICY / ID3 "now playing song") received during playback, if any.
30
+ * On iOS, also a file's own tags when the file has no chapters.
31
+ * Always `undefined` on web — see `onTimedMetadata` for why.
32
+ */
29
33
  timedMetadata?: TimedMetadata
30
34
  /** The play/pause intent — `false` while paused. Stays `true` through buffers, so the song line won't flicker. */
31
35
  playWhenReady: boolean
@@ -54,44 +58,28 @@ export type StallReason = 'buffering' | 'offline'
54
58
  * Customizes what's rendered on the now-playing surface — lock screen, notification, Control Center,
55
59
  * CarPlay, and Android Auto — for the currently playing track.
56
60
  *
57
- * Configure it via {@link SetupPlayerOptions.nowPlaying}. Where the default behavior
58
- * simply publishes the track's own `title` / `artist`, the formatter hands you the two now-playing
59
- * text lines outright: render the live timed metadata (the ICY / ID3 "now playing song"), surface a
60
- * transient status line ("Reconnecting…", an error message), drop the song while paused — anything
61
- * you can derive from the {@link FormatNowPlayingParams} for that moment.
62
- *
63
- * The callback is **synchronous** and should stay cheap: it's a pure formatting function, run on the
64
- * JS thread and awaited natively. Don't do I/O in it. If you need asynchronously-fetched data (e.g.
65
- * album art), resolve it out-of-band and stamp it imperatively rather than awaiting inside here.
66
- *
67
- * ### When it's invoked
68
- * The player re-invokes the formatter whenever the now-playing could change:
69
- * - on track change (a new item becomes current);
70
- * - on each timed-metadata update ({@link FormatNowPlayingParams.timedMetadata} arrives or changes);
71
- * - on every playback transition — play / pause, a stall starting or recovering, an error.
72
- *
73
- * Identical results are de-duplicated natively before they reach the media session, so returning the
74
- * same fields across a rapid burst of transitions is cheap and won't flicker the surface.
61
+ * Configure it via {@link SetupPlayerOptions.nowPlaying}. It is re-invoked on track change, each
62
+ * timed-metadata update and every playback transition; identical results are de-duplicated
63
+ * natively, so they don't flicker the surface.
75
64
  *
76
- * ### What to return
77
- * Return a {@link NowPlayingUpdate} with the fields to display. Each field falls back **independently**
78
- * to the track's own value when omitted — so `{ artist: 'Some Song' }` replaces only the secondary
79
- * line and leaves the title as the track's title. Return `undefined` (or `{}`) to use the library
80
- * default entirely (the track's own `title` / `artist`).
81
- *
82
- * @param params - The current track, latest timed metadata, and playback signals for this moment
83
- * ({@link FormatNowPlayingParams}), including a {@link StallReason} that already classifies an
84
- * offline stall — no separate connectivity read needed for the now-playing line.
85
- * @returns The now-playing fields to display, or `undefined` to fall back to the track's own
86
- * `title` / `artist`.
65
+ * The callback is **synchronous**, run on the JS thread and awaited natively: no I/O in it.
66
+ * Each returned field falls back **independently** to the track's own value, so
67
+ * `{ artist: 'Some Song' }` replaces only the secondary line; `undefined` (or `{}`) keeps the
68
+ * track's own `title` / `artist`. See the [Now playing guide](https://audiobrowser.dev/guide/now-playing).
87
69
  *
88
70
  * @example
89
71
  * ```ts
90
72
  * setupPlayer({
91
73
  * nowPlaying: ({ timedMetadata, playWhenReady, stalled, error }) => {
92
74
  * if (error) return { artist: error.message ?? 'Playback error' }
93
- * if (stalled) return { artist: stalled === 'offline' ? 'No internet connection' : 'Reconnecting…' }
94
- * // Show the live song only while actually playing; otherwise fall back to the track default.
75
+ * if (stalled) {
76
+ * return {
77
+ * artist: stalled === 'offline'
78
+ * ? 'No internet connection'
79
+ * : 'Reconnecting…'
80
+ * }
81
+ * }
82
+ * // Show the live song only while playing; else use the track default.
95
83
  * if (!playWhenReady || !timedMetadata?.title) return
96
84
  * return {
97
85
  * artist: timedMetadata.artist
@@ -149,7 +137,8 @@ export type AndroidAudioContentType =
149
137
  * - `'ambient'`: The category for an app in which sound playback is nonprimary
150
138
  * — that is, your app also works with the sound turned off. See
151
139
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616560-ambient
152
- * - `'soloAmbient'`: The default audio session category. See
140
+ * - `'soloAmbient'`: The system's default audio session category; the library
141
+ * uses `'playback'` when `category` is omitted. See
153
142
  * https://developer.apple.com/documentation/avfaudio/avaudiosession/category/1616488-soloambient
154
143
  * - `'record'`: The category for recording audio while also silencing playback
155
144
  * audio. See
@@ -249,18 +238,24 @@ export type IOSCategoryOptions =
249
238
  */
250
239
  export type IOSCategoryPolicy = 'default' | 'longFormAudio' | 'longFormVideo'
251
240
 
241
+ /**
242
+ * Requirements for Android audio offload; see `audioOffload`.
243
+ * @platform android
244
+ */
252
245
  export interface AndroidAudioOffloadSettings {
253
246
  /**
254
247
  * Whether gapless playback support is required for offload.
255
248
  * Enables smooth transitions between tracks without silence gaps.
256
- * @default true
249
+ * Omitting it here means not required; `audioOffload: true` requires it.
250
+ * @default false
257
251
  */
258
252
  gaplessSupportRequired?: boolean
259
253
 
260
254
  /**
261
255
  * Whether playback rate change support is required for offload.
262
256
  * Enables variable playback speeds (0.5x, 1.25x, 2x, etc.) during offload.
263
- * @default true
257
+ * Omitting it here means not required; `audioOffload: true` requires it.
258
+ * @default false
264
259
  */
265
260
  rateChangeSupportRequired?: boolean
266
261
  }
@@ -333,8 +328,8 @@ export type AndroidPlayerWakeMode = 'none' | 'local' | 'network'
333
328
  export interface AndroidSetupOptions extends AndroidUpdateOptions {
334
329
  /**
335
330
  * Minimum duration of media that the player will attempt to buffer in ms.
331
+ * Has no effect: the player keeps loading until `maxBuffer` is buffered.
336
332
  *
337
- * @throws Will throw if min buffer is higher than max buffer.
338
333
  * @default 50000
339
334
  */
340
335
  minBuffer?: number
@@ -347,8 +342,9 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
347
342
  *
348
343
  * - `true`: Enable with default settings (gapless + rate change support required)
349
344
  * - `false`/`undefined`: Disabled
350
- * - `{ gaplessSupportRequired: boolean, rateChangeSupportRequired: boolean }`:
351
- * Enable with specific requirements for gapless playback and playback rate changes
345
+ * - `{ gaplessSupportRequired?: boolean, rateChangeSupportRequired?: boolean }`:
346
+ * Enable with specific requirements for gapless playback and playback rate changes;
347
+ * an omitted field is not required, so `{}` enables offload with no requirements
352
348
  *
353
349
  * @default false
354
350
  */
@@ -356,9 +352,7 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
356
352
 
357
353
  /**
358
354
  * Maximum duration of media that the player will attempt to buffer in ms.
359
- * Max buffer may not be lower than min buffer.
360
355
  *
361
- * @throws Will throw if max buffer is lower than min buffer.
362
356
  * @default 50000
363
357
  */
364
358
  maxBuffer?: number
@@ -375,7 +369,7 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
375
369
  * Duration of media in ms that must be buffered for playback to start or
376
370
  * resume following a user action such as a seek.
377
371
  *
378
- * @default 2500
372
+ * @default 1000 (media3's `DEFAULT_BUFFER_FOR_PLAYBACK_MS`)
379
373
  */
380
374
  playBuffer?: number
381
375
 
@@ -386,7 +380,6 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
386
380
  * When null (the default), uses automatic mode:
387
381
  * - Starts at `playBuffer` value
388
382
  * - On rebuffer, measures how fast the buffer drained
389
- * - Calculates how much buffer is needed to sustain 60s of playback
390
383
  * - Increases threshold accordingly (up to 8000ms max)
391
384
  * - Resets when changing tracks
392
385
  *
@@ -409,11 +402,11 @@ export interface AndroidSetupOptions extends AndroidUpdateOptions {
409
402
  * The audio content type indicates to the android system how
410
403
  * you intend to use audio in your app.
411
404
  *
412
- * With `audioContentType: AndroidAudioContentType.Speech`, the audio will be
405
+ * With `audioContentType: 'speech'`, the audio will be
413
406
  * paused during short interruptions, such as when a message arrives.
414
407
  * Otherwise the playback volume is reduced while the notification is playing.
415
408
  *
416
- * @default AndroidAudioContentType.Music
409
+ * @default 'music'
417
410
  */
418
411
  audioContentType?: AndroidAudioContentType
419
412
 
@@ -452,7 +445,10 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
452
445
 
453
446
  /**
454
447
  * [AVAudioSession.Category](https://developer.apple.com/documentation/avfoundation/avaudiosession/1616615-category)
455
- * for iOS. Sets on `play()`.
448
+ * for iOS. Applied at `setupPlayer`; the session is activated when playback
449
+ * starts.
450
+ *
451
+ * @default 'playback'
456
452
  */
457
453
  category?: IOSCategory
458
454
 
@@ -461,25 +457,58 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
461
457
  * indicates to the system how you intend to use audio in your app. You can use
462
458
  * a mode to configure the audio system for specific use cases such as video
463
459
  * recording, voice or video chat, or audio analysis.
464
- * Sets on `play()`.
460
+ * Applied at `setupPlayer`; the session is activated when playback starts.
465
461
  *
466
462
  * See https://developer.apple.com/documentation/avfoundation/avaudiosession/1616508-mode
463
+ *
464
+ * @default 'default'
467
465
  */
468
466
  categoryMode?: IOSCategoryMode
469
467
 
470
468
  /**
471
469
  * [AVAudioSession.CategoryOptions](https://developer.apple.com/documentation/avfoundation/avaudiosession/1616503-categoryoptions) for iOS.
472
- * Sets on `play()`.
470
+ * Applied at `setupPlayer`; the session is activated when playback starts.
471
+ *
472
+ * @default []
473
473
  */
474
474
  categoryOptions?: IOSCategoryOptions[]
475
475
 
476
476
  /**
477
477
  * [AVAudioSession.RouteSharingPolicy](https://developer.apple.com/documentation/AVFAudio/AVAudioSession/RouteSharingPolicy-swift.enum) for iOS.
478
- * Sets on `play()`.
478
+ * Applied at `setupPlayer`; the session is activated when playback starts.
479
+ *
480
+ * @default 'default'
479
481
  */
480
482
  categoryPolicy?: IOSCategoryPolicy
481
483
  }
482
484
 
485
+ /** Which remote outputs `setupPlayer({ remoteOutputs })` turns on. */
486
+ export interface RemoteOutputsOptions {
487
+ /**
488
+ * Plays on Cast devices selected in the Output Switcher, through the Default Media Receiver:
489
+ * the receiver fetches the track's media URL itself, so it gets the URL the media transform
490
+ * resolves, without its headers. Needs the app built with `AudioBrowser_castEnabled=true` in
491
+ * its `gradle.properties` and Google Play services on the device; without either, playback
492
+ * stays on the phone and a warning is logged.
493
+ * @default false
494
+ */
495
+ cast?: boolean
496
+ /**
497
+ * The Cast receiver application `cast` loads, as registered in the Google Cast SDK Developer
498
+ * Console: a Styled Media Receiver shows the app's own name on the device and in its
499
+ * notifications. Cast takes it once per app process: a change takes effect after a restart.
500
+ * @default the Default Media Receiver, `'CC1AD845'`
501
+ */
502
+ castReceiverApplicationId?: string
503
+ /**
504
+ * Plays on Sonos rooms selected in the Output Switcher, over the speakers' UPnP control: the
505
+ * speaker fetches the media URL the media transform resolves, without its headers. Sonos calls
506
+ * UPnP unsupported and lets the listener switch it off; then no rooms are listed.
507
+ * @default false
508
+ */
509
+ sonos?: boolean
510
+ }
511
+
483
512
  /**
484
513
  * @internal The wire shape `setupPlayer` sends across the bridge: the platform bags hold only
485
514
  * construction fields, the runtime options nest under `options`, and the public `nowPlaying`
@@ -487,7 +516,11 @@ export interface IOSSetupOptions extends IOSUpdateOptions {
487
516
  */
488
517
  export interface NativeSetupPlayerOptions extends Pick<
489
518
  SetupPlayerOptions,
490
- 'playWhenReady' | 'repeatMode' | 'retry' | 'keepSessionAliveOnError'
519
+ | 'playWhenReady'
520
+ | 'repeatMode'
521
+ | 'retry'
522
+ | 'keepSessionAliveOnError'
523
+ | 'remoteOutputs'
491
524
  > {
492
525
  /** Android-specific configuration options for setup */
493
526
  android?: NativeAndroidSetupOptions
@@ -572,13 +605,15 @@ export type SetupPlayerOptions = Pick<
572
605
  /**
573
606
  * Retry policy for load errors (network failures, timeouts, etc.)
574
607
  * - `true`: Retry indefinitely with exponential backoff, under the default
575
- * duration budgets (12s before first audio, 2 minutes after — see
576
- * {@link RetryConfig})
577
- * - `false`/`undefined`: No automatic retry (default)
608
+ * duration budgets of {@link RetryConfig}
609
+ * - `false`/`undefined`: no library retry. Android keeps media3's default
610
+ * handling, which retries a failed load a few times before surfacing the
611
+ * error; iOS fails at once.
578
612
  * - `{ maxRetries: n }`: Retry up to n times with exponential backoff
579
613
  * - `RetryConfig`: custom attempt and duration budgets
580
614
  *
581
- * Exponential backoff delays: 1s → 1.5s → 2.3s → 3.4s → 5s (capped)
615
+ * Backoff timing and budgets: see the
616
+ * [Errors guide](https://audiobrowser.dev/guide/errors#two-duration-budgets).
582
617
  *
583
618
  * @default false
584
619
  */
@@ -586,7 +621,7 @@ export type SetupPlayerOptions = Pick<
586
621
 
587
622
  /**
588
623
  * Keep the media session alive and controllable through a terminal playback error (e.g. a dead
589
- * stream), so external controllers (Android Auto / CarPlay) keep their transport controls
624
+ * stream), so External Surfaces such as Android Auto keep their transport controls
590
625
  * (next / previous) instead of tearing the session down. The error is still reported via
591
626
  * `onPlaybackError` / `playbackState`; this only affects what the OS media session observes.
592
627
  *
@@ -597,6 +632,23 @@ export type SetupPlayerOptions = Pick<
597
632
  */
598
633
  keepSessionAliveOnError?: boolean
599
634
 
635
+ /**
636
+ * Offers remote speakers and TVs in the system Output Switcher (`openOutputPicker`), and
637
+ * reports the selected one as the `Output`, with `type: 'remote'`, or `'cast'` for a Cast
638
+ * device and `'sonos'` for a Sonos room. `{}` reports the selection only: the library keeps
639
+ * playing locally, and rendering the audio on the speaker is the provider's job. The speakers
640
+ * come from media route providers that declare the library's remote-output control category
641
+ * (`RemoteOutputs.CATEGORY` on Android). The app declares AndroidX's `MediaTransferReceiver` in
642
+ * its manifest for the switcher to move the session.
643
+ *
644
+ * Each `setupPlayer` sets it: left out, remote outputs are off, and playback on one comes back
645
+ * to the phone.
646
+ *
647
+ * Android 11+; ignored on iOS, whose route picker already lists AirPlay devices.
648
+ * @default off
649
+ */
650
+ remoteOutputs?: RemoteOutputsOptions
651
+
600
652
  /** Android-specific options: engine construction and runtime, merged. */
601
653
  android?: AndroidSetupOptions
602
654
  /** iOS-specific options: audio session and runtime, merged. */
@@ -608,8 +660,7 @@ export type SetupPlayerOptions = Pick<
608
660
  * - `true` (default): publish the track's own title / artist.
609
661
  * - `false`: don't manage the now-playing metadata at all.
610
662
  * - a {@link FormatNowPlayingCallback}: render it yourself — the callback owns every line,
611
- * including any transient status (buffering / reconnecting / offline / error), which the
612
- * library no longer renders on your behalf.
663
+ * including any transient status (buffering / reconnecting / offline / error).
613
664
  *
614
665
  * @default true
615
666
  */
@@ -659,7 +710,8 @@ function wrapNowPlayingFormatter(
659
710
  /**
660
711
  * The object's entries whose values aren't `undefined`. `null` stays: it's meaningful on some
661
712
  * fields (`progressUpdateEventInterval: null` disables progress events, `remoteButtonLayout:
662
- * null` empties the layout), so only `undefined` means "not provided".
713
+ * null` goes back to the layout derived from capabilities), so only `undefined` means "not
714
+ * provided".
663
715
  */
664
716
  function definedFields<T extends object>(obj: T): Partial<T> {
665
717
  const out: Partial<T> = {}
@@ -686,9 +738,14 @@ function nonEmpty<K extends string, T extends object>(
686
738
  * natively as part of setup itself, so there is no setup-then-command ordering for consumers
687
739
  * to know about, and no window where the player exists without its options.
688
740
  *
689
- * Calling it again reconfigures the player in place: newly provided fields are merged over
690
- * the previous ones, and the audio engine is rebuilt when construction-bound fields (buffers,
691
- * wake mode, …) changed.
741
+ * Calling it again is how a setup-only option changes after launch, and works differently per
742
+ * platform. On Android, newly provided fields are merged over the previous ones, except
743
+ * `remoteOutputs`, which is off when left out, and `nowPlaying`, which is on when left out
744
+ * and keeps an earlier formatter until a call passes another one. The audio engine is rebuilt
745
+ * only when construction-bound fields (buffers, wake mode, …) changed. On iOS, each call
746
+ * replaces the player: the queue is cleared, and setup-only fields you omit (`ios` session
747
+ * category and `buffer`, `retry`, …) go back to their defaults. Runtime options set earlier
748
+ * carry over on both.
692
749
  *
693
750
  * @param options - The options to initialize the player with.
694
751
  *
@@ -738,12 +795,14 @@ export async function setupPlayer(
738
795
  playbackRates,
739
796
  carPlayUpNextButton,
740
797
  carPlayNowPlayingButtons,
798
+ carPlayPlayingIndicatorLocation,
741
799
  ...iosSetup
742
800
  } = ios
743
801
  const iosUpdate = definedFields({
744
802
  playbackRates,
745
803
  carPlayUpNextButton,
746
- carPlayNowPlayingButtons
804
+ carPlayNowPlayingButtons,
805
+ carPlayPlayingIndicatorLocation
747
806
  })
748
807
  validateIOSUpdateOptions(iosUpdate)
749
808
 
@@ -0,0 +1,21 @@
1
+ import type { IOSUpdateOptions } from './options'
2
+
3
+ const MAX_CARPLAY_NOW_PLAYING_BUTTONS = 5
4
+
5
+ /**
6
+ * Warns when more CarPlay now-playing buttons are configured than CarPlay renders.
7
+ * Shared by `updateOptions` and `setupPlayer` (both can carry `ios` options).
8
+ * Kept out of `options.ts`, which the barrel re-exports — see
9
+ * public-surface.test.ts.
10
+ *
11
+ * @internal
12
+ */
13
+ export function validateIOSUpdateOptions(ios?: IOSUpdateOptions): void {
14
+ const buttons = ios?.carPlayNowPlayingButtons
15
+ if (buttons && buttons.length > MAX_CARPLAY_NOW_PLAYING_BUTTONS) {
16
+ console.warn(
17
+ `[react-native-audio-browser] ${buttons.length} CarPlay now-playing ` +
18
+ `buttons configured; CarPlay shows at most ${MAX_CARPLAY_NOW_PLAYING_BUTTONS}.`
19
+ )
20
+ }
21
+ }
@@ -1,7 +1,8 @@
1
1
  import type { Track } from '../../types'
2
2
  import { nativeBrowser } from '../../native'
3
3
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue'
4
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
4
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy'
5
+ import { onFavoriteChanged } from '../favorites'
5
6
 
6
7
  /**
7
8
  * Event data for when the active track changes.
@@ -40,8 +41,13 @@ export function getActiveTrackIndex(): number | undefined {
40
41
 
41
42
  /**
42
43
  * Subscribes to active track change events.
43
- * @param callback - Called when the active track changes
44
- * @returns Cleanup function to unsubscribe
44
+ *
45
+ * Fires on **transitions only** — selection, queue advance, skip. In-place
46
+ * metadata mutations of the active track (a favorite toggle) emit
47
+ * {@link onFavoriteChanged} instead; {@link useActiveTrack} subscribes to
48
+ * both, so UI bound through the hook still re-renders on a heart toggle.
49
+ *
50
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
45
51
  */
46
52
  export const onActiveTrackChanged =
47
53
  NativeUpdatedValue.emitterize<PlaybackActiveTrackChangedEvent>(
@@ -50,10 +56,14 @@ export const onActiveTrackChanged =
50
56
 
51
57
  // MARK: - Hooks
52
58
 
59
+ // Module-level so the hook's subscription identity is stable across renders.
60
+ const activeTrackInvalidators = [onActiveTrackChanged, onFavoriteChanged]
61
+
53
62
  /**
54
- * Hook that returns the current active track and updates when it changes.
63
+ * Hook that returns the current active track, updating on transitions AND on
64
+ * in-place mutations of the active track (favorite toggles).
55
65
  * @returns The current active track or undefined
56
66
  */
57
67
  export function useActiveTrack(): Track | undefined {
58
- return useNativeUpdatedValue(getActiveTrack, onActiveTrackChanged, 'track')
68
+ return useNativeValueRefreshedBy(getActiveTrack, activeTrackInvalidators)
59
69
  }
@@ -1,7 +1,8 @@
1
1
  import type { Track } from '../../types'
2
2
  import { nativeBrowser } from '../../native'
3
3
  import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue'
4
- import { useNativeUpdatedValue } from '../../utils/useNativeUpdatedValue'
4
+ import { useNativeValueRefreshedBy } from '../../utils/useNativeValueRefreshedBy'
5
+ import { onFavoriteChanged } from '../favorites'
5
6
 
6
7
  // MARK: - Types
7
8
 
@@ -22,6 +23,8 @@ export interface PlaybackQueueEndedEvent {
22
23
  * @param tracks - The tracks to add to the queue.
23
24
  * @param insertBeforeIndex - (Optional) The index to insert the tracks before.
24
25
  * By default the tracks will be added to the end of the queue.
26
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
27
+ * Android and the web treat `-1` as append; iOS throws on it.
25
28
  */
26
29
  export function add(tracks: Track[], insertBeforeIndex?: number): void
27
30
  /**
@@ -29,6 +32,8 @@ export function add(tracks: Track[], insertBeforeIndex?: number): void
29
32
  * @param track - The track to add to the queue.
30
33
  * @param insertBeforeIndex - (Optional) The index to insert the track before.
31
34
  * By default the track will be added to the end of the queue.
35
+ * @throws If `insertBeforeIndex` is negative or past the queue's length.
36
+ * Android and the web treat `-1` as append; iOS throws on it.
32
37
  */
33
38
  export function add(track: Track, insertBeforeIndex?: number): void
34
39
  export function add(tracks: Track | Track[], insertBeforeIndex?: number): void {
@@ -41,6 +46,7 @@ export function add(tracks: Track | Track[], insertBeforeIndex?: number): void {
41
46
  /**
42
47
  * Replaces the current track or loads the track as the first in the queue.
43
48
  * @param track - The track to load.
49
+ * @throws If called before `setupPlayer`.
44
50
  */
45
51
  export function load(track: Track): void {
46
52
  nativeBrowser.load(track)
@@ -49,8 +55,10 @@ export function load(track: Track): void {
49
55
  /**
50
56
  * Move a track within the queue.
51
57
  * @param fromIndex - The index of the track to be moved.
52
- * @param toIndex - The index to move the track to. If the index is larger than
53
- * the size of the queue, then the track is moved to the end of the queue.
58
+ * @param toIndex - The index to move the track to. On iOS and Android an index
59
+ * past the end moves the track to the end of the queue; the web throws.
60
+ * @throws If `fromIndex` is outside the queue or `toIndex` is negative (on the
61
+ * web, also if `toIndex` is past the last index).
54
62
  */
55
63
  export function move(fromIndex: number, toIndex: number): void {
56
64
  nativeBrowser.move(fromIndex, toIndex)
@@ -59,21 +67,32 @@ export function move(fromIndex: number, toIndex: number): void {
59
67
  /**
60
68
  * Removes multiple tracks from the queue by their indexes.
61
69
  *
62
- * If the current track is removed, the next track will activated. If the
63
- * current track was the last track in the queue, the first track will be
64
- * activated.
70
+ * If the active track is removed, the track after it becomes active. On iOS
71
+ * and the web that is the next index, wrapping to the first track. On Android
72
+ * it is the next track in playback order (shuffle and repeat apply), and
73
+ * removing the last track with repeat `off` makes the first track active but
74
+ * ends playback.
65
75
  *
66
76
  * @param indexes - The indexes of the tracks to be removed.
77
+ * @throws If an index is outside the queue. Android checks every index before
78
+ * removing any, and also throws if an index appears twice. iOS removes from the
79
+ * highest index down, so an invalid index can throw after some tracks are gone,
80
+ * and a repeated index also removes the track that moved into its place. The
81
+ * web skips invalid and repeated indexes without throwing.
67
82
  */
68
83
  export function remove(indexes: number[]): void
69
84
  /**
70
85
  * Removes a track from the queue by its index.
71
86
  *
72
- * If the current track is removed, the next track will activated. If the
73
- * current track was the last track in the queue, the first track will be
74
- * activated.
87
+ * If the active track is removed, the track after it becomes active. On iOS
88
+ * and the web that is the next index, wrapping to the first track. On Android
89
+ * it is the next track in playback order (shuffle and repeat apply), and
90
+ * removing the last track with repeat `off` makes the first track active but
91
+ * ends playback.
75
92
  *
76
93
  * @param index - The index of the track to be removed.
94
+ * @throws If `index` is outside the queue, on iOS and Android; the web
95
+ * ignores it.
77
96
  */
78
97
  export function remove(index: number): void
79
98
  export function remove(indexOrIndexes: number | number[]): void {
@@ -83,7 +102,8 @@ export function remove(indexOrIndexes: number | number[]): void {
83
102
  }
84
103
 
85
104
  /**
86
- * Clears any upcoming tracks from the queue.
105
+ * Removes every track after the active track's index in the queue. With
106
+ * shuffle on, this is queue order, not the shuffled play order.
87
107
  */
88
108
  export function removeUpcomingTracks(): void {
89
109
  nativeBrowser.removeUpcomingTracks()
@@ -93,6 +113,7 @@ export function removeUpcomingTracks(): void {
93
113
  * Skips to a track in the queue.
94
114
  * @param index - The index of the track to skip to.
95
115
  * @param initialPosition - (Optional) The initial position to seek to in seconds.
116
+ * @throws If `index` is outside the queue.
96
117
  */
97
118
  export function skip(index: number, initialPosition?: number): void {
98
119
  nativeBrowser.skip(index, initialPosition)
@@ -100,7 +121,9 @@ export function skip(index: number, initialPosition?: number): void {
100
121
 
101
122
  /**
102
123
  * Skips to the next track in the queue.
103
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
124
+ * @param initialPosition - (Optional) The position in seconds to start the next
125
+ * track from. On iOS and Android, with no next track the active track seeks to
126
+ * it instead; on the web the call does nothing.
104
127
  */
105
128
  export function skipToNext(initialPosition?: number): void {
106
129
  nativeBrowser.skipToNext(initialPosition)
@@ -108,7 +131,9 @@ export function skipToNext(initialPosition?: number): void {
108
131
 
109
132
  /**
110
133
  * Skips to the previous track in the queue.
111
- * @param initialPosition - (Optional) The initial position to seek to in seconds.
134
+ * @param initialPosition - (Optional) The position in seconds to start the
135
+ * previous track from. On iOS and Android, with no previous track the active
136
+ * track seeks to it instead; on the web the call does nothing.
112
137
  */
113
138
  export function skipToPrevious(initialPosition?: number): void {
114
139
  nativeBrowser.skipToPrevious(initialPosition)
@@ -117,12 +142,15 @@ export function skipToPrevious(initialPosition?: number): void {
117
142
  /**
118
143
  * Sets (replaces) the queue.
119
144
  *
120
- * This does not change the play/pause state: the player keeps playing if it was
121
- * playing and stays paused if it was paused. Call `play` explicitly to
122
- * start playback.
145
+ * On iOS and Android this does not change the play/pause state: the player
146
+ * keeps playing if it was playing and stays paused if it was paused. On the
147
+ * web it stops playback. Call `play` after it to start playback.
123
148
  *
124
149
  * @param tracks - The tracks to set as the queue.
125
150
  * @param startIndex - (Optional) The index of the track to make active.
151
+ * Defaults to 0 on iOS and Android; on the web, omitting it leaves no track
152
+ * active. iOS clamps an out-of-range index into the queue, Android throws, and
153
+ * the web ignores it.
126
154
  * @param startPosition - (Optional) The position in seconds to start the active track from.
127
155
  */
128
156
  export function setQueue(
@@ -154,9 +182,10 @@ export function getQueue(): Track[] {
154
182
  // MARK: - Event Callbacks
155
183
 
156
184
  /**
157
- * Subscribes to playback queue ended events.
158
- * @param callback - Called when playback has paused due to reaching the end of the queue
159
- * @returns Cleanup function to unsubscribe
185
+ * Subscribes to playback queue ended events: fires when the last track in
186
+ * playback order finishes with repeat mode `off` and the playback state
187
+ * becomes `ended`. Never fires under `track` or `queue` repeat.
188
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
160
189
  */
161
190
  export const onQueueEnded =
162
191
  NativeUpdatedValue.emitterize<PlaybackQueueEndedEvent>(
@@ -165,9 +194,11 @@ export const onQueueEnded =
165
194
 
166
195
  /**
167
196
  * Subscribes to queue change events.
168
- * Called when tracks are added, removed, reordered, or when track metadata changes.
169
- * @param callback - Called with the updated queue
170
- * @returns Cleanup function to unsubscribe
197
+ * Called when tracks are added, removed, or reordered. On iOS and Android a
198
+ * favorite toggle also fires it, alongside `onFavoriteChanged`. On web a
199
+ * favorite toggle fires only `onFavoriteChanged`. {@link useQueue} subscribes
200
+ * to both.
201
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
171
202
  */
172
203
  export const onQueueChanged = NativeUpdatedValue.emitterize<Track[]>(
173
204
  (cb) => (nativeBrowser.onPlaybackQueueChanged = cb)
@@ -175,10 +206,14 @@ export const onQueueChanged = NativeUpdatedValue.emitterize<Track[]>(
175
206
 
176
207
  // MARK: - Hooks
177
208
 
209
+ // Module-level so the hook's subscription identity is stable across renders.
210
+ const queueInvalidators = [onQueueChanged, onFavoriteChanged]
211
+
178
212
  /**
179
- * Hook that returns the current queue and updates when it changes.
213
+ * Hook that returns the current queue, updating on queue changes AND on
214
+ * in-place mutations of queued tracks (favorite toggles).
180
215
  * @returns The current queue
181
216
  */
182
217
  export function useQueue(): Track[] {
183
- return useNativeUpdatedValue(getQueue, onQueueChanged)
218
+ return useNativeValueRefreshedBy(getQueue, queueInvalidators)
184
219
  }
@@ -32,6 +32,7 @@ export function setRepeatMode(repeatMode: RepeatMode) {
32
32
 
33
33
  // MARK: - Event Callbacks
34
34
 
35
+ /** Event data for when the repeat mode changes. */
35
36
  export interface RepeatModeChangedEvent {
36
37
  /** The new repeat mode */
37
38
  repeatMode: RepeatMode
@@ -39,8 +40,7 @@ export interface RepeatModeChangedEvent {
39
40
 
40
41
  /**
41
42
  * Subscribes to repeat mode changes.
42
- * @param callback - Called when repeat mode changes
43
- * @returns Cleanup function to unsubscribe
43
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
44
44
  */
45
45
  export const onRepeatModeChanged =
46
46
  NativeUpdatedValue.emitterize<RepeatModeChangedEvent>(