react-native-audio-browser 0.2.0-next.9 → 0.2.0-next.91

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 (1275) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +582 -456
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +101 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +15 -17
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +12 -19
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +92 -49
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +113 -50
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +75 -65
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +600 -345
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +119 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +686 -600
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +18 -28
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +171 -178
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +65 -210
  63. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  64. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  66. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  67. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  68. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  69. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  71. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  72. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  94. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  95. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  97. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  98. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  99. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  103. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  105. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  106. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  107. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  108. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  110. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  111. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  112. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  113. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  114. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  115. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  116. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  117. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  118. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  119. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  120. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  121. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  122. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  123. package/android/src/main/res/values/strings.xml +25 -5
  124. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  125. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  126. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +32 -0
  127. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  128. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  129. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  130. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  132. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  134. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  135. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +24 -4
  136. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  138. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  139. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  140. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  141. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  142. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  147. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  148. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  149. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  150. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  151. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  152. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  153. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  154. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  155. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  156. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  157. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  158. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  159. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  160. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  161. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  162. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  163. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  164. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  165. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  166. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  167. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  168. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +316 -0
  169. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  170. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  171. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  172. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  173. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  175. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  178. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  182. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +607 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +354 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  191. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  192. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  193. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +93 -200
  194. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  198. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  199. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  200. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  202. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  203. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  204. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  205. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  206. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  207. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  208. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  209. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  210. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  211. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  212. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  213. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  214. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  223. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  224. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  225. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  226. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  227. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  228. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  229. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  230. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  231. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  232. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  233. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  234. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  235. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  236. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  237. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  238. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  239. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  240. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  241. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  242. package/android/src/test/resources/sonos/device_description.xml +78 -0
  243. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  244. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  245. package/ios/AVPlayerEngine.swift +363 -0
  246. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  247. package/ios/Browser/BrowseGate.swift +70 -0
  248. package/ios/Browser/BrowserConfig.swift +123 -104
  249. package/ios/Browser/BrowserError.swift +15 -0
  250. package/ios/Browser/BrowserManager.swift +153 -675
  251. package/ios/Browser/BrowserPathHelper.swift +54 -117
  252. package/ios/Browser/FavoriteSet.swift +43 -0
  253. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  254. package/ios/Browser/JsonModels.swift +244 -335
  255. package/ios/Browser/NavigationErrorState.swift +42 -0
  256. package/ios/Browser/PageResolver.swift +132 -0
  257. package/ios/Browser/RequestLayer.swift +185 -0
  258. package/ios/Browser/RequestPipeline.swift +295 -0
  259. package/ios/Browser/SearchDrillIn.swift +10 -16
  260. package/ios/Browser/SectionScope.swift +73 -26
  261. package/ios/Browser/SimpleRouter.swift +76 -154
  262. package/ios/Browser/StyleResolver.swift +41 -0
  263. package/ios/Browser/TabBarEntries.swift +8 -7
  264. package/ios/Browser/TrackIdTemplate.swift +29 -0
  265. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  266. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  267. package/ios/CarPlay/CarPlayController.swift +37 -1297
  268. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  269. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  270. package/ios/CarPlay/CarPlayNowPlayingManager.swift +147 -218
  271. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  272. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  273. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  274. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  275. package/ios/CarPlay/CarPlaySession.swift +203 -0
  276. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  277. package/ios/CarPlay/IntentHandlers.swift +94 -0
  278. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  279. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +15 -17
  280. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  281. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  282. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  283. package/ios/CarPlay/SectionPresentation.swift +67 -0
  284. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  285. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  286. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  287. package/ios/Extension/CxxVectorConformances.swift +4 -16
  288. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  289. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  290. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  291. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  292. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  293. package/ios/Extension/SearchParams+Query.swift +28 -0
  294. package/ios/Extension/Section+Copying.swift +26 -0
  295. package/ios/Extension/String+IcyCharset.swift +21 -0
  296. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  297. package/ios/Extension/Track+AVPlayer.swift +1 -18
  298. package/ios/Extension/Track+Copying.swift +13 -21
  299. package/ios/Extension/Track+Identity.swift +20 -0
  300. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  301. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  302. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  303. package/ios/Extension/URLError+Connectivity.swift +15 -0
  304. package/ios/Extension/Variant+Artwork.swift +8 -22
  305. package/ios/Http/HttpClient.swift +73 -167
  306. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  307. package/ios/HybridAudioBrowser+Options.swift +116 -0
  308. package/ios/HybridAudioBrowser+Player.swift +347 -0
  309. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  310. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  311. package/ios/HybridAudioBrowser.swift +147 -1718
  312. package/ios/Model/NitroTypeStubs.swift +266 -32
  313. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  314. package/ios/Model/RemoteCommand.swift +6 -78
  315. package/ios/Model/TrackPlayerError.swift +12 -21
  316. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  317. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  318. package/ios/Observer/ItemObserver.swift +92 -0
  319. package/ios/Observer/PlayerObserver.swift +59 -0
  320. package/ios/Option/SessionCategories.swift +41 -92
  321. package/ios/PlaybackEvent.swift +4 -2
  322. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  323. package/ios/Player/AudioSessionController.swift +190 -0
  324. package/ios/Player/DeferredSeek.swift +73 -0
  325. package/ios/Player/ErrorStatus.swift +56 -0
  326. package/ios/Player/MediaLoader.swift +73 -98
  327. package/ios/Player/NowPlayingLines.swift +49 -0
  328. package/ios/Player/NowPlayingUpdater.swift +180 -105
  329. package/ios/Player/PersistedPlaybackState.swift +1 -2
  330. package/ios/Player/PlaybackFailure.swift +121 -0
  331. package/ios/Player/PlaybackPersistence.swift +72 -0
  332. package/ios/Player/PlaybackStateMachine.swift +15 -14
  333. package/ios/Player/PlaybackTimer.swift +11 -8
  334. package/ios/Player/Player.swift +1030 -0
  335. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  336. package/ios/Player/PlayerEngine.swift +109 -0
  337. package/ios/Player/PlayerStatusTypes.swift +1 -6
  338. package/ios/Player/QueueManager.swift +80 -98
  339. package/ios/Player/ReconnectPacer.swift +83 -0
  340. package/ios/Player/RetryLoop.swift +374 -0
  341. package/ios/Player/ShuffleOrder.swift +36 -43
  342. package/ios/Player/SilenceBudget.swift +78 -0
  343. package/ios/Player/SleepTimerManager.swift +25 -42
  344. package/ios/Player/VolumeFader.swift +20 -15
  345. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  346. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  347. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  348. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  349. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  350. package/ios/Tests/BrowseGateTests.swift +50 -0
  351. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  352. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  353. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  354. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  355. package/ios/Tests/ConnectivityTests.swift +13 -0
  356. package/ios/Tests/DeferredSeekTests.swift +76 -0
  357. package/ios/Tests/EmitterTests.swift +22 -39
  358. package/ios/Tests/ErrorStatusTests.swift +50 -0
  359. package/ios/Tests/FavoriteSetTests.swift +61 -0
  360. package/ios/Tests/GenerationMemoTests.swift +178 -0
  361. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  362. package/ios/Tests/JsonModelsTests.swift +189 -3
  363. package/ios/Tests/LRUCacheTests.swift +106 -0
  364. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  365. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  366. package/ios/Tests/MediaLoaderTests.swift +38 -78
  367. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  368. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  369. package/ios/Tests/ObserverTests.swift +88 -0
  370. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  371. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  372. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  373. package/ios/Tests/PlaybackStateMachineTests.swift +7 -22
  374. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  375. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  376. package/ios/Tests/PlayerPolicyTests.swift +1386 -0
  377. package/ios/Tests/PlayerTests.swift +1677 -0
  378. package/ios/Tests/PlayingStateTests.swift +41 -0
  379. package/ios/Tests/QueueManagerTests.swift +205 -174
  380. package/ios/Tests/ReadyValueTests.swift +73 -0
  381. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  382. package/ios/Tests/RequestLayerTests.swift +228 -0
  383. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  384. package/ios/Tests/RetryCaseTests.swift +146 -0
  385. package/ios/Tests/RetryLoopTests.swift +486 -0
  386. package/ios/Tests/SearchDrillInTests.swift +16 -17
  387. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  388. package/ios/Tests/SectionPresentationTests.swift +85 -0
  389. package/ios/Tests/SectionScopeTests.swift +136 -54
  390. package/ios/Tests/SimpleRouterTests.swift +39 -8
  391. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  392. package/ios/Tests/StyleResolverTests.swift +123 -0
  393. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  394. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  395. package/ios/Tests/Support/TestTypes.swift +236 -93
  396. package/ios/Tests/Support/TimeLimit.swift +43 -0
  397. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  398. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  399. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  400. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  401. package/ios/Tests/TrackIdentityTests.swift +20 -0
  402. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  403. package/ios/Tests/TrackSelectorTests.swift +157 -34
  404. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  405. package/ios/TrackSelector.swift +67 -77
  406. package/ios/Util/ArtworkFreshness.swift +42 -0
  407. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  408. package/ios/Util/AwaitCallback.swift +80 -0
  409. package/ios/Util/ConcurrentMap.swift +19 -0
  410. package/ios/Util/Connectivity.swift +12 -0
  411. package/ios/Util/Deadline.swift +38 -0
  412. package/ios/Util/Emitter.swift +45 -22
  413. package/ios/Util/GenerationMemo.swift +43 -0
  414. package/ios/Util/LRUCache.swift +23 -159
  415. package/ios/Util/NetworkMonitor.swift +31 -33
  416. package/ios/Util/OutputPicker.swift +48 -0
  417. package/ios/Util/ReadyValue.swift +57 -0
  418. package/ios/Util/SFSymbolRenderer.swift +64 -49
  419. package/ios/Util/SVGProcessor.swift +9 -16
  420. package/ios/Util/SupersedingTask.swift +45 -0
  421. package/lib/commonjs/AudioBrowser.js +11 -0
  422. package/lib/commonjs/AudioBrowser.js.map +1 -1
  423. package/lib/commonjs/CLAUDE.md +57 -0
  424. package/lib/commonjs/features/battery.js +16 -12
  425. package/lib/commonjs/features/battery.js.map +1 -1
  426. package/lib/commonjs/features/browser-config.js +13 -9
  427. package/lib/commonjs/features/browser-config.js.map +1 -1
  428. package/lib/commonjs/features/browser.js +78 -20
  429. package/lib/commonjs/features/browser.js.map +1 -1
  430. package/lib/commonjs/features/carConnection.js +3 -4
  431. package/lib/commonjs/features/carConnection.js.map +1 -1
  432. package/lib/commonjs/features/equalizer.js +9 -5
  433. package/lib/commonjs/features/equalizer.js.map +1 -1
  434. package/lib/commonjs/features/errors.js +35 -21
  435. package/lib/commonjs/features/errors.js.map +1 -1
  436. package/lib/commonjs/features/favorites.js +28 -23
  437. package/lib/commonjs/features/favorites.js.map +1 -1
  438. package/lib/commonjs/features/gate.js +27 -6
  439. package/lib/commonjs/features/gate.js.map +1 -1
  440. package/lib/commonjs/features/metadata.js +61 -11
  441. package/lib/commonjs/features/metadata.js.map +1 -1
  442. package/lib/commonjs/features/network.js +5 -1
  443. package/lib/commonjs/features/network.js.map +1 -1
  444. package/lib/commonjs/features/nowPlaying.js +28 -14
  445. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  446. package/lib/commonjs/features/output.js +9 -4
  447. package/lib/commonjs/features/output.js.map +1 -1
  448. package/lib/commonjs/features/playback/controls.js +13 -6
  449. package/lib/commonjs/features/playback/controls.js.map +1 -1
  450. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  451. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  452. package/lib/commonjs/features/playback/playing.js +5 -3
  453. package/lib/commonjs/features/playback/playing.js.map +1 -1
  454. package/lib/commonjs/features/playback/progress.js +13 -6
  455. package/lib/commonjs/features/playback/progress.js.map +1 -1
  456. package/lib/commonjs/features/playback/rate.js +8 -1
  457. package/lib/commonjs/features/playback/rate.js.map +1 -1
  458. package/lib/commonjs/features/playback/state.js +5 -6
  459. package/lib/commonjs/features/playback/state.js.map +1 -1
  460. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  461. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  462. package/lib/commonjs/features/playback/volume.js +6 -5
  463. package/lib/commonjs/features/playback/volume.js.map +1 -1
  464. package/lib/commonjs/features/player/options.js +20 -10
  465. package/lib/commonjs/features/player/options.js.map +1 -1
  466. package/lib/commonjs/features/player/setup.js +44 -43
  467. package/lib/commonjs/features/player/setup.js.map +1 -1
  468. package/lib/commonjs/features/player/validateOptions.js +3 -4
  469. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  470. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  471. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  472. package/lib/commonjs/features/queue/queue.js +56 -21
  473. package/lib/commonjs/features/queue/queue.js.map +1 -1
  474. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  475. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  476. package/lib/commonjs/features/queue/shuffle.js +0 -1
  477. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  478. package/lib/commonjs/features/remoteControls.js +59 -35
  479. package/lib/commonjs/features/remoteControls.js.map +1 -1
  480. package/lib/commonjs/features/sleepTimer.js +23 -6
  481. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  482. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  483. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  484. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  485. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  486. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  487. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  488. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  489. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  490. package/lib/commonjs/utils/useDebug.js +16 -3
  491. package/lib/commonjs/utils/useDebug.js.map +1 -1
  492. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  493. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  494. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  495. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  496. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  497. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  498. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  499. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  500. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  501. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  502. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  503. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  504. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  505. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  506. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  507. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  508. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  509. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  510. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  511. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  512. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  513. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  514. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  515. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  516. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  517. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  518. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  519. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  520. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  521. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  522. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  523. package/lib/commonjs/web/browser/sections.js +89 -0
  524. package/lib/commonjs/web/browser/sections.js.map +1 -0
  525. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  526. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  527. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  528. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  529. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  530. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  531. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  532. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  533. package/lib/module/AudioBrowser.js +2 -4
  534. package/lib/module/AudioBrowser.js.map +1 -1
  535. package/lib/module/CLAUDE.md +57 -0
  536. package/lib/module/features/battery.js +16 -12
  537. package/lib/module/features/battery.js.map +1 -1
  538. package/lib/module/features/browser-config.js +13 -9
  539. package/lib/module/features/browser-config.js.map +1 -1
  540. package/lib/module/features/browser.js +78 -20
  541. package/lib/module/features/browser.js.map +1 -1
  542. package/lib/module/features/carConnection.js +3 -4
  543. package/lib/module/features/carConnection.js.map +1 -1
  544. package/lib/module/features/equalizer.js +9 -5
  545. package/lib/module/features/equalizer.js.map +1 -1
  546. package/lib/module/features/errors.js +35 -21
  547. package/lib/module/features/errors.js.map +1 -1
  548. package/lib/module/features/favorites.js +28 -23
  549. package/lib/module/features/favorites.js.map +1 -1
  550. package/lib/module/features/gate.js +27 -6
  551. package/lib/module/features/gate.js.map +1 -1
  552. package/lib/module/features/metadata.js +59 -11
  553. package/lib/module/features/metadata.js.map +1 -1
  554. package/lib/module/features/network.js +5 -1
  555. package/lib/module/features/network.js.map +1 -1
  556. package/lib/module/features/nowPlaying.js +28 -14
  557. package/lib/module/features/nowPlaying.js.map +1 -1
  558. package/lib/module/features/output.js +9 -4
  559. package/lib/module/features/output.js.map +1 -1
  560. package/lib/module/features/playback/controls.js +13 -6
  561. package/lib/module/features/playback/controls.js.map +1 -1
  562. package/lib/module/features/playback/playWhenReady.js +6 -5
  563. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  564. package/lib/module/features/playback/playing.js +5 -3
  565. package/lib/module/features/playback/playing.js.map +1 -1
  566. package/lib/module/features/playback/progress.js +13 -6
  567. package/lib/module/features/playback/progress.js.map +1 -1
  568. package/lib/module/features/playback/rate.js +8 -1
  569. package/lib/module/features/playback/rate.js.map +1 -1
  570. package/lib/module/features/playback/state.js +5 -6
  571. package/lib/module/features/playback/state.js.map +1 -1
  572. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  573. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  574. package/lib/module/features/playback/volume.js +6 -5
  575. package/lib/module/features/playback/volume.js.map +1 -1
  576. package/lib/module/features/player/options.js +20 -10
  577. package/lib/module/features/player/options.js.map +1 -1
  578. package/lib/module/features/player/setup.js +44 -43
  579. package/lib/module/features/player/setup.js.map +1 -1
  580. package/lib/module/features/player/validateOptions.js +3 -4
  581. package/lib/module/features/player/validateOptions.js.map +1 -1
  582. package/lib/module/features/queue/activeTrack.js +14 -4
  583. package/lib/module/features/queue/activeTrack.js.map +1 -1
  584. package/lib/module/features/queue/queue.js +56 -21
  585. package/lib/module/features/queue/queue.js.map +1 -1
  586. package/lib/module/features/queue/repeatMode.js +2 -1
  587. package/lib/module/features/queue/repeatMode.js.map +1 -1
  588. package/lib/module/features/queue/shuffle.js +0 -1
  589. package/lib/module/features/queue/shuffle.js.map +1 -1
  590. package/lib/module/features/remoteControls.js +59 -35
  591. package/lib/module/features/remoteControls.js.map +1 -1
  592. package/lib/module/features/sleepTimer.js +24 -7
  593. package/lib/module/features/sleepTimer.js.map +1 -1
  594. package/lib/module/test-utils/reactNativeStub.js +58 -0
  595. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  596. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  597. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  598. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  599. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  600. package/lib/module/utils/getTrackIdentity.js +22 -0
  601. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  602. package/lib/module/utils/useDebug.js +16 -3
  603. package/lib/module/utils/useDebug.js.map +1 -1
  604. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  605. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  606. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  607. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  608. package/lib/module/web/NativeAudioBrowser.js +207 -84
  609. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  610. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  611. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  612. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  613. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  614. package/lib/module/web/TrackPlayer/Player.js +256 -40
  615. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  616. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  617. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  618. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  619. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  620. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  621. package/lib/module/web/browser/BrowserManager.js +175 -100
  622. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  623. package/lib/module/web/browser/FavoriteManager.js +31 -21
  624. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  625. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  626. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  627. package/lib/module/web/browser/SearchManager.js +18 -23
  628. package/lib/module/web/browser/SearchManager.js.map +1 -1
  629. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  630. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  631. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  632. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  633. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  634. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  635. package/lib/module/web/browser/sections.js +83 -0
  636. package/lib/module/web/browser/sections.js.map +1 -0
  637. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  638. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  639. package/lib/module/web/http/followMediaRedirect.js +215 -0
  640. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  641. package/lib/module/web/player/NowPlayingManager.js +4 -3
  642. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  643. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  644. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  645. package/lib/typescript/package.json +1 -0
  646. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  647. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  648. package/lib/typescript/src/features/battery.d.ts +17 -12
  649. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  650. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  651. package/lib/typescript/src/features/browser.d.ts +67 -19
  652. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  653. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  654. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  655. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  656. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  657. package/lib/typescript/src/features/errors.d.ts +37 -22
  658. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  659. package/lib/typescript/src/features/favorites.d.ts +28 -23
  660. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  661. package/lib/typescript/src/features/gate.d.ts +29 -8
  662. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  663. package/lib/typescript/src/features/metadata.d.ts +65 -14
  664. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  665. package/lib/typescript/src/features/network.d.ts +5 -1
  666. package/lib/typescript/src/features/network.d.ts.map +1 -1
  667. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  668. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  669. package/lib/typescript/src/features/output.d.ts +9 -4
  670. package/lib/typescript/src/features/output.d.ts.map +1 -1
  671. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  672. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  673. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  674. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  675. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  676. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  677. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  678. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  679. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  680. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  681. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  682. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  683. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  684. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  685. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  686. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  687. package/lib/typescript/src/features/player/options.d.ts +73 -56
  688. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  689. package/lib/typescript/src/features/player/setup.d.ts +129 -73
  690. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  691. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  692. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  693. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  694. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  695. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  696. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  697. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  698. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  699. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  700. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  701. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  702. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  703. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  704. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  705. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  706. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  707. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  708. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  709. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  710. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  711. package/lib/typescript/src/types/browser.d.ts +248 -173
  712. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  713. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  714. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  715. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  716. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  717. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  718. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  719. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  720. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  721. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  722. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  723. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  724. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  725. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  726. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  727. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  728. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  729. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  735. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  736. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  742. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  745. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  747. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  749. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  750. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  751. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  752. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  755. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  757. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  758. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  759. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  761. 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
  762. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  763. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  765. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  766. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  767. 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
  768. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  777. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  780. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  798. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  801. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  802. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  807. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  809. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  810. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  815. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  818. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  821. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  824. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  826. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  827. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  828. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  829. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  832. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  835. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  838. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  840. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  842. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  845. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  846. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  850. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  853. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  854. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  857. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  863. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  864. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  865. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  866. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  867. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  868. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  869. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  870. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  871. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  875. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  877. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +25 -15
  878. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  881. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  883. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  884. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  885. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  886. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  887. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  907. 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
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  914. 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
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  917. 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
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  920. 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
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1026. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1027. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1028. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1029. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1030. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1031. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1032. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1034. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1035. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1036. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1037. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1038. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1039. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1040. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1041. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1042. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1043. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1044. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1045. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1046. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1047. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1048. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1049. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1050. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1051. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1052. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1053. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1054. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1055. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1056. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1057. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1058. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1059. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1060. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1061. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1062. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1063. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1064. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1065. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1066. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1067. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1068. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1069. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1070. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1071. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1072. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1073. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1074. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1075. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1076. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1077. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1078. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1079. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1080. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1081. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1082. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1083. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1084. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1085. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1086. package/package.json +27 -13
  1087. package/src/AudioBrowser.ts +2 -4
  1088. package/src/CLAUDE.md +57 -0
  1089. package/src/docs-floors.test.ts +71 -0
  1090. package/src/features/battery.test.ts +79 -0
  1091. package/src/features/battery.ts +17 -13
  1092. package/src/features/browser-config.test.ts +21 -6
  1093. package/src/features/browser-config.ts +13 -9
  1094. package/src/features/browser.test.ts +1 -1
  1095. package/src/features/browser.ts +69 -20
  1096. package/src/features/carConnection.ts +3 -4
  1097. package/src/features/equalizer.ts +9 -5
  1098. package/src/features/errors.ts +37 -22
  1099. package/src/features/favorites.ts +28 -23
  1100. package/src/features/gate.ts +29 -8
  1101. package/src/features/hook-wiring.test.ts +302 -0
  1102. package/src/features/metadata.ts +80 -14
  1103. package/src/features/network.ts +5 -1
  1104. package/src/features/nowPlaying.ts +28 -14
  1105. package/src/features/output.ts +9 -4
  1106. package/src/features/playback/controls.ts +13 -6
  1107. package/src/features/playback/playWhenReady.ts +6 -5
  1108. package/src/features/playback/playing.ts +16 -3
  1109. package/src/features/playback/progress.test.ts +169 -0
  1110. package/src/features/playback/progress.ts +13 -6
  1111. package/src/features/playback/rate.ts +8 -1
  1112. package/src/features/playback/state.ts +10 -6
  1113. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1114. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1115. package/src/features/playback/volume.ts +6 -5
  1116. package/src/features/player/options.ts +81 -62
  1117. package/src/features/player/setup.test.ts +12 -3
  1118. package/src/features/player/setup.ts +141 -76
  1119. package/src/features/player/validateOptions.ts +3 -4
  1120. package/src/features/queue/activeTrack.ts +14 -4
  1121. package/src/features/queue/queue.ts +56 -21
  1122. package/src/features/queue/repeatMode.ts +1 -1
  1123. package/src/features/queue/shuffle.ts +0 -1
  1124. package/src/features/remoteControls.ts +59 -35
  1125. package/src/features/sleepTimer.test.ts +171 -0
  1126. package/src/features/sleepTimer.ts +24 -8
  1127. package/src/nitro-stub-drift.test.ts +277 -0
  1128. package/src/public-surface.test.ts +48 -24
  1129. package/src/specs/audio-browser.nitro.ts +15 -8
  1130. package/src/style-resolution.test.ts +210 -0
  1131. package/src/test-utils/reactNativeStub.ts +60 -0
  1132. package/src/types/browser-native.ts +7 -3
  1133. package/src/types/browser-nodes.ts +417 -151
  1134. package/src/types/browser.ts +254 -177
  1135. package/src/utils/LazyNativeEmitter.ts +17 -10
  1136. package/src/utils/NativeUpdatedValue.ts +30 -16
  1137. package/src/utils/getTrackIdentity.ts +22 -0
  1138. package/src/utils/useDebug.test.ts +182 -0
  1139. package/src/utils/useDebug.ts +16 -3
  1140. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1141. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1142. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1143. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1144. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1145. package/src/web/NativeAudioBrowser.ts +247 -92
  1146. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1147. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1148. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1149. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1150. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1151. package/src/web/TrackPlayer/Player.ts +286 -38
  1152. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1153. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1154. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1155. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1156. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1157. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1158. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1159. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1160. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1161. package/src/web/__tests__/retry.test.ts +169 -0
  1162. package/src/web/browser/BrowserManager.ts +209 -111
  1163. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1164. package/src/web/browser/FavoriteManager.ts +28 -23
  1165. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1166. package/src/web/browser/SearchManager.test.ts +75 -0
  1167. package/src/web/browser/SearchManager.ts +25 -28
  1168. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1169. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1170. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1171. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1172. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1173. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1174. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1175. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1176. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1177. package/src/web/browser/parseSearchResponse.ts +3 -4
  1178. package/src/web/browser/sections.test.ts +91 -0
  1179. package/src/web/browser/sections.ts +72 -0
  1180. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1181. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1182. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1183. package/src/web/http/followMediaRedirect.ts +253 -0
  1184. package/src/web/player/NowPlayingManager.ts +4 -3
  1185. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1186. package/src/web/util/BrowserPathHelper.ts +68 -13
  1187. package/website/guide/android-auto.md +126 -0
  1188. package/website/guide/android-certificates.md +488 -0
  1189. package/website/guide/artwork.md +300 -0
  1190. package/website/guide/audio-output.md +382 -0
  1191. package/website/guide/automotive.md +91 -0
  1192. package/website/guide/basic-usage.md +154 -0
  1193. package/website/guide/battery.md +142 -0
  1194. package/website/guide/browser.md +674 -0
  1195. package/website/guide/carplay.md +733 -0
  1196. package/website/guide/configuration.md +215 -0
  1197. package/website/guide/equalizer.md +235 -0
  1198. package/website/guide/errors.md +359 -0
  1199. package/website/guide/favorites.md +164 -0
  1200. package/website/guide/gate.md +157 -0
  1201. package/website/guide/getting-started.md +99 -0
  1202. package/website/guide/hooks.md +247 -0
  1203. package/website/guide/live-streams.md +189 -0
  1204. package/website/guide/metadata.md +289 -0
  1205. package/website/guide/migrating-from-track-player.md +289 -0
  1206. package/website/guide/native-callback-fetch.md +137 -0
  1207. package/website/guide/network.md +103 -0
  1208. package/website/guide/now-playing.md +203 -0
  1209. package/website/guide/playback.md +405 -0
  1210. package/website/guide/queue.md +334 -0
  1211. package/website/guide/remote-controls.md +314 -0
  1212. package/website/guide/search.md +270 -0
  1213. package/website/guide/sleep-timer.md +289 -0
  1214. package/website/guide/track.md +271 -0
  1215. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +0 -50
  1216. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1217. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +0 -40
  1218. package/ios/Bridge.h +0 -8
  1219. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1220. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1221. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1222. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1223. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1224. package/ios/Model/MediaURL.swift +0 -67
  1225. package/ios/Model/SourceType.swift +0 -6
  1226. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1227. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1228. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1229. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1230. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1231. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1232. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1233. package/ios/Option/PitchAlgorithms.swift +0 -17
  1234. package/ios/Option/TimeEventFrequency.swift +0 -18
  1235. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1236. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1237. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1238. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1239. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1240. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1241. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1242. package/ios/Player/PlaybackStateStore.swift +0 -27
  1243. package/ios/Player/PlayingStateManager.swift +0 -33
  1244. package/ios/Player/RetryManager.swift +0 -323
  1245. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1246. package/ios/Player/SleepTimerHandling.swift +0 -15
  1247. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1248. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1249. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1250. package/ios/Tests/MediaResolveTests.swift +0 -126
  1251. package/ios/Tests/OnceValueTests.swift +0 -79
  1252. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1253. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1254. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1255. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1256. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1257. package/ios/Tests/RetryManagerTests.swift +0 -89
  1258. package/ios/TrackPlayer.swift +0 -1014
  1259. package/ios/TrackPlayerCallbacks.swift +0 -53
  1260. package/ios/Util/MetadataAdapter.swift +0 -131
  1261. package/ios/Util/OnceValue.swift +0 -104
  1262. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1263. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1264. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1265. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1266. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1267. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1268. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1269. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1270. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1271. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1272. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1273. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1274. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1275. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,40 +2,23 @@ import CarPlay
2
2
  import Foundation
3
3
  import os.log
4
4
 
5
- /// Manages the Now Playing template, buttons, Up Next, and related state for CarPlay.
6
- ///
7
- /// Responsibilities:
8
- /// - CPNowPlayingTemplate setup and button configuration
9
- /// - Button action handlers (shuffle, repeat, favorite, playback rate)
10
- /// - Button state updates (favorite appearance, Up Next enabled)
11
- /// - Up Next template creation and queue change handling
12
- /// - NowPlayingObserver for Up Next button taps
13
5
  @MainActor
14
6
  final class CarPlayNowPlayingManager {
15
7
  private let logger = Logger(subsystem: "com.audiobrowser", category: "CarPlayNowPlayingManager")
16
8
 
17
9
  private let interfaceController: CPInterfaceController
18
- var listItemFactory: (Track, ((CPSelectableListItem, @escaping () -> Void) -> Void)?) -> CPListItem
19
- /// Pushes a browse destination (wired to the controller's navigateToUrl).
20
- var navigateToUrl: ((_ url: String, _ title: String) -> Void)?
10
+ private let audioBrowser: HybridAudioBrowser
11
+ /// Read on each use: a re-setup replaces the bridge's player.
12
+ private var player: Player? { audioBrowser.player }
13
+ private let listItem: (Track, ((CPSelectableListItem, @escaping () -> Void) -> Void)?) -> CPListItem
14
+ private let navigate: (_ path: String, _ title: String) -> Void
21
15
 
22
- private weak var audioBrowser: HybridAudioBrowser?
16
+ private var subscriptions: [Subscription] = []
23
17
  private var nowPlayingObserver: NowPlayingObserver?
24
18
  private weak var upNextTemplate: CPListTemplate?
25
- /// Everything the built button row renders — button types, the heart's
26
- /// favorited state, and the shuffle/repeat `isSelected` state. Rebuilds are
27
- /// skipped while this is unchanged (`onConfigChanged` fires on unrelated
28
- /// churn, and every `updateNowPlayingButtons` call re-renders ALL buttons).
29
- ///
30
- /// shuffle/repeat selected state is part of the snapshot because CarPlay
31
- /// SERIALIZES the buttons (NSSecureCoding) to its UI process: whenever the
32
- /// now-playing screen re-renders (it does on every metadata change), the
33
- /// stateful buttons first draw from their serialized `isSelected`, and only
34
- /// then overlay the live state the app reports via the command center. A
35
- /// button built with the default `isSelected = false` while repeat/shuffle
36
- /// is on therefore flashes background-off → background-on at every
37
- /// re-render. Stamping `isSelected` at build time (and rebuilding when the
38
- /// mode changes) makes the first-frame render match the live state.
19
+ /// A rebuild is skipped while this is unchanged: every `updateNowPlayingButtons` re-renders
20
+ /// all buttons. Shuffle and repeat carry `isSelected` because CarPlay draws a re-render from
21
+ /// the serialized state first: a button built unselected while its mode is on flashes off.
39
22
  private struct BuiltButtonRow: Equatable {
40
23
  let types: [CarPlayNowPlayingButton]
41
24
  let favorited: Bool?
@@ -45,87 +28,93 @@ final class CarPlayNowPlayingManager {
45
28
 
46
29
  private var builtRow: BuiltButtonRow?
47
30
 
48
- /// Browse path the album line navigates to for the active track —
49
- /// `track.albumUrl`, or the pre-resolved `resolveAlbumUrl` result. Resolved
50
- /// at track-change time (not at tap) so the album line only surfaces when a
51
- /// destination actually exists.
31
+ /// Resolved on track change, not on tap, so the album line shows only when a destination exists.
52
32
  private var albumArtistDestination: String?
53
- /// Drops a stale async `resolveAlbumUrl` result when the track changed while
54
- /// the resolver was in flight (latest-update-wins).
55
- private var albumArtistGeneration: UInt = 0
56
- /// The just-tapped track whose load is still in flight. CarPlay reads
57
- /// `isAlbumArtistButtonEnabled` when the template is displayed (a change while
58
- /// visible doesn't re-render), and Now Playing is pushed at tap time — before
59
- /// the player's `currentTrack` reflects the tap — so the flag must be derived
60
- /// from the tapped track at push time. Cleared when the active track changes.
33
+ private let albumPathResolution = SupersedingTask<String, String>()
34
+ /// The tapped track while its load runs, which wins over `currentTrack`: CarPlay reads
35
+ /// `isAlbumArtistButtonEnabled` only when Now Playing is displayed, and that push comes first.
61
36
  private var pendingAlbumArtistTrack: Track?
62
37
 
63
- /// Convenience accessor for browser config
64
38
  private var config: BrowserConfig {
65
- audioBrowser?.browserManager.config ?? BrowserConfig()
39
+ audioBrowser.browserManager.config
66
40
  }
67
41
 
68
- /// The active track's favorited state, from the authoritative favorite set
69
- /// (see `HybridAudioBrowser.isActiveTrackFavorited`).
70
- private var isActiveTrackFavorited: Bool {
71
- audioBrowser?.isActiveTrackFavorited() ?? false
72
- }
73
-
74
- init(interfaceController: CPInterfaceController) {
42
+ init(
43
+ interfaceController: CPInterfaceController,
44
+ audioBrowser: HybridAudioBrowser,
45
+ listItem: @escaping (Track, ((CPSelectableListItem, @escaping () -> Void) -> Void)?) -> CPListItem,
46
+ navigate: @escaping (_ path: String, _ title: String) -> Void,
47
+ ) {
75
48
  self.interfaceController = interfaceController
76
- self.listItemFactory = { track, _ in CPListItem(text: track.title, detailText: nil) }
49
+ self.audioBrowser = audioBrowser
50
+ self.listItem = listItem
51
+ self.navigate = navigate
77
52
  }
78
53
 
79
54
  // MARK: - Lifecycle
80
55
 
81
- func setup(audioBrowser: HybridAudioBrowser) {
82
- self.audioBrowser = audioBrowser
83
- setupNowPlayingTemplate()
56
+ func start() {
57
+ let observer = NowPlayingObserver(manager: self)
58
+ nowPlayingObserver = observer
59
+ CPNowPlayingTemplate.shared.add(observer)
60
+
61
+ let browserManager = audioBrowser.browserManager
62
+ subscriptions = [
63
+ browserManager.configChanged.subscribeOnMain { [weak self] _ in
64
+ // A new config may bring a new `resolveAlbumPath`, so the current track is asked again.
65
+ self?.albumPathResolution.cancel()
66
+ self?.refresh()
67
+ },
68
+ audioBrowser.playerOptionsChangedEmitter.subscribeOnMain { [weak self] in self?.refresh() },
69
+ browserManager.favoritesChanged.subscribeOnMain { [weak self] in self?.refreshButtons() },
70
+ audioBrowser.favoriteChangedEmitter.subscribeOnMain { [weak self] _ in self?.refreshButtons() },
71
+ audioBrowser.repeatModeChangedEmitter.subscribeOnMain { [weak self] _ in self?.refreshButtons() },
72
+ audioBrowser.shuffleChangedEmitter.subscribeOnMain { [weak self] _ in self?.refreshButtons() },
73
+ audioBrowser.queueChangedEmitter.subscribeOnMain { [weak self] in self?.queueChanged($0) },
74
+ audioBrowser.showNowPlayingRequestedEmitter.subscribeOnMain { [weak self] in self?.showNowPlaying() },
75
+ audioBrowser.activeTrackChangedEmitter.subscribeOnMain { [weak self] _ in
76
+ // The player's current track is authoritative again.
77
+ self?.pendingAlbumArtistTrack = nil
78
+ self?.refresh()
79
+ },
80
+ ]
81
+ refresh()
84
82
  }
85
83
 
86
- func teardown() {
87
- if let observer = nowPlayingObserver {
88
- CPNowPlayingTemplate.shared.remove(observer)
89
- nowPlayingObserver = nil
90
- }
84
+ func end() {
85
+ if let nowPlayingObserver { CPNowPlayingTemplate.shared.remove(nowPlayingObserver) }
86
+ nowPlayingObserver = nil
87
+ subscriptions = []
91
88
  pendingAlbumArtistTrack = nil
92
- audioBrowser = nil
89
+ // A resolve in flight must not set the shared template for the next session.
90
+ albumPathResolution.cancel()
93
91
  }
94
92
 
95
- // MARK: - Now Playing Template
96
-
97
- private func setupNowPlayingTemplate() {
98
- let template = CPNowPlayingTemplate.shared
99
-
100
- let observer = NowPlayingObserver(manager: self)
101
- nowPlayingObserver = observer
102
- template.add(observer)
93
+ func refresh() {
94
+ updateUpNextButton()
95
+ refreshButtons()
96
+ updateAlbumArtistDestination()
97
+ }
103
98
 
104
- setupNowPlayingButtons()
105
- updateNowPlayingButtonStates()
99
+ /// Call before pushing Now Playing for a just-tapped track: enabling the album line after
100
+ /// the push renders no chevron.
101
+ func prepare(for track: Track) {
102
+ pendingAlbumArtistTrack = track
103
+ updateAlbumArtistDestination()
106
104
  }
107
105
 
108
- /// Sets up custom Now Playing buttons based on configuration and current
109
- /// player state, skipping the rebuild when nothing the row renders changed.
110
- func setupNowPlayingButtons() {
111
- // While a gate is active, custom buttons (favorite etc.) are hidden;
112
- // the system transport controls stay — a gate never blocks playback.
113
- let configured = (audioBrowser?.isGateActive ?? false) ? [] : (audioBrowser?.carPlayNowPlayingButtons ?? [])
114
- // The template caps custom buttons at 5 (CPNowPlayingTemplate.h) and says
115
- // nothing about overflow — unlike lists (trim) or the tab bar (throw). The
116
- // config comes straight from JS, where duplicates and excess are
117
- // representable, so dedupe (order preserved) and clamp here.
118
- var deduped: [CarPlayNowPlayingButton] = []
119
- for button in configured where !deduped.contains(button) {
120
- deduped.append(button)
121
- }
122
- let buttons = Array(deduped.prefix(5))
123
- let player = audioBrowser?.getPlayer()
106
+ // MARK: - Buttons
107
+
108
+ private func refreshButtons() {
109
+ // A gate hides the custom buttons; the transport controls stay, as a gate never blocks playback.
110
+ let buttons = NowPlayingButtonRules.buttons(
111
+ audioBrowser.browseGate.isActive ? [] : audioBrowser.playerOptions.carPlayNowPlayingButtons,
112
+ )
124
113
  let row = BuiltButtonRow(
125
114
  types: buttons,
126
- favorited: buttons.contains(.favorite) ? isActiveTrackFavorited : nil,
127
- shuffleSelected: buttons.contains(.shuffle) ? (player?.shuffleEnabled ?? false) : nil,
128
- repeatSelected: buttons.contains(.repeat) ? (player?.getRepeatMode() ?? .off) != .off : nil,
115
+ favorited: buttons.contains(.favorite) ? audioBrowser.isActiveTrackFavorited() : nil,
116
+ shuffleSelected: buttons.contains(.shuffle) ? player?.shuffleEnabled ?? false : nil,
117
+ repeatSelected: buttons.contains(.repeat) ? (player?.repeatMode ?? .off) != .off : nil,
129
118
  )
130
119
  guard row != builtRow else { return }
131
120
  builtRow = row
@@ -144,7 +133,7 @@ final class CarPlayNowPlayingManager {
144
133
  let shuffleButton = CPNowPlayingShuffleButton { [weak self] _ in
145
134
  self?.handleShuffleButtonTapped()
146
135
  }
147
- // Pre-stamp the serialized selected state — see BuiltButtonRow.
136
+ // Pre-stamped: see BuiltButtonRow.
148
137
  shuffleButton.isSelected = row.shuffleSelected ?? false
149
138
  nowPlayingButtons.append(shuffleButton)
150
139
 
@@ -152,7 +141,7 @@ final class CarPlayNowPlayingManager {
152
141
  let repeatButton = CPNowPlayingRepeatButton { [weak self] _ in
153
142
  self?.handleRepeatButtonTapped()
154
143
  }
155
- // Pre-stamp the serialized selected state — see BuiltButtonRow.
144
+ // Pre-stamped: see BuiltButtonRow.
156
145
  repeatButton.isSelected = row.repeatSelected ?? false
157
146
  nowPlayingButtons.append(repeatButton)
158
147
 
@@ -178,14 +167,11 @@ final class CarPlayNowPlayingManager {
178
167
 
179
168
  // MARK: - Show Now Playing
180
169
 
181
- /// `popToFront` controls what happens when Now Playing is already on the
182
- /// stack but buried under templates pushed on top of it (Up Next, the album
183
- /// line's browse destination): a user-initiated surface (tap, voice play)
184
- /// pops back to it, while the deferred post-resolve calls in
185
- /// `handleItemSelection` pass `false` — they run seconds after the tap, and
186
- /// popping then would yank away a screen the user navigated to meanwhile.
170
+ /// Pushes Now Playing, or pops back to it when it is buried under Up Next or a browse page,
171
+ /// unless `popToFront` is false: a call seconds after the tap must not yank away a screen the
172
+ /// user opened since.
187
173
  func showNowPlaying(popToFront: Bool = true) {
188
- updateNowPlayingButtonStates()
174
+ refresh()
189
175
  let nowPlayingTemplate = CPNowPlayingTemplate.shared
190
176
  if interfaceController.templates.contains(where: { $0 === nowPlayingTemplate }) {
191
177
  if popToFront {
@@ -196,74 +182,40 @@ final class CarPlayNowPlayingManager {
196
182
  }
197
183
  }
198
184
 
199
- // MARK: - Button State Updates
185
+ // MARK: - Album Line
200
186
 
201
- /// Refreshes the row for a favorite/shuffle/repeat state change — the
202
- /// snapshot diff in setupNowPlayingButtons makes this a no-op when nothing
203
- /// the row renders actually changed.
204
- func updateFavoriteButtonState() {
205
- setupNowPlayingButtons()
206
- }
207
-
208
- /// Updates Now Playing button states based on config and current queue
209
- func updateNowPlayingButtonStates() {
210
- updateNowPlayingUpNextButton()
211
- setupNowPlayingButtons()
212
- updateAlbumArtistButtonState()
213
- }
214
-
215
- /// Re-resolves the album line's destination for the active track and
216
- /// enables the (tappable) album/artist button only when one exists:
217
- /// `track.albumUrl`, or the app's `resolveAlbumUrl` result.
218
- /// Marks `track` as the just-tapped (still loading) track and derives the
219
- /// album line's destination from it. Must run before the Now Playing
220
- /// template is pushed — CarPlay reads `isAlbumArtistButtonEnabled` at display
221
- /// time, so enabling after the push (when the load lands) renders no chevron.
222
- func prepareAlbumArtistButton(for track: Track) {
223
- pendingAlbumArtistTrack = track
224
- updateAlbumArtistButtonState()
225
- }
226
-
227
- /// Clears the tap-time pending track (the player's `currentTrack` is now
228
- /// authoritative) and refreshes all button states.
229
- func handleActiveTrackChanged() {
230
- pendingAlbumArtistTrack = nil
231
- updateNowPlayingButtonStates()
232
- }
233
-
234
- func updateAlbumArtistButtonState() {
235
- albumArtistGeneration &+= 1
236
- let generation = albumArtistGeneration
237
-
238
- // The just-tapped track wins while its load is in flight: currentTrack
239
- // still points at the previous track (or nil) at push time.
240
- guard let track = pendingAlbumArtistTrack ?? audioBrowser?.getPlayer()?.currentTrack else {
187
+ private func updateAlbumArtistDestination() {
188
+ guard let track = pendingAlbumArtistTrack ?? player?.currentTrack else {
241
189
  logger.debug("AlbumArtist: no current track → disabled")
242
- setAlbumArtistDestination(nil)
190
+ settleAlbumArtistDestination(nil)
243
191
  return
244
192
  }
245
- logger.info("AlbumArtist: track=\(track.title) albumUrl=\(track.albumUrl ?? "nil") resolver=\(self.config.resolveAlbumUrl != nil)")
246
- if let albumUrl = track.albumUrl {
247
- setAlbumArtistDestination(albumUrl)
193
+ logger.info("AlbumArtist: track=\(track.title) albumPath=\(track.albumPath ?? "nil") resolver=\(self.config.resolveAlbumPath != nil)")
194
+ if let albumPath = track.albumPath {
195
+ settleAlbumArtistDestination(albumPath)
248
196
  return
249
197
  }
250
- guard let resolver = config.resolveAlbumUrl else {
251
- setAlbumArtistDestination(nil)
198
+ guard let resolver = config.resolveAlbumPath else {
199
+ settleAlbumArtistDestination(nil)
252
200
  return
253
201
  }
254
- Task { @MainActor [weak self] in
255
- let path: String?
256
- do {
257
- path = try await resolver(track).await()
258
- } catch {
259
- self?.logger.error("resolveAlbumUrl failed: \(error.localizedDescription)")
260
- path = nil
202
+ albumPathResolution.run(key: track.identity) {
203
+ try await resolver(track).awaitCancellable()
204
+ } deliver: { [weak self] result in
205
+ guard let self else { return }
206
+ if case let .failure(error) = result {
207
+ logger.error("resolveAlbumPath failed: \(error.localizedDescription)")
261
208
  }
262
- guard let self, self.albumArtistGeneration == generation else { return }
263
- self.setAlbumArtistDestination(path)
209
+ setAlbumArtistDestination(try? result.get())
264
210
  }
265
211
  }
266
212
 
213
+ /// Sets the destination without a resolve, ending any in flight so it cannot overwrite this.
214
+ private func settleAlbumArtistDestination(_ path: String?) {
215
+ albumPathResolution.cancel()
216
+ setAlbumArtistDestination(path)
217
+ }
218
+
267
219
  private func setAlbumArtistDestination(_ path: String?) {
268
220
  albumArtistDestination = path
269
221
  let template = CPNowPlayingTemplate.shared
@@ -276,77 +228,53 @@ final class CarPlayNowPlayingManager {
276
228
 
277
229
  // MARK: - Queue Changes
278
230
 
279
- /// Handles queue changes - updates Up Next list if visible
280
- func handleQueueChanged(_ tracks: [Track]) {
281
- updateNowPlayingUpNextButton()
282
-
283
- guard let template = upNextTemplate,
284
- let player = audioBrowser?.getPlayer()
285
- else {
286
- return
287
- }
288
-
289
- logger.debug("Queue changed, updating Up Next list with \(tracks.count) tracks")
290
- template.updateSections([createUpNextSection(tracks: tracks, player: player)])
231
+ private func queueChanged(_ tracks: [Track]) {
232
+ updateUpNextButton()
233
+ guard let upNextTemplate else { return }
234
+ upNextTemplate.updateSections([createUpNextSection(tracks: tracks)])
291
235
  }
292
236
 
293
237
  // MARK: - Private - Button Handlers
294
238
 
295
- /// Returns the appropriate image for the favorite button based on state
296
239
  private func favoriteButtonImage(isFavorited: Bool) -> UIImage {
297
240
  let symbolName = isFavorited ? "heart.fill" : "heart"
298
- guard let image = UIImage(systemName: symbolName)?.resized(to: CPNowPlayingButtonMaximumImageSize) else {
241
+ guard let image = UIImage(systemName: symbolName)?.fitted(
242
+ to: CPNowPlayingButtonMaximumImageSize,
243
+ scale: interfaceController.carTraitCollection.displayScale,
244
+ ) else {
299
245
  return UIImage()
300
246
  }
301
247
  return image
302
248
  }
303
249
 
304
250
  private func handleShuffleButtonTapped() {
305
- guard let player = audioBrowser?.getPlayer() else { return }
306
-
251
+ guard let player else { return }
307
252
  let newEnabled = !player.shuffleEnabled
308
253
  player.shuffleEnabled = newEnabled
309
254
  logger.info("CarPlay shuffle mode changed: \(newEnabled)")
310
255
  }
311
256
 
312
257
  private func handleRepeatButtonTapped() {
313
- guard let player = audioBrowser?.getPlayer() else { return }
314
-
315
- let currentMode = player.getRepeatMode()
316
- let newMode: RepeatMode = switch currentMode {
317
- case .off:
318
- .track
319
- case .track:
320
- .queue
321
- case .queue:
322
- .off
323
- }
324
-
325
- player.setRepeatMode(newMode)
258
+ guard let player else { return }
259
+ let currentMode = player.repeatMode
260
+ let newMode = NowPlayingButtonRules.repeatMode(after: currentMode)
261
+ player.repeatMode = newMode
326
262
  logger.info("CarPlay repeat mode changed: \(currentMode.stringValue) → \(newMode.stringValue)")
327
263
  }
328
264
 
329
265
  private func handleFavoriteButtonTapped() {
330
- try? audioBrowser?.toggleActiveTrackFavorited()
266
+ do {
267
+ try audioBrowser.toggleActiveTrackFavorited()
268
+ } catch {
269
+ logger.error("favorite toggle failed: \(error.localizedDescription)")
270
+ }
331
271
  logger.info("CarPlay favorite toggled")
332
272
  }
333
273
 
334
274
  private func handlePlaybackRateButtonTapped() {
335
- guard let audioBrowser, let player = audioBrowser.getPlayer() else { return }
336
-
337
- let rates = audioBrowser.playbackRates
338
- guard !rates.isEmpty else { return }
339
-
275
+ guard let player else { return }
340
276
  let currentRate = Double(player.rate)
341
- let nextRate: Double
342
-
343
- if let currentIndex = rates.firstIndex(where: { (currentRate - $0).magnitude < 0.01 }) {
344
- let nextIndex = (currentIndex + 1) % rates.count
345
- nextRate = rates[nextIndex]
346
- } else {
347
- nextRate = rates.first { $0 > currentRate } ?? rates[0]
348
- }
349
-
277
+ guard let nextRate = NowPlayingButtonRules.rate(after: currentRate, in: audioBrowser.playerOptions.playbackRates) else { return }
350
278
  player.rate = Float(nextRate)
351
279
  logger.info("CarPlay playback rate changed: \(currentRate) → \(nextRate)")
352
280
  }
@@ -355,26 +283,19 @@ final class CarPlayNowPlayingManager {
355
283
 
356
284
  fileprivate func handleAlbumArtistButtonTapped() {
357
285
  guard let destination = albumArtistDestination else { return }
358
- let track = pendingAlbumArtistTrack ?? audioBrowser?.getPlayer()?.currentTrack
359
- // The album line is what was tapped, so its text is the natural title for
360
- // the pushed destination (artist may be unset, or the live song).
286
+ let track = pendingAlbumArtistTrack ?? player?.currentTrack
287
+ // The album line is what was tapped, so it titles the destination; artist may be unset.
361
288
  let title = track?.album ?? track?.artist ?? track?.title ?? ""
362
289
  logger.info("Album/Artist button tapped, navigating to \(destination)")
363
- navigateToUrl?(destination, title)
290
+ navigate(destination, title)
364
291
  }
365
292
 
366
- private func updateNowPlayingUpNextButton() {
367
- let template = CPNowPlayingTemplate.shared
368
- template.isUpNextButtonEnabled = (audioBrowser?.carPlayUpNextButton ?? true) && (audioBrowser?.getPlayer()?.tracks.count ?? 0) > 1
293
+ private func updateUpNextButton() {
294
+ CPNowPlayingTemplate.shared.isUpNextButtonEnabled = audioBrowser.playerOptions.carPlayUpNextButton && (player?.tracks.count ?? 0) > 1
369
295
  }
370
296
 
371
297
  fileprivate func handleUpNextButtonTapped() {
372
- guard let player = audioBrowser?.getPlayer() else {
373
- logger.warning("Player not available for Up Next")
374
- return
375
- }
376
-
377
- let tracks = player.tracks
298
+ let tracks = player?.tracks ?? []
378
299
 
379
300
  guard !tracks.isEmpty else {
380
301
  logger.debug("No tracks in queue for Up Next")
@@ -383,13 +304,11 @@ final class CarPlayNowPlayingManager {
383
304
 
384
305
  logger.info("Showing Up Next queue with \(tracks.count) tracks")
385
306
 
386
- // Reuse the now-playing template's button title (system-localized "Up Next"
387
- // by default, and whatever the app set otherwise) instead of hardcoding an
388
- // un-localized string.
307
+ // System-localized, or what the app set.
389
308
  let upNextTitle = CPNowPlayingTemplate.shared.upNextTitle
390
309
  let template = CPListTemplate(
391
310
  title: upNextTitle.isEmpty ? "Up Next" : upNextTitle,
392
- sections: [createUpNextSection(tracks: tracks, player: player)],
311
+ sections: [createUpNextSection(tracks: tracks)],
393
312
  )
394
313
 
395
314
  upNextTemplate = template
@@ -397,18 +316,17 @@ final class CarPlayNowPlayingManager {
397
316
  interfaceController.safePush(template, animated: true)
398
317
  }
399
318
 
400
- private func createUpNextSection(tracks: [Track], player: TrackPlayer) -> CPListSection {
401
- // Clamp to CarPlay's list limit (createSections does the same for browse
402
- // lists). Taking the prefix keeps item positions aligned with queue indices.
319
+ private func createUpNextSection(tracks: [Track]) -> CPListSection {
403
320
  let maxItems = CPListTemplate.maximumItemCount
404
321
  if tracks.count > maxItems {
405
322
  logger.info("Up Next queue has \(tracks.count) tracks, clamping to CarPlay's limit of \(maxItems)")
406
323
  }
324
+ // A prefix keeps item positions equal to queue indices.
407
325
  let items = tracks.prefix(maxItems).enumerated().map { index, track -> CPListItem in
408
- listItemFactory(track) { [weak self] _, completion in
326
+ listItem(track) { [weak self] _, completion in
409
327
  self?.logger.info("Skipping to track at index \(index): \(track.title)")
410
328
  do {
411
- try player.skipTo(index, playWhenReady: true)
329
+ try self?.player?.skipTo(index, playWhenReady: true)
412
330
  } catch {
413
331
  self?.logger.error("Failed to skip to track: \(error.localizedDescription)")
414
332
  }
@@ -421,7 +339,6 @@ final class CarPlayNowPlayingManager {
421
339
 
422
340
  // MARK: - Now Playing Observer
423
341
 
424
- /// Private helper class for CPNowPlayingTemplateObserver conformance.
425
342
  private final class NowPlayingObserver: NSObject, CPNowPlayingTemplateObserver, @unchecked Sendable {
426
343
  private let logger = Logger(subsystem: "com.audiobrowser", category: "NowPlayingObserver")
427
344
  private weak var manager: CarPlayNowPlayingManager?
@@ -444,3 +361,15 @@ private final class NowPlayingObserver: NSObject, CPNowPlayingTemplateObserver,
444
361
  }
445
362
  }
446
363
  }
364
+
365
+ private extension UIImage {
366
+ func fitted(to targetSize: CGSize, scale: CGFloat) -> UIImage? {
367
+ UIGraphicsBeginImageContextWithOptions(targetSize, false, scale)
368
+ defer { UIGraphicsEndImageContext() }
369
+ let fitScale = min(targetSize.width / size.width, targetSize.height / size.height)
370
+ let scaledSize = CGSize(width: size.width * fitScale, height: size.height * fitScale)
371
+ let origin = CGPoint(x: (targetSize.width - scaledSize.width) / 2, y: (targetSize.height - scaledSize.height) / 2)
372
+ draw(in: CGRect(origin: origin, size: scaledSize))
373
+ return UIGraphicsGetImageFromCurrentImageContext()?.withRenderingMode(.alwaysTemplate)
374
+ }
375
+ }
@@ -0,0 +1,103 @@
1
+ import CarPlay
2
+ import NitroModules
3
+
4
+ extension CarPlaySession {
5
+ /// A row or tile was tapped. Calls `completion` at once so the list never locks: a browse
6
+ /// pushes its destination and fills it in; playback shows its loading state on Now Playing.
7
+ func select(_ track: Track, completion: @escaping () -> Void) {
8
+ logger.info("Selected track: \(track.title)")
9
+ // A tap queued before `end()`: the next run owns the screen.
10
+ guard !ended else {
11
+ completion()
12
+ return
13
+ }
14
+
15
+ if track.src != nil, let identity = track.identity, player?.currentTrack?.identity == identity {
16
+ try? audioBrowser.play()
17
+ nowPlaying.showNowPlaying()
18
+ completion()
19
+ return
20
+ }
21
+
22
+ // A playable track always lands on Now Playing, so it shows now with the tapped track's
23
+ // fields: the queue expansion and media resolve may both hit the network.
24
+ if track.src != nil {
25
+ player?.previewNowPlaying(track)
26
+ nowPlaying.prepare(for: track)
27
+ nowPlaying.showNowPlaying()
28
+ }
29
+ completion()
30
+
31
+ spawn { session in
32
+ guard let player = session.player else { return }
33
+ let result = await session.trackSelector.select(track: track, player: player)
34
+ guard !Task.isCancelled else {
35
+ if track.src != nil { session.player?.endNowPlayingPreview() }
36
+ return
37
+ }
38
+ switch result {
39
+ case let .play(intent):
40
+ session.player?.execute(intent)
41
+ session.nowPlaying.showNowPlaying(popToFront: false)
42
+ case .intercepted:
43
+ session.nowPlaying.showNowPlaying(popToFront: false)
44
+ case let .browse(path):
45
+ await session.navigate(to: path, title: track.title)
46
+ case .none:
47
+ break
48
+ }
49
+ }
50
+ }
51
+
52
+ /// Pushes `path`'s page as an empty, spinning template that fills in once it appears; or the
53
+ /// Browse Gate's page when the gate holds the path; or selects the tab that is that path.
54
+ func navigate(to path: String, title: String) async {
55
+ // A push lands asynchronously: `navigatingPaths` catches a double tap until the pushed
56
+ // template appears and clears it.
57
+ guard interfaceController.topTemplate?.carPlayInfo?.path != path, !navigatingPaths.contains(path) else { return }
58
+ navigatingPaths.insert(path)
59
+ var pushing = false
60
+ defer { if !pushing { navigatingPaths.remove(path) } }
61
+
62
+ let chrome = audioBrowser.browseGate.isActive ? await gate(.browse, path: path) : nil
63
+ guard !Task.isCancelled else { return }
64
+ let template: CPTemplate
65
+ if let chrome {
66
+ template = makeGatePage(chrome, path: path, tab: nil)
67
+ } else if selectTab(owning: path) {
68
+ return
69
+ } else {
70
+ template = CPListTemplate.loading(title: title, path: path, loadingTitle: config.carPlayLoadingTitle)
71
+ }
72
+
73
+ pushing = true
74
+ interfaceController.safePush(template, animated: true) { [weak self] pushed, error in
75
+ guard !pushed else { return }
76
+ // The template never appears to clear the guard (e.g. at the depth limit).
77
+ self?.navigatingPaths.remove(path)
78
+ if let error { self?.logger.error("pushTemplate failed for \(path): \(error.localizedDescription)") }
79
+ }
80
+ }
81
+
82
+ /// Switches to the tab whose path this is, popping any pushed stack first, instead of pushing
83
+ /// a second copy of the tab. False when no tab has the path, when the root is not a tab bar,
84
+ /// or before iOS 17, which cannot select a tab.
85
+ private func selectTab(owning path: String) -> Bool {
86
+ guard #available(iOS 17.0, *),
87
+ let tabBar = interfaceController.rootTemplate as? CPTabBarTemplate,
88
+ let tab = tabBar.templates.first(where: { $0.contentPath == path })
89
+ else { return false }
90
+ let isPushed = interfaceController.templates.count > 1
91
+ if tabBar.selectedTemplate === tab, !isPushed { return true }
92
+ guard isPushed else {
93
+ tabBar.select(tab)
94
+ return true
95
+ }
96
+ interfaceController.safePopToRoot(animated: true) { popped, _ in
97
+ // After a failed pop the selection would land under the pushed stack.
98
+ guard popped else { return }
99
+ tabBar.select(tab)
100
+ }
101
+ return true
102
+ }
103
+ }