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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1275) hide show
  1. package/AudioBrowser.podspec +1 -1
  2. package/README.md +68 -39
  3. package/android/build.gradle +53 -14
  4. package/android/gradle.properties +3 -3
  5. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +213 -0
  6. package/android/src/main/AndroidManifest.xml +14 -1
  7. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +582 -456
  8. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +34 -0
  9. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +16 -2
  10. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  11. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +126 -0
  12. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  13. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +222 -0
  14. package/android/src/main/java/com/audiobrowser/Service.kt +101 -104
  15. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +15 -17
  16. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  17. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +30 -14
  18. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +358 -541
  19. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +36 -66
  20. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +228 -0
  21. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  22. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +86 -64
  23. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  24. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +52 -28
  25. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  26. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +49 -0
  27. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +12 -19
  28. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  29. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  30. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +20 -11
  31. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +18 -0
  32. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +11 -0
  33. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +25 -17
  34. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +28 -42
  35. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +23 -0
  36. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +12 -13
  37. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +32 -27
  38. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  39. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +92 -49
  40. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  41. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +65 -0
  42. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  43. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +67 -0
  44. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +16 -19
  45. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +113 -50
  46. package/android/src/main/java/com/audiobrowser/player/LiveStreamExtractor.kt +65 -0
  47. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +49 -0
  48. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +75 -65
  49. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +600 -345
  50. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +108 -153
  51. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +110 -116
  52. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  53. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +62 -38
  54. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +119 -132
  55. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  56. package/android/src/main/java/com/audiobrowser/player/Player.kt +686 -600
  57. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +2 -15
  58. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +18 -28
  59. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +171 -178
  60. package/android/src/main/java/com/audiobrowser/player/ReconnectPacer.kt +96 -0
  61. package/android/src/main/java/com/audiobrowser/player/RetryFocus.kt +126 -0
  62. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +65 -210
  63. package/android/src/main/java/com/audiobrowser/player/RetryLocks.kt +52 -0
  64. package/android/src/main/java/com/audiobrowser/player/RetryLoop.kt +310 -0
  65. package/android/src/main/java/com/audiobrowser/player/RetryView.kt +31 -0
  66. package/android/src/main/java/com/audiobrowser/player/SessionViewListener.kt +168 -0
  67. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +24 -0
  68. package/android/src/main/java/com/audiobrowser/player/SilenceBudget.kt +89 -0
  69. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  70. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  71. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +53 -68
  72. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  73. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +65 -0
  74. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +104 -0
  75. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +42 -0
  76. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +117 -0
  77. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +742 -0
  78. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +105 -0
  79. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +39 -0
  80. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +59 -0
  81. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +91 -0
  82. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +98 -0
  83. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +69 -0
  84. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +128 -0
  85. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +538 -0
  86. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +97 -0
  87. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +203 -0
  88. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +15 -0
  89. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +67 -0
  90. package/android/src/main/java/com/audiobrowser/sonos/SpeakerXml.kt +26 -0
  91. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +68 -0
  92. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +61 -0
  93. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +70 -0
  94. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +62 -43
  95. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +151 -0
  96. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +53 -18
  97. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +26 -13
  98. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +231 -77
  99. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  100. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +39 -0
  101. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  102. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  103. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +13 -0
  104. package/android/src/main/java/com/audiobrowser/util/AwaitCancellable.kt +45 -0
  105. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  106. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  107. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +50 -93
  108. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  109. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  110. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  111. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  112. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +25 -24
  113. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +10 -10
  114. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +25 -56
  115. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +39 -46
  116. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  117. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +6 -7
  118. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  119. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +110 -0
  120. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  121. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  122. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +96 -83
  123. package/android/src/main/res/values/strings.xml +25 -5
  124. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +16 -0
  125. package/android/src/test/java/androidx/media3/session/SessionViews.kt +38 -0
  126. package/android/src/test/java/com/audiobrowser/AudioFixtures.kt +32 -0
  127. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +151 -0
  128. package/android/src/test/java/com/audiobrowser/GateDecisionTest.kt +128 -0
  129. package/android/src/test/java/com/audiobrowser/LaunchSettledTest.kt +81 -0
  130. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +90 -0
  131. package/android/src/test/java/com/audiobrowser/NetworkFixtures.kt +25 -0
  132. package/android/src/test/java/com/audiobrowser/RemoteOutputRoutesTest.kt +29 -0
  133. package/android/src/test/java/com/audiobrowser/RemoteOutputsTest.kt +81 -0
  134. package/android/src/test/java/com/audiobrowser/ResolveFormattedErrorTest.kt +93 -0
  135. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +24 -4
  136. package/android/src/test/java/com/audiobrowser/ServiceFixtures.kt +48 -0
  137. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +290 -0
  138. package/android/src/test/java/com/audiobrowser/SessionPositionUpdatesTest.kt +114 -0
  139. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +123 -42
  140. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  141. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  142. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +143 -0
  143. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerInvalidationTest.kt +172 -0
  144. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +87 -25
  145. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +356 -8
  146. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +69 -13
  147. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +292 -0
  148. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +1 -3
  149. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +163 -0
  150. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +116 -53
  151. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  152. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +149 -0
  153. package/android/src/test/java/com/audiobrowser/browser/TrackLoadHandlerTest.kt +44 -0
  154. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +37 -0
  155. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +36 -0
  156. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +70 -16
  157. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +49 -0
  158. package/android/src/test/java/com/audiobrowser/model/PlayerSetupOptionsTest.kt +35 -0
  159. package/android/src/test/java/com/audiobrowser/player/AutomaticBufferManagerTest.kt +208 -0
  160. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +459 -0
  161. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +4 -14
  162. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +87 -0
  163. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  164. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +12 -9
  165. package/android/src/test/java/com/audiobrowser/player/FavoriteCapabilityTest.kt +109 -0
  166. package/android/src/test/java/com/audiobrowser/player/HandleTrackLoadSeekTest.kt +243 -0
  167. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +137 -0
  168. package/android/src/test/java/com/audiobrowser/player/LiveStreamEndTest.kt +316 -0
  169. package/android/src/test/java/com/audiobrowser/player/MediaFactoryTest.kt +102 -0
  170. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  171. package/android/src/test/java/com/audiobrowser/player/NowPlayingFormatterTest.kt +75 -0
  172. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +251 -21
  173. package/android/src/test/java/com/audiobrowser/player/PlayFromSearchTest.kt +108 -0
  174. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  175. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +90 -38
  176. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +50 -0
  177. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  178. package/android/src/test/java/com/audiobrowser/player/PlayerBrowserTest.kt +62 -0
  179. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +172 -0
  180. package/android/src/test/java/com/audiobrowser/player/PlayerDestroyTest.kt +60 -0
  181. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  182. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +66 -0
  183. package/android/src/test/java/com/audiobrowser/player/PlayerRemoteOutputsSeekTest.kt +105 -0
  184. package/android/src/test/java/com/audiobrowser/player/PlayerRetryTest.kt +607 -0
  185. package/android/src/test/java/com/audiobrowser/player/PlayerSetupEndedTest.kt +195 -0
  186. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +147 -0
  187. package/android/src/test/java/com/audiobrowser/player/PlayerSleepTimerTest.kt +38 -0
  188. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +235 -0
  189. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +354 -0
  190. package/android/src/test/java/com/audiobrowser/player/PlayerTrackChangeTest.kt +222 -0
  191. package/android/src/test/java/com/audiobrowser/player/RetryCaseTest.kt +125 -0
  192. package/android/src/test/java/com/audiobrowser/player/RetryFocusTest.kt +97 -0
  193. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +93 -200
  194. package/android/src/test/java/com/audiobrowser/player/RetryLocksTest.kt +48 -0
  195. package/android/src/test/java/com/audiobrowser/player/RetryLoopCaseTest.kt +181 -0
  196. package/android/src/test/java/com/audiobrowser/player/RetryLoopTest.kt +221 -0
  197. package/android/src/test/java/com/audiobrowser/player/RetryMaskingTest.kt +178 -0
  198. package/android/src/test/java/com/audiobrowser/player/SessionPlayTest.kt +212 -0
  199. package/android/src/test/java/com/audiobrowser/player/SessionViewListenerTest.kt +225 -0
  200. package/android/src/test/java/com/audiobrowser/player/SessionViewRulesTest.kt +62 -0
  201. package/android/src/test/java/com/audiobrowser/player/SessionViewTest.kt +234 -0
  202. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +72 -0
  203. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +149 -0
  204. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +61 -23
  205. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +309 -0
  206. package/android/src/test/java/com/audiobrowser/remote/RemoteItemTest.kt +61 -0
  207. package/android/src/test/java/com/audiobrowser/remote/RemoteOutputsControllerTest.kt +77 -0
  208. package/android/src/test/java/com/audiobrowser/remote/RemoteQueueTest.kt +101 -0
  209. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +1037 -0
  210. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +201 -0
  211. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +89 -0
  212. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +70 -0
  213. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +134 -0
  214. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +169 -0
  215. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +176 -0
  216. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +690 -0
  217. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +129 -0
  218. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +199 -0
  219. package/android/src/test/java/com/audiobrowser/sonos/SonosStreamUriTest.kt +64 -0
  220. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +200 -0
  221. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +97 -0
  222. package/android/src/test/java/com/audiobrowser/sonos/ZoneGroupStateTest.kt +139 -0
  223. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +181 -15
  224. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +315 -8
  225. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +298 -0
  226. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +78 -1
  227. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  228. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  229. package/android/src/test/java/com/audiobrowser/util/AwaitCancellableTest.kt +136 -0
  230. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +51 -16
  231. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  232. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  233. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  234. package/android/src/test/java/com/audiobrowser/util/JsPromise.kt +44 -0
  235. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +154 -0
  236. package/android/src/test/java/com/audiobrowser/util/NetworkConnectivityMonitorTest.kt +108 -0
  237. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +97 -0
  238. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +6 -10
  239. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  240. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +11 -13
  241. package/android/src/test/java/com/audiobrowser/util/TrackFactoryRatingTest.kt +91 -1
  242. package/android/src/test/resources/sonos/device_description.xml +78 -0
  243. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +56 -0
  244. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +80 -0
  245. package/ios/AVPlayerEngine.swift +363 -0
  246. package/ios/AVPlayerEngineCallbacks.swift +12 -0
  247. package/ios/Browser/BrowseGate.swift +70 -0
  248. package/ios/Browser/BrowserConfig.swift +123 -104
  249. package/ios/Browser/BrowserError.swift +15 -0
  250. package/ios/Browser/BrowserManager.swift +153 -675
  251. package/ios/Browser/BrowserPathHelper.swift +54 -117
  252. package/ios/Browser/FavoriteSet.swift +43 -0
  253. package/ios/Browser/InertStyleDiagnostic.swift +231 -0
  254. package/ios/Browser/JsonModels.swift +244 -335
  255. package/ios/Browser/NavigationErrorState.swift +42 -0
  256. package/ios/Browser/PageResolver.swift +132 -0
  257. package/ios/Browser/RequestLayer.swift +185 -0
  258. package/ios/Browser/RequestPipeline.swift +295 -0
  259. package/ios/Browser/SearchDrillIn.swift +10 -16
  260. package/ios/Browser/SectionScope.swift +73 -26
  261. package/ios/Browser/SimpleRouter.swift +76 -154
  262. package/ios/Browser/StyleResolver.swift +41 -0
  263. package/ios/Browser/TabBarEntries.swift +8 -7
  264. package/ios/Browser/TrackIdTemplate.swift +29 -0
  265. package/ios/CarPlay/CPInterfaceController+Safe.swift +102 -61
  266. package/ios/CarPlay/CarPlayArtworkResolver.swift +32 -83
  267. package/ios/CarPlay/CarPlayController.swift +37 -1297
  268. package/ios/CarPlay/CarPlayImageLoader.swift +85 -172
  269. package/ios/CarPlay/CarPlayListItemFactory.swift +240 -104
  270. package/ios/CarPlay/CarPlayNowPlayingManager.swift +147 -218
  271. package/ios/CarPlay/CarPlaySession+Navigator.swift +103 -0
  272. package/ios/CarPlay/CarPlaySession+PageLoader.swift +93 -0
  273. package/ios/CarPlay/CarPlaySession+Refresher.swift +43 -0
  274. package/ios/CarPlay/CarPlaySession+TabBar.swift +185 -0
  275. package/ios/CarPlay/CarPlaySession.swift +203 -0
  276. package/ios/CarPlay/CarPlayTemplates.swift +62 -0
  277. package/ios/CarPlay/IntentHandlers.swift +94 -0
  278. package/ios/CarPlay/MediaIntentCriteria.swift +91 -0
  279. package/ios/CarPlay/{RNABMediaIntentHandler.swift → MediaIntentHandler.swift} +15 -17
  280. package/ios/CarPlay/MediaIntentPlayback.swift +86 -0
  281. package/ios/CarPlay/NowPlayingButtonRules.swift +34 -0
  282. package/ios/CarPlay/RNABAudioBrowser.m +7 -15
  283. package/ios/CarPlay/SectionPresentation.swift +67 -0
  284. package/ios/CarPlay/TopTemplateReplacer.swift +95 -0
  285. package/ios/Extension/Capability+RemoteCommand.swift +22 -69
  286. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  287. package/ios/Extension/CxxVectorConformances.swift +4 -16
  288. package/ios/Extension/NavigationError+Conversion.swift +17 -10
  289. package/ios/Extension/PlayerCapabilities+Favorite.swift +1 -16
  290. package/ios/Extension/Promise+AwaitCallback.swift +33 -0
  291. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  292. package/ios/Extension/ResolvedTrack+Copying.swift +14 -22
  293. package/ios/Extension/SearchParams+Query.swift +28 -0
  294. package/ios/Extension/Section+Copying.swift +26 -0
  295. package/ios/Extension/String+IcyCharset.swift +21 -0
  296. package/ios/Extension/TimedMetadata+AVFoundation.swift +10 -14
  297. package/ios/Extension/Track+AVPlayer.swift +1 -18
  298. package/ios/Extension/Track+Copying.swift +13 -21
  299. package/ios/Extension/Track+Identity.swift +20 -0
  300. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  301. package/ios/Extension/UIApplication+ActiveScene.swift +19 -0
  302. package/ios/Extension/UIImage+Adaptive.swift +12 -0
  303. package/ios/Extension/URLError+Connectivity.swift +15 -0
  304. package/ios/Extension/Variant+Artwork.swift +8 -22
  305. package/ios/Http/HttpClient.swift +73 -167
  306. package/ios/HybridAudioBrowser+Browser.swift +134 -0
  307. package/ios/HybridAudioBrowser+Options.swift +116 -0
  308. package/ios/HybridAudioBrowser+Player.swift +347 -0
  309. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +156 -0
  310. package/ios/HybridAudioBrowser+Stubs.swift +44 -0
  311. package/ios/HybridAudioBrowser.swift +147 -1718
  312. package/ios/Model/NitroTypeStubs.swift +266 -32
  313. package/ios/Model/PlayerUpdateOptions.swift +13 -19
  314. package/ios/Model/RemoteCommand.swift +6 -78
  315. package/ios/Model/TrackPlayerError.swift +12 -21
  316. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +28 -82
  317. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  318. package/ios/Observer/ItemObserver.swift +92 -0
  319. package/ios/Observer/PlayerObserver.swift +59 -0
  320. package/ios/Option/SessionCategories.swift +41 -92
  321. package/ios/PlaybackEvent.swift +4 -2
  322. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  323. package/ios/Player/AudioSessionController.swift +190 -0
  324. package/ios/Player/DeferredSeek.swift +73 -0
  325. package/ios/Player/ErrorStatus.swift +56 -0
  326. package/ios/Player/MediaLoader.swift +73 -98
  327. package/ios/Player/NowPlayingLines.swift +49 -0
  328. package/ios/Player/NowPlayingUpdater.swift +180 -105
  329. package/ios/Player/PersistedPlaybackState.swift +1 -2
  330. package/ios/Player/PlaybackFailure.swift +121 -0
  331. package/ios/Player/PlaybackPersistence.swift +72 -0
  332. package/ios/Player/PlaybackStateMachine.swift +15 -14
  333. package/ios/Player/PlaybackTimer.swift +11 -8
  334. package/ios/Player/Player.swift +1030 -0
  335. package/ios/Player/{PlaybackCoordinatorCallbacks.swift → PlayerCallbacks.swift} +4 -8
  336. package/ios/Player/PlayerEngine.swift +109 -0
  337. package/ios/Player/PlayerStatusTypes.swift +1 -6
  338. package/ios/Player/QueueManager.swift +80 -98
  339. package/ios/Player/ReconnectPacer.swift +83 -0
  340. package/ios/Player/RetryLoop.swift +374 -0
  341. package/ios/Player/ShuffleOrder.swift +36 -43
  342. package/ios/Player/SilenceBudget.swift +78 -0
  343. package/ios/Player/SleepTimerManager.swift +25 -42
  344. package/ios/Player/VolumeFader.swift +20 -15
  345. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -20
  346. package/ios/RemoteCommand/RemoteCommandController.swift +99 -337
  347. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  348. package/ios/Tests/ArtworkFreshnessTests.swift +67 -0
  349. package/ios/Tests/AwaitCallbackTests.swift +210 -0
  350. package/ios/Tests/BrowseGateTests.swift +50 -0
  351. package/ios/Tests/BrowserPathHelperTests.swift +89 -18
  352. package/ios/Tests/CapabilityRemoteCommandTests.swift +35 -0
  353. package/ios/Tests/CarPlayArtworkResolverTests.swift +60 -373
  354. package/ios/Tests/ConcurrentMapTests.swift +42 -0
  355. package/ios/Tests/ConnectivityTests.swift +13 -0
  356. package/ios/Tests/DeferredSeekTests.swift +76 -0
  357. package/ios/Tests/EmitterTests.swift +22 -39
  358. package/ios/Tests/ErrorStatusTests.swift +50 -0
  359. package/ios/Tests/FavoriteSetTests.swift +61 -0
  360. package/ios/Tests/GenerationMemoTests.swift +178 -0
  361. package/ios/Tests/InertStyleDiagnosticTests.swift +203 -0
  362. package/ios/Tests/JsonModelsTests.swift +189 -3
  363. package/ios/Tests/LRUCacheTests.swift +106 -0
  364. package/ios/Tests/MediaIntentCriteriaTests.swift +58 -52
  365. package/ios/Tests/MediaIntentDeadlineTests.swift +75 -0
  366. package/ios/Tests/MediaLoaderTests.swift +38 -78
  367. package/ios/Tests/NowPlayingButtonRulesTests.swift +43 -0
  368. package/ios/Tests/NowPlayingLinesTests.swift +66 -0
  369. package/ios/Tests/ObserverTests.swift +88 -0
  370. package/ios/Tests/PlaybackErrorTests.swift +74 -0
  371. package/ios/Tests/PlaybackFailureTests.swift +188 -0
  372. package/ios/Tests/PlaybackPersistenceTests.swift +94 -0
  373. package/ios/Tests/PlaybackStateMachineTests.swift +7 -22
  374. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  375. package/ios/Tests/PlayerInvalidTrackTests.swift +65 -0
  376. package/ios/Tests/PlayerPolicyTests.swift +1386 -0
  377. package/ios/Tests/PlayerTests.swift +1677 -0
  378. package/ios/Tests/PlayingStateTests.swift +41 -0
  379. package/ios/Tests/QueueManagerTests.swift +205 -174
  380. package/ios/Tests/ReadyValueTests.swift +73 -0
  381. package/ios/Tests/RemoteCommandControllerTests.swift +65 -48
  382. package/ios/Tests/RequestLayerTests.swift +228 -0
  383. package/ios/Tests/ResolvedTrackCopyingTests.swift +39 -37
  384. package/ios/Tests/RetryCaseTests.swift +146 -0
  385. package/ios/Tests/RetryLoopTests.swift +486 -0
  386. package/ios/Tests/SearchDrillInTests.swift +16 -17
  387. package/ios/Tests/SearchParamsQueryTests.swift +48 -0
  388. package/ios/Tests/SectionPresentationTests.swift +85 -0
  389. package/ios/Tests/SectionScopeTests.swift +136 -54
  390. package/ios/Tests/SimpleRouterTests.swift +39 -8
  391. package/ios/Tests/SleepTimerManagerTests.swift +68 -47
  392. package/ios/Tests/StyleResolverTests.swift +123 -0
  393. package/ios/Tests/SupersedingTaskTests.swift +148 -0
  394. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  395. package/ios/Tests/Support/TestTypes.swift +236 -93
  396. package/ios/Tests/Support/TimeLimit.swift +43 -0
  397. package/ios/Tests/TabBarEntriesTests.swift +18 -20
  398. package/ios/Tests/TimedMetadataAVFoundationTests.swift +43 -2
  399. package/ios/Tests/TopTemplateReplacerTests.swift +172 -0
  400. package/ios/Tests/TrackIdTemplateTests.swift +63 -0
  401. package/ios/Tests/TrackIdentityTests.swift +20 -0
  402. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  403. package/ios/Tests/TrackSelectorTests.swift +157 -34
  404. package/ios/Tests/URLErrorConnectivityTests.swift +20 -0
  405. package/ios/TrackSelector.swift +67 -77
  406. package/ios/Util/ArtworkFreshness.swift +42 -0
  407. package/ios/Util/ArtworkImageFetcher.swift +143 -6
  408. package/ios/Util/AwaitCallback.swift +80 -0
  409. package/ios/Util/ConcurrentMap.swift +19 -0
  410. package/ios/Util/Connectivity.swift +12 -0
  411. package/ios/Util/Deadline.swift +38 -0
  412. package/ios/Util/Emitter.swift +45 -22
  413. package/ios/Util/GenerationMemo.swift +43 -0
  414. package/ios/Util/LRUCache.swift +23 -159
  415. package/ios/Util/NetworkMonitor.swift +31 -33
  416. package/ios/Util/OutputPicker.swift +48 -0
  417. package/ios/Util/ReadyValue.swift +57 -0
  418. package/ios/Util/SFSymbolRenderer.swift +64 -49
  419. package/ios/Util/SVGProcessor.swift +9 -16
  420. package/ios/Util/SupersedingTask.swift +45 -0
  421. package/lib/commonjs/AudioBrowser.js +11 -0
  422. package/lib/commonjs/AudioBrowser.js.map +1 -1
  423. package/lib/commonjs/CLAUDE.md +57 -0
  424. package/lib/commonjs/features/battery.js +16 -12
  425. package/lib/commonjs/features/battery.js.map +1 -1
  426. package/lib/commonjs/features/browser-config.js +13 -9
  427. package/lib/commonjs/features/browser-config.js.map +1 -1
  428. package/lib/commonjs/features/browser.js +78 -20
  429. package/lib/commonjs/features/browser.js.map +1 -1
  430. package/lib/commonjs/features/carConnection.js +3 -4
  431. package/lib/commonjs/features/carConnection.js.map +1 -1
  432. package/lib/commonjs/features/equalizer.js +9 -5
  433. package/lib/commonjs/features/equalizer.js.map +1 -1
  434. package/lib/commonjs/features/errors.js +35 -21
  435. package/lib/commonjs/features/errors.js.map +1 -1
  436. package/lib/commonjs/features/favorites.js +28 -23
  437. package/lib/commonjs/features/favorites.js.map +1 -1
  438. package/lib/commonjs/features/gate.js +27 -6
  439. package/lib/commonjs/features/gate.js.map +1 -1
  440. package/lib/commonjs/features/metadata.js +61 -11
  441. package/lib/commonjs/features/metadata.js.map +1 -1
  442. package/lib/commonjs/features/network.js +5 -1
  443. package/lib/commonjs/features/network.js.map +1 -1
  444. package/lib/commonjs/features/nowPlaying.js +28 -14
  445. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  446. package/lib/commonjs/features/output.js +9 -4
  447. package/lib/commonjs/features/output.js.map +1 -1
  448. package/lib/commonjs/features/playback/controls.js +13 -6
  449. package/lib/commonjs/features/playback/controls.js.map +1 -1
  450. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  451. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  452. package/lib/commonjs/features/playback/playing.js +5 -3
  453. package/lib/commonjs/features/playback/playing.js.map +1 -1
  454. package/lib/commonjs/features/playback/progress.js +13 -6
  455. package/lib/commonjs/features/playback/progress.js.map +1 -1
  456. package/lib/commonjs/features/playback/rate.js +8 -1
  457. package/lib/commonjs/features/playback/rate.js.map +1 -1
  458. package/lib/commonjs/features/playback/state.js +5 -6
  459. package/lib/commonjs/features/playback/state.js.map +1 -1
  460. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  461. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  462. package/lib/commonjs/features/playback/volume.js +6 -5
  463. package/lib/commonjs/features/playback/volume.js.map +1 -1
  464. package/lib/commonjs/features/player/options.js +20 -10
  465. package/lib/commonjs/features/player/options.js.map +1 -1
  466. package/lib/commonjs/features/player/setup.js +44 -43
  467. package/lib/commonjs/features/player/setup.js.map +1 -1
  468. package/lib/commonjs/features/player/validateOptions.js +3 -4
  469. package/lib/commonjs/features/player/validateOptions.js.map +1 -1
  470. package/lib/commonjs/features/queue/activeTrack.js +14 -4
  471. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  472. package/lib/commonjs/features/queue/queue.js +56 -21
  473. package/lib/commonjs/features/queue/queue.js.map +1 -1
  474. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  475. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  476. package/lib/commonjs/features/queue/shuffle.js +0 -1
  477. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  478. package/lib/commonjs/features/remoteControls.js +59 -35
  479. package/lib/commonjs/features/remoteControls.js.map +1 -1
  480. package/lib/commonjs/features/sleepTimer.js +23 -6
  481. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  482. package/lib/commonjs/test-utils/reactNativeStub.js +65 -0
  483. package/lib/commonjs/test-utils/reactNativeStub.js.map +1 -0
  484. package/lib/commonjs/utils/LazyNativeEmitter.js +18 -10
  485. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  486. package/lib/commonjs/utils/NativeUpdatedValue.js +32 -16
  487. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  488. package/lib/commonjs/utils/getTrackIdentity.js +26 -0
  489. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -0
  490. package/lib/commonjs/utils/useDebug.js +16 -3
  491. package/lib/commonjs/utils/useDebug.js.map +1 -1
  492. package/lib/commonjs/utils/useNativeUpdatedValue.js +12 -20
  493. package/lib/commonjs/utils/useNativeUpdatedValue.js.map +1 -1
  494. package/lib/commonjs/utils/useNativeValueRefreshedBy.js +38 -0
  495. package/lib/commonjs/utils/useNativeValueRefreshedBy.js.map +1 -0
  496. package/lib/commonjs/web/NativeAudioBrowser.js +207 -84
  497. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  498. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js +37 -0
  499. package/lib/commonjs/web/TrackPlayer/LoadAttempt.js.map +1 -0
  500. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  501. package/lib/commonjs/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  502. package/lib/commonjs/web/TrackPlayer/Player.js +256 -40
  503. package/lib/commonjs/web/TrackPlayer/Player.js.map +1 -1
  504. package/lib/commonjs/web/TrackPlayer/PlayingStateFactory.js +1 -1
  505. package/lib/commonjs/web/TrackPlayer/QueueManager.js +14 -0
  506. package/lib/commonjs/web/TrackPlayer/QueueManager.js.map +1 -1
  507. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js +34 -14
  508. package/lib/commonjs/web/TrackPlayer/QueuePlayer.js.map +1 -1
  509. package/lib/commonjs/web/browser/BrowserManager.js +175 -100
  510. package/lib/commonjs/web/browser/BrowserManager.js.map +1 -1
  511. package/lib/commonjs/web/browser/FavoriteManager.js +30 -21
  512. package/lib/commonjs/web/browser/FavoriteManager.js.map +1 -1
  513. package/lib/commonjs/web/browser/NavigationErrorManager.js +3 -1
  514. package/lib/commonjs/web/browser/NavigationErrorManager.js.map +1 -1
  515. package/lib/commonjs/web/browser/SearchManager.js +18 -23
  516. package/lib/commonjs/web/browser/SearchManager.js.map +1 -1
  517. package/lib/commonjs/web/browser/assertBrowsePageShape.js +2 -2
  518. package/lib/commonjs/web/browser/assertBrowsePageShape.js.map +1 -1
  519. package/lib/commonjs/web/browser/classifyTrackNavigation.js +9 -9
  520. package/lib/commonjs/web/browser/classifyTrackNavigation.js.map +1 -1
  521. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  522. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  523. package/lib/commonjs/web/browser/sections.js +89 -0
  524. package/lib/commonjs/web/browser/sections.js.map +1 -0
  525. package/lib/commonjs/web/http/RequestConfigBuilder.js +110 -27
  526. package/lib/commonjs/web/http/RequestConfigBuilder.js.map +1 -1
  527. package/lib/commonjs/web/http/followMediaRedirect.js +219 -0
  528. package/lib/commonjs/web/http/followMediaRedirect.js.map +1 -0
  529. package/lib/commonjs/web/player/NowPlayingManager.js +4 -3
  530. package/lib/commonjs/web/player/NowPlayingManager.js.map +1 -1
  531. package/lib/commonjs/web/util/BrowserPathHelper.js +60 -11
  532. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  533. package/lib/module/AudioBrowser.js +2 -4
  534. package/lib/module/AudioBrowser.js.map +1 -1
  535. package/lib/module/CLAUDE.md +57 -0
  536. package/lib/module/features/battery.js +16 -12
  537. package/lib/module/features/battery.js.map +1 -1
  538. package/lib/module/features/browser-config.js +13 -9
  539. package/lib/module/features/browser-config.js.map +1 -1
  540. package/lib/module/features/browser.js +78 -20
  541. package/lib/module/features/browser.js.map +1 -1
  542. package/lib/module/features/carConnection.js +3 -4
  543. package/lib/module/features/carConnection.js.map +1 -1
  544. package/lib/module/features/equalizer.js +9 -5
  545. package/lib/module/features/equalizer.js.map +1 -1
  546. package/lib/module/features/errors.js +35 -21
  547. package/lib/module/features/errors.js.map +1 -1
  548. package/lib/module/features/favorites.js +28 -23
  549. package/lib/module/features/favorites.js.map +1 -1
  550. package/lib/module/features/gate.js +27 -6
  551. package/lib/module/features/gate.js.map +1 -1
  552. package/lib/module/features/metadata.js +59 -11
  553. package/lib/module/features/metadata.js.map +1 -1
  554. package/lib/module/features/network.js +5 -1
  555. package/lib/module/features/network.js.map +1 -1
  556. package/lib/module/features/nowPlaying.js +28 -14
  557. package/lib/module/features/nowPlaying.js.map +1 -1
  558. package/lib/module/features/output.js +9 -4
  559. package/lib/module/features/output.js.map +1 -1
  560. package/lib/module/features/playback/controls.js +13 -6
  561. package/lib/module/features/playback/controls.js.map +1 -1
  562. package/lib/module/features/playback/playWhenReady.js +6 -5
  563. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  564. package/lib/module/features/playback/playing.js +5 -3
  565. package/lib/module/features/playback/playing.js.map +1 -1
  566. package/lib/module/features/playback/progress.js +13 -6
  567. package/lib/module/features/playback/progress.js.map +1 -1
  568. package/lib/module/features/playback/rate.js +8 -1
  569. package/lib/module/features/playback/rate.js.map +1 -1
  570. package/lib/module/features/playback/state.js +5 -6
  571. package/lib/module/features/playback/state.js.map +1 -1
  572. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  573. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  574. package/lib/module/features/playback/volume.js +6 -5
  575. package/lib/module/features/playback/volume.js.map +1 -1
  576. package/lib/module/features/player/options.js +20 -10
  577. package/lib/module/features/player/options.js.map +1 -1
  578. package/lib/module/features/player/setup.js +44 -43
  579. package/lib/module/features/player/setup.js.map +1 -1
  580. package/lib/module/features/player/validateOptions.js +3 -4
  581. package/lib/module/features/player/validateOptions.js.map +1 -1
  582. package/lib/module/features/queue/activeTrack.js +14 -4
  583. package/lib/module/features/queue/activeTrack.js.map +1 -1
  584. package/lib/module/features/queue/queue.js +56 -21
  585. package/lib/module/features/queue/queue.js.map +1 -1
  586. package/lib/module/features/queue/repeatMode.js +2 -1
  587. package/lib/module/features/queue/repeatMode.js.map +1 -1
  588. package/lib/module/features/queue/shuffle.js +0 -1
  589. package/lib/module/features/queue/shuffle.js.map +1 -1
  590. package/lib/module/features/remoteControls.js +59 -35
  591. package/lib/module/features/remoteControls.js.map +1 -1
  592. package/lib/module/features/sleepTimer.js +24 -7
  593. package/lib/module/features/sleepTimer.js.map +1 -1
  594. package/lib/module/test-utils/reactNativeStub.js +58 -0
  595. package/lib/module/test-utils/reactNativeStub.js.map +1 -0
  596. package/lib/module/utils/LazyNativeEmitter.js +18 -10
  597. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  598. package/lib/module/utils/NativeUpdatedValue.js +32 -16
  599. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  600. package/lib/module/utils/getTrackIdentity.js +22 -0
  601. package/lib/module/utils/getTrackIdentity.js.map +1 -0
  602. package/lib/module/utils/useDebug.js +16 -3
  603. package/lib/module/utils/useDebug.js.map +1 -1
  604. package/lib/module/utils/useNativeUpdatedValue.js +13 -21
  605. package/lib/module/utils/useNativeUpdatedValue.js.map +1 -1
  606. package/lib/module/utils/useNativeValueRefreshedBy.js +34 -0
  607. package/lib/module/utils/useNativeValueRefreshedBy.js.map +1 -0
  608. package/lib/module/web/NativeAudioBrowser.js +207 -84
  609. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  610. package/lib/module/web/TrackPlayer/LoadAttempt.js +32 -0
  611. package/lib/module/web/TrackPlayer/LoadAttempt.js.map +1 -0
  612. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js +18 -2
  613. package/lib/module/web/TrackPlayer/PlaybackStateMachine.js.map +1 -1
  614. package/lib/module/web/TrackPlayer/Player.js +256 -40
  615. package/lib/module/web/TrackPlayer/Player.js.map +1 -1
  616. package/lib/module/web/TrackPlayer/PlayingStateFactory.js +1 -1
  617. package/lib/module/web/TrackPlayer/QueueManager.js +14 -0
  618. package/lib/module/web/TrackPlayer/QueueManager.js.map +1 -1
  619. package/lib/module/web/TrackPlayer/QueuePlayer.js +34 -14
  620. package/lib/module/web/TrackPlayer/QueuePlayer.js.map +1 -1
  621. package/lib/module/web/browser/BrowserManager.js +175 -100
  622. package/lib/module/web/browser/BrowserManager.js.map +1 -1
  623. package/lib/module/web/browser/FavoriteManager.js +31 -21
  624. package/lib/module/web/browser/FavoriteManager.js.map +1 -1
  625. package/lib/module/web/browser/NavigationErrorManager.js +3 -1
  626. package/lib/module/web/browser/NavigationErrorManager.js.map +1 -1
  627. package/lib/module/web/browser/SearchManager.js +18 -23
  628. package/lib/module/web/browser/SearchManager.js.map +1 -1
  629. package/lib/module/web/browser/assertBrowsePageShape.js +2 -2
  630. package/lib/module/web/browser/assertBrowsePageShape.js.map +1 -1
  631. package/lib/module/web/browser/classifyTrackNavigation.js +9 -9
  632. package/lib/module/web/browser/classifyTrackNavigation.js.map +1 -1
  633. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  634. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  635. package/lib/module/web/browser/sections.js +83 -0
  636. package/lib/module/web/browser/sections.js.map +1 -0
  637. package/lib/module/web/http/RequestConfigBuilder.js +110 -27
  638. package/lib/module/web/http/RequestConfigBuilder.js.map +1 -1
  639. package/lib/module/web/http/followMediaRedirect.js +215 -0
  640. package/lib/module/web/http/followMediaRedirect.js.map +1 -0
  641. package/lib/module/web/player/NowPlayingManager.js +4 -3
  642. package/lib/module/web/player/NowPlayingManager.js.map +1 -1
  643. package/lib/module/web/util/BrowserPathHelper.js +60 -11
  644. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  645. package/lib/typescript/package.json +1 -0
  646. package/lib/typescript/src/AudioBrowser.d.ts +1 -0
  647. package/lib/typescript/src/AudioBrowser.d.ts.map +1 -1
  648. package/lib/typescript/src/features/battery.d.ts +17 -12
  649. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  650. package/lib/typescript/src/features/browser-config.d.ts.map +1 -1
  651. package/lib/typescript/src/features/browser.d.ts +67 -19
  652. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  653. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  654. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  655. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  656. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  657. package/lib/typescript/src/features/errors.d.ts +37 -22
  658. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  659. package/lib/typescript/src/features/favorites.d.ts +28 -23
  660. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  661. package/lib/typescript/src/features/gate.d.ts +29 -8
  662. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  663. package/lib/typescript/src/features/metadata.d.ts +65 -14
  664. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  665. package/lib/typescript/src/features/network.d.ts +5 -1
  666. package/lib/typescript/src/features/network.d.ts.map +1 -1
  667. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  668. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  669. package/lib/typescript/src/features/output.d.ts +9 -4
  670. package/lib/typescript/src/features/output.d.ts.map +1 -1
  671. package/lib/typescript/src/features/playback/controls.d.ts +13 -6
  672. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  673. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  674. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  675. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  676. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  677. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  678. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  679. package/lib/typescript/src/features/playback/rate.d.ts +8 -1
  680. package/lib/typescript/src/features/playback/rate.d.ts.map +1 -1
  681. package/lib/typescript/src/features/playback/state.d.ts +10 -6
  682. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  683. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  684. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  685. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  686. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  687. package/lib/typescript/src/features/player/options.d.ts +73 -56
  688. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  689. package/lib/typescript/src/features/player/setup.d.ts +129 -73
  690. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  691. package/lib/typescript/src/features/queue/activeTrack.d.ts +8 -2
  692. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  693. package/lib/typescript/src/features/queue/queue.d.ts +50 -19
  694. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  695. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  696. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  697. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  698. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  699. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  700. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  701. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  702. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  703. package/lib/typescript/src/specs/audio-browser.nitro.d.ts +3 -4
  704. package/lib/typescript/src/specs/audio-browser.nitro.d.ts.map +1 -1
  705. package/lib/typescript/src/test-utils/reactNativeStub.d.ts +36 -0
  706. package/lib/typescript/src/test-utils/reactNativeStub.d.ts.map +1 -0
  707. package/lib/typescript/src/types/browser-native.d.ts +3 -2
  708. package/lib/typescript/src/types/browser-native.d.ts.map +1 -1
  709. package/lib/typescript/src/types/browser-nodes.d.ts +401 -143
  710. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  711. package/lib/typescript/src/types/browser.d.ts +248 -173
  712. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  713. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +13 -17
  714. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  715. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +17 -20
  716. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  717. package/lib/typescript/src/utils/getTrackIdentity.d.ts +20 -0
  718. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -0
  719. package/lib/typescript/src/utils/resolveAssetSource.d.ts +1 -2
  720. package/lib/typescript/src/utils/resolveAssetSource.d.ts.map +1 -1
  721. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  722. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  723. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts +4 -4
  724. package/lib/typescript/src/utils/useNativeUpdatedValue.d.ts.map +1 -1
  725. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts +20 -0
  726. package/lib/typescript/src/utils/useNativeValueRefreshedBy.d.ts.map +1 -0
  727. package/nitrogen/generated/android/AudioBrowser+autolinking.cmake +0 -1
  728. package/nitrogen/generated/android/AudioBrowserOnLoad.cpp +4 -2
  729. package/nitrogen/generated/android/c++/JAndroidAudioContentType.hpp +2 -2
  730. package/nitrogen/generated/android/c++/JAndroidAudioOffloadSettings.hpp +2 -2
  731. package/nitrogen/generated/android/c++/JAndroidOptions.hpp +2 -2
  732. package/nitrogen/generated/android/c++/JAndroidPlayerWakeMode.hpp +2 -2
  733. package/nitrogen/generated/android/c++/JAppKilledPlaybackBehavior.hpp +2 -2
  734. package/nitrogen/generated/android/c++/JArtworkRendering.hpp +58 -0
  735. package/nitrogen/generated/android/c++/JArtworkRequestConfig.hpp +10 -5
  736. package/nitrogen/generated/android/c++/JArtworkVariants.hpp +2 -2
  737. package/nitrogen/generated/android/c++/JBatteryOptimizationStatus.hpp +2 -2
  738. package/nitrogen/generated/android/c++/JBatteryOptimizationStatusChangedEvent.hpp +2 -2
  739. package/nitrogen/generated/android/c++/JBatteryWarningPendingChangedEvent.hpp +2 -2
  740. package/nitrogen/generated/android/c++/JBrowseError.hpp +2 -2
  741. package/nitrogen/generated/android/c++/JBrowseResult.hpp +19 -7
  742. package/nitrogen/generated/android/c++/JBrowserSourceCallbackParam.hpp +2 -2
  743. package/nitrogen/generated/android/c++/JCarPlayNowPlayingButton.hpp +2 -2
  744. package/nitrogen/generated/android/c++/JCarPlayPlayingIndicatorLocation.hpp +58 -0
  745. package/nitrogen/generated/android/c++/JCarPlaySiriListButtonPosition.hpp +2 -2
  746. package/nitrogen/generated/android/c++/JCardImage.hpp +58 -0
  747. package/nitrogen/generated/android/c++/JChapterMetadata.hpp +2 -2
  748. package/nitrogen/generated/android/c++/JEqualizerSettings.hpp +10 -10
  749. package/nitrogen/generated/android/c++/JFavoriteChangedEvent.hpp +10 -5
  750. package/nitrogen/generated/android/c++/JFormatNavigationErrorParams.hpp +11 -5
  751. package/nitrogen/generated/android/c++/JFormatNowPlayingParams.hpp +10 -5
  752. package/nitrogen/generated/android/c++/JFormattedNavigationError.hpp +2 -2
  753. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.hpp +2 -2
  754. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  755. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_RequestConfig___Track.hpp +10 -5
  756. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.hpp +4 -2
  757. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.hpp +10 -5
  758. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__optional_std__string____Track.hpp +10 -5
  759. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.hpp +2 -2
  760. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.hpp +2 -2
  761. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.hpp +9 -9
  762. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.hpp +10 -5
  763. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.hpp +2 -2
  764. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.hpp +18 -12
  765. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.hpp +10 -4
  766. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__string__.hpp +102 -0
  767. package/nitrogen/generated/android/c++/JFunc_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.hpp +18 -6
  768. package/nitrogen/generated/android/c++/JFunc_void.hpp +2 -2
  769. package/nitrogen/generated/android/c++/JFunc_void_BatteryOptimizationStatusChangedEvent.hpp +2 -2
  770. package/nitrogen/generated/android/c++/JFunc_void_BatteryWarningPendingChangedEvent.hpp +2 -2
  771. package/nitrogen/generated/android/c++/JFunc_void_EqualizerSettings.hpp +2 -2
  772. package/nitrogen/generated/android/c++/JFunc_void_FavoriteChangedEvent.hpp +10 -5
  773. package/nitrogen/generated/android/c++/JFunc_void_GateEvent.hpp +2 -2
  774. package/nitrogen/generated/android/c++/JFunc_void_NavigationErrorEvent.hpp +2 -2
  775. package/nitrogen/generated/android/c++/JFunc_void_NowPlayingMetadata.hpp +2 -2
  776. package/nitrogen/generated/android/c++/JFunc_void_Options.hpp +4 -7
  777. package/nitrogen/generated/android/c++/JFunc_void_Output.hpp +2 -2
  778. package/nitrogen/generated/android/c++/JFunc_void_Playback.hpp +2 -2
  779. package/nitrogen/generated/android/c++/JFunc_void_PlaybackActiveTrackChangedEvent.hpp +10 -5
  780. package/nitrogen/generated/android/c++/JFunc_void_PlaybackErrorEvent.hpp +2 -2
  781. package/nitrogen/generated/android/c++/JFunc_void_PlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  782. package/nitrogen/generated/android/c++/JFunc_void_PlaybackProgressUpdatedEvent.hpp +2 -2
  783. package/nitrogen/generated/android/c++/JFunc_void_PlaybackQueueEndedEvent.hpp +2 -2
  784. package/nitrogen/generated/android/c++/JFunc_void_PlayingState.hpp +2 -2
  785. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpBackwardEvent.hpp +2 -2
  786. package/nitrogen/generated/android/c++/JFunc_void_RemoteJumpForwardEvent.hpp +2 -2
  787. package/nitrogen/generated/android/c++/JFunc_void_RemotePlayIdEvent.hpp +2 -2
  788. package/nitrogen/generated/android/c++/JFunc_void_RemotePlaySearchEvent.hpp +2 -2
  789. package/nitrogen/generated/android/c++/JFunc_void_RemoteSeekEvent.hpp +2 -2
  790. package/nitrogen/generated/android/c++/JFunc_void_RemoteSkipEvent.hpp +2 -2
  791. package/nitrogen/generated/android/c++/JFunc_void_RepeatModeChangedEvent.hpp +2 -2
  792. package/nitrogen/generated/android/c++/JFunc_void_TimedMetadata.hpp +2 -2
  793. package/nitrogen/generated/android/c++/JFunc_void_TrackMetadata.hpp +2 -2
  794. package/nitrogen/generated/android/c++/JFunc_void_bool.hpp +2 -2
  795. package/nitrogen/generated/android/c++/JFunc_void_double.hpp +2 -2
  796. package/nitrogen/generated/android/c++/JFunc_void_std__optional_FormattedNavigationError_.hpp +2 -2
  797. package/nitrogen/generated/android/c++/JFunc_void_std__optional_ResolvedTrack_.hpp +17 -5
  798. package/nitrogen/generated/android/c++/JFunc_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.hpp +2 -2
  799. package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp +2 -2
  800. package/nitrogen/generated/android/c++/JFunc_void_std__vector_ChapterMetadata_.hpp +16 -16
  801. package/nitrogen/generated/android/c++/JFunc_void_std__vector_Track_.hpp +24 -18
  802. package/nitrogen/generated/android/c++/JGate.hpp +2 -2
  803. package/nitrogen/generated/android/c++/JGateDecision.hpp +2 -2
  804. package/nitrogen/generated/android/c++/JGateEvent.hpp +2 -2
  805. package/nitrogen/generated/android/c++/JGateReason.hpp +2 -2
  806. package/nitrogen/generated/android/c++/JGridTile.hpp +64 -0
  807. package/nitrogen/generated/android/c++/JHttpMethod.hpp +2 -2
  808. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp +77 -44
  809. package/nitrogen/generated/android/c++/JHybridAudioBrowserSpec.hpp +4 -3
  810. package/nitrogen/generated/android/c++/JIOSCategory.hpp +2 -2
  811. package/nitrogen/generated/android/c++/JIOSCategoryMode.hpp +2 -2
  812. package/nitrogen/generated/android/c++/JIOSCategoryOptions.hpp +2 -2
  813. package/nitrogen/generated/android/c++/JIOSCategoryPolicy.hpp +2 -2
  814. package/nitrogen/generated/android/c++/JIOSOptions.hpp +17 -11
  815. package/nitrogen/generated/android/c++/JImageContext.hpp +2 -2
  816. package/nitrogen/generated/android/c++/JImageQueryParams.hpp +2 -2
  817. package/nitrogen/generated/android/c++/JImageShape.hpp +58 -0
  818. package/nitrogen/generated/android/c++/JImageSource.hpp +2 -2
  819. package/nitrogen/generated/android/c++/JMediaReference.hpp +2 -2
  820. package/nitrogen/generated/android/c++/JMediaRequestConfig.hpp +10 -5
  821. package/nitrogen/generated/android/c++/JMediaTransformParams.hpp +2 -2
  822. package/nitrogen/generated/android/c++/JNativeAndroidSetupOptions.hpp +2 -2
  823. package/nitrogen/generated/android/c++/JNativeBrowserConfiguration.hpp +48 -21
  824. package/nitrogen/generated/android/c++/JNativeGateRequest.hpp +2 -2
  825. package/nitrogen/generated/android/c++/JNativeIOSSetupOptions.hpp +10 -10
  826. package/nitrogen/generated/android/c++/JNativeRouteEntry.hpp +16 -4
  827. package/nitrogen/generated/android/c++/JNativeSetupPlayerOptions.hpp +21 -12
  828. package/nitrogen/generated/android/c++/JNativeUpdateOptions.hpp +4 -7
  829. package/nitrogen/generated/android/c++/JNavigationError.hpp +2 -2
  830. package/nitrogen/generated/android/c++/JNavigationErrorEvent.hpp +2 -2
  831. package/nitrogen/generated/android/c++/JNavigationErrorKind.hpp +58 -0
  832. package/nitrogen/generated/android/c++/JNavigationErrorType.hpp +2 -2
  833. package/nitrogen/generated/android/c++/JNitroAndroidUpdateOptions.hpp +2 -2
  834. package/nitrogen/generated/android/c++/JNitroIOSUpdateOptions.hpp +17 -11
  835. package/nitrogen/generated/android/c++/JNowPlayingMetadata.hpp +2 -2
  836. package/nitrogen/generated/android/c++/JNowPlayingUpdate.hpp +2 -2
  837. package/nitrogen/generated/android/c++/JOptions.hpp +4 -7
  838. package/nitrogen/generated/android/c++/JOutput.hpp +2 -2
  839. package/nitrogen/generated/android/c++/JOutputType.hpp +8 -2
  840. package/nitrogen/generated/android/c++/JPlayback.hpp +2 -2
  841. package/nitrogen/generated/android/c++/JPlaybackActiveTrackChangedEvent.hpp +10 -5
  842. package/nitrogen/generated/android/c++/JPlaybackError.hpp +2 -2
  843. package/nitrogen/generated/android/c++/JPlaybackErrorEvent.hpp +2 -2
  844. package/nitrogen/generated/android/c++/JPlaybackErrorKind.hpp +2 -2
  845. package/nitrogen/generated/android/c++/JPlaybackPlayWhenReadyChangedEvent.hpp +2 -2
  846. package/nitrogen/generated/android/c++/JPlaybackProgressUpdatedEvent.hpp +2 -2
  847. package/nitrogen/generated/android/c++/JPlaybackQueueEndedEvent.hpp +2 -2
  848. package/nitrogen/generated/android/c++/JPlaybackState.hpp +2 -2
  849. package/nitrogen/generated/android/c++/JPlayerCapabilities.hpp +7 -13
  850. package/nitrogen/generated/android/c++/JPlayingState.hpp +2 -2
  851. package/nitrogen/generated/android/c++/JProgress.hpp +2 -2
  852. package/nitrogen/generated/android/c++/JRemoteButton.hpp +2 -2
  853. package/nitrogen/generated/android/c++/JRemoteButtonLayout.hpp +10 -10
  854. package/nitrogen/generated/android/c++/JRemoteJumpBackwardEvent.hpp +2 -2
  855. package/nitrogen/generated/android/c++/JRemoteJumpForwardEvent.hpp +2 -2
  856. package/nitrogen/generated/android/c++/JRemoteOutputsOptions.hpp +66 -0
  857. package/nitrogen/generated/android/c++/JRemotePlayIdEvent.hpp +2 -2
  858. package/nitrogen/generated/android/c++/JRemotePlaySearchEvent.hpp +2 -2
  859. package/nitrogen/generated/android/c++/JRemoteSeekEvent.hpp +2 -2
  860. package/nitrogen/generated/android/c++/JRemoteSkipEvent.hpp +2 -2
  861. package/nitrogen/generated/android/c++/JRepeatMode.hpp +2 -2
  862. package/nitrogen/generated/android/c++/JRepeatModeChangedEvent.hpp +2 -2
  863. package/nitrogen/generated/android/c++/JRequestConfig.hpp +2 -2
  864. package/nitrogen/generated/android/c++/JResolvedTrack.hpp +67 -59
  865. package/nitrogen/generated/android/c++/JRetryConfig.hpp +2 -2
  866. package/nitrogen/generated/android/c++/JSearchMode.hpp +2 -2
  867. package/nitrogen/generated/android/c++/JSearchParams.hpp +2 -2
  868. package/nitrogen/generated/android/c++/JSection.hpp +116 -0
  869. package/nitrogen/generated/android/c++/JSectionStyle.hpp +96 -0
  870. package/nitrogen/generated/android/c++/JSleepTimer.hpp +4 -4
  871. package/nitrogen/generated/android/c++/JSleepTimerEndOfTrack.hpp +2 -2
  872. package/nitrogen/generated/android/c++/JSleepTimerTime.hpp +2 -2
  873. package/nitrogen/generated/android/c++/JStallReason.hpp +2 -2
  874. package/nitrogen/generated/android/c++/JStyleDisplay.hpp +58 -0
  875. package/nitrogen/generated/android/c++/JTimedMetadata.hpp +2 -2
  876. package/nitrogen/generated/android/c++/JTrack.hpp +27 -48
  877. package/nitrogen/generated/android/c++/JTrackLoadEvent.hpp +25 -15
  878. package/nitrogen/generated/android/c++/JTrackMetadata.hpp +2 -2
  879. package/nitrogen/generated/android/c++/JTrackRequest.hpp +2 -2
  880. package/nitrogen/generated/android/c++/JTrackStyle.hpp +47 -19
  881. package/nitrogen/generated/android/c++/JTransformableRequestConfig.hpp +2 -2
  882. package/nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.hpp +3 -3
  883. package/nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.hpp +3 -3
  884. package/nitrogen/generated/android/c++/JVariant_NullType_Double.hpp +3 -3
  885. package/nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.hpp +3 -3
  886. package/nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.hpp +20 -8
  887. package/nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.hpp +3 -3
  888. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidAudioOffloadSettings.kt +15 -0
  889. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/AndroidOptions.kt +17 -0
  890. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/{FavoritesMatchMode.kt → ArtworkRendering.kt} +5 -5
  891. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkRequestConfig.kt +37 -0
  892. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ArtworkVariants.kt +15 -0
  893. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryOptimizationStatusChangedEvent.kt +13 -0
  894. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BatteryWarningPendingChangedEvent.kt +13 -0
  895. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseError.kt +13 -0
  896. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowseResult.kt +16 -7
  897. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/BrowserSourceCallbackParam.kt +15 -0
  898. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CarPlayPlayingIndicatorLocation.kt +23 -0
  899. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/CardImage.kt +23 -0
  900. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ChapterMetadata.kt +19 -0
  901. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/EqualizerSettings.kt +27 -0
  902. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteChangedEvent.kt +15 -0
  903. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNavigationErrorParams.kt +25 -3
  904. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormatNowPlayingParams.kt +21 -0
  905. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FormattedNavigationError.kt +15 -0
  906. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___MediaTransformParams.kt +0 -2
  907. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  908. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_RequestConfig___Track.kt +0 -2
  909. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_FormattedNavigationError____FormatNavigationErrorParams.kt +0 -2
  910. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_NowPlayingUpdate____FormatNowPlayingParams.kt +0 -2
  911. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__optional_std__string____Track.kt +0 -2
  912. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_GateDecision_____NativeGateRequest.kt +0 -2
  913. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____MediaTransformParams.kt +0 -2
  914. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____RequestConfig_std__optional_std__unordered_map_std__string__std__string__.kt +0 -2
  915. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_RequestConfig_____Track.kt +0 -2
  916. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_TransformableRequestConfig____.kt +0 -2
  917. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_std__vector_Track______SearchParams.kt +0 -2
  918. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__shared_ptr_Promise_void_____TrackLoadEvent.kt +0 -2
  919. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__string__.kt +78 -0
  920. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError__std__shared_ptr_Promise_std__variant_ResolvedTrack__BrowseError_______BrowserSourceCallbackParam.kt +0 -2
  921. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void.kt +0 -2
  922. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryOptimizationStatusChangedEvent.kt +0 -2
  923. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_BatteryWarningPendingChangedEvent.kt +0 -2
  924. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_EqualizerSettings.kt +0 -2
  925. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_FavoriteChangedEvent.kt +0 -2
  926. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_GateEvent.kt +0 -2
  927. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NavigationErrorEvent.kt +0 -2
  928. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_NowPlayingMetadata.kt +0 -2
  929. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Options.kt +0 -2
  930. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Output.kt +0 -2
  931. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_Playback.kt +0 -2
  932. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackActiveTrackChangedEvent.kt +0 -2
  933. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackErrorEvent.kt +0 -2
  934. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackPlayWhenReadyChangedEvent.kt +0 -2
  935. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackProgressUpdatedEvent.kt +0 -2
  936. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlaybackQueueEndedEvent.kt +0 -2
  937. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_PlayingState.kt +0 -2
  938. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpBackwardEvent.kt +0 -2
  939. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteJumpForwardEvent.kt +0 -2
  940. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlayIdEvent.kt +0 -2
  941. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemotePlaySearchEvent.kt +0 -2
  942. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSeekEvent.kt +0 -2
  943. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RemoteSkipEvent.kt +0 -2
  944. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_RepeatModeChangedEvent.kt +0 -2
  945. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TimedMetadata.kt +0 -2
  946. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_TrackMetadata.kt +0 -2
  947. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_bool.kt +0 -2
  948. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_double.kt +0 -2
  949. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_FormattedNavigationError_.kt +0 -2
  950. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_ResolvedTrack_.kt +0 -2
  951. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__optional_std__variant_nitro__NullType__SleepTimerTime__SleepTimerEndOfTrack__.kt +0 -2
  952. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__string.kt +0 -2
  953. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_ChapterMetadata_.kt +0 -2
  954. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Func_void_std__vector_Track_.kt +0 -2
  955. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Gate.kt +15 -0
  956. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateDecision.kt +15 -0
  957. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GateEvent.kt +13 -0
  958. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/GridTile.kt +25 -0
  959. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/HybridAudioBrowserSpec.kt +7 -1
  960. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/IOSOptions.kt +25 -3
  961. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageContext.kt +15 -0
  962. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageQueryParams.kt +15 -0
  963. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageShape.kt +23 -0
  964. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageSource.kt +19 -0
  965. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaRequestConfig.kt +35 -0
  966. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/MediaTransformParams.kt +15 -0
  967. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeAndroidSetupOptions.kt +31 -0
  968. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeBrowserConfiguration.kt +51 -5
  969. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeGateRequest.kt +17 -0
  970. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeIOSSetupOptions.kt +21 -0
  971. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeRouteEntry.kt +27 -0
  972. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeSetupPlayerOptions.kt +39 -5
  973. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NativeUpdateOptions.kt +23 -0
  974. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationError.kt +19 -0
  975. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorEvent.kt +13 -0
  976. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NavigationErrorKind.kt +23 -0
  977. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroAndroidUpdateOptions.kt +17 -0
  978. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NitroIOSUpdateOptions.kt +25 -3
  979. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingMetadata.kt +29 -0
  980. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/NowPlayingUpdate.kt +17 -0
  981. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Options.kt +23 -0
  982. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Output.kt +17 -0
  983. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/OutputType.kt +3 -1
  984. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Playback.kt +15 -0
  985. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackActiveTrackChangedEvent.kt +21 -0
  986. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackError.kt +21 -0
  987. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackErrorEvent.kt +13 -0
  988. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackPlayWhenReadyChangedEvent.kt +13 -0
  989. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackProgressUpdatedEvent.kt +19 -0
  990. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlaybackQueueEndedEvent.kt +15 -0
  991. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayerCapabilities.kt +37 -2
  992. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/PlayingState.kt +15 -0
  993. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Progress.kt +17 -0
  994. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteButtonLayout.kt +17 -0
  995. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpBackwardEvent.kt +13 -0
  996. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteJumpForwardEvent.kt +13 -0
  997. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteOutputsOptions.kt +61 -0
  998. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlayIdEvent.kt +15 -0
  999. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemotePlaySearchEvent.kt +13 -0
  1000. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSeekEvent.kt +13 -0
  1001. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RemoteSkipEvent.kt +13 -0
  1002. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RepeatModeChangedEvent.kt +13 -0
  1003. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RequestConfig.kt +27 -0
  1004. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ResolvedTrack.kt +67 -15
  1005. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/RetryConfig.kt +17 -0
  1006. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SearchParams.kt +27 -0
  1007. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Section.kt +66 -0
  1008. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SectionStyle.kt +86 -0
  1009. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimer.kt +18 -8
  1010. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerEndOfTrack.kt +13 -0
  1011. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/SleepTimerTime.kt +13 -0
  1012. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/StyleDisplay.kt +23 -0
  1013. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TimedMetadata.kt +21 -0
  1014. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Track.kt +55 -12
  1015. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackLoadEvent.kt +25 -3
  1016. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackMetadata.kt +43 -0
  1017. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackRequest.kt +17 -0
  1018. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TrackStyle.kt +58 -5
  1019. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/TransformableRequestConfig.kt +31 -0
  1020. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_AndroidAudioOffloadSettings.kt +16 -7
  1021. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_RetryConfig.kt +16 -7
  1022. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_Double.kt +16 -7
  1023. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_NullType_RemoteButtonLayout.kt +16 -7
  1024. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.kt +18 -8
  1025. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_String_ArtworkVariants.kt +16 -7
  1026. package/nitrogen/generated/ios/AudioBrowser+autolinking.rb +2 -0
  1027. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.cpp +38 -29
  1028. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Bridge.hpp +800 -644
  1029. package/nitrogen/generated/ios/AudioBrowser-Swift-Cxx-Umbrella.hpp +31 -10
  1030. package/nitrogen/generated/ios/c++/HybridAudioBrowserSpecSwift.hpp +41 -12
  1031. package/nitrogen/generated/ios/swift/ArtworkRendering.swift +40 -0
  1032. package/nitrogen/generated/ios/swift/BrowseResult.swift +12 -0
  1033. package/nitrogen/generated/ios/swift/CarPlayPlayingIndicatorLocation.swift +40 -0
  1034. package/nitrogen/generated/ios/swift/CardImage.swift +40 -0
  1035. package/nitrogen/generated/ios/swift/FormatNavigationErrorParams.swift +7 -2
  1036. package/nitrogen/generated/ios/swift/Func_std__shared_ptr_Promise_std__string__.swift +54 -0
  1037. package/nitrogen/generated/ios/swift/GridTile.swift +48 -0
  1038. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec.swift +2 -1
  1039. package/nitrogen/generated/ios/swift/HybridAudioBrowserSpec_cxx.swift +20 -2
  1040. package/nitrogen/generated/ios/swift/IOSOptions.swift +7 -2
  1041. package/nitrogen/generated/ios/swift/ImageShape.swift +40 -0
  1042. package/nitrogen/generated/ios/swift/NativeBrowserConfiguration.swift +52 -5
  1043. package/nitrogen/generated/ios/swift/NativeSetupPlayerOptions.swift +12 -1
  1044. package/nitrogen/generated/ios/swift/NavigationErrorKind.swift +40 -0
  1045. package/nitrogen/generated/ios/swift/NitroIOSUpdateOptions.swift +12 -1
  1046. package/nitrogen/generated/ios/swift/OutputType.swift +8 -0
  1047. package/nitrogen/generated/ios/swift/PlayerCapabilities.swift +8 -27
  1048. package/nitrogen/generated/ios/swift/RemoteOutputsOptions.swift +78 -0
  1049. package/nitrogen/generated/ios/swift/ResolvedTrack.swift +62 -73
  1050. package/nitrogen/generated/ios/swift/Section.swift +82 -0
  1051. package/nitrogen/generated/ios/swift/SectionStyle.swift +133 -0
  1052. package/nitrogen/generated/ios/swift/SleepTimer.swift +13 -0
  1053. package/nitrogen/generated/ios/swift/StyleDisplay.swift +40 -0
  1054. package/nitrogen/generated/ios/swift/Track.swift +28 -63
  1055. package/nitrogen/generated/ios/swift/TrackLoadEvent.swift +20 -2
  1056. package/nitrogen/generated/ios/swift/TrackStyle.swift +86 -22
  1057. package/nitrogen/generated/ios/swift/Variant_Bool_AndroidAudioOffloadSettings.swift +12 -0
  1058. package/nitrogen/generated/ios/swift/Variant_Bool_RetryConfig.swift +12 -0
  1059. package/nitrogen/generated/ios/swift/Variant_NullType_Double.swift +12 -0
  1060. package/nitrogen/generated/ios/swift/Variant_NullType_RemoteButtonLayout.swift +12 -0
  1061. package/nitrogen/generated/ios/swift/Variant_ResolvedTrack_BrowseError_Promise_BrowseResult_.swift +13 -0
  1062. package/nitrogen/generated/ios/swift/Variant_String_ArtworkVariants.swift +12 -0
  1063. package/nitrogen/generated/shared/c++/{FavoritesMatchMode.hpp → ArtworkRendering.hpp} +17 -17
  1064. package/nitrogen/generated/shared/c++/CarPlayPlayingIndicatorLocation.hpp +76 -0
  1065. package/nitrogen/generated/shared/c++/CardImage.hpp +76 -0
  1066. package/nitrogen/generated/shared/c++/FormatNavigationErrorParams.hpp +9 -2
  1067. package/nitrogen/generated/shared/c++/GridTile.hpp +84 -0
  1068. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp +2 -1
  1069. package/nitrogen/generated/shared/c++/HybridAudioBrowserSpec.hpp +2 -1
  1070. package/nitrogen/generated/shared/c++/IOSOptions.hpp +9 -2
  1071. package/nitrogen/generated/shared/c++/ImageShape.hpp +76 -0
  1072. package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp +10 -6
  1073. package/nitrogen/generated/shared/c++/NativeSetupPlayerOptions.hpp +9 -2
  1074. package/nitrogen/generated/shared/c++/NavigationErrorKind.hpp +76 -0
  1075. package/nitrogen/generated/shared/c++/NitroIOSUpdateOptions.hpp +9 -2
  1076. package/nitrogen/generated/shared/c++/OutputType.hpp +9 -1
  1077. package/nitrogen/generated/shared/c++/PlayerCapabilities.hpp +6 -9
  1078. package/nitrogen/generated/shared/c++/RemoteOutputsOptions.hpp +92 -0
  1079. package/nitrogen/generated/shared/c++/ResolvedTrack.hpp +33 -37
  1080. package/nitrogen/generated/shared/c++/Section.hpp +102 -0
  1081. package/nitrogen/generated/shared/c++/SectionStyle.hpp +126 -0
  1082. package/nitrogen/generated/shared/c++/StyleDisplay.hpp +76 -0
  1083. package/nitrogen/generated/shared/c++/Track.hpp +18 -30
  1084. package/nitrogen/generated/shared/c++/TrackLoadEvent.hpp +7 -2
  1085. package/nitrogen/generated/shared/c++/TrackStyle.hpp +73 -34
  1086. package/package.json +27 -13
  1087. package/src/AudioBrowser.ts +2 -4
  1088. package/src/CLAUDE.md +57 -0
  1089. package/src/docs-floors.test.ts +71 -0
  1090. package/src/features/battery.test.ts +79 -0
  1091. package/src/features/battery.ts +17 -13
  1092. package/src/features/browser-config.test.ts +21 -6
  1093. package/src/features/browser-config.ts +13 -9
  1094. package/src/features/browser.test.ts +1 -1
  1095. package/src/features/browser.ts +69 -20
  1096. package/src/features/carConnection.ts +3 -4
  1097. package/src/features/equalizer.ts +9 -5
  1098. package/src/features/errors.ts +37 -22
  1099. package/src/features/favorites.ts +28 -23
  1100. package/src/features/gate.ts +29 -8
  1101. package/src/features/hook-wiring.test.ts +302 -0
  1102. package/src/features/metadata.ts +80 -14
  1103. package/src/features/network.ts +5 -1
  1104. package/src/features/nowPlaying.ts +28 -14
  1105. package/src/features/output.ts +9 -4
  1106. package/src/features/playback/controls.ts +13 -6
  1107. package/src/features/playback/playWhenReady.ts +6 -5
  1108. package/src/features/playback/playing.ts +16 -3
  1109. package/src/features/playback/progress.test.ts +169 -0
  1110. package/src/features/playback/progress.ts +13 -6
  1111. package/src/features/playback/rate.ts +8 -1
  1112. package/src/features/playback/state.ts +10 -6
  1113. package/src/features/playback/trackPlaybackTime.test.ts +1 -5
  1114. package/src/features/playback/trackPlaybackTime.ts +9 -2
  1115. package/src/features/playback/volume.ts +6 -5
  1116. package/src/features/player/options.ts +81 -62
  1117. package/src/features/player/setup.test.ts +12 -3
  1118. package/src/features/player/setup.ts +141 -76
  1119. package/src/features/player/validateOptions.ts +3 -4
  1120. package/src/features/queue/activeTrack.ts +14 -4
  1121. package/src/features/queue/queue.ts +56 -21
  1122. package/src/features/queue/repeatMode.ts +1 -1
  1123. package/src/features/queue/shuffle.ts +0 -1
  1124. package/src/features/remoteControls.ts +59 -35
  1125. package/src/features/sleepTimer.test.ts +171 -0
  1126. package/src/features/sleepTimer.ts +24 -8
  1127. package/src/nitro-stub-drift.test.ts +277 -0
  1128. package/src/public-surface.test.ts +48 -24
  1129. package/src/specs/audio-browser.nitro.ts +15 -8
  1130. package/src/style-resolution.test.ts +210 -0
  1131. package/src/test-utils/reactNativeStub.ts +60 -0
  1132. package/src/types/browser-native.ts +7 -3
  1133. package/src/types/browser-nodes.ts +417 -151
  1134. package/src/types/browser.ts +254 -177
  1135. package/src/utils/LazyNativeEmitter.ts +17 -10
  1136. package/src/utils/NativeUpdatedValue.ts +30 -16
  1137. package/src/utils/getTrackIdentity.ts +22 -0
  1138. package/src/utils/useDebug.test.ts +182 -0
  1139. package/src/utils/useDebug.ts +16 -3
  1140. package/src/utils/useNativeUpdatedValue.test.ts +111 -0
  1141. package/src/utils/useNativeUpdatedValue.ts +13 -17
  1142. package/src/utils/useNativeValueRefreshedBy.test.ts +68 -0
  1143. package/src/utils/useNativeValueRefreshedBy.ts +45 -0
  1144. package/src/web/NativeAudioBrowser.playWhenReady.test.ts +232 -2
  1145. package/src/web/NativeAudioBrowser.ts +247 -92
  1146. package/src/web/TrackPlayer/LoadAttempt.ts +29 -0
  1147. package/src/web/TrackPlayer/PlaybackStateMachine.test.ts +60 -13
  1148. package/src/web/TrackPlayer/PlaybackStateMachine.ts +22 -6
  1149. package/src/web/TrackPlayer/Player.dispatch.test.ts +50 -5
  1150. package/src/web/TrackPlayer/Player.load.test.ts +137 -1
  1151. package/src/web/TrackPlayer/Player.ts +286 -38
  1152. package/src/web/TrackPlayer/PlayingStateFactory.test.ts +1 -1
  1153. package/src/web/TrackPlayer/PlayingStateFactory.ts +1 -1
  1154. package/src/web/TrackPlayer/QueueManager.test.ts +29 -0
  1155. package/src/web/TrackPlayer/QueueManager.ts +14 -0
  1156. package/src/web/TrackPlayer/QueuePlayer.ts +34 -16
  1157. package/src/web/__tests__/lifecycle.test.ts +345 -0
  1158. package/src/web/__tests__/lifecycleHarness.ts +351 -0
  1159. package/src/web/__tests__/loadEdgeCases.test.ts +246 -0
  1160. package/src/web/__tests__/loadSupersession.test.ts +175 -0
  1161. package/src/web/__tests__/retry.test.ts +169 -0
  1162. package/src/web/browser/BrowserManager.ts +209 -111
  1163. package/src/web/browser/FavoriteManager.test.ts +84 -0
  1164. package/src/web/browser/FavoriteManager.ts +28 -23
  1165. package/src/web/browser/NavigationErrorManager.ts +3 -1
  1166. package/src/web/browser/SearchManager.test.ts +75 -0
  1167. package/src/web/browser/SearchManager.ts +25 -28
  1168. package/src/web/browser/__tests__/artwork-resolution.test.ts +117 -0
  1169. package/src/web/browser/__tests__/layer-resolver.test.ts +35 -0
  1170. package/src/web/browser/__tests__/search-artwork.test.ts +46 -0
  1171. package/src/web/browser/__tests__/search-navigation.test.ts +76 -0
  1172. package/src/web/browser/assertBrowsePageShape.test.ts +1 -1
  1173. package/src/web/browser/assertBrowsePageShape.ts +5 -3
  1174. package/src/web/browser/classifyTrackNavigation.test.ts +10 -8
  1175. package/src/web/browser/classifyTrackNavigation.ts +9 -9
  1176. package/src/web/browser/parseSearchResponse.test.ts +8 -2
  1177. package/src/web/browser/parseSearchResponse.ts +3 -4
  1178. package/src/web/browser/sections.test.ts +91 -0
  1179. package/src/web/browser/sections.ts +72 -0
  1180. package/src/web/http/RequestConfigBuilder.test.ts +241 -1
  1181. package/src/web/http/RequestConfigBuilder.ts +140 -33
  1182. package/src/web/http/followMediaRedirect.test.ts +289 -0
  1183. package/src/web/http/followMediaRedirect.ts +253 -0
  1184. package/src/web/player/NowPlayingManager.ts +4 -3
  1185. package/src/web/util/BrowserPathHelper.test.ts +68 -0
  1186. package/src/web/util/BrowserPathHelper.ts +68 -13
  1187. package/website/guide/android-auto.md +126 -0
  1188. package/website/guide/android-certificates.md +488 -0
  1189. package/website/guide/artwork.md +300 -0
  1190. package/website/guide/audio-output.md +382 -0
  1191. package/website/guide/automotive.md +91 -0
  1192. package/website/guide/basic-usage.md +154 -0
  1193. package/website/guide/battery.md +142 -0
  1194. package/website/guide/browser.md +674 -0
  1195. package/website/guide/carplay.md +733 -0
  1196. package/website/guide/configuration.md +215 -0
  1197. package/website/guide/equalizer.md +235 -0
  1198. package/website/guide/errors.md +359 -0
  1199. package/website/guide/favorites.md +164 -0
  1200. package/website/guide/gate.md +157 -0
  1201. package/website/guide/getting-started.md +99 -0
  1202. package/website/guide/hooks.md +247 -0
  1203. package/website/guide/live-streams.md +189 -0
  1204. package/website/guide/metadata.md +289 -0
  1205. package/website/guide/migrating-from-track-player.md +289 -0
  1206. package/website/guide/native-callback-fetch.md +137 -0
  1207. package/website/guide/network.md +103 -0
  1208. package/website/guide/now-playing.md +203 -0
  1209. package/website/guide/playback.md +405 -0
  1210. package/website/guide/queue.md +334 -0
  1211. package/website/guide/remote-controls.md +314 -0
  1212. package/website/guide/search.md +270 -0
  1213. package/website/guide/sleep-timer.md +289 -0
  1214. package/website/guide/track.md +271 -0
  1215. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +0 -50
  1216. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -68
  1217. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +0 -40
  1218. package/ios/Bridge.h +0 -8
  1219. package/ios/Browser/BrowserManager+URLResolution.swift +0 -380
  1220. package/ios/Browser/MediaResolveComposer.swift +0 -114
  1221. package/ios/CarPlay/ImageRowItem+CarPlay.swift +0 -19
  1222. package/ios/CarPlay/RNABMediaAddHandler.swift +0 -75
  1223. package/ios/CarPlay/RNABMediaAffinityHandler.swift +0 -69
  1224. package/ios/Model/MediaURL.swift +0 -67
  1225. package/ios/Model/SourceType.swift +0 -6
  1226. package/ios/NowPlayingInfo/MediaItemProperty.swift +0 -78
  1227. package/ios/NowPlayingInfo/NowPlayingInfoKeyValue.swift +0 -6
  1228. package/ios/NowPlayingInfo/NowPlayingInfoProperty.swift +0 -220
  1229. package/ios/Observer/PlayerItemNotificationObserver.swift +0 -119
  1230. package/ios/Observer/PlayerItemPropertyObserver.swift +0 -133
  1231. package/ios/Observer/PlayerStateObserver.swift +0 -50
  1232. package/ios/Observer/PlayerTimeObserver.swift +0 -55
  1233. package/ios/Option/PitchAlgorithms.swift +0 -17
  1234. package/ios/Option/TimeEventFrequency.swift +0 -18
  1235. package/ios/Player/EndOfTrackJudgement.swift +0 -32
  1236. package/ios/Player/LoadSeekCoordinator.swift +0 -99
  1237. package/ios/Player/MediaIntentCriteria.swift +0 -139
  1238. package/ios/Player/MediaLoaderDelegate.swift +0 -11
  1239. package/ios/Player/PlaybackCoordinator.swift +0 -754
  1240. package/ios/Player/PlaybackEffectHandler.swift +0 -54
  1241. package/ios/Player/PlaybackErrorHandler.swift +0 -175
  1242. package/ios/Player/PlaybackStateStore.swift +0 -27
  1243. package/ios/Player/PlayingStateManager.swift +0 -33
  1244. package/ios/Player/RetryManager.swift +0 -323
  1245. package/ios/Player/SeekCompletionHandler.swift +0 -3
  1246. package/ios/Player/SleepTimerHandling.swift +0 -15
  1247. package/ios/Support/RNTrackPlayer-Bridging-Header.h +0 -7
  1248. package/ios/Tests/EndOfTrackJudgementTests.swift +0 -35
  1249. package/ios/Tests/LoadSeekCoordinatorTests.swift +0 -327
  1250. package/ios/Tests/MediaResolveTests.swift +0 -126
  1251. package/ios/Tests/OnceValueTests.swift +0 -79
  1252. package/ios/Tests/PlaybackCoordinatorTests.swift +0 -1260
  1253. package/ios/Tests/PlaybackErrorHandlerTests.swift +0 -547
  1254. package/ios/Tests/PlaybackStateStoreTests.swift +0 -48
  1255. package/ios/Tests/PlayingStateManagerTests.swift +0 -57
  1256. package/ios/Tests/RemoteCommandTests.swift +0 -67
  1257. package/ios/Tests/RetryManagerTests.swift +0 -89
  1258. package/ios/TrackPlayer.swift +0 -1014
  1259. package/ios/TrackPlayerCallbacks.swift +0 -53
  1260. package/ios/Util/MetadataAdapter.swift +0 -131
  1261. package/ios/Util/OnceValue.swift +0 -104
  1262. package/nitrogen/generated/android/c++/JFavoriteConfig.hpp +0 -58
  1263. package/nitrogen/generated/android/c++/JFavoritesMatchMode.hpp +0 -58
  1264. package/nitrogen/generated/android/c++/JImageRowItem.hpp +0 -105
  1265. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp +0 -26
  1266. package/nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.hpp +0 -71
  1267. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/FavoriteConfig.kt +0 -38
  1268. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/ImageRowItem.kt +0 -68
  1269. package/nitrogen/generated/android/kotlin/com/margelo/nitro/audiobrowser/Variant_Boolean_FavoriteConfig.kt +0 -53
  1270. package/nitrogen/generated/ios/swift/FavoriteConfig.swift +0 -29
  1271. package/nitrogen/generated/ios/swift/FavoritesMatchMode.swift +0 -40
  1272. package/nitrogen/generated/ios/swift/ImageRowItem.swift +0 -195
  1273. package/nitrogen/generated/ios/swift/Variant_Bool_FavoriteConfig.swift +0 -18
  1274. package/nitrogen/generated/shared/c++/FavoriteConfig.hpp +0 -84
  1275. package/nitrogen/generated/shared/c++/ImageRowItem.hpp +0 -129
@@ -2,8 +2,7 @@ import Foundation
2
2
  import Network
3
3
  import os.log
4
4
 
5
- /// Monitors network connectivity state using NWPathMonitor.
6
- /// Notifies listeners when the connection state changes.
5
+ /// The device's connectivity from NWPathMonitor; `changed` emits each change on the main thread.
7
6
  final class NetworkMonitor: @unchecked Sendable {
8
7
  // MARK: - Properties
9
8
 
@@ -11,52 +10,51 @@ final class NetworkMonitor: @unchecked Sendable {
11
10
  private let monitor: NWPathMonitor
12
11
  private let queue = DispatchQueue(label: "com.audiobrowser.networkmonitor")
13
12
 
14
- /// Current network connectivity state. Must only be set on main thread.
15
- private(set) var isOnline: Bool = false {
16
- didSet {
17
- if oldValue != isOnline {
18
- logger.notice("Network status changed: \(oldValue) -> \(self.isOnline)")
19
- onChanged?(isOnline)
20
- }
13
+ // Guards `_isOnline` only; never held across an emit.
14
+ private let lock = NSLock()
15
+ private var _isOnline = false
16
+
17
+ /// Readable from any thread, so the JS thread's `getOnline` needs no main-queue hop.
18
+ var isOnline: Bool {
19
+ lock.lock()
20
+ defer { lock.unlock() }
21
+ return _isOnline
22
+ }
23
+
24
+ private func apply(_ newStatus: Bool) {
25
+ lock.lock()
26
+ let changed = _isOnline != newStatus
27
+ let oldValue = _isOnline
28
+ _isOnline = newStatus
29
+ lock.unlock()
30
+
31
+ guard changed else { return }
32
+ logger.notice("Network status changed: \(oldValue) -> \(newStatus)")
33
+ DispatchQueue.main.async { [weak self] in
34
+ self?.changed.emit(newStatus)
21
35
  }
22
36
  }
23
37
 
24
- /// Invoked on every connectivity change. Wired centrally in `HybridAudioBrowser.setupPlayer` and
25
- /// fans out to the JS event bridge, the now-playing re-render (so the offline/online label tracks
26
- /// connectivity), and the player's reconnect-reload.
27
- var onChanged: ((Bool) -> Void)?
38
+ let changed = Emitter<Bool>()
28
39
 
29
40
  // MARK: - Initialization
30
41
 
31
42
  init() {
32
43
  monitor = NWPathMonitor()
33
44
 
34
- // Set up handler before starting
45
+ // Seeded before `start`: written after it, a `currentPath` the monitor hasn't finished
46
+ // evaluating could clobber the handler's real update. The handler stays the last writer.
47
+ let initialStatus = monitor.currentPath.status.isOnline
48
+ logger.notice("NetworkMonitor initialized, initial isOnline=\(initialStatus)")
49
+ _isOnline = initialStatus
50
+
35
51
  monitor.pathUpdateHandler = { [weak self] path in
36
- let newStatus = path.status == .satisfied
37
- DispatchQueue.main.async { [weak self] in
38
- self?.isOnline = newStatus
39
- }
52
+ self?.apply(path.status.isOnline)
40
53
  }
41
54
 
42
- // Start monitoring
43
55
  monitor.start(queue: queue)
44
-
45
- // Read initial state after starting (currentPath is now valid)
46
- let initialStatus = monitor.currentPath.status == .satisfied
47
- logger.notice("NetworkMonitor initialized, initial isOnline=\(initialStatus)")
48
- isOnline = initialStatus
49
- }
50
-
51
- // MARK: - Public Methods
52
-
53
- /// Gets the current network connectivity state.
54
- /// - Returns: true if device is online, false otherwise
55
- func getOnline() -> Bool {
56
- isOnline
57
56
  }
58
57
 
59
- /// Stops monitoring and cleans up resources.
60
58
  func destroy() {
61
59
  monitor.cancel()
62
60
  }
@@ -0,0 +1,48 @@
1
+ import AVKit
2
+ import os.log
3
+ import UIKit
4
+
5
+ /// Presents the system audio route picker over the topmost view controller.
6
+ @MainActor
7
+ enum OutputPicker {
8
+ private static let logger = Logger(subsystem: "com.audiobrowser", category: "OutputPicker")
9
+
10
+ static func present() {
11
+ guard let windowScene = UIApplication.shared.activeWindowScene,
12
+ let window = windowScene.windows.first(where: { $0.isKeyWindow }),
13
+ var topController = window.rootViewController
14
+ else {
15
+ logger.error("openOutputPicker: no active window scene / root view controller")
16
+ return
17
+ }
18
+ while let presented = topController.presentedViewController {
19
+ topController = presented
20
+ }
21
+
22
+ // AVRoutePickerView has no API to present its picker, so its internal button is tapped. The
23
+ // view must be visible to the system (a hidden source view suppresses the picker), and the
24
+ // button can sit below the top-level subviews.
25
+ let routePicker = AVRoutePickerView(frame: CGRect(x: 0, y: 0, width: 1, height: 1))
26
+ routePicker.alpha = 0.01
27
+ topController.view.addSubview(routePicker)
28
+
29
+ if let button = firstButton(in: routePicker) {
30
+ button.sendActions(for: .touchUpInside)
31
+ } else {
32
+ logger.error("openOutputPicker: no UIButton found inside AVRoutePickerView")
33
+ }
34
+
35
+ // On iPad the picker's popover anchors to this view, so it outlives the tap.
36
+ DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
37
+ routePicker.removeFromSuperview()
38
+ }
39
+ }
40
+
41
+ private static func firstButton(in view: UIView) -> UIButton? {
42
+ if let button = view as? UIButton { return button }
43
+ for subview in view.subviews {
44
+ if let button = firstButton(in: subview) { return button }
45
+ }
46
+ return nil
47
+ }
48
+ }
@@ -0,0 +1,57 @@
1
+ import Foundation
2
+
3
+ /// A value that exists once `provider` returns one. Nothing is cached, so the provider's current
4
+ /// answer always wins; the provider is not polled, so the owner calls `check()` when it may have
5
+ /// become non-nil.
6
+ @MainActor
7
+ final class ReadyValue<T: Sendable> {
8
+ private let provider: () -> T?
9
+ private var waiters: [UUID: CheckedContinuation<T?, Never>] = [:]
10
+
11
+ init(provider: @escaping () -> T?) {
12
+ self.provider = provider
13
+ }
14
+
15
+ var waiterCount: Int {
16
+ waiters.count
17
+ }
18
+
19
+ /// Resumes every parked waiter if the provider now has a value.
20
+ func check() {
21
+ guard !waiters.isEmpty, let value = provider() else { return }
22
+ let pending = waiters
23
+ waiters = [:]
24
+ for waiter in pending.values {
25
+ waiter.resume(returning: value)
26
+ }
27
+ }
28
+
29
+ /// The provider's value, waiting for it when there is none yet. Nil when the calling task is
30
+ /// cancelled or `timeout` elapses first.
31
+ func wait(timeout: Duration? = nil) async -> T? {
32
+ if let value = provider() { return value }
33
+ let id = UUID()
34
+ let timer = timeout.map { timeout in
35
+ Task { [weak self] in
36
+ try? await Task.sleep(for: timeout)
37
+ self?.resume(id, with: nil)
38
+ }
39
+ }
40
+ defer { timer?.cancel() }
41
+ return await withTaskCancellationHandler {
42
+ await withCheckedContinuation { continuation in
43
+ if Task.isCancelled {
44
+ continuation.resume(returning: nil)
45
+ } else {
46
+ waiters[id] = continuation
47
+ }
48
+ }
49
+ } onCancel: {
50
+ Task { @MainActor [weak self] in self?.resume(id, with: nil) }
51
+ }
52
+ }
53
+
54
+ private func resume(_ id: UUID, with value: T?) {
55
+ waiters.removeValue(forKey: id)?.resume(returning: value)
56
+ }
57
+ }
@@ -1,77 +1,53 @@
1
1
  import os.log
2
2
  import UIKit
3
3
 
4
- /// Renders SF Symbols to PNG files in the caches directory.
5
- /// Returns `file://` URIs usable by both React Native's `<Image>` and native image loaders.
4
+ /// Renders SF Symbols to PNG files in the caches directory, as `file://` URIs that
5
+ /// React Native's `<Image>` and native image loaders both accept.
6
6
  ///
7
- /// Artwork format: `sf:symbol.name?bg=#RRGGBB&fg=#RRGGBB`
8
- /// - `bg`: background color (default: transparent)
9
- /// - `fg`: foreground/symbol color (default: #000000)
7
+ /// Artwork format: `sf:symbol.name?bg=#RRGGBB&fg=#RRGGBB` (3- or 6-digit hex).
8
+ /// `bg` defaults to transparent, `fg` to black.
10
9
  final class SFSymbolRenderer: @unchecked Sendable {
11
10
  @MainActor static let shared = SFSymbolRenderer()
12
11
  static let defaultCanvasSize = CGSize(width: 200, height: 200)
13
12
 
13
+ // Part of the cache filename: bump it whenever the rendering changes. The caches
14
+ // directory survives app updates and the existence check is the only validation,
15
+ // so without a bump devices keep serving the old pixels.
16
+ private static let renderVersion = 1
17
+
14
18
  private let logger = Logger(subsystem: "com.audiobrowser", category: "SFSymbolRenderer")
15
19
  private let scale: CGFloat
16
20
  private let cacheDirectory: URL
17
21
 
18
22
  @MainActor
19
23
  private init() {
20
- scale = UIScreen.main.scale
24
+ scale = appDisplayScale
21
25
 
22
26
  let caches = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask)[0]
23
27
  cacheDirectory = caches.appendingPathComponent("sf-symbols", isDirectory: true)
24
28
  try? FileManager.default.createDirectory(at: cacheDirectory, withIntermediateDirectories: true)
25
29
  }
26
30
 
27
- /// Renders an SF Symbol to a PNG file and returns its `file://` URI.
28
- ///
29
- /// Skips rendering if the file already exists on disk.
30
- ///
31
- /// - Parameters:
32
- /// - artworkValue: The artwork string (e.g. "sf:heart.fill?bg=#000&fg=#fff" or "heart.fill")
33
- /// - canvasSize: The canvas size in points (rendered at device scale)
34
- /// - Returns: A file URI string, or nil if the symbol doesn't exist or rendering fails
31
+ /// Returns the `file://` URI of the PNG for `artworkValue` (with or without the `sf:`
32
+ /// prefix), rendering it only when no file for it exists yet. `canvasSize` is in points,
33
+ /// drawn at device scale. Nil when there is no such symbol or the file can't be written.
35
34
  func render(_ artworkValue: String, canvasSize: CGSize = defaultCanvasSize) -> String? {
36
- let (symbolName, backgroundColor, symbolColor) = Self.parseArtwork(artworkValue)
37
-
38
- // Validate symbol exists before any filesystem work
39
- let symbolPointSize = min(canvasSize.width, canvasSize.height) * 0.45
40
- let config = UIImage.SymbolConfiguration(pointSize: symbolPointSize, weight: .medium)
41
- guard let symbol = UIImage(systemName: symbolName, withConfiguration: config) else {
42
- return nil
43
- }
44
-
45
35
  let safeArtwork = artworkValue.unicodeScalars
46
36
  .filter { CharacterSet.alphanumerics.contains($0) || $0 == "_" }
47
37
  .map(String.init).joined()
48
- let fileName = "\(safeArtwork)_\(Int(canvasSize.width))x\(Int(canvasSize.height))_\(Int(scale))x"
38
+ let fileName =
39
+ "\(safeArtwork)_\(Int(canvasSize.width))x\(Int(canvasSize.height))_\(Int(scale))x_v\(Self.renderVersion)"
49
40
  let fileURL = cacheDirectory.appendingPathComponent("\(fileName).png")
50
41
 
51
42
  if FileManager.default.fileExists(atPath: fileURL.path) {
52
43
  return fileURL.absoluteString
53
44
  }
54
45
 
55
- let renderer = UIGraphicsImageRenderer(size: canvasSize, format: {
56
- let fmt = UIGraphicsImageRendererFormat()
57
- fmt.scale = scale
58
- return fmt
59
- }())
60
-
61
- let pngData = renderer.pngData { _ in
62
- if let backgroundColor {
63
- backgroundColor.setFill()
64
- UIRectFill(CGRect(origin: .zero, size: canvasSize))
65
- }
66
-
67
- let symbolSize = symbol.size
68
- let x = (canvasSize.width - symbolSize.width) / 2
69
- let y = (canvasSize.height - symbolSize.height) / 2
70
-
71
- (symbolColor ?? .black).set()
72
- symbol.withRenderingMode(.alwaysTemplate)
73
- .draw(in: CGRect(x: x, y: y, width: symbolSize.width, height: symbolSize.height))
74
- }
46
+ let (symbolName, backgroundColor, symbolColor) = Self.parseArtwork(artworkValue)
47
+ guard let pngData = Self.image(
48
+ name: symbolName, canvasSize: canvasSize, scale: scale,
49
+ tint: symbolColor ?? .black, background: backgroundColor,
50
+ )?.pngData() else { return nil }
75
51
 
76
52
  do {
77
53
  try pngData.write(to: fileURL, options: .atomic)
@@ -83,13 +59,42 @@ final class SFSymbolRenderer: @unchecked Sendable {
83
59
  return fileURL.absoluteString
84
60
  }
85
61
 
86
- /// Whether the given artwork string is an SF Symbol reference.
62
+ /// Draws the symbol at 45% of the canvas, centred and tinted, over `background` (nil leaves it
63
+ /// transparent). Nil when there is no symbol of that name.
64
+ static func image(
65
+ name: String,
66
+ canvasSize: CGSize,
67
+ scale: CGFloat,
68
+ tint: UIColor,
69
+ background: UIColor?,
70
+ ) -> UIImage? {
71
+ let pointSize = min(canvasSize.width, canvasSize.height) * 0.45
72
+ let config = UIImage.SymbolConfiguration(pointSize: pointSize, weight: .medium)
73
+ guard let symbol = UIImage(systemName: name, withConfiguration: config) else { return nil }
74
+ let format = UIGraphicsImageRendererFormat()
75
+ format.scale = scale
76
+ return UIGraphicsImageRenderer(size: canvasSize, format: format).image { _ in
77
+ if let background {
78
+ background.setFill()
79
+ UIRectFill(CGRect(origin: .zero, size: canvasSize))
80
+ }
81
+ let size = symbol.size
82
+ tint.set()
83
+ symbol.withRenderingMode(.alwaysTemplate).draw(in: CGRect(
84
+ x: (canvasSize.width - size.width) / 2,
85
+ y: (canvasSize.height - size.height) / 2,
86
+ width: size.width,
87
+ height: size.height,
88
+ ))
89
+ }.withRenderingMode(.alwaysOriginal) // Keeps the drawn tint inside a tinted view.
90
+ }
91
+
87
92
  static func isSFSymbol(_ artwork: String) -> Bool {
88
93
  artwork.hasPrefix("sf:")
89
94
  }
90
95
 
91
- /// Parses an SF Symbol artwork string into symbol name and resolved colors.
92
- /// `"sf:heart.fill?bg=#000&fg=#fff"` → `("heart.fill", bg: black, fg: white)`
96
+ /// `"sf:heart.fill?bg=#000&fg=#fff"` → `("heart.fill", black, white)`; a colour that is
97
+ /// absent is nil, one that is not 3 or 6 characters long is black.
93
98
  static func parseArtwork(_ value: String) -> (symbolName: String, backgroundColor: UIColor?, symbolColor: UIColor?) {
94
99
  let (symbolName, params) = parseArtworkValue(value)
95
100
  let bg = params["bg"].map { UIColor(hex: $0) }
@@ -97,8 +102,6 @@ final class SFSymbolRenderer: @unchecked Sendable {
97
102
  return (symbolName, bg, fg)
98
103
  }
99
104
 
100
- /// Parses an SF Symbol artwork string, stripping the `sf:` prefix if present.
101
- /// `"sf:heart.fill?bg=#000&fg=#fff"` → `("heart.fill", ["bg": "000", "fg": "fff"])`
102
105
  private static func parseArtworkValue(_ value: String) -> (symbolName: String, params: [String: String]) {
103
106
  let stripped = value.hasPrefix("sf:") ? String(value.dropFirst(3)) : value
104
107
  guard let questionMark = stripped.firstIndex(of: "?") else {
@@ -119,6 +122,8 @@ final class SFSymbolRenderer: @unchecked Sendable {
119
122
  }
120
123
 
121
124
  extension UIColor {
125
+ /// `#` optional. Any length but 3 or 6 is black; the digits are not validated
126
+ /// (`init(declaredHex:)` does that).
122
127
  convenience init(hex: String) {
123
128
  let hex = hex.trimmingCharacters(in: CharacterSet(charactersIn: "#"))
124
129
  var rgb: UInt64 = 0
@@ -139,4 +144,14 @@ extension UIColor {
139
144
  self.init(white: 0, alpha: 1)
140
145
  }
141
146
  }
147
+
148
+ /// Nil unless 3 or 6 hex digits (`#` optional), so an unparseable declared colour
149
+ /// (`style.cardTint`) falls back to the system default instead of black.
150
+ convenience init?(declaredHex hex: String) {
151
+ let digits = hex.trimmingCharacters(in: CharacterSet(charactersIn: "#"))
152
+ guard [3, 6].contains(digits.count),
153
+ digits.allSatisfy(\.isHexDigit)
154
+ else { return nil }
155
+ self.init(hex: hex)
156
+ }
142
157
  }
@@ -2,20 +2,24 @@ import Kingfisher
2
2
  import SwiftDraw
3
3
  import UIKit
4
4
 
5
- /// Kingfisher processor that renders SVG data to UIImage using SwiftDraw.
5
+ /// Kingfisher processor that rasterizes SVG data with SwiftDraw.
6
6
  struct SVGProcessor: ImageProcessor {
7
- let identifier = "com.audiobrowser.svgprocessor"
7
+ // Kingfisher keys its cache on the URL and this identifier only (`.scaleFactor` is
8
+ // not in the key), so every render parameter must be here or different
9
+ // rasterizations of one URL collide.
10
+ var identifier: String {
11
+ "com.audiobrowser.svgprocessor(\(size?.width ?? -1)x\(size?.height ?? -1)@\(scale))"
12
+ }
8
13
 
9
- /// Target size for rendering (in points). If nil, uses SVG's intrinsic size.
14
+ /// Points; nil renders at the SVG's intrinsic size.
10
15
  let size: CGSize?
11
16
 
12
- /// Scale factor for rendering. Resolved at init time to avoid MainActor issues.
13
17
  let scale: CGFloat
14
18
 
15
19
  @MainActor
16
20
  init(size: CGSize? = nil, scale: CGFloat? = nil) {
17
21
  self.size = size
18
- self.scale = scale ?? UIScreen.main.scale
22
+ self.scale = scale ?? appDisplayScale
19
23
  }
20
24
 
21
25
  func process(item: ImageProcessItem, options _: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? {
@@ -23,7 +27,6 @@ struct SVGProcessor: ImageProcessor {
23
27
  case let .data(data):
24
28
  return renderSVG(from: data)
25
29
  case let .image(image):
26
- // Already an image, return as-is
27
30
  return image
28
31
  @unknown default:
29
32
  return nil
@@ -44,13 +47,3 @@ struct SVGProcessor: ImageProcessor {
44
47
  return svg.rasterize(size: renderSize, scale: scale)
45
48
  }
46
49
  }
47
-
48
- // MARK: - Kingfisher Options Extension
49
-
50
- extension KingfisherOptionsInfoItem {
51
- /// Returns an SVG processor option for Kingfisher.
52
- @MainActor
53
- static func svgProcessor(size: CGSize? = nil, scale: CGFloat? = nil) -> KingfisherOptionsInfoItem {
54
- .processor(SVGProcessor(size: size, scale: scale))
55
- }
56
- }
@@ -0,0 +1,45 @@
1
+ /// At most one task in flight: `run` and `cancel` cancel the one before, and a result is
2
+ /// delivered only while its task is the latest, so a cancelled or superseded task delivers nothing.
3
+ /// A `run` with the latest run's non-nil key is skipped until `cancel`: that run, in flight or
4
+ /// done, already answers it through its own `deliver`. Only a non-nil answer keeps the key: after a
5
+ /// nil answer or a failure, the next run asks again.
6
+ @MainActor
7
+ final class SupersedingTask<Key: Equatable, Value: Sendable> {
8
+ private var generation: UInt = 0
9
+ private var task: Task<Void, Never>?
10
+ private var key: Key?
11
+
12
+ func run(
13
+ key: Key?,
14
+ _ work: @escaping @MainActor () async throws -> Value?,
15
+ deliver: @escaping @MainActor (Result<Value?, Error>) -> Void,
16
+ ) {
17
+ if key != nil, key == self.key { return }
18
+ cancel()
19
+ self.key = key
20
+ let generation = generation
21
+ task = Task { [weak self] in
22
+ let result: Result<Value?, Error>
23
+ do {
24
+ result = try await .success(work())
25
+ } catch {
26
+ result = .failure(error)
27
+ }
28
+ guard let self, self.generation == generation else { return }
29
+ self.task = nil
30
+ if (try? result.get()) == nil { self.key = nil }
31
+ deliver(result)
32
+ }
33
+ }
34
+
35
+ deinit {
36
+ task?.cancel()
37
+ }
38
+
39
+ func cancel() {
40
+ generation &+= 1
41
+ task?.cancel()
42
+ task = nil
43
+ key = nil
44
+ }
45
+ }
@@ -25,6 +25,17 @@ Object.keys(_types).forEach(function (key) {
25
25
  }
26
26
  });
27
27
  });
28
+ var _getTrackIdentity = require("./utils/getTrackIdentity");
29
+ Object.keys(_getTrackIdentity).forEach(function (key) {
30
+ if (key === "default" || key === "__esModule") return;
31
+ if (key in exports && exports[key] === _getTrackIdentity[key]) return;
32
+ Object.defineProperty(exports, key, {
33
+ enumerable: true,
34
+ get: function () {
35
+ return _getTrackIdentity[key];
36
+ }
37
+ });
38
+ });
28
39
  var _useDebug = require("./utils/useDebug");
29
40
  Object.keys(_useDebug).forEach(function (key) {
30
41
  if (key === "default" || key === "__esModule") return;
@@ -1 +1 @@
1
- {"version":3,"names":["_features","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_types","_useDebug"],"sourceRoot":"../../src","sources":["AudioBrowser.ts"],"mappings":";;;;;AAIA,IAAAA,SAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,SAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,SAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,SAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,MAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,MAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,MAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,SAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,SAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,SAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,SAAA,CAAAN,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
1
+ {"version":3,"names":["_features","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_types","_getTrackIdentity","_useDebug"],"sourceRoot":"../../src","sources":["AudioBrowser.ts"],"mappings":";;;;;AACA,IAAAA,SAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,SAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,SAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,SAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,MAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,MAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,MAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,iBAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,iBAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,iBAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,iBAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,SAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,SAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,SAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,SAAA,CAAAP,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
@@ -0,0 +1,57 @@
1
+ # TypeScript API
2
+
3
+ The rules here are about the shape of the package's public surface. The first
4
+ is enforced by `public-surface.test.ts`, which only tells you _after_ you've
5
+ written it; the second is a convention no test checks.
6
+
7
+ ## Everything you export is public
8
+
9
+ `index.ts` → `AudioBrowser.ts` → `features/index.ts` is a chain of unfiltered
10
+ `export *`. There is no allowlist to add a symbol to: a new `export` in any
11
+ feature module joins the package's public surface the moment you write it.
12
+
13
+ `@internal` does **not** make a value private. `stripInternal` honours it when
14
+ building `lib/typescript` — what a consumer's TypeScript sees — but React Native
15
+ resolves `"react-native": "src/index"`, so Metro bundles the _source_, where
16
+ nothing was stripped. An `@internal` value is invisible to the type checker and
17
+ fully reachable at runtime via `require()`.
18
+
19
+ So an internal value needs a module the barrels don't re-export, imported
20
+ directly by its callers — `features/player/validateOptions.ts` is the pattern.
21
+ Types are exempt: they have no runtime representation, so `stripInternal` really
22
+ does remove them, and `@internal` is enough.
23
+
24
+ `native.ts` is the sharp case and stays out of the barrel permanently. It holds
25
+ the raw Nitro object, whose `on*` properties are single callback slots that the
26
+ emitters below already occupy — a consumer assigning one unsubscribes every hook
27
+ in the library. Feature modules import it relatively; nothing else touches it.
28
+
29
+ `public-surface.test.ts` walks the `export *` graph and fails on any reachable
30
+ value that is `@internal`, `__`-prefixed, or `nativeBrowser`.
31
+
32
+ ## Events are emitters, not functions
33
+
34
+ Every `on*` export is an object you subscribe to with `addListener(cb)`, which
35
+ returns an unsubscribe function. Never export a bare `on*(cb)` subscribe
36
+ function — that split is what made the whole remote-controls guide a compile
37
+ error until it was unified.
38
+
39
+ Two emitter classes, picked by what the event _is_:
40
+
41
+ - `NativeUpdatedValue` — state with a current value (playback, options,
42
+ progress). Subscribes to native at module load so no update is missed; hooks
43
+ read the matching getter, never a cached payload.
44
+ - `LazyNativeEmitter` — discrete events with no current value (remote controls,
45
+ gate hits). Assigns the native callback on the first `addListener`, so an
46
+ event nobody listens to costs nothing.
47
+
48
+ Both are created via `emitterize(cb => (nativeBrowser.onThing = cb))` and both
49
+ return the instance. Neither class is exported from the package.
50
+
51
+ No test checks this rule: `features/hook-wiring.test.ts` only records which
52
+ native slot each emitter claims, so a bare `export function onThing(cb)` would
53
+ pass the suite. Review is what catches it.
54
+
55
+ `on*` observes; `handle*` overrides. `handleRemoteNext(cb)` is a plain setter
56
+ that replaces the default behaviour and takes `undefined` to clear it, while
57
+ `onRemoteNext` fires on every press regardless of who handled it.
@@ -14,14 +14,6 @@ exports.useBatteryWarningPending = useBatteryWarningPending;
14
14
  var _native = require("../native");
15
15
  var _NativeUpdatedValue = require("../utils/NativeUpdatedValue");
16
16
  var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
17
- /**
18
- * Battery optimization status and warning handling for Android 12+ foreground service restrictions.
19
- *
20
- * When an external controller (Bluetooth, car head unit) tries to resume playback while the app
21
- * is killed and battery restrictions are in place, Android 12+ blocks the foreground service start.
22
- * This module exposes APIs to detect this condition and guide users to fix their settings.
23
- */
24
-
25
17
  // MARK: - Types
26
18
 
27
19
  /**
@@ -44,7 +36,10 @@ var _useNativeUpdatedValue = require("../utils/useNativeUpdatedValue");
44
36
 
45
37
  /**
46
38
  * Check if a battery warning is pending (Android only).
47
- * Returns true if a foreground service start was blocked and the user hasn't dismissed
39
+ * On Android 12+, when a Bluetooth or car controller resumes playback while the
40
+ * app is killed and battery restrictions apply, the system blocks the foreground
41
+ * service start.
42
+ * Returns true if such a start was blocked and the user hasn't dismissed
48
43
  * the warning or fixed their battery settings.
49
44
  * Auto-clears when battery status becomes unrestricted.
50
45
  * @returns true if warning is pending, always false on iOS
@@ -55,7 +50,6 @@ function getBatteryWarningPending() {
55
50
 
56
51
  /**
57
52
  * Get the current battery optimization status (Android only).
58
- * Also fires onBatteryOptimizationStatusChanged if status changed since last call.
59
53
  * @returns Current status, always 'unrestricted' on iOS
60
54
  */
61
55
  function getBatteryOptimizationStatus() {
@@ -74,7 +68,12 @@ function dismissBatteryWarning() {
74
68
  }
75
69
 
76
70
  /**
77
- * Open the system battery settings for this app (Android only).
71
+ * Prompt the user to lift this app's battery restriction (Android only).
72
+ * With status `'optimized'` it starts the system's one-tap "ignore battery
73
+ * optimizations" dialog. Android shows that dialog only if the app's manifest
74
+ * declares `android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS`, which the
75
+ * library does not declare; without it nothing appears. With any other status it
76
+ * opens the app's App info page.
78
77
  * No-op on iOS.
79
78
  */
80
79
  function openBatterySettings() {
@@ -93,7 +92,8 @@ const onBatteryWarningPendingChanged = exports.onBatteryWarningPendingChanged =
93
92
 
94
93
  /**
95
94
  * Subscribes to battery optimization status changes (Android only).
96
- * Fires when user returns from settings with a different status.
95
+ * Fires when the app comes to the foreground with a different status from the
96
+ * one it had at the previous foreground, typically on return from settings.
97
97
  * Never fires on iOS.
98
98
  */
99
99
  const onBatteryOptimizationStatusChanged = exports.onBatteryOptimizationStatusChanged = _NativeUpdatedValue.NativeUpdatedValue.emitterize(cb => _native.nativeBrowser.onBatteryOptimizationStatusChanged = cb);
@@ -124,6 +124,10 @@ function useBatteryOptimizationStatus() {
124
124
  * Meta hook that bundles all battery warning state and actions (Android only).
125
125
  * Use this for a complete battery warning UI implementation.
126
126
  *
127
+ * On Android 12+, when a Bluetooth or car controller resumes playback while the
128
+ * app is killed and battery restrictions apply, the system blocks the foreground
129
+ * service start. See the [Battery guide](https://audiobrowser.dev/guide/battery).
130
+ *
127
131
  * @example
128
132
  * ```tsx
129
133
  * function BatteryWarningBanner() {
@@ -1 +1 @@
1
- {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getBatteryWarningPending","nativeBrowser","getBatteryOptimizationStatus","dismissBatteryWarning","openBatterySettings","onBatteryWarningPendingChanged","exports","NativeUpdatedValue","emitterize","cb","onBatteryOptimizationStatusChanged","useBatteryWarningPending","useNativeUpdatedValue","useBatteryOptimizationStatus","useBatteryWarning","pending","status","dismiss","openSettings"],"sourceRoot":"../../../src","sources":["features/battery.ts"],"mappings":";;;;;;;;;;;;;AAQA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAVA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AAKA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,wBAAwBA,CAAA,EAAY;EAClD,OAAOC,qBAAa,CAACD,wBAAwB,CAAC,CAAC;AACjD;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASE,4BAA4BA,CAAA,EAA8B;EACxE,OAAOD,qBAAa,CAACC,4BAA4B,CAAC,CAAC;AACrD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,qBAAqBA,CAAA,EAAS;EAC5CF,qBAAa,CAACE,qBAAqB,CAAC,CAAC;AACvC;;AAEA;AACA;AACA;AACA;AACO,SAASC,mBAAmBA,CAAA,EAAS;EAC1CH,qBAAa,CAACG,mBAAmB,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,8BAA8B,GAAAC,OAAA,CAAAD,8BAAA,GACzCE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMR,qBAAa,CAACI,8BAA8B,GAAGI,EAC1D,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACO,MAAMC,kCAAkC,GAAAJ,OAAA,CAAAI,kCAAA,GAC7CH,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMR,qBAAa,CAACS,kCAAkC,GAAGD,EAC9D,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASE,wBAAwBA,CAAA,EAAY;EAClD,OAAO,IAAAC,4CAAqB,EAC1BZ,wBAAwB,EACxBK,8BAA8B,EAC9B,SACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACO,SAASQ,4BAA4BA,CAAA,EAA8B;EACxE,OAAO,IAAAD,4CAAqB,EAC1BV,4BAA4B,EAC5BQ,kCAAkC,EAClC,QACF,CAAC;AACH;;AAEA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,iBAAiBA,CAAA,EAAmB;EAClD,MAAMC,OAAO,GAAGJ,wBAAwB,CAAC,CAAC;EAC1C,MAAMK,MAAM,GAAGH,4BAA4B,CAAC,CAAC;EAE7C,OAAO;IACLE,OAAO;IACPC,MAAM;IACNC,OAAO,EAAEd,qBAAqB;IAC9Be,YAAY,EAAEd;EAChB,CAAC;AACH","ignoreList":[]}
1
+ {"version":3,"names":["_native","require","_NativeUpdatedValue","_useNativeUpdatedValue","getBatteryWarningPending","nativeBrowser","getBatteryOptimizationStatus","dismissBatteryWarning","openBatterySettings","onBatteryWarningPendingChanged","exports","NativeUpdatedValue","emitterize","cb","onBatteryOptimizationStatusChanged","useBatteryWarningPending","useNativeUpdatedValue","useBatteryOptimizationStatus","useBatteryWarning","pending","status","dismiss","openSettings"],"sourceRoot":"../../../src","sources":["features/battery.ts"],"mappings":";;;;;;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AAKA;AACA;AACA;;AAKA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,wBAAwBA,CAAA,EAAY;EAClD,OAAOC,qBAAa,CAACD,wBAAwB,CAAC,CAAC;AACjD;;AAEA;AACA;AACA;AACA;AACO,SAASE,4BAA4BA,CAAA,EAA8B;EACxE,OAAOD,qBAAa,CAACC,4BAA4B,CAAC,CAAC;AACrD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,qBAAqBA,CAAA,EAAS;EAC5CF,qBAAa,CAACE,qBAAqB,CAAC,CAAC;AACvC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,mBAAmBA,CAAA,EAAS;EAC1CH,qBAAa,CAACG,mBAAmB,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,8BAA8B,GAAAC,OAAA,CAAAD,8BAAA,GACzCE,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMR,qBAAa,CAACI,8BAA8B,GAAGI,EAC1D,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,kCAAkC,GAAAJ,OAAA,CAAAI,kCAAA,GAC7CH,sCAAkB,CAACC,UAAU,CAC1BC,EAAE,IAAMR,qBAAa,CAACS,kCAAkC,GAAGD,EAC9D,CAAC;;AAEH;;AAEA;AACA;AACA;AACA;AACO,SAASE,wBAAwBA,CAAA,EAAY;EAClD,OAAO,IAAAC,4CAAqB,EAC1BZ,wBAAwB,EACxBK,8BAA8B,EAC9B,SACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACO,SAASQ,4BAA4BA,CAAA,EAA8B;EACxE,OAAO,IAAAD,4CAAqB,EAC1BV,4BAA4B,EAC5BQ,kCAAkC,EAClC,QACF,CAAC;AACH;;AAEA;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,iBAAiBA,CAAA,EAAmB;EAClD,MAAMC,OAAO,GAAGJ,wBAAwB,CAAC,CAAC;EAC1C,MAAMK,MAAM,GAAGH,4BAA4B,CAAC,CAAC;EAE7C,OAAO;IACLE,OAAO;IACPC,MAAM;IACNC,OAAO,EAAEd,qBAAqB;IAC9Be,YAAY,EAAEd;EAChB,CAAC;AACH","ignoreList":[]}