react-native-audio-browser 0.2.0-next.4 → 0.2.0-next.40

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 (1025) hide show
  1. package/README.md +36 -22
  2. package/android/build.gradle +42 -15
  3. package/android/gradle.properties +2 -2
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +543 -280
  6. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +38 -0
  7. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +18 -2
  8. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +131 -0
  9. package/android/src/main/java/com/audiobrowser/Service.kt +9 -6
  10. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  11. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  12. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  13. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  14. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  15. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  16. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  17. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  18. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  19. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  20. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  21. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  22. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  23. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  24. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +12 -12
  26. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +111 -58
  27. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  28. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  29. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  30. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +530 -230
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +218 -252
  32. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +23 -26
  33. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  35. package/android/src/main/java/com/audiobrowser/player/Player.kt +130 -63
  36. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  37. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  38. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +12 -4
  39. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  40. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  41. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  42. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  44. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  45. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  46. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  47. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +62 -40
  48. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  49. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  50. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  51. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +56 -52
  52. package/android/src/main/res/values/strings.xml +25 -5
  53. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  54. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  55. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  56. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  57. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  58. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  59. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  60. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  61. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  62. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  63. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  64. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  65. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  66. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  67. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  68. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +385 -0
  69. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +101 -58
  70. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  71. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  72. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +45 -0
  73. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +42 -2
  74. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  75. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  76. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  77. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  78. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +185 -0
  79. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  80. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  81. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  82. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  83. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  84. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  85. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  86. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  87. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  88. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  89. package/ios/AVPlayerEngine.swift +362 -0
  90. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  91. package/ios/Browser/BrowseGate.swift +58 -0
  92. package/ios/Browser/BrowserConfig.swift +115 -81
  93. package/ios/Browser/BrowserError.swift +16 -0
  94. package/ios/Browser/BrowserManager.swift +155 -654
  95. package/ios/Browser/BrowserPathHelper.swift +68 -51
  96. package/ios/Browser/FavoriteSet.swift +46 -0
  97. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  98. package/ios/Browser/JsonModels.swift +270 -321
  99. package/ios/Browser/NavigationErrorState.swift +41 -0
  100. package/ios/Browser/PageResolver.swift +147 -0
  101. package/ios/Browser/RequestLayer.swift +185 -0
  102. package/ios/Browser/RequestPipeline.swift +303 -0
  103. package/ios/Browser/SearchDrillIn.swift +7 -7
  104. package/ios/Browser/SectionScope.swift +82 -23
  105. package/ios/Browser/SimpleRouter.swift +73 -144
  106. package/ios/Browser/StyleResolver.swift +58 -0
  107. package/ios/Browser/TabBarEntries.swift +9 -3
  108. package/ios/Browser/TrackIdTemplate.swift +37 -0
  109. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  110. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  111. package/ios/CarPlay/CarPlayController.swift +37 -1297
  112. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  113. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  114. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  115. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  116. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  117. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  118. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  119. package/ios/CarPlay/CarPlaySession.swift +207 -0
  120. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  121. package/ios/CarPlay/IntentHandlers.swift +96 -0
  122. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  123. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  124. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  125. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  126. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  127. package/ios/CarPlay/SectionPresentation.swift +77 -0
  128. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  129. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  130. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  131. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  132. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  133. package/ios/Extension/SearchParams+Query.swift +28 -0
  134. package/ios/Extension/Section+Copying.swift +29 -0
  135. package/ios/Extension/String+IcyCharset.swift +21 -0
  136. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  137. package/ios/Extension/Track+AVPlayer.swift +0 -16
  138. package/ios/Extension/Track+Copying.swift +11 -13
  139. package/ios/Extension/Track+Identity.swift +25 -0
  140. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  141. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  142. package/ios/Extension/URLError+Connectivity.swift +15 -0
  143. package/ios/Http/HttpClient.swift +71 -165
  144. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  145. package/ios/HybridAudioBrowser+Options.swift +105 -0
  146. package/ios/HybridAudioBrowser+Player.swift +341 -0
  147. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  148. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  149. package/ios/HybridAudioBrowser.swift +132 -1652
  150. package/ios/Model/NitroTypeStubs.swift +239 -24
  151. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  152. package/ios/Model/RemoteCommand.swift +6 -60
  153. package/ios/Model/TrackPlayerError.swift +2 -2
  154. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  155. package/ios/Observer/ItemObserver.swift +90 -0
  156. package/ios/Observer/PlayerObserver.swift +59 -0
  157. package/ios/Option/SessionCategories.swift +42 -92
  158. package/ios/Player/AudioSessionController.swift +191 -0
  159. package/ios/Player/DeferredSeek.swift +70 -0
  160. package/ios/Player/ErrorStatus.swift +50 -0
  161. package/ios/Player/MediaLoader.swift +66 -87
  162. package/ios/Player/NowPlayingLines.swift +36 -0
  163. package/ios/Player/NowPlayingUpdater.swift +180 -85
  164. package/ios/Player/PlaybackFailure.swift +125 -0
  165. package/ios/Player/PlaybackPersistence.swift +73 -0
  166. package/ios/Player/PlaybackTimer.swift +8 -2
  167. package/ios/Player/Player.swift +960 -0
  168. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  169. package/ios/Player/PlayerEngine.swift +104 -0
  170. package/ios/Player/PlayerStatusTypes.swift +2 -6
  171. package/ios/Player/QueueManager.swift +93 -67
  172. package/ios/Player/RetryLoop.swift +291 -0
  173. package/ios/Player/ShuffleOrder.swift +33 -0
  174. package/ios/Player/SleepTimerManager.swift +14 -16
  175. package/ios/Player/VolumeFader.swift +5 -0
  176. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  177. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  178. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  179. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  180. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  181. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  182. package/ios/Tests/DeferredSeekTests.swift +70 -0
  183. package/ios/Tests/EmitterTests.swift +22 -38
  184. package/ios/Tests/ErrorStatusTests.swift +50 -0
  185. package/ios/Tests/FavoriteSetTests.swift +60 -0
  186. package/ios/Tests/GenerationMemoTests.swift +121 -0
  187. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  188. package/ios/Tests/JsonModelsTests.swift +194 -1
  189. package/ios/Tests/LRUCacheTests.swift +110 -0
  190. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  191. package/ios/Tests/MediaLoaderTests.swift +36 -67
  192. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  193. package/ios/Tests/NowPlayingLinesTests.swift +43 -0
  194. package/ios/Tests/ObserverTests.swift +88 -0
  195. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  196. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  197. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  198. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  199. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +489 -311
  200. package/ios/Tests/PlayingStateTests.swift +42 -0
  201. package/ios/Tests/QueueManagerTests.swift +196 -115
  202. package/ios/Tests/ReadyValueTests.swift +73 -0
  203. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  204. package/ios/Tests/RequestLayerTests.swift +228 -0
  205. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  206. package/ios/Tests/RetryLoopTests.swift +305 -0
  207. package/ios/Tests/SearchDrillInTests.swift +16 -16
  208. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  209. package/ios/Tests/SectionPresentationTests.swift +98 -0
  210. package/ios/Tests/SectionScopeTests.swift +139 -54
  211. package/ios/Tests/SimpleRouterTests.swift +38 -3
  212. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  213. package/ios/Tests/StyleResolverTests.swift +132 -0
  214. package/ios/Tests/Support/TestTypes.swift +146 -101
  215. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  216. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  217. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  218. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  219. package/ios/Tests/TrackIdentityTests.swift +20 -0
  220. package/ios/Tests/TrackSelectorTests.swift +168 -33
  221. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  222. package/ios/TrackSelector.swift +62 -65
  223. package/ios/Util/ArtworkImageFetcher.swift +58 -1
  224. package/ios/Util/ConcurrentMap.swift +19 -0
  225. package/ios/Util/Emitter.swift +40 -12
  226. package/ios/Util/GenerationMemo.swift +36 -0
  227. package/ios/Util/LRUCache.swift +23 -159
  228. package/ios/Util/NetworkMonitor.swift +32 -32
  229. package/ios/Util/OutputPicker.swift +48 -0
  230. package/ios/Util/ReadyValue.swift +56 -0
  231. package/ios/Util/SFSymbolRenderer.swift +59 -31
  232. package/ios/Util/SVGProcessor.swift +9 -12
  233. package/lib/commonjs/AudioBrowser.js +8 -8
  234. package/lib/commonjs/AudioBrowser.js.map +1 -1
  235. package/lib/commonjs/CLAUDE.md +52 -0
  236. package/lib/commonjs/features/browser-config.js +12 -8
  237. package/lib/commonjs/features/browser-config.js.map +1 -1
  238. package/lib/commonjs/features/browser.js +11 -3
  239. package/lib/commonjs/features/browser.js.map +1 -1
  240. package/lib/commonjs/features/carConnection.js +1 -1
  241. package/lib/commonjs/features/equalizer.js +1 -1
  242. package/lib/commonjs/features/errors.js +3 -3
  243. package/lib/commonjs/features/favorites.js +14 -11
  244. package/lib/commonjs/features/favorites.js.map +1 -1
  245. package/lib/commonjs/features/gate.js +16 -1
  246. package/lib/commonjs/features/gate.js.map +1 -1
  247. package/lib/commonjs/features/metadata.js +20 -3
  248. package/lib/commonjs/features/metadata.js.map +1 -1
  249. package/lib/commonjs/features/network.js +1 -1
  250. package/lib/commonjs/features/nowPlaying.js +1 -1
  251. package/lib/commonjs/features/output.js +1 -1
  252. package/lib/commonjs/features/playback/controls.js +4 -2
  253. package/lib/commonjs/features/playback/controls.js.map +1 -1
  254. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  255. package/lib/commonjs/features/playback/playing.js +1 -1
  256. package/lib/commonjs/features/playback/progress.js +3 -2
  257. package/lib/commonjs/features/playback/progress.js.map +1 -1
  258. package/lib/commonjs/features/playback/rate.js +8 -1
  259. package/lib/commonjs/features/playback/rate.js.map +1 -1
  260. package/lib/commonjs/features/playback/state.js +3 -4
  261. package/lib/commonjs/features/playback/state.js.map +1 -1
  262. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  263. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  264. package/lib/commonjs/features/playback/volume.js +1 -1
  265. package/lib/commonjs/features/player/options.js +48 -34
  266. package/lib/commonjs/features/player/options.js.map +1 -1
  267. package/lib/commonjs/features/player/setup.js +18 -9
  268. package/lib/commonjs/features/player/setup.js.map +1 -1
  269. package/lib/commonjs/features/player/validateOptions.js +23 -0
  270. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  271. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  272. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  273. package/lib/commonjs/features/queue/queue.js +13 -6
  274. package/lib/commonjs/features/queue/queue.js.map +1 -1
  275. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  276. package/lib/commonjs/features/queue/shuffle.js +1 -1
  277. package/lib/commonjs/features/remoteControls.js +13 -92
  278. package/lib/commonjs/features/remoteControls.js.map +1 -1
  279. package/lib/commonjs/features/sleepTimer.js +13 -1
  280. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  281. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  282. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  283. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  284. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  285. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  286. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  287. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  288. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  289. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  290. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  291. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  292. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  293. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  294. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  295. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  296. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  297. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  298. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  299. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  300. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  301. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  302. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  303. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  304. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  305. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  306. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  307. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  308. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  309. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  310. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  311. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  312. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  313. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  314. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  315. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  316. package/lib/commonjs/web/browser/sections.js +89 -0
  317. package/lib/commonjs/web/browser/sections.js.map +1 -0
  318. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  319. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  320. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  321. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  322. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  323. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  324. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  325. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  326. package/lib/module/AudioBrowser.js +2 -1
  327. package/lib/module/AudioBrowser.js.map +1 -1
  328. package/lib/module/CLAUDE.md +52 -0
  329. package/lib/module/features/browser-config.js +12 -8
  330. package/lib/module/features/browser-config.js.map +1 -1
  331. package/lib/module/features/browser.js +11 -3
  332. package/lib/module/features/browser.js.map +1 -1
  333. package/lib/module/features/carConnection.js +1 -1
  334. package/lib/module/features/equalizer.js +1 -1
  335. package/lib/module/features/errors.js +3 -3
  336. package/lib/module/features/favorites.js +14 -11
  337. package/lib/module/features/favorites.js.map +1 -1
  338. package/lib/module/features/gate.js +16 -1
  339. package/lib/module/features/gate.js.map +1 -1
  340. package/lib/module/features/metadata.js +20 -3
  341. package/lib/module/features/metadata.js.map +1 -1
  342. package/lib/module/features/network.js +1 -1
  343. package/lib/module/features/nowPlaying.js +1 -1
  344. package/lib/module/features/output.js +1 -1
  345. package/lib/module/features/playback/controls.js +4 -2
  346. package/lib/module/features/playback/controls.js.map +1 -1
  347. package/lib/module/features/playback/playWhenReady.js +1 -1
  348. package/lib/module/features/playback/playing.js +1 -1
  349. package/lib/module/features/playback/progress.js +3 -2
  350. package/lib/module/features/playback/progress.js.map +1 -1
  351. package/lib/module/features/playback/rate.js +8 -1
  352. package/lib/module/features/playback/rate.js.map +1 -1
  353. package/lib/module/features/playback/state.js +3 -4
  354. package/lib/module/features/playback/state.js.map +1 -1
  355. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  356. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  357. package/lib/module/features/playback/volume.js +1 -1
  358. package/lib/module/features/player/options.js +47 -32
  359. package/lib/module/features/player/options.js.map +1 -1
  360. package/lib/module/features/player/setup.js +17 -8
  361. package/lib/module/features/player/setup.js.map +1 -1
  362. package/lib/module/features/player/validateOptions.js +19 -0
  363. package/lib/module/features/player/validateOptions.js.map +1 -0
  364. package/lib/module/features/queue/activeTrack.js +15 -4
  365. package/lib/module/features/queue/activeTrack.js.map +1 -1
  366. package/lib/module/features/queue/queue.js +13 -6
  367. package/lib/module/features/queue/queue.js.map +1 -1
  368. package/lib/module/features/queue/repeatMode.js +1 -1
  369. package/lib/module/features/queue/shuffle.js +1 -1
  370. package/lib/module/features/remoteControls.js +13 -92
  371. package/lib/module/features/remoteControls.js.map +1 -1
  372. package/lib/module/features/sleepTimer.js +13 -1
  373. package/lib/module/features/sleepTimer.js.map +1 -1
  374. package/lib/module/test-utils/reactNativeStub.js +58 -0
  375. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  376. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  377. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  378. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  379. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  380. package/lib/module/utils/getTrackIdentity.js +20 -0
  381. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  382. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  383. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  384. package/lib/module/web/NativeAudioBrowser.js +202 -77
  385. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  386. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  387. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  388. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  389. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  390. package/lib/module/web/TrackPlayer/Player.js +254 -39
  391. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  392. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  393. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  394. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  395. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  396. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  397. package/lib/module/web/browser/BrowserManager.js +175 -100
  398. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  399. package/lib/module/web/browser/FavoriteManager.js +31 -21
  400. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  401. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  402. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  403. package/lib/module/web/browser/SearchManager.js +18 -23
  404. package/lib/module/web/browser/SearchManager.js.map +1 -1
  405. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  406. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  407. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  408. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  409. package/lib/module/web/browser/sections.js +83 -0
  410. package/lib/module/web/browser/sections.js.map +1 -0
  411. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  412. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  413. package/lib/module/web/http/followMediaRedirect.js +215 -0
  414. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  415. package/lib/module/web/player/NowPlayingManager.js +4 -3
  416. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  417. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  418. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  419. package/lib/typescript/package.json +1 -0
  420. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  421. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  422. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  423. package/lib/typescript/src/features/browser.d.ts +10 -2
  424. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  425. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  426. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  427. package/lib/typescript/src/features/errors.d.ts +3 -3
  428. package/lib/typescript/src/features/favorites.d.ts +14 -11
  429. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  430. package/lib/typescript/src/features/gate.d.ts +18 -2
  431. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  432. package/lib/typescript/src/features/metadata.d.ts +20 -3
  433. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  434. package/lib/typescript/src/features/network.d.ts +1 -1
  435. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  436. package/lib/typescript/src/features/output.d.ts +1 -1
  437. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  438. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  439. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  440. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  441. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  442. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  443. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  444. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  445. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  446. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  447. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  448. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  449. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  450. package/lib/typescript/src/features/player/options.d.ts +108 -56
  451. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  452. package/lib/typescript/src/features/player/setup.d.ts +14 -4
  453. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  454. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  455. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  456. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  457. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  458. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  459. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  460. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  461. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  462. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  463. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  464. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  465. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  466. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  467. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  468. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  469. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  470. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  471. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  472. package/lib/typescript/src/types/browser.d.ts +93 -61
  473. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  474. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  475. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  476. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  477. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  478. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  479. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  480. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  481. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  482. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  483. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  484. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +1 -2
  485. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  486. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  487. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  488. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +12 -12
  489. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  490. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  491. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  492. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  493. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  494. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  495. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  496. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  497. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  498. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  499. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  500. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  501. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  502. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  503. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  504. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  505. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  506. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  507. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  508. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  509. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  510. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  512. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  513. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  514. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  515. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  516. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  517. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  518. 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
  519. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  520. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  521. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  522. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  523. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  524. 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
  525. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  526. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  528. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  530. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  531. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  532. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  533. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +9 -12
  534. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  535. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  536. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  537. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  538. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  539. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  540. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  542. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  543. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  544. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  546. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  547. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  548. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  549. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  554. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  555. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  556. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  558. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  559. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  560. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  561. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  564. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -53
  566. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  567. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  568. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  572. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  575. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  578. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  579. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  581. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  582. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  583. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  584. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +17 -14
  585. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +9 -12
  586. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  587. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  588. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  589. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  590. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +12 -12
  591. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  592. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  593. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JOptions.hpp +9 -12
  595. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  596. package/nitrogen/generated/android/c++/JOutputType.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  599. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  600. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  602. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  605. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  607. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  608. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  609. package/nitrogen/generated/android/c++/{JNotificationButton.hpp → JRemoteButton.hpp} +19 -19
  610. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +86 -0
  611. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  612. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  613. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  616. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  619. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  621. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  623. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  625. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  626. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  627. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  631. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  633. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  634. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  635. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  637. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  639. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  640. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  641. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp +26 -0
  642. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +75 -0
  643. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  644. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  645. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  646. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +20 -3
  647. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  648. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  649. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  650. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  651. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  652. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  653. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  654. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  655. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  656. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  657. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  658. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  659. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  660. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  661. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  662. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  663. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  664. 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
  665. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  666. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  667. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  671. 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
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  674. 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
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  677. 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
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  687. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  694. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  697. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  700. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +29 -0
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +20 -3
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{NotificationButton.kt → RemoteButton.kt} +3 -3
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +61 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{Variant_NullType_NotificationButtonLayout.kt → Variant_NullType_RemoteButtonLayout.kt} +24 -15
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  782. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  783. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  784. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +779 -665
  785. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +34 -16
  786. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +36 -18
  787. package/nitrogen/generated/ios/swift/AndroidOptions.swift +12 -12
  788. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  789. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  790. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  791. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  792. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  793. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  794. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  795. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  796. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  797. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  798. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  799. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  800. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  801. package/nitrogen/generated/ios/swift/NitroAndroidUpdateOptions.swift +12 -12
  802. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  803. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  804. package/nitrogen/generated/ios/swift/{NotificationButton.swift → RemoteButton.swift} +6 -6
  805. package/nitrogen/generated/ios/swift/RemoteButtonLayout.swift +57 -0
  806. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  807. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  808. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  809. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  810. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  811. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  812. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  813. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  814. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  815. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  816. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +30 -0
  817. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  818. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  819. package/nitrogen/generated/shared/c++/AndroidOptions.hpp +8 -8
  820. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  821. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  822. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  823. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  824. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  825. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  826. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  827. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  828. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  829. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  830. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  831. package/nitrogen/generated/shared/c++/NitroAndroidUpdateOptions.hpp +8 -8
  832. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  833. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  834. package/nitrogen/generated/shared/c++/{NotificationButton.hpp → RemoteButton.hpp} +19 -19
  835. package/nitrogen/generated/shared/c++/RemoteButtonLayout.hpp +94 -0
  836. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  837. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  838. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  839. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  840. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  841. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  842. package/package.json +24 -11
  843. package/src/AudioBrowser.ts +2 -1
  844. package/src/CLAUDE.md +52 -0
  845. package/src/features/battery.test.ts +79 -0
  846. package/src/features/browser-config.test.ts +21 -6
  847. package/src/features/browser-config.ts +12 -8
  848. package/src/features/browser.test.ts +1 -1
  849. package/src/features/browser.ts +11 -3
  850. package/src/features/carConnection.ts +1 -1
  851. package/src/features/equalizer.ts +1 -1
  852. package/src/features/errors.ts +3 -3
  853. package/src/features/favorites.ts +14 -11
  854. package/src/features/gate.ts +16 -1
  855. package/src/features/hook-wiring.test.ts +302 -0
  856. package/src/features/metadata.ts +20 -3
  857. package/src/features/network.ts +1 -1
  858. package/src/features/nowPlaying.ts +1 -1
  859. package/src/features/output.ts +1 -1
  860. package/src/features/playback/controls.ts +4 -2
  861. package/src/features/playback/playWhenReady.ts +1 -1
  862. package/src/features/playback/playing.ts +1 -1
  863. package/src/features/playback/progress.test.ts +169 -0
  864. package/src/features/playback/progress.ts +3 -2
  865. package/src/features/playback/rate.ts +8 -1
  866. package/src/features/playback/state.ts +3 -4
  867. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  868. package/src/features/playback/trackPlaybackTime.ts +1 -6
  869. package/src/features/playback/volume.ts +1 -1
  870. package/src/features/player/options.ts +126 -76
  871. package/src/features/player/setup.test.ts +24 -7
  872. package/src/features/player/setup.ts +22 -10
  873. package/src/features/player/validateOptions.ts +21 -0
  874. package/src/features/queue/activeTrack.ts +15 -4
  875. package/src/features/queue/queue.ts +13 -6
  876. package/src/features/queue/repeatMode.ts +1 -1
  877. package/src/features/queue/shuffle.ts +1 -1
  878. package/src/features/remoteControls.ts +13 -92
  879. package/src/features/sleepTimer.test.ts +172 -0
  880. package/src/features/sleepTimer.ts +9 -1
  881. package/src/nitro-stub-drift.test.ts +277 -0
  882. package/src/public-surface.test.ts +147 -0
  883. package/src/specs/audio-browser.nitro.ts +5 -4
  884. package/src/style-resolution.test.ts +210 -0
  885. package/src/test-utils/reactNativeStub.ts +60 -0
  886. package/src/types/browser-native.ts +7 -3
  887. package/src/types/browser-nodes.ts +403 -134
  888. package/src/types/browser.ts +97 -63
  889. package/src/utils/LazyNativeEmitter.ts +28 -15
  890. package/src/utils/NativeUpdatedValue.ts +29 -13
  891. package/src/utils/getTrackIdentity.ts +20 -0
  892. package/src/utils/useDebug.test.ts +182 -0
  893. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  894. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  895. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  896. package/src/web/NativeAudioBrowser.ts +241 -84
  897. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  898. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  899. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  900. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  901. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  902. package/src/web/TrackPlayer/Player.ts +284 -37
  903. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  904. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  905. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  906. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  907. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  908. package/src/web/__tests__/lifecycle.test.ts +345 -0
  909. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  910. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  911. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  912. package/src/web/__tests__/retry.test.ts +169 -0
  913. package/src/web/browser/BrowserManager.ts +209 -111
  914. package/src/web/browser/FavoriteManager.test.ts +84 -0
  915. package/src/web/browser/FavoriteManager.ts +28 -23
  916. package/src/web/browser/NavigationErrorManager.ts +3 -1
  917. package/src/web/browser/SearchManager.test.ts +75 -0
  918. package/src/web/browser/SearchManager.ts +25 -28
  919. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  920. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  921. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  922. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  923. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  924. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  925. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  926. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  927. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  928. package/src/web/browser/sections.test.ts +91 -0
  929. package/src/web/browser/sections.ts +72 -0
  930. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  931. package/src/web/http/RequestConfigBuilder.ts +140 -33
  932. package/src/web/http/followMediaRedirect.test.ts +289 -0
  933. package/src/web/http/followMediaRedirect.ts +253 -0
  934. package/src/web/player/NowPlayingManager.ts +4 -3
  935. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  936. package/src/web/util/BrowserPathHelper.ts +70 -13
  937. package/website/guide/android-auto.md +114 -0
  938. package/website/guide/android-certificates.md +409 -0
  939. package/website/guide/artwork.md +255 -0
  940. package/website/guide/audio-output.md +135 -0
  941. package/website/guide/automotive.md +86 -0
  942. package/website/guide/basic-usage.md +151 -0
  943. package/website/guide/battery.md +115 -0
  944. package/website/guide/browser.md +587 -0
  945. package/website/guide/carplay.md +650 -0
  946. package/website/guide/configuration.md +173 -0
  947. package/website/guide/equalizer.md +231 -0
  948. package/website/guide/errors.md +310 -0
  949. package/website/guide/favorites.md +154 -0
  950. package/website/guide/gate.md +143 -0
  951. package/website/guide/getting-started.md +46 -0
  952. package/website/guide/hooks.md +238 -0
  953. package/website/guide/live-streams.md +125 -0
  954. package/website/guide/metadata.md +239 -0
  955. package/website/guide/migrating-from-track-player.md +244 -0
  956. package/website/guide/native-callback-fetch.md +127 -0
  957. package/website/guide/network.md +86 -0
  958. package/website/guide/now-playing.md +175 -0
  959. package/website/guide/playback.md +328 -0
  960. package/website/guide/queue.md +300 -0
  961. package/website/guide/remote-controls.md +256 -0
  962. package/website/guide/search.md +255 -0
  963. package/website/guide/sleep-timer.md +268 -0
  964. package/website/guide/track.md +247 -0
  965. package/ios/Bridge.h +0 -8
  966. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  967. package/ios/Browser/MediaResolveComposer.swift +0 -114
  968. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  969. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  970. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  971. package/ios/Model/MediaURL.swift +0 -67
  972. package/ios/Model/SourceType.swift +0 -6
  973. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  974. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  975. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  976. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  977. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  978. package/ios/Observer/PlayerStateObserver.swift +0 -50
  979. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  980. package/ios/Option/PitchAlgorithms.swift +0 -17
  981. package/ios/Option/TimeEventFrequency.swift +0 -18
  982. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  983. package/ios/Player/MediaIntentCriteria.swift +0 -139
  984. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  985. package/ios/Player/PlaybackCoordinator.swift +0 -754
  986. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  987. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  988. package/ios/Player/PlaybackStateStore.swift +0 -27
  989. package/ios/Player/PlayingStateManager.swift +0 -33
  990. package/ios/Player/RetryManager.swift +0 -322
  991. package/ios/Player/SeekCompletionHandler.swift +0 -3
  992. package/ios/Player/SleepTimerHandling.swift +0 -15
  993. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  994. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  995. package/ios/Tests/MediaResolveTests.swift +0 -126
  996. package/ios/Tests/OnceValueTests.swift +0 -79
  997. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  998. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  999. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1000. package/ios/Tests/RetryManagerTests.swift +0 -89
  1001. package/ios/TrackPlayer.swift +0 -1014
  1002. package/ios/TrackPlayerCallbacks.swift +0 -86
  1003. package/ios/Util/MetadataAdapter.swift +0 -131
  1004. package/ios/Util/OnceValue.swift +0 -104
  1005. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1006. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1007. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1008. package/nitrogen/generated/android/c++/JNotificationButtonLayout.hpp +0 -94
  1009. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1010. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1011. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp +0 -26
  1012. package/nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.hpp +0 -75
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NotificationButtonLayout.kt +0 -50
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1017. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1018. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1019. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1020. package/nitrogen/generated/ios/swift/NotificationButtonLayout.swift +0 -92
  1021. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1022. package/nitrogen/generated/ios/swift/Variant_NullType_NotificationButtonLayout.swift +0 -18
  1023. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1024. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
  1025. package/nitrogen/generated/shared/c++/NotificationButtonLayout.hpp +0 -102
@@ -2,10 +2,8 @@
2
2
  import NitroModules
3
3
  #endif
4
4
 
5
- /// Subset of TrackPlayerCallbacks containing only the callbacks the coordinator fires.
6
- /// Uses Nitro types (no AVFoundation). TrackPlayerCallbacks extends this protocol
7
- /// so HybridAudioBrowser implements both automatically.
8
- @MainActor protocol PlaybackCoordinatorCallbacks: AnyObject {
5
+ /// What the Player reports, in Nitro types. HybridAudioBrowser implements it.
6
+ @MainActor protocol PlayerCallbacks: AnyObject {
9
7
  func playerDidChangePlayback(_ playback: Playback)
10
8
  func playerDidChangeActiveTrack(_ event: PlaybackActiveTrackChangedEvent)
11
9
  func playerDidUpdateProgress(_ event: PlaybackProgressUpdatedEvent)
@@ -17,8 +15,6 @@
17
15
  func playerDidChangeRepeatMode(_ event: RepeatModeChangedEvent)
18
16
  func playerDidChangeShuffleEnabled(_ enabled: Bool)
19
17
  func playerDidError(_ event: PlaybackErrorEvent)
20
- /// Playback is deliberately stopped — play intent is off, it isn't an interruption-driven pause
21
- /// (those resume), and no retry is pending (a live-stream reconnect must keep the session). The
22
- /// host may release the audio session (debounced) so other apps' audio can resume.
23
- func playerShouldReleaseSession()
18
+ func playerDidReceiveTimedMetadata(_ metadata: TimedMetadata)
19
+ func playerDidChangeSleepTimer(_ state: SleepTimerState?)
24
20
  }
@@ -0,0 +1,104 @@
1
+ import Foundation
2
+
3
+ #if canImport(NitroModules)
4
+ import NitroModules
5
+ #endif
6
+
7
+ /// What the media stack reports to the Player.
8
+ enum EngineEvent {
9
+ /// The loaded item is now current and observed.
10
+ case itemPrepared(likelyToKeepUp: Bool)
11
+ /// Loading the asset failed; the retry loop classifies the error.
12
+ case loadFailed(Error)
13
+ /// The asset loaded but cannot play.
14
+ case unplayable
15
+ /// The source is not a URL.
16
+ case invalidSource(String)
17
+ /// The player or its item failed, with the HTTP status the server last answered, if any.
18
+ case failed(Error?, httpStatusCode: Int?)
19
+ case likelyToKeepUp(Bool)
20
+ /// `waitingForNoItem`: the player waits because it has no item to play.
21
+ case timeControlStatus(PlayerTimeControlStatus, waitingForNoItem: Bool)
22
+ /// Playback crossed the first millisecond.
23
+ case audioDidStart
24
+ case playedToEnd
25
+ /// The buffer emptied mid-playback.
26
+ case stalled
27
+ /// A timed-metadata group (a live stream's song line), decoded with the loaded track's ICY
28
+ /// charset.
29
+ case timedMetadata(TimedMetadata)
30
+ }
31
+
32
+ /// The media stack under the Player: the AVPlayer and its items, media loading, now playing and
33
+ /// the remote commands. It carries out what the Player decides and reports what it observes
34
+ /// through `onEvent`; it holds no playback policy. AVPlayerEngine is the one implementation;
35
+ /// tests use a mock.
36
+ @MainActor protocol PlayerEngine: AnyObject {
37
+ var onEvent: (@MainActor (EngineEvent) -> Void)? { get set }
38
+
39
+ // MARK: The current item
40
+
41
+ var hasItem: Bool { get }
42
+ var hasLoadedAsset: Bool { get }
43
+ var currentTime: Double { get }
44
+ var duration: Double { get }
45
+ var bufferedPosition: Double { get }
46
+ /// The position a reload resumes from: nil without an item, or for an indefinite duration.
47
+ var resumePosition: Double? { get }
48
+ /// The end of a live stream's seekable window, when it has one.
49
+ var liveEdge: Double? { get }
50
+ var isPlaybackLikelyToKeepUp: Bool { get }
51
+ var isAirPlayRoute: Bool { get }
52
+ /// 0–1; ramped by the sleep-timer fade.
53
+ var volume: Float { get set }
54
+
55
+ // MARK: Loading
56
+
57
+ /// Runs the media-URL resolver for `track`, so a short-lived URL is minted afresh, and loads
58
+ /// the result.
59
+ func resolveAndLoad(src: String, track: Track)
60
+ func cancelLoading()
61
+ /// Drops the asset and stops observing the item, leaving it in place for the reload.
62
+ func dropAsset()
63
+ /// Drops the asset and removes the item.
64
+ func clearItem()
65
+ func stopObservingItem()
66
+ /// Replaces the AVPlayer: every handle to the old one is invalid.
67
+ func recreate()
68
+
69
+ // MARK: Transport
70
+
71
+ func play()
72
+ func pause()
73
+ /// Stages `rate` for the next play; applies it now only when `playing`, since a nonzero
74
+ /// AVPlayer rate is a play.
75
+ func setRate(_ rate: Float, playing: Bool)
76
+ /// Seeks the current item exactly; `completion` runs on the main actor.
77
+ func seek(to seconds: Double, completion: @escaping @MainActor (Bool) -> Void)
78
+ func applyTimePitchAlgorithm()
79
+
80
+ // MARK: Now playing and remote commands
81
+
82
+ /// Renders silence so iOS elects the app onto the now-playing surfaces (ADR 0005).
83
+ func primeNowPlaying()
84
+ func loadNowPlayingMetadata(for track: Track)
85
+ func clearNowPlaying()
86
+ /// Re-renders the now-playing lines from the Player's state.
87
+ func renderNowPlaying()
88
+ /// Drops the previous track's override, flash and timed metadata, and re-renders.
89
+ func nowPlayingTrackChanged()
90
+ func applyTimedMetadata(_ metadata: TimedMetadata)
91
+ func updateRemoteRepeatMode(_ mode: RepeatMode)
92
+ func updateRemoteShuffleMode(_ enabled: Bool)
93
+ /// Greys out next/previous on the remote surfaces when the queue has nowhere to skip.
94
+ func updateSkipAvailability(canNext: Bool, canPrevious: Bool)
95
+
96
+ // MARK: Audio session
97
+
98
+ /// Activates the audio session off the main thread, then re-requests the now-playing session,
99
+ /// which the system may have declined while the audio session was inactive.
100
+ func activateAudioSession()
101
+ func cancelAudioSessionRelease()
102
+ /// Releases the audio session after a debounce, unless playback resumes first.
103
+ func scheduleAudioSessionRelease()
104
+ }
@@ -1,9 +1,5 @@
1
- /// Decouples PlaybackCoordinator from AVFoundation enum types.
2
- /// TrackPlayer maps from AVPlayer.TimeControlStatus → PlayerTimeControlStatus at the call boundary.
1
+ /// Decouples Player from AVFoundation enum types.
2
+ /// AVPlayerEngine maps from AVPlayer.TimeControlStatus → PlayerTimeControlStatus at the call boundary.
3
3
  enum PlayerTimeControlStatus {
4
4
  case paused, waitingToPlayAtSpecifiedRate, playing
5
5
  }
6
-
7
- enum PlayerItemStatus {
8
- case unknown, readyToPlay, failed
9
- }
@@ -3,9 +3,16 @@ import Foundation
3
3
  import NitroModules
4
4
  #endif
5
5
 
6
- /// Notifies the owner when the track list changes.
7
- @MainActor protocol QueueManagerDelegate: AnyObject {
8
- func queueDidChangeTracks(_ tracks: [Track])
6
+ /// What a queue mutation changed, reported once the queue has settled.
7
+ struct QueueChange: Equatable {
8
+ /// The track list changed.
9
+ var tracks = false
10
+ /// A different track became current, or the current track was cleared.
11
+ var currentTrack = false
12
+
13
+ static let none = QueueChange()
14
+ static let tracksOnly = QueueChange(tracks: true)
15
+ static let tracksAndCurrent = QueueChange(tracks: true, currentTrack: true)
9
16
  }
10
17
 
11
18
  /// Result of a navigation action (next/previous/skipTo).
@@ -19,11 +26,9 @@ enum QueueNavigationResult {
19
26
  }
20
27
 
21
28
  /// Pure queue logic: tracks, indices, shuffle, repeat.
22
- /// Has no knowledge of AVPlayer or playback — TrackPlayer owns that.
29
+ /// Has no knowledge of AVPlayer or playback — Player and its engine own that.
23
30
  @MainActor
24
31
  class QueueManager {
25
- weak var delegate: QueueManagerDelegate?
26
-
27
32
  // MARK: - Stored Properties
28
33
 
29
34
  /// The index of the current track. `-1` when there is no current track.
@@ -33,11 +38,7 @@ class QueueManager {
33
38
  private(set) var queueSourcePath: String?
34
39
 
35
40
  /// All tracks held by the queue.
36
- private(set) var tracks: [Track] = [] {
37
- didSet {
38
- delegate?.queueDidChangeTracks(tracks)
39
- }
40
- }
41
+ private(set) var tracks: [Track] = []
41
42
 
42
43
  /// The shuffle order for randomized playback.
43
44
  private(set) var shuffleOrder = ShuffleOrder()
@@ -45,8 +46,15 @@ class QueueManager {
45
46
  /// The repeat mode for the queue. Plain property — no side effects.
46
47
  var repeatMode: RepeatMode = .off
47
48
 
48
- /// Whether shuffle mode is enabled. Plain property — no side effects.
49
- var shuffleEnabled: Bool = false
49
+ /// Whether shuffle mode is enabled.
50
+ var shuffleEnabled: Bool = false {
51
+ didSet {
52
+ // Re-pin on enable: the existing order has the current track wherever it happened to land,
53
+ // so without this, turning shuffle on near the end of the queue ends it right away.
54
+ guard shuffleEnabled, shuffleEnabled != oldValue else { return }
55
+ shuffleOrder.reshuffle(keepingFirst: currentIndex)
56
+ }
57
+ }
50
58
 
51
59
  // MARK: - Computed Properties
52
60
 
@@ -196,41 +204,36 @@ class QueueManager {
196
204
  return .trackChanged
197
205
  }
198
206
 
199
- // MARK: - Mutations (returns Bool: whether current track changed)
207
+ // MARK: - Mutations
200
208
 
201
- /// Replace the entire queue with new tracks.
202
- /// Returns `true` (current track always changes).
209
+ /// Replace the entire queue with new tracks. The current track always changes.
203
210
  @discardableResult
204
- func setQueue(_ newTracks: [Track], initialIndex: Int = 0, sourcePath: String? = nil) -> Bool {
211
+ func setQueue(_ newTracks: [Track], initialIndex: Int = 0, sourcePath: String? = nil) -> QueueChange {
205
212
  let clampedIndex = max(0, min(initialIndex, newTracks.count - 1))
206
213
  currentIndex = clampedIndex
207
214
  queueSourcePath = sourcePath
208
215
  tracks = newTracks
209
- shuffleOrder = ShuffleOrder(length: newTracks.count)
210
- return true
216
+ shuffleOrder = ShuffleOrder(length: newTracks.count, firstIndex: clampedIndex)
217
+ return .tracksAndCurrent
211
218
  }
212
219
 
213
- /// Add tracks to the end of the queue.
214
- /// Returns `true` if the queue was empty (a new current track was set).
220
+ /// Add tracks to the end of the queue. The current track changes only when the queue was empty.
215
221
  @discardableResult
216
- func add(_ newTracks: [Track], initialIndex: Int = 0) -> Bool {
217
- guard !newTracks.isEmpty else { return false }
222
+ func add(_ newTracks: [Track], initialIndex: Int = 0) -> QueueChange {
223
+ guard !newTracks.isEmpty else { return .none }
218
224
  let wasEmpty = tracks.isEmpty
219
225
  let insertIndex = tracks.count
220
226
  tracks.append(contentsOf: newTracks)
227
+ if wasEmpty { return adoptInitialCurrent(initialIndex) }
221
228
  shuffleOrder.insert(at: insertIndex, count: newTracks.count)
222
- if wasEmpty {
223
- currentIndex = max(0, min(initialIndex, tracks.count - 1))
224
- return true
225
- }
226
- return false
229
+ return .tracksOnly
227
230
  }
228
231
 
229
- /// Add tracks at a specific index in the queue.
230
- /// Returns `true` if the queue was empty (a new current track was set).
232
+ /// Add tracks at a specific index in the queue. The current track changes only when the queue
233
+ /// was empty.
231
234
  @discardableResult
232
- func addAt(_ newTracks: [Track], at index: Int) throws -> Bool {
233
- guard !newTracks.isEmpty else { return false }
235
+ func addAt(_ newTracks: [Track], at index: Int) throws -> QueueChange {
236
+ guard !newTracks.isEmpty else { return .none }
234
237
  guard index >= 0, tracks.count >= index else {
235
238
  throw TrackPlayerError.QueueError.invalidIndex(
236
239
  index: index,
@@ -243,48 +246,68 @@ class QueueManager {
243
246
  currentIndex += newTracks.count
244
247
  }
245
248
  tracks.insert(contentsOf: newTracks, at: index)
249
+ if wasEmpty { return adoptInitialCurrent(0) }
246
250
  shuffleOrder.insert(at: index, count: newTracks.count)
247
- if wasEmpty {
248
- currentIndex = 0
249
- return true
250
- }
251
- return false
251
+ return .tracksOnly
252
+ }
253
+
254
+ /// The queue was empty: `index` becomes the current track AND leads the
255
+ /// shuffle order. One operation because the two must not be separable —
256
+ /// forgetting the second half is the bug this exists to prevent.
257
+ ///
258
+ /// `insert(at:count:)` drops new indices at *random* shuffle positions, so
259
+ /// without the pin the starting track can land last in the order, which reads
260
+ /// as `isLastInPlaybackOrder`: the queue "ends" (and fires
261
+ /// `playerDidEndQueue`) the moment the first track finishes. Pins
262
+ /// unconditionally, like `setQueue` — the order has to be sane whether or not
263
+ /// shuffle is on right now, since `shuffleEnabled`'s didSet only re-pins on
264
+ /// the off→on edge.
265
+ ///
266
+ /// Returns the change, so callers can `return adoptInitialCurrent(…)`.
267
+ private func adoptInitialCurrent(_ index: Int) -> QueueChange {
268
+ currentIndex = max(0, min(index, tracks.count - 1))
269
+ shuffleOrder = ShuffleOrder(length: tracks.count, firstIndex: currentIndex)
270
+ return .tracksAndCurrent
252
271
  }
253
272
 
254
- /// Remove a track from the queue.
255
- /// Returns `true` if the current track changed.
273
+ /// Remove a track from the queue. The current track changes when it is the one removed.
256
274
  @discardableResult
257
- func remove(_ index: Int) throws -> Bool {
275
+ func remove(_ index: Int) throws -> QueueChange {
258
276
  try throwIfQueueEmpty()
259
277
  try throwIfIndexInvalid(index: index)
260
278
  tracks.remove(at: index)
261
279
  shuffleOrder.remove(from: index, to: index + 1)
262
280
  if index == currentIndex {
263
281
  currentIndex = tracks.count > 0 ? currentIndex % tracks.count : -1
264
- return true
282
+ return .tracksAndCurrent
265
283
  } else if index < currentIndex {
266
284
  currentIndex -= 1
267
285
  }
268
- return false
286
+ return .tracksOnly
269
287
  }
270
288
 
271
- /// Move a track in the queue from one position to another.
272
- /// Returns `true` if the current track changed (fromIndex was currentIndex).
289
+ /// Move a track in the queue from one position to another. The current track never changes:
290
+ /// the pointer follows the playing track.
273
291
  @discardableResult
274
- func move(fromIndex: Int, toIndex: Int) throws -> Bool {
292
+ func move(fromIndex: Int, toIndex: Int) throws -> QueueChange {
275
293
  try throwIfQueueEmpty()
276
294
  try throwIfIndexInvalid(index: fromIndex, name: "fromIndex")
277
295
  try throwIfIndexInvalid(index: toIndex, name: "toIndex", max: Int.max)
278
- // Mutate a copy and assign once to trigger didSet only once
279
- var newTracks = tracks
280
- let track = newTracks.remove(at: fromIndex)
281
- let insertion = min(newTracks.count, toIndex)
282
- newTracks.insert(track, at: insertion)
283
- tracks = newTracks
296
+ let track = tracks.remove(at: fromIndex)
297
+ let insertion = min(tracks.count, toIndex)
298
+ tracks.insert(track, at: insertion)
299
+ // Carry the moved track's shuffle position across the move. `insert(at:count:)`
300
+ // would drop it at a RANDOM position instead — reordering the queue would then
301
+ // silently reorder shuffled playback, and moving the playing track could land it
302
+ // last in the order, ending the queue at the next track boundary with tracks
303
+ // still unplayed (the failure `adoptInitialCurrent` guards against elsewhere).
304
+ // `remove` shifts every later position down by one, so re-inserting at the
305
+ // captured position restores the exact prior order.
306
+ let shufflePosition = shuffleOrder.shufflePosition(of: fromIndex)
284
307
  shuffleOrder.remove(from: fromIndex, to: fromIndex + 1)
285
- shuffleOrder.insert(at: insertion, count: 1)
286
- // The pointer follows the playing track; its identity never changes on a
287
- // move, so no caller needs to reload (returning true reloads).
308
+ shuffleOrder.insert(
309
+ at: insertion, atShufflePosition: shufflePosition ?? shuffleOrder.count,
310
+ )
288
311
  if currentIndex == fromIndex {
289
312
  currentIndex = insertion
290
313
  } else if fromIndex < currentIndex, insertion >= currentIndex {
@@ -292,35 +315,38 @@ class QueueManager {
292
315
  } else if fromIndex > currentIndex, insertion <= currentIndex {
293
316
  currentIndex += 1
294
317
  }
295
- return false
318
+ return .tracksOnly
296
319
  }
297
320
 
298
- /// Remove all tracks and reset state.
299
- /// Returns `true` if there was a current track to clear.
321
+ /// Remove all tracks and reset state. Does nothing when there is no current track.
300
322
  @discardableResult
301
- func clear() -> Bool {
302
- guard currentIndex != -1 else { return false }
323
+ func clear() -> QueueChange {
324
+ guard currentIndex != -1 else { return .none }
303
325
  currentIndex = -1
304
326
  tracks.removeAll()
305
327
  shuffleOrder.clear()
306
328
  queueSourcePath = nil
307
- return true
329
+ return .tracksAndCurrent
308
330
  }
309
331
 
310
- // MARK: - Other Mutations
311
-
312
- /// Replace the track at a specific index.
313
- func replace(_ index: Int, _ track: Track) {
332
+ /// Replace the track at a specific index; which index is current does not change.
333
+ /// Throws like every other index-taking mutation here, rather than trapping.
334
+ @discardableResult
335
+ func replace(_ index: Int, _ track: Track) throws -> QueueChange {
336
+ try throwIfIndexInvalid(index: index)
314
337
  tracks[index] = track
338
+ return .tracksOnly
315
339
  }
316
340
 
317
341
  /// Remove all upcoming tracks (those after currentIndex).
318
- func removeUpcomingTracks() {
319
- guard !tracks.isEmpty else { return }
342
+ @discardableResult
343
+ func removeUpcomingTracks() -> QueueChange {
344
+ guard !tracks.isEmpty else { return .none }
320
345
  let nextIndex = currentIndex + 1
321
- guard nextIndex < tracks.count else { return }
346
+ guard nextIndex < tracks.count else { return .none }
322
347
  let end = tracks.count
323
348
  tracks.removeSubrange(nextIndex ..< end)
324
349
  shuffleOrder.remove(from: nextIndex, to: end)
350
+ return .tracksOnly
325
351
  }
326
352
  }