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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1213) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +550 -435
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +61 -72
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +334 -536
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +14 -31
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +96 -113
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +41 -35
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +123 -136
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +397 -562
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +63 -114
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +42 -101
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +690 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  118. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  119. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +201 -0
  121. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  122. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  123. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +158 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  129. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  130. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  131. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  132. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  133. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  134. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  135. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  137. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  138. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  139. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  140. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  141. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  142. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  143. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  144. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  145. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  146. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  147. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  149. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +223 -20
  150. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +45 -33
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  154. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  155. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +48 -0
  157. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  158. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  159. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +179 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  163. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  164. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +22 -65
  165. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  166. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  167. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  168. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  169. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  170. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +285 -0
  171. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  172. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  173. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  174. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  175. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  176. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  186. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  187. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  188. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  189. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  190. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  191. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  192. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  193. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  194. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  195. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  196. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  197. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  198. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  199. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  200. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  201. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  202. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  203. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  204. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  205. package/android/src/test/resources/sonos/device_description.xml +78 -0
  206. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  207. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  208. package/ios/AVPlayerEngine.swift +354 -0
  209. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  210. package/ios/Browser/BrowseGate.swift +57 -0
  211. package/ios/Browser/BrowserConfig.swift +123 -104
  212. package/ios/Browser/BrowserError.swift +15 -0
  213. package/ios/Browser/BrowserManager.swift +139 -676
  214. package/ios/Browser/BrowserPathHelper.swift +54 -117
  215. package/ios/Browser/FavoriteSet.swift +43 -0
  216. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  217. package/ios/Browser/JsonModels.swift +244 -335
  218. package/ios/Browser/NavigationErrorState.swift +42 -0
  219. package/ios/Browser/PageResolver.swift +137 -0
  220. package/ios/Browser/RequestLayer.swift +181 -0
  221. package/ios/Browser/RequestPipeline.swift +293 -0
  222. package/ios/Browser/SearchDrillIn.swift +11 -17
  223. package/ios/Browser/SectionScope.swift +73 -26
  224. package/ios/Browser/SimpleRouter.swift +76 -154
  225. package/ios/Browser/StyleResolver.swift +41 -0
  226. package/ios/Browser/TabBarEntries.swift +8 -7
  227. package/ios/Browser/TrackIdTemplate.swift +29 -0
  228. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  229. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  230. package/ios/CarPlay/CarPlayController.swift +37 -1297
  231. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  232. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  233. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  234. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  235. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  236. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  237. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  238. package/ios/CarPlay/CarPlaySession.swift +203 -0
  239. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  240. package/ios/CarPlay/IntentHandlers.swift +94 -0
  241. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  242. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  243. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  244. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  245. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  246. package/ios/CarPlay/SectionPresentation.swift +67 -0
  247. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  248. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  249. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  250. package/ios/Extension/CxxVectorConformances.swift +4 -16
  251. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  252. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  253. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  254. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  255. package/ios/Extension/SearchParams+Query.swift +28 -0
  256. package/ios/Extension/Section+Copying.swift +26 -0
  257. package/ios/Extension/String+IcyCharset.swift +21 -0
  258. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  259. package/ios/Extension/Track+AVPlayer.swift +1 -18
  260. package/ios/Extension/Track+Copying.swift +13 -21
  261. package/ios/Extension/Track+Identity.swift +20 -0
  262. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  263. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  264. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  265. package/ios/Extension/URLError+Connectivity.swift +15 -0
  266. package/ios/Extension/Variant+Artwork.swift +8 -22
  267. package/ios/Http/HttpClient.swift +73 -167
  268. package/ios/HybridAudioBrowser+Browser.swift +130 -0
  269. package/ios/HybridAudioBrowser+Options.swift +102 -0
  270. package/ios/HybridAudioBrowser+Player.swift +333 -0
  271. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  272. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  273. package/ios/HybridAudioBrowser.swift +138 -1684
  274. package/ios/Model/NitroTypeStubs.swift +240 -32
  275. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  276. package/ios/Model/RemoteCommand.swift +6 -60
  277. package/ios/Model/TrackPlayerError.swift +14 -23
  278. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  279. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  280. package/ios/Observer/ItemObserver.swift +92 -0
  281. package/ios/Observer/PlayerObserver.swift +59 -0
  282. package/ios/Option/SessionCategories.swift +42 -92
  283. package/ios/PlaybackEvent.swift +4 -2
  284. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  285. package/ios/Player/AudioSessionController.swift +190 -0
  286. package/ios/Player/DeferredSeek.swift +70 -0
  287. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  288. package/ios/Player/ErrorStatus.swift +52 -0
  289. package/ios/Player/MediaLoader.swift +73 -98
  290. package/ios/Player/NowPlayingLines.swift +49 -0
  291. package/ios/Player/NowPlayingUpdater.swift +176 -105
  292. package/ios/Player/PersistedPlaybackState.swift +1 -2
  293. package/ios/Player/PlaybackFailure.swift +121 -0
  294. package/ios/Player/PlaybackPersistence.swift +72 -0
  295. package/ios/Player/PlaybackStateMachine.swift +11 -11
  296. package/ios/Player/PlaybackTimer.swift +11 -8
  297. package/ios/Player/Player.swift +987 -0
  298. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  299. package/ios/Player/PlayerEngine.swift +104 -0
  300. package/ios/Player/PlayerStatusTypes.swift +1 -6
  301. package/ios/Player/QueueManager.swift +80 -98
  302. package/ios/Player/RetryLoop.swift +274 -0
  303. package/ios/Player/ShuffleOrder.swift +36 -43
  304. package/ios/Player/SleepTimerManager.swift +25 -42
  305. package/ios/Player/VolumeFader.swift +20 -15
  306. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  307. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  308. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  309. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  310. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  311. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  312. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  313. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  314. package/ios/Tests/DeferredSeekTests.swift +68 -0
  315. package/ios/Tests/EmitterTests.swift +22 -39
  316. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  317. package/ios/Tests/ErrorStatusTests.swift +50 -0
  318. package/ios/Tests/FavoriteSetTests.swift +61 -0
  319. package/ios/Tests/GenerationMemoTests.swift +121 -0
  320. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  321. package/ios/Tests/JsonModelsTests.swift +189 -3
  322. package/ios/Tests/LRUCacheTests.swift +106 -0
  323. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  324. package/ios/Tests/MediaLoaderTests.swift +38 -78
  325. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  326. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  327. package/ios/Tests/ObserverTests.swift +88 -0
  328. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  329. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  330. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  331. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  332. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  333. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  334. package/ios/Tests/PlayerPolicyTests.swift +461 -0
  335. package/ios/Tests/PlayerTests.swift +1542 -0
  336. package/ios/Tests/PlayingStateTests.swift +41 -0
  337. package/ios/Tests/QueueManagerTests.swift +205 -174
  338. package/ios/Tests/ReadyValueTests.swift +73 -0
  339. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  340. package/ios/Tests/RequestLayerTests.swift +228 -0
  341. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  342. package/ios/Tests/RetryLoopTests.swift +282 -0
  343. package/ios/Tests/SearchDrillInTests.swift +16 -17
  344. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  345. package/ios/Tests/SectionPresentationTests.swift +85 -0
  346. package/ios/Tests/SectionScopeTests.swift +136 -54
  347. package/ios/Tests/SimpleRouterTests.swift +39 -8
  348. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  349. package/ios/Tests/StyleResolverTests.swift +123 -0
  350. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  351. package/ios/Tests/Support/TestTypes.swift +135 -100
  352. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  353. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  354. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  355. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  356. package/ios/Tests/TrackIdentityTests.swift +20 -0
  357. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  358. package/ios/Tests/TrackSelectorTests.swift +157 -34
  359. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  360. package/ios/TrackSelector.swift +62 -77
  361. package/ios/Util/ArtworkFreshness.swift +42 -0
  362. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  363. package/ios/Util/ConcurrentMap.swift +19 -0
  364. package/ios/Util/Emitter.swift +45 -22
  365. package/ios/Util/GenerationMemo.swift +36 -0
  366. package/ios/Util/LRUCache.swift +23 -159
  367. package/ios/Util/NetworkMonitor.swift +31 -33
  368. package/ios/Util/OutputPicker.swift +48 -0
  369. package/ios/Util/ReadyValue.swift +57 -0
  370. package/ios/Util/SFSymbolRenderer.swift +64 -49
  371. package/ios/Util/SVGProcessor.swift +9 -16
  372. package/lib/commonjs/AudioBrowser.js +8 -8
  373. package/lib/commonjs/AudioBrowser.js.map +1 -1
  374. package/lib/commonjs/CLAUDE.md +57 -0
  375. package/lib/commonjs/features/battery.js +16 -12
  376. package/lib/commonjs/features/battery.js.map +1 -1
  377. package/lib/commonjs/features/browser-config.js +13 -9
  378. package/lib/commonjs/features/browser-config.js.map +1 -1
  379. package/lib/commonjs/features/browser.js +78 -20
  380. package/lib/commonjs/features/browser.js.map +1 -1
  381. package/lib/commonjs/features/carConnection.js +3 -4
  382. package/lib/commonjs/features/carConnection.js.map +1 -1
  383. package/lib/commonjs/features/equalizer.js +10 -6
  384. package/lib/commonjs/features/equalizer.js.map +1 -1
  385. package/lib/commonjs/features/errors.js +35 -21
  386. package/lib/commonjs/features/errors.js.map +1 -1
  387. package/lib/commonjs/features/favorites.js +29 -24
  388. package/lib/commonjs/features/favorites.js.map +1 -1
  389. package/lib/commonjs/features/gate.js +28 -7
  390. package/lib/commonjs/features/gate.js.map +1 -1
  391. package/lib/commonjs/features/metadata.js +33 -14
  392. package/lib/commonjs/features/metadata.js.map +1 -1
  393. package/lib/commonjs/features/network.js +6 -2
  394. package/lib/commonjs/features/network.js.map +1 -1
  395. package/lib/commonjs/features/nowPlaying.js +29 -15
  396. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  397. package/lib/commonjs/features/output.js +10 -5
  398. package/lib/commonjs/features/output.js.map +1 -1
  399. package/lib/commonjs/features/playback/controls.js +13 -6
  400. package/lib/commonjs/features/playback/controls.js.map +1 -1
  401. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  402. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  403. package/lib/commonjs/features/playback/playing.js +5 -3
  404. package/lib/commonjs/features/playback/playing.js.map +1 -1
  405. package/lib/commonjs/features/playback/progress.js +13 -6
  406. package/lib/commonjs/features/playback/progress.js.map +1 -1
  407. package/lib/commonjs/features/playback/rate.js +8 -1
  408. package/lib/commonjs/features/playback/rate.js.map +1 -1
  409. package/lib/commonjs/features/playback/state.js +5 -6
  410. package/lib/commonjs/features/playback/state.js.map +1 -1
  411. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  412. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  413. package/lib/commonjs/features/playback/volume.js +6 -5
  414. package/lib/commonjs/features/playback/volume.js.map +1 -1
  415. package/lib/commonjs/features/player/options.js +23 -29
  416. package/lib/commonjs/features/player/options.js.map +1 -1
  417. package/lib/commonjs/features/player/setup.js +41 -41
  418. package/lib/commonjs/features/player/setup.js.map +1 -1
  419. package/lib/commonjs/features/player/validateOptions.js +23 -0
  420. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  421. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  422. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  423. package/lib/commonjs/features/queue/queue.js +58 -23
  424. package/lib/commonjs/features/queue/queue.js.map +1 -1
  425. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  426. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  427. package/lib/commonjs/features/queue/shuffle.js +1 -2
  428. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  429. package/lib/commonjs/features/remoteControls.js +70 -125
  430. package/lib/commonjs/features/remoteControls.js.map +1 -1
  431. package/lib/commonjs/features/sleepTimer.js +28 -7
  432. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  433. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  434. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  435. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  436. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  437. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -12
  438. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  439. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  440. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  441. package/lib/commonjs/utils/useDebug.js +16 -3
  442. package/lib/commonjs/utils/useDebug.js.map +1 -1
  443. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  444. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  445. package/lib/commonjs/web/NativeAudioBrowser.js +204 -81
  446. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  447. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  448. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  449. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  450. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  452. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  453. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  454. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  455. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  456. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  457. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  458. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  459. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  460. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  461. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  462. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  463. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  465. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  466. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  467. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  468. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  469. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  470. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  471. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  472. package/lib/commonjs/web/browser/sections.js +89 -0
  473. package/lib/commonjs/web/browser/sections.js.map +1 -0
  474. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  475. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  476. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  477. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  478. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  479. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  480. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  481. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  482. package/lib/module/AudioBrowser.js +2 -1
  483. package/lib/module/AudioBrowser.js.map +1 -1
  484. package/lib/module/CLAUDE.md +57 -0
  485. package/lib/module/features/battery.js +16 -12
  486. package/lib/module/features/battery.js.map +1 -1
  487. package/lib/module/features/browser-config.js +13 -9
  488. package/lib/module/features/browser-config.js.map +1 -1
  489. package/lib/module/features/browser.js +78 -20
  490. package/lib/module/features/browser.js.map +1 -1
  491. package/lib/module/features/carConnection.js +3 -4
  492. package/lib/module/features/carConnection.js.map +1 -1
  493. package/lib/module/features/equalizer.js +10 -6
  494. package/lib/module/features/equalizer.js.map +1 -1
  495. package/lib/module/features/errors.js +35 -21
  496. package/lib/module/features/errors.js.map +1 -1
  497. package/lib/module/features/favorites.js +29 -24
  498. package/lib/module/features/favorites.js.map +1 -1
  499. package/lib/module/features/gate.js +28 -7
  500. package/lib/module/features/gate.js.map +1 -1
  501. package/lib/module/features/metadata.js +33 -14
  502. package/lib/module/features/metadata.js.map +1 -1
  503. package/lib/module/features/network.js +6 -2
  504. package/lib/module/features/network.js.map +1 -1
  505. package/lib/module/features/nowPlaying.js +29 -15
  506. package/lib/module/features/nowPlaying.js.map +1 -1
  507. package/lib/module/features/output.js +10 -5
  508. package/lib/module/features/output.js.map +1 -1
  509. package/lib/module/features/playback/controls.js +13 -6
  510. package/lib/module/features/playback/controls.js.map +1 -1
  511. package/lib/module/features/playback/playWhenReady.js +6 -5
  512. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  513. package/lib/module/features/playback/playing.js +5 -3
  514. package/lib/module/features/playback/playing.js.map +1 -1
  515. package/lib/module/features/playback/progress.js +13 -6
  516. package/lib/module/features/playback/progress.js.map +1 -1
  517. package/lib/module/features/playback/rate.js +8 -1
  518. package/lib/module/features/playback/rate.js.map +1 -1
  519. package/lib/module/features/playback/state.js +5 -6
  520. package/lib/module/features/playback/state.js.map +1 -1
  521. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  522. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  523. package/lib/module/features/playback/volume.js +6 -5
  524. package/lib/module/features/playback/volume.js.map +1 -1
  525. package/lib/module/features/player/options.js +22 -27
  526. package/lib/module/features/player/options.js.map +1 -1
  527. package/lib/module/features/player/setup.js +40 -40
  528. package/lib/module/features/player/setup.js.map +1 -1
  529. package/lib/module/features/player/validateOptions.js +19 -0
  530. package/lib/module/features/player/validateOptions.js.map +1 -0
  531. package/lib/module/features/queue/activeTrack.js +15 -5
  532. package/lib/module/features/queue/activeTrack.js.map +1 -1
  533. package/lib/module/features/queue/queue.js +58 -23
  534. package/lib/module/features/queue/queue.js.map +1 -1
  535. package/lib/module/features/queue/repeatMode.js +3 -2
  536. package/lib/module/features/queue/repeatMode.js.map +1 -1
  537. package/lib/module/features/queue/shuffle.js +1 -2
  538. package/lib/module/features/queue/shuffle.js.map +1 -1
  539. package/lib/module/features/remoteControls.js +70 -125
  540. package/lib/module/features/remoteControls.js.map +1 -1
  541. package/lib/module/features/sleepTimer.js +28 -7
  542. package/lib/module/features/sleepTimer.js.map +1 -1
  543. package/lib/module/test-utils/reactNativeStub.js +58 -0
  544. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  545. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  546. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  547. package/lib/module/utils/NativeUpdatedValue.js +31 -12
  548. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  549. package/lib/module/utils/getTrackIdentity.js +22 -0
  550. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  551. package/lib/module/utils/useDebug.js +16 -3
  552. package/lib/module/utils/useDebug.js.map +1 -1
  553. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  554. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  555. package/lib/module/web/NativeAudioBrowser.js +204 -81
  556. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  557. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  558. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  559. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  560. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  561. package/lib/module/web/TrackPlayer/Player.js +254 -39
  562. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  563. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  564. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  565. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  566. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  567. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  568. package/lib/module/web/browser/BrowserManager.js +175 -100
  569. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  570. package/lib/module/web/browser/FavoriteManager.js +31 -21
  571. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  572. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  573. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  574. package/lib/module/web/browser/SearchManager.js +18 -23
  575. package/lib/module/web/browser/SearchManager.js.map +1 -1
  576. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  577. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  578. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  579. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  580. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  581. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  582. package/lib/module/web/browser/sections.js +83 -0
  583. package/lib/module/web/browser/sections.js.map +1 -0
  584. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  585. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  586. package/lib/module/web/http/followMediaRedirect.js +215 -0
  587. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  588. package/lib/module/web/player/NowPlayingManager.js +4 -3
  589. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  590. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  591. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  592. package/lib/typescript/package.json +1 -0
  593. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  594. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  595. package/lib/typescript/src/features/battery.d.ts +17 -12
  596. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  597. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  598. package/lib/typescript/src/features/browser.d.ts +67 -19
  599. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  600. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  601. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  602. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  603. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  604. package/lib/typescript/src/features/errors.d.ts +37 -22
  605. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  606. package/lib/typescript/src/features/favorites.d.ts +29 -24
  607. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  608. package/lib/typescript/src/features/gate.d.ts +32 -10
  609. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  610. package/lib/typescript/src/features/metadata.d.ts +54 -17
  611. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  612. package/lib/typescript/src/features/network.d.ts +6 -2
  613. package/lib/typescript/src/features/network.d.ts.map +1 -1
  614. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  615. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  616. package/lib/typescript/src/features/output.d.ts +10 -5
  617. package/lib/typescript/src/features/output.d.ts.map +1 -1
  618. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  619. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  620. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  621. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  622. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  623. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  625. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  627. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  629. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  631. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  632. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  633. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  634. package/lib/typescript/src/features/player/options.d.ts +74 -57
  635. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  636. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  637. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  638. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  639. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  640. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  641. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  642. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  643. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  644. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  645. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  646. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  647. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  648. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  649. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  650. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  651. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  652. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  653. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  654. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  655. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  656. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  657. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  658. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  659. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  660. package/lib/typescript/src/types/browser.d.ts +242 -173
  661. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  662. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  663. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  664. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -18
  665. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  666. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  667. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  668. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  669. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  671. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  672. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  673. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  674. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  675. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  676. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  682. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  683. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  689. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  692. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  694. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  696. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  697. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  698. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  699. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  701. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  702. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  703. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  704. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  705. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  706. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  713. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  714. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  715. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  718. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  720. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  722. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  724. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  725. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  727. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  745. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  748. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  749. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  752. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  754. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  755. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  756. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  757. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  762. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  765. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  768. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  771. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  773. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  774. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  775. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  776. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  777. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  779. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  782. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  785. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  787. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  789. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  797. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  801. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  802. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  804. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  810. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  812. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  815. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  816. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  817. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  818. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  822. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  824. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  825. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  826. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  828. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  829. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  830. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  831. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  832. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  833. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  834. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  862. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  973. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  974. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  975. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  976. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  977. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  978. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  979. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  980. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  981. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  982. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  983. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  984. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  985. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  986. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  987. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  988. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  989. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  990. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  991. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  992. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  993. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  994. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  995. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  996. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  997. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  998. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  999. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1000. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1001. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1002. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1003. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1004. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1005. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1006. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1007. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1008. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1009. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1010. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1011. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1012. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1013. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1014. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  1015. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  1016. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1017. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1018. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1019. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1020. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1021. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1022. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1023. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1024. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1025. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1026. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1027. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1028. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1029. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1030. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1031. package/package.json +26 -12
  1032. package/src/AudioBrowser.ts +2 -1
  1033. package/src/CLAUDE.md +57 -0
  1034. package/src/docs-floors.test.ts +71 -0
  1035. package/src/features/battery.test.ts +79 -0
  1036. package/src/features/battery.ts +17 -13
  1037. package/src/features/browser-config.test.ts +21 -6
  1038. package/src/features/browser-config.ts +13 -9
  1039. package/src/features/browser.test.ts +1 -1
  1040. package/src/features/browser.ts +69 -20
  1041. package/src/features/carConnection.ts +3 -4
  1042. package/src/features/equalizer.ts +10 -6
  1043. package/src/features/errors.ts +37 -22
  1044. package/src/features/favorites.ts +29 -24
  1045. package/src/features/gate.ts +30 -9
  1046. package/src/features/hook-wiring.test.ts +302 -0
  1047. package/src/features/metadata.ts +54 -17
  1048. package/src/features/network.ts +6 -2
  1049. package/src/features/nowPlaying.ts +29 -15
  1050. package/src/features/output.ts +10 -5
  1051. package/src/features/playback/controls.ts +13 -6
  1052. package/src/features/playback/playWhenReady.ts +6 -5
  1053. package/src/features/playback/playing.ts +16 -3
  1054. package/src/features/playback/progress.test.ts +169 -0
  1055. package/src/features/playback/progress.ts +13 -6
  1056. package/src/features/playback/rate.ts +8 -1
  1057. package/src/features/playback/state.ts +10 -6
  1058. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1059. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1060. package/src/features/playback/volume.ts +6 -5
  1061. package/src/features/player/options.ts +83 -82
  1062. package/src/features/player/setup.test.ts +12 -3
  1063. package/src/features/player/setup.ts +123 -64
  1064. package/src/features/player/validateOptions.ts +21 -0
  1065. package/src/features/queue/activeTrack.ts +15 -5
  1066. package/src/features/queue/queue.ts +58 -23
  1067. package/src/features/queue/repeatMode.ts +2 -2
  1068. package/src/features/queue/shuffle.ts +1 -2
  1069. package/src/features/remoteControls.ts +70 -125
  1070. package/src/features/sleepTimer.test.ts +172 -0
  1071. package/src/features/sleepTimer.ts +24 -8
  1072. package/src/nitro-stub-drift.test.ts +277 -0
  1073. package/src/public-surface.test.ts +147 -0
  1074. package/src/specs/audio-browser.nitro.ts +10 -8
  1075. package/src/style-resolution.test.ts +210 -0
  1076. package/src/test-utils/reactNativeStub.ts +60 -0
  1077. package/src/types/browser-native.ts +7 -3
  1078. package/src/types/browser-nodes.ts +417 -151
  1079. package/src/types/browser.ts +248 -177
  1080. package/src/utils/LazyNativeEmitter.ts +25 -15
  1081. package/src/utils/NativeUpdatedValue.ts +29 -12
  1082. package/src/utils/getTrackIdentity.ts +22 -0
  1083. package/src/utils/useDebug.test.ts +182 -0
  1084. package/src/utils/useDebug.ts +16 -3
  1085. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  1086. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  1087. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1088. package/src/web/NativeAudioBrowser.ts +243 -88
  1089. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1090. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1091. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1092. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  1093. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1094. package/src/web/TrackPlayer/Player.ts +284 -37
  1095. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1096. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1097. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1098. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1099. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  1100. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1101. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1102. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1103. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1104. package/src/web/__tests__/retry.test.ts +169 -0
  1105. package/src/web/browser/BrowserManager.ts +209 -111
  1106. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1107. package/src/web/browser/FavoriteManager.ts +28 -23
  1108. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1109. package/src/web/browser/SearchManager.test.ts +75 -0
  1110. package/src/web/browser/SearchManager.ts +25 -28
  1111. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1112. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1113. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1114. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1115. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1116. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1117. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1118. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1119. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1120. package/src/web/browser/parseSearchResponse.ts +3 -4
  1121. package/src/web/browser/sections.test.ts +91 -0
  1122. package/src/web/browser/sections.ts +72 -0
  1123. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1124. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1125. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1126. package/src/web/http/followMediaRedirect.ts +253 -0
  1127. package/src/web/player/NowPlayingManager.ts +4 -3
  1128. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1129. package/src/web/util/BrowserPathHelper.ts +68 -13
  1130. package/website/guide/android-auto.md +126 -0
  1131. package/website/guide/android-certificates.md +488 -0
  1132. package/website/guide/artwork.md +300 -0
  1133. package/website/guide/audio-output.md +357 -0
  1134. package/website/guide/automotive.md +91 -0
  1135. package/website/guide/basic-usage.md +154 -0
  1136. package/website/guide/battery.md +142 -0
  1137. package/website/guide/browser.md +674 -0
  1138. package/website/guide/carplay.md +733 -0
  1139. package/website/guide/configuration.md +215 -0
  1140. package/website/guide/equalizer.md +235 -0
  1141. package/website/guide/errors.md +352 -0
  1142. package/website/guide/favorites.md +164 -0
  1143. package/website/guide/gate.md +157 -0
  1144. package/website/guide/getting-started.md +99 -0
  1145. package/website/guide/hooks.md +244 -0
  1146. package/website/guide/live-streams.md +156 -0
  1147. package/website/guide/metadata.md +273 -0
  1148. package/website/guide/migrating-from-track-player.md +289 -0
  1149. package/website/guide/native-callback-fetch.md +137 -0
  1150. package/website/guide/network.md +102 -0
  1151. package/website/guide/now-playing.md +203 -0
  1152. package/website/guide/playback.md +405 -0
  1153. package/website/guide/queue.md +334 -0
  1154. package/website/guide/remote-controls.md +314 -0
  1155. package/website/guide/search.md +270 -0
  1156. package/website/guide/sleep-timer.md +289 -0
  1157. package/website/guide/track.md +271 -0
  1158. package/ios/Bridge.h +0 -8
  1159. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1160. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1161. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1162. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1163. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1164. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1165. package/ios/Model/MediaURL.swift +0 -67
  1166. package/ios/Model/SourceType.swift +0 -6
  1167. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1168. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1169. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1170. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1171. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1172. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1173. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1174. package/ios/Option/PitchAlgorithms.swift +0 -17
  1175. package/ios/Option/TimeEventFrequency.swift +0 -18
  1176. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1177. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1178. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1179. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1180. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1181. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1182. package/ios/Player/PlaybackStateStore.swift +0 -27
  1183. package/ios/Player/PlayingStateManager.swift +0 -33
  1184. package/ios/Player/RetryManager.swift +0 -322
  1185. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1186. package/ios/Player/SleepTimerHandling.swift +0 -15
  1187. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1188. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1189. package/ios/Tests/MediaResolveTests.swift +0 -126
  1190. package/ios/Tests/OnceValueTests.swift +0 -79
  1191. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1192. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1193. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1194. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1195. package/ios/Tests/RetryManagerTests.swift +0 -89
  1196. package/ios/TrackPlayer.swift +0 -1014
  1197. package/ios/TrackPlayerCallbacks.swift +0 -86
  1198. package/ios/Util/MetadataAdapter.swift +0 -131
  1199. package/ios/Util/OnceValue.swift +0 -104
  1200. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1201. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1202. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1203. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1204. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1205. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1206. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1207. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1208. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1209. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1210. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1211. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1212. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1213. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -1,5 +1,214 @@
1
1
  import type { CarPlaySiriListButtonPosition, HttpMethod } from './browser';
2
- export type TrackStyle = 'list' | 'grid';
2
+ /**
3
+ * How a holder's *children* lay out — CSS's inner display type, honored
4
+ * literally (`display: 'grid'` in CSS describes the children, not the
5
+ * element).
6
+ *
7
+ * - `'list'` (default) — full-width rows on every surface.
8
+ * - `'grid'` — artwork tiles; wraps unless {@link SectionStyle.gridWrap}
9
+ * is `false`. Tiles presume artwork: an artwork-less child renders a
10
+ * placeholder tile plus its title. On CarPlay a *wrapping* grid needs
11
+ * iOS 26+ and renders a list before that; a single-line grid renders
12
+ * on every OS.
13
+ */
14
+ export type StyleDisplay = 'list' | 'grid';
15
+ /**
16
+ * How a track's artwork is rendered.
17
+ *
18
+ * - `'original'` (default) — drawn as-is.
19
+ * - `'stencil'` — treated as a monochrome glyph and tinted to the
20
+ * surface's appearance (black in light mode, white in dark). For
21
+ * monochrome logos and icons; full-color artwork should stay
22
+ * `'original'`.
23
+ */
24
+ export type ArtworkRendering = 'original' | 'stencil';
25
+ /**
26
+ * The shape an image or condensed grid tile's artwork is cropped to.
27
+ *
28
+ * - `'rounded-rectangle'` (default) — the standard tile crop.
29
+ * - `'circular'` — the standard presentation for *people* (artists, hosts,
30
+ * DJs). Shape encodes the kind of item, so mixed grids legitimately
31
+ * render circular artists next to rounded albums.
32
+ */
33
+ export type ImageShape = 'circular' | 'rounded-rectangle';
34
+ /**
35
+ * The kind of tile a grid renders.
36
+ *
37
+ * - `'plain'` (default) — large artwork tiles with a title and subtitle
38
+ * below. No shape and no accessory.
39
+ * - `'image'` — artwork tiles with a title and no subtitle; takes
40
+ * {@link TrackStyle.imageShape} and {@link TrackStyle.accessorySymbol}.
41
+ * The grid of round tiles for people is `'image'` with
42
+ * `imageShape: 'circular'`.
43
+ * - `'card'` — a larger card with title/subtitle and a
44
+ * {@link TrackStyle.cardTint} color; its image mode is
45
+ * {@link TrackStyle.cardImage}. Cards have no shape and no accessory.
46
+ * - `'condensed'` — a denser cell carrying title + subtitle beside a small
47
+ * image; takes {@link TrackStyle.imageShape} and
48
+ * {@link TrackStyle.accessorySymbol}.
49
+ *
50
+ * Element families are mutually exclusive within a container, so this is
51
+ * a container property.
52
+ */
53
+ export type GridTile = 'plain' | 'image' | 'card' | 'condensed';
54
+ /**
55
+ * How a card tile uses its image.
56
+ *
57
+ * - `'normal'` (default) — a square image inset above the labels;
58
+ * {@link TrackStyle.cardTint} colors the whole card.
59
+ * - `'background'` — the image fills the card full-height with the labels
60
+ * overlaid; `cardTint` fades in behind them. Selects the larger artwork
61
+ * target size.
62
+ */
63
+ export type CardImage = 'normal' | 'background';
64
+ /**
65
+ * The style declaration block a {@link Track} may carry: *inherited item
66
+ * properties* (resolved `track ?? section ?? page ?? default`, per
67
+ * property — they travel with the track) plus the *positional*
68
+ * {@link TrackStyle.display} (each holder's own children; never
69
+ * inherited).
70
+ *
71
+ * Rules governing every property:
72
+ *
73
+ * - **Declarations are aspirational.** Each surface renders the
74
+ * properties it understands and ignores the rest — inert, never an
75
+ * error.
76
+ * - **Presentation only.** No style property affects queue scope,
77
+ * playback, or navigation: rendering may truncate what is visible, it
78
+ * never changes what plays. (This is why {@link Track.disabled} is NOT
79
+ * here — it carries behavior, so it lives on Track as a content fact.)
80
+ * - **The inheritance boundary**: a handle's block styles the handle; a
81
+ * page's block is inherited by the page's descendants; nothing
82
+ * inherits across resolution.
83
+ */
84
+ export interface TrackStyle {
85
+ /**
86
+ * How this entity's *children* lay out. The meaning is uniform at
87
+ * every position; only the children differ:
88
+ *
89
+ * - On a {@link Section}: the section's children.
90
+ * - On a resolved page ({@link ResolvedTrack.style}): the declaration
91
+ * for the whole page — a section overrides it for its own children.
92
+ * - On a browsable {@link Track} (the handle): the *advertised*
93
+ * layout of the page it opens. Android Auto decides a page's
94
+ * layout before resolving it, so it is the one reader that acts
95
+ * on the handle's declaration. Declared or it doesn't exist: no
96
+ * value → nothing advertised. The resolved page is the truth.
97
+ * - On a track rendered *playable* (`src` wins the rendering): inert —
98
+ * playables open no page.
99
+ *
100
+ * Never *item*-inherited — each holder speaks only for its own
101
+ * children. Between containers it resolves by scope override, not
102
+ * inheritance: the page declares for its whole scope, a section
103
+ * overrides for its own children.
104
+ *
105
+ * @default 'list'
106
+ *
107
+ * @see https://developer.android.com/training/cars/media/create-media-browser/content-styles
108
+ */
109
+ display?: StyleDisplay;
110
+ /**
111
+ * Inherited (`track ?? section ?? page`): how this item's artwork is
112
+ * rendered — `'stencil'` tints a monochrome glyph to the surface's
113
+ * light/dark appearance.
114
+ *
115
+ * @default 'original'
116
+ *
117
+ * @platform carplay
118
+ */
119
+ artworkRendering?: ArtworkRendering;
120
+ /**
121
+ * Inherited (`track ?? section ?? page`): the shape an image or
122
+ * condensed grid tile's artwork is cropped to — `'circular'` for people,
123
+ * the default `'rounded-rectangle'` for everything else. Shape follows
124
+ * the item wherever it travels: a circular artist stays circular in
125
+ * whatever shaped grid renders it next. Inert where the presentation has
126
+ * no shape (list rows, plain and card tiles, pre-26 CarPlay, Android
127
+ * Auto).
128
+ *
129
+ * @default 'rounded-rectangle'
130
+ *
131
+ * @platform carplay
132
+ */
133
+ imageShape?: ImageShape;
134
+ /**
135
+ * Inherited (`track ?? section ?? page`): an SF Symbol name drawn as
136
+ * the item's accessory wherever the current presentation supports one —
137
+ * the trailing edge of a list row or an iOS 26 condensed tile, leading
138
+ * the title on an image tile (placement is the platform's choice per
139
+ * surface); plain and card tiles have no slot for one. A resolved
140
+ * symbol replaces the derived accessory (the disclosure chevron a
141
+ * browsable row gets); `'none'` clears an inherited value, restoring
142
+ * the derived accessory. Inert off CarPlay.
143
+ *
144
+ * @platform carplay
145
+ */
146
+ accessorySymbol?: string;
147
+ /**
148
+ * Inherited (`track ?? section ?? page`): the card treatment's tint
149
+ * color (hex, e.g. `'#1e3a8a'`) — the card's own color, or the color
150
+ * that fades in behind the labels when {@link TrackStyle.cardImage} is
151
+ * `'background'`. Card-prefixed: inert unless the container renders
152
+ * `gridTile: 'card'`.
153
+ *
154
+ * @platform carplay
155
+ */
156
+ cardTint?: string;
157
+ /**
158
+ * Inherited (`track ?? section ?? page`): how a card tile uses its
159
+ * image — see {@link CardImage}. Uniform via the section value,
160
+ * mixable per card. Inert unless the container renders
161
+ * `gridTile: 'card'`.
162
+ *
163
+ * @default 'normal'
164
+ *
165
+ * @platform carplay
166
+ */
167
+ cardImage?: CardImage;
168
+ }
169
+ /**
170
+ * A {@link Section}'s (or resolved page's) style declaration block: the
171
+ * *container* properties below, plus — via `extends` — a section-wide
172
+ * value for every inherited {@link TrackStyle} item property (and the
173
+ * section's own positional `display`).
174
+ *
175
+ * Container properties resolve by scope override, not inheritance: the
176
+ * page declares for its whole scope, a section overrides for its own
177
+ * children (`section ?? page ?? default`) — they never flow to items.
178
+ */
179
+ export interface SectionStyle extends TrackStyle {
180
+ /**
181
+ * Whether grid tiles wrap to multiple lines. `false` renders exactly
182
+ * one line — the teaser shelf: a preview of a larger collection,
183
+ * typically paired with {@link Section.path} as the "view all" target.
184
+ *
185
+ * Rendered by CarPlay (a single line of tiles). Android Auto has no
186
+ * single-line tile container — its grid wraps, showing more, never
187
+ * less. Phone UIs typically honor `false` as a horizontal scroller.
188
+ *
189
+ * Inert unless {@link TrackStyle.display} is `'grid'`.
190
+ *
191
+ * @default true
192
+ *
193
+ * @platform carplay
194
+ *
195
+ * @see https://developer.apple.com/documentation/carplay/cplistimagerowitem
196
+ */
197
+ gridWrap?: boolean;
198
+ /**
199
+ * The kind of tile this container's grid renders — see
200
+ * {@link GridTile}. A container property (element families are
201
+ * container-homogeneous), resolved by scope override
202
+ * (`section ?? page`), never per item. Inert unless
203
+ * {@link TrackStyle.display} is `'grid'`, and on CarPlay before
204
+ * iOS 26 (where the treatment drops and the layout survives).
205
+ *
206
+ * @default 'plain'
207
+ *
208
+ * @platform carplay
209
+ */
210
+ gridTile?: GridTile;
211
+ }
3
212
  /**
4
213
  * Image source for React Native's `<Image>` component.
5
214
  * Contains all information needed to load an image, including URL transformation
@@ -21,12 +230,12 @@ export interface ImageSource {
21
230
  body?: string;
22
231
  }
23
232
  /**
24
- * Per-track override applied as the most-specific layer of THIS track's media
25
- * request (after the shared `request` and `media` layers). Deliberately narrow:
26
- * a track may customize HOW its request is made (identity, auth, signed-URL
27
- * params), not WHERE it goes — `baseUrl`/`path`/`method`/`body` are intentionally
28
- * absent so a (often server-sourced) track can't repoint its own host or verb.
29
- * Carried verbatim on the Track and round-tripped like any other field.
233
+ * Per-track request fields, carried verbatim on the Track and round-tripped like
234
+ * any other field. Not applied: no platform merges them into the track's
235
+ * media request, so they set no header, user agent or query. For per-track
236
+ * headers or query, return them from `media.resolve` / `resolveSync(track)`.
237
+ * `baseUrl`/`path`/`method`/`body` are absent so a (often server-sourced)
238
+ * track can't repoint its own host or verb.
30
239
  */
31
240
  export interface TrackRequest {
32
241
  userAgent?: string;
@@ -37,87 +246,102 @@ export interface TrackRequest {
37
246
  * Artwork URLs for a track that ships a different image per appearance.
38
247
  *
39
248
  * Both are required: a pair with one side missing has no sensible fallback at
40
- * render time, and making that unrepresentable is the reason this is a pair
41
- * rather than two optional fields.
249
+ * render time.
42
250
  *
43
- * Android Auto is dark-only and takes `dark`.
251
+ * The pair adapts to appearance only on CarPlay browse rows and tabs. Every
252
+ * other surface takes `dark` whatever the appearance: now-playing and the lock
253
+ * screen on every platform, Android Auto, and {@link Track.artworkSource}.
44
254
  */
45
255
  export interface ArtworkVariants {
46
- /** Shown in light mode. */
256
+ /** Shown on CarPlay in light mode. */
47
257
  light: string;
48
- /** Shown in dark mode, and on Android Auto. */
258
+ /** Shown on CarPlay in dark mode, and on every other surface. */
49
259
  dark: string;
50
260
  }
51
261
  /** A single artwork URL, or one per appearance. */
52
262
  export type TrackArtwork = string | ArtworkVariants;
53
- export interface ImageRowItem {
263
+ /**
264
+ * A titled, styled group of Tracks within a resolved page — the unit of
265
+ * queue scope. Tapping a playable child queues the section it sits in,
266
+ * identically on every platform and screen width: rendering may truncate
267
+ * what is visible, it never changes what plays.
268
+ */
269
+ export interface Section {
270
+ /** Header text. Absent = headerless group. */
271
+ title?: string;
54
272
  /**
55
- * Opaque, stable identifier for this item's track. Round-tripped like
56
- * `Track.id` when the thumbnail is played (see `src`).
273
+ * Presentation, separated from content. Each surface renders the
274
+ * declared layout's nearest supported form (CarPlay's grid limits:
275
+ * {@link StyleDisplay}). Use the artwork `resolve` hook to supply
276
+ * fallback art for tile layouts.
57
277
  */
58
- id?: string;
59
- /** Navigation path. Tapping this thumbnail navigates to this URL. */
60
- url?: string;
278
+ style?: SectionStyle;
61
279
  /**
62
- * Direct audio source. When present, tapping this thumbnail plays it
63
- * immediately (same selection path as a playable list row) instead of
64
- * navigating. Takes precedence over `url`.
280
+ * Navigation target for the section's "view all" affordance — the
281
+ * fuller page this section is a teaser for. Absent = a self-contained
282
+ * section: the header is a plain label, not a link.
283
+ *
284
+ * The surface picks the form, and each carries the copy
285
+ * itself — a `path` never adds words to the section:
286
+ *
287
+ * - **CarPlay** — a tile section's row draws a disclosure chevron and
288
+ * the whole row navigates. A list section renders no affordance:
289
+ * CarPlay has no "see all" idiom for one, and an invented row would
290
+ * spend an item from the template's cap.
291
+ * - **Android Auto** — no header is tappable at any display, so the
292
+ * section gets an appended browsable row, titled by the global
293
+ * `viewMoreTitle` browser option.
65
294
  */
66
- src?: string;
67
- /** Artwork URL for the thumbnail image. */
68
- artwork?: string;
69
- /** Output only — populated by the artwork transform pipeline. */
70
- readonly artworkSource?: ImageSource;
71
- /** Title of this item. Shown as the thumbnail caption; used for identification and accessibility. */
72
- title: string;
73
- /** Now-playing secondary line when played via `src` (mirrors `Track.artist`). */
74
- artist?: string;
75
- /** Now-playing album line when played via `src` (mirrors `Track.album`). */
76
- album?: string;
77
- /** Navigation target of the album line when played via `src` (mirrors `Track.albumUrl`). */
78
- albumUrl?: string;
79
- /** Live stream indicator when played via `src` (mirrors `Track.live`). */
80
- live?: boolean;
81
- /** Per-item media-request override when played via `src` (mirrors `Track.request`). */
82
- request?: TrackRequest;
295
+ path?: string;
296
+ /** The section's tracks. */
297
+ children: Track[];
83
298
  }
299
+ /**
300
+ * The one node type of the browse tree — every tab, folder, station,
301
+ * episode, and queue item is a Track. What a Track *is* follows from which
302
+ * address fields it carries: a {@link path} makes it **browsable** (it opens
303
+ * as a page), a {@link src} makes it **playable** (it can be loaded into the
304
+ * player); at least one of the two is required. The remaining fields are
305
+ * display metadata ({@link title}, {@link artist}, {@link artwork}, …) and
306
+ * content state ({@link favorited}, {@link live}, {@link disabled}).
307
+ */
84
308
  export interface Track {
85
309
  /**
86
310
  * Opaque, stable identifier for this track.
87
311
  *
312
+ * A track's **identity** is `id` when set (non-empty), falling back to
313
+ * `src`; Android also treats a whitespace-only `id` as unset, so never
314
+ * send one. That single rule drives every comparison the library makes:
315
+ * favorites matching (`setFavorites`), the CarPlay / Android Auto
316
+ * "now playing" row indicator, section scoping and skip-in-place, and the
317
+ * contextual queue re-expansion. Two tracks refer to the same item iff
318
+ * their identities are equal — so set `id` consistently on every surface,
319
+ * or on none.
320
+ *
88
321
  * The library never parses or derives anything from this value — it is
89
- * round-tripped verbatim through `setQueue`, `getActiveTrack`, the queue, and
90
- * `onActiveTrackChanged`, so consumers can recognise which item became active
91
- * after an external transport change (lock screen / CarPlay / Android Auto /
92
- * Bluetooth next-previous) without parsing the playable `src`.
93
- *
94
- * When present on a playable track it is also the track's *identity* on car
95
- * browse surfaces: CarPlay's and Android Auto's "now playing" row indicator
96
- * match the active track to browse rows by `id` (falling back to exact `src`
97
- * equality for tracks without one). Assign ids when your playable `src`
98
- * strings for the same item can differ between browse rows and loaded tracks
99
- * (absolute vs relative URLs, volatile query params) — otherwise the
100
- * indicator never matches.
101
- *
102
- * It is also handed to the per-track `MediaRequestConfig.resolve` and
103
- * `ArtworkRequestConfig.resolve` hooks, so requests can be built from a stable
104
- * id (e.g. supply tracks with only an `id` and synthesise `src` in `resolve`).
105
- *
106
- * Optional: consumers whose `url`/`src` strings are already stable across
107
- * surfaces can ignore it.
108
- *
109
- * Note: an Android Auto item selected directly from the browse tree that the
110
- * consumer never queued is identified only by `url`/`src`, so `id` may be
111
- * undefined on that specific path.
322
+ * round-tripped verbatim through `setQueue`, `getActiveTrack`, the queue,
323
+ * `onActiveTrackChanged`, and `onFavoriteChanged`, and handed to the
324
+ * per-track `MediaRequestConfig.resolve` / `ArtworkRequestConfig.resolve`
325
+ * hooks so requests can be built from the stable id.
326
+ *
327
+ * Optional: consumers whose `src` strings are identical wherever the same
328
+ * item appears can ignore it — their identity is the `src`. Assign ids when
329
+ * `src` strings for the same item can differ between surfaces (absolute vs
330
+ * relative URLs, volatile query params), or when favorites are stored as an
331
+ * identifier that isn't the playable URL.
112
332
  */
113
333
  id?: string;
114
334
  /**
115
335
  * Navigation path. When present, this track is a container (tab, album, playlist, folder)
116
336
  * that can be navigated into to view its contents.
117
337
  *
118
- * At least one of `url` or `src` must be defined.
338
+ * At least one of `path` or `src` must be defined. When both are set, current
339
+ * surfaces treat the track as playable — `src` wins the rendering, and the
340
+ * browse pipeline replaces a playable track's `path` with its contextual
341
+ * path — so a consumer-supplied `path` on a playable track is not reachable
342
+ * today.
119
343
  */
120
- url?: string;
344
+ path?: string;
121
345
  /**
122
346
  * Direct audio source identifier. When present, this track can be played directly.
123
347
  *
@@ -125,7 +349,7 @@ export interface Track {
125
349
  * any string (file path, custom identifier, etc.) that will be passed to
126
350
  * MediaRequestConfig.resolve to transform it into the actual media request.
127
351
  *
128
- * At least one of `url` or `src` must be defined.
352
+ * At least one of `path` or `src` must be defined.
129
353
  */
130
354
  src?: string;
131
355
  /**
@@ -138,14 +362,16 @@ export interface Track {
138
362
  * Pass an {@link ArtworkVariants} pair to supply genuinely different images
139
363
  * per appearance — a logo that changes colour, say. For a monochrome glyph
140
364
  * that only needs recolouring, prefer a single URL plus
141
- * {@link Track.artworkCarPlayTinted}, which is one fetch instead of two.
365
+ * `style: { artworkRendering: 'stencil' }`, which is one fetch instead
366
+ * of two.
142
367
  *
143
368
  * **iOS:** supports {@link https://developer.apple.com/sf-symbols/ | SF Symbols}
144
369
  * with the `sf:` prefix and optional color params:
145
370
  * `sf:heart.fill?bg=#FF0090&fg=#fff`. `bg` sets the background color
146
371
  * (transparent if omitted), `fg` sets the symbol color (black if omitted).
147
- * On CarPlay, SF Symbols without explicit colors automatically adapt to
148
- * light/dark mode.
372
+ * CarPlay rows key off `fg` instead: without it, the symbol is drawn black
373
+ * or white to match light/dark mode over a grey tile, and `bg` is ignored;
374
+ * with it, an omitted `bg` is a grey tile. CarPlay tabs ignore both.
149
375
  */
150
376
  artwork?: TrackArtwork;
151
377
  /**
@@ -159,28 +385,13 @@ export interface Track {
159
385
  *
160
386
  * @example
161
387
  * ```tsx
162
- * <Image source={audioBrowser.activeTrack?.artworkSource} />
388
+ * const track = useActiveTrack()
389
+ * <Image source={track?.artworkSource} />
163
390
  * ```
164
391
  */
165
392
  readonly artworkSource?: ImageSource;
166
- /** Per-track media-request override; merged last (request → media → track.request). */
393
+ /** Per-track request fields, round-tripped verbatim; see {@link TrackRequest} for whether they reach the media request. */
167
394
  request?: TrackRequest;
168
- /**
169
- * Whether this artwork should be tinted based on CarPlay's current appearance (light/dark mode).
170
- *
171
- * When `true`, the artwork is treated as a monochrome icon and tinted:
172
- * - Light mode: tinted black for visibility on light backgrounds
173
- * - Dark mode: tinted white for visibility on dark backgrounds
174
- *
175
- * This is useful for SVG or PNG icons that need to adapt to CarPlay's light/dark themes.
176
- * Full-color artwork (album covers, logos) should not use this.
177
- *
178
- * **iOS CarPlay only** - Android Auto is dark-only, so content providers should
179
- * provide appropriately colored icons directly (e.g., white icons).
180
- *
181
- * @default false
182
- */
183
- artworkCarPlayTinted?: boolean;
184
395
  /** Primary line shown for this item, in both browse lists and now-playing. */
185
396
  title: string;
186
397
  /**
@@ -202,9 +413,9 @@ export interface Track {
202
413
  artist?: string;
203
414
  /**
204
415
  * Browse path the {@link album} line navigates to (same path namespace as
205
- * {@link url}). On CarPlay, when the active track has an `albumUrl`, its
416
+ * {@link path}). On CarPlay, when the active track has an `albumPath`, its
206
417
  * album line on the Now Playing screen becomes tappable and navigates the
207
- * browse stack there. See also `resolveAlbumUrl` in the browser
418
+ * browse stack there. See also `resolveAlbumPath` in the browser
208
419
  * configuration for a dynamic fallback.
209
420
  *
210
421
  * Requires {@link album} to be set: CarPlay renders the tappable line from
@@ -212,9 +423,25 @@ export interface Track {
212
423
  *
213
424
  * @platform ios
214
425
  */
215
- albumUrl?: string;
426
+ albumPath?: string;
427
+ /**
428
+ * Album name, shown on now-playing surfaces that have an album slot
429
+ * (CarPlay, Android Auto, Bluetooth metadata — the iOS lock screen has
430
+ * none). With {@link albumPath} set, CarPlay renders it as a tappable
431
+ * line that navigates there.
432
+ */
216
433
  album?: string;
434
+ /**
435
+ * Longer free-form text about the item, passed to the platform's
436
+ * description metadata slot where one exists. Not shown on browse rows
437
+ * (those render {@link title} / {@link subtitle}) or the lock screen.
438
+ */
217
439
  description?: string;
440
+ /**
441
+ * Genre name, passed to the platform's genre metadata slot where one
442
+ * exists. Catalog metadata only — the library never matches search or
443
+ * browse against it.
444
+ */
218
445
  genre?: string;
219
446
  /**
220
447
  * Duration in seconds, as catalog metadata for app UI (e.g. an episode
@@ -223,67 +450,79 @@ export interface Track {
223
450
  */
224
451
  duration?: number;
225
452
  /**
226
- * Display style for this item in Android Auto/AAOS.
227
- * - 'list': Display as a list row
228
- * - 'grid': Display as a grid tile
229
- *
230
- * On Android: when `artwork` is an `android.resource://` URI
231
- * (e.g., `android.resource://com.myapp/drawable/ic_folder`), the library
232
- * automatically uses 'category' styling which adds margins around the icon
233
- * and enables system tinting for vector drawables.
234
- *
235
- * @see https://developer.android.com/training/cars/media#default-content-style
453
+ * The track's style declaration block: inherited item properties (a
454
+ * per-item override of section/page values — they travel with the
455
+ * track), plus the positional {@link TrackStyle.display} — on a
456
+ * browsable track, the advertised layout of the page it opens, read
457
+ * by Android Auto, which picks a page's layout before resolving it.
236
458
  */
237
459
  style?: TrackStyle;
238
460
  /**
239
- * Display style for this item's children in Android Auto/AAOS.
240
- * Only applies to browsable items (containers/folders).
241
- * - 'list': Display children as list rows
242
- * - 'grid': Display children as grid tiles
461
+ * Marks the track unavailable: the library never plays it — taps and
462
+ * voice selection are refused, queue expansion and resume exclude it. A
463
+ * queue you pass to `setQueue` is not filtered, and your own UI must
464
+ * honor the flag itself.
465
+ *
466
+ * Drawn **grayed + inert** where the surface can (CarPlay list rows and
467
+ * iOS 26+ tiles), **hidden** where it can't (CarPlay tile rows before
468
+ * iOS 26, CarPlay tabs, Android Auto). Surfaces that hide lose any
469
+ * "Available at 9 PM" tease, so put the reason in the title for the ones
470
+ * that gray. Applied when the page is (re-)served, like style.
243
471
  *
244
- * Must be set on the item when it appears as a child in a parent's list.
245
- * Android Auto reads the extras at that point to determine how to display
246
- * the folder's contents when navigated into.
472
+ * @default false
247
473
  */
248
- childrenStyle?: TrackStyle;
474
+ disabled?: boolean;
249
475
  /**
250
- * Whether this track is favorited. When the `favorite` capability is enabled,
251
- * displays a filled/empty heart icon in media controllers (notification, Android Auto).
476
+ * Whether this track is favorited. It fills or empties the heart on
477
+ * CarPlay now-playing when `ios.carPlayNowPlayingButtons` includes
478
+ * `'favorite'`. When the `favorite` capability is enabled, it does the
479
+ * same on Android in the notification, Android Auto, the system media
480
+ * controls and playable browse rows. iOS Control Center shows no heart.
252
481
  */
253
482
  favorited?: boolean;
254
483
  /**
255
- * Group title for section headers in Android Auto/AAOS.
256
- * Items with the same groupTitle are displayed under a shared section header.
257
- * Items must be contiguous to form a single group.
258
- */
259
- groupTitle?: string;
260
- /**
261
- * Whether this track is a live stream. When true, displays a "live" indicator
262
- * in iOS now playing interfaces.
263
- */
264
- live?: boolean;
265
- /**
266
- * When present, renders this track as a horizontal row of tappable artwork
267
- * thumbnails instead of a standard list item.
268
- *
269
- * - Track.title → row header text
270
- * - Track.url → navigated when header is tapped (optional)
271
- * - Each ImageRowItem → one thumbnail in the horizontal row; a thumbnail
272
- * with `src` plays immediately on tap, otherwise its `url` is navigated
484
+ * Declares this track a live broadcast rather than a file. The players
485
+ * detect *transport* liveness (sliding windows, buffering) themselves;
486
+ * this declaration drives the semantic decisions they can't infer:
273
487
  *
274
- * On CarPlay: maps to CPListImageRowItem. Limits visible images by display
275
- * width (~4-5). Excess silently truncated. A row whose track has no `url`
276
- * is a pure preview: its header is not tappable.
488
+ * - **End of stream** (iOS): a live track "ending" is judged a dropped
489
+ * broadcast and recovered by rejoining the edge, never a queue advance.
490
+ * - **Stall recovery** (iOS): a live track that runs dry reconnects at
491
+ * the edge; a non-live one resumes its existing connection.
492
+ * - **`seekToLiveEdge()`** (all platforms): the call only acts on a
493
+ * track declared live — without the declaration it is a no-op.
494
+ * - **Persistence** (iOS): no position is stored, so a cold-start resume
495
+ * rejoins the current broadcast instead of seeking a stale timestamp.
496
+ * - **Now-playing** (iOS and Android): non-scrubbing controls; on iOS
497
+ * also the live indicator. On Android the seek command is removed from
498
+ * media controllers, so the notification and Android Auto draw no
499
+ * scrubber.
500
+ * - **Casting** (Android): a cast receiver loads the item as a live
501
+ * stream, at the live edge.
277
502
  *
278
- * On Android Auto: there is no image-row rendering, so the row expands into
279
- * its items as grid-styled rows (artwork tiles where the host honors the
280
- * per-item content-style hint, list rows otherwise) grouped under the
281
- * track's title, followed by the track itself as a browsable "view all"
282
- * link when it has a `url`.
503
+ * On Android, ExoPlayer's own liveness detection covers end of stream
504
+ * and persistence: a dropped live connection surfaces as a load error
505
+ * (never end-of-stream), and persistence keys off the detected liveness.
506
+ * Android Auto has no live badge.
283
507
  *
284
- * On app side: consumable by React Native UI for horizontal thumbnail layouts.
508
+ * Omitting it never breaks playback — it silently breaks these judgment
509
+ * calls. Declare it on every live track.
285
510
  */
286
- imageRow?: ImageRowItem[];
511
+ live?: boolean;
512
+ /**
513
+ * Byte encoding of this track's ICY `StreamTitle` when it is not UTF-8, as
514
+ * an IANA label (`'windows-1251'`, `'windows-874'`, …). Some Shoutcast /
515
+ * Icecast stations send titles in a legacy code page; ICY declares no
516
+ * encoding, so the player's UTF-8 decode fails and falls back to Latin-1,
517
+ * showing mojibake. With this set, a title that came out Latin-1 shaped
518
+ * (every char at or below U+00FF, some at or above U+0080) is re-decoded
519
+ * through ISO-8859-1 with the given charset; this also repairs stations
520
+ * that UTF-8 encoded their legacy bytes. A title already in another script
521
+ * or pure ASCII is left alone. Applies to ICY only: ID3 and HLS timed
522
+ * metadata declare their own encoding and are never touched. A label the
523
+ * platform cannot decode with is ignored.
524
+ */
525
+ icyCharset?: string;
287
526
  }
288
527
  /**
289
528
  * A Track that has been resolved with its children through browsing.
@@ -295,21 +534,40 @@ export interface Track {
295
534
  * ```ts
296
535
  * // navigate() is fire-and-forget (returns void); read the resolved page
297
536
  * // from getContent() / useContent() / onContentChanged.
298
- * navigate('albums/abbey-road');
537
+ * navigate('/albums/abbey-road');
299
538
  * const resolved = getContent();
300
- * console.log(resolved?.url); // "albums/abbey-road"
539
+ * console.log(resolved?.path); // "/albums/abbey-road"
301
540
  * console.log(resolved?.title); // "Abbey Road"
302
- * console.log(resolved?.children); // Array of tracks in this album
541
+ * console.log(resolved?.sections); // the album's tracks, as sections
303
542
  * ```
304
543
  */
305
544
  export interface ResolvedTrack extends Track {
306
545
  /**
307
- * URL path for this resolved track. Always present since you navigated to this location.
546
+ * Browse path of this resolved track. Always present since you navigated to this location.
547
+ */
548
+ path: string;
549
+ /**
550
+ * A page is a Track that is also the container of its sections, so its
551
+ * block widens to {@link SectionStyle}: the declaration for the whole
552
+ * page. Item properties set here are inherited by every item on the
553
+ * page unless a section or track declares its own; the container
554
+ * properties (`gridWrap`, `gridTile`) and the positional `display` are
555
+ * the page-wide values a section overrides for its own children.
556
+ */
557
+ style?: SectionStyle;
558
+ /**
559
+ * The page's sections — the canonical resolved shape. Every resolved page
560
+ * with content carries `sections`; a page authored with plain `children`
561
+ * resolves to a single untitled section.
308
562
  */
309
- url: string;
563
+ sections?: Section[];
310
564
  /**
311
- * Immediate children of this track. Present for container tracks (albums, playlists, folders).
312
- * Undefined for leaf tracks (individual songs without children).
565
+ * Authoring sugar for a flat page: equivalent to declaring one untitled,
566
+ * style-less section holding these tracks (which therefore takes the
567
+ * page block's scope-wide values, like any undeclared section). Accepted
568
+ * anywhere a page is authored (static routes, browse callbacks, JSON
569
+ * payloads); never populated on a *resolved* page — read `sections`
570
+ * instead.
313
571
  */
314
572
  children?: Track[];
315
573
  /**