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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1211) hide show
  1. package/README.md +66 -39
  2. package/android/build.gradle +58 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  5. package/android/src/main/AndroidManifest.xml +14 -1
  6. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -419
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  9. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  10. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  11. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  12. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +163 -0
  13. package/android/src/main/java/com/audiobrowser/Service.kt +61 -72
  14. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +44 -0
  15. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  16. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  17. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +334 -536
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +37 -68
  19. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  20. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  21. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  22. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  23. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -29
  24. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  25. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  26. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  27. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  28. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  29. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  30. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  31. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  32. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  33. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +18 -40
  34. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  35. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  36. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  37. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  38. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  39. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  40. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  41. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  42. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  43. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  44. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +14 -31
  45. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  46. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +38 -27
  47. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +585 -342
  48. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  49. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +96 -113
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  51. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +41 -35
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +125 -133
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  54. package/android/src/main/java/com/audiobrowser/player/Player.kt +396 -561
  55. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  56. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +14 -21
  57. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +59 -113
  58. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +42 -101
  59. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  60. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  61. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  62. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  63. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +32 -67
  64. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +101 -0
  67. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  68. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  69. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +682 -0
  70. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  71. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  72. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  73. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  74. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +200 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  86. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  87. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  88. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  89. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  90. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  91. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  92. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  93. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  94. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -15
  95. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  96. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  97. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  98. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  99. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  100. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  101. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  102. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  103. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  104. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  105. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +27 -56
  106. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  107. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  108. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  109. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  110. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  111. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  112. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  113. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -82
  114. package/android/src/main/res/values/strings.xml +25 -5
  115. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  116. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  117. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  118. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +39 -0
  119. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +88 -0
  120. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +201 -0
  121. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -43
  122. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  123. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  124. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  125. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +158 -0
  126. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -23
  127. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +314 -8
  128. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  129. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  130. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -4
  131. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  132. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -55
  133. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  134. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  135. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  136. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  137. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  138. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  139. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  140. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +460 -0
  141. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  142. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  143. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  144. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  145. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  146. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  147. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  148. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  149. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +223 -20
  150. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +2 -26
  151. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +45 -33
  152. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  153. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  154. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  155. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +150 -0
  156. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  157. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  158. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +179 -0
  159. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +93 -0
  160. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  161. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +190 -0
  162. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +22 -65
  163. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  164. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  165. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  166. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  167. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  168. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +279 -0
  169. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  170. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  171. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  172. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +926 -0
  173. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  174. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  175. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  176. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  177. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  178. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  179. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  180. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  181. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +167 -0
  182. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  183. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  184. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  185. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  186. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  187. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  188. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  189. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  190. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  191. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  192. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  193. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  194. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  195. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  196. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  197. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  198. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  199. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  200. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  201. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  202. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  203. package/android/src/test/resources/sonos/device_description.xml +78 -0
  204. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  205. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  206. package/ios/AVPlayerEngine.swift +354 -0
  207. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  208. package/ios/Browser/BrowseGate.swift +57 -0
  209. package/ios/Browser/BrowserConfig.swift +123 -104
  210. package/ios/Browser/BrowserError.swift +15 -0
  211. package/ios/Browser/BrowserManager.swift +139 -676
  212. package/ios/Browser/BrowserPathHelper.swift +54 -117
  213. package/ios/Browser/FavoriteSet.swift +43 -0
  214. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  215. package/ios/Browser/JsonModels.swift +244 -335
  216. package/ios/Browser/NavigationErrorState.swift +42 -0
  217. package/ios/Browser/PageResolver.swift +137 -0
  218. package/ios/Browser/RequestLayer.swift +181 -0
  219. package/ios/Browser/RequestPipeline.swift +293 -0
  220. package/ios/Browser/SearchDrillIn.swift +11 -17
  221. package/ios/Browser/SectionScope.swift +73 -26
  222. package/ios/Browser/SimpleRouter.swift +76 -154
  223. package/ios/Browser/StyleResolver.swift +41 -0
  224. package/ios/Browser/TabBarEntries.swift +8 -7
  225. package/ios/Browser/TrackIdTemplate.swift +29 -0
  226. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  227. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  228. package/ios/CarPlay/CarPlayController.swift +37 -1297
  229. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  230. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  231. package/ios/CarPlay/CarPlayNowPlayingManager.swift +129 -204
  232. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  233. package/ios/CarPlay/CarPlaySession+PageLoader.swift +92 -0
  234. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  235. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  236. package/ios/CarPlay/CarPlaySession.swift +203 -0
  237. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  238. package/ios/CarPlay/IntentHandlers.swift +94 -0
  239. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  240. package/ios/CarPlay/MediaIntentHandler.swift +63 -0
  241. package/ios/CarPlay/MediaIntentPlayback.swift +75 -0
  242. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  243. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  244. package/ios/CarPlay/SectionPresentation.swift +67 -0
  245. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  246. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  247. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  248. package/ios/Extension/CxxVectorConformances.swift +4 -16
  249. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  250. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  251. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  252. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  253. package/ios/Extension/SearchParams+Query.swift +28 -0
  254. package/ios/Extension/Section+Copying.swift +26 -0
  255. package/ios/Extension/String+IcyCharset.swift +21 -0
  256. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  257. package/ios/Extension/Track+AVPlayer.swift +1 -18
  258. package/ios/Extension/Track+Copying.swift +13 -21
  259. package/ios/Extension/Track+Identity.swift +20 -0
  260. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  261. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  262. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  263. package/ios/Extension/URLError+Connectivity.swift +15 -0
  264. package/ios/Extension/Variant+Artwork.swift +8 -22
  265. package/ios/Http/HttpClient.swift +73 -167
  266. package/ios/HybridAudioBrowser+Browser.swift +130 -0
  267. package/ios/HybridAudioBrowser+Options.swift +102 -0
  268. package/ios/HybridAudioBrowser+Player.swift +333 -0
  269. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  270. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  271. package/ios/HybridAudioBrowser.swift +138 -1684
  272. package/ios/Model/NitroTypeStubs.swift +240 -32
  273. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  274. package/ios/Model/RemoteCommand.swift +6 -60
  275. package/ios/Model/TrackPlayerError.swift +14 -23
  276. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  277. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  278. package/ios/Observer/ItemObserver.swift +92 -0
  279. package/ios/Observer/PlayerObserver.swift +59 -0
  280. package/ios/Option/SessionCategories.swift +42 -92
  281. package/ios/PlaybackEvent.swift +2 -2
  282. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  283. package/ios/Player/AudioSessionController.swift +190 -0
  284. package/ios/Player/DeferredSeek.swift +70 -0
  285. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  286. package/ios/Player/ErrorStatus.swift +51 -0
  287. package/ios/Player/MediaLoader.swift +73 -98
  288. package/ios/Player/NowPlayingLines.swift +49 -0
  289. package/ios/Player/NowPlayingUpdater.swift +176 -105
  290. package/ios/Player/PersistedPlaybackState.swift +1 -2
  291. package/ios/Player/PlaybackFailure.swift +121 -0
  292. package/ios/Player/PlaybackPersistence.swift +72 -0
  293. package/ios/Player/PlaybackStateMachine.swift +8 -11
  294. package/ios/Player/PlaybackTimer.swift +11 -8
  295. package/ios/Player/Player.swift +968 -0
  296. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  297. package/ios/Player/PlayerEngine.swift +104 -0
  298. package/ios/Player/PlayerStatusTypes.swift +1 -6
  299. package/ios/Player/QueueManager.swift +80 -98
  300. package/ios/Player/RetryLoop.swift +280 -0
  301. package/ios/Player/ShuffleOrder.swift +36 -43
  302. package/ios/Player/SleepTimerManager.swift +25 -42
  303. package/ios/Player/VolumeFader.swift +20 -15
  304. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +33 -0
  305. package/ios/RemoteCommand/RemoteCommandController.swift +101 -336
  306. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  307. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  308. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  309. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  310. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  311. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  312. package/ios/Tests/DeferredSeekTests.swift +68 -0
  313. package/ios/Tests/EmitterTests.swift +22 -39
  314. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  315. package/ios/Tests/ErrorStatusTests.swift +50 -0
  316. package/ios/Tests/FavoriteSetTests.swift +61 -0
  317. package/ios/Tests/GenerationMemoTests.swift +121 -0
  318. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  319. package/ios/Tests/JsonModelsTests.swift +189 -3
  320. package/ios/Tests/LRUCacheTests.swift +106 -0
  321. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  322. package/ios/Tests/MediaLoaderTests.swift +38 -78
  323. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  324. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  325. package/ios/Tests/ObserverTests.swift +88 -0
  326. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  327. package/ios/Tests/PlaybackFailureTests.swift +181 -0
  328. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  329. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  330. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  331. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  332. package/ios/Tests/PlayerPolicyTests.swift +444 -0
  333. package/ios/Tests/PlayerTests.swift +1403 -0
  334. package/ios/Tests/PlayingStateTests.swift +41 -0
  335. package/ios/Tests/QueueManagerTests.swift +205 -174
  336. package/ios/Tests/ReadyValueTests.swift +73 -0
  337. package/ios/Tests/RemoteCommandControllerTests.swift +173 -0
  338. package/ios/Tests/RequestLayerTests.swift +228 -0
  339. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  340. package/ios/Tests/RetryLoopTests.swift +282 -0
  341. package/ios/Tests/SearchDrillInTests.swift +16 -17
  342. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  343. package/ios/Tests/SectionPresentationTests.swift +85 -0
  344. package/ios/Tests/SectionScopeTests.swift +136 -54
  345. package/ios/Tests/SimpleRouterTests.swift +39 -8
  346. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  347. package/ios/Tests/StyleResolverTests.swift +123 -0
  348. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  349. package/ios/Tests/Support/TestTypes.swift +135 -100
  350. package/ios/Tests/TabBarEntriesTests.swift +19 -21
  351. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  352. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  353. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  354. package/ios/Tests/TrackIdentityTests.swift +20 -0
  355. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  356. package/ios/Tests/TrackSelectorTests.swift +157 -34
  357. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  358. package/ios/TrackSelector.swift +62 -77
  359. package/ios/Util/ArtworkFreshness.swift +42 -0
  360. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  361. package/ios/Util/ConcurrentMap.swift +19 -0
  362. package/ios/Util/Emitter.swift +45 -22
  363. package/ios/Util/GenerationMemo.swift +36 -0
  364. package/ios/Util/LRUCache.swift +23 -159
  365. package/ios/Util/NetworkMonitor.swift +31 -33
  366. package/ios/Util/OutputPicker.swift +48 -0
  367. package/ios/Util/ReadyValue.swift +57 -0
  368. package/ios/Util/SFSymbolRenderer.swift +64 -49
  369. package/ios/Util/SVGProcessor.swift +9 -16
  370. package/lib/commonjs/AudioBrowser.js +8 -8
  371. package/lib/commonjs/AudioBrowser.js.map +1 -1
  372. package/lib/commonjs/CLAUDE.md +57 -0
  373. package/lib/commonjs/features/battery.js +16 -12
  374. package/lib/commonjs/features/battery.js.map +1 -1
  375. package/lib/commonjs/features/browser-config.js +13 -9
  376. package/lib/commonjs/features/browser-config.js.map +1 -1
  377. package/lib/commonjs/features/browser.js +78 -20
  378. package/lib/commonjs/features/browser.js.map +1 -1
  379. package/lib/commonjs/features/carConnection.js +3 -4
  380. package/lib/commonjs/features/carConnection.js.map +1 -1
  381. package/lib/commonjs/features/equalizer.js +10 -6
  382. package/lib/commonjs/features/equalizer.js.map +1 -1
  383. package/lib/commonjs/features/errors.js +35 -21
  384. package/lib/commonjs/features/errors.js.map +1 -1
  385. package/lib/commonjs/features/favorites.js +29 -24
  386. package/lib/commonjs/features/favorites.js.map +1 -1
  387. package/lib/commonjs/features/gate.js +28 -7
  388. package/lib/commonjs/features/gate.js.map +1 -1
  389. package/lib/commonjs/features/metadata.js +33 -14
  390. package/lib/commonjs/features/metadata.js.map +1 -1
  391. package/lib/commonjs/features/network.js +6 -2
  392. package/lib/commonjs/features/network.js.map +1 -1
  393. package/lib/commonjs/features/nowPlaying.js +29 -15
  394. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  395. package/lib/commonjs/features/output.js +10 -5
  396. package/lib/commonjs/features/output.js.map +1 -1
  397. package/lib/commonjs/features/playback/controls.js +13 -6
  398. package/lib/commonjs/features/playback/controls.js.map +1 -1
  399. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  400. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  401. package/lib/commonjs/features/playback/playing.js +5 -3
  402. package/lib/commonjs/features/playback/playing.js.map +1 -1
  403. package/lib/commonjs/features/playback/progress.js +13 -6
  404. package/lib/commonjs/features/playback/progress.js.map +1 -1
  405. package/lib/commonjs/features/playback/rate.js +8 -1
  406. package/lib/commonjs/features/playback/rate.js.map +1 -1
  407. package/lib/commonjs/features/playback/state.js +5 -6
  408. package/lib/commonjs/features/playback/state.js.map +1 -1
  409. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -7
  410. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  411. package/lib/commonjs/features/playback/volume.js +6 -5
  412. package/lib/commonjs/features/playback/volume.js.map +1 -1
  413. package/lib/commonjs/features/player/options.js +23 -29
  414. package/lib/commonjs/features/player/options.js.map +1 -1
  415. package/lib/commonjs/features/player/setup.js +41 -41
  416. package/lib/commonjs/features/player/setup.js.map +1 -1
  417. package/lib/commonjs/features/player/validateOptions.js +23 -0
  418. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  419. package/lib/commonjs/features/queue/activeTrack.js +15 -5
  420. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  421. package/lib/commonjs/features/queue/queue.js +58 -23
  422. package/lib/commonjs/features/queue/queue.js.map +1 -1
  423. package/lib/commonjs/features/queue/repeatMode.js +3 -2
  424. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  425. package/lib/commonjs/features/queue/shuffle.js +1 -2
  426. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  427. package/lib/commonjs/features/remoteControls.js +70 -125
  428. package/lib/commonjs/features/remoteControls.js.map +1 -1
  429. package/lib/commonjs/features/sleepTimer.js +28 -7
  430. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  431. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  432. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  433. package/lib/commonjs/utils/LazyNativeEmitter.js +25 -14
  434. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  435. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -12
  436. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  437. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  438. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  439. package/lib/commonjs/utils/useDebug.js +16 -3
  440. package/lib/commonjs/utils/useDebug.js.map +1 -1
  441. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  442. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  443. package/lib/commonjs/web/NativeAudioBrowser.js +204 -81
  444. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  445. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  446. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  447. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  448. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  449. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  450. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  451. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  452. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  453. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  454. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  455. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  456. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  457. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  458. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  459. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  460. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  461. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  462. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  463. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  464. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  465. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  466. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  467. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  468. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  469. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  470. package/lib/commonjs/web/browser/sections.js +89 -0
  471. package/lib/commonjs/web/browser/sections.js.map +1 -0
  472. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  473. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  474. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  475. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  476. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  477. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  478. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  479. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  480. package/lib/module/AudioBrowser.js +2 -1
  481. package/lib/module/AudioBrowser.js.map +1 -1
  482. package/lib/module/CLAUDE.md +57 -0
  483. package/lib/module/features/battery.js +16 -12
  484. package/lib/module/features/battery.js.map +1 -1
  485. package/lib/module/features/browser-config.js +13 -9
  486. package/lib/module/features/browser-config.js.map +1 -1
  487. package/lib/module/features/browser.js +78 -20
  488. package/lib/module/features/browser.js.map +1 -1
  489. package/lib/module/features/carConnection.js +3 -4
  490. package/lib/module/features/carConnection.js.map +1 -1
  491. package/lib/module/features/equalizer.js +10 -6
  492. package/lib/module/features/equalizer.js.map +1 -1
  493. package/lib/module/features/errors.js +35 -21
  494. package/lib/module/features/errors.js.map +1 -1
  495. package/lib/module/features/favorites.js +29 -24
  496. package/lib/module/features/favorites.js.map +1 -1
  497. package/lib/module/features/gate.js +28 -7
  498. package/lib/module/features/gate.js.map +1 -1
  499. package/lib/module/features/metadata.js +33 -14
  500. package/lib/module/features/metadata.js.map +1 -1
  501. package/lib/module/features/network.js +6 -2
  502. package/lib/module/features/network.js.map +1 -1
  503. package/lib/module/features/nowPlaying.js +29 -15
  504. package/lib/module/features/nowPlaying.js.map +1 -1
  505. package/lib/module/features/output.js +10 -5
  506. package/lib/module/features/output.js.map +1 -1
  507. package/lib/module/features/playback/controls.js +13 -6
  508. package/lib/module/features/playback/controls.js.map +1 -1
  509. package/lib/module/features/playback/playWhenReady.js +6 -5
  510. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  511. package/lib/module/features/playback/playing.js +5 -3
  512. package/lib/module/features/playback/playing.js.map +1 -1
  513. package/lib/module/features/playback/progress.js +13 -6
  514. package/lib/module/features/playback/progress.js.map +1 -1
  515. package/lib/module/features/playback/rate.js +8 -1
  516. package/lib/module/features/playback/rate.js.map +1 -1
  517. package/lib/module/features/playback/state.js +5 -6
  518. package/lib/module/features/playback/state.js.map +1 -1
  519. package/lib/module/features/playback/trackPlaybackTime.js +6 -6
  520. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  521. package/lib/module/features/playback/volume.js +6 -5
  522. package/lib/module/features/playback/volume.js.map +1 -1
  523. package/lib/module/features/player/options.js +22 -27
  524. package/lib/module/features/player/options.js.map +1 -1
  525. package/lib/module/features/player/setup.js +40 -40
  526. package/lib/module/features/player/setup.js.map +1 -1
  527. package/lib/module/features/player/validateOptions.js +19 -0
  528. package/lib/module/features/player/validateOptions.js.map +1 -0
  529. package/lib/module/features/queue/activeTrack.js +15 -5
  530. package/lib/module/features/queue/activeTrack.js.map +1 -1
  531. package/lib/module/features/queue/queue.js +58 -23
  532. package/lib/module/features/queue/queue.js.map +1 -1
  533. package/lib/module/features/queue/repeatMode.js +3 -2
  534. package/lib/module/features/queue/repeatMode.js.map +1 -1
  535. package/lib/module/features/queue/shuffle.js +1 -2
  536. package/lib/module/features/queue/shuffle.js.map +1 -1
  537. package/lib/module/features/remoteControls.js +70 -125
  538. package/lib/module/features/remoteControls.js.map +1 -1
  539. package/lib/module/features/sleepTimer.js +28 -7
  540. package/lib/module/features/sleepTimer.js.map +1 -1
  541. package/lib/module/test-utils/reactNativeStub.js +58 -0
  542. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  543. package/lib/module/utils/LazyNativeEmitter.js +25 -14
  544. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  545. package/lib/module/utils/NativeUpdatedValue.js +31 -12
  546. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  547. package/lib/module/utils/getTrackIdentity.js +22 -0
  548. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  549. package/lib/module/utils/useDebug.js +16 -3
  550. package/lib/module/utils/useDebug.js.map +1 -1
  551. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  552. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  553. package/lib/module/web/NativeAudioBrowser.js +204 -81
  554. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  555. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  556. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  557. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  558. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  559. package/lib/module/web/TrackPlayer/Player.js +254 -39
  560. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  561. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  562. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  563. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  564. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  565. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  566. package/lib/module/web/browser/BrowserManager.js +175 -100
  567. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  568. package/lib/module/web/browser/FavoriteManager.js +31 -21
  569. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  570. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  571. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  572. package/lib/module/web/browser/SearchManager.js +18 -23
  573. package/lib/module/web/browser/SearchManager.js.map +1 -1
  574. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  575. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  576. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  577. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  578. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  579. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  580. package/lib/module/web/browser/sections.js +83 -0
  581. package/lib/module/web/browser/sections.js.map +1 -0
  582. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  583. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  584. package/lib/module/web/http/followMediaRedirect.js +215 -0
  585. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  586. package/lib/module/web/player/NowPlayingManager.js +4 -3
  587. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  588. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  589. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  590. package/lib/typescript/package.json +1 -0
  591. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  592. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  593. package/lib/typescript/src/features/battery.d.ts +17 -12
  594. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  595. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  596. package/lib/typescript/src/features/browser.d.ts +67 -19
  597. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  598. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  599. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  600. package/lib/typescript/src/features/equalizer.d.ts +10 -6
  601. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  602. package/lib/typescript/src/features/errors.d.ts +37 -22
  603. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  604. package/lib/typescript/src/features/favorites.d.ts +29 -24
  605. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  606. package/lib/typescript/src/features/gate.d.ts +32 -10
  607. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  608. package/lib/typescript/src/features/metadata.d.ts +54 -17
  609. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  610. package/lib/typescript/src/features/network.d.ts +6 -2
  611. package/lib/typescript/src/features/network.d.ts.map +1 -1
  612. package/lib/typescript/src/features/nowPlaying.d.ts +29 -15
  613. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  614. package/lib/typescript/src/features/output.d.ts +10 -5
  615. package/lib/typescript/src/features/output.d.ts.map +1 -1
  616. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  617. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  618. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  619. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  620. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  621. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  622. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  623. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  624. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  625. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  626. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  627. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  628. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  629. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  630. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  631. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  632. package/lib/typescript/src/features/player/options.d.ts +74 -57
  633. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  634. package/lib/typescript/src/features/player/setup.d.ts +110 -60
  635. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  636. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  637. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  638. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -3
  639. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  640. package/lib/typescript/src/features/queue/queue.d.ts +52 -21
  641. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  642. package/lib/typescript/src/features/queue/repeatMode.d.ts +2 -2
  643. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  644. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -2
  645. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  646. package/lib/typescript/src/features/remoteControls.d.ts +81 -47
  647. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  648. package/lib/typescript/src/features/sleepTimer.d.ts +16 -8
  649. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  650. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  651. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  652. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  653. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  654. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  655. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  656. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  657. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  658. package/lib/typescript/src/types/browser.d.ts +242 -173
  659. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  660. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +16 -16
  661. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  662. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -18
  663. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  664. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  665. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  666. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  667. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  668. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  669. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  670. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  671. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  672. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  673. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  674. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  675. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  676. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  677. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  678. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  679. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  680. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  681. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  682. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  683. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  684. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  685. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  686. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  687. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  688. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  689. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  690. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  691. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  692. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  693. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  694. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  695. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  696. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  697. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  698. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  699. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  700. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  701. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  702. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  703. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  704. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  705. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  706. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  707. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  708. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  709. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  710. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  711. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  712. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  713. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  714. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  715. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  716. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  717. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  718. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  719. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  720. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  721. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  722. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  723. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  724. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  725. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  726. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  727. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  728. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  729. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  735. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  736. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  742. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  743. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  745. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  746. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  747. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  749. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  750. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  751. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  752. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +72 -44
  754. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  755. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  756. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  757. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  758. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  759. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  760. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  762. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  763. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  765. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  766. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  767. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  768. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  769. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  771. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  772. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  773. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  774. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  777. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  780. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  783. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  785. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  787. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  795. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  798. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  799. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  801. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  802. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  807. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  809. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  810. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  814. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  815. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  816. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  818. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  820. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  821. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  822. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  823. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  824. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  826. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  827. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  828. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  829. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  830. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  831. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  832. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  833. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  834. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  835. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  836. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  837. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  838. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  839. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  840. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  841. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  842. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  843. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  844. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  845. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  846. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  847. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  848. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  849. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  850. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  851. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  852. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  853. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  854. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  855. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  856. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  857. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  858. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  859. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  860. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  861. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  862. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  863. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  864. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  865. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  866. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  867. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  868. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  869. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  870. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  871. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  872. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  873. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  874. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  875. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  876. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  877. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  878. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  879. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  880. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  881. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  882. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  883. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  884. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  885. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  886. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  887. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  971. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  972. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  973. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +788 -641
  974. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  975. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +33 -12
  976. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  977. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  978. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  979. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  980. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  981. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  982. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  983. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  984. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  985. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  986. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  987. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  988. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  989. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  990. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  991. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  992. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  993. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  994. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  995. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  996. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  997. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  998. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  999. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1000. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1001. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1002. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1003. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1004. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1005. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1006. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1007. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1008. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1009. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1010. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1011. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1012. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  1013. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  1014. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1015. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1016. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1017. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1018. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1019. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1020. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1021. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1022. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1023. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1024. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1025. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1026. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1027. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1028. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1029. package/package.json +26 -12
  1030. package/src/AudioBrowser.ts +2 -1
  1031. package/src/CLAUDE.md +57 -0
  1032. package/src/docs-floors.test.ts +71 -0
  1033. package/src/features/battery.test.ts +79 -0
  1034. package/src/features/battery.ts +17 -13
  1035. package/src/features/browser-config.test.ts +21 -6
  1036. package/src/features/browser-config.ts +13 -9
  1037. package/src/features/browser.test.ts +1 -1
  1038. package/src/features/browser.ts +69 -20
  1039. package/src/features/carConnection.ts +3 -4
  1040. package/src/features/equalizer.ts +10 -6
  1041. package/src/features/errors.ts +37 -22
  1042. package/src/features/favorites.ts +29 -24
  1043. package/src/features/gate.ts +30 -9
  1044. package/src/features/hook-wiring.test.ts +302 -0
  1045. package/src/features/metadata.ts +54 -17
  1046. package/src/features/network.ts +6 -2
  1047. package/src/features/nowPlaying.ts +29 -15
  1048. package/src/features/output.ts +10 -5
  1049. package/src/features/playback/controls.ts +13 -6
  1050. package/src/features/playback/playWhenReady.ts +6 -5
  1051. package/src/features/playback/playing.ts +16 -3
  1052. package/src/features/playback/progress.test.ts +169 -0
  1053. package/src/features/playback/progress.ts +13 -6
  1054. package/src/features/playback/rate.ts +8 -1
  1055. package/src/features/playback/state.ts +10 -6
  1056. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  1057. package/src/features/playback/trackPlaybackTime.ts +9 -7
  1058. package/src/features/playback/volume.ts +6 -5
  1059. package/src/features/player/options.ts +83 -82
  1060. package/src/features/player/setup.test.ts +12 -3
  1061. package/src/features/player/setup.ts +123 -64
  1062. package/src/features/player/validateOptions.ts +21 -0
  1063. package/src/features/queue/activeTrack.ts +15 -5
  1064. package/src/features/queue/queue.ts +58 -23
  1065. package/src/features/queue/repeatMode.ts +2 -2
  1066. package/src/features/queue/shuffle.ts +1 -2
  1067. package/src/features/remoteControls.ts +70 -125
  1068. package/src/features/sleepTimer.test.ts +172 -0
  1069. package/src/features/sleepTimer.ts +24 -8
  1070. package/src/nitro-stub-drift.test.ts +277 -0
  1071. package/src/public-surface.test.ts +147 -0
  1072. package/src/specs/audio-browser.nitro.ts +10 -8
  1073. package/src/style-resolution.test.ts +210 -0
  1074. package/src/test-utils/reactNativeStub.ts +60 -0
  1075. package/src/types/browser-native.ts +7 -3
  1076. package/src/types/browser-nodes.ts +417 -151
  1077. package/src/types/browser.ts +248 -177
  1078. package/src/utils/LazyNativeEmitter.ts +25 -15
  1079. package/src/utils/NativeUpdatedValue.ts +29 -12
  1080. package/src/utils/getTrackIdentity.ts +22 -0
  1081. package/src/utils/useDebug.test.ts +182 -0
  1082. package/src/utils/useDebug.ts +16 -3
  1083. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  1084. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  1085. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1086. package/src/web/NativeAudioBrowser.ts +243 -88
  1087. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1088. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1089. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1090. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  1091. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1092. package/src/web/TrackPlayer/Player.ts +284 -37
  1093. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1094. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1095. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1096. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1097. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  1098. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1099. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1100. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1101. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1102. package/src/web/__tests__/retry.test.ts +169 -0
  1103. package/src/web/browser/BrowserManager.ts +209 -111
  1104. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1105. package/src/web/browser/FavoriteManager.ts +28 -23
  1106. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1107. package/src/web/browser/SearchManager.test.ts +75 -0
  1108. package/src/web/browser/SearchManager.ts +25 -28
  1109. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1110. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1111. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1112. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1113. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1114. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1115. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1116. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1117. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1118. package/src/web/browser/parseSearchResponse.ts +3 -4
  1119. package/src/web/browser/sections.test.ts +91 -0
  1120. package/src/web/browser/sections.ts +72 -0
  1121. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1122. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1123. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1124. package/src/web/http/followMediaRedirect.ts +253 -0
  1125. package/src/web/player/NowPlayingManager.ts +4 -3
  1126. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1127. package/src/web/util/BrowserPathHelper.ts +68 -13
  1128. package/website/guide/android-auto.md +126 -0
  1129. package/website/guide/android-certificates.md +488 -0
  1130. package/website/guide/artwork.md +300 -0
  1131. package/website/guide/audio-output.md +357 -0
  1132. package/website/guide/automotive.md +91 -0
  1133. package/website/guide/basic-usage.md +154 -0
  1134. package/website/guide/battery.md +142 -0
  1135. package/website/guide/browser.md +674 -0
  1136. package/website/guide/carplay.md +733 -0
  1137. package/website/guide/configuration.md +215 -0
  1138. package/website/guide/equalizer.md +235 -0
  1139. package/website/guide/errors.md +352 -0
  1140. package/website/guide/favorites.md +164 -0
  1141. package/website/guide/gate.md +157 -0
  1142. package/website/guide/getting-started.md +99 -0
  1143. package/website/guide/hooks.md +244 -0
  1144. package/website/guide/live-streams.md +156 -0
  1145. package/website/guide/metadata.md +273 -0
  1146. package/website/guide/migrating-from-track-player.md +289 -0
  1147. package/website/guide/native-callback-fetch.md +137 -0
  1148. package/website/guide/network.md +102 -0
  1149. package/website/guide/now-playing.md +203 -0
  1150. package/website/guide/playback.md +405 -0
  1151. package/website/guide/queue.md +334 -0
  1152. package/website/guide/remote-controls.md +314 -0
  1153. package/website/guide/search.md +270 -0
  1154. package/website/guide/sleep-timer.md +289 -0
  1155. package/website/guide/track.md +271 -0
  1156. package/ios/Bridge.h +0 -8
  1157. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1158. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1159. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1160. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1161. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1162. package/ios/CarPlay/RNABMediaIntentHandler.swift +0 -70
  1163. package/ios/Model/MediaURL.swift +0 -67
  1164. package/ios/Model/SourceType.swift +0 -6
  1165. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1166. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1167. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1168. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1169. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1170. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1171. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1172. package/ios/Option/PitchAlgorithms.swift +0 -17
  1173. package/ios/Option/TimeEventFrequency.swift +0 -18
  1174. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1175. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1176. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1177. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1178. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1179. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1180. package/ios/Player/PlaybackStateStore.swift +0 -27
  1181. package/ios/Player/PlayingStateManager.swift +0 -33
  1182. package/ios/Player/RetryManager.swift +0 -322
  1183. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1184. package/ios/Player/SleepTimerHandling.swift +0 -15
  1185. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1186. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1187. package/ios/Tests/MediaResolveTests.swift +0 -126
  1188. package/ios/Tests/OnceValueTests.swift +0 -79
  1189. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1190. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1191. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1192. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1193. package/ios/Tests/RetryManagerTests.swift +0 -89
  1194. package/ios/TrackPlayer.swift +0 -1014
  1195. package/ios/TrackPlayerCallbacks.swift +0 -86
  1196. package/ios/Util/MetadataAdapter.swift +0 -131
  1197. package/ios/Util/OnceValue.swift +0 -104
  1198. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1199. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1200. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1201. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1202. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1203. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1204. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1205. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1206. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1207. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1208. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1209. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1210. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1211. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,92 +2,32 @@ import Foundation
2
2
  import NitroModules
3
3
  import os.log
4
4
 
5
- /// Custom browser errors.
6
- enum BrowserError: Error {
7
- case contentNotFound(path: String)
8
- case httpError(code: Int, body: String)
9
- case networkError(Error)
10
- case invalidConfiguration(String)
11
- case callbackError(String)
12
-
13
- var localizedDescription: String {
14
- switch self {
15
- case .contentNotFound:
16
- return "Content not found"
17
- case let .httpError(code, body):
18
- // Try to extract error message from JSON response: { "error": "message" }
19
- if let data = body.data(using: .utf8),
20
- let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
21
- let errorMessage = json["error"] as? String
22
- {
23
- return errorMessage
24
- }
25
- // Fall back to localized HTTP status description
26
- return HTTPURLResponse.localizedString(forStatusCode: code)
27
- case let .networkError(error):
28
- return "Network error: \(error.localizedDescription)"
29
- case let .invalidConfiguration(message):
30
- return "Invalid configuration: \(message)"
31
- case let .callbackError(message):
32
- return message
33
- }
34
- }
35
- }
36
-
37
- /// Core browser manager that handles navigation, search, and media browsing.
38
- ///
39
- /// This class contains the main business logic for:
40
- /// - Route resolution and path matching with parameter extraction
41
- /// - HTTP API requests and response processing
42
- /// - JavaScript callback invocation
43
- /// - Fallback handling and error management
44
5
  @MainActor
45
6
  final class BrowserManager {
46
- // Allow creation from nonisolated contexts (e.g. HybridAudioBrowser property default)
47
- nonisolated init() {}
7
+ // Nonisolated so HybridAudioBrowser can create it as a property default.
8
+ nonisolated init() {
9
+ pages = PageResolver(requests: requests)
10
+ }
48
11
 
49
12
  let logger = Logger(subsystem: "com.audiobrowser", category: "BrowserManager")
50
13
 
51
- // MARK: - Constants (match Kotlin companion object)
52
-
53
- /// Internal path used for the default/root browse source
54
- static let defaultRoutePath = "__default__"
55
-
56
- /// Internal path used for navigation tabs
57
- static let tabsRoutePath = "__tabs__"
58
-
59
- /// Internal path used for search
60
- static let searchRoutePath = "__search__"
61
-
62
14
  // MARK: - Private Properties
63
15
 
64
- private let router = SimpleRouter()
65
- private let httpClient = HttpClient()
66
-
67
- // LRU cache for individual tracks - keyed by both url and src for O(1) lookup
68
- private let trackCache = LRUCache<String, Track>(maxSize: 3000)
16
+ let requests = RequestPipeline()
17
+ private let pages: PageResolver
69
18
 
70
- // LRU cache for resolved content - keyed by path
19
+ // Entries are unhydrated; `resolve` hydrates favorites on the way out.
71
20
  private let contentCache = LRUCache<String, ResolvedTrack>(maxSize: 20)
21
+ // Moves on `invalidateAll`, so a fetch that outlives one caches nothing.
22
+ private var contentGeneration = 0
72
23
 
73
- // Cache for search results
74
- private var lastSearchQuery: String?
24
+ // Raw results, never hydrated ones: `FavoriteSet.hydrate` skips a track whose `favorited` is
25
+ // already set, so a hydrated slot would keep the favorites of the first search.
26
+ private var lastSearchKey: String?
75
27
  private var lastSearchResults: [Track]?
76
28
 
77
- // Resolver caching: request/browse thunks resolve once per content generation.
78
- private var layerGeneration = 0
79
- private var resolvedLayerGeneration = -1
80
- var resolvedRequestLayer: TransformableRequestConfig?
81
- private var resolvedBrowseLayer: TransformableRequestConfig?
82
-
83
- // Set of favorited track identifiers (src)
84
- private var favoriteIds: Set<String> = []
29
+ private var favorites = FavoriteSet()
85
30
 
86
- // Favorite match mode, propagated from the player's `favorite` capability.
87
- // nil = favoriting disabled (no row hearts). Set via setFavoriteMatch.
88
- private var favoriteMatch: FavoritesMatchMode?
89
-
90
- // Navigation tracking to prevent race conditions
91
31
  private var currentNavigationId: Int = 0
92
32
 
93
33
  // MARK: - Public State
@@ -95,726 +35,249 @@ final class BrowserManager {
95
35
  private(set) var path: String = "/" {
96
36
  didSet {
97
37
  if oldValue != path {
98
- onPathChanged?(path)
38
+ pathChanged.emit(path)
99
39
  }
100
40
  }
101
41
  }
102
42
 
103
43
  private(set) var content: ResolvedTrack? {
104
44
  didSet {
105
- // Note: Can't compare ResolvedTrack directly, always fire callback
106
- onContentChanged?(content)
45
+ // ResolvedTrack is not comparable, so every set emits.
46
+ contentChanged.emit(content)
107
47
  }
108
48
  }
109
49
 
110
50
  private(set) var tabs: [Track]? {
111
51
  didSet {
112
- // Emit only on a real change: invalidateAllContent() re-queries the tabs
113
- // source on every invalidation (a callback source can re-resolve, e.g.
114
- // titles in a new locale), and an unchanged result must not churn the
115
- // CarPlay tab bar or reset its selection.
52
+ // An unchanged result must not churn the CarPlay tab bar or reset its selection;
53
+ // `invalidateAll` re-queries the tabs every time.
116
54
  if let tabs, !TabBarEntries.same(oldValue, tabs) {
117
- onTabsChanged?(tabs)
55
+ tabsChanged.emit(tabs)
118
56
  }
119
57
  }
120
58
  }
121
59
 
122
60
  // MARK: - Configuration
123
61
 
124
- /// Whether configureBrowser() has been called
125
62
  private(set) var isConfigured = false
126
63
 
127
- /// Browser configuration containing routes, search, tabs, and request settings.
128
- var config: BrowserConfig = .init() {
129
- didSet {
64
+ var config: BrowserConfig {
65
+ get { requests.config }
66
+ set {
130
67
  isConfigured = true
131
- // New config means the cached resolver results are stale.
132
- layerGeneration += 1
133
- onConfigChanged?(config)
68
+ requests.config = newValue
69
+ configChanged.emit(newValue)
134
70
  }
135
71
  }
136
72
 
137
- // MARK: - Callbacks
73
+ // MARK: - Events (emitted on the main actor)
138
74
 
139
- var onPathChanged: ((String) -> Void)?
140
- var onContentChanged: ((ResolvedTrack?) -> Void)?
141
- var onTabsChanged: (([Track]) -> Void)?
142
- var onConfigChanged: ((BrowserConfig) -> Void)?
143
- /// Fired when the favorite id set changes (e.g. an app/webview-originated
144
- /// favorite). Lets surfaces like the CarPlay now-playing heart re-render —
145
- /// they otherwise only learn of their own toggles via favorite/active-track
146
- /// events, never an external change routed through `setFavorites`.
147
- var onFavoritesChanged: (() -> Void)?
75
+ let pathChanged = Emitter<String>()
76
+ let contentChanged = Emitter<ResolvedTrack?>()
77
+ let tabsChanged = Emitter<[Track]>()
78
+ let configChanged = Emitter<BrowserConfig>()
79
+ /// Emitted on any change to the favorites, however it came about.
80
+ let favoritesChanged = Emitter<Void>()
148
81
 
149
- /// Forwards to config.awaitTrackLoadHandler so callers don't need to
150
- /// cross the MainActor boundary to access `config`.
82
+ /// Runs the app's `handleTrackLoad` and awaits both promise layers (a JS callback returning
83
+ /// `Promise<void>` arrives as `Promise<Promise<Void>>`); a failure is logged, not thrown. False
84
+ /// when the app set no handler.
151
85
  func awaitTrackLoadHandler(event: TrackLoadEvent) async -> Bool {
152
- // awaitTrackLoadHandler manages its own MainActor dispatch internally
153
- nonisolated(unsafe) let cfg = config
154
- nonisolated(unsafe) let evt = event
155
- return await cfg.awaitTrackLoadHandler(event: evt)
86
+ guard let handler = config.handleTrackLoad else { return false }
87
+ do {
88
+ try await handler(event).await().await()
89
+ } catch {
90
+ logger.error("handleTrackLoad failed: \(error.localizedDescription)")
91
+ }
92
+ return true
156
93
  }
157
94
 
158
95
  // MARK: - Favorites
159
96
 
160
- /// Sets the favorited track identifiers.
161
97
  func setFavorites(_ favorites: [String]) {
162
- let newIds = Set(favorites)
163
- guard newIds != favoriteIds else { return }
164
- favoriteIds = newIds
165
- onFavoritesChanged?()
166
- }
167
-
168
- /// Sets the favorite match mode (propagated from the `favorite` capability).
169
- /// nil disables row-heart hydration.
170
- func setFavoriteMatch(_ match: FavoritesMatchMode?) {
171
- favoriteMatch = match
172
- }
173
-
174
- /// Optimistically reflects a local favorite toggle for `src` in the match set,
175
- /// needing no consumer-specific id extraction: favoriting inserts `src` (which
176
- /// matches itself under either mode). Removal mirrors `isFavorite`'s match
177
- /// semantics — partial drops every id that is a path segment of `src` (the
178
- /// channel uid, and self-heals stray ids); exact (or disabled) drops only
179
- /// `src`, so unrelated exact favorites that happen to be a segment of `src`
180
- /// aren't collaterally lost. The consumer reconciles `favoriteIds` to its
181
- /// canonical ids on the next `setFavorites`; `isFavorite(src:)` gives the same
182
- /// answer before and after, so the now-playing heart stays responsive.
183
- func setFavorited(src: String, favorited: Bool) {
184
- if favorited {
185
- favoriteIds.insert(src)
186
- } else if favoriteMatch == .partial {
187
- favoriteIds = favoriteIds.filter { !BrowserPathHelper.containsSegment(src, $0) }
188
- } else {
189
- favoriteIds.remove(src)
190
- }
191
- }
192
-
193
- /// Hydrates the favorited field on a track based on the favoriteIds set.
194
- /// No-op unless favoriting is enabled (the `favorite` capability). Only
195
- /// playable (src-bearing) tracks are favoritable; the flag is set to true OR
196
- /// false so non-favorited tracks still show an (empty) heart. Local
197
- /// favoriteIds take precedence over API-provided values.
198
- func hydrateFavorite(_ track: Track) -> Track {
199
- guard let match = favoriteMatch, let src = track.src else { return track }
200
-
201
- let isFavorited = isFavorite(src: src, match: match)
202
-
203
- // Only create a new track if the favorited state differs
204
- if track.favorited == isFavorited { return track }
205
-
206
- return track.copying(favorited: isFavorited)
207
- }
208
-
209
- /// Whether `src` is favorited under the given match mode.
210
- private func isFavorite(src: String, match: FavoritesMatchMode) -> Bool {
211
- switch match {
212
- case .exact:
213
- favoriteIds.contains(src)
214
- case .partial:
215
- favoriteIds.contains { BrowserPathHelper.containsSegment(src, $0) }
98
+ if self.favorites.replace(with: favorites) {
99
+ favoritesChanged.emit(())
216
100
  }
217
101
  }
218
102
 
219
- /// Hydrates favorites on all children of a ResolvedTrack.
220
- private func hydrateChildren(_ resolvedTrack: ResolvedTrack) -> ResolvedTrack {
221
- guard let children = resolvedTrack.children else { return resolvedTrack }
222
- let hydratedChildren = children.map { hydrateFavorite($0) }
223
- return resolvedTrack.copying(children: hydratedChildren)
103
+ func setFavoriteEnabled(_ enabled: Bool) {
104
+ favorites.enabled = enabled
224
105
  }
225
106
 
226
- // MARK: - Track Cache
227
-
228
- /// Cache a track by both url and src for O(1) lookup from either key.
229
- private func cacheTrack(_ track: Track) {
230
- if let url = track.url {
231
- trackCache.set(url, value: track)
232
- }
233
- if let src = track.src {
234
- trackCache.set(src, value: track)
235
- }
107
+ func setFavorited(identity: String, favorited: Bool) {
108
+ favorites.set(identity, favorited: favorited)
236
109
  }
237
110
 
238
- private func cacheChildren(_ resolvedTrack: ResolvedTrack) {
239
- resolvedTrack.children?.forEach { cacheTrack($0) }
111
+ func hydrateFavorite(_ track: Track) -> Track {
112
+ favorites.hydrate(track)
240
113
  }
241
114
 
242
115
  // MARK: - Navigation
243
116
 
244
- /// Main navigation method - updates path and resolves content.
245
- ///
246
- /// Uses a navigation ID to prevent race conditions when multiple navigations
247
- /// overlap. Only the most recent navigation's result is applied.
248
- func navigate(_ path: String) async throws {
249
- // Increment navigation ID and capture for this navigation
117
+ /// Loads `path` as the current page. `bypassCache` refetches it and keeps the current content
118
+ /// on screen meanwhile. A newer load supersedes this one: its result or error is dropped, so a
119
+ /// slow failing /a cannot show its error over a fast /b's content.
120
+ func load(_ path: String, bypassCache: Bool = false) async throws {
250
121
  currentNavigationId += 1
251
122
  let navigationId = currentNavigationId
252
-
253
123
  self.path = path
254
- content = nil // Clear for loading state
255
-
256
- let resolved = try await resolve(path)
257
-
258
- // Only apply result if this is still the current navigation
259
- guard navigationId == currentNavigationId else { return }
260
-
261
- content = resolved
124
+ if bypassCache {
125
+ // So a failed reload doesn't leave the stale page in the cache.
126
+ contentCache.remove(path)
127
+ } else {
128
+ content = nil
129
+ }
130
+ do {
131
+ let resolved = try await resolve(path, useCache: !bypassCache)
132
+ guard navigationId == currentNavigationId else { return }
133
+ content = resolved
134
+ } catch {
135
+ guard navigationId == currentNavigationId else { return }
136
+ throw error
137
+ }
262
138
  }
263
139
 
264
- /// Resolves content for a path with optional caching.
140
+ /// Contextual paths resolve their parent page. Favorites are hydrated on every call.
265
141
  func resolve(_ path: String, useCache: Bool = true) async throws -> ResolvedTrack {
266
- // Strip __trackId from contextual URLs
267
142
  let normalizedPath = BrowserPathHelper.stripTrackId(path)
268
143
 
269
- // Check content cache first
270
144
  if useCache, let cached = contentCache.get(normalizedPath) {
271
- return hydrateChildren(cached)
145
+ return favorites.hydrate(cached)
272
146
  }
273
147
 
274
- let resolvedTrack = try await resolveUncached(normalizedPath)
275
-
276
- // Cache the resolved content for future navigation
277
- contentCache.set(normalizedPath, value: resolvedTrack)
278
-
279
- // Cache children for track lookups
280
- cacheChildren(resolvedTrack)
281
-
282
- return hydrateChildren(resolvedTrack)
283
- }
284
-
285
- /// Invalidates the content cache for a specific path.
286
- func invalidateContentCache(_ path: String) {
287
- contentCache.remove(path)
288
- }
289
-
290
- /// Clears the entire content cache (e.g. on a locale change).
291
- /// Runs from `invalidateAllContent`, so re-resolve the layer thunks too.
292
- func clearContentCache() {
293
- contentCache.clear()
294
- layerGeneration += 1
295
- }
296
-
297
- /// Refreshes the current path by invalidating cache and re-resolving.
298
- ///
299
- /// Uses navigation ID tracking to prevent race conditions.
300
- func refresh() async throws {
301
- // Increment navigation ID and capture for this refresh
302
- currentNavigationId += 1
303
- let navigationId = currentNavigationId
304
-
305
- let currentPath = path
306
- contentCache.remove(currentPath)
307
- let resolved = try await resolve(currentPath, useCache: false)
148
+ let generation = contentGeneration
149
+ let resolvedTrack = try await pages.resolve(normalizedPath)
308
150
 
309
- // Only apply result if this is still the current navigation
310
- guard navigationId == currentNavigationId else { return }
151
+ if generation == contentGeneration { contentCache.set(normalizedPath, value: resolvedTrack) }
311
152
 
312
- content = resolved
153
+ return favorites.hydrate(resolvedTrack)
313
154
  }
314
155
 
315
- private func resolveUncached(_ path: String) async throws -> ResolvedTrack {
316
- // Match an explicit route (or the '*' default). With no match, fall back to
317
- // the implicit default: fetch the path via the request + browse config.
318
- let routeEntry = (config.routes).flatMap { findBestRouteMatch(path: path, routes: $0) }
319
-
320
- let resolvedTrack: ResolvedTrack = if let (entry, routeMatch) = routeEntry {
321
- try await resolveRouteEntry(entry, path: path, params: routeMatch.params)
322
- } else {
323
- // Implicit default — no route config, just request → browse → fetch path.
324
- try await resolveFromConfig(
325
- nil, path: path, params: ["path": path],
326
- )
327
- }
328
-
329
- // Validate and transform children
330
- if let children = resolvedTrack.children {
331
- let transformed = try await transformChildren(
332
- children, parentPath: path, routeEntry: routeEntry?.0,
156
+ /// Throws on a contextual path, which never names a cache entry (Android requires the same).
157
+ func invalidateContentCache(_ path: String) throws {
158
+ guard !BrowserPathHelper.isContextual(path) else {
159
+ throw BrowserError.invalidConfiguration(
160
+ "invalidateContentCache() expects a container path, not a contextual path: \(path)",
333
161
  )
334
- return resolvedTrack.copying(children: transformed)
335
- }
336
-
337
- return resolvedTrack
338
- }
339
-
340
- // MARK: - Route Resolution
341
-
342
- private func findBestRouteMatch(
343
- path: String,
344
- routes: [NativeRouteEntry],
345
- ) -> (NativeRouteEntry, RouteMatch)? {
346
- // Filter out special routes
347
- let browseRoutes = routes.filter {
348
- $0.path != Self.tabsRoutePath &&
349
- $0.path != Self.searchRoutePath &&
350
- $0.path != Self.defaultRoutePath
351
162
  }
352
-
353
- // Try to find a matching route
354
- if let match = router.findBestMatch(path: path, routes: browseRoutes) {
355
- return match
356
- }
357
-
358
- // Fall back to __default__ if present
359
- if let defaultRoute = routes.first(where: { $0.path == Self.defaultRoutePath }) {
360
- return (defaultRoute, RouteMatch(params: ["path": path]))
361
- }
362
-
363
- return nil
163
+ contentCache.remove(path)
364
164
  }
365
165
 
366
- private func resolveRouteEntry(
367
- _ entry: NativeRouteEntry,
368
- path: String,
369
- params: [String: String],
370
- ) async throws -> ResolvedTrack {
371
- // Priority: callback > config > static
372
- if let callback = entry.browseCallback {
373
- let callbackParam = BrowserSourceCallbackParam(path: path, routeParams: params)
374
- // BrowserSourceCallback may return a BrowseResult synchronously or via a
375
- // Promise. Nitro flattens (ResolvedTrack | BrowseError) | Promise<BrowseResult>
376
- // into a 3-arm variant: sync track, sync error, or a Promise resolving to a
377
- // BrowseResult (which is itself a ResolvedTrack | BrowseError variant).
378
- switch try await callback(callbackParam).await() {
379
- case let .first(resolvedTrack):
380
- return resolvedTrack
381
- case let .second(browseError):
382
- throw BrowserError.callbackError(browseError.error)
383
- case let .third(promise):
384
- switch try await promise.await() {
385
- case let .first(resolvedTrack):
386
- return resolvedTrack
387
- case let .second(browseError):
388
- throw BrowserError.callbackError(browseError.error)
389
- }
166
+ /// Clears every cache and the resolved request layers, then re-queries the tabs and reloads
167
+ /// the current path, independently: a failed reload goes to `reloadFailed` with its path, and
168
+ /// a failed tabs query keeps the current tabs.
169
+ func invalidateAll(reloadFailed: @escaping @MainActor (Error, String) async -> Void) {
170
+ contentCache.clear()
171
+ contentGeneration &+= 1
172
+ requests.invalidateLayers()
173
+ lastSearchKey = nil
174
+ lastSearchResults = nil
175
+ Task { _ = try? await queryTabs() }
176
+ Task {
177
+ do {
178
+ try await load(path, bypassCache: true)
179
+ } catch {
180
+ await reloadFailed(error, path)
390
181
  }
391
182
  }
392
-
393
- if let browseConfig = entry.browseConfig {
394
- return try await resolveFromConfig(
395
- browseConfig, path: path, params: params,
396
- )
397
- }
398
-
399
- if let staticContent = entry.browseStatic {
400
- return staticContent
401
- }
402
-
403
- throw BrowserError.contentNotFound(path: path)
404
- }
405
-
406
- /// Builds the HTTP request for an API-backed route by layering
407
- /// request → kind → route configs. `initialQuery` seeds request-level query
408
- /// params (e.g. search q/mode/…) onto the base before the route layer, so they
409
- /// survive into `request.query` even when a layer's transform "wins
410
- /// completely" (it is handed only the base, so the route config's own static
411
- /// query would otherwise be dropped). `routeConfig` is nil for the implicit
412
- /// browse default; `kindConfig` is nil for kinds with no per-kind config.
413
- private func buildApiRequest(
414
- kind kindConfig: TransformableRequestConfig?,
415
- _ routeConfig: TransformableRequestConfig?,
416
- path: String,
417
- params: [String: String],
418
- initialQuery: [String: String]? = nil,
419
- ) async throws -> HttpClient.HttpRequest {
420
- try await ensureLayersResolved()
421
-
422
- var merged = RequestConfig(
423
- method: nil, path: path, baseUrl: nil, headers: nil,
424
- query: nil, body: nil, contentType: nil, userAgent: nil,
425
- )
426
- merged = try await applyLayer(resolvedRequestLayer, to: merged, params: params)
427
- if let initialQuery, !initialQuery.isEmpty {
428
- merged = merged.copying(query: mergeDicts(merged.query, initialQuery))
429
- }
430
- merged = try await applyLayer(kindConfig, to: merged, params: params)
431
- merged = try await applyLayer(routeConfig, to: merged, params: params)
432
-
433
- guard let baseUrl = merged.baseUrl else {
434
- throw BrowserError.invalidConfiguration("No URL configured for route")
435
- }
436
- var url = BrowserPathHelper.buildUrl(baseUrl: baseUrl, path: merged.path ?? path)
437
- if let query = merged.query, !query.isEmpty {
438
- url = BrowserPathHelper.appendQuery(query, to: url)
439
- }
440
-
441
- return HttpClient.HttpRequest(
442
- url: url,
443
- method: merged.method?.stringValue ?? "GET",
444
- headers: merged.headers,
445
- body: merged.body,
446
- contentType: merged.contentType ?? HttpClient.defaultContentType,
447
- userAgent: merged.userAgent ?? HttpClient.defaultUserAgent,
448
- )
449
- }
450
-
451
- /// Resolves a browse route: a page object (`{title,url,children:[…]}`).
452
- /// The browse kind layer is the cached resolved layer (`resolvedBrowseLayer`),
453
- /// populated by `ensureLayersResolved()` inside `buildApiRequest`.
454
- private func resolveFromConfig(
455
- _ routeConfig: TransformableRequestConfig?,
456
- path: String,
457
- params: [String: String],
458
- ) async throws -> ResolvedTrack {
459
- try await ensureLayersResolved()
460
- let request = try await buildApiRequest(
461
- kind: resolvedBrowseLayer, routeConfig, path: path, params: params,
462
- )
463
-
464
- logger.debug("Resolving content from API")
465
- logger.debug(" path: \(path)")
466
- logger.debug(" url: \(request.url)")
467
-
468
- let result: JsonResolvedTrack = try await httpClient.requestJson(request, as: JsonResolvedTrack.self)
469
- let nitroResult = result.toNitro()
470
-
471
- logger.debug("Resolved: \(nitroResult.title)")
472
- if let children = nitroResult.children {
473
- logger.debug(" children: \(children.count) tracks")
474
- }
475
-
476
- return nitroResult
477
183
  }
478
184
 
479
- /// Applies one request-config layer (request / browse / route) onto a base.
480
- /// A transform (async and/or sync) wins completely: it receives the base and its
481
- /// result replaces it. When both are set they run as a pipeline — async first,
482
- /// then sync. Otherwise the layer's static fields merge over the base. `path` is
483
- /// carried from the base (only a transform may change it).
484
- func applyLayer(
485
- _ layer: TransformableRequestConfig?,
486
- to base: RequestConfig,
487
- params: [String: String],
488
- ) async throws -> RequestConfig {
489
- guard let layer else { return base }
490
- // Run-both transform: async first, then sync (each replaces the running config).
491
- // The bridge await depth — the bug-prone part — is centralised in awaitAsync/SyncConfig.
492
- if layer.transform != nil || layer.transformSync != nil {
493
- var result = base
494
- if let transform = layer.transform { result = try await awaitAsyncConfig(transform(result, params)) }
495
- if let transformSync = layer.transformSync { result = try await awaitSyncConfig(transformSync(result, params)) }
496
- return result
497
- }
498
- return RequestConfig(
499
- method: layer.method ?? base.method,
500
- path: base.path,
501
- baseUrl: layer.baseUrl ?? base.baseUrl,
502
- headers: mergeDicts(base.headers, layer.headers),
503
- query: mergeDicts(base.query, layer.query),
504
- body: layer.body ?? base.body,
505
- contentType: layer.contentType ?? base.contentType,
506
- userAgent: layer.userAgent ?? base.userAgent,
185
+ /// The app's `formatNavigationError` result, or the default when it has none or it fails.
186
+ func formatted(_ error: NavigationError, path: String) async -> FormattedNavigationError {
187
+ let fallback = error.defaultFormatted()
188
+ guard let formatter = config.formatNavigationError else { return fallback }
189
+ let params = FormatNavigationErrorParams(
190
+ error: error, defaultFormatted: fallback, path: path, kind: NavigationErrorKind(path: path),
507
191
  )
508
- }
509
-
510
- /// Merges two optional dictionaries, with override values taking precedence.
511
- /// Delegates to the pure, unit-tested `MediaResolveComposer.mergeDicts`.
512
- func mergeDicts(
513
- _ base: [String: String]?,
514
- _ override: [String: String]?,
515
- ) -> [String: String]? {
516
- MediaResolveComposer.mergeDicts(base, override)
517
- }
518
-
519
- // MARK: - Layer Resolvers
520
-
521
- /// Resolve one layer: invoke its resolver if present, else return the static
522
- /// layer config unchanged. The resolver is Promise-only (the TS layer wraps a
523
- /// sync-or-async thunk in Promise.resolve), so its result is the JS promise
524
- /// behind the bridge promise — a double await.
525
- private func resolveLayer(
526
- config staticConfig: TransformableRequestConfig?,
527
- resolver: (() -> Promise<Promise<TransformableRequestConfig>>)?,
528
- ) async throws -> TransformableRequestConfig? {
529
- guard let resolver else { return staticConfig }
530
- return try await resolver().await().await()
531
- }
532
-
533
- /// Ensure request/browse resolvers are resolved for the current generation,
534
- /// caching the results. Re-resolves after a generation bump (config change /
535
- /// invalidateAllContent). Idempotent within a generation.
536
- func ensureLayersResolved() async throws {
537
- guard resolvedLayerGeneration != layerGeneration else { return }
538
- let generation = layerGeneration
539
- let req = try await resolveLayer(config: config.request, resolver: config.requestResolver)
540
- let brw = try await resolveLayer(config: config.browse, resolver: config.browseResolver)
541
- // Only commit if still current (a newer generation may have started during await).
542
- guard generation == layerGeneration else { return }
543
- resolvedRequestLayer = req
544
- resolvedBrowseLayer = brw
545
- resolvedLayerGeneration = generation
546
- }
547
-
548
- // MARK: - Child Transformation
549
-
550
- private func transformChildren(
551
- _ children: [Track],
552
- parentPath: String,
553
- routeEntry: NativeRouteEntry?,
554
- ) async throws -> [Track] {
555
- var transformed: [Track] = []
556
-
557
- for track in children {
558
- // Validate track has stable identifier. A track carrying an imageRow is
559
- // exempt: a url-less row is a pure preview — never selected, navigated
560
- // to, or cached (its items carry their own identity).
561
- if track.url == nil, track.src == nil, track.imageRow?.isEmpty != false {
562
- throw BrowserError.invalidConfiguration(
563
- "Track must have either 'url' or 'src' for stable identification: \(track.title)",
564
- )
565
- }
566
-
567
- var transformedTrack = track
568
-
569
- if track.src != nil, track.url == nil {
570
- let contextualUrl = BrowserPathHelper.build(parentPath: parentPath, trackId: track.src!)
571
- transformedTrack = track.copying(url: contextualUrl)
572
- }
573
-
574
- // Resolve artwork URL at browse-time (no size context)
575
- let artworkConfig = routeEntry?.artwork ?? config.artwork
576
- if let imageSource = await resolveArtworkUrl(track: transformedTrack, perRouteConfig: artworkConfig) {
577
- transformedTrack = transformedTrack.copying(artworkSource: imageSource)
578
- }
579
-
580
- // Resolve artwork for image row items
581
- if let imageRowItems = transformedTrack.imageRow {
582
- var resolvedItems: [ImageRowItem] = []
583
- for item in imageRowItems {
584
- let itemImageSource = await resolveArtworkUrl(track: item.toTrack(), perRouteConfig: artworkConfig)
585
- // Playable items get a contextual URL like any list row, so a
586
- // thumbnail tap expands into its section's queue instead of a
587
- // queue of one (ADR 0006).
588
- let itemUrl = item.url ?? item.src.map {
589
- BrowserPathHelper.build(parentPath: parentPath, trackId: $0)
590
- }
591
- resolvedItems.append(ImageRowItem(
592
- id: item.id,
593
- url: itemUrl,
594
- src: item.src,
595
- artwork: item.artwork,
596
- artworkSource: itemImageSource,
597
- title: item.title,
598
- artist: item.artist,
599
- album: item.album,
600
- albumUrl: item.albumUrl,
601
- live: item.live,
602
- request: item.request,
603
- ))
604
- }
605
- transformedTrack = transformedTrack.copying(imageRow: resolvedItems)
606
- }
607
-
608
- transformed.append(transformedTrack)
609
- }
610
-
611
- return transformed
192
+ return await (try? formatter(params).await()) ?? fallback
612
193
  }
613
194
 
614
195
  // MARK: - Search
615
196
 
616
- /// Execute a search query.
617
- /// Plain free-text search — wraps the structured overload with no mode/filters.
618
197
  func search(_ query: String) async throws -> ResolvedTrack {
619
198
  try await search(
620
199
  SearchParams(mode: nil, query: query, genre: nil, artist: nil, album: nil, title: nil, playlist: nil, reference: .unknown),
621
200
  )
622
201
  }
623
202
 
624
- /// Structured search. Emits `q` plus any of `mode`/`genre`/`artist`/`album`/
625
- /// `title`/`playlist` that are set, mirroring Android's `executeSearchApiRequest`
626
- /// and the web stub. Cached by `query`.
203
+ /// Cached by `cacheKey`, not `query`: voice intents fill `query` from a genre or artist when
204
+ /// nothing was spoken, so "play jazz" and a text search for "jazz" share a `query`.
627
205
  func search(_ params: SearchParams) async throws -> ResolvedTrack {
628
206
  let query = params.query
207
+ let cacheKey = params.cacheKey
629
208
 
630
- // Check cache - re-hydrate favorites since they may have changed
631
- if query == lastSearchQuery, let results = lastSearchResults {
632
- let hydratedResults = results.map { hydrateFavorite($0) }
633
- return makeSearchResult(query: query, results: hydratedResults)
209
+ if cacheKey == lastSearchKey, let results = lastSearchResults {
210
+ return makeSearchResult(query: query, results: results)
634
211
  }
635
212
 
636
- guard let routes = config.routes else {
637
- throw BrowserError.contentNotFound(path: Self.searchRoutePath)
638
- }
639
-
640
- guard let searchEntry = routes.first(where: { $0.path == Self.searchRoutePath }) else {
641
- throw BrowserError.contentNotFound(path: Self.searchRoutePath)
642
- }
213
+ let generation = contentGeneration
214
+ let results = try await pages.search(params)
643
215
 
644
- var results: [Track]
645
-
646
- if let callback = searchEntry.searchCallback {
647
- let outerPromise = callback(params)
648
- let innerPromise = try await outerPromise.await()
649
- results = try await innerPromise.await()
650
- } else if let searchConfig = searchEntry.searchConfig {
651
- // Search is its own kind — request → search route (no browse layer). The
652
- // endpoint returns a bare Track array (unlike browse's page object). The
653
- // search params go through `initialQuery` so they land in `request.query`
654
- // (and the URL); a config with a transform only ever sees the base.
655
- // Seed the search config's static path onto the base — a layer's static
656
- // path never applies (carried from the base; only a transform may change
657
- // it). Matches the web stub's fetchSearchResults and Android.
658
- var queryParams: [String: String] = ["q": query]
659
- if let mode = params.mode { queryParams["mode"] = mode.stringValue }
660
- if params.reference == .my { queryParams["reference"] = "my" }
661
- if let genre = params.genre { queryParams["genre"] = genre }
662
- if let artist = params.artist { queryParams["artist"] = artist }
663
- if let album = params.album { queryParams["album"] = album }
664
- if let title = params.title { queryParams["title"] = title }
665
- if let playlist = params.playlist { queryParams["playlist"] = playlist }
666
-
667
- let request = try await buildApiRequest(
668
- kind: nil, searchConfig, path: searchConfig.path ?? "", params: ["q": query],
669
- initialQuery: queryParams,
670
- )
671
- logger.debug("Searching via API: \(request.url)")
672
- let jsonTracks: [JsonTrack] = try await httpClient.requestJson(request, as: [JsonTrack].self)
673
- results = jsonTracks.map { $0.toNitro() }
674
- } else {
675
- throw BrowserError.contentNotFound(path: Self.searchRoutePath)
216
+ if generation == contentGeneration {
217
+ lastSearchKey = cacheKey
218
+ lastSearchResults = results
676
219
  }
677
220
 
678
- // Hydrate favorites in results
679
- let hydratedResults = results.map { hydrateFavorite($0) }
680
-
681
- // Cache results
682
- lastSearchQuery = query
683
- lastSearchResults = hydratedResults
684
-
685
- // Cache individual tracks
686
- hydratedResults.forEach { cacheTrack($0) }
687
-
688
- return makeSearchResult(query: query, results: hydratedResults)
221
+ return makeSearchResult(query: query, results: results)
689
222
  }
690
223
 
691
- /// Search and return playable tracks for "play «X»" voice intents, drilling
692
- /// into a browsable-only first result (place/genre page) so we play its first
693
- /// station. Decision in `SearchDrillIn.playable`; mirrors Android's
694
- /// `searchPlayable`.
224
+ /// Playable tracks for a "play X" voice intent, drilling into a browsable-only first result
225
+ /// (`SearchDrillIn.playable`). Mirrors Android's `searchPlayable`.
695
226
  func searchPlayable(_ params: SearchParams) async throws -> [Track]? {
696
- let children = try await (search(params).children) ?? []
697
- return try await SearchDrillIn.playable(from: children) { [self] url in
698
- logger.debug("First search result is browsable-only, resolving: \(url)")
699
- return try await (resolve(url).children) ?? []
227
+ // Disabled tracks go before drill-in, so an unavailable first result can't take the play.
228
+ let children = try await ((search(params).flattenedChildren) ?? [])
229
+ .filter { $0.disabled != true }
230
+ return try await SearchDrillIn.playable(from: children) { [self] path in
231
+ logger.debug("First search result is browsable-only, resolving: \(path)")
232
+ return try await ((resolve(path).flattenedChildren) ?? []).filter { $0.disabled != true }
700
233
  }
701
234
  }
702
235
 
703
236
  private func makeSearchResult(query: String, results: [Track]) -> ResolvedTrack {
237
+ // Search results become one untitled section (ADR 0010).
704
238
  ResolvedTrack(
705
- url: BrowserPathHelper.createSearchPath(query),
706
- children: results,
239
+ path: BrowserPathHelper.createSearchPath(query),
240
+ style: nil,
241
+ sections: [.untitled(results.map { favorites.hydrate($0) })],
242
+ children: nil,
707
243
  carPlaySiriListButton: nil,
708
244
  id: nil,
709
245
  src: nil,
710
246
  artwork: nil,
711
247
  artworkSource: nil, request: nil,
712
- artworkCarPlayTinted: nil,
713
248
  title: "Search: \(query)",
714
249
  subtitle: nil,
715
250
  artist: nil,
716
- albumUrl: nil,
251
+ albumPath: nil,
717
252
  album: nil,
718
253
  description: nil,
719
254
  genre: nil,
720
255
  duration: nil,
721
- style: nil,
722
- childrenStyle: nil,
256
+ disabled: nil,
723
257
  favorited: nil,
724
- groupTitle: nil,
725
258
  live: nil,
726
- imageRow: nil,
259
+ icyCharset: nil,
727
260
  )
728
261
  }
729
262
 
730
263
  // MARK: - Tabs
731
264
 
732
- /// Query navigation tabs.
733
265
  func queryTabs() async throws -> [Track] {
734
- guard let routes = config.routes else {
735
- return []
736
- }
737
-
738
- guard let tabsEntry = routes.first(where: { $0.path == Self.tabsRoutePath }) else {
739
- return []
740
- }
741
-
742
- let resolved = try await resolveRouteEntry(tabsEntry, path: Self.tabsRoutePath, params: [:])
743
- let tabTracks = resolved.children ?? []
744
-
745
- tabs = tabTracks
746
- return tabTracks
266
+ let generation = contentGeneration
267
+ guard let tabs = try await pages.tabs() else { return [] }
268
+ if generation == contentGeneration { self.tabs = tabs }
269
+ return tabs
747
270
  }
748
271
 
749
272
  // MARK: - Queue Expansion (for CarPlay/external controllers)
750
273
 
751
- /// Expands a contextual URL to a full queue of playable tracks.
752
- func expandQueueFromContextualUrl(_ url: String) async throws -> (tracks: [Track], selectedIndex: Int)? {
753
- guard BrowserPathHelper.isContextual(url) else { return nil }
754
-
755
- let parentPath = BrowserPathHelper.stripTrackId(url)
756
- guard let trackId = BrowserPathHelper.extractTrackId(url) else { return nil }
757
-
758
- logger.debug("Expanding queue from contextual URL")
759
- logger.debug(" url: \(url)")
760
- logger.debug(" parentPath: \(parentPath)")
761
- logger.debug(" trackId: \(trackId)")
762
-
763
- // Resolve the parent container
764
- let resolved = try await resolve(parentPath, useCache: true)
765
- guard let children = resolved.children else { return nil }
766
-
767
- // Queue scope is the tapped section, not the whole page (ADR 0006). An
768
- // id that no longer appears on the page aborts the expansion — the
769
- // caller falls back to the stored single track (matching Android);
770
- // silently queueing the changed list would resume the wrong station.
771
- let sectionTracks: [Track]
772
- switch SectionScope.section(of: children, containing: trackId) {
773
- case .imageRow(let items):
774
- sectionTracks = items.map { $0.toTrack() }
775
- case .run(let tracks):
776
- sectionTracks = tracks
777
- case nil:
778
- return nil
779
- }
780
-
781
- // Filter to playable tracks (have src)
782
- let playableTracks = sectionTracks.filter { $0.src != nil }
783
- guard !playableTracks.isEmpty else { return nil }
784
-
785
- logger.debug("Found \(playableTracks.count) playable tracks")
786
- for (index, track) in playableTracks.enumerated() {
787
- logger.debug(" [\(index)] \(track.title) - src: \(track.src ?? "nil")")
788
- }
789
-
790
- // Find selected track index
791
- // Unreachable in practice (the section was found BY this id), but a miss
792
- // must abort rather than silently start the queue at the wrong track.
793
- guard let selectedIndex = playableTracks.firstIndex(where: { $0.src == trackId }) else {
794
- return nil
795
- }
796
- logger.debug("Selected track index: \(selectedIndex)")
797
-
798
- // If singleTrack mode, return just the selected track
799
- if config.singleTrack {
800
- return (tracks: [playableTracks[selectedIndex]], selectedIndex: 0)
801
- }
802
-
803
- return (tracks: playableTracks, selectedIndex: selectedIndex)
804
- }
805
-
806
- // MARK: - Accessors
807
-
808
- func getPath() -> String {
809
- path
810
- }
811
-
812
- func getContent() -> ResolvedTrack? {
813
- content
814
- }
815
-
816
- func getTabs() -> [Track]? {
817
- tabs
274
+ /// The queue a tap on the contextual `path` plays (`SectionScope.queue`); nil when `path` is
275
+ /// not contextual.
276
+ func expandQueueFromContextualPath(_ path: String) async throws -> (tracks: [Track], selectedIndex: Int)? {
277
+ guard BrowserPathHelper.extractTrackId(path) != nil else { return nil }
278
+ let resolved = try await resolve(BrowserPathHelper.stripTrackId(path), useCache: true)
279
+ guard let sections = resolved.normalizedSections else { return nil }
280
+ return SectionScope.queue(in: sections, path: path, singleTrack: config.singleTrack)
818
281
  }
819
282
  }
820
283