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

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 (1037) hide show
  1. package/README.md +37 -23
  2. package/android/build.gradle +43 -15
  3. package/android/gradle.properties +3 -3
  4. package/android/src/main/AndroidManifest.xml +3 -1
  5. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +550 -283
  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/RemoteOutputs.kt +128 -0
  10. package/android/src/main/java/com/audiobrowser/Service.kt +41 -11
  11. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +52 -0
  12. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +23 -10
  13. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +315 -213
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +31 -23
  15. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +288 -0
  16. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +97 -58
  17. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +70 -29
  18. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +60 -0
  19. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -7
  20. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +20 -0
  21. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +15 -0
  22. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +20 -3
  23. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +4 -5
  24. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +24 -0
  25. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +10 -6
  26. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +7 -0
  27. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +1 -1
  28. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +77 -0
  29. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +63 -0
  30. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +34 -12
  31. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +639 -278
  32. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +85 -33
  33. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +88 -44
  34. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +26 -14
  35. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +113 -78
  36. package/android/src/main/java/com/audiobrowser/player/Player.kt +180 -84
  37. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  38. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +2 -1
  39. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +16 -4
  40. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +2 -1
  41. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +30 -0
  42. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +67 -11
  43. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +168 -0
  44. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +58 -14
  45. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +35 -7
  46. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +278 -59
  47. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  48. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +7 -9
  49. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +15 -0
  50. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +61 -40
  51. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +28 -23
  52. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -1
  53. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +24 -49
  54. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +22 -1
  55. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -5
  56. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +2 -2
  57. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  58. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +103 -67
  59. package/android/src/main/res/values/strings.xml +25 -5
  60. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +152 -0
  61. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +103 -0
  62. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +22 -0
  63. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +101 -0
  64. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +159 -0
  65. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -34
  66. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +153 -0
  67. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +15 -0
  68. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +346 -8
  69. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +70 -5
  70. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +301 -0
  71. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +3 -2
  72. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +168 -0
  73. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +128 -55
  74. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +160 -0
  75. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +43 -0
  76. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +41 -0
  77. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  78. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +477 -0
  79. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +1 -2
  80. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +94 -0
  81. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  82. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +138 -0
  83. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +71 -0
  84. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +212 -2
  85. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +3 -4
  86. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +48 -16
  87. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +55 -0
  88. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +67 -0
  89. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +92 -0
  90. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +192 -0
  91. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +3 -3
  92. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +79 -0
  93. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +151 -0
  94. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +197 -7
  95. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +325 -4
  96. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +322 -0
  97. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +83 -0
  98. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +55 -16
  99. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +162 -0
  100. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +99 -0
  101. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +95 -0
  102. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -6
  103. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +7 -7
  104. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  105. package/ios/AVPlayerEngine.swift +362 -0
  106. package/ios/AVPlayerEngineCallbacks.swift +14 -0
  107. package/ios/Browser/BrowseGate.swift +58 -0
  108. package/ios/Browser/BrowserConfig.swift +115 -81
  109. package/ios/Browser/BrowserError.swift +16 -0
  110. package/ios/Browser/BrowserManager.swift +155 -654
  111. package/ios/Browser/BrowserPathHelper.swift +68 -51
  112. package/ios/Browser/FavoriteSet.swift +46 -0
  113. package/ios/Browser/InertStyleDiagnostic.swift +296 -0
  114. package/ios/Browser/JsonModels.swift +270 -321
  115. package/ios/Browser/NavigationErrorState.swift +41 -0
  116. package/ios/Browser/PageResolver.swift +147 -0
  117. package/ios/Browser/RequestLayer.swift +185 -0
  118. package/ios/Browser/RequestPipeline.swift +303 -0
  119. package/ios/Browser/SearchDrillIn.swift +7 -7
  120. package/ios/Browser/SectionScope.swift +82 -23
  121. package/ios/Browser/SimpleRouter.swift +73 -144
  122. package/ios/Browser/StyleResolver.swift +58 -0
  123. package/ios/Browser/TabBarEntries.swift +9 -3
  124. package/ios/Browser/TrackIdTemplate.swift +37 -0
  125. package/ios/CarPlay/CPInterfaceController+Safe.swift +93 -43
  126. package/ios/CarPlay/CarPlayArtworkResolver.swift +36 -83
  127. package/ios/CarPlay/CarPlayController.swift +37 -1297
  128. package/ios/CarPlay/CarPlayImageLoader.swift +91 -163
  129. package/ios/CarPlay/CarPlayListItemFactory.swift +288 -102
  130. package/ios/CarPlay/CarPlayNowPlayingManager.swift +137 -177
  131. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  132. package/ios/CarPlay/CarPlaySession+PageLoader.swift +91 -0
  133. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  134. package/ios/CarPlay/CarPlaySession+TabBar.swift +192 -0
  135. package/ios/CarPlay/CarPlaySession.swift +207 -0
  136. package/ios/CarPlay/CarPlayTemplates.swift +63 -0
  137. package/ios/CarPlay/IntentHandlers.swift +96 -0
  138. package/ios/CarPlay/MediaIntentCriteria.swift +105 -0
  139. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +21 -25
  140. package/ios/CarPlay/MediaIntentPlayback.swift +74 -0
  141. package/ios/CarPlay/NowPlayingButtonRules.swift +35 -0
  142. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  143. package/ios/CarPlay/SectionPresentation.swift +77 -0
  144. package/ios/CarPlay/TopTemplateReplacer.swift +96 -0
  145. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  146. package/ios/Extension/NavigationError+Conversion.swift +14 -4
  147. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -15
  148. package/ios/Extension/ResolvedTrack+Copying.swift +13 -15
  149. package/ios/Extension/SearchParams+Query.swift +28 -0
  150. package/ios/Extension/Section+Copying.swift +29 -0
  151. package/ios/Extension/String+IcyCharset.swift +21 -0
  152. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -4
  153. package/ios/Extension/Track+AVPlayer.swift +0 -16
  154. package/ios/Extension/Track+Copying.swift +11 -13
  155. package/ios/Extension/Track+Identity.swift +25 -0
  156. package/ios/Extension/UIApplication+ActiveScene.swift +27 -0
  157. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  158. package/ios/Extension/URLError+Connectivity.swift +15 -0
  159. package/ios/Http/HttpClient.swift +71 -165
  160. package/ios/HybridAudioBrowser+Browser.swift +136 -0
  161. package/ios/HybridAudioBrowser+Options.swift +105 -0
  162. package/ios/HybridAudioBrowser+Player.swift +341 -0
  163. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +157 -0
  164. package/ios/HybridAudioBrowser+Stubs.swift +46 -0
  165. package/ios/HybridAudioBrowser.swift +131 -1652
  166. package/ios/Model/NitroTypeStubs.swift +239 -24
  167. package/ios/Model/PlayerUpdateOptions.swift +10 -1
  168. package/ios/Model/RemoteCommand.swift +6 -60
  169. package/ios/Model/TrackPlayerError.swift +6 -2
  170. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +18 -53
  171. package/ios/Observer/ItemObserver.swift +90 -0
  172. package/ios/Observer/PlayerObserver.swift +59 -0
  173. package/ios/Option/SessionCategories.swift +42 -92
  174. package/ios/Player/AudioSessionController.swift +191 -0
  175. package/ios/Player/DeferredSeek.swift +70 -0
  176. package/ios/Player/ErrorStatus.swift +50 -0
  177. package/ios/Player/MediaLoader.swift +66 -87
  178. package/ios/Player/NowPlayingLines.swift +52 -0
  179. package/ios/Player/NowPlayingUpdater.swift +182 -85
  180. package/ios/Player/PlaybackFailure.swift +125 -0
  181. package/ios/Player/PlaybackPersistence.swift +73 -0
  182. package/ios/Player/PlaybackTimer.swift +8 -2
  183. package/ios/Player/Player.swift +975 -0
  184. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  185. package/ios/Player/PlayerEngine.swift +104 -0
  186. package/ios/Player/PlayerStatusTypes.swift +2 -6
  187. package/ios/Player/QueueManager.swift +93 -67
  188. package/ios/Player/RetryLoop.swift +291 -0
  189. package/ios/Player/ShuffleOrder.swift +33 -0
  190. package/ios/Player/SleepTimerManager.swift +14 -16
  191. package/ios/Player/VolumeFader.swift +5 -0
  192. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +43 -0
  193. package/ios/RemoteCommand/RemoteCommandController.swift +100 -333
  194. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  195. package/ios/Tests/BrowserPathHelperTests.swift +89 -15
  196. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  197. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  198. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  199. package/ios/Tests/DeferredSeekTests.swift +70 -0
  200. package/ios/Tests/EmitterTests.swift +22 -38
  201. package/ios/Tests/ErrorStatusTests.swift +50 -0
  202. package/ios/Tests/FavoriteSetTests.swift +60 -0
  203. package/ios/Tests/GenerationMemoTests.swift +121 -0
  204. package/ios/Tests/InertStyleDiagnosticTests.swift +209 -0
  205. package/ios/Tests/JsonModelsTests.swift +194 -1
  206. package/ios/Tests/LRUCacheTests.swift +110 -0
  207. package/ios/Tests/MediaIntentCriteriaTests.swift +57 -46
  208. package/ios/Tests/MediaLoaderTests.swift +36 -67
  209. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  210. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  211. package/ios/Tests/ObserverTests.swift +88 -0
  212. package/ios/Tests/PlaybackErrorTests.swift +76 -0
  213. package/ios/Tests/PlaybackFailureTests.swift +189 -0
  214. package/ios/Tests/PlaybackPersistenceTests.swift +93 -0
  215. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  216. package/ios/Tests/PlayerPolicyTests.swift +460 -0
  217. package/ios/Tests/{PlaybackCoordinatorTests.swift → PlayerTests.swift} +573 -395
  218. package/ios/Tests/PlayingStateTests.swift +42 -0
  219. package/ios/Tests/QueueManagerTests.swift +196 -115
  220. package/ios/Tests/ReadyValueTests.swift +73 -0
  221. package/ios/Tests/RemoteCommandControllerTests.swift +181 -0
  222. package/ios/Tests/RequestLayerTests.swift +228 -0
  223. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -35
  224. package/ios/Tests/RetryLoopTests.swift +305 -0
  225. package/ios/Tests/SearchDrillInTests.swift +16 -16
  226. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  227. package/ios/Tests/SectionPresentationTests.swift +98 -0
  228. package/ios/Tests/SectionScopeTests.swift +139 -54
  229. package/ios/Tests/SimpleRouterTests.swift +38 -3
  230. package/ios/Tests/SleepTimerManagerTests.swift +65 -41
  231. package/ios/Tests/StyleResolverTests.swift +132 -0
  232. package/ios/Tests/Support/TestTypes.swift +146 -101
  233. package/ios/Tests/TabBarEntriesTests.swift +19 -19
  234. package/ios/Tests/TimedMetadataAVFoundationTests.swift +42 -0
  235. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  236. package/ios/Tests/TrackIdTemplateTests.swift +67 -0
  237. package/ios/Tests/TrackIdentityTests.swift +20 -0
  238. package/ios/Tests/TrackSelectorTests.swift +168 -33
  239. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  240. package/ios/TrackSelector.swift +62 -65
  241. package/ios/Util/ArtworkFreshness.swift +42 -0
  242. package/ios/Util/ArtworkImageFetcher.swift +143 -5
  243. package/ios/Util/ConcurrentMap.swift +19 -0
  244. package/ios/Util/Emitter.swift +40 -12
  245. package/ios/Util/GenerationMemo.swift +36 -0
  246. package/ios/Util/LRUCache.swift +23 -159
  247. package/ios/Util/NetworkMonitor.swift +32 -32
  248. package/ios/Util/OutputPicker.swift +48 -0
  249. package/ios/Util/ReadyValue.swift +56 -0
  250. package/ios/Util/SFSymbolRenderer.swift +59 -31
  251. package/ios/Util/SVGProcessor.swift +9 -12
  252. package/lib/commonjs/AudioBrowser.js +8 -8
  253. package/lib/commonjs/AudioBrowser.js.map +1 -1
  254. package/lib/commonjs/CLAUDE.md +52 -0
  255. package/lib/commonjs/features/browser-config.js +12 -8
  256. package/lib/commonjs/features/browser-config.js.map +1 -1
  257. package/lib/commonjs/features/browser.js +11 -3
  258. package/lib/commonjs/features/browser.js.map +1 -1
  259. package/lib/commonjs/features/carConnection.js +1 -1
  260. package/lib/commonjs/features/equalizer.js +1 -1
  261. package/lib/commonjs/features/errors.js +3 -3
  262. package/lib/commonjs/features/favorites.js +14 -11
  263. package/lib/commonjs/features/favorites.js.map +1 -1
  264. package/lib/commonjs/features/gate.js +16 -1
  265. package/lib/commonjs/features/gate.js.map +1 -1
  266. package/lib/commonjs/features/metadata.js +20 -3
  267. package/lib/commonjs/features/metadata.js.map +1 -1
  268. package/lib/commonjs/features/network.js +1 -1
  269. package/lib/commonjs/features/nowPlaying.js +1 -1
  270. package/lib/commonjs/features/output.js +4 -3
  271. package/lib/commonjs/features/output.js.map +1 -1
  272. package/lib/commonjs/features/playback/controls.js +4 -2
  273. package/lib/commonjs/features/playback/controls.js.map +1 -1
  274. package/lib/commonjs/features/playback/playWhenReady.js +1 -1
  275. package/lib/commonjs/features/playback/playing.js +1 -1
  276. package/lib/commonjs/features/playback/progress.js +3 -2
  277. package/lib/commonjs/features/playback/progress.js.map +1 -1
  278. package/lib/commonjs/features/playback/rate.js +8 -1
  279. package/lib/commonjs/features/playback/rate.js.map +1 -1
  280. package/lib/commonjs/features/playback/state.js +3 -4
  281. package/lib/commonjs/features/playback/state.js.map +1 -1
  282. package/lib/commonjs/features/playback/trackPlaybackTime.js +0 -6
  283. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  284. package/lib/commonjs/features/playback/volume.js +1 -1
  285. package/lib/commonjs/features/player/options.js +3 -19
  286. package/lib/commonjs/features/player/options.js.map +1 -1
  287. package/lib/commonjs/features/player/setup.js +5 -3
  288. package/lib/commonjs/features/player/setup.js.map +1 -1
  289. package/lib/commonjs/features/player/validateOptions.js +23 -0
  290. package/lib/commonjs/features/player/validateOptions.js.map +1 -0
  291. package/lib/commonjs/features/queue/activeTrack.js +15 -4
  292. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  293. package/lib/commonjs/features/queue/queue.js +13 -6
  294. package/lib/commonjs/features/queue/queue.js.map +1 -1
  295. package/lib/commonjs/features/queue/repeatMode.js +1 -1
  296. package/lib/commonjs/features/queue/shuffle.js +1 -1
  297. package/lib/commonjs/features/remoteControls.js +13 -92
  298. package/lib/commonjs/features/remoteControls.js.map +1 -1
  299. package/lib/commonjs/features/sleepTimer.js +13 -1
  300. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  301. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  302. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  303. package/lib/commonjs/utils/LazyNativeEmitter.js +28 -14
  304. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  305. package/lib/commonjs/utils/NativeUpdatedValue.js +31 -13
  306. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  307. package/lib/commonjs/utils/getTrackIdentity.js +24 -0
  308. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  309. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +33 -0
  310. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  311. package/lib/commonjs/web/NativeAudioBrowser.js +202 -77
  312. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  313. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  314. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  315. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  316. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  317. package/lib/commonjs/web/TrackPlayer/Player.js +254 -39
  318. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  319. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  320. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  321. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  322. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +33 -12
  323. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  324. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  325. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  326. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  327. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  328. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  329. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  330. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  331. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  332. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  333. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  334. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  335. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  336. package/lib/commonjs/web/browser/sections.js +89 -0
  337. package/lib/commonjs/web/browser/sections.js.map +1 -0
  338. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  339. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  340. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  341. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  342. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  343. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  344. package/lib/commonjs/web/util/BrowserPathHelper.js +62 -11
  345. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  346. package/lib/module/AudioBrowser.js +2 -1
  347. package/lib/module/AudioBrowser.js.map +1 -1
  348. package/lib/module/CLAUDE.md +52 -0
  349. package/lib/module/features/browser-config.js +12 -8
  350. package/lib/module/features/browser-config.js.map +1 -1
  351. package/lib/module/features/browser.js +11 -3
  352. package/lib/module/features/browser.js.map +1 -1
  353. package/lib/module/features/carConnection.js +1 -1
  354. package/lib/module/features/equalizer.js +1 -1
  355. package/lib/module/features/errors.js +3 -3
  356. package/lib/module/features/favorites.js +14 -11
  357. package/lib/module/features/favorites.js.map +1 -1
  358. package/lib/module/features/gate.js +16 -1
  359. package/lib/module/features/gate.js.map +1 -1
  360. package/lib/module/features/metadata.js +20 -3
  361. package/lib/module/features/metadata.js.map +1 -1
  362. package/lib/module/features/network.js +1 -1
  363. package/lib/module/features/nowPlaying.js +1 -1
  364. package/lib/module/features/output.js +4 -3
  365. package/lib/module/features/output.js.map +1 -1
  366. package/lib/module/features/playback/controls.js +4 -2
  367. package/lib/module/features/playback/controls.js.map +1 -1
  368. package/lib/module/features/playback/playWhenReady.js +1 -1
  369. package/lib/module/features/playback/playing.js +1 -1
  370. package/lib/module/features/playback/progress.js +3 -2
  371. package/lib/module/features/playback/progress.js.map +1 -1
  372. package/lib/module/features/playback/rate.js +8 -1
  373. package/lib/module/features/playback/rate.js.map +1 -1
  374. package/lib/module/features/playback/state.js +3 -4
  375. package/lib/module/features/playback/state.js.map +1 -1
  376. package/lib/module/features/playback/trackPlaybackTime.js +0 -5
  377. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  378. package/lib/module/features/playback/volume.js +1 -1
  379. package/lib/module/features/player/options.js +2 -17
  380. package/lib/module/features/player/options.js.map +1 -1
  381. package/lib/module/features/player/setup.js +4 -2
  382. package/lib/module/features/player/setup.js.map +1 -1
  383. package/lib/module/features/player/validateOptions.js +19 -0
  384. package/lib/module/features/player/validateOptions.js.map +1 -0
  385. package/lib/module/features/queue/activeTrack.js +15 -4
  386. package/lib/module/features/queue/activeTrack.js.map +1 -1
  387. package/lib/module/features/queue/queue.js +13 -6
  388. package/lib/module/features/queue/queue.js.map +1 -1
  389. package/lib/module/features/queue/repeatMode.js +1 -1
  390. package/lib/module/features/queue/shuffle.js +1 -1
  391. package/lib/module/features/remoteControls.js +13 -92
  392. package/lib/module/features/remoteControls.js.map +1 -1
  393. package/lib/module/features/sleepTimer.js +13 -1
  394. package/lib/module/features/sleepTimer.js.map +1 -1
  395. package/lib/module/test-utils/reactNativeStub.js +58 -0
  396. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  397. package/lib/module/utils/LazyNativeEmitter.js +28 -14
  398. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  399. package/lib/module/utils/NativeUpdatedValue.js +31 -13
  400. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  401. package/lib/module/utils/getTrackIdentity.js +20 -0
  402. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  403. package/lib/module/utils/useNativeValueRefreshedBy.js +29 -0
  404. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  405. package/lib/module/web/NativeAudioBrowser.js +202 -77
  406. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  407. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  408. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  409. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  410. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  411. package/lib/module/web/TrackPlayer/Player.js +254 -39
  412. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  413. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  414. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  415. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  416. package/lib/module/web/TrackPlayer/QueuePlayer.js +33 -12
  417. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  418. package/lib/module/web/browser/BrowserManager.js +175 -100
  419. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  420. package/lib/module/web/browser/FavoriteManager.js +31 -21
  421. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  422. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  423. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  424. package/lib/module/web/browser/SearchManager.js +18 -23
  425. package/lib/module/web/browser/SearchManager.js.map +1 -1
  426. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  427. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  428. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  429. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  430. package/lib/module/web/browser/sections.js +83 -0
  431. package/lib/module/web/browser/sections.js.map +1 -0
  432. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  433. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  434. package/lib/module/web/http/followMediaRedirect.js +215 -0
  435. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  436. package/lib/module/web/player/NowPlayingManager.js +4 -3
  437. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  438. package/lib/module/web/util/BrowserPathHelper.js +62 -11
  439. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  440. package/lib/typescript/package.json +1 -0
  441. package/lib/typescript/src/AudioBrowser.d.ts +1 -1
  442. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  443. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  444. package/lib/typescript/src/features/browser.d.ts +10 -2
  445. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  446. package/lib/typescript/src/features/carConnection.d.ts +1 -1
  447. package/lib/typescript/src/features/equalizer.d.ts +1 -1
  448. package/lib/typescript/src/features/errors.d.ts +3 -3
  449. package/lib/typescript/src/features/favorites.d.ts +14 -11
  450. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  451. package/lib/typescript/src/features/gate.d.ts +18 -2
  452. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  453. package/lib/typescript/src/features/metadata.d.ts +20 -3
  454. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  455. package/lib/typescript/src/features/network.d.ts +1 -1
  456. package/lib/typescript/src/features/nowPlaying.d.ts +1 -1
  457. package/lib/typescript/src/features/output.d.ts +4 -3
  458. package/lib/typescript/src/features/output.d.ts.map +1 -1
  459. package/lib/typescript/src/features/playback/controls.d.ts +4 -2
  460. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  461. package/lib/typescript/src/features/playback/playWhenReady.d.ts +1 -1
  462. package/lib/typescript/src/features/playback/playing.d.ts +1 -1
  463. package/lib/typescript/src/features/playback/progress.d.ts +1 -1
  464. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  465. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  466. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  467. package/lib/typescript/src/features/playback/state.d.ts +3 -4
  468. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  469. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +1 -1
  470. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  471. package/lib/typescript/src/features/playback/volume.d.ts +1 -1
  472. package/lib/typescript/src/features/player/options.d.ts +24 -21
  473. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  474. package/lib/typescript/src/features/player/setup.d.ts +16 -1
  475. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  476. package/lib/typescript/src/features/player/validateOptions.d.ts +2 -0
  477. package/lib/typescript/src/features/player/validateOptions.d.ts.map +1 -0
  478. package/lib/typescript/src/features/queue/activeTrack.d.ts +9 -2
  479. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  480. package/lib/typescript/src/features/queue/queue.d.ts +7 -4
  481. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  482. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  483. package/lib/typescript/src/features/queue/shuffle.d.ts +1 -1
  484. package/lib/typescript/src/features/remoteControls.d.ts +23 -22
  485. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  486. package/lib/typescript/src/features/sleepTimer.d.ts +1 -1
  487. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  488. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  489. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  490. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  491. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  492. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  493. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  494. package/lib/typescript/src/types/browser-nodes.d.ts +387 -126
  495. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  496. package/lib/typescript/src/types/browser.d.ts +93 -61
  497. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  498. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +19 -16
  499. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  500. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +24 -19
  501. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  502. package/lib/typescript/src/utils/getTrackIdentity.d.ts +18 -0
  503. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  504. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  505. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  506. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +21 -0
  507. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  508. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  509. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  510. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  511. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  512. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  513. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  514. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  515. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  516. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  517. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  518. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  519. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  520. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  521. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  522. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  523. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  524. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  525. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  526. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  527. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  528. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  529. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  530. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  531. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  532. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  533. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  534. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  535. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  536. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  537. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  538. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  539. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  540. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  541. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  542. 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
  543. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  544. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  545. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  546. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  547. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  548. 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
  549. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  550. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  551. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  552. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  553. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  554. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  555. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  556. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  557. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  558. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  559. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  560. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  561. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  562. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  563. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  564. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  565. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  566. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  567. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  568. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  569. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  570. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  571. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  572. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  573. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  574. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  575. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  576. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  577. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  578. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  579. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  580. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  581. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  582. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  583. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  584. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  585. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  586. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  587. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  588. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  589. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +68 -44
  590. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +3 -3
  591. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  592. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  593. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  594. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  595. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  596. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  597. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  598. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  599. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  600. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  601. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  602. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  603. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  604. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  605. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  606. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  607. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  608. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +19 -12
  609. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  610. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  611. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  612. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  613. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  614. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  615. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  616. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  617. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  618. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  619. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  620. package/nitrogen/generated/android/c++/JOutputType.hpp +5 -2
  621. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  622. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  623. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  624. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  625. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  626. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  627. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  628. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  629. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  630. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  631. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  632. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  633. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  634. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  635. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  636. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  637. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  638. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  639. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  640. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  641. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  642. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  643. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  644. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  645. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  646. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  647. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  648. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  649. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  650. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  651. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  652. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  653. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  654. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  655. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  656. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  657. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +18 -12
  658. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  659. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  660. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  661. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  662. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  663. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  664. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  665. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  666. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  667. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  668. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  669. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  670. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  671. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  672. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  673. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  674. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  675. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  676. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  677. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  678. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  679. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  680. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  681. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  682. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  683. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  684. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  685. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  686. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  687. 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
  688. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  689. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  690. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  691. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  692. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  693. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  694. 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
  695. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  696. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  697. 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
  698. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  699. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  700. 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
  701. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  702. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  703. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  704. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  705. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  706. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  707. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  708. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  709. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  710. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  711. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  712. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  713. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  714. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  715. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  716. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  717. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  718. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  719. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  720. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  721. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  722. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  723. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  724. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  725. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  726. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  727. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  728. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  729. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  730. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  731. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  732. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  733. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  734. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  735. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  736. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  737. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  738. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  739. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +3 -1
  740. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  741. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  742. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  743. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  744. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  745. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  746. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  747. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  748. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  749. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  750. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  751. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  752. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  753. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  754. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  755. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  756. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  757. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  758. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  759. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  760. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  761. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  762. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  763. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +2 -1
  764. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  765. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  766. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  767. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  768. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  769. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  770. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  771. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  772. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  773. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  774. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  775. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  776. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  777. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  778. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  779. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  780. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  781. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  782. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  783. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  784. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  785. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  786. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  787. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  788. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  789. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  790. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  791. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  792. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  793. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  794. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +17 -0
  795. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  796. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  797. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  798. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  799. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  800. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  801. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  802. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  803. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  804. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  805. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  806. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  807. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +767 -638
  808. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +28 -10
  809. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +30 -12
  810. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  811. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  812. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  813. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  814. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  815. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  816. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  817. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +1 -1
  818. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +2 -2
  819. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  820. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  821. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  822. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +19 -1
  823. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  824. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  825. package/nitrogen/generated/ios/swift/OutputType.swift +4 -0
  826. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  827. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  828. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  829. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  830. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  831. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  832. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  833. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  834. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  835. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  836. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  837. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  838. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  839. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  840. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  841. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  842. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  843. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  844. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  845. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +1 -1
  846. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +1 -1
  847. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  848. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  849. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  850. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +6 -2
  851. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  852. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  853. package/nitrogen/generated/shared/c++/OutputType.hpp +5 -1
  854. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  855. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  856. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  857. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  858. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  859. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  860. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  861. package/package.json +24 -11
  862. package/src/AudioBrowser.ts +2 -1
  863. package/src/CLAUDE.md +52 -0
  864. package/src/features/battery.test.ts +79 -0
  865. package/src/features/browser-config.test.ts +21 -6
  866. package/src/features/browser-config.ts +12 -8
  867. package/src/features/browser.test.ts +1 -1
  868. package/src/features/browser.ts +11 -3
  869. package/src/features/carConnection.ts +1 -1
  870. package/src/features/equalizer.ts +1 -1
  871. package/src/features/errors.ts +3 -3
  872. package/src/features/favorites.ts +14 -11
  873. package/src/features/gate.ts +16 -1
  874. package/src/features/hook-wiring.test.ts +302 -0
  875. package/src/features/metadata.ts +20 -3
  876. package/src/features/network.ts +1 -1
  877. package/src/features/nowPlaying.ts +1 -1
  878. package/src/features/output.ts +4 -3
  879. package/src/features/playback/controls.ts +4 -2
  880. package/src/features/playback/playWhenReady.ts +1 -1
  881. package/src/features/playback/playing.ts +1 -1
  882. package/src/features/playback/progress.test.ts +169 -0
  883. package/src/features/playback/progress.ts +3 -2
  884. package/src/features/playback/rate.ts +8 -1
  885. package/src/features/playback/state.ts +3 -4
  886. package/src/features/playback/trackPlaybackTime.test.ts +16 -6
  887. package/src/features/playback/trackPlaybackTime.ts +1 -6
  888. package/src/features/playback/volume.ts +1 -1
  889. package/src/features/player/options.ts +31 -40
  890. package/src/features/player/setup.test.ts +12 -3
  891. package/src/features/player/setup.ts +27 -5
  892. package/src/features/player/validateOptions.ts +21 -0
  893. package/src/features/queue/activeTrack.ts +15 -4
  894. package/src/features/queue/queue.ts +13 -6
  895. package/src/features/queue/repeatMode.ts +1 -1
  896. package/src/features/queue/shuffle.ts +1 -1
  897. package/src/features/remoteControls.ts +13 -92
  898. package/src/features/sleepTimer.test.ts +172 -0
  899. package/src/features/sleepTimer.ts +9 -1
  900. package/src/nitro-stub-drift.test.ts +277 -0
  901. package/src/public-surface.test.ts +147 -0
  902. package/src/specs/audio-browser.nitro.ts +9 -8
  903. package/src/style-resolution.test.ts +210 -0
  904. package/src/test-utils/reactNativeStub.ts +60 -0
  905. package/src/types/browser-native.ts +7 -3
  906. package/src/types/browser-nodes.ts +403 -134
  907. package/src/types/browser.ts +97 -63
  908. package/src/utils/LazyNativeEmitter.ts +28 -15
  909. package/src/utils/NativeUpdatedValue.ts +29 -13
  910. package/src/utils/getTrackIdentity.ts +20 -0
  911. package/src/utils/useDebug.test.ts +182 -0
  912. package/src/utils/useNativeUpdatedValue.test.ts +103 -0
  913. package/src/utils/useNativeValueRefreshedBy.ts +38 -0
  914. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  915. package/src/web/NativeAudioBrowser.ts +241 -84
  916. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  917. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  918. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  919. package/src/web/TrackPlayer/Player.dispatch.test.ts +5 -3
  920. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  921. package/src/web/TrackPlayer/Player.ts +284 -37
  922. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  923. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  924. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  925. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  926. package/src/web/TrackPlayer/QueuePlayer.ts +33 -14
  927. package/src/web/__tests__/lifecycle.test.ts +345 -0
  928. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  929. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  930. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  931. package/src/web/__tests__/retry.test.ts +169 -0
  932. package/src/web/browser/BrowserManager.ts +209 -111
  933. package/src/web/browser/FavoriteManager.test.ts +84 -0
  934. package/src/web/browser/FavoriteManager.ts +28 -23
  935. package/src/web/browser/NavigationErrorManager.ts +3 -1
  936. package/src/web/browser/SearchManager.test.ts +75 -0
  937. package/src/web/browser/SearchManager.ts +25 -28
  938. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  939. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  940. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  941. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  942. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  943. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  944. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  945. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  946. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  947. package/src/web/browser/sections.test.ts +91 -0
  948. package/src/web/browser/sections.ts +72 -0
  949. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  950. package/src/web/http/RequestConfigBuilder.ts +140 -33
  951. package/src/web/http/followMediaRedirect.test.ts +289 -0
  952. package/src/web/http/followMediaRedirect.ts +253 -0
  953. package/src/web/player/NowPlayingManager.ts +4 -3
  954. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  955. package/src/web/util/BrowserPathHelper.ts +70 -13
  956. package/website/guide/android-auto.md +114 -0
  957. package/website/guide/android-certificates.md +409 -0
  958. package/website/guide/artwork.md +255 -0
  959. package/website/guide/audio-output.md +158 -0
  960. package/website/guide/automotive.md +86 -0
  961. package/website/guide/basic-usage.md +151 -0
  962. package/website/guide/battery.md +115 -0
  963. package/website/guide/browser.md +587 -0
  964. package/website/guide/carplay.md +650 -0
  965. package/website/guide/configuration.md +173 -0
  966. package/website/guide/equalizer.md +231 -0
  967. package/website/guide/errors.md +310 -0
  968. package/website/guide/favorites.md +154 -0
  969. package/website/guide/gate.md +143 -0
  970. package/website/guide/getting-started.md +46 -0
  971. package/website/guide/hooks.md +238 -0
  972. package/website/guide/live-streams.md +125 -0
  973. package/website/guide/metadata.md +239 -0
  974. package/website/guide/migrating-from-track-player.md +244 -0
  975. package/website/guide/native-callback-fetch.md +127 -0
  976. package/website/guide/network.md +86 -0
  977. package/website/guide/now-playing.md +175 -0
  978. package/website/guide/playback.md +328 -0
  979. package/website/guide/queue.md +300 -0
  980. package/website/guide/remote-controls.md +256 -0
  981. package/website/guide/search.md +255 -0
  982. package/website/guide/sleep-timer.md +268 -0
  983. package/website/guide/track.md +247 -0
  984. package/ios/Bridge.h +0 -8
  985. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  986. package/ios/Browser/MediaResolveComposer.swift +0 -114
  987. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  988. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  989. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  990. package/ios/Model/MediaURL.swift +0 -67
  991. package/ios/Model/SourceType.swift +0 -6
  992. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  993. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  994. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  995. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  996. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  997. package/ios/Observer/PlayerStateObserver.swift +0 -50
  998. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  999. package/ios/Option/PitchAlgorithms.swift +0 -17
  1000. package/ios/Option/TimeEventFrequency.swift +0 -18
  1001. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1002. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1003. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1004. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1005. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1006. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1007. package/ios/Player/PlaybackStateStore.swift +0 -27
  1008. package/ios/Player/PlayingStateManager.swift +0 -33
  1009. package/ios/Player/RetryManager.swift +0 -322
  1010. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1011. package/ios/Player/SleepTimerHandling.swift +0 -15
  1012. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1013. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -325
  1014. package/ios/Tests/MediaResolveTests.swift +0 -126
  1015. package/ios/Tests/OnceValueTests.swift +0 -79
  1016. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1017. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1018. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1019. package/ios/Tests/RetryManagerTests.swift +0 -89
  1020. package/ios/TrackPlayer.swift +0 -1014
  1021. package/ios/TrackPlayerCallbacks.swift +0 -86
  1022. package/ios/Util/MetadataAdapter.swift +0 -131
  1023. package/ios/Util/OnceValue.swift +0 -104
  1024. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1025. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1026. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1027. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1028. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1029. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1030. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1031. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1032. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1033. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1034. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1035. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1036. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1037. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,20 +2,26 @@ package com.audiobrowser.util
2
2
 
3
3
  import android.net.Uri
4
4
  import androidx.core.net.toUri
5
+ import com.margelo.nitro.audiobrowser.NavigationErrorKind
5
6
  import java.net.URLEncoder
6
7
 
7
8
  /**
8
9
  * Utility for handling browser paths and contextual URLs in the media browser system.
9
10
  *
10
11
  * Handles two types of special paths:
11
- * 1. System paths (prefixed with `/__`): Root, recent, and search paths
12
+ * 1. System paths (prefixed with `/__`): root, search, offline, error, gate, and empty paths
12
13
  * 2. Contextual URLs: Embed parent context in track identifiers for Media3 integration
13
14
  *
14
- * Contextual URL format: `{parentPath}?__trackId={trackSrc}` Example:
15
- * "/library/radio?__trackId=song.mp3"
15
+ * Contextual URL format: `{parentPath}?__trackId={trackIdentity}&__index={childIndex}` (the
16
+ * identity is the track's `id` when non-blank, else its `src`) Example:
17
+ * "/library/radio?__trackId=song.mp3&__index=2"
18
+ *
19
+ * `__trackId` is the identity check; `__index` (the child's position on the page at stamp time) is
20
+ * only a tie-breaker between surfaces that carry the same identity — a stale index never selects a
21
+ * different track.
16
22
  *
17
23
  * This allows:
18
- * - Media3 to reference playable-only tracks (tracks with `src` but no `url`)
24
+ * - Media3 to reference playable-only tracks (tracks with `src` but no `path`)
19
25
  * - Cache lookup to work consistently
20
26
  * - Parent context to be preserved for queue restoration
21
27
  */
@@ -23,9 +29,6 @@ object BrowserPathHelper {
23
29
  /** Root path for media browsing */
24
30
  const val ROOT_PATH = "/__root"
25
31
 
26
- /** Recent media path for playback resumption */
27
- const val RECENT_PATH = "/__recent"
28
-
29
32
  /** Search path prefix (full path is /__search?q=query) */
30
33
  const val SEARCH_PATH_PREFIX = "/__search"
31
34
 
@@ -38,12 +41,31 @@ object BrowserPathHelper {
38
41
  /** Browse Gate placeholder media ID (subscription/login/region block) */
39
42
  const val GATE_PATH = "/__gate"
40
43
 
44
+ /** Empty-page placeholder media ID — a level that resolved with zero children (ADR 0001) */
45
+ const val EMPTY_PATH = "/__empty"
46
+
41
47
  // Query parameter name for contextual track identifiers
42
48
  private const val CONTEXTUAL_TRACK_PARAM = "__trackId"
43
49
 
50
+ // Query parameter name for the tapped child's page position (tie-breaker)
51
+ private const val CONTEXTUAL_INDEX_PARAM = "__index"
52
+
53
+ /** Whether a navigation error on this path came from a browse or a search */
54
+ fun navigationErrorKind(path: String): NavigationErrorKind =
55
+ if (path.startsWith("$SEARCH_PATH_PREFIX?")) NavigationErrorKind.SEARCH
56
+ else NavigationErrorKind.BROWSE
57
+
44
58
  /** Check if a path is a special system path (not a regular navigation path) */
45
59
  fun isSpecialPath(path: String): Boolean {
46
- return path == ROOT_PATH || path == RECENT_PATH || path.startsWith("$SEARCH_PATH_PREFIX?")
60
+ return path == ROOT_PATH || path.startsWith("$SEARCH_PATH_PREFIX?")
61
+ }
62
+
63
+ /**
64
+ * The tile sentinels a drill-in dead-ends on (see `deadEndChildren` for what they serve).
65
+ * [GATE_PATH] is not one of them — it re-serves the gate tile so the message stays readable.
66
+ */
67
+ fun isDeadEndPath(path: String): Boolean {
68
+ return path == OFFLINE_PATH || path == ERROR_PATH || path == EMPTY_PATH
47
69
  }
48
70
 
49
71
  /** Create a search path for a given query */
@@ -63,13 +85,13 @@ object BrowserPathHelper {
63
85
  }
64
86
 
65
87
  /**
66
- * Strips the __trackId parameter from a contextual URL to get the parent path. If the URL is not
67
- * contextual, returns it unchanged.
88
+ * Strips the contextual parameters (__trackId and __index) from a contextual URL to get the
89
+ * parent path. If the URL is not contextual, returns it unchanged.
68
90
  *
69
91
  * @param url The URL to process
70
- * @return The URL without the __trackId parameter
92
+ * @return The URL without the contextual parameters
71
93
  *
72
- * Example: "/library/radio?__trackId=song.mp3" → "/library/radio" Example:
94
+ * Example: "/library/radio?__trackId=song.mp3&__index=2" → "/library/radio" Example:
73
95
  * "/search?q=jazz&__trackId=song.mp3" → "/search?q=jazz"
74
96
  */
75
97
  fun stripTrackId(url: String): String {
@@ -79,13 +101,13 @@ object BrowserPathHelper {
79
101
 
80
102
  val uri = url.toUri()
81
103
 
82
- // Build URL preserving everything except __trackId parameter
104
+ // Build URL preserving everything except the contextual parameters
83
105
  val builder = uri.buildUpon()
84
106
  builder.clearQuery()
85
107
 
86
- // Re-add all query params except __trackId
108
+ // Re-add all query params except __trackId and __index
87
109
  uri.queryParameterNames.forEach { paramName ->
88
- if (paramName != CONTEXTUAL_TRACK_PARAM) {
110
+ if (paramName != CONTEXTUAL_TRACK_PARAM && paramName != CONTEXTUAL_INDEX_PARAM) {
89
111
  uri.getQueryParameters(paramName).forEach { value ->
90
112
  builder.appendQueryParameter(paramName, value)
91
113
  }
@@ -96,19 +118,21 @@ object BrowserPathHelper {
96
118
  }
97
119
 
98
120
  /**
99
- * Builds a contextual URL by appending a track identifier to a parent path. Handles existing
100
- * query parameters correctly.
121
+ * Builds a contextual URL by appending a track identifier — and optionally the tapped child's
122
+ * page position — to a parent path. Handles existing query parameters correctly.
101
123
  *
102
124
  * @param parentPath The parent container path
103
- * @param trackId The track identifier (typically the `src` value)
104
- * @return A contextual URL combining parent path and track ID
125
+ * @param trackId The track identity (`id` when non-blank, else `src` — see Track.identity)
126
+ * @param index The child's position on the page at stamp time (tie-breaker)
127
+ * @return A contextual URL combining parent path, track ID, and index
105
128
  *
106
- * Example: build("/library", "song.mp3") → "/library?__trackId=song.mp3" Example:
129
+ * Example: build("/library", "song.mp3", 2) → "/library?__trackId=song.mp3&__index=2" Example:
107
130
  * build("/search?q=jazz", "song.mp3") → "/search?q=jazz&__trackId=song.mp3"
108
131
  */
109
- fun build(parentPath: String, trackId: String): String {
132
+ fun build(parentPath: String, trackId: String, index: Int? = null): String {
110
133
  val separator = if (parentPath.contains('?')) '&' else '?'
111
- return "$parentPath$separator$CONTEXTUAL_TRACK_PARAM=${Uri.encode(trackId)}"
134
+ val indexParam = if (index != null) "&$CONTEXTUAL_INDEX_PARAM=$index" else ""
135
+ return "$parentPath$separator$CONTEXTUAL_TRACK_PARAM=${Uri.encode(trackId)}$indexParam"
112
136
  }
113
137
 
114
138
  /**
@@ -129,6 +153,21 @@ object BrowserPathHelper {
129
153
  return uri.getQueryParameter(CONTEXTUAL_TRACK_PARAM)
130
154
  }
131
155
 
156
+ /**
157
+ * Extracts the stamped page index from a contextual URL, or null when the URL is not contextual
158
+ * or carries no (valid, non-negative) index.
159
+ *
160
+ * Example: "/library/radio?__trackId=song.mp3&__index=2" → 2
161
+ */
162
+ fun extractIndex(path: String): Int? {
163
+ if (!isContextual(path)) {
164
+ return null
165
+ }
166
+
167
+ val raw = Uri.parse(path).getQueryParameter(CONTEXTUAL_INDEX_PARAM) ?: return null
168
+ return raw.toIntOrNull()?.takeIf { it >= 0 }
169
+ }
170
+
132
171
  /**
133
172
  * Combines a base URL with a path, ensuring proper slash handling.
134
173
  *
@@ -158,22 +197,4 @@ object BrowserPathHelper {
158
197
  val normalizedPath = path.trimStart('/')
159
198
  return "$normalizedBase$normalizedPath"
160
199
  }
161
-
162
- /**
163
- * True if [segment] appears in [path] as a complete path segment — bounded on the left by the
164
- * string start or `/`, and on the right by the string end or one of `/`, `?`, `#`.
165
- */
166
- fun containsSegment(path: String, segment: String): Boolean {
167
- if (segment.isEmpty()) return false
168
- var from = 0
169
- while (true) {
170
- val idx = path.indexOf(segment, from)
171
- if (idx < 0) return false
172
- val beforeOk = idx == 0 || path[idx - 1] == '/'
173
- val end = idx + segment.length
174
- val afterOk = end == path.length || path[end] == '/' || path[end] == '?' || path[end] == '#'
175
- if (beforeOk && afterOk) return true
176
- from = idx + 1
177
- }
178
- }
179
200
  }
@@ -2,30 +2,31 @@ package com.audiobrowser.util
2
2
 
3
3
  import android.os.Bundle
4
4
  import androidx.media.utils.MediaConstants
5
- import com.margelo.nitro.audiobrowser.ResolvedTrack
5
+ import com.margelo.nitro.audiobrowser.Section
6
+ import com.margelo.nitro.audiobrowser.StyleDisplay
6
7
  import com.margelo.nitro.audiobrowser.Track
7
- import com.margelo.nitro.audiobrowser.TrackStyle
8
8
 
9
9
  /** Builds MediaMetadata extras bundle for Android Auto/AAOS content styling. */
10
10
  object MediaExtrasBuilder {
11
11
 
12
12
  /**
13
- * Maps TrackStyle to MediaConstants content style value. When artwork is an android.resource://
14
- * URI, uses CATEGORY_* variants which add margins around icons (better for small vector icons).
13
+ * Maps a display mode to the MediaConstants content style value. When artwork is an
14
+ * android.resource:// URI, uses CATEGORY_* variants which add margins around icons (better for
15
+ * small vector icons).
15
16
  *
16
17
  * @see <a href="https://developer.android.com/training/cars/media#default-content-style">Default
17
18
  * content style</a>
18
19
  */
19
- private fun TrackStyle.toContentStyleValue(artwork: String?): Int {
20
+ private fun StyleDisplay.toContentStyleValue(artwork: String?): Int {
20
21
  val isAndroidResource = artwork?.startsWith("android.resource://") == true
21
22
  return when (this) {
22
- TrackStyle.LIST ->
23
+ StyleDisplay.LIST ->
23
24
  if (isAndroidResource) {
24
25
  MediaConstants.DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_CATEGORY_LIST_ITEM
25
26
  } else {
26
27
  MediaConstants.DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_LIST_ITEM
27
28
  }
28
- TrackStyle.GRID ->
29
+ StyleDisplay.GRID ->
29
30
  if (isAndroidResource) {
30
31
  MediaConstants.DESCRIPTION_EXTRAS_VALUE_CONTENT_STYLE_CATEGORY_GRID_ITEM
31
32
  } else {
@@ -34,39 +35,43 @@ object MediaExtrasBuilder {
34
35
  }
35
36
  }
36
37
 
37
- fun build(track: Track): Bundle =
38
+ /**
39
+ * Extras for a track rendered on a browse surface. The owning [section] supplies the Android Auto
40
+ * group-title header hint (grouping is a per-item advisory in the flat MediaBrowser protocol —
41
+ * the section dies here, ADR 0010) and, from its page-folded style block, the per-item display
42
+ * hint: per-item hints derive from the section resolution, never from the track's own `display`,
43
+ * which is positional (ADR 0011).
44
+ *
45
+ * The track's own declared `display` is the page-layout *promise* for the page a browsable track
46
+ * opens — emitted as the parent-level BROWSABLE/PLAYABLE hint, the only below-root hint
47
+ * AOSP-derived AAOS media UIs honor. Declared or it doesn't exist: the library never derives a
48
+ * promise from pages it hasn't resolved, and never back-fills from ones it has.
49
+ */
50
+ fun build(track: Track, section: Section? = null): Bundle =
38
51
  build(
39
- groupTitle = track.groupTitle,
40
- style = track.style,
41
- childrenStyle = track.childrenStyle,
52
+ groupTitle = section?.title,
53
+ itemDisplay = section?.style?.display,
54
+ promisedDisplay = if (track.src == null) track.style?.display else null,
42
55
  artwork = track.artwork?.url,
43
56
  )
44
57
 
45
- fun build(resolvedTrack: ResolvedTrack): Bundle =
46
- build(
47
- groupTitle = resolvedTrack.groupTitle,
48
- style = resolvedTrack.style,
49
- childrenStyle = resolvedTrack.childrenStyle,
50
- artwork = resolvedTrack.artwork?.url,
51
- )
52
-
53
58
  private fun build(
54
59
  groupTitle: String?,
55
- style: TrackStyle?,
56
- childrenStyle: TrackStyle?,
60
+ itemDisplay: StyleDisplay?,
61
+ promisedDisplay: StyleDisplay?,
57
62
  artwork: String?,
58
63
  ): Bundle =
59
64
  Bundle().apply {
60
65
  groupTitle?.let {
61
66
  putString(MediaConstants.DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_GROUP_TITLE, it)
62
67
  }
63
- style?.let {
68
+ itemDisplay?.let {
64
69
  putInt(
65
70
  MediaConstants.DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_SINGLE_ITEM,
66
71
  it.toContentStyleValue(artwork),
67
72
  )
68
73
  }
69
- childrenStyle?.let {
74
+ promisedDisplay?.let {
70
75
  val styleValue = it.toContentStyleValue(artwork)
71
76
  putInt(MediaConstants.DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_BROWSABLE, styleValue)
72
77
  putInt(MediaConstants.DESCRIPTION_EXTRAS_KEY_CONTENT_STYLE_PLAYABLE, styleValue)
@@ -81,7 +81,11 @@ sealed class MetadataAdapter {
81
81
  albumTitle = metadata.albumTitle as String?,
82
82
  subtitle = metadata.subtitle as String?,
83
83
  description = metadata.description as String?,
84
- artworkUri = metadata.artworkUri?.toString(),
84
+ artworkUri =
85
+ metadata.artworkUri?.let { uri ->
86
+ val routes = TrackFactory.artworkRoutes
87
+ if (routes == null) uri.toString() else routes.publicUrl(uri)
88
+ },
85
89
  trackNumber = metadata.trackNumber?.toString(),
86
90
  composer = metadata.composer as String?,
87
91
  conductor = metadata.conductor as String?,
@@ -4,7 +4,6 @@ import android.content.Context
4
4
  import android.net.ConnectivityManager
5
5
  import android.net.Network
6
6
  import android.net.NetworkCapabilities
7
- import android.net.NetworkRequest
8
7
  import kotlinx.coroutines.CoroutineScope
9
8
  import kotlinx.coroutines.flow.MutableStateFlow
10
9
  import kotlinx.coroutines.flow.StateFlow
@@ -14,12 +13,8 @@ import kotlinx.coroutines.flow.onEach
14
13
  import timber.log.Timber
15
14
 
16
15
  /**
17
- * Monitors network connectivity state and notifies listeners when the connection state changes.
18
- *
19
- * This class uses Android's ConnectivityManager.NetworkCallback to detect when the device goes
20
- * online or offline, which is useful for updating UI in Android Auto and other contexts.
21
- *
22
- * Monitoring starts automatically on construction.
16
+ * Whether the device is online: whether its default network has INTERNET and VALIDATED. Monitoring
17
+ * starts on construction.
23
18
  */
24
19
  class NetworkConnectivityMonitor(private val context: Context) {
25
20
  private val connectivityManager =
@@ -27,15 +22,11 @@ class NetworkConnectivityMonitor(private val context: Context) {
27
22
 
28
23
  private var destroyed = false
29
24
 
30
- // Compute initial state before creating StateFlow to avoid race condition
31
- private val _isOnline = MutableStateFlow(checkInitialNetworkState())
25
+ @Volatile private var defaultNetwork: Network? = connectivityManager.activeNetwork
26
+
27
+ private val _isOnline = MutableStateFlow(isOnline(defaultNetwork?.let(::capabilitiesOf)))
32
28
  val isOnline: StateFlow<Boolean> = _isOnline.asStateFlow()
33
29
 
34
- /**
35
- * Gets the current network connectivity state.
36
- *
37
- * @return true if device is online, false otherwise
38
- */
39
30
  fun getOnline(): Boolean = _isOnline.value
40
31
 
41
32
  /**
@@ -46,56 +37,40 @@ class NetworkConnectivityMonitor(private val context: Context) {
46
37
  isOnline.onEach { isOnline -> onStateChanged(isOnline) }.launchIn(scope)
47
38
  }
48
39
 
49
- private fun checkInitialNetworkState(): Boolean {
50
- return connectivityManager.activeNetwork
51
- ?.let { connectivityManager.getNetworkCapabilities(it) }
52
- ?.let {
53
- it.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) &&
54
- it.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
55
- } ?: false
56
- }
40
+ private fun capabilitiesOf(network: Network): NetworkCapabilities? =
41
+ connectivityManager.getNetworkCapabilities(network)
42
+
43
+ private fun isOnline(capabilities: NetworkCapabilities?): Boolean =
44
+ capabilities != null &&
45
+ capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) &&
46
+ capabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
57
47
 
58
48
  private val networkCallback =
59
49
  object : ConnectivityManager.NetworkCallback() {
60
50
  override fun onAvailable(network: Network) {
61
- Timber.d("Network available: $network")
62
- updateNetworkState(true)
51
+ Timber.d("Default network available: $network")
52
+ defaultNetwork = network
53
+ _isOnline.value = isOnline(capabilitiesOf(network))
63
54
  }
64
55
 
65
56
  override fun onLost(network: Network) {
66
57
  Timber.d("Network lost: $network")
67
- updateNetworkState(false)
58
+ if (network != defaultNetwork) return
59
+ defaultNetwork = null
60
+ _isOnline.value = false
68
61
  }
69
62
 
70
- override fun onCapabilitiesChanged(
71
- network: Network,
72
- networkCapabilities: NetworkCapabilities,
73
- ) {
74
- val hasInternet =
75
- networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
76
- val isValidated =
77
- networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
78
- Timber.d("Network capabilities changed: hasInternet=$hasInternet, isValidated=$isValidated")
79
- updateNetworkState(hasInternet && isValidated)
63
+ override fun onCapabilitiesChanged(network: Network, capabilities: NetworkCapabilities) {
64
+ if (network != defaultNetwork) return
65
+ val online = isOnline(capabilities)
66
+ Timber.d("Default network $network capabilities changed: online=$online")
67
+ _isOnline.value = online
80
68
  }
81
69
  }
82
70
 
83
- private fun updateNetworkState(isOnline: Boolean) {
84
- if (_isOnline.value != isOnline) {
85
- _isOnline.value = isOnline
86
- }
87
- }
88
-
89
71
  init {
90
72
  try {
91
- val networkRequest =
92
- NetworkRequest.Builder()
93
- .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
94
- .addCapability(NetworkCapabilities.NET_CAPABILITY_VALIDATED)
95
- .build()
96
-
97
- connectivityManager.registerNetworkCallback(networkRequest, networkCallback)
98
-
73
+ connectivityManager.registerDefaultNetworkCallback(networkCallback)
99
74
  Timber.d(
100
75
  "Network monitoring started, initial state: ${if (_isOnline.value) "online" else "offline"}"
101
76
  )
@@ -11,6 +11,7 @@ import android.os.Looper
11
11
  import androidx.lifecycle.DefaultLifecycleObserver
12
12
  import androidx.lifecycle.LifecycleOwner
13
13
  import androidx.lifecycle.ProcessLifecycleOwner
14
+ import com.audiobrowser.RemoteOutputs
14
15
  import com.margelo.nitro.audiobrowser.Output
15
16
  import com.margelo.nitro.audiobrowser.OutputType
16
17
  import timber.log.Timber
@@ -43,6 +44,9 @@ import timber.log.Timber
43
44
  * over the connected output devices; that fallback cannot detect a manual reroute while a device
44
45
  * stays connected (the long-standing limitation).
45
46
  *
47
+ * A selected [RemoteOutputs] route takes precedence over the local device. Unlike a local device's,
48
+ * a remote route's selection is reliable: the router owns it.
49
+ *
46
50
  * Threading: [AudioManager] queries are thread-safe, so [current] recomputes live on read (safe
47
51
  * from the JS thread's `getOutput()`); emitted change events come from the main-thread
48
52
  * callbacks/poll.
@@ -80,6 +84,8 @@ class OutputMonitor(private val context: Context) : DefaultLifecycleObserver {
80
84
  recompute("device-removed")
81
85
  }
82
86
 
87
+ private val remoteOutputListener = { recompute("remote-output") }
88
+
83
89
  // Backstop for manual reroutes, which emit no public event (see class doc).
84
90
  // Only scheduled while in the foreground.
85
91
  private val poll =
@@ -94,6 +100,7 @@ class OutputMonitor(private val context: Context) : DefaultLifecycleObserver {
94
100
  fun start() {
95
101
  mainHandler.post {
96
102
  audioManager.registerAudioDeviceCallback(deviceCallback, mainHandler)
103
+ RemoteOutputs.addListener(remoteOutputListener)
97
104
  // Delivers onStart synchronously if already foreground, kicking off the poll.
98
105
  ProcessLifecycleOwner.get().lifecycle.addObserver(this)
99
106
  }
@@ -120,11 +127,22 @@ class OutputMonitor(private val context: Context) : DefaultLifecycleObserver {
120
127
  mainHandler.removeCallbacks(poll)
121
128
  ProcessLifecycleOwner.get().lifecycle.removeObserver(this)
122
129
  audioManager.unregisterAudioDeviceCallback(deviceCallback)
130
+ RemoteOutputs.removeListener(remoteOutputListener)
123
131
  }
124
132
  }
125
133
 
126
134
  private fun recompute(reason: String) {
127
- val output = computeOutput() ?: return
135
+ // A left remote output is no fallback for a local reading that came back empty: the phone
136
+ // speaker stands in, so listeners hear that the remote output is gone.
137
+ val output =
138
+ computeOutput()
139
+ ?: if (cached?.type == OutputType.REMOTE)
140
+ Output(
141
+ type = OutputType.SPEAKER,
142
+ name = defaultName(OutputType.SPEAKER),
143
+ external = false,
144
+ )
145
+ else return
128
146
  if (output == cached) return
129
147
  cached = output
130
148
  Timber.d("OutputMonitor [%s]: type=%s name=%s", reason, output.type, output.name)
@@ -132,6 +150,9 @@ class OutputMonitor(private val context: Context) : DefaultLifecycleObserver {
132
150
  }
133
151
 
134
152
  private fun computeOutput(): Output? {
153
+ RemoteOutputs.current?.let {
154
+ return it
155
+ }
135
156
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
136
157
  val device =
137
158
  audioManager.getAudioDevicesForAttributes(mediaAttributes).firstOrNull { it.isSink }
@@ -5,21 +5,22 @@ import com.margelo.nitro.audiobrowser.PlayingState
5
5
 
6
6
  object PlayingStateFactory {
7
7
  /**
8
- * Derives a PlayingState from playWhenReady and state.
8
+ * Derives a PlayingState from shouldPlayWhenReady and state.
9
9
  *
10
- * @param playWhenReady Whether the player wants to play when ready
10
+ * @param shouldPlayWhenReady Whether the player wants to play when ready and nothing holds its
11
+ * output back
11
12
  * @param playbackState The current player state
12
13
  * @return A PlayingState representing the current playing/buffering status
13
14
  */
14
- fun derive(playWhenReady: Boolean, playbackState: PlaybackState): PlayingState {
15
+ fun derive(shouldPlayWhenReady: Boolean, playbackState: PlaybackState): PlayingState {
15
16
  val playing =
16
- playWhenReady &&
17
+ shouldPlayWhenReady &&
17
18
  !(playbackState == PlaybackState.ERROR ||
18
19
  playbackState == PlaybackState.ENDED ||
19
20
  playbackState == PlaybackState.NONE ||
20
21
  playbackState == PlaybackState.STOPPED)
21
22
  val buffering =
22
- playWhenReady &&
23
+ shouldPlayWhenReady &&
23
24
  (playbackState == PlaybackState.LOADING || playbackState == PlaybackState.BUFFERING)
24
25
  return PlayingState(playing, buffering)
25
26
  }
@@ -4,8 +4,8 @@ import androidx.media3.common.HeartRating
4
4
  import androidx.media3.common.Rating
5
5
 
6
6
  /**
7
- * Maps a Media3 [Rating] arriving from a controller (e.g. Google Assistant "I like this") to a
8
- * favorite intent. Only an explicitly-rated heart carries favorite intent: a thumbs / star /
7
+ * Maps a Media3 [Rating] arriving from a controller (e.g. Android Automotive OS's rating control)
8
+ * to a favorite intent. Only an explicitly-rated heart carries favorite intent: a thumbs / star /
9
9
  * percentage rating, or an unrated (cleared) heart, returns null — no favorite change.
10
10
  */
11
11
  object RatingFavorites {
@@ -0,0 +1,110 @@
1
+ package com.audiobrowser.util
2
+
3
+ import com.margelo.nitro.audiobrowser.ArtworkRendering
4
+ import com.margelo.nitro.audiobrowser.CardImage
5
+ import com.margelo.nitro.audiobrowser.GridTile
6
+ import com.margelo.nitro.audiobrowser.ImageShape
7
+ import com.margelo.nitro.audiobrowser.SectionStyle
8
+ import com.margelo.nitro.audiobrowser.StyleDisplay
9
+ import com.margelo.nitro.audiobrowser.TrackStyle
10
+
11
+ /**
12
+ * The all-nil blocks a decode collapses to "no declaration". Every field is listed exactly once
13
+ * here — the decoders and the persistence restore compare against these instead of re-enumerating
14
+ * the fields in each guard (a constructor gaining a field breaks this file, not silently a guard).
15
+ */
16
+ internal val EMPTY_TRACK_STYLE =
17
+ TrackStyle(
18
+ display = null,
19
+ artworkRendering = null,
20
+ imageShape = null,
21
+ accessorySymbol = null,
22
+ cardTint = null,
23
+ cardImage = null,
24
+ )
25
+
26
+ internal val EMPTY_SECTION_STYLE =
27
+ SectionStyle(
28
+ display = null,
29
+ artworkRendering = null,
30
+ imageShape = null,
31
+ accessorySymbol = null,
32
+ cardTint = null,
33
+ cardImage = null,
34
+ gridWrap = null,
35
+ gridTile = null,
36
+ )
37
+
38
+ /**
39
+ * The style block's wire strings (ADR 0011) ↔ Nitro enums, shared by the browse decoder and the
40
+ * playback-state store. Inbound mapping is lenient: an unknown or empty value is "no declaration",
41
+ * never an error.
42
+ */
43
+ internal fun StyleDisplay.toWireString(): String =
44
+ when (this) {
45
+ StyleDisplay.LIST -> "list"
46
+ StyleDisplay.GRID -> "grid"
47
+ }
48
+
49
+ internal fun ArtworkRendering.toWireString(): String =
50
+ when (this) {
51
+ ArtworkRendering.ORIGINAL -> "original"
52
+ ArtworkRendering.STENCIL -> "stencil"
53
+ }
54
+
55
+ internal fun String?.toStyleDisplay(): StyleDisplay? =
56
+ when (this?.takeIf { it.isNotEmpty() }?.lowercase()) {
57
+ "list" -> StyleDisplay.LIST
58
+ "grid" -> StyleDisplay.GRID
59
+ else -> null
60
+ }
61
+
62
+ internal fun String?.toArtworkRendering(): ArtworkRendering? =
63
+ when (this?.takeIf { it.isNotEmpty() }?.lowercase()) {
64
+ "original" -> ArtworkRendering.ORIGINAL
65
+ "stencil" -> ArtworkRendering.STENCIL
66
+ else -> null
67
+ }
68
+
69
+ internal fun ImageShape.toWireString(): String =
70
+ when (this) {
71
+ ImageShape.CIRCULAR -> "circular"
72
+ ImageShape.ROUNDED_RECTANGLE -> "rounded-rectangle"
73
+ }
74
+
75
+ internal fun String?.toImageShape(): ImageShape? =
76
+ when (this?.takeIf { it.isNotEmpty() }?.lowercase()) {
77
+ "circular" -> ImageShape.CIRCULAR
78
+ "rounded-rectangle" -> ImageShape.ROUNDED_RECTANGLE
79
+ else -> null
80
+ }
81
+
82
+ internal fun GridTile.toWireString(): String =
83
+ when (this) {
84
+ GridTile.PLAIN -> "plain"
85
+ GridTile.IMAGE -> "image"
86
+ GridTile.CARD -> "card"
87
+ GridTile.CONDENSED -> "condensed"
88
+ }
89
+
90
+ internal fun String?.toGridTile(): GridTile? =
91
+ when (this?.takeIf { it.isNotEmpty() }?.lowercase()) {
92
+ "plain" -> GridTile.PLAIN
93
+ "image" -> GridTile.IMAGE
94
+ "card" -> GridTile.CARD
95
+ "condensed" -> GridTile.CONDENSED
96
+ else -> null
97
+ }
98
+
99
+ internal fun CardImage.toWireString(): String =
100
+ when (this) {
101
+ CardImage.NORMAL -> "normal"
102
+ CardImage.BACKGROUND -> "background"
103
+ }
104
+
105
+ internal fun String?.toCardImage(): CardImage? =
106
+ when (this?.takeIf { it.isNotEmpty() }?.lowercase()) {
107
+ "normal" -> CardImage.NORMAL
108
+ "background" -> CardImage.BACKGROUND
109
+ else -> null
110
+ }