react-native-audio-browser 0.2.0-next.5 → 0.2.0-next.51

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 (1092) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +215 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +546 -283
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  9. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  10. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +165 -0
  11. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  12. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  13. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  15. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  16. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  17. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  18. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  19. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  20. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  21. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  22. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  23. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  24. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  25. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  26. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  27. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +16 -0
  28. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  29. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  30. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  31. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +4 -1
  32. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  33. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  34. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  35. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  36. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  37. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  38. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  39. package/android/src/main/java/com/audiobrowser/player/Player.kt +333 -186
  40. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  41. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  42. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +33 -16
  43. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  44. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  45. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +10 -13
  46. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +64 -0
  47. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +98 -0
  48. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  49. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +110 -0
  50. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +696 -0
  51. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +113 -0
  52. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  53. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  54. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +92 -0
  55. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +105 -0
  56. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  57. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  58. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +550 -0
  59. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +99 -0
  60. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +201 -0
  61. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  62. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +66 -0
  63. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  64. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +63 -0
  65. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +63 -0
  66. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +68 -0
  67. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  68. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  69. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  70. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  71. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  72. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  73. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  74. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  75. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  76. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  77. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  78. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  79. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +23 -1
  80. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  81. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  82. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  83. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  84. package/android/src/main/res/values/strings.xml +25 -5
  85. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +18 -0
  86. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  87. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  88. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  89. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  90. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  91. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  92. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  93. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  94. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  95. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  96. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  97. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  98. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  99. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  100. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  101. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  102. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  103. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  104. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  105. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  106. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  107. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  108. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -0
  109. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  110. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  111. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  112. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  113. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  114. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  115. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  116. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +136 -0
  117. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  118. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  119. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +213 -0
  120. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  121. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  122. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  123. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  124. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +275 -0
  125. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  126. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  127. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  128. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +815 -0
  129. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +203 -0
  130. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +73 -0
  132. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +135 -0
  133. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +170 -0
  134. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +174 -0
  135. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +691 -0
  136. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  137. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +165 -0
  138. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  139. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +204 -0
  140. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +99 -0
  141. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  142. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  143. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  144. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  145. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  146. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  147. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  148. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  149. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  150. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  151. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  152. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  153. package/android/src/test/resources/sonos/device_description.xml +78 -0
  154. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  155. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +79 -0
  156. package/ios/AVPlayerEngine.swift +362 -0
  157. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  158. package/ios/Browser/BrowseGate.swift +58 -0
  159. package/ios/Browser/BrowserConfig.swift +115 -81
  160. package/ios/Browser/BrowserError.swift +16 -0
  161. package/ios/Browser/BrowserManager.swift +155 -654
  162. package/ios/Browser/BrowserPathHelper.swift +68 -51
  163. package/ios/Browser/FavoriteSet.swift +46 -0
  164. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  165. package/ios/Browser/JsonModels.swift +270 -321
  166. package/ios/Browser/NavigationErrorState.swift +41 -0
  167. package/ios/Browser/PageResolver.swift +147 -0
  168. package/ios/Browser/RequestLayer.swift +185 -0
  169. package/ios/Browser/RequestPipeline.swift +303 -0
  170. package/ios/Browser/SearchDrillIn.swift +7 -7
  171. package/ios/Browser/SectionScope.swift +82 -23
  172. package/ios/Browser/SimpleRouter.swift +73 -144
  173. package/ios/Browser/StyleResolver.swift +58 -0
  174. package/ios/Browser/TabBarEntries.swift +9 -3
  175. package/ios/Browser/TrackIdTemplate.swift +37 -0
  176. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  177. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  178. package/ios/CarPlay/CarPlayController.swift +37 -1297
  179. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  180. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  181. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  182. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  183. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  184. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  185. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  186. package/ios/CarPlay/CarPlaySession.swift +207 -0
  187. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  188. package/ios/CarPlay/IntentHandlers.swift +96 -0
  189. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  190. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  191. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  192. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  193. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  194. package/ios/CarPlay/SectionPresentation.swift +77 -0
  195. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  196. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  197. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  198. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  199. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  200. package/ios/Extension/SearchParams+Query.swift +28 -0
  201. package/ios/Extension/Section+Copying.swift +29 -0
  202. package/ios/Extension/String+IcyCharset.swift +21 -0
  203. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  204. package/ios/Extension/Track+AVPlayer.swift +0 -16
  205. package/ios/Extension/Track+Copying.swift +11 -13
  206. package/ios/Extension/Track+Identity.swift +25 -0
  207. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  208. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  209. package/ios/Extension/URLError+Connectivity.swift +15 -0
  210. package/ios/Http/HttpClient.swift +71 -165
  211. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  212. package/ios/HybridAudioBrowser+Options.swift +105 -0
  213. package/ios/HybridAudioBrowser+Player.swift +341 -0
  214. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  215. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  216. package/ios/HybridAudioBrowser.swift +131 -1652
  217. package/ios/Model/NitroTypeStubs.swift +239 -24
  218. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  219. package/ios/Model/RemoteCommand.swift +6 -60
  220. package/ios/Model/TrackPlayerError.swift +6 -2
  221. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  222. package/ios/Observer/ItemObserver.swift +90 -0
  223. package/ios/Observer/PlayerObserver.swift +59 -0
  224. package/ios/Option/SessionCategories.swift +42 -92
  225. package/ios/Player/AudioSessionController.swift +191 -0
  226. package/ios/Player/DeferredSeek.swift +70 -0
  227. package/ios/Player/ErrorStatus.swift +50 -0
  228. package/ios/Player/MediaLoader.swift +66 -87
  229. package/ios/Player/NowPlayingLines.swift +52 -0
  230. package/ios/Player/NowPlayingUpdater.swift +182 -85
  231. package/ios/Player/PlaybackFailure.swift +125 -0
  232. package/ios/Player/PlaybackPersistence.swift +73 -0
  233. package/ios/Player/PlaybackTimer.swift +8 -2
  234. package/ios/Player/Player.swift +975 -0
  235. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  236. package/ios/Player/PlayerEngine.swift +104 -0
  237. package/ios/Player/PlayerStatusTypes.swift +2 -6
  238. package/ios/Player/QueueManager.swift +93 -67
  239. package/ios/Player/RetryLoop.swift +291 -0
  240. package/ios/Player/ShuffleOrder.swift +33 -0
  241. package/ios/Player/SleepTimerManager.swift +14 -16
  242. package/ios/Player/VolumeFader.swift +5 -0
  243. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  244. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  245. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  246. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  247. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  248. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  249. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  250. package/ios/Tests/DeferredSeekTests.swift +70 -0
  251. package/ios/Tests/EmitterTests.swift +22 -38
  252. package/ios/Tests/ErrorStatusTests.swift +50 -0
  253. package/ios/Tests/FavoriteSetTests.swift +60 -0
  254. package/ios/Tests/GenerationMemoTests.swift +121 -0
  255. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  256. package/ios/Tests/JsonModelsTests.swift +194 -1
  257. package/ios/Tests/LRUCacheTests.swift +110 -0
  258. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  259. package/ios/Tests/MediaLoaderTests.swift +36 -67
  260. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  261. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  262. package/ios/Tests/ObserverTests.swift +88 -0
  263. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  264. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  265. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  266. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  267. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  268. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  269. package/ios/Tests/PlayingStateTests.swift +42 -0
  270. package/ios/Tests/QueueManagerTests.swift +196 -115
  271. package/ios/Tests/ReadyValueTests.swift +73 -0
  272. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  273. package/ios/Tests/RequestLayerTests.swift +228 -0
  274. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  275. package/ios/Tests/RetryLoopTests.swift +305 -0
  276. package/ios/Tests/SearchDrillInTests.swift +16 -16
  277. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  278. package/ios/Tests/SectionPresentationTests.swift +98 -0
  279. package/ios/Tests/SectionScopeTests.swift +139 -54
  280. package/ios/Tests/SimpleRouterTests.swift +38 -3
  281. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  282. package/ios/Tests/StyleResolverTests.swift +132 -0
  283. package/ios/Tests/Support/TestTypes.swift +146 -101
  284. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  285. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  286. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  287. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  288. package/ios/Tests/TrackIdentityTests.swift +20 -0
  289. package/ios/Tests/TrackSelectorTests.swift +168 -33
  290. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  291. package/ios/TrackSelector.swift +62 -65
  292. package/ios/Util/ArtworkFreshness.swift +42 -0
  293. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  294. package/ios/Util/ConcurrentMap.swift +19 -0
  295. package/ios/Util/Emitter.swift +40 -12
  296. package/ios/Util/GenerationMemo.swift +36 -0
  297. package/ios/Util/LRUCache.swift +23 -159
  298. package/ios/Util/NetworkMonitor.swift +32 -32
  299. package/ios/Util/OutputPicker.swift +48 -0
  300. package/ios/Util/ReadyValue.swift +56 -0
  301. package/ios/Util/SFSymbolRenderer.swift +59 -31
  302. package/ios/Util/SVGProcessor.swift +9 -12
  303. package/lib/commonjs/AudioBrowser.js +8 -8
  304. package/lib/commonjs/AudioBrowser.js.map +1 -1
  305. package/lib/commonjs/CLAUDE.md +52 -0
  306. package/lib/commonjs/features/browser-config.js +12 -8
  307. package/lib/commonjs/features/browser-config.js.map +1 -1
  308. package/lib/commonjs/features/browser.js +11 -3
  309. package/lib/commonjs/features/browser.js.map +1 -1
  310. package/lib/commonjs/features/carConnection.js +1 -1
  311. package/lib/commonjs/features/equalizer.js +1 -1
  312. package/lib/commonjs/features/errors.js +3 -3
  313. package/lib/commonjs/features/favorites.js +14 -11
  314. package/lib/commonjs/features/favorites.js.map +1 -1
  315. package/lib/commonjs/features/gate.js +16 -1
  316. package/lib/commonjs/features/gate.js.map +1 -1
  317. package/lib/commonjs/features/metadata.js +20 -3
  318. package/lib/commonjs/features/metadata.js.map +1 -1
  319. package/lib/commonjs/features/network.js +1 -1
  320. package/lib/commonjs/features/nowPlaying.js +1 -1
  321. package/lib/commonjs/features/output.js +4 -3
  322. package/lib/commonjs/features/output.js.map +1 -1
  323. package/lib/commonjs/features/playback/controls.js +4 -2
  324. package/lib/commonjs/features/playback/controls.js.map +1 -1
  325. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  326. package/lib/commonjs/features/playback/playing.js +1 -1
  327. package/lib/commonjs/features/playback/progress.js +3 -2
  328. package/lib/commonjs/features/playback/progress.js.map +1 -1
  329. package/lib/commonjs/features/playback/rate.js +8 -1
  330. package/lib/commonjs/features/playback/rate.js.map +1 -1
  331. package/lib/commonjs/features/playback/state.js +3 -4
  332. package/lib/commonjs/features/playback/state.js.map +1 -1
  333. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  334. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  335. package/lib/commonjs/features/playback/volume.js +1 -1
  336. package/lib/commonjs/features/player/options.js +3 -19
  337. package/lib/commonjs/features/player/options.js.map +1 -1
  338. package/lib/commonjs/features/player/setup.js +7 -3
  339. package/lib/commonjs/features/player/setup.js.map +1 -1
  340. package/lib/commonjs/features/player/validateOptions.js +23 -0
  341. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  342. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  343. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  344. package/lib/commonjs/features/queue/queue.js +13 -6
  345. package/lib/commonjs/features/queue/queue.js.map +1 -1
  346. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  347. package/lib/commonjs/features/queue/shuffle.js +1 -1
  348. package/lib/commonjs/features/remoteControls.js +13 -92
  349. package/lib/commonjs/features/remoteControls.js.map +1 -1
  350. package/lib/commonjs/features/sleepTimer.js +13 -1
  351. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  352. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  353. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  354. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  355. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  356. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  357. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  358. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  359. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  360. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  361. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  362. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  363. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  364. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  365. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  366. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  367. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  368. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  369. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  370. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  371. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  372. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  373. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  374. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  375. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  376. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  377. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  378. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  379. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  380. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  381. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  382. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  383. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  384. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  385. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  386. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  387. package/lib/commonjs/web/browser/sections.js +89 -0
  388. package/lib/commonjs/web/browser/sections.js.map +1 -0
  389. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  390. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  391. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  392. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  393. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  394. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  395. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  396. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  397. package/lib/module/AudioBrowser.js +2 -1
  398. package/lib/module/AudioBrowser.js.map +1 -1
  399. package/lib/module/CLAUDE.md +52 -0
  400. package/lib/module/features/browser-config.js +12 -8
  401. package/lib/module/features/browser-config.js.map +1 -1
  402. package/lib/module/features/browser.js +11 -3
  403. package/lib/module/features/browser.js.map +1 -1
  404. package/lib/module/features/carConnection.js +1 -1
  405. package/lib/module/features/equalizer.js +1 -1
  406. package/lib/module/features/errors.js +3 -3
  407. package/lib/module/features/favorites.js +14 -11
  408. package/lib/module/features/favorites.js.map +1 -1
  409. package/lib/module/features/gate.js +16 -1
  410. package/lib/module/features/gate.js.map +1 -1
  411. package/lib/module/features/metadata.js +20 -3
  412. package/lib/module/features/metadata.js.map +1 -1
  413. package/lib/module/features/network.js +1 -1
  414. package/lib/module/features/nowPlaying.js +1 -1
  415. package/lib/module/features/output.js +4 -3
  416. package/lib/module/features/output.js.map +1 -1
  417. package/lib/module/features/playback/controls.js +4 -2
  418. package/lib/module/features/playback/controls.js.map +1 -1
  419. package/lib/module/features/playback/playWhenReady.js +1 -1
  420. package/lib/module/features/playback/playing.js +1 -1
  421. package/lib/module/features/playback/progress.js +3 -2
  422. package/lib/module/features/playback/progress.js.map +1 -1
  423. package/lib/module/features/playback/rate.js +8 -1
  424. package/lib/module/features/playback/rate.js.map +1 -1
  425. package/lib/module/features/playback/state.js +3 -4
  426. package/lib/module/features/playback/state.js.map +1 -1
  427. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  428. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  429. package/lib/module/features/playback/volume.js +1 -1
  430. package/lib/module/features/player/options.js +2 -17
  431. package/lib/module/features/player/options.js.map +1 -1
  432. package/lib/module/features/player/setup.js +6 -2
  433. package/lib/module/features/player/setup.js.map +1 -1
  434. package/lib/module/features/player/validateOptions.js +19 -0
  435. package/lib/module/features/player/validateOptions.js.map +1 -0
  436. package/lib/module/features/queue/activeTrack.js +15 -4
  437. package/lib/module/features/queue/activeTrack.js.map +1 -1
  438. package/lib/module/features/queue/queue.js +13 -6
  439. package/lib/module/features/queue/queue.js.map +1 -1
  440. package/lib/module/features/queue/repeatMode.js +1 -1
  441. package/lib/module/features/queue/shuffle.js +1 -1
  442. package/lib/module/features/remoteControls.js +13 -92
  443. package/lib/module/features/remoteControls.js.map +1 -1
  444. package/lib/module/features/sleepTimer.js +13 -1
  445. package/lib/module/features/sleepTimer.js.map +1 -1
  446. package/lib/module/test-utils/reactNativeStub.js +58 -0
  447. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  448. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  449. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  450. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  451. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  452. package/lib/module/utils/getTrackIdentity.js +20 -0
  453. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  454. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  455. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  456. package/lib/module/web/NativeAudioBrowser.js +202 -77
  457. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  458. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  459. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  460. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  461. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  462. package/lib/module/web/TrackPlayer/Player.js +254 -39
  463. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  464. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  465. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  466. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  467. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  468. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  469. package/lib/module/web/browser/BrowserManager.js +175 -100
  470. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  471. package/lib/module/web/browser/FavoriteManager.js +31 -21
  472. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  473. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  474. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  475. package/lib/module/web/browser/SearchManager.js +18 -23
  476. package/lib/module/web/browser/SearchManager.js.map +1 -1
  477. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  478. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  479. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  480. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  481. package/lib/module/web/browser/sections.js +83 -0
  482. package/lib/module/web/browser/sections.js.map +1 -0
  483. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  484. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  485. package/lib/module/web/http/followMediaRedirect.js +215 -0
  486. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  487. package/lib/module/web/player/NowPlayingManager.js +4 -3
  488. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  489. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  490. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  491. package/lib/typescript/package.json +1 -0
  492. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  493. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  494. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  495. package/lib/typescript/src/features/browser.d.ts +10 -2
  496. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  497. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  498. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  499. package/lib/typescript/src/features/errors.d.ts +3 -3
  500. package/lib/typescript/src/features/favorites.d.ts +14 -11
  501. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  502. package/lib/typescript/src/features/gate.d.ts +18 -2
  503. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  504. package/lib/typescript/src/features/metadata.d.ts +20 -3
  505. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  506. package/lib/typescript/src/features/network.d.ts +1 -1
  507. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  508. package/lib/typescript/src/features/output.d.ts +4 -3
  509. package/lib/typescript/src/features/output.d.ts.map +1 -1
  510. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  511. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  512. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  513. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  514. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  515. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  516. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  517. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  518. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  519. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  520. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  521. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  522. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  523. package/lib/typescript/src/features/player/options.d.ts +24 -21
  524. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  525. package/lib/typescript/src/features/player/setup.d.ts +46 -1
  526. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  527. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  528. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  529. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  530. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  531. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  532. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  533. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  534. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  535. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  536. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  537. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  538. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  539. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  540. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  541. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  542. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  543. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  544. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  545. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  546. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  547. package/lib/typescript/src/types/browser.d.ts +93 -61
  548. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  549. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  550. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  551. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  552. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  553. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  554. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  555. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  556. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  557. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  558. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  559. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  560. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  561. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  567. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  568. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  574. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  577. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  579. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  581. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  582. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  583. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  584. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  587. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  588. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  589. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  590. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  591. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  593. 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
  594. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  595. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  597. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  598. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  599. 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
  600. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  605. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  607. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  609. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  610. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  612. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  621. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  630. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  631. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  633. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  634. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  639. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  641. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  642. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  645. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  647. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  649. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  650. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  651. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  653. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  655. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  656. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  657. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  658. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  659. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  660. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  661. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  663. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  664. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  665. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  666. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  667. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  668. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  669. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  670. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  671. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  672. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  673. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  674. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  680. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  681. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  682. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  686. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  687. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  689. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  690. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  692. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  694. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  695. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  696. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  697. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  700. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  701. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  702. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  703. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  704. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  707. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  708. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  709. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  711. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  712. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  713. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  715. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  716. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  717. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  718. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  719. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  739. 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
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  746. 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
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  749. 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
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  752. 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
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  805. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  806. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  807. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  808. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  809. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  810. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  811. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  812. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  813. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  814. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  815. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  816. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  817. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  818. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  819. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  820. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  821. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  822. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  823. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  824. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  825. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  826. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  827. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  828. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  829. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  830. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  831. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  832. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  858. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  859. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  860. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  861. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  862. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  863. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  864. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  865. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  866. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  867. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  868. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  869. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  870. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  871. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  872. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  873. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  874. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  875. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  876. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  877. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  878. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  879. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  880. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  881. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  882. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  883. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  884. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  885. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  886. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  887. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  888. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  889. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  890. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  891. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  892. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  893. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  894. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  895. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  896. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  897. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  898. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  899. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  900. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  901. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  902. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  903. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  904. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  905. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  906. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  907. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  908. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  909. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  910. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  911. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  912. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  913. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  914. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  915. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  916. package/package.json +24 -11
  917. package/src/AudioBrowser.ts +2 -1
  918. package/src/CLAUDE.md +52 -0
  919. package/src/features/battery.test.ts +79 -0
  920. package/src/features/browser-config.test.ts +21 -6
  921. package/src/features/browser-config.ts +12 -8
  922. package/src/features/browser.test.ts +1 -1
  923. package/src/features/browser.ts +11 -3
  924. package/src/features/carConnection.ts +1 -1
  925. package/src/features/equalizer.ts +1 -1
  926. package/src/features/errors.ts +3 -3
  927. package/src/features/favorites.ts +14 -11
  928. package/src/features/gate.ts +16 -1
  929. package/src/features/hook-wiring.test.ts +302 -0
  930. package/src/features/metadata.ts +20 -3
  931. package/src/features/network.ts +1 -1
  932. package/src/features/nowPlaying.ts +1 -1
  933. package/src/features/output.ts +4 -3
  934. package/src/features/playback/controls.ts +4 -2
  935. package/src/features/playback/playWhenReady.ts +1 -1
  936. package/src/features/playback/playing.ts +1 -1
  937. package/src/features/playback/progress.test.ts +169 -0
  938. package/src/features/playback/progress.ts +3 -2
  939. package/src/features/playback/rate.ts +8 -1
  940. package/src/features/playback/state.ts +3 -4
  941. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  942. package/src/features/playback/trackPlaybackTime.ts +1 -6
  943. package/src/features/playback/volume.ts +1 -1
  944. package/src/features/player/options.ts +31 -40
  945. package/src/features/player/setup.test.ts +12 -3
  946. package/src/features/player/setup.ts +58 -5
  947. package/src/features/player/validateOptions.ts +21 -0
  948. package/src/features/queue/activeTrack.ts +15 -4
  949. package/src/features/queue/queue.ts +13 -6
  950. package/src/features/queue/repeatMode.ts +1 -1
  951. package/src/features/queue/shuffle.ts +1 -1
  952. package/src/features/remoteControls.ts +13 -92
  953. package/src/features/sleepTimer.test.ts +172 -0
  954. package/src/features/sleepTimer.ts +9 -1
  955. package/src/nitro-stub-drift.test.ts +277 -0
  956. package/src/public-surface.test.ts +147 -0
  957. package/src/specs/audio-browser.nitro.ts +10 -8
  958. package/src/style-resolution.test.ts +210 -0
  959. package/src/test-utils/reactNativeStub.ts +60 -0
  960. package/src/types/browser-native.ts +7 -3
  961. package/src/types/browser-nodes.ts +403 -134
  962. package/src/types/browser.ts +97 -63
  963. package/src/utils/LazyNativeEmitter.ts +28 -15
  964. package/src/utils/NativeUpdatedValue.ts +29 -13
  965. package/src/utils/getTrackIdentity.ts +20 -0
  966. package/src/utils/useDebug.test.ts +182 -0
  967. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  968. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  969. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  970. package/src/web/NativeAudioBrowser.ts +241 -84
  971. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  972. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  973. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  974. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  975. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  976. package/src/web/TrackPlayer/Player.ts +284 -37
  977. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  978. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  979. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  980. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  981. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  982. package/src/web/__tests__/lifecycle.test.ts +345 -0
  983. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  984. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  985. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  986. package/src/web/__tests__/retry.test.ts +169 -0
  987. package/src/web/browser/BrowserManager.ts +209 -111
  988. package/src/web/browser/FavoriteManager.test.ts +84 -0
  989. package/src/web/browser/FavoriteManager.ts +28 -23
  990. package/src/web/browser/NavigationErrorManager.ts +3 -1
  991. package/src/web/browser/SearchManager.test.ts +75 -0
  992. package/src/web/browser/SearchManager.ts +25 -28
  993. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  994. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  995. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  996. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  997. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  998. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  999. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1000. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1001. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1002. package/src/web/browser/sections.test.ts +91 -0
  1003. package/src/web/browser/sections.ts +72 -0
  1004. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1005. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1006. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1007. package/src/web/http/followMediaRedirect.ts +253 -0
  1008. package/src/web/player/NowPlayingManager.ts +4 -3
  1009. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1010. package/src/web/util/BrowserPathHelper.ts +70 -13
  1011. package/website/guide/android-auto.md +114 -0
  1012. package/website/guide/android-certificates.md +409 -0
  1013. package/website/guide/artwork.md +255 -0
  1014. package/website/guide/audio-output.md +339 -0
  1015. package/website/guide/automotive.md +86 -0
  1016. package/website/guide/basic-usage.md +151 -0
  1017. package/website/guide/battery.md +115 -0
  1018. package/website/guide/browser.md +587 -0
  1019. package/website/guide/carplay.md +650 -0
  1020. package/website/guide/configuration.md +179 -0
  1021. package/website/guide/equalizer.md +231 -0
  1022. package/website/guide/errors.md +310 -0
  1023. package/website/guide/favorites.md +154 -0
  1024. package/website/guide/gate.md +143 -0
  1025. package/website/guide/getting-started.md +46 -0
  1026. package/website/guide/hooks.md +238 -0
  1027. package/website/guide/live-streams.md +125 -0
  1028. package/website/guide/metadata.md +239 -0
  1029. package/website/guide/migrating-from-track-player.md +244 -0
  1030. package/website/guide/native-callback-fetch.md +127 -0
  1031. package/website/guide/network.md +86 -0
  1032. package/website/guide/now-playing.md +175 -0
  1033. package/website/guide/playback.md +328 -0
  1034. package/website/guide/queue.md +300 -0
  1035. package/website/guide/remote-controls.md +256 -0
  1036. package/website/guide/search.md +255 -0
  1037. package/website/guide/sleep-timer.md +268 -0
  1038. package/website/guide/track.md +247 -0
  1039. package/ios/Bridge.h +0 -8
  1040. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1041. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1042. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1043. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1044. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1045. package/ios/Model/MediaURL.swift +0 -67
  1046. package/ios/Model/SourceType.swift +0 -6
  1047. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1048. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1049. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1050. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1051. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1052. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1053. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1054. package/ios/Option/PitchAlgorithms.swift +0 -17
  1055. package/ios/Option/TimeEventFrequency.swift +0 -18
  1056. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1057. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1058. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1059. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1060. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1061. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1062. package/ios/Player/PlaybackStateStore.swift +0 -27
  1063. package/ios/Player/PlayingStateManager.swift +0 -33
  1064. package/ios/Player/RetryManager.swift +0 -322
  1065. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1066. package/ios/Player/SleepTimerHandling.swift +0 -15
  1067. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1068. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1069. package/ios/Tests/MediaResolveTests.swift +0 -126
  1070. package/ios/Tests/OnceValueTests.swift +0 -79
  1071. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1072. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1073. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1074. package/ios/Tests/RetryManagerTests.swift +0 -89
  1075. package/ios/TrackPlayer.swift +0 -1014
  1076. package/ios/TrackPlayerCallbacks.swift +0 -86
  1077. package/ios/Util/MetadataAdapter.swift +0 -131
  1078. package/ios/Util/OnceValue.swift +0 -104
  1079. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1080. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1081. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1082. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1083. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1084. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1085. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1086. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1087. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1088. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1089. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1090. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1091. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1092. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -15,75 +15,56 @@ final class MediaLoader {
15
15
  /// Resolves a playback src into a concrete URL + headers/user-agent.
16
16
  /// The `Track` is threaded through so the resolver can invoke the
17
17
  /// consumer-supplied `media.resolve(track)` as the final media layer.
18
- var mediaUrlResolver: ((String, Track?) async -> MediaResolvedUrl)?
18
+ private let resolveUrl: (String, Track?) async -> MediaResolvedUrl
19
19
 
20
- /// Internal access so TrackPlayer can read it for observer guards.
20
+ init(resolveUrl: @escaping (String, Track?) async -> MediaResolvedUrl) {
21
+ self.resolveUrl = resolveUrl
22
+ }
23
+
24
+ /// Internal access so AVPlayerEngine can read it.
21
25
  private(set) var asset: AVURLAsset?
22
26
 
23
27
  /// Milliseconds; applied to AVPlayerItem's preferredForwardBufferDuration.
24
28
  var bufferDuration: Double = 0
25
29
 
26
- weak var delegate: MediaLoaderDelegate?
30
+ enum Event {
31
+ case prepared(AVPlayerItem)
32
+ /// Loading failed; the retry loop decides whether another attempt could help.
33
+ case failed(Error)
34
+ /// The asset loaded but cannot play.
35
+ case unplayable
36
+ /// The source is not a URL, so no asset exists.
37
+ case invalidSource(String)
38
+ case commonMetadata([AVMetadataItem])
39
+ case chapterMetadata([AVTimedMetadataGroup])
40
+ case timedMetadata([AVTimedMetadataGroup])
41
+ }
42
+
43
+ var onEvent: (@MainActor (Event) -> Void)?
27
44
 
28
45
  /// The in-flight resolve. Readable so tests can await the resolve-then-load
29
46
  /// chain instead of sleeping past it; only this type starts and cancels it.
30
47
  private(set) var mediaResolverTask: Task<Void, Never>?
31
48
  private var metadataLoadTask: Task<Void, Never>?
32
49
  private var playableLoadTask: Task<Void, Never>?
33
- private var url: URL?
34
- private var urlOptions: [String: Any]?
35
50
 
36
51
  // MARK: - Public API
37
52
 
38
53
  func resolveAndLoad(src: String, track: Track? = nil) {
39
- if let resolver = mediaUrlResolver {
40
- mediaResolverTask?.cancel()
41
- mediaResolverTask = Task {
42
- self.logger.debug("resolveAndLoad: starting resolution for \(src)")
43
-
44
- guard !Task.isCancelled else {
45
- self.logger.debug("resolveAndLoad: cancelled before start")
46
- return
47
- }
48
-
49
- self.logger.debug("resolveAndLoad: calling resolver...")
50
- let resolved = await resolver(src, track)
51
-
52
- guard !Task.isCancelled else {
53
- self.logger.debug("resolveAndLoad: cancelled after resolver returned")
54
- return
55
- }
56
-
57
- self.logger.debug("resolveAndLoad: resolver returned, resolved URL: \(resolved.url)")
58
- if let headers = resolved.headers {
59
- self.logger.debug(" headers: \(headers)")
60
- }
61
- if let userAgent = resolved.userAgent {
62
- self.logger.debug(" userAgent: \(userAgent)")
63
- }
64
-
65
- await MainActor.run {
66
- guard !Task.isCancelled else {
67
- self.logger.debug("resolveAndLoad: cancelled before loadWithResolvedUrl")
68
- return
69
- }
70
- self.loadWithResolvedUrl(resolved)
71
- }
72
- }
73
- } else {
74
- let resolved = MediaResolvedUrl(url: src, headers: nil, userAgent: nil)
54
+ mediaResolverTask?.cancel()
55
+ // `self` stays weak across the await: a consumer resolver that never settles must not pin
56
+ // the loader, and cancellation cannot force its `await` to return.
57
+ let resolveUrl = resolveUrl
58
+ mediaResolverTask = Task { [weak self] in
59
+ guard !Task.isCancelled else { return }
60
+ let resolved = await resolveUrl(src, track)
61
+ guard !Task.isCancelled, let self else { return }
75
62
  loadWithResolvedUrl(resolved)
76
63
  }
77
64
  }
78
65
 
79
- func loadAsset() {
80
- guard let url else {
81
- // Callers (reload-from-terminal) have already transitioned to .loading;
82
- // a silent return would strand that state with no load in flight.
83
- delegate?.mediaLoaderDidFailWithError(.invalidSourceUrl("nil"))
84
- return
85
- }
86
- let pendingAsset = AVURLAsset(url: url, options: urlOptions)
66
+ private func loadAsset(url: URL, options: [String: Any]?) {
67
+ let pendingAsset = AVURLAsset(url: url, options: options)
87
68
  asset = pendingAsset
88
69
 
89
70
  // Separate from playable loading to allow playback to start faster
@@ -96,33 +77,35 @@ final class MediaLoader {
96
77
  .availableMetadataFormats,
97
78
  ) else { return }
98
79
 
99
- guard !Task.isCancelled, pendingAsset == asset else { return }
80
+ guard isCurrent(pendingAsset) else { return }
100
81
 
101
82
  if !commonMetadata.isEmpty {
102
- delegate?.mediaLoaderDidReceiveCommonMetadata(commonMetadata)
83
+ onEvent?(.commonMetadata(commonMetadata))
103
84
  }
104
85
 
105
86
  if !chapterLocales.isEmpty {
106
87
  for locale in chapterLocales {
107
- guard !Task.isCancelled else { return }
88
+ guard isCurrent(pendingAsset) else { return }
108
89
  if let chapters = try? await pendingAsset.loadChapterMetadataGroups(
109
90
  withTitleLocale: locale,
110
91
  containingItemsWithCommonKeys: [],
111
92
  ) {
112
- delegate?.mediaLoaderDidReceiveChapterMetadata(chapters)
93
+ guard isCurrent(pendingAsset) else { return }
94
+ onEvent?(.chapterMetadata(chapters))
113
95
  }
114
96
  }
115
97
  } else {
116
98
  let duration = await (try? pendingAsset.load(.duration)) ?? .zero
117
99
  for format in metadataFormats {
118
- guard !Task.isCancelled else { return }
100
+ guard isCurrent(pendingAsset) else { return }
119
101
  if let metadata = try? await pendingAsset.loadMetadata(for: format) {
102
+ guard isCurrent(pendingAsset) else { return }
120
103
  let timeRange = CMTimeRange(
121
104
  start: CMTime(seconds: 0, preferredTimescale: 1000),
122
105
  end: duration,
123
106
  )
124
107
  let group = AVTimedMetadataGroup(items: metadata, timeRange: timeRange)
125
- delegate?.mediaLoaderDidReceiveTimedMetadata([group])
108
+ onEvent?(.timedMetadata([group]))
126
109
  }
127
110
  }
128
111
  }
@@ -133,32 +116,34 @@ final class MediaLoader {
133
116
 
134
117
  do {
135
118
  let isPlayable = try await pendingAsset.load(.isPlayable)
136
-
137
- guard !Task.isCancelled else { return }
138
-
139
- await MainActor.run {
140
- guard pendingAsset == self.asset else { return }
141
-
142
- if !isPlayable {
143
- self.delegate?.mediaLoaderDidFailWithUnplayableTrack()
144
- return
145
- }
146
-
147
- let avItem = AVPlayerItem(asset: pendingAsset)
148
- avItem.preferredForwardBufferDuration = self.bufferDuration / 1000.0
149
- self.delegate?.mediaLoaderDidPrepareItem(avItem)
119
+ guard isCurrent(pendingAsset) else { return }
120
+ guard isPlayable else {
121
+ onEvent?(.unplayable)
122
+ return
150
123
  }
124
+ let avItem = AVPlayerItem(asset: pendingAsset)
125
+ avItem.preferredForwardBufferDuration = bufferDuration / 1000.0
126
+ onEvent?(.prepared(avItem))
151
127
  } catch {
152
- guard !Task.isCancelled else { return }
153
-
154
- await MainActor.run {
155
- guard pendingAsset == self.asset else { return }
156
- self.delegate?.mediaLoaderDidFailWithRetryableError(error)
157
- }
128
+ guard isCurrent(pendingAsset) else { return }
129
+ onEvent?(.failed(error))
158
130
  }
159
131
  }
160
132
  }
161
133
 
134
+ /// Whether `candidate` is still the load this loader cares about — checked
135
+ /// after EVERY await, not just once before a loop.
136
+ ///
137
+ /// Cancellation alone is not enough: it only sets a flag, and can't abort a
138
+ /// load already in flight inside AVFoundation (only `cancelLoading()` does,
139
+ /// and the track-change path deliberately doesn't call it — the old asset
140
+ /// still backs the playing item at that point). So a load that lands after
141
+ /// the track changed would otherwise attribute the old asset's metadata to
142
+ /// the newly loaded track.
143
+ private func isCurrent(_ candidate: AVURLAsset) -> Bool {
144
+ !Task.isCancelled && candidate == asset
145
+ }
146
+
162
147
  func cancelAll() {
163
148
  mediaResolverTask?.cancel()
164
149
  mediaResolverTask = nil
@@ -168,8 +153,6 @@ final class MediaLoader {
168
153
  playableLoadTask = nil
169
154
  }
170
155
 
171
- /// Preserves `url` and `urlOptions` so that `loadAsset()` can recreate the asset
172
- /// (used by `reload()` → `loadAVPlayer()` without a preceding `resolveAndLoad`).
173
156
  func clearAsset() {
174
157
  guard let currentAsset = asset else { return }
175
158
 
@@ -183,7 +166,7 @@ final class MediaLoader {
183
166
 
184
167
  /// Builds AVURLAsset options, merging any explicit headers with a resolved
185
168
  /// User-Agent. An explicit `User-Agent` in `headers` wins (mirrors the artwork
186
- /// path in BrowserManager+URLResolution). A nil/empty userAgent contributes
169
+ /// path in RequestPipeline). A nil/empty userAgent contributes
187
170
  /// nothing, so "no UA configured" still falls through to AVPlayer's default.
188
171
  nonisolated static func buildAssetOptions(
189
172
  headers: [String: String]?,
@@ -201,17 +184,13 @@ final class MediaLoader {
201
184
  private func loadWithResolvedUrl(_ resolved: MediaResolvedUrl) {
202
185
  guard let mediaUrl = URL(string: resolved.url) else {
203
186
  logger.error("Invalid media URL: \(resolved.url)")
204
- delegate?.mediaLoaderDidFailWithError(.invalidSourceUrl(resolved.url))
187
+ onEvent?(.invalidSource(resolved.url))
205
188
  return
206
189
  }
207
190
 
208
- let isLocalFile = mediaUrl.isFileURL
209
- url = isLocalFile ? URL(fileURLWithPath: mediaUrl.path) : mediaUrl
210
- urlOptions = Self.buildAssetOptions(headers: resolved.headers, userAgent: resolved.userAgent)
211
-
212
- logger.debug(" final playbackUrl: \(mediaUrl.absoluteString)")
213
- logger.debug(" isLocalFile: \(isLocalFile)")
214
-
215
- loadAsset()
191
+ loadAsset(
192
+ url: mediaUrl.isFileURL ? URL(fileURLWithPath: mediaUrl.path) : mediaUrl,
193
+ options: Self.buildAssetOptions(headers: resolved.headers, userAgent: resolved.userAgent),
194
+ )
216
195
  }
217
196
  }
@@ -0,0 +1,52 @@
1
+ #if canImport(NitroModules)
2
+ import NitroModules
3
+ #endif
4
+
5
+ /// The title, artist and album lines the now-playing surface shows.
6
+ struct NowPlayingLines: Equatable {
7
+ let title: String
8
+ let artist: String?
9
+ let album: String?
10
+
11
+ /// Each line from the first of `flash`, `formatted` and `override` that sets it, else the
12
+ /// track's own.
13
+ static func resolve(
14
+ track: Track,
15
+ flash: NowPlayingUpdate? = nil,
16
+ formatted: NowPlayingUpdate? = nil,
17
+ override: NowPlayingUpdate? = nil,
18
+ ) -> NowPlayingLines {
19
+ let layers = [flash, formatted, override].compactMap(\.self)
20
+ return NowPlayingLines(
21
+ title: layers.lazy.compactMap(\.title).first ?? track.title,
22
+ artist: layers.lazy.compactMap(\.artist).first ?? track.artist,
23
+ album: layers.lazy.compactMap(\.album).first ?? track.album,
24
+ )
25
+ }
26
+ }
27
+
28
+ /// The lines last stamped on the now-playing surface, and the track they were stamped for.
29
+ struct PublishedNowPlayingLines {
30
+ let trackId: String?
31
+ let lines: NowPlayingLines
32
+
33
+ init(_ lines: NowPlayingLines, for track: Track) {
34
+ trackId = track.identity ?? track.path
35
+ self.lines = lines
36
+ }
37
+
38
+ /// `lines` when they were stamped for `track`, else nil.
39
+ func lines(for track: Track) -> NowPlayingLines? {
40
+ trackId == (track.identity ?? track.path) ? lines : nil
41
+ }
42
+ }
43
+
44
+ /// What the now-playing surface renders from: the player's track and state.
45
+ @MainActor
46
+ protocol NowPlayingSource: AnyObject {
47
+ var currentTrack: Track? { get }
48
+ var currentTime: Double { get }
49
+ var playWhenReady: Bool { get }
50
+ var isStalled: Bool { get }
51
+ var nitroPlaybackError: PlaybackError? { get }
52
+ }
@@ -4,51 +4,138 @@ import NitroModules
4
4
  import os.log
5
5
 
6
6
  /// Owns the now-playing surface: publishes a track's static fields + artwork, and renders the
7
- /// title/artist line — the formatter's result, or the track/override default. The single writer of
8
- /// the title/artist fields, with a publish-dedupe so the frequent re-renders stay cheap.
9
- ///
10
- /// Does not exclusively own NowPlayingInfoController -- other callers (e.g. HybridAudioBrowser for
11
- /// overrides) can still access it directly.
7
+ /// title/artist line — a flash, else the formatter's result, else the override or the track's own
8
+ /// fields. Holds that state (override, flash, latest timed metadata, formatter) and reports each
9
+ /// change of the rendered lines through `onChanged`.
12
10
  @MainActor
13
11
  final class NowPlayingUpdater {
14
12
  private let logger = Logger(subsystem: "com.audiobrowser", category: "NowPlayingUpdater")
15
13
  private let nowPlayingInfoController: NowPlayingInfoController
16
14
 
15
+ weak var source: NowPlayingSource?
17
16
  var artworkUrlResolver: ((Track, ImageContext?) async -> ImageSource?)?
18
- /// Invoked when the published title/artist actually change, so the owner can emit the JS
19
- /// `onNowPlayingChanged` event (which it shapes with elapsed time / artwork / etc.).
20
- var onChanged: (@MainActor (_ track: Track, _ title: String, _ artist: String?, _ album: String?) -> Void)?
17
+ /// Called with the JS-facing metadata whenever the rendered lines or the track change.
18
+ var onChanged: ((NowPlayingMetadata) -> Void)?
19
+
20
+ /// When false the surface shows the track's own fields: the override and formatter are ignored.
21
+ private let enabled: Bool
22
+ var formatter: ((_ params: FormatNowPlayingParams) -> Promise<NowPlayingUpdate?>)?
23
+
24
+ /// Tells a stall apart: offline or buffering.
25
+ private weak var networkStatus: (any NetworkStatusProviding)?
26
+
27
+ private var override: NowPlayingUpdate?
28
+ private var timedMetadata: TimedMetadata?
29
+ /// A transient line (e.g. feedback for a refused remote command) that outranks the formatter
30
+ /// and the override, reverted by a native timer: JS timers pause in the background.
31
+ private var flash: NowPlayingUpdate?
32
+ private var flashRevert: DispatchWorkItem?
21
33
 
22
34
  private var artworkLoadTask: Task<Void, Never>?
23
- private var artworkGeneration: UInt = 0
24
35
 
25
- /// Last published text lines, to dedupe redundant writes (render runs on every transition).
26
- private struct Published: Equatable {
27
- let trackId: String?
28
- let title: String?
29
- let artist: String?
30
- let album: String?
36
+ /// The lines `onChanged` last reported, and their track, so a new track with the same text
37
+ /// still reports.
38
+ private var published: PublishedNowPlayingLines?
39
+
40
+ func setOverride(_ update: NowPlayingUpdate?) {
41
+ override = update
42
+ render()
43
+ }
44
+
45
+ func flash(_ update: NowPlayingUpdate, durationMs: Double) {
46
+ flashRevert?.cancel()
47
+ flash = update
48
+ let revert = DispatchWorkItem { [weak self] in
49
+ self?.flash = nil
50
+ self?.flashRevert = nil
51
+ self?.render()
52
+ }
53
+ flashRevert = revert
54
+ DispatchQueue.main.asyncAfter(deadline: .now() + durationMs / 1000, execute: revert)
55
+ render()
56
+ }
57
+
58
+ func clearFlash() {
59
+ guard flash != nil else { return }
60
+ cancelFlash()
61
+ render()
31
62
  }
32
63
 
33
- private var lastPublished: Published?
64
+ func receivedTimedMetadata(_ metadata: TimedMetadata) {
65
+ timedMetadata = metadata
66
+ render()
67
+ }
68
+
69
+ /// A new track drops the override, flash and timed metadata of the last one.
70
+ func trackChanged() {
71
+ override = nil
72
+ cancelFlash()
73
+ timedMetadata = nil
74
+ render()
75
+ }
76
+
77
+ /// The lines the surface shows for the current track, formatter result included; until the
78
+ /// track's first render, and while `enabled` is false, the flash, override or track fields.
79
+ var nowPlaying: NowPlayingMetadata? {
80
+ guard let track = source?.currentTrack else { return nil }
81
+ let rendered = enabled ? published?.lines(for: track) : nil
82
+ let lines = rendered ?? .resolve(track: track, flash: flash, override: override)
83
+ return metadata(track: track, lines: lines)
84
+ }
85
+
86
+ /// Empties the now-playing surface and drops any artwork fetch or formatter result in flight.
87
+ func clearNowPlaying() {
88
+ renderGeneration &+= 1
89
+ artworkLoadTask?.cancel()
90
+ artworkLoadTask = nil
91
+ nowPlayingInfoController.clear()
92
+ published = nil
93
+ formattedTrackId = nil
94
+ }
34
95
 
35
96
  /// Bumped on every `render`; an async formatter result applies only if its render is still the
36
97
  /// latest (latest-render-wins — drops a result whose track skipped or whose state moved on while
37
98
  /// the formatter was in flight).
38
99
  private var renderGeneration: UInt = 0
39
100
 
40
- init(nowPlayingInfoController: NowPlayingInfoController) {
101
+ /// The track whose *formatted* line is currently on the surface. While this
102
+ /// matches the rendering track, `render` skips its interim default write — see
103
+ /// the comment at that site. Cleared whenever the surface stops showing a
104
+ /// formatter result (a flash overwrites it, `clearNowPlaying` empties it).
105
+ private var formattedTrackId: String?
106
+
107
+ init(
108
+ nowPlayingInfoController: NowPlayingInfoController,
109
+ networkStatus: (any NetworkStatusProviding)?,
110
+ enabled: Bool,
111
+ formatter: ((_ params: FormatNowPlayingParams) -> Promise<NowPlayingUpdate?>)?,
112
+ ) {
41
113
  self.nowPlayingInfoController = nowPlayingInfoController
114
+ self.networkStatus = networkStatus
115
+ self.enabled = enabled
116
+ self.formatter = formatter
42
117
  }
43
118
 
119
+ /// Pixel width to request now-playing artwork at: the active scene's screen
120
+ /// width in pixels, capped at `maxArtworkPixelWidth`. With no foreground
121
+ /// scene (headless CarPlay) the cap stands in — every current device exceeds
122
+ /// it anyway, and this only sizes a CDN request.
123
+ private static var artworkPixelWidth: CGFloat {
124
+ guard let screen = UIApplication.shared.activeWindowScene?.screen else {
125
+ return maxArtworkPixelWidth
126
+ }
127
+ return min(screen.bounds.width * screen.scale, maxArtworkPixelWidth)
128
+ }
129
+
130
+ /// Mirrored by the Kotlin twin's `artworkSizePx`.
131
+ private static let maxArtworkPixelWidth: CGFloat = 1200
132
+
44
133
  /// Publishes the static, per-track fields + artwork on a track change. The title/artist/album
45
- /// lines are owned by `render` (routed through `applyFields` here so it dedupes against later
134
+ /// lines are owned by `render` (routed through `apply` here so it dedupes against later
46
135
  /// renders).
47
136
  func loadMetaValues(for track: Track) {
48
- nowPlayingInfoController.set(keyValues: [
49
- NowPlayingInfoProperty.isLiveStream(track.live),
50
- ])
51
- applyFields(track: track, title: track.title, artist: track.artist, album: track.album)
137
+ nowPlayingInfoController.set([MPNowPlayingInfoPropertyIsLiveStream: track.live])
138
+ apply(.resolve(track: track), for: track)
52
139
  loadArtwork(for: track)
53
140
  }
54
141
 
@@ -56,44 +143,43 @@ final class NowPlayingUpdater {
56
143
  /// immediately, then — when a formatter is configured — its async result overlaid (each field
57
144
  /// falling back to the default). A `flash` (transient line, e.g. feedback for a refused remote
58
145
  /// command) outranks both: while one is active the formatter pass is skipped entirely, so its
59
- /// async result can't land on top. Safe to call on every playback transition; redundant writes
60
- /// are deduped.
61
- func render(
62
- track: Track,
63
- timedMetadata: TimedMetadata?,
64
- playWhenReady: Bool,
65
- stalled: StallReason?,
66
- error: PlaybackError?,
67
- flash: NowPlayingUpdate? = nil,
68
- override: NowPlayingUpdate?,
69
- formatter: ((_ params: FormatNowPlayingParams) -> Promise<NowPlayingUpdate?>)?,
70
- ) {
146
+ /// async result can't land on top. Called on every playback transition; unchanged lines are not
147
+ /// re-published.
148
+ func render() {
149
+ guard let source, let track = source.currentTrack else { return }
150
+ let override = enabled ? self.override : nil
151
+ let formatter = enabled ? self.formatter : nil
71
152
  renderGeneration &+= 1
72
153
  let generation = renderGeneration
73
154
 
74
- let defaultTitle = override?.title ?? track.title
75
- let defaultSecondary = override?.artist ?? track.artist
76
- let defaultAlbum = override?.album ?? track.album
155
+ let trackId = track.identity ?? track.path
77
156
 
78
157
  if let flash {
79
- applyFields(
80
- track: track,
81
- title: flash.title ?? defaultTitle,
82
- artist: flash.artist ?? defaultSecondary,
83
- album: flash.album ?? defaultAlbum,
84
- )
158
+ apply(.resolve(track: track, flash: flash, override: override), for: track)
159
+ // The flash replaced the formatter's line, so the surface no longer shows
160
+ // one: the render that follows the flash reverting must publish the default
161
+ // immediately rather than sit on stale flash text awaiting the formatter.
162
+ formattedTrackId = nil
85
163
  return
86
164
  }
87
165
 
88
- applyFields(track: track, title: defaultTitle, artist: defaultSecondary, album: defaultAlbum)
166
+ // Publish the raw default only while no formatter result is on screen for this
167
+ // track. `render` runs on EVERY playback transition (state change, playing/
168
+ // buffering flip, timed-metadata tick, connectivity change); writing the
169
+ // default each time would flash the track title over the formatter's line
170
+ // until the async result lands, since the two differ by construction on a live
171
+ // stream (station name vs. song line).
172
+ if formatter == nil || formattedTrackId != trackId {
173
+ apply(.resolve(track: track, override: override), for: track)
174
+ }
89
175
 
90
176
  guard let formatter else { return }
91
177
  let params = FormatNowPlayingParams(
92
178
  track: track,
93
179
  timedMetadata: timedMetadata,
94
- playWhenReady: playWhenReady,
95
- stalled: stalled,
96
- error: error,
180
+ playWhenReady: source.playWhenReady,
181
+ stalled: source.isStalled ? ((networkStatus?.isOnline ?? true) ? .buffering : .offline) : nil,
182
+ error: source.nitroPlaybackError,
97
183
  )
98
184
  // `@Sendable` breaks the @MainActor isolation inheritance: Nitro resolves the promise on the JS
99
185
  // thread, so the resolver must NOT be main-isolated (a main-isolated closure run off-main traps
@@ -105,12 +191,10 @@ final class NowPlayingUpdater {
105
191
  Task { @MainActor in
106
192
  // Apply only if no newer render has superseded this one (fast skip / state moved on).
107
193
  guard self.renderGeneration == generation else { return }
108
- self.applyFields(
109
- track: track,
110
- title: formatted.title ?? defaultTitle,
111
- artist: formatted.artist ?? defaultSecondary,
112
- album: formatted.album ?? defaultAlbum,
113
- )
194
+ self.apply(.resolve(track: track, formatted: formatted, override: override), for: track)
195
+ // A formatter result now owns the surface for this track, so later
196
+ // renders skip the interim default write.
197
+ self.formattedTrackId = trackId
114
198
  }
115
199
  }
116
200
  .catch { @Sendable [weak self] error in
@@ -123,27 +207,45 @@ final class NowPlayingUpdater {
123
207
 
124
208
  // MARK: - Private
125
209
 
126
- /// Stamps the title/artist/album (each falling back to the track's own) onto
127
- /// NowPlayingInfoCenter, deduped against the last publish, and notifies `onChanged`.
128
- private func applyFields(track: Track, title: String?, artist: String?, album: String?) {
129
- let resolvedTitle = title ?? track.title
130
- let resolvedArtist = artist ?? track.artist
131
- let resolvedAlbum = album ?? track.album
132
- let published = Published(
133
- trackId: track.src ?? track.url,
134
- title: resolvedTitle,
135
- artist: resolvedArtist,
136
- album: resolvedAlbum,
210
+ /// Stamps the lines onto the now-playing surface, and notifies `onChanged` when the text or the
211
+ /// track changed.
212
+ private func apply(_ lines: NowPlayingLines, for track: Track) {
213
+ let textChanged = nowPlayingInfoController.set([
214
+ MPMediaItemPropertyTitle: lines.title,
215
+ MPMediaItemPropertyArtist: lines.artist,
216
+ MPMediaItemPropertyAlbumTitle: lines.album,
217
+ ])
218
+ guard textChanged || published?.lines(for: track) == nil else { return }
219
+ published = PublishedNowPlayingLines(lines, for: track)
220
+ onChanged?(metadata(track: track, lines: lines))
221
+ }
222
+
223
+ private func cancelFlash() {
224
+ flashRevert?.cancel()
225
+ flashRevert = nil
226
+ flash = nil
227
+ }
228
+
229
+ private func metadata(track: Track, lines: NowPlayingLines) -> NowPlayingMetadata {
230
+ NowPlayingMetadata(
231
+ elapsedTime: source?.currentTime,
232
+ title: lines.title,
233
+ album: lines.album,
234
+ artist: lines.artist,
235
+ duration: track.duration,
236
+ artwork: Self.jsArtwork(for: track),
237
+ description: track.description,
238
+ mediaId: track.src ?? track.path,
239
+ genre: track.genre,
137
240
  )
138
- guard published != lastPublished else { return }
139
- lastPublished = published
241
+ }
140
242
 
141
- nowPlayingInfoController.set(keyValues: [
142
- MediaItemProperty.title(resolvedTitle),
143
- MediaItemProperty.artist(resolvedArtist),
144
- MediaItemProperty.albumTitle(resolvedAlbum),
145
- ])
146
- onChanged?(track, resolvedTitle, resolvedArtist, resolvedAlbum)
243
+ /// The artwork URI JS can load: the resolved `artworkSource` (a rendered SF Symbol's `file://`
244
+ /// included), else the raw artwork unless it is an SF Symbol.
245
+ private static func jsArtwork(for track: Track) -> String? {
246
+ if let uri = track.artworkSource?.uri { return uri }
247
+ guard let artwork = track.artwork?.url else { return nil }
248
+ return SFSymbolRenderer.isSFSymbol(artwork) ? nil : artwork
147
249
  }
148
250
 
149
251
  private func loadArtwork(for track: Track) {
@@ -152,15 +254,10 @@ final class NowPlayingUpdater {
152
254
  let artworkUrl = track.artworkSource?.uri ?? track.artwork?.url
153
255
  logger.debug("loadArtwork: \(track.title), artworkUrl: \(artworkUrl ?? "nil")")
154
256
 
155
- // Now Playing artwork: use screen width in pixels, capped at 1200px
156
- let screenScale = UIScreen.main.scale
157
- let screenWidth = UIScreen.main.bounds.width * screenScale
158
- let artworkSize = min(screenWidth, 1200)
257
+ let artworkSize = Self.artworkPixelWidth
159
258
  let nowPlayingSize = ImageContext(width: artworkSize, height: artworkSize)
160
259
 
161
260
  artworkLoadTask?.cancel()
162
- artworkGeneration &+= 1
163
- let expectedGeneration = artworkGeneration
164
261
  artworkLoadTask = Task {
165
262
  let image: UIImage?
166
263
 
@@ -168,19 +265,19 @@ final class NowPlayingUpdater {
168
265
  if let resolver = artworkUrlResolver,
169
266
  let imageSource = await resolver(track, nowPlayingSize)
170
267
  {
171
- guard !Task.isCancelled, artworkGeneration == expectedGeneration else { return }
268
+ guard !Task.isCancelled else { return }
172
269
  logger.debug("loadArtwork: using resolved URL: \(imageSource.uri)")
173
- image = await ArtworkImageFetcher.fetchImage(from: imageSource)
270
+ image = await ArtworkImageFetcher.fetchImage(from: imageSource, waitsForConnectivity: true)
174
271
  } else {
175
- guard !Task.isCancelled, artworkGeneration == expectedGeneration else { return }
272
+ guard !Task.isCancelled else { return }
176
273
  if let source = track.artworkImageSource {
177
- image = await ArtworkImageFetcher.fetchImage(from: source)
274
+ image = await ArtworkImageFetcher.fetchImage(from: source, waitsForConnectivity: true)
178
275
  } else {
179
276
  image = nil
180
277
  }
181
278
  }
182
279
 
183
- guard !Task.isCancelled, artworkGeneration == expectedGeneration else { return }
280
+ guard !Task.isCancelled else { return }
184
281
 
185
282
  if let image {
186
283
  logger.debug("loadArtwork: loaded image \(image.size.width)x\(image.size.height)")
@@ -189,10 +286,10 @@ final class NowPlayingUpdater {
189
286
  let artwork = MPMediaItemArtwork(boundsSize: image.size) { @Sendable requestedSize in
190
287
  return image
191
288
  }
192
- nowPlayingInfoController.set(keyValue: MediaItemProperty.artwork(artwork))
289
+ nowPlayingInfoController.set([MPMediaItemPropertyArtwork: artwork])
193
290
  } else {
194
291
  logger.debug("loadArtwork: no image loaded")
195
- nowPlayingInfoController.set(keyValue: MediaItemProperty.artwork(nil))
292
+ nowPlayingInfoController.set([MPMediaItemPropertyArtwork: nil])
196
293
  }
197
294
  }
198
295
  }