react-native-audio-browser 0.2.0-next.8 → 0.2.0-next.80

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 (1246) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +53 -14
  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 +588 -441
  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 +84 -104
  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 +358 -541
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  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 -28
  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 +10 -18
  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 +28 -42
  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 +67 -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 +93 -52
  45. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  46. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  47. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +50 -33
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  50. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +121 -132
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  55. package/android/src/main/java/com/audiobrowser/player/Player.kt +490 -581
  56. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  57. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -23
  58. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +107 -129
  59. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +97 -0
  60. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +49 -128
  61. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  62. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  63. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  64. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  65. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  66. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  67. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  70. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  71. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  72. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +736 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  89. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  90. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  91. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  92. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  93. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  95. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  96. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  97. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  98. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  99. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  100. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  101. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  102. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  103. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  104. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  105. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  106. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  107. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  108. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  109. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  110. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  111. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  112. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  113. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  114. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  115. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  116. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  117. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  118. package/android/src/main/res/values/strings.xml +25 -5
  119. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  120. package/android/src/test/java/androidx/media3/session/SessionViews.kt +10 -0
  121. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  122. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  123. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  124. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  125. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  126. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  127. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  128. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +322 -0
  129. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  130. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  131. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  132. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  133. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  134. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  135. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  136. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  137. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  138. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  139. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  140. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  141. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  142. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  143. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +43 -0
  144. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  145. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  146. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  147. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  148. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  149. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  150. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  151. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  152. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  153. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  154. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  155. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  156. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +372 -0
  157. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  158. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  159. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  160. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  161. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  162. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  163. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  164. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  165. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  166. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  167. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  168. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  169. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  170. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  171. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +478 -0
  172. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +221 -0
  173. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  175. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  176. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +379 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +199 -0
  178. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  179. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +34 -79
  180. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +236 -0
  181. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  182. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +188 -0
  183. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  184. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  185. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  186. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  187. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +308 -0
  188. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  189. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  190. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  191. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1000 -0
  192. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  193. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  194. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  195. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  196. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  197. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  198. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  199. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  200. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  201. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  202. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  203. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  204. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  205. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  206. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  207. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  208. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  209. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  210. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  211. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  212. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  213. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  214. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  215. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  216. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  217. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  218. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  219. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  220. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  221. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  222. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  223. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  224. package/android/src/test/resources/sonos/device_description.xml +78 -0
  225. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  226. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  227. package/ios/AVPlayerEngine.swift +363 -0
  228. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  229. package/ios/Browser/BrowseGate.swift +57 -0
  230. package/ios/Browser/BrowserConfig.swift +123 -104
  231. package/ios/Browser/BrowserError.swift +15 -0
  232. package/ios/Browser/BrowserManager.swift +153 -675
  233. package/ios/Browser/BrowserPathHelper.swift +54 -117
  234. package/ios/Browser/FavoriteSet.swift +43 -0
  235. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  236. package/ios/Browser/JsonModels.swift +244 -335
  237. package/ios/Browser/NavigationErrorState.swift +42 -0
  238. package/ios/Browser/PageResolver.swift +132 -0
  239. package/ios/Browser/RequestLayer.swift +181 -0
  240. package/ios/Browser/RequestPipeline.swift +295 -0
  241. package/ios/Browser/SearchDrillIn.swift +10 -16
  242. package/ios/Browser/SectionScope.swift +73 -26
  243. package/ios/Browser/SimpleRouter.swift +76 -154
  244. package/ios/Browser/StyleResolver.swift +41 -0
  245. package/ios/Browser/TabBarEntries.swift +8 -7
  246. package/ios/Browser/TrackIdTemplate.swift +29 -0
  247. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  248. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  249. package/ios/CarPlay/CarPlayController.swift +37 -1297
  250. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  251. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  252. package/ios/CarPlay/CarPlayNowPlayingManager.swift +130 -205
  253. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  254. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  255. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  256. package/ios/CarPlay/CarPlaySession+TabBar.swift +187 -0
  257. package/ios/CarPlay/CarPlaySession.swift +203 -0
  258. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  259. package/ios/CarPlay/IntentHandlers.swift +94 -0
  260. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  261. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +9 -16
  262. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  263. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  264. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  265. package/ios/CarPlay/SectionPresentation.swift +67 -0
  266. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  267. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  268. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  269. package/ios/Extension/CxxVectorConformances.swift +4 -16
  270. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  271. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  272. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  273. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  274. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  275. package/ios/Extension/SearchParams+Query.swift +28 -0
  276. package/ios/Extension/Section+Copying.swift +26 -0
  277. package/ios/Extension/String+IcyCharset.swift +21 -0
  278. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  279. package/ios/Extension/Track+AVPlayer.swift +1 -18
  280. package/ios/Extension/Track+Copying.swift +13 -21
  281. package/ios/Extension/Track+Identity.swift +20 -0
  282. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  283. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  284. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  285. package/ios/Extension/URLError+Connectivity.swift +15 -0
  286. package/ios/Extension/Variant+Artwork.swift +8 -22
  287. package/ios/Http/HttpClient.swift +73 -167
  288. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  289. package/ios/HybridAudioBrowser+Options.swift +116 -0
  290. package/ios/HybridAudioBrowser+Player.swift +347 -0
  291. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  292. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  293. package/ios/HybridAudioBrowser.swift +148 -1689
  294. package/ios/Model/NitroTypeStubs.swift +240 -32
  295. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  296. package/ios/Model/RemoteCommand.swift +6 -78
  297. package/ios/Model/TrackPlayerError.swift +12 -21
  298. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  299. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  300. package/ios/Observer/ItemObserver.swift +92 -0
  301. package/ios/Observer/PlayerObserver.swift +59 -0
  302. package/ios/Option/SessionCategories.swift +41 -92
  303. package/ios/PlaybackEvent.swift +4 -2
  304. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  305. package/ios/Player/AudioSessionController.swift +190 -0
  306. package/ios/Player/DeferredSeek.swift +73 -0
  307. package/ios/Player/ErrorStatus.swift +52 -0
  308. package/ios/Player/MediaLoader.swift +73 -98
  309. package/ios/Player/NowPlayingLines.swift +49 -0
  310. package/ios/Player/NowPlayingUpdater.swift +180 -105
  311. package/ios/Player/PersistedPlaybackState.swift +1 -2
  312. package/ios/Player/PlaybackFailure.swift +121 -0
  313. package/ios/Player/PlaybackPersistence.swift +72 -0
  314. package/ios/Player/PlaybackStateMachine.swift +11 -11
  315. package/ios/Player/PlaybackTimer.swift +11 -8
  316. package/ios/Player/Player.swift +1010 -0
  317. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  318. package/ios/Player/PlayerEngine.swift +109 -0
  319. package/ios/Player/PlayerStatusTypes.swift +1 -6
  320. package/ios/Player/QueueManager.swift +80 -98
  321. package/ios/Player/ReconnectPacer.swift +83 -0
  322. package/ios/Player/RetryLoop.swift +334 -0
  323. package/ios/Player/ShuffleOrder.swift +36 -43
  324. package/ios/Player/SilenceBudget.swift +78 -0
  325. package/ios/Player/SleepTimerManager.swift +25 -42
  326. package/ios/Player/VolumeFader.swift +20 -15
  327. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  328. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  329. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  330. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  331. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  332. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  333. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  334. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  335. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  336. package/ios/Tests/DeferredSeekTests.swift +76 -0
  337. package/ios/Tests/EmitterTests.swift +22 -39
  338. package/ios/Tests/ErrorStatusTests.swift +50 -0
  339. package/ios/Tests/FavoriteSetTests.swift +61 -0
  340. package/ios/Tests/GenerationMemoTests.swift +178 -0
  341. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  342. package/ios/Tests/JsonModelsTests.swift +189 -3
  343. package/ios/Tests/LRUCacheTests.swift +106 -0
  344. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  345. package/ios/Tests/MediaLoaderTests.swift +38 -78
  346. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  347. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  348. package/ios/Tests/ObserverTests.swift +88 -0
  349. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  350. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  351. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  352. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  353. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  354. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  355. package/ios/Tests/PlayerPolicyTests.swift +991 -0
  356. package/ios/Tests/PlayerTests.swift +1719 -0
  357. package/ios/Tests/PlayingStateTests.swift +41 -0
  358. package/ios/Tests/QueueManagerTests.swift +205 -174
  359. package/ios/Tests/ReadyValueTests.swift +73 -0
  360. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  361. package/ios/Tests/RequestLayerTests.swift +228 -0
  362. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  363. package/ios/Tests/RetryCaseTests.swift +146 -0
  364. package/ios/Tests/RetryLoopTests.swift +307 -0
  365. package/ios/Tests/SearchDrillInTests.swift +16 -17
  366. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  367. package/ios/Tests/SectionPresentationTests.swift +85 -0
  368. package/ios/Tests/SectionScopeTests.swift +136 -54
  369. package/ios/Tests/SimpleRouterTests.swift +39 -8
  370. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  371. package/ios/Tests/StyleResolverTests.swift +123 -0
  372. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  373. package/ios/Tests/Support/TestTypes.swift +152 -100
  374. package/ios/Tests/Support/TimeLimit.swift +43 -0
  375. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  376. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  377. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  378. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  379. package/ios/Tests/TrackIdentityTests.swift +20 -0
  380. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  381. package/ios/Tests/TrackSelectorTests.swift +157 -34
  382. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  383. package/ios/TrackSelector.swift +62 -77
  384. package/ios/Util/ArtworkFreshness.swift +42 -0
  385. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  386. package/ios/Util/AwaitCallback.swift +80 -0
  387. package/ios/Util/ConcurrentMap.swift +19 -0
  388. package/ios/Util/Emitter.swift +45 -22
  389. package/ios/Util/GenerationMemo.swift +43 -0
  390. package/ios/Util/LRUCache.swift +23 -159
  391. package/ios/Util/NetworkMonitor.swift +31 -33
  392. package/ios/Util/OutputPicker.swift +48 -0
  393. package/ios/Util/ReadyValue.swift +57 -0
  394. package/ios/Util/SFSymbolRenderer.swift +64 -49
  395. package/ios/Util/SVGProcessor.swift +9 -16
  396. package/lib/commonjs/AudioBrowser.js +11 -0
  397. package/lib/commonjs/AudioBrowser.js.map +1 -1
  398. package/lib/commonjs/CLAUDE.md +57 -0
  399. package/lib/commonjs/features/battery.js +16 -12
  400. package/lib/commonjs/features/battery.js.map +1 -1
  401. package/lib/commonjs/features/browser-config.js +13 -9
  402. package/lib/commonjs/features/browser-config.js.map +1 -1
  403. package/lib/commonjs/features/browser.js +78 -20
  404. package/lib/commonjs/features/browser.js.map +1 -1
  405. package/lib/commonjs/features/carConnection.js +3 -4
  406. package/lib/commonjs/features/carConnection.js.map +1 -1
  407. package/lib/commonjs/features/equalizer.js +9 -5
  408. package/lib/commonjs/features/equalizer.js.map +1 -1
  409. package/lib/commonjs/features/errors.js +35 -21
  410. package/lib/commonjs/features/errors.js.map +1 -1
  411. package/lib/commonjs/features/favorites.js +28 -23
  412. package/lib/commonjs/features/favorites.js.map +1 -1
  413. package/lib/commonjs/features/gate.js +27 -6
  414. package/lib/commonjs/features/gate.js.map +1 -1
  415. package/lib/commonjs/features/metadata.js +61 -11
  416. package/lib/commonjs/features/metadata.js.map +1 -1
  417. package/lib/commonjs/features/network.js +5 -1
  418. package/lib/commonjs/features/network.js.map +1 -1
  419. package/lib/commonjs/features/nowPlaying.js +28 -14
  420. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  421. package/lib/commonjs/features/output.js +9 -4
  422. package/lib/commonjs/features/output.js.map +1 -1
  423. package/lib/commonjs/features/playback/controls.js +13 -6
  424. package/lib/commonjs/features/playback/controls.js.map +1 -1
  425. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  426. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  427. package/lib/commonjs/features/playback/playing.js +5 -3
  428. package/lib/commonjs/features/playback/playing.js.map +1 -1
  429. package/lib/commonjs/features/playback/progress.js +13 -6
  430. package/lib/commonjs/features/playback/progress.js.map +1 -1
  431. package/lib/commonjs/features/playback/rate.js +8 -1
  432. package/lib/commonjs/features/playback/rate.js.map +1 -1
  433. package/lib/commonjs/features/playback/state.js +5 -6
  434. package/lib/commonjs/features/playback/state.js.map +1 -1
  435. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  436. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  437. package/lib/commonjs/features/playback/volume.js +6 -5
  438. package/lib/commonjs/features/playback/volume.js.map +1 -1
  439. package/lib/commonjs/features/player/options.js +21 -11
  440. package/lib/commonjs/features/player/options.js.map +1 -1
  441. package/lib/commonjs/features/player/setup.js +39 -39
  442. package/lib/commonjs/features/player/setup.js.map +1 -1
  443. package/lib/commonjs/features/player/validateOptions.js +3 -4
  444. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  445. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  446. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  447. package/lib/commonjs/features/queue/queue.js +56 -21
  448. package/lib/commonjs/features/queue/queue.js.map +1 -1
  449. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  450. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  451. package/lib/commonjs/features/queue/shuffle.js +0 -1
  452. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  453. package/lib/commonjs/features/remoteControls.js +59 -35
  454. package/lib/commonjs/features/remoteControls.js.map +1 -1
  455. package/lib/commonjs/features/sleepTimer.js +23 -6
  456. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  457. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  458. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  459. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  460. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  461. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  462. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  463. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  464. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  465. package/lib/commonjs/utils/useDebug.js +16 -3
  466. package/lib/commonjs/utils/useDebug.js.map +1 -1
  467. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  468. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  469. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  470. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  471. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  472. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  473. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  474. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  475. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  476. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  477. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  478. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  479. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  480. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  481. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  482. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  483. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  484. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  485. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  486. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  487. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  488. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  489. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  490. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  491. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  492. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  493. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  494. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  495. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  496. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  497. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  498. package/lib/commonjs/web/browser/sections.js +89 -0
  499. package/lib/commonjs/web/browser/sections.js.map +1 -0
  500. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  501. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  502. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  503. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  504. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  505. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  506. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  507. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  508. package/lib/module/AudioBrowser.js +2 -4
  509. package/lib/module/AudioBrowser.js.map +1 -1
  510. package/lib/module/CLAUDE.md +57 -0
  511. package/lib/module/features/battery.js +16 -12
  512. package/lib/module/features/battery.js.map +1 -1
  513. package/lib/module/features/browser-config.js +13 -9
  514. package/lib/module/features/browser-config.js.map +1 -1
  515. package/lib/module/features/browser.js +78 -20
  516. package/lib/module/features/browser.js.map +1 -1
  517. package/lib/module/features/carConnection.js +3 -4
  518. package/lib/module/features/carConnection.js.map +1 -1
  519. package/lib/module/features/equalizer.js +9 -5
  520. package/lib/module/features/equalizer.js.map +1 -1
  521. package/lib/module/features/errors.js +35 -21
  522. package/lib/module/features/errors.js.map +1 -1
  523. package/lib/module/features/favorites.js +28 -23
  524. package/lib/module/features/favorites.js.map +1 -1
  525. package/lib/module/features/gate.js +27 -6
  526. package/lib/module/features/gate.js.map +1 -1
  527. package/lib/module/features/metadata.js +59 -11
  528. package/lib/module/features/metadata.js.map +1 -1
  529. package/lib/module/features/network.js +5 -1
  530. package/lib/module/features/network.js.map +1 -1
  531. package/lib/module/features/nowPlaying.js +28 -14
  532. package/lib/module/features/nowPlaying.js.map +1 -1
  533. package/lib/module/features/output.js +9 -4
  534. package/lib/module/features/output.js.map +1 -1
  535. package/lib/module/features/playback/controls.js +13 -6
  536. package/lib/module/features/playback/controls.js.map +1 -1
  537. package/lib/module/features/playback/playWhenReady.js +6 -5
  538. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  539. package/lib/module/features/playback/playing.js +5 -3
  540. package/lib/module/features/playback/playing.js.map +1 -1
  541. package/lib/module/features/playback/progress.js +13 -6
  542. package/lib/module/features/playback/progress.js.map +1 -1
  543. package/lib/module/features/playback/rate.js +8 -1
  544. package/lib/module/features/playback/rate.js.map +1 -1
  545. package/lib/module/features/playback/state.js +5 -6
  546. package/lib/module/features/playback/state.js.map +1 -1
  547. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  548. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  549. package/lib/module/features/playback/volume.js +6 -5
  550. package/lib/module/features/playback/volume.js.map +1 -1
  551. package/lib/module/features/player/options.js +21 -11
  552. package/lib/module/features/player/options.js.map +1 -1
  553. package/lib/module/features/player/setup.js +39 -39
  554. package/lib/module/features/player/setup.js.map +1 -1
  555. package/lib/module/features/player/validateOptions.js +3 -4
  556. package/lib/module/features/player/validateOptions.js.map +1 -1
  557. package/lib/module/features/queue/activeTrack.js +14 -4
  558. package/lib/module/features/queue/activeTrack.js.map +1 -1
  559. package/lib/module/features/queue/queue.js +56 -21
  560. package/lib/module/features/queue/queue.js.map +1 -1
  561. package/lib/module/features/queue/repeatMode.js +2 -1
  562. package/lib/module/features/queue/repeatMode.js.map +1 -1
  563. package/lib/module/features/queue/shuffle.js +0 -1
  564. package/lib/module/features/queue/shuffle.js.map +1 -1
  565. package/lib/module/features/remoteControls.js +59 -35
  566. package/lib/module/features/remoteControls.js.map +1 -1
  567. package/lib/module/features/sleepTimer.js +24 -7
  568. package/lib/module/features/sleepTimer.js.map +1 -1
  569. package/lib/module/test-utils/reactNativeStub.js +58 -0
  570. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  571. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  572. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  573. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  574. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  575. package/lib/module/utils/getTrackIdentity.js +22 -0
  576. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  577. package/lib/module/utils/useDebug.js +16 -3
  578. package/lib/module/utils/useDebug.js.map +1 -1
  579. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  580. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  581. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  582. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  583. package/lib/module/web/NativeAudioBrowser.js +207 -84
  584. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  585. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  586. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  587. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  588. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  589. package/lib/module/web/TrackPlayer/Player.js +256 -40
  590. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  591. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  592. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  593. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  594. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  595. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  596. package/lib/module/web/browser/BrowserManager.js +175 -100
  597. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  598. package/lib/module/web/browser/FavoriteManager.js +31 -21
  599. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  600. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  601. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  602. package/lib/module/web/browser/SearchManager.js +18 -23
  603. package/lib/module/web/browser/SearchManager.js.map +1 -1
  604. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  605. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  606. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  607. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  608. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  609. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  610. package/lib/module/web/browser/sections.js +83 -0
  611. package/lib/module/web/browser/sections.js.map +1 -0
  612. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  613. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  614. package/lib/module/web/http/followMediaRedirect.js +215 -0
  615. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  616. package/lib/module/web/player/NowPlayingManager.js +4 -3
  617. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  618. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  619. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  620. package/lib/typescript/package.json +1 -0
  621. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  622. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  623. package/lib/typescript/src/features/battery.d.ts +17 -12
  624. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  625. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  626. package/lib/typescript/src/features/browser.d.ts +67 -19
  627. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  628. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  629. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  630. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  631. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  632. package/lib/typescript/src/features/errors.d.ts +37 -22
  633. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  634. package/lib/typescript/src/features/favorites.d.ts +28 -23
  635. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  636. package/lib/typescript/src/features/gate.d.ts +29 -8
  637. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  638. package/lib/typescript/src/features/metadata.d.ts +65 -14
  639. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  640. package/lib/typescript/src/features/network.d.ts +5 -1
  641. package/lib/typescript/src/features/network.d.ts.map +1 -1
  642. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  643. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  644. package/lib/typescript/src/features/output.d.ts +9 -4
  645. package/lib/typescript/src/features/output.d.ts.map +1 -1
  646. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  647. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  649. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  650. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  651. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  652. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  653. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  654. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  655. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  656. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  657. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  658. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  659. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  660. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  661. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  662. package/lib/typescript/src/features/player/options.d.ts +73 -56
  663. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  664. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  665. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  666. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  667. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  668. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  669. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  670. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  671. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  672. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  673. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  674. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  675. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  676. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  677. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  678. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  679. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  680. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  681. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  682. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  683. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  684. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  685. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  686. package/lib/typescript/src/types/browser.d.ts +242 -173
  687. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  688. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  689. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  690. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  691. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  692. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  693. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  694. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  695. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  696. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  697. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  698. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  699. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  700. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  701. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  702. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  703. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  704. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  707. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  710. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  711. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  713. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  717. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  718. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  720. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  722. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  724. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  726. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  727. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  730. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  731. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  732. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  733. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  734. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  736. 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
  737. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  738. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  740. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  741. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  742. 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
  743. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  747. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  748. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  752. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  755. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  763. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  766. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  776. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  777. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  780. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  782. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  784. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  785. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  790. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  793. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  796. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  799. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  801. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  802. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  803. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  804. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  807. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  810. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  813. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  815. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  817. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  825. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  826. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  828. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  829. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  832. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  835. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  838. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  840. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  842. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  844. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  845. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  846. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  850. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  852. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  853. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  854. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  856. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  857. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  858. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  859. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  860. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  861. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  862. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  882. 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
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  889. 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
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  892. 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
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  895. 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
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1001. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1002. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1003. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1004. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1005. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1006. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1007. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1008. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1009. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1010. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1011. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1012. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1013. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1014. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1015. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1016. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1017. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1018. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1019. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1020. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1021. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1022. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1023. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1024. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1025. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1026. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1027. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1028. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1029. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1030. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1031. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1032. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1034. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1035. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1036. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1037. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1038. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1039. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1040. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1041. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1042. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1043. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1044. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1045. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1046. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1047. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1048. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1049. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1050. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1051. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1052. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1053. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1054. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1055. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1056. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1057. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1058. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1059. package/package.json +26 -13
  1060. package/src/AudioBrowser.ts +2 -4
  1061. package/src/CLAUDE.md +57 -0
  1062. package/src/docs-floors.test.ts +71 -0
  1063. package/src/features/battery.test.ts +79 -0
  1064. package/src/features/battery.ts +17 -13
  1065. package/src/features/browser-config.test.ts +21 -6
  1066. package/src/features/browser-config.ts +13 -9
  1067. package/src/features/browser.test.ts +1 -1
  1068. package/src/features/browser.ts +69 -20
  1069. package/src/features/carConnection.ts +3 -4
  1070. package/src/features/equalizer.ts +9 -5
  1071. package/src/features/errors.ts +37 -22
  1072. package/src/features/favorites.ts +28 -23
  1073. package/src/features/gate.ts +29 -8
  1074. package/src/features/hook-wiring.test.ts +302 -0
  1075. package/src/features/metadata.ts +80 -14
  1076. package/src/features/network.ts +5 -1
  1077. package/src/features/nowPlaying.ts +28 -14
  1078. package/src/features/output.ts +9 -4
  1079. package/src/features/playback/controls.ts +13 -6
  1080. package/src/features/playback/playWhenReady.ts +6 -5
  1081. package/src/features/playback/playing.ts +16 -3
  1082. package/src/features/playback/progress.test.ts +169 -0
  1083. package/src/features/playback/progress.ts +13 -6
  1084. package/src/features/playback/rate.ts +8 -1
  1085. package/src/features/playback/state.ts +10 -6
  1086. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1087. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1088. package/src/features/playback/volume.ts +6 -5
  1089. package/src/features/player/options.ts +82 -63
  1090. package/src/features/player/setup.test.ts +12 -3
  1091. package/src/features/player/setup.ts +122 -63
  1092. package/src/features/player/validateOptions.ts +3 -4
  1093. package/src/features/queue/activeTrack.ts +14 -4
  1094. package/src/features/queue/queue.ts +56 -21
  1095. package/src/features/queue/repeatMode.ts +1 -1
  1096. package/src/features/queue/shuffle.ts +0 -1
  1097. package/src/features/remoteControls.ts +59 -35
  1098. package/src/features/sleepTimer.test.ts +171 -0
  1099. package/src/features/sleepTimer.ts +24 -8
  1100. package/src/nitro-stub-drift.test.ts +277 -0
  1101. package/src/public-surface.test.ts +56 -25
  1102. package/src/specs/audio-browser.nitro.ts +15 -8
  1103. package/src/style-resolution.test.ts +210 -0
  1104. package/src/test-utils/reactNativeStub.ts +60 -0
  1105. package/src/types/browser-native.ts +7 -3
  1106. package/src/types/browser-nodes.ts +417 -151
  1107. package/src/types/browser.ts +248 -177
  1108. package/src/utils/LazyNativeEmitter.ts +17 -10
  1109. package/src/utils/NativeUpdatedValue.ts +30 -16
  1110. package/src/utils/getTrackIdentity.ts +22 -0
  1111. package/src/utils/useDebug.test.ts +182 -0
  1112. package/src/utils/useDebug.ts +16 -3
  1113. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1114. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1115. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1116. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1117. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1118. package/src/web/NativeAudioBrowser.ts +247 -92
  1119. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1120. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1121. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1122. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1123. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1124. package/src/web/TrackPlayer/Player.ts +286 -38
  1125. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1126. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1127. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1128. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1129. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1130. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1131. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1132. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1133. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1134. package/src/web/__tests__/retry.test.ts +169 -0
  1135. package/src/web/browser/BrowserManager.ts +209 -111
  1136. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1137. package/src/web/browser/FavoriteManager.ts +28 -23
  1138. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1139. package/src/web/browser/SearchManager.test.ts +75 -0
  1140. package/src/web/browser/SearchManager.ts +25 -28
  1141. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1142. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1143. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1144. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1145. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1146. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1147. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1148. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1149. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1150. package/src/web/browser/parseSearchResponse.ts +3 -4
  1151. package/src/web/browser/sections.test.ts +91 -0
  1152. package/src/web/browser/sections.ts +72 -0
  1153. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1154. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1155. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1156. package/src/web/http/followMediaRedirect.ts +253 -0
  1157. package/src/web/player/NowPlayingManager.ts +4 -3
  1158. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1159. package/src/web/util/BrowserPathHelper.ts +68 -13
  1160. package/website/guide/android-auto.md +126 -0
  1161. package/website/guide/android-certificates.md +488 -0
  1162. package/website/guide/artwork.md +300 -0
  1163. package/website/guide/audio-output.md +357 -0
  1164. package/website/guide/automotive.md +91 -0
  1165. package/website/guide/basic-usage.md +154 -0
  1166. package/website/guide/battery.md +142 -0
  1167. package/website/guide/browser.md +674 -0
  1168. package/website/guide/carplay.md +733 -0
  1169. package/website/guide/configuration.md +215 -0
  1170. package/website/guide/equalizer.md +235 -0
  1171. package/website/guide/errors.md +355 -0
  1172. package/website/guide/favorites.md +164 -0
  1173. package/website/guide/gate.md +157 -0
  1174. package/website/guide/getting-started.md +99 -0
  1175. package/website/guide/hooks.md +247 -0
  1176. package/website/guide/live-streams.md +156 -0
  1177. package/website/guide/metadata.md +289 -0
  1178. package/website/guide/migrating-from-track-player.md +289 -0
  1179. package/website/guide/native-callback-fetch.md +137 -0
  1180. package/website/guide/network.md +102 -0
  1181. package/website/guide/now-playing.md +203 -0
  1182. package/website/guide/playback.md +405 -0
  1183. package/website/guide/queue.md +334 -0
  1184. package/website/guide/remote-controls.md +314 -0
  1185. package/website/guide/search.md +270 -0
  1186. package/website/guide/sleep-timer.md +289 -0
  1187. package/website/guide/track.md +271 -0
  1188. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1189. package/ios/Bridge.h +0 -8
  1190. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1191. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1192. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1193. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1194. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1195. package/ios/Model/MediaURL.swift +0 -67
  1196. package/ios/Model/SourceType.swift +0 -6
  1197. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1198. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1199. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1200. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1201. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1202. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1203. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1204. package/ios/Option/PitchAlgorithms.swift +0 -17
  1205. package/ios/Option/TimeEventFrequency.swift +0 -18
  1206. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1207. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1208. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1209. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1210. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1211. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1212. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1213. package/ios/Player/PlaybackStateStore.swift +0 -27
  1214. package/ios/Player/PlayingStateManager.swift +0 -33
  1215. package/ios/Player/RetryManager.swift +0 -323
  1216. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1217. package/ios/Player/SleepTimerHandling.swift +0 -15
  1218. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1219. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1220. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1221. package/ios/Tests/MediaResolveTests.swift +0 -126
  1222. package/ios/Tests/OnceValueTests.swift +0 -79
  1223. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1224. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1225. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1226. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1227. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1228. package/ios/Tests/RetryManagerTests.swift +0 -89
  1229. package/ios/TrackPlayer.swift +0 -1014
  1230. package/ios/TrackPlayerCallbacks.swift +0 -53
  1231. package/ios/Util/MetadataAdapter.swift +0 -131
  1232. package/ios/Util/OnceValue.swift +0 -104
  1233. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1234. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1235. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1236. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1237. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1238. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1239. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1240. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1241. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1242. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1243. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1244. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1245. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1246. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -0,0 +1,277 @@
1
+ import { readFileSync } from 'node:fs'
2
+ import { join } from 'node:path'
3
+ import { describe, it, expect } from 'vitest'
4
+
5
+ /**
6
+ * Drift guard for `ios/Model/NitroTypeStubs.swift`.
7
+ *
8
+ * The generated Nitro Swift types are `typealias`es onto C++ structs
9
+ * (`margelo.nitro.audiobrowser.*`), so SwiftPM cannot compile them without the
10
+ * whole Nitro C++ core — which is why the SPM test target substitutes
11
+ * hand-written stubs behind `#if !canImport(NitroModules)`. The cost of that
12
+ * trick is that the stubs can disagree with the real types, and when they do
13
+ * `swift test` still passes while the app build breaks. That has already
14
+ * happened once (1d2edade, "restore the SPM test-stub build after the artwork
15
+ * variants change").
16
+ *
17
+ * Neither native CI job can catch it: the Swift job only ever sees the stubs,
18
+ * and the app build only ever sees the generated types. This test is the one
19
+ * place both files are readable at once, so the check lives here.
20
+ *
21
+ * The rule is subset-with-exact-types. A stub may declare FEWER properties than
22
+ * the real type — shared `ios/` sources can only use what the stub declares, so
23
+ * an omission is safe. What is not safe is a property the real type spells
24
+ * differently: `var id: String` against a generated `id: String?` compiles under
25
+ * test and fails to compile in the app.
26
+ */
27
+ const ROOT = process.cwd()
28
+ const STUBS = join(ROOT, 'ios', 'Model', 'NitroTypeStubs.swift')
29
+ const GENERATED = join(ROOT, 'nitrogen', 'generated', 'ios', 'swift')
30
+
31
+ /**
32
+ * Stubbed types with no generated counterpart, and why. Anything else missing
33
+ * from `nitrogen/generated/ios/swift/` is a stub for a type that no longer
34
+ * exists — the loudest kind of drift.
35
+ */
36
+ const NOT_GENERATED: Record<string, string> = {
37
+ // Nitro core type (`nitro::NullType`), shipped by NitroModules rather than
38
+ // emitted per-project, so there is no file of ours to compare against.
39
+ NullType: 'provided by NitroModules core'
40
+ }
41
+
42
+ type Struct = { kind: 'struct'; members: Map<string, string> }
43
+ type Enum = { kind: 'enum'; members: Map<string, string> }
44
+ type Shape = Struct | Enum
45
+
46
+ /** Splits a parameter/case list on top-level commas, ignoring `[]`, `()`, `<>`. */
47
+ function splitTopLevel(text: string): string[] {
48
+ const parts: string[] = []
49
+ let depth = 0
50
+ let current = ''
51
+ for (const char of text) {
52
+ if (char === '[' || char === '(' || char === '<') depth++
53
+ else if (char === ']' || char === ')' || char === '>') depth--
54
+ if (char === ',' && depth === 0) {
55
+ parts.push(current)
56
+ current = ''
57
+ } else current += char
58
+ }
59
+ if (current.trim()) parts.push(current)
60
+ return parts.map((part) => part.trim()).filter(Boolean)
61
+ }
62
+
63
+ /** `label: Type` → [label, Type]. Splits on the FIRST colon (`[String: String]`). */
64
+ function splitLabelled(part: string): [string, string] | null {
65
+ const colon = part.indexOf(':')
66
+ if (colon < 0) return null
67
+ const label = part.slice(0, colon).trim()
68
+ // A generated init can carry both an argument label and a parameter name
69
+ // (`for value: String`); the property name is the last word before the colon.
70
+ const name = label.split(/\s+/).pop()!
71
+ return [name, part.slice(colon + 1).trim()]
72
+ }
73
+
74
+ const DECL =
75
+ /^\s*(?:(?:public|@frozen|indirect|final)\s+)*(struct|enum)\s+([A-Za-z_]\w*)\s*(?::[^{]*)?\{/
76
+
77
+ /** Parses every top-level `struct`/`enum` in a Swift file into its member map. */
78
+ function parseSwiftDecls(source: string): Map<string, Shape> {
79
+ const shapes = new Map<string, Shape>()
80
+ const lines = source.split('\n')
81
+
82
+ for (let i = 0; i < lines.length; i++) {
83
+ const decl = DECL.exec(lines[i]!)
84
+ if (!decl) continue
85
+ const keyword = decl[1]!
86
+ const name = decl[2]!
87
+ const members = new Map<string, string>()
88
+ let depth = 1
89
+
90
+ for (let j = i + 1; j < lines.length && depth > 0; j++) {
91
+ const body = lines[j]!.replace(/\/\/.*$/, '')
92
+
93
+ if (depth === 1) {
94
+ // Stored property: `var name: Type`, but not a computed one (`{` after).
95
+ const prop =
96
+ /^\s*(?:public\s+)?var\s+([A-Za-z_]\w*)\s*:\s*([^={]+?)\s*(?:=|$)/.exec(
97
+ body
98
+ )
99
+ if (prop && !/\{\s*$/.test(body)) members.set(prop[1]!, prop[2]!.trim())
100
+
101
+ // `case a`, `case a(T)`, `case a, b`
102
+ const enumCase = /^\s*case\s+(.+)$/.exec(body)
103
+ if (enumCase && keyword === 'enum') {
104
+ for (const one of splitTopLevel(enumCase[1]!)) {
105
+ const withPayload = /^([A-Za-z_]\w*)\s*\((.*)\)$/.exec(one)
106
+ if (withPayload)
107
+ members.set(withPayload[1]!, withPayload[2]!.trim())
108
+ else if (/^[A-Za-z_]\w*$/.test(one)) members.set(one, '')
109
+ }
110
+ }
111
+ }
112
+
113
+ for (const char of body) {
114
+ if (char === '{') depth++
115
+ else if (char === '}') depth--
116
+ }
117
+ }
118
+
119
+ shapes.set(name, {
120
+ kind: keyword === 'struct' ? 'struct' : 'enum',
121
+ members
122
+ } as Shape)
123
+ }
124
+ return shapes
125
+ }
126
+
127
+ /**
128
+ * Reads the real shape of a generated type. Nitro emits three forms: a struct
129
+ * (memberwise `init`), a string-backed enum (`init?(fromString:)`), and a
130
+ * variant (a plain `enum` with `first`/`second`/… payload cases).
131
+ */
132
+ function parseGenerated(name: string): Shape | null {
133
+ let source: string
134
+ try {
135
+ source = readFileSync(join(GENERATED, `${name}.swift`), 'utf8')
136
+ } catch {
137
+ return null
138
+ }
139
+
140
+ // Variant enums are declared outright, so the generic parser sees them.
141
+ const declared = parseSwiftDecls(source).get(name)
142
+ if (declared && declared.members.size > 0) return declared
143
+
144
+ // String-backed enum. Read the case names off the `stringValue` switch, which
145
+ // spells them out (`case .get: return "GET"`), rather than deriving them from
146
+ // the JS values — nitrogen's casing rule is not ours to reimplement.
147
+ if (source.includes('var stringValue: String')) {
148
+ const members = new Map<string, string>()
149
+ for (const match of source.matchAll(/case\s+\.(\w+)\s*:/g))
150
+ members.set(match[1]!, '')
151
+ return { kind: 'enum', members }
152
+ }
153
+
154
+ const init = /^\s*init\((.*)\)\s*\{/m.exec(source)
155
+ if (init) {
156
+ const members = new Map<string, string>()
157
+ for (const part of splitTopLevel(init[1]!)) {
158
+ const labelled = splitLabelled(part)
159
+ if (labelled) members.set(labelled[0], labelled[1])
160
+ }
161
+ return { kind: 'struct', members }
162
+ }
163
+
164
+ return null
165
+ }
166
+
167
+ /**
168
+ * Sugared and desugared spellings are the same Swift type — nitrogen emits
169
+ * `Dictionary<String, String>` where the stubs write `[String: String]`.
170
+ */
171
+ function normalizeType(type: string): string {
172
+ let previous: string
173
+ let current = type.replace(/\s+/g, ' ').trim()
174
+ do {
175
+ previous = current
176
+ current = current
177
+ .replace(/\bDictionary<([^<>]+),\s*([^<>]+)>/g, '[$1: $2]')
178
+ .replace(/\bArray<([^<>]+)>/g, '[$1]')
179
+ .replace(/\bOptional<([^<>]+)>/g, '$1?')
180
+ } while (current !== previous)
181
+ return current
182
+ }
183
+
184
+ describe('NitroTypeStubs mirror the generated Nitro types', () => {
185
+ const stubs = parseSwiftDecls(readFileSync(STUBS, 'utf8'))
186
+
187
+ it('parses the stub file', () => {
188
+ // A parser that silently matches nothing would make every check below pass.
189
+ expect(stubs.size).toBeGreaterThan(20)
190
+ expect(stubs.get('Track')?.members.get('src')).toBe('String?')
191
+ })
192
+
193
+ it('stubs only types that Nitro actually generates', () => {
194
+ const orphans = [...stubs.keys()].filter(
195
+ (name) => !(name in NOT_GENERATED) && parseGenerated(name) == null
196
+ )
197
+ expect(
198
+ orphans,
199
+ `Stubbed with no generated counterpart in nitrogen/generated/ios/swift — the type was ` +
200
+ `renamed or removed from the Nitro spec, so the stub is standing in for nothing:\n` +
201
+ orphans.join('\n')
202
+ ).toEqual([])
203
+ })
204
+
205
+ it('declares every stubbed property with the generated type', () => {
206
+ const drift: string[] = []
207
+
208
+ for (const [name, stub] of stubs) {
209
+ if (name in NOT_GENERATED) continue
210
+ const real = parseGenerated(name)
211
+ if (real == null) continue // reported by the previous test
212
+
213
+ for (const [member, stubType] of stub.members) {
214
+ const realType = real.members.get(member)
215
+ const what = real.kind === 'enum' ? 'case' : 'property'
216
+ if (realType == null) {
217
+ drift.push(
218
+ `${name}.${member}: stub declares a ${what} the generated type does not have`
219
+ )
220
+ } else if (normalizeType(realType) !== normalizeType(stubType)) {
221
+ drift.push(
222
+ `${name}.${member}: stub \`${stubType || '(no payload)'}\`, ` +
223
+ `generated \`${realType || '(no payload)'}\``
224
+ )
225
+ }
226
+ }
227
+ }
228
+
229
+ expect(
230
+ drift,
231
+ `ios/Model/NitroTypeStubs.swift disagrees with nitrogen/generated/ios/swift. ` +
232
+ `\`swift test\` compiles against the stub and will not catch this; the app build ` +
233
+ `compiles against the generated type and will fail. Fix the stub to match:\n` +
234
+ drift.join('\n')
235
+ ).toEqual([])
236
+ })
237
+
238
+ it('declares struct members in the generated initializer order', () => {
239
+ // Name/type parity is not enough: the stub struct's memberwise init must
240
+ // accept the same ARGUMENT ORDER as the generated labelled init, or shared
241
+ // sources compile under `swift test` and fail in the app build with
242
+ // "argument 'x' must precede argument 'y'" (nitrogen flattens `extends`
243
+ // own-properties-first, which is easy to get backwards — SectionStyle did).
244
+ // A stub may omit members; the ones it declares must be a subsequence of
245
+ // the generated order.
246
+ const misordered: string[] = []
247
+
248
+ for (const [name, stub] of stubs) {
249
+ if (name in NOT_GENERATED || stub.kind !== 'struct') continue
250
+ const real = parseGenerated(name)
251
+ if (real == null || real.kind !== 'struct') continue
252
+
253
+ const realOrder = [...real.members.keys()]
254
+ const stubOrder = [...stub.members.keys()].filter((member) =>
255
+ real.members.has(member)
256
+ )
257
+ let cursor = -1
258
+ for (const member of stubOrder) {
259
+ const index = realOrder.indexOf(member)
260
+ if (index < cursor) {
261
+ misordered.push(
262
+ `${name}: stub declares [${stubOrder.join(', ')}], ` +
263
+ `generated init order is [${realOrder.join(', ')}]`
264
+ )
265
+ break
266
+ }
267
+ cursor = index
268
+ }
269
+ }
270
+
271
+ expect(
272
+ misordered,
273
+ `Stub struct members are out of order relative to the generated init:\n` +
274
+ misordered.join('\n')
275
+ ).toEqual([])
276
+ })
277
+ })
@@ -5,29 +5,22 @@ import { describe, it, expect } from 'vitest'
5
5
  /**
6
6
  * Guard on what `import { … } from 'react-native-audio-browser'` can reach.
7
7
  *
8
- * The package root is a chain of unfiltered `export *` barrels, so every
9
- * `export` in every feature file joins the public surface by default — there is
10
- * no gate to forget to pass, only one to forget to add.
11
- *
12
- * `@internal` alone does not keep a symbol private. It is honoured by
13
- * `stripInternal` when generating `lib/typescript`, which is what a consumer's
14
- * TypeScript sees — but React Native resolves `"react-native": "src/index"`, so
15
- * Metro bundles the *source*, where nothing was stripped. An `@internal` value
16
- * is therefore invisible to the type checker and fully reachable at runtime:
17
- * `require('react-native-audio-browser').nativeBrowser` used to hand out the raw
18
- * Nitro object, whose `on*` properties are the single callback slots the library's
19
- * emitters own — assigning one unsubscribes every hook in the package.
20
- *
21
- * So: values marked `@internal` must not be reachable from the barrel at all.
22
- * Move them to a module the barrel doesn't re-export (see
23
- * `features/player/validateOptions.ts`) and import them directly. Types are
24
- * exempt — they carry no runtime representation, and `stripInternal` genuinely
25
- * removes them from the published `.d.ts`.
8
+ * `@internal` hides a value from the published types but not from the bundle:
9
+ * Metro resolves `"react-native": "src/index"` and compiles the source, where
10
+ * `stripInternal` never ran. Types are exempt — they have no runtime form.
11
+ * `CLAUDE.md` in this directory has the full rule.
26
12
  */
27
13
  const SRC = join(process.cwd(), 'src')
28
14
  const ENTRY = join(SRC, 'index.ts')
29
15
 
30
- const VALUE_KINDS = new Set(['const', 'let', 'var', 'function', 'class', 'enum'])
16
+ const VALUE_KINDS = new Set([
17
+ 'const',
18
+ 'let',
19
+ 'var',
20
+ 'function',
21
+ 'class',
22
+ 'enum'
23
+ ])
31
24
 
32
25
  function resolveModule(fromFile: string, spec: string): string | undefined {
33
26
  const base = resolve(dirname(fromFile), spec.replace(/\.tsx?$/, ''))
@@ -90,10 +83,8 @@ describe('public surface', () => {
90
83
  .map((e) => `${e.name} (${e.file})`)
91
84
  expect(
92
85
  leaked,
93
- 'These values are tagged @internal but are reachable from the package root ' +
94
- 'at runtime — stripInternal only hides them from the published types, and ' +
95
- 'Metro bundles src/. Move each to a module the barrels do not re-export ' +
96
- 'and import it directly:\n' +
86
+ 'Reachable from the package root at runtime despite @internal. Move each ' +
87
+ 'to a module the barrels skip, and import it directly:\n' +
97
88
  leaked.join('\n')
98
89
  ).toEqual([])
99
90
  })
@@ -104,8 +95,8 @@ describe('public surface', () => {
104
95
  .map((e) => `${e.name} (${e.file})`)
105
96
  expect(
106
97
  hooks,
107
- 'Test-only exports ship to consumers. Drive the unit under test through ' +
108
- 'the seam it already has (a mocked native slot, say) instead:\n' +
98
+ 'Test-only exports ship to consumers. Drive the unit through a seam it ' +
99
+ 'already has — a mocked native slot, say:\n' +
109
100
  hooks.join('\n')
110
101
  ).toEqual([])
111
102
  })
@@ -113,4 +104,44 @@ describe('public surface', () => {
113
104
  it('does not re-export the raw Nitro object', () => {
114
105
  expect(exports.map((e) => e.name)).not.toContain('nativeBrowser')
115
106
  })
107
+
108
+ it('every public module is covered by the typedoc entry points', () => {
109
+ // The API reference documents entryPoints, not the export graph — a public
110
+ // module missing from website/typedoc.json ships undocumented.
111
+ const config = JSON.parse(
112
+ readFileSync(join(process.cwd(), 'website', 'typedoc.json'), 'utf8')
113
+ ) as { entryPoints: string[] }
114
+ const entries = config.entryPoints.map(
115
+ (glob) =>
116
+ new RegExp(
117
+ '^' +
118
+ glob
119
+ .replace(/^\.\.\/src\//, '')
120
+ .replace(/[.]/g, '\\.')
121
+ .replace(/\*/g, '[^/]+') +
122
+ '$'
123
+ )
124
+ )
125
+ const covered = (file: string): boolean => {
126
+ if (entries.some((e) => e.test(file))) return true
127
+ // A directory barrel entry (…/index.ts) documents what it re-exports.
128
+ const dir = file.split('/').slice(0, -1)
129
+ while (dir.length > 0) {
130
+ if (entries.some((e) => e.test([...dir, 'index.ts'].join('/'))))
131
+ return true
132
+ dir.pop()
133
+ }
134
+ return false
135
+ }
136
+ const uncovered = [...new Set(exports.map((e) => e.file))].filter(
137
+ (file) => !covered(file)
138
+ )
139
+ expect(
140
+ uncovered,
141
+ 'Exported to consumers but absent from the API reference. Add each ' +
142
+ 'module (or its directory barrel) to website/typedoc.json ' +
143
+ 'entryPoints:\n' +
144
+ uncovered.join('\n')
145
+ ).toEqual([])
146
+ })
116
147
  })
@@ -69,9 +69,8 @@ export type EqualizerSettings = {
69
69
  /**
70
70
  * Cross-platform audio output kind. Each platform maps its native ports into
71
71
  * this shared set: iOS's granular Bluetooth ports (`bluetoothA2DP`/`HFP`/`LE`)
72
- * all collapse to `'bluetooth'`. Note Android's *reading* (`getOutput`) reports
73
- * the active local route only — `'airplay'`/`'cast'` come from iOS / are
74
- * reserved for remote destinations and don't appear from Android reads.
72
+ * all collapse to `'bluetooth'`. `'airplay'` comes from iOS only, `'remote'`,
73
+ * `'cast'` and `'sonos'` from Android only (with `remoteOutputs` on).
75
74
  */
76
75
  export type OutputType =
77
76
  | 'speaker' // built-in loudspeaker
@@ -82,7 +81,9 @@ export type OutputType =
82
81
  | 'car' // car audio (CarPlay / Android Auto / car Bluetooth)
83
82
  | 'hdmi'
84
83
  | 'usb'
85
- | 'cast' // remote speaker / TV (reserved)
84
+ | 'cast' // Cast device, playing through the library's Cast support (Android)
85
+ | 'sonos' // Sonos room, playing through the library's Sonos support (Android)
86
+ | 'remote' // a media route provider's speaker or TV, selected in the Output Switcher (Android)
86
87
  | 'other'
87
88
 
88
89
  /**
@@ -115,7 +116,7 @@ export interface AudioBrowser extends HybridObject<{
115
116
  tabs: Track[] | undefined
116
117
  navigatePath(path: string): void
117
118
  navigateTrack(track: Track): void
118
- onSearch(query: string): Promise<Track[]>
119
+ search(query: string): Promise<Track[]>
119
120
  getContent(): ResolvedTrack | undefined
120
121
  onPathChanged: (path: string) => void
121
122
  onContentChanged: (content: ResolvedTrack | undefined) => void
@@ -229,9 +230,10 @@ export interface AudioBrowser extends HybridObject<{
229
230
  seekTo(position: number): void
230
231
  seekBy(offset: number): void
231
232
  /**
232
- * Jump to the live edge of the current track. No-op for non-live tracks.
233
- * Live with a seekable window (HLS): seeks to the window end. Live without a
234
- * window (non-seekable, e.g. ICY): reconnects to rejoin live.
233
+ * Jump to the live edge of the current track; no-op unless the track
234
+ * declares `live: true`. A stream with a seekable live window (HLS) seeks
235
+ * to the window's edge; a non-seekable stream (e.g. ICY radio) reconnects
236
+ * to rejoin live — an expired URL re-resolves through `media.resolve`.
235
237
  */
236
238
  seekToLiveEdge(): void
237
239
  setVolume(level: number): void
@@ -307,6 +309,11 @@ export interface AudioBrowser extends HybridObject<{
307
309
  * Gets the current now playing metadata (override if set, else track metadata).
308
310
  */
309
311
  getNowPlaying(): NowPlayingMetadata | undefined
312
+ /**
313
+ * Gets the last timed metadata received for the current track, cleared on
314
+ * a track change.
315
+ */
316
+ getTimedMetadata(): TimedMetadata | undefined
310
317
 
311
318
  // MARK: network connectivity
312
319
  getOnline(): boolean
@@ -0,0 +1,210 @@
1
+ import { readFileSync } from 'node:fs'
2
+ import { join } from 'node:path'
3
+ import { describe, expect, it } from 'vitest'
4
+
5
+ /**
6
+ * Completeness guards for the style declaration block (ADR 0011) — the checks
7
+ * Nitro's `extends`-flattening took out of the type system, in two parts:
8
+ * every key must be *resolved* by each platform's `StyleResolver`, and every
9
+ * key must be *accounted for* by each platform's `InertStyleDiagnostic`.
10
+ *
11
+ * Part one — inheritance completeness.
12
+ *
13
+ * `SectionStyle extends TrackStyle` in the spec, but Nitro flattens `extends`
14
+ * into independent structs on every platform — so nothing in any type system
15
+ * forces a platform's `StyleResolver` to read a newly added style key. A key
16
+ * the resolver forgets is silently dead: declared by consumers, decoded on the
17
+ * wire, never rendered. This test is the compile-time check the flattening
18
+ * took away:
19
+ *
20
+ * - every `SectionStyle` key must appear in each platform's
21
+ * `sectionStyle(section, page)` merge;
22
+ * - every inherited `TrackStyle` key must appear in each platform's
23
+ * `trackStyle(track, section)` merge;
24
+ * - `display` is positional (the deny-list): the track merge must resolve it
25
+ * to nil/null and must not read it from any level.
26
+ */
27
+
28
+ const ROOT = process.cwd()
29
+
30
+ const RESOLVERS = [
31
+ {
32
+ file: 'ios/Browser/StyleResolver.swift',
33
+ sectionMarker: 'static func sectionStyle',
34
+ trackMarker: 'static func trackStyle',
35
+ positionalNil: 'display: nil'
36
+ },
37
+ {
38
+ file: 'android/src/main/java/com/audiobrowser/browser/StyleResolver.kt',
39
+ sectionMarker: 'fun sectionStyle',
40
+ trackMarker: 'fun trackStyle',
41
+ positionalNil: 'display = null'
42
+ }
43
+ ]
44
+
45
+ /** Keys the spec deliberately excludes from item inheritance. */
46
+ const POSITIONAL = ['display']
47
+
48
+ function interfaceKeys(source: string, name: string): string[] {
49
+ const start = source.indexOf(`export interface ${name} `)
50
+ expect(
51
+ start,
52
+ `interface ${name} not found in browser-nodes.ts`
53
+ ).toBeGreaterThan(-1)
54
+ const end = source.indexOf('\n}', start)
55
+ const body = source.slice(start, end)
56
+ return [...body.matchAll(/^ {2}(\w+)\??:/gm)].flatMap((match) =>
57
+ match[1] === undefined ? [] : [match[1]]
58
+ )
59
+ }
60
+
61
+ /**
62
+ * The function's text from `marker` to the next function declaration (or end
63
+ * of file) — brace-agnostic, since Kotlin expression bodies have no braces.
64
+ */
65
+ function functionBody(source: string, marker: string, file: string): string {
66
+ const start = source.indexOf(marker)
67
+ expect(start, `${marker} not found in ${file}`).toBeGreaterThan(-1)
68
+ const rest = source.slice(start + marker.length)
69
+ const next = rest.search(/\n\s*(?:static func|func|fun)\s/)
70
+ return marker + (next === -1 ? rest : rest.slice(0, next))
71
+ }
72
+
73
+ /** Comment-free view, so prose about a key doesn't count as reading it. */
74
+ function stripComments(code: string): string {
75
+ return code
76
+ .replace(/\/\*[\s\S]*?\*\//g, '')
77
+ .split('\n')
78
+ .map((line) => line.replace(/\/\/.*$/, ''))
79
+ .join('\n')
80
+ }
81
+
82
+ const nodes = readFileSync(
83
+ join(ROOT, 'src', 'types', 'browser-nodes.ts'),
84
+ 'utf8'
85
+ )
86
+ const trackKeys = interfaceKeys(nodes, 'TrackStyle')
87
+ const sectionKeys = [...trackKeys, ...interfaceKeys(nodes, 'SectionStyle')]
88
+ const inheritedKeys = trackKeys.filter((key) => !POSITIONAL.includes(key))
89
+
90
+ describe('style block shape', () => {
91
+ it('has the positional key and at least one inherited key', () => {
92
+ expect(trackKeys).toContain('display')
93
+ expect(inheritedKeys.length).toBeGreaterThan(0)
94
+ })
95
+ })
96
+
97
+ for (const resolver of RESOLVERS) {
98
+ describe(resolver.file, () => {
99
+ const source = readFileSync(join(ROOT, resolver.file), 'utf8')
100
+ const sectionBody = stripComments(
101
+ functionBody(source, resolver.sectionMarker, resolver.file)
102
+ )
103
+ const trackBody = stripComments(
104
+ functionBody(source, resolver.trackMarker, resolver.file)
105
+ )
106
+
107
+ // Containment of `holder?.key` for BOTH holders — `display =
108
+ // section?.display` with the page half dropped must fail — AND in
109
+ // precedence order: the narrower holder must be read first, or the
110
+ // scope-override/inheritance direction is inverted (`page ?? section`
111
+ // would pass a bare containment check).
112
+ it.each(sectionKeys)('sectionStyle merges %s (section ?? page)', (key) => {
113
+ const section = sectionBody.indexOf(`section?.${key}`)
114
+ const page = sectionBody.indexOf(`page?.${key}`)
115
+ expect(section, `section?.${key} not read`).toBeGreaterThan(-1)
116
+ expect(page, `page?.${key} not read`).toBeGreaterThan(-1)
117
+ expect(section, `section?.${key} must precede page?.${key}`).toBeLessThan(
118
+ page
119
+ )
120
+ })
121
+
122
+ it.each(inheritedKeys)(
123
+ 'trackStyle inherits %s (track ?? section)',
124
+ (key) => {
125
+ const track = trackBody.indexOf(`track?.${key}`)
126
+ const section = trackBody.indexOf(`section?.${key}`)
127
+ expect(track, `track?.${key} not read`).toBeGreaterThan(-1)
128
+ expect(section, `section?.${key} not read`).toBeGreaterThan(-1)
129
+ expect(
130
+ track,
131
+ `track?.${key} must precede section?.${key}`
132
+ ).toBeLessThan(section)
133
+ }
134
+ )
135
+
136
+ it('trackStyle excludes the positional display (deny-list)', () => {
137
+ expect(trackBody).toContain(resolver.positionalNil)
138
+ // The nil assignment must be the ONLY mention: reading display from any
139
+ // level here would item-inherit a positional key.
140
+ const mentions = trackBody.match(/display/g) ?? []
141
+ expect(mentions).toHaveLength(1)
142
+ })
143
+ })
144
+ }
145
+
146
+ /**
147
+ * Part two — diagnostic completeness.
148
+ *
149
+ * The block model traded compile-time invalid-combination errors for
150
+ * inertness, and the dev-mode `InertStyleDiagnostic` is the recovery. It is
151
+ * exposed to the same flattening problem as the resolvers, one level up: a
152
+ * key added to the spec has no type-system tie to the diagnostic's rule set,
153
+ * so a property could ship whose inert combinations nobody is warned about.
154
+ *
155
+ * Each platform therefore dispositions the whole vocabulary — every key is a
156
+ * `Property` with an inertness rule, `alwaysRenderable`, or `positional` —
157
+ * and this test reads those three declarations and asserts set equality with
158
+ * the spec, both directions: a new key must be dispositioned, and a key
159
+ * deleted from the spec must not linger in the rule set.
160
+ */
161
+ const DIAGNOSTICS = [
162
+ {
163
+ file: 'ios/Browser/InertStyleDiagnostic.swift',
164
+ // `case gridWrap`, up to the first member after the case list.
165
+ ruled: (source: string) =>
166
+ keysIn(
167
+ source,
168
+ /enum Property[\s\S]*?var isItemProperty/,
169
+ /^\s*case (\w+)$/gm
170
+ )
171
+ },
172
+ {
173
+ file: 'android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt',
174
+ // `GRID_WRAP("gridWrap", …)`, up to the `;` that ends the entry list.
175
+ ruled: (source: string) =>
176
+ keysIn(source, /enum class Property[\s\S]*?;/, /\w+\("(\w+)"/g)
177
+ }
178
+ ]
179
+
180
+ /** The capture group of every `pattern` match within the first `region`. */
181
+ function keysIn(source: string, region: RegExp, pattern: RegExp): string[] {
182
+ const found = region.exec(source)
183
+ expect(found, `region ${region} not found`).not.toBeNull()
184
+ return [...found![0].matchAll(pattern)].flatMap((match) =>
185
+ match[1] === undefined ? [] : [match[1]]
186
+ )
187
+ }
188
+
189
+ for (const diagnostic of DIAGNOSTICS) {
190
+ describe(diagnostic.file, () => {
191
+ // Comment-free, so prose naming a key doesn't pass for dispositioning it.
192
+ const source = stripComments(
193
+ readFileSync(join(ROOT, diagnostic.file), 'utf8')
194
+ )
195
+ // The two lists are spelled `alwaysRenderable`/`positional` in Swift and
196
+ // SCREAMING_CASE in Kotlin; both hold bare string literals.
197
+ const listed = [
198
+ ...source.matchAll(
199
+ /(?:alwaysRenderable|ALWAYS_RENDERABLE|positional|POSITIONAL)\s*=[^\n]*/gi
200
+ )
201
+ ].flatMap((match) =>
202
+ [...match[0].matchAll(/"(\w+)"/g)].map((key) => key[1])
203
+ )
204
+
205
+ it('dispositions every key of the block, and only those', () => {
206
+ const dispositioned = [...diagnostic.ruled(source), ...listed]
207
+ expect(new Set(dispositioned)).toEqual(new Set(sectionKeys))
208
+ })
209
+ })
210
+ }