react-native-audio-browser 0.2.0-next.53 → 0.2.0-next.55

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 (599) hide show
  1. package/README.md +32 -19
  2. package/android/src/cast/java/com/audiobrowser/cast/CastSupport.kt +8 -10
  3. package/android/src/main/java/com/audiobrowser/AudioBrowser.kt +96 -243
  4. package/android/src/main/java/com/audiobrowser/AudioBrowserLifecycleModule.kt +8 -12
  5. package/android/src/main/java/com/audiobrowser/AudioBrowserPackage.kt +1 -3
  6. package/android/src/main/java/com/audiobrowser/Callbacks.kt +1 -10
  7. package/android/src/main/java/com/audiobrowser/ForegroundStart.kt +13 -18
  8. package/android/src/main/java/com/audiobrowser/HeadlessTaskService.kt +3 -7
  9. package/android/src/main/java/com/audiobrowser/RemoteOutputs.kt +8 -10
  10. package/android/src/main/java/com/audiobrowser/Service.kt +20 -61
  11. package/android/src/main/java/com/audiobrowser/ServiceBinding.kt +9 -17
  12. package/android/src/main/java/com/audiobrowser/browser/ArtworkResolutionRegistry.kt +10 -9
  13. package/android/src/main/java/com/audiobrowser/browser/BrowseArtworkRegistry.kt +11 -8
  14. package/android/src/main/java/com/audiobrowser/browser/BrowserManager.kt +117 -448
  15. package/android/src/main/java/com/audiobrowser/browser/BrowserUrlResolution.kt +21 -60
  16. package/android/src/main/java/com/audiobrowser/browser/InertStyleDiagnostic.kt +20 -80
  17. package/android/src/main/java/com/audiobrowser/browser/JsonArtwork.kt +6 -10
  18. package/android/src/main/java/com/audiobrowser/browser/JsonModels.kt +7 -24
  19. package/android/src/main/java/com/audiobrowser/browser/RouteMatch.kt +2 -4
  20. package/android/src/main/java/com/audiobrowser/browser/SectionScope.kt +13 -31
  21. package/android/src/main/java/com/audiobrowser/browser/SimpleRouter.kt +12 -40
  22. package/android/src/main/java/com/audiobrowser/browser/StyleResolver.kt +15 -26
  23. package/android/src/main/java/com/audiobrowser/browser/TrackLoadHandler.kt +5 -15
  24. package/android/src/main/java/com/audiobrowser/extension/EnumExtensions.kt +1 -0
  25. package/android/src/main/java/com/audiobrowser/extension/NumberExt.kt +2 -0
  26. package/android/src/main/java/com/audiobrowser/extension/ResolvedTrackExt.kt +4 -8
  27. package/android/src/main/java/com/audiobrowser/extension/TappedTrack.kt +4 -6
  28. package/android/src/main/java/com/audiobrowser/extension/TrackIdentity.kt +3 -7
  29. package/android/src/main/java/com/audiobrowser/http/HttpClient.kt +13 -22
  30. package/android/src/main/java/com/audiobrowser/http/RequestConfigBuilder.kt +17 -38
  31. package/android/src/main/java/com/audiobrowser/model/IcyTitle.kt +5 -6
  32. package/android/src/main/java/com/audiobrowser/model/PlaybackMetadata.kt +4 -9
  33. package/android/src/main/java/com/audiobrowser/model/PlayerSetupOptions.kt +18 -29
  34. package/android/src/main/java/com/audiobrowser/model/PlayerUpdateOptions.kt +6 -16
  35. package/android/src/main/java/com/audiobrowser/player/AutomaticBufferManager.kt +15 -45
  36. package/android/src/main/java/com/audiobrowser/player/CapabilityControls.kt +23 -59
  37. package/android/src/main/java/com/audiobrowser/player/CrossOriginHeaderStripper.kt +14 -26
  38. package/android/src/main/java/com/audiobrowser/player/DynamicLoadControl.kt +15 -43
  39. package/android/src/main/java/com/audiobrowser/player/EnginePlayback.kt +4 -4
  40. package/android/src/main/java/com/audiobrowser/player/EqualizerController.kt +15 -21
  41. package/android/src/main/java/com/audiobrowser/player/InterceptingPlayer.kt +14 -31
  42. package/android/src/main/java/com/audiobrowser/player/LocalEngine.kt +8 -8
  43. package/android/src/main/java/com/audiobrowser/player/MediaFactory.kt +16 -27
  44. package/android/src/main/java/com/audiobrowser/player/MediaSessionCallback.kt +119 -237
  45. package/android/src/main/java/com/audiobrowser/player/MediaSessionCommandManager.kt +48 -145
  46. package/android/src/main/java/com/audiobrowser/player/NowPlayingUpdater.kt +39 -100
  47. package/android/src/main/java/com/audiobrowser/player/PlaybackErrorClassifier.kt +16 -26
  48. package/android/src/main/java/com/audiobrowser/player/PlaybackStateMachine.kt +22 -28
  49. package/android/src/main/java/com/audiobrowser/player/PlaybackStateStore.kt +28 -64
  50. package/android/src/main/java/com/audiobrowser/player/PlaybackTimer.kt +8 -4
  51. package/android/src/main/java/com/audiobrowser/player/Player.kt +117 -405
  52. package/android/src/main/java/com/audiobrowser/player/PlayerCapabilitiesExt.kt +1 -1
  53. package/android/src/main/java/com/audiobrowser/player/PlayerEngineFactory.kt +11 -19
  54. package/android/src/main/java/com/audiobrowser/player/PlayerListener.kt +30 -96
  55. package/android/src/main/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicy.kt +39 -95
  56. package/android/src/main/java/com/audiobrowser/player/ShuffleOrderLedBy.kt +7 -13
  57. package/android/src/main/java/com/audiobrowser/player/SleepTimer.kt +13 -30
  58. package/android/src/main/java/com/audiobrowser/player/SleepTimerManager.kt +7 -11
  59. package/android/src/main/java/com/audiobrowser/player/StuckRecoveryPolicy.kt +9 -22
  60. package/android/src/main/java/com/audiobrowser/player/TransformingDataSource.kt +22 -54
  61. package/android/src/main/java/com/audiobrowser/player/VolumeFader.kt +8 -15
  62. package/android/src/main/java/com/audiobrowser/remote/RemoteItem.kt +9 -8
  63. package/android/src/main/java/com/audiobrowser/remote/RemoteOutputsController.kt +13 -10
  64. package/android/src/main/java/com/audiobrowser/remote/RemotePlayback.kt +8 -8
  65. package/android/src/main/java/com/audiobrowser/remote/RemoteQueue.kt +12 -5
  66. package/android/src/main/java/com/audiobrowser/remote/RemoteSwitchingPlayer.kt +28 -48
  67. package/android/src/main/java/com/audiobrowser/sonos/DeviceDescriptionParser.kt +11 -19
  68. package/android/src/main/java/com/audiobrowser/sonos/DidlLite.kt +2 -2
  69. package/android/src/main/java/com/audiobrowser/sonos/SoapClient.kt +6 -6
  70. package/android/src/main/java/com/audiobrowser/sonos/SoapEnvelopes.kt +8 -9
  71. package/android/src/main/java/com/audiobrowser/sonos/SoapResponseParser.kt +11 -18
  72. package/android/src/main/java/com/audiobrowser/sonos/SonosDiscoverer.kt +10 -10
  73. package/android/src/main/java/com/audiobrowser/sonos/SonosOutputs.kt +10 -10
  74. package/android/src/main/java/com/audiobrowser/sonos/SonosPlayer.kt +21 -33
  75. package/android/src/main/java/com/audiobrowser/sonos/SonosRemote.kt +4 -6
  76. package/android/src/main/java/com/audiobrowser/sonos/SonosRouteProviderService.kt +9 -10
  77. package/android/src/main/java/com/audiobrowser/sonos/SonosStreamUri.kt +7 -7
  78. package/android/src/main/java/com/audiobrowser/sonos/SonosTransport.kt +5 -4
  79. package/android/src/main/java/com/audiobrowser/sonos/SsdpDiscovery.kt +8 -3
  80. package/android/src/main/java/com/audiobrowser/sonos/SsdpMessages.kt +4 -6
  81. package/android/src/main/java/com/audiobrowser/sonos/ZoneGroupState.kt +13 -11
  82. package/android/src/main/java/com/audiobrowser/tls/AiaCertChaser.kt +34 -71
  83. package/android/src/main/java/com/audiobrowser/tls/AiaChasingExtendedTrustManager.kt +20 -37
  84. package/android/src/main/java/com/audiobrowser/tls/AiaChasingTrustManager.kt +18 -27
  85. package/android/src/main/java/com/audiobrowser/tls/AiaTls.kt +14 -29
  86. package/android/src/main/java/com/audiobrowser/tls/CachingCertificateFetcher.kt +68 -133
  87. package/android/src/main/java/com/audiobrowser/util/ArtworkContentProvider.kt +10 -22
  88. package/android/src/main/java/com/audiobrowser/util/ArtworkRoutes.kt +6 -6
  89. package/android/src/main/java/com/audiobrowser/util/ArtworkUris.kt +4 -3
  90. package/android/src/main/java/com/audiobrowser/util/ArtworkVariant.kt +2 -13
  91. package/android/src/main/java/com/audiobrowser/util/Automotive.kt +2 -4
  92. package/android/src/main/java/com/audiobrowser/util/BatteryOptimizationHelper.kt +3 -9
  93. package/android/src/main/java/com/audiobrowser/util/BatteryWarningStore.kt +4 -14
  94. package/android/src/main/java/com/audiobrowser/util/BrowserPathHelper.kt +21 -85
  95. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoader.kt +7 -7
  96. package/android/src/main/java/com/audiobrowser/util/CoilArtworkLoaderHolder.kt +5 -8
  97. package/android/src/main/java/com/audiobrowser/util/CoilBitmapLoader.kt +8 -24
  98. package/android/src/main/java/com/audiobrowser/util/EqualizerManager.kt +7 -39
  99. package/android/src/main/java/com/audiobrowser/util/MediaExtrasBuilder.kt +10 -14
  100. package/android/src/main/java/com/audiobrowser/util/MetadataAdapter.kt +5 -9
  101. package/android/src/main/java/com/audiobrowser/util/NetworkConnectivityMonitor.kt +5 -9
  102. package/android/src/main/java/com/audiobrowser/util/OutputMonitor.kt +21 -50
  103. package/android/src/main/java/com/audiobrowser/util/OutputSwitcher.kt +7 -20
  104. package/android/src/main/java/com/audiobrowser/util/PlayingStateFactory.kt +3 -5
  105. package/android/src/main/java/com/audiobrowser/util/RatingFavorites.kt +4 -5
  106. package/android/src/main/java/com/audiobrowser/util/StyleWire.kt +5 -5
  107. package/android/src/main/java/com/audiobrowser/util/SvgArtworkRenderer.kt +5 -9
  108. package/android/src/main/java/com/audiobrowser/util/SystemVolumeMonitor.kt +6 -9
  109. package/android/src/main/java/com/audiobrowser/util/TrackFactory.kt +25 -47
  110. package/android/src/nocast/java/com/audiobrowser/cast/CastSupport.kt +0 -2
  111. package/android/src/test/java/com/audiobrowser/ForegroundStartTest.kt +1 -2
  112. package/android/src/test/java/com/audiobrowser/LegacyRatingTest.kt +3 -3
  113. package/android/src/test/java/com/audiobrowser/ServiceBindingTest.kt +0 -13
  114. package/android/src/test/java/com/audiobrowser/ServiceTaskRemovedTest.kt +2 -3
  115. package/android/src/test/java/com/audiobrowser/TestFixtures.kt +5 -14
  116. package/android/src/test/java/com/audiobrowser/browser/BrowseArtworkRegistryTest.kt +1 -1
  117. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerBuildApiRequestTest.kt +2 -8
  118. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerFavoritesTest.kt +2 -12
  119. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerLayerResolutionTest.kt +5 -28
  120. package/android/src/test/java/com/audiobrowser/browser/BrowserManagerTest.kt +11 -43
  121. package/android/src/test/java/com/audiobrowser/browser/BrowserUrlResolutionTest.kt +4 -13
  122. package/android/src/test/java/com/audiobrowser/browser/InertStyleDiagnosticTest.kt +2 -11
  123. package/android/src/test/java/com/audiobrowser/browser/JsonArtworkTest.kt +0 -2
  124. package/android/src/test/java/com/audiobrowser/browser/JsonStyleTest.kt +3 -8
  125. package/android/src/test/java/com/audiobrowser/browser/SectionScopeTest.kt +2 -14
  126. package/android/src/test/java/com/audiobrowser/browser/SimpleRouterTest.kt +1 -5
  127. package/android/src/test/java/com/audiobrowser/browser/StyleResolverTest.kt +2 -13
  128. package/android/src/test/java/com/audiobrowser/extension/TappedTrackTest.kt +1 -7
  129. package/android/src/test/java/com/audiobrowser/extension/TrackIdentityTest.kt +0 -5
  130. package/android/src/test/java/com/audiobrowser/http/RequestConfigBuilderTest.kt +8 -16
  131. package/android/src/test/java/com/audiobrowser/model/IcyTitleTest.kt +1 -1
  132. package/android/src/test/java/com/audiobrowser/player/BrowseTilesTest.kt +12 -29
  133. package/android/src/test/java/com/audiobrowser/player/CapabilityControlsTest.kt +3 -12
  134. package/android/src/test/java/com/audiobrowser/player/CrossOriginHeaderStripperTest.kt +0 -7
  135. package/android/src/test/java/com/audiobrowser/player/DynamicLoadControlTest.kt +0 -1
  136. package/android/src/test/java/com/audiobrowser/player/EqualizerControllerTest.kt +0 -9
  137. package/android/src/test/java/com/audiobrowser/player/LiveSeekCommandTest.kt +1 -2
  138. package/android/src/test/java/com/audiobrowser/player/MediaSessionSlotMappingTest.kt +0 -9
  139. package/android/src/test/java/com/audiobrowser/player/NowPlayingUpdaterTest.kt +15 -22
  140. package/android/src/test/java/com/audiobrowser/player/PlaybackErrorClassifierTest.kt +1 -24
  141. package/android/src/test/java/com/audiobrowser/player/PlaybackStateMachineTest.kt +0 -20
  142. package/android/src/test/java/com/audiobrowser/player/PlaybackStateStoreTrackJsonTest.kt +1 -6
  143. package/android/src/test/java/com/audiobrowser/player/PlaybackTimerTest.kt +2 -4
  144. package/android/src/test/java/com/audiobrowser/player/PlayerCastTest.kt +2 -2
  145. package/android/src/test/java/com/audiobrowser/player/PlayerEngineFactoryTest.kt +0 -3
  146. package/android/src/test/java/com/audiobrowser/player/PlayerInvalidTrackTest.kt +0 -1
  147. package/android/src/test/java/com/audiobrowser/player/PlayerSetupTest.kt +3 -2
  148. package/android/src/test/java/com/audiobrowser/player/PlayerSonosTest.kt +5 -1
  149. package/android/src/test/java/com/audiobrowser/player/PlayerSuppressionTest.kt +5 -7
  150. package/android/src/test/java/com/audiobrowser/player/RetryLoadErrorHandlingPolicyTest.kt +4 -35
  151. package/android/src/test/java/com/audiobrowser/player/SessionErrorMaskTest.kt +0 -5
  152. package/android/src/test/java/com/audiobrowser/player/ShuffleOrderLedByTest.kt +1 -8
  153. package/android/src/test/java/com/audiobrowser/player/StandardSkipTest.kt +4 -6
  154. package/android/src/test/java/com/audiobrowser/player/StuckRecoveryPolicyTest.kt +11 -11
  155. package/android/src/test/java/com/audiobrowser/player/TransformingDataSourceTest.kt +2 -23
  156. package/android/src/test/java/com/audiobrowser/remote/FakeRemote.kt +9 -10
  157. package/android/src/test/java/com/audiobrowser/remote/RemoteSwitchingPlayerTest.kt +0 -1
  158. package/android/src/test/java/com/audiobrowser/sonos/DeviceDescriptionParserTest.kt +1 -3
  159. package/android/src/test/java/com/audiobrowser/sonos/DidlLiteTest.kt +0 -1
  160. package/android/src/test/java/com/audiobrowser/sonos/SoapClientTest.kt +0 -3
  161. package/android/src/test/java/com/audiobrowser/sonos/SoapEnvelopesTest.kt +0 -1
  162. package/android/src/test/java/com/audiobrowser/sonos/SoapResponseParserTest.kt +0 -1
  163. package/android/src/test/java/com/audiobrowser/sonos/SonosDiscovererTest.kt +2 -0
  164. package/android/src/test/java/com/audiobrowser/sonos/SonosPlayerTest.kt +0 -1
  165. package/android/src/test/java/com/audiobrowser/sonos/SonosRemoteTest.kt +1 -1
  166. package/android/src/test/java/com/audiobrowser/sonos/SonosRoutesTest.kt +2 -0
  167. package/android/src/test/java/com/audiobrowser/sonos/SonosTransportTest.kt +2 -6
  168. package/android/src/test/java/com/audiobrowser/sonos/SsdpMessagesTest.kt +0 -2
  169. package/android/src/test/java/com/audiobrowser/tls/AiaCertChaserTest.kt +13 -37
  170. package/android/src/test/java/com/audiobrowser/tls/AiaChasingTrustManagerTest.kt +10 -24
  171. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherCallSiteTest.kt +15 -39
  172. package/android/src/test/java/com/audiobrowser/tls/CachingCertificateFetcherTest.kt +4 -10
  173. package/android/src/test/java/com/audiobrowser/util/ArtworkContentProviderTest.kt +2 -11
  174. package/android/src/test/java/com/audiobrowser/util/ArtworkUrisTest.kt +0 -1
  175. package/android/src/test/java/com/audiobrowser/util/BrowserPathHelperTest.kt +0 -4
  176. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderHolderTest.kt +1 -1
  177. package/android/src/test/java/com/audiobrowser/util/CoilArtworkLoaderTest.kt +0 -5
  178. package/android/src/test/java/com/audiobrowser/util/FakeImageLoader.kt +2 -2
  179. package/android/src/test/java/com/audiobrowser/util/MediaExtrasBuilderTest.kt +4 -12
  180. package/android/src/test/java/com/audiobrowser/util/OutputMonitorTest.kt +1 -1
  181. package/android/src/test/java/com/audiobrowser/util/PlayingStateFactoryTest.kt +0 -4
  182. package/android/src/test/java/com/audiobrowser/util/TrackFactoryBrowseTest.kt +1 -1
  183. package/android/src/test/java/com/audiobrowser/util/TrackFactoryMediaIdTest.kt +4 -6
  184. package/android/src/testCast/java/com/audiobrowser/cast/CastEndsTest.kt +1 -1
  185. package/android/src/testCast/java/com/audiobrowser/cast/SendingMediaItemConverterTest.kt +1 -0
  186. package/ios/AVPlayerEngine.swift +13 -21
  187. package/ios/AVPlayerEngineCallbacks.swift +2 -4
  188. package/ios/Browser/BrowseGate.swift +7 -8
  189. package/ios/Browser/BrowserConfig.swift +19 -34
  190. package/ios/Browser/BrowserError.swift +0 -1
  191. package/ios/Browser/BrowserManager.swift +29 -75
  192. package/ios/Browser/BrowserPathHelper.swift +13 -93
  193. package/ios/Browser/FavoriteSet.swift +7 -10
  194. package/ios/Browser/InertStyleDiagnostic.swift +17 -82
  195. package/ios/Browser/JsonModels.swift +11 -51
  196. package/ios/Browser/NavigationErrorState.swift +3 -2
  197. package/ios/Browser/PageResolver.swift +13 -23
  198. package/ios/Browser/RequestLayer.swift +16 -20
  199. package/ios/Browser/RequestPipeline.swift +33 -43
  200. package/ios/Browser/SearchDrillIn.swift +7 -13
  201. package/ios/Browser/SectionScope.swift +14 -26
  202. package/ios/Browser/SimpleRouter.swift +8 -15
  203. package/ios/Browser/StyleResolver.swift +12 -29
  204. package/ios/Browser/TabBarEntries.swift +6 -11
  205. package/ios/Browser/TrackIdTemplate.swift +6 -14
  206. package/ios/CarPlay/CPInterfaceController+Safe.swift +19 -28
  207. package/ios/CarPlay/CarPlayArtworkResolver.swift +5 -9
  208. package/ios/CarPlay/CarPlayController.swift +4 -4
  209. package/ios/CarPlay/CarPlayImageLoader.swift +11 -26
  210. package/ios/CarPlay/CarPlayListItemFactory.swift +30 -80
  211. package/ios/CarPlay/CarPlayNowPlayingManager.swift +19 -54
  212. package/ios/CarPlay/CarPlaySession+Navigator.swift +10 -10
  213. package/ios/CarPlay/CarPlaySession+PageLoader.swift +6 -5
  214. package/ios/CarPlay/CarPlaySession+Refresher.swift +2 -2
  215. package/ios/CarPlay/CarPlaySession+TabBar.swift +19 -26
  216. package/ios/CarPlay/CarPlaySession.swift +13 -17
  217. package/ios/CarPlay/CarPlayTemplates.swift +6 -7
  218. package/ios/CarPlay/IntentHandlers.swift +3 -5
  219. package/ios/CarPlay/MediaIntentCriteria.swift +15 -29
  220. package/ios/CarPlay/MediaIntentHandler.swift +4 -7
  221. package/ios/CarPlay/MediaIntentPlayback.swift +9 -8
  222. package/ios/CarPlay/NowPlayingButtonRules.swift +3 -4
  223. package/ios/CarPlay/SectionPresentation.swift +18 -28
  224. package/ios/CarPlay/TopTemplateReplacer.swift +8 -9
  225. package/ios/Extension/Capability+RemoteCommand.swift +3 -3
  226. package/ios/Extension/ChapterMetadata+AVFoundation.swift +2 -5
  227. package/ios/Extension/CxxVectorConformances.swift +4 -16
  228. package/ios/Extension/NavigationError+Conversion.swift +4 -7
  229. package/ios/Extension/PlayerCapabilities+Favorite.swift +0 -1
  230. package/ios/Extension/RequestConfig+Copying.swift +2 -6
  231. package/ios/Extension/ResolvedTrack+Copying.swift +2 -8
  232. package/ios/Extension/SearchParams+Query.swift +4 -4
  233. package/ios/Extension/Section+Copying.swift +3 -6
  234. package/ios/Extension/String+IcyCharset.swift +5 -5
  235. package/ios/Extension/TimedMetadata+AVFoundation.swift +6 -12
  236. package/ios/Extension/Track+AVPlayer.swift +1 -2
  237. package/ios/Extension/Track+Copying.swift +2 -8
  238. package/ios/Extension/Track+Identity.swift +4 -9
  239. package/ios/Extension/TrackMetadata+AVFoundation.swift +10 -13
  240. package/ios/Extension/UIApplication+ActiveScene.swift +6 -14
  241. package/ios/Extension/Variant+Artwork.swift +8 -22
  242. package/ios/Http/HttpClient.swift +3 -3
  243. package/ios/HybridAudioBrowser+Browser.swift +10 -16
  244. package/ios/HybridAudioBrowser+Options.swift +6 -9
  245. package/ios/HybridAudioBrowser+Player.swift +8 -16
  246. package/ios/HybridAudioBrowser+PlayerCallbacks.swift +4 -5
  247. package/ios/HybridAudioBrowser+Stubs.swift +5 -7
  248. package/ios/HybridAudioBrowser.swift +54 -79
  249. package/ios/Model/NitroTypeStubs.swift +15 -22
  250. package/ios/Model/PlayerUpdateOptions.swift +6 -21
  251. package/ios/Model/RemoteCommand.swift +2 -2
  252. package/ios/Model/TrackPlayerError.swift +9 -22
  253. package/ios/NowPlayingInfo/NowPlayingInfoController.swift +21 -40
  254. package/ios/NowPlayingInfo/SilentAudioPrimer.swift +10 -16
  255. package/ios/Observer/ItemObserver.swift +7 -5
  256. package/ios/Observer/PlayerObserver.swift +5 -5
  257. package/ios/PlaybackEvent.swift +2 -2
  258. package/ios/Player/AirPlayStallJudgement.swift +7 -9
  259. package/ios/Player/AudioSessionController.swift +14 -15
  260. package/ios/Player/DeferredSeek.swift +2 -2
  261. package/ios/Player/EndOfTrackJudgement.swift +6 -13
  262. package/ios/Player/ErrorStatus.swift +8 -7
  263. package/ios/Player/MediaLoader.swift +20 -24
  264. package/ios/Player/NowPlayingLines.swift +1 -4
  265. package/ios/Player/NowPlayingUpdater.swift +35 -61
  266. package/ios/Player/PersistedPlaybackState.swift +1 -2
  267. package/ios/Player/PlaybackFailure.swift +20 -24
  268. package/ios/Player/PlaybackPersistence.swift +5 -6
  269. package/ios/Player/PlaybackStateMachine.swift +8 -11
  270. package/ios/Player/PlaybackTimer.swift +8 -11
  271. package/ios/Player/Player.swift +6 -13
  272. package/ios/Player/PlayerEngine.swift +20 -20
  273. package/ios/Player/PlayerStatusTypes.swift +1 -2
  274. package/ios/Player/QueueManager.swift +23 -67
  275. package/ios/Player/RetryLoop.swift +39 -50
  276. package/ios/Player/ShuffleOrder.swift +17 -57
  277. package/ios/Player/SleepTimerManager.swift +13 -28
  278. package/ios/Player/VolumeFader.swift +16 -16
  279. package/ios/RemoteCommand/RemoteCommandCallbacks.swift +6 -16
  280. package/ios/RemoteCommand/RemoteCommandController.swift +8 -10
  281. package/ios/Tests/AirPlayStallJudgementTests.swift +4 -4
  282. package/ios/Tests/BrowserPathHelperTests.swift +3 -6
  283. package/ios/Tests/DeferredSeekTests.swift +1 -3
  284. package/ios/Tests/EmitterTests.swift +0 -1
  285. package/ios/Tests/EndOfTrackJudgementTests.swift +1 -6
  286. package/ios/Tests/FavoriteSetTests.swift +1 -0
  287. package/ios/Tests/GenerationMemoTests.swift +2 -2
  288. package/ios/Tests/InertStyleDiagnosticTests.swift +4 -10
  289. package/ios/Tests/JsonModelsTests.swift +5 -12
  290. package/ios/Tests/LRUCacheTests.swift +1 -5
  291. package/ios/Tests/MediaIntentCriteriaTests.swift +2 -7
  292. package/ios/Tests/MediaLoaderTests.swift +3 -12
  293. package/ios/Tests/ObserverTests.swift +3 -3
  294. package/ios/Tests/PlaybackErrorTests.swift +7 -9
  295. package/ios/Tests/PlaybackFailureTests.swift +9 -17
  296. package/ios/Tests/PlaybackPersistenceTests.swift +1 -0
  297. package/ios/Tests/PlaybackStateMachineTests.swift +1 -16
  298. package/ios/Tests/PlaybackTimerTests.swift +2 -3
  299. package/ios/Tests/PlayerPolicyTests.swift +10 -26
  300. package/ios/Tests/PlayerTests.swift +53 -88
  301. package/ios/Tests/PlayingStateTests.swift +0 -1
  302. package/ios/Tests/QueueManagerTests.swift +30 -80
  303. package/ios/Tests/RemoteCommandControllerTests.swift +5 -13
  304. package/ios/Tests/ResolvedTrackCopyingTests.swift +0 -2
  305. package/ios/Tests/RetryLoopTests.swift +12 -35
  306. package/ios/Tests/SearchDrillInTests.swift +4 -5
  307. package/ios/Tests/SectionPresentationTests.swift +3 -16
  308. package/ios/Tests/SectionScopeTests.swift +3 -6
  309. package/ios/Tests/SimpleRouterTests.swift +1 -5
  310. package/ios/Tests/SleepTimerManagerTests.swift +8 -11
  311. package/ios/Tests/StyleResolverTests.swift +4 -13
  312. package/ios/Tests/Support/ManualSleepTimerScheduler.swift +3 -8
  313. package/ios/Tests/Support/TestTypes.swift +5 -15
  314. package/ios/Tests/TabBarEntriesTests.swift +0 -2
  315. package/ios/Tests/TimedMetadataAVFoundationTests.swift +2 -3
  316. package/ios/Tests/TopTemplateReplacerTests.swift +1 -1
  317. package/ios/Tests/TrackIdTemplateTests.swift +2 -6
  318. package/ios/Tests/TrackMetadataAVFoundationTests.swift +1 -4
  319. package/ios/Tests/TrackSelectorTests.swift +3 -15
  320. package/ios/TrackSelector.swift +13 -25
  321. package/ios/Util/ArtworkFreshness.swift +6 -6
  322. package/ios/Util/ArtworkImageFetcher.swift +19 -20
  323. package/ios/Util/ConcurrentMap.swift +2 -2
  324. package/ios/Util/Emitter.swift +8 -13
  325. package/ios/Util/NetworkMonitor.swift +4 -6
  326. package/ios/Util/OutputPicker.swift +1 -1
  327. package/ios/Util/ReadyValue.swift +3 -2
  328. package/ios/Util/SFSymbolRenderer.swift +17 -30
  329. package/ios/Util/SVGProcessor.swift +5 -9
  330. package/lib/commonjs/CLAUDE.md +7 -2
  331. package/lib/commonjs/features/battery.js +16 -12
  332. package/lib/commonjs/features/battery.js.map +1 -1
  333. package/lib/commonjs/features/browser-config.js +1 -1
  334. package/lib/commonjs/features/browser.js +74 -24
  335. package/lib/commonjs/features/browser.js.map +1 -1
  336. package/lib/commonjs/features/carConnection.js +3 -4
  337. package/lib/commonjs/features/carConnection.js.map +1 -1
  338. package/lib/commonjs/features/equalizer.js +9 -5
  339. package/lib/commonjs/features/equalizer.js.map +1 -1
  340. package/lib/commonjs/features/errors.js +35 -21
  341. package/lib/commonjs/features/errors.js.map +1 -1
  342. package/lib/commonjs/features/favorites.js +15 -13
  343. package/lib/commonjs/features/favorites.js.map +1 -1
  344. package/lib/commonjs/features/gate.js +12 -6
  345. package/lib/commonjs/features/gate.js.map +1 -1
  346. package/lib/commonjs/features/metadata.js +16 -14
  347. package/lib/commonjs/features/metadata.js.map +1 -1
  348. package/lib/commonjs/features/network.js +5 -1
  349. package/lib/commonjs/features/network.js.map +1 -1
  350. package/lib/commonjs/features/nowPlaying.js +28 -14
  351. package/lib/commonjs/features/nowPlaying.js.map +1 -1
  352. package/lib/commonjs/features/output.js +8 -4
  353. package/lib/commonjs/features/output.js.map +1 -1
  354. package/lib/commonjs/features/playback/controls.js +10 -5
  355. package/lib/commonjs/features/playback/controls.js.map +1 -1
  356. package/lib/commonjs/features/playback/playWhenReady.js +6 -5
  357. package/lib/commonjs/features/playback/playWhenReady.js.map +1 -1
  358. package/lib/commonjs/features/playback/playing.js +5 -3
  359. package/lib/commonjs/features/playback/playing.js.map +1 -1
  360. package/lib/commonjs/features/playback/progress.js +11 -5
  361. package/lib/commonjs/features/playback/progress.js.map +1 -1
  362. package/lib/commonjs/features/playback/state.js +3 -3
  363. package/lib/commonjs/features/playback/state.js.map +1 -1
  364. package/lib/commonjs/features/playback/trackPlaybackTime.js +6 -1
  365. package/lib/commonjs/features/playback/trackPlaybackTime.js.map +1 -1
  366. package/lib/commonjs/features/playback/volume.js +6 -5
  367. package/lib/commonjs/features/playback/volume.js.map +1 -1
  368. package/lib/commonjs/features/player/options.js +20 -10
  369. package/lib/commonjs/features/player/options.js.map +1 -1
  370. package/lib/commonjs/features/player/setup.js +34 -38
  371. package/lib/commonjs/features/player/setup.js.map +1 -1
  372. package/lib/commonjs/features/queue/activeTrack.js +0 -1
  373. package/lib/commonjs/features/queue/activeTrack.js.map +1 -1
  374. package/lib/commonjs/features/queue/queue.js +48 -20
  375. package/lib/commonjs/features/queue/queue.js.map +1 -1
  376. package/lib/commonjs/features/queue/repeatMode.js +2 -1
  377. package/lib/commonjs/features/queue/repeatMode.js.map +1 -1
  378. package/lib/commonjs/features/queue/shuffle.js +0 -1
  379. package/lib/commonjs/features/queue/shuffle.js.map +1 -1
  380. package/lib/commonjs/features/remoteControls.js +59 -35
  381. package/lib/commonjs/features/remoteControls.js.map +1 -1
  382. package/lib/commonjs/features/sleepTimer.js +15 -6
  383. package/lib/commonjs/features/sleepTimer.js.map +1 -1
  384. package/lib/commonjs/utils/LazyNativeEmitter.js +6 -9
  385. package/lib/commonjs/utils/LazyNativeEmitter.js.map +1 -1
  386. package/lib/commonjs/utils/NativeUpdatedValue.js +13 -12
  387. package/lib/commonjs/utils/NativeUpdatedValue.js.map +1 -1
  388. package/lib/commonjs/utils/getTrackIdentity.js +6 -4
  389. package/lib/commonjs/utils/getTrackIdentity.js.map +1 -1
  390. package/lib/commonjs/utils/useDebug.js +16 -3
  391. package/lib/commonjs/utils/useDebug.js.map +1 -1
  392. package/lib/commonjs/web/NativeAudioBrowser.js +2 -4
  393. package/lib/commonjs/web/NativeAudioBrowser.js.map +1 -1
  394. package/lib/commonjs/web/browser/parseSearchResponse.js +3 -4
  395. package/lib/commonjs/web/browser/parseSearchResponse.js.map +1 -1
  396. package/lib/commonjs/web/browser/sections.js +1 -1
  397. package/lib/commonjs/web/util/BrowserPathHelper.js +1 -3
  398. package/lib/commonjs/web/util/BrowserPathHelper.js.map +1 -1
  399. package/lib/module/CLAUDE.md +7 -2
  400. package/lib/module/features/battery.js +16 -12
  401. package/lib/module/features/battery.js.map +1 -1
  402. package/lib/module/features/browser-config.js +1 -1
  403. package/lib/module/features/browser.js +74 -24
  404. package/lib/module/features/browser.js.map +1 -1
  405. package/lib/module/features/carConnection.js +3 -4
  406. package/lib/module/features/carConnection.js.map +1 -1
  407. package/lib/module/features/equalizer.js +9 -5
  408. package/lib/module/features/equalizer.js.map +1 -1
  409. package/lib/module/features/errors.js +35 -21
  410. package/lib/module/features/errors.js.map +1 -1
  411. package/lib/module/features/favorites.js +15 -13
  412. package/lib/module/features/favorites.js.map +1 -1
  413. package/lib/module/features/gate.js +12 -6
  414. package/lib/module/features/gate.js.map +1 -1
  415. package/lib/module/features/metadata.js +16 -14
  416. package/lib/module/features/metadata.js.map +1 -1
  417. package/lib/module/features/network.js +5 -1
  418. package/lib/module/features/network.js.map +1 -1
  419. package/lib/module/features/nowPlaying.js +28 -14
  420. package/lib/module/features/nowPlaying.js.map +1 -1
  421. package/lib/module/features/output.js +8 -4
  422. package/lib/module/features/output.js.map +1 -1
  423. package/lib/module/features/playback/controls.js +10 -5
  424. package/lib/module/features/playback/controls.js.map +1 -1
  425. package/lib/module/features/playback/playWhenReady.js +6 -5
  426. package/lib/module/features/playback/playWhenReady.js.map +1 -1
  427. package/lib/module/features/playback/playing.js +5 -3
  428. package/lib/module/features/playback/playing.js.map +1 -1
  429. package/lib/module/features/playback/progress.js +11 -5
  430. package/lib/module/features/playback/progress.js.map +1 -1
  431. package/lib/module/features/playback/state.js +3 -3
  432. package/lib/module/features/playback/state.js.map +1 -1
  433. package/lib/module/features/playback/trackPlaybackTime.js +6 -1
  434. package/lib/module/features/playback/trackPlaybackTime.js.map +1 -1
  435. package/lib/module/features/playback/volume.js +6 -5
  436. package/lib/module/features/playback/volume.js.map +1 -1
  437. package/lib/module/features/player/options.js +20 -10
  438. package/lib/module/features/player/options.js.map +1 -1
  439. package/lib/module/features/player/setup.js +34 -38
  440. package/lib/module/features/player/setup.js.map +1 -1
  441. package/lib/module/features/queue/activeTrack.js +0 -1
  442. package/lib/module/features/queue/activeTrack.js.map +1 -1
  443. package/lib/module/features/queue/queue.js +48 -20
  444. package/lib/module/features/queue/queue.js.map +1 -1
  445. package/lib/module/features/queue/repeatMode.js +2 -1
  446. package/lib/module/features/queue/repeatMode.js.map +1 -1
  447. package/lib/module/features/queue/shuffle.js +0 -1
  448. package/lib/module/features/queue/shuffle.js.map +1 -1
  449. package/lib/module/features/remoteControls.js +59 -35
  450. package/lib/module/features/remoteControls.js.map +1 -1
  451. package/lib/module/features/sleepTimer.js +15 -6
  452. package/lib/module/features/sleepTimer.js.map +1 -1
  453. package/lib/module/utils/LazyNativeEmitter.js +6 -9
  454. package/lib/module/utils/LazyNativeEmitter.js.map +1 -1
  455. package/lib/module/utils/NativeUpdatedValue.js +13 -12
  456. package/lib/module/utils/NativeUpdatedValue.js.map +1 -1
  457. package/lib/module/utils/getTrackIdentity.js +6 -4
  458. package/lib/module/utils/getTrackIdentity.js.map +1 -1
  459. package/lib/module/utils/useDebug.js +16 -3
  460. package/lib/module/utils/useDebug.js.map +1 -1
  461. package/lib/module/web/NativeAudioBrowser.js +2 -4
  462. package/lib/module/web/NativeAudioBrowser.js.map +1 -1
  463. package/lib/module/web/browser/parseSearchResponse.js +3 -4
  464. package/lib/module/web/browser/parseSearchResponse.js.map +1 -1
  465. package/lib/module/web/browser/sections.js +1 -1
  466. package/lib/module/web/util/BrowserPathHelper.js +1 -3
  467. package/lib/module/web/util/BrowserPathHelper.js.map +1 -1
  468. package/lib/typescript/src/features/battery.d.ts +17 -12
  469. package/lib/typescript/src/features/battery.d.ts.map +1 -1
  470. package/lib/typescript/src/features/browser.d.ts +64 -24
  471. package/lib/typescript/src/features/browser.d.ts.map +1 -1
  472. package/lib/typescript/src/features/carConnection.d.ts +3 -4
  473. package/lib/typescript/src/features/carConnection.d.ts.map +1 -1
  474. package/lib/typescript/src/features/equalizer.d.ts +9 -5
  475. package/lib/typescript/src/features/equalizer.d.ts.map +1 -1
  476. package/lib/typescript/src/features/errors.d.ts +37 -22
  477. package/lib/typescript/src/features/errors.d.ts.map +1 -1
  478. package/lib/typescript/src/features/favorites.d.ts +15 -13
  479. package/lib/typescript/src/features/favorites.d.ts.map +1 -1
  480. package/lib/typescript/src/features/gate.d.ts +14 -8
  481. package/lib/typescript/src/features/gate.d.ts.map +1 -1
  482. package/lib/typescript/src/features/metadata.d.ts +37 -17
  483. package/lib/typescript/src/features/metadata.d.ts.map +1 -1
  484. package/lib/typescript/src/features/network.d.ts +5 -1
  485. package/lib/typescript/src/features/network.d.ts.map +1 -1
  486. package/lib/typescript/src/features/nowPlaying.d.ts +28 -14
  487. package/lib/typescript/src/features/nowPlaying.d.ts.map +1 -1
  488. package/lib/typescript/src/features/output.d.ts +8 -4
  489. package/lib/typescript/src/features/output.d.ts.map +1 -1
  490. package/lib/typescript/src/features/playback/controls.d.ts +10 -5
  491. package/lib/typescript/src/features/playback/controls.d.ts.map +1 -1
  492. package/lib/typescript/src/features/playback/playWhenReady.d.ts +6 -5
  493. package/lib/typescript/src/features/playback/playWhenReady.d.ts.map +1 -1
  494. package/lib/typescript/src/features/playback/playing.d.ts +16 -3
  495. package/lib/typescript/src/features/playback/playing.d.ts.map +1 -1
  496. package/lib/typescript/src/features/playback/progress.d.ts +11 -5
  497. package/lib/typescript/src/features/playback/progress.d.ts.map +1 -1
  498. package/lib/typescript/src/features/playback/state.d.ts +8 -3
  499. package/lib/typescript/src/features/playback/state.d.ts.map +1 -1
  500. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts +9 -2
  501. package/lib/typescript/src/features/playback/trackPlaybackTime.d.ts.map +1 -1
  502. package/lib/typescript/src/features/playback/volume.d.ts +6 -5
  503. package/lib/typescript/src/features/playback/volume.d.ts.map +1 -1
  504. package/lib/typescript/src/features/player/options.d.ts +52 -37
  505. package/lib/typescript/src/features/player/options.d.ts.map +1 -1
  506. package/lib/typescript/src/features/player/setup.d.ts +65 -60
  507. package/lib/typescript/src/features/player/setup.d.ts.map +1 -1
  508. package/lib/typescript/src/features/queue/activeTrack.d.ts +0 -1
  509. package/lib/typescript/src/features/queue/activeTrack.d.ts.map +1 -1
  510. package/lib/typescript/src/features/queue/queue.d.ts +48 -20
  511. package/lib/typescript/src/features/queue/queue.d.ts.map +1 -1
  512. package/lib/typescript/src/features/queue/repeatMode.d.ts +1 -1
  513. package/lib/typescript/src/features/queue/repeatMode.d.ts.map +1 -1
  514. package/lib/typescript/src/features/queue/shuffle.d.ts +0 -1
  515. package/lib/typescript/src/features/queue/shuffle.d.ts.map +1 -1
  516. package/lib/typescript/src/features/remoteControls.d.ts +58 -25
  517. package/lib/typescript/src/features/remoteControls.d.ts.map +1 -1
  518. package/lib/typescript/src/features/sleepTimer.d.ts +15 -7
  519. package/lib/typescript/src/features/sleepTimer.d.ts.map +1 -1
  520. package/lib/typescript/src/types/browser-nodes.d.ts +54 -57
  521. package/lib/typescript/src/types/browser-nodes.d.ts.map +1 -1
  522. package/lib/typescript/src/types/browser.d.ts +181 -144
  523. package/lib/typescript/src/types/browser.d.ts.map +1 -1
  524. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts +6 -9
  525. package/lib/typescript/src/utils/LazyNativeEmitter.d.ts.map +1 -1
  526. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts +13 -12
  527. package/lib/typescript/src/utils/NativeUpdatedValue.d.ts.map +1 -1
  528. package/lib/typescript/src/utils/getTrackIdentity.d.ts +6 -4
  529. package/lib/typescript/src/utils/getTrackIdentity.d.ts.map +1 -1
  530. package/lib/typescript/src/utils/useDebug.d.ts +16 -3
  531. package/lib/typescript/src/utils/useDebug.d.ts.map +1 -1
  532. package/package.json +1 -1
  533. package/src/CLAUDE.md +7 -2
  534. package/src/docs-floors.test.ts +71 -0
  535. package/src/features/battery.ts +17 -13
  536. package/src/features/browser-config.ts +1 -1
  537. package/src/features/browser.ts +65 -24
  538. package/src/features/carConnection.ts +3 -4
  539. package/src/features/equalizer.ts +9 -5
  540. package/src/features/errors.ts +37 -22
  541. package/src/features/favorites.ts +15 -13
  542. package/src/features/gate.ts +14 -8
  543. package/src/features/metadata.ts +37 -17
  544. package/src/features/network.ts +5 -1
  545. package/src/features/nowPlaying.ts +28 -14
  546. package/src/features/output.ts +8 -4
  547. package/src/features/playback/controls.ts +10 -5
  548. package/src/features/playback/playWhenReady.ts +6 -5
  549. package/src/features/playback/playing.ts +16 -3
  550. package/src/features/playback/progress.ts +11 -5
  551. package/src/features/playback/state.ts +8 -3
  552. package/src/features/playback/trackPlaybackTime.ts +9 -2
  553. package/src/features/playback/volume.ts +6 -5
  554. package/src/features/player/options.ts +54 -43
  555. package/src/features/player/setup.ts +67 -61
  556. package/src/features/queue/activeTrack.ts +0 -1
  557. package/src/features/queue/queue.ts +48 -20
  558. package/src/features/queue/repeatMode.ts +1 -1
  559. package/src/features/queue/shuffle.ts +0 -1
  560. package/src/features/remoteControls.ts +59 -35
  561. package/src/features/sleepTimer.ts +15 -7
  562. package/src/types/browser-nodes.ts +54 -57
  563. package/src/types/browser.ts +183 -146
  564. package/src/utils/LazyNativeEmitter.ts +6 -9
  565. package/src/utils/NativeUpdatedValue.ts +13 -12
  566. package/src/utils/getTrackIdentity.ts +6 -4
  567. package/src/utils/useDebug.ts +16 -3
  568. package/src/web/NativeAudioBrowser.ts +2 -4
  569. package/src/web/browser/parseSearchResponse.ts +3 -4
  570. package/src/web/browser/sections.ts +1 -1
  571. package/src/web/util/BrowserPathHelper.ts +1 -3
  572. package/website/guide/android-auto.md +25 -13
  573. package/website/guide/android-certificates.md +199 -120
  574. package/website/guide/artwork.md +93 -48
  575. package/website/guide/audio-output.md +86 -68
  576. package/website/guide/automotive.md +15 -10
  577. package/website/guide/basic-usage.md +5 -2
  578. package/website/guide/battery.md +50 -23
  579. package/website/guide/browser.md +155 -68
  580. package/website/guide/carplay.md +132 -49
  581. package/website/guide/configuration.md +85 -49
  582. package/website/guide/equalizer.md +36 -32
  583. package/website/guide/errors.md +106 -64
  584. package/website/guide/favorites.md +41 -31
  585. package/website/guide/gate.md +24 -10
  586. package/website/guide/getting-started.md +55 -2
  587. package/website/guide/hooks.md +53 -47
  588. package/website/guide/live-streams.md +80 -49
  589. package/website/guide/metadata.md +87 -53
  590. package/website/guide/migrating-from-track-player.md +94 -49
  591. package/website/guide/native-callback-fetch.md +46 -36
  592. package/website/guide/network.md +36 -20
  593. package/website/guide/now-playing.md +72 -44
  594. package/website/guide/playback.md +112 -35
  595. package/website/guide/queue.md +77 -43
  596. package/website/guide/remote-controls.md +87 -29
  597. package/website/guide/search.md +37 -22
  598. package/website/guide/sleep-timer.md +35 -14
  599. package/website/guide/track.md +59 -35
@@ -1,12 +1,12 @@
1
1
  import Foundation
2
2
 
3
3
  enum ArtworkFreshness {
4
- /// The lifetime when no response states one: Kingfisher's own disk expiry.
4
+ /// Used when no response states a lifetime; matches Kingfisher's default disk expiry.
5
5
  static let defaultLifetime: TimeInterval = 7 * 24 * 60 * 60
6
6
 
7
- /// The shortest lifetime any of `responses` (a fetch's redirects and its final response) states:
8
- /// its `max-age` less its `Age`, or zero for `no-cache` or `no-store`. A response that states
9
- /// none is skipped; `defaultLifetime` when none does.
7
+ /// The shortest lifetime stated across `responses` (every redirect and the final response):
8
+ /// `max-age` minus `Age`, or 0 for `no-cache` or `no-store`. Responses that state none are
9
+ /// ignored; `defaultLifetime` when none states one.
10
10
  static func lifetime(of responses: [HTTPURLResponse]) -> TimeInterval {
11
11
  responses.compactMap(lifetime(of:)).min() ?? defaultLifetime
12
12
  }
@@ -19,7 +19,7 @@ enum ArtworkFreshness {
19
19
  let name = parts[0].trimmingCharacters(in: .whitespaces).lowercased()
20
20
  let value = parts.count == 2 ? parts[1].trimmingCharacters(in: .whitespaces).trimmingCharacters(in: ["\""]) : nil
21
21
  switch name {
22
- // `no-cache="field"` forbids reusing only that field, not the response.
22
+ // `no-cache="field"` restricts reuse of that field only, not of the response.
23
23
  case "no-cache" where value == nil, "no-store":
24
24
  return 0
25
25
  case "max-age":
@@ -33,7 +33,7 @@ enum ArtworkFreshness {
33
33
  return max(0, maxAge - age)
34
34
  }
35
35
 
36
- /// RFC 9111's delta-seconds: digits only, so `inf` or `1e999` state nothing, and capped at 2^31.
36
+ /// RFC 9111 delta-seconds: digits only (so `inf` or `1e999` are rejected), capped at 2^31.
37
37
  private static func deltaSeconds(_ value: String) -> TimeInterval? {
38
38
  guard !value.isEmpty, value.allSatisfy({ ("0" ... "9").contains($0) }), let seconds = TimeInterval(value)
39
39
  else { return nil }
@@ -4,10 +4,12 @@ import NitroModules
4
4
  import os.log
5
5
  import UIKit
6
6
 
7
- /// Single entry point for loading artwork images from URLs via Kingfisher.
7
+ /// Loads artwork through Kingfisher, refetching an HTTP image once its cached copy is stale.
8
8
  enum ArtworkImageFetcher {
9
9
  private static let logger = Logger(subsystem: "com.audiobrowser", category: "ArtworkImageFetcher")
10
10
 
11
+ /// Returns nil when the image cannot be loaded, logging a failed fetch (not an unparseable URI). A stale image whose refetch fails
12
+ /// falls back to the cached copy. `svgScale` wins over `downsampleTo`.
11
13
  /// - Parameter waitsForConnectivity: A fetch that fails for want of a connection waits for one
12
14
  /// and tries again. A cancelled fetch that is waiting ends when the connection returns.
13
15
  @MainActor
@@ -34,13 +36,9 @@ enum ArtworkImageFetcher {
34
36
  if let svgScale {
35
37
  processor = SVGProcessor(size: nil, scale: svgScale)
36
38
  } else if let downsampleTo {
37
- // Downsample rasters at decode time. Any size hint passed upstream (the
38
- // resolver's ImageContext) is advisory — a CDN can ignore it and return
39
- // the original — so this is the only sizing that is guaranteed to
40
- // happen. The processed image is cached under a size-qualified key;
41
- // cacheOriginalImage keeps the untouched original in the disk cache so
42
- // the same URL at another target size re-processes instead of
43
- // re-downloading.
39
+ // The only sizing that is guaranteed: a size hint sent upstream is advisory and a CDN may
40
+ // return the original. cacheOriginalImage keeps the original on disk so another target
41
+ // size re-processes it instead of downloading it again.
44
42
  processor = DownsamplingImageProcessor(size: downsampleTo.size)
45
43
  options.append(.scaleFactor(downsampleTo.scale))
46
44
  options.append(.cacheOriginalImage)
@@ -53,7 +51,7 @@ enum ArtworkImageFetcher {
53
51
  // Each processed variant is fresh on its own: a variant cached before the image changed
54
52
  // would otherwise outlive the refetch of another.
55
53
  let key = url.absoluteString + (processor?.identifier ?? "")
56
- // Only an HTTP fetch records a lifetime: a file: or data: image would be refetched on every show.
54
+ // Only HTTP fetches record a lifetime, so any other scheme would otherwise refetch on every call.
57
55
  let isFresh = if ["http", "https"].contains(url.scheme?.lowercased()) { await freshness.isFresh(key) } else { true }
58
56
  let result: Result<UIImage, any Error> = if isFresh {
59
57
  await retrieve(url, options: options + retry, freshnessKey: key)
@@ -71,8 +69,9 @@ enum ArtworkImageFetcher {
71
69
 
72
70
  private static let freshness = FreshnessStore()
73
71
 
74
- /// Fetches a stale or never-fetched image again. When that fails, the cached copy, if any, is
75
- /// shown; with `retry`, a fetch that failed for want of a connection waits for one first.
72
+ /// Fetches past the cache. On failure returns the cached copy if there is one; otherwise, with
73
+ /// `retry`, a connectivity failure waits for a connection and fetches again. The first fetch
74
+ /// skips `retry` so a cached copy is shown without waiting for the network.
76
75
  @MainActor
77
76
  private static func refetch(
78
77
  _ url: URL,
@@ -89,7 +88,7 @@ enum ArtworkImageFetcher {
89
88
  return await retrieve(url, options: options + [.forceRefresh] + retry, freshnessKey: freshnessKey)
90
89
  }
91
90
 
92
- /// Fetches through Kingfisher, and records how long an image from the network stays fresh.
91
+ /// Fetches through Kingfisher and records the freshness lifetime of an image that was downloaded.
93
92
  @MainActor
94
93
  private static func retrieve(
95
94
  _ url: URL,
@@ -98,7 +97,7 @@ enum ArtworkImageFetcher {
98
97
  ) async -> Result<UIImage, any Error> {
99
98
  do {
100
99
  let result = try await KingfisherManager.shared.retrieveImage(with: url, options: options)
101
- // Metrics mark a download: an image re-made from the cached original is `.none` too.
100
+ // `.none` also covers an image re-processed from the cached original; only metrics mark a download.
102
101
  if result.cacheType == .none, let metrics = result.metrics {
103
102
  let responses = metrics.rawMetrics.transactionMetrics.compactMap { $0.response as? HTTPURLResponse }
104
103
  await freshness.record(freshnessKey, lifetime: ArtworkFreshness.lifetime(of: responses))
@@ -110,7 +109,7 @@ enum ArtworkImageFetcher {
110
109
  }
111
110
  }
112
111
 
113
- /// The cache keys whose image is still fresh, each kept on disk until its lifetime ends.
112
+ /// Cache keys whose image is still fresh, each stored on disk with its lifetime as expiry.
114
113
  private actor FreshnessStore {
115
114
  private let storage = try? DiskStorage.Backend<Data>(
116
115
  config: DiskStorage.Config(name: "com.audiobrowser.artwork-freshness", sizeLimit: 0),
@@ -143,8 +142,8 @@ private extension KingfisherError {
143
142
  }
144
143
  }
145
144
 
146
- /// Repeats a fetch that failed for want of a connection once one is back, a few times at most; any
147
- /// other failure, a 404 included, stops at once.
145
+ /// Retries a connectivity failure once a connection is back, up to `maxRetries` times; any other
146
+ /// failure, a 404 included, stops immediately.
148
147
  private struct ConnectivityRetry: RetryStrategy {
149
148
  private static let maxRetries = 3
150
149
 
@@ -156,9 +155,9 @@ private struct ConnectivityRetry: RetryStrategy {
156
155
  Self.whenConnected { retryHandler(.retry(userInfo: nil)) }
157
156
  }
158
157
 
159
- /// Calls `body` once the device has a usable path, at once when it has one already: a monitor
160
- /// reports the current path when it starts, so a reconnect cannot slip past it. The handler
161
- /// holds the monitor until it fires.
158
+ /// Calls `body` once there is a usable path, immediately if there is one already: a monitor
159
+ /// reports the current path when it starts, so a reconnect cannot be missed. The handler keeps
160
+ /// the monitor alive until it fires.
162
161
  private static func whenConnected(_ body: @escaping @Sendable () -> Void) {
163
162
  let monitor = NWPathMonitor()
164
163
  monitor.pathUpdateHandler = { path in
@@ -170,6 +169,6 @@ private struct ConnectivityRetry: RetryStrategy {
170
169
  monitor.start(queue: queue)
171
170
  }
172
171
 
173
- /// Serial, so a monitor's handler never runs twice at once.
172
+ // Serial, so a monitor's handler never runs concurrently with itself.
174
173
  private static let queue = DispatchQueue(label: "com.audiobrowser.artwork-connectivity", qos: .utility)
175
174
  }
@@ -1,6 +1,6 @@
1
1
  extension Array where Element: Sendable {
2
- /// `transform` over every element at once, with the results in element order. Cancelling the
3
- /// caller cancels every transform still running.
2
+ /// Runs `transform` on every element concurrently and returns the results in element order.
3
+ /// Cancelling the caller cancels every transform still running.
4
4
  func concurrentMap<T: Sendable>(_ transform: @escaping @MainActor (Element) async -> T) async -> [T] {
5
5
  await withTaskGroup(of: (Int, T).self) { group in
6
6
  for (index, element) in enumerated() {
@@ -1,11 +1,11 @@
1
1
  import Foundation
2
2
 
3
- /// Opaque token returned by `addListener` for targeted removal.
4
3
  public struct EmitterToken: Sendable {
5
4
  fileprivate let id: Int
6
5
  }
7
6
 
8
- /// Generic event emitter that allows multiple listeners for a single event type
7
+ /// Delivers each event to every listener, synchronously on the emitting thread. Any method may be
8
+ /// called from any thread, including from inside a listener.
9
9
  public final class Emitter<T>: @unchecked Sendable {
10
10
  private let lock = NSLock()
11
11
  private var nextId = 0
@@ -13,9 +13,6 @@ public final class Emitter<T>: @unchecked Sendable {
13
13
 
14
14
  public init() {}
15
15
 
16
- /// Adds a listener to this emitter
17
- /// - Parameter listener: The callback to invoke when an event is emitted
18
- /// - Returns: A token that can be passed to `removeListener` for targeted removal
19
16
  @discardableResult
20
17
  public func addListener(_ listener: @escaping (T) -> Void) -> EmitterToken {
21
18
  lock.lock()
@@ -29,8 +26,6 @@ public final class Emitter<T>: @unchecked Sendable {
29
26
  return EmitterToken(id: id)
30
27
  }
31
28
 
32
- /// Removes a specific listener by its token
33
- /// - Parameter token: The token returned by `addListener`
34
29
  public func removeListener(_ token: EmitterToken) {
35
30
  lock.lock()
36
31
  defer { lock.unlock() }
@@ -40,11 +35,11 @@ public final class Emitter<T>: @unchecked Sendable {
40
35
  snapshot = next
41
36
  }
42
37
 
43
- /// Emits an event to all registered listeners
44
- /// - Parameter event: The event data to emit
45
38
  public func emit(_ event: T) {
39
+ // Listeners run outside the lock, so one may add or remove listeners; a listener removed
40
+ // during an emit still receives that event.
46
41
  lock.lock()
47
- let current = snapshot // O(1) reference bump; no array copy here
42
+ let current = snapshot
48
43
  lock.unlock()
49
44
 
50
45
  for entry in current {
@@ -80,8 +75,8 @@ extension Emitter {
80
75
  }
81
76
 
82
77
  extension Emitter {
83
- /// Like `subscribe`, but `handler` runs on the main actor after the emit returns, whichever
84
- /// thread emitted.
78
+ /// Like `subscribe`, but `handler` runs later on the main actor, in a Task, whichever thread
79
+ /// emitted. Off main it may run before the emit returns.
85
80
  func subscribeOnMain(_ handler: @escaping @MainActor (T) -> Void) -> Subscription {
86
81
  subscribe { value in
87
82
  let event = MainActorHop(value: value)
@@ -90,7 +85,7 @@ extension Emitter {
90
85
  }
91
86
  }
92
87
 
93
- /// Carries an emitted value to the main actor, where it is only read.
88
+ /// Carries a non-Sendable emitted value to the main actor, where it is only read.
94
89
  private struct MainActorHop<T>: @unchecked Sendable {
95
90
  let value: T
96
91
  }
@@ -2,7 +2,7 @@ import Foundation
2
2
  import Network
3
3
  import os.log
4
4
 
5
- /// The device's connectivity, from NWPathMonitor; `changed` emits each change on the main thread.
5
+ /// The device's connectivity from NWPathMonitor; `changed` emits each change on the main thread.
6
6
  final class NetworkMonitor: @unchecked Sendable {
7
7
  // MARK: - Properties
8
8
 
@@ -10,7 +10,7 @@ final class NetworkMonitor: @unchecked Sendable {
10
10
  private let monitor: NWPathMonitor
11
11
  private let queue = DispatchQueue(label: "com.audiobrowser.networkmonitor")
12
12
 
13
- /// Guards `_isOnline` only; never held across an emit.
13
+ // Guards `_isOnline` only; never held across an emit.
14
14
  private let lock = NSLock()
15
15
  private var _isOnline = false
16
16
 
@@ -42,9 +42,8 @@ final class NetworkMonitor: @unchecked Sendable {
42
42
  init() {
43
43
  monitor = NWPathMonitor()
44
44
 
45
- // Seeded before `start`: a write after it races the handler's, and would clobber a real
46
- // update with a `currentPath` the monitor hasn't finished evaluating. The handler, which
47
- // fires shortly after `start`, is the last writer.
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.
48
47
  let initialStatus = monitor.currentPath.status == .satisfied
49
48
  logger.notice("NetworkMonitor initialized, initial isOnline=\(initialStatus)")
50
49
  _isOnline = initialStatus
@@ -56,7 +55,6 @@ final class NetworkMonitor: @unchecked Sendable {
56
55
  monitor.start(queue: queue)
57
56
  }
58
57
 
59
- /// Stops monitoring and cleans up resources.
60
58
  func destroy() {
61
59
  monitor.cancel()
62
60
  }
@@ -32,7 +32,7 @@ enum OutputPicker {
32
32
  logger.error("openOutputPicker: no UIButton found inside AVRoutePickerView")
33
33
  }
34
34
 
35
- // On iPad the picker's popover anchors to this view.
35
+ // On iPad the picker's popover anchors to this view, so it outlives the tap.
36
36
  DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) {
37
37
  routePicker.removeFromSuperview()
38
38
  }
@@ -1,7 +1,8 @@
1
1
  import Foundation
2
2
 
3
- /// A value that exists once `provider` returns one. `wait` returns it, parking until `check()`
4
- /// finds it; nothing is cached, so the provider's current answer always wins.
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.
5
6
  @MainActor
6
7
  final class ReadyValue<T: Sendable> {
7
8
  private let provider: () -> T?
@@ -1,22 +1,18 @@
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
 
14
- /// Bumped whenever the rendering below changes (symbol point-size factor,
15
- /// centering, tinting, background fill). It is part of the cache filename
16
- /// because `.cachesDirectory` survives app updates and the existence check is
17
- /// the only cache validation — without a version key, every device that had
18
- /// rendered a symbol once would keep serving the OLD pixels forever after a
19
- /// render change.
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.
20
16
  private static let renderVersion = 1
21
17
 
22
18
  private let logger = Logger(subsystem: "com.audiobrowser", category: "SFSymbolRenderer")
@@ -32,14 +28,9 @@ final class SFSymbolRenderer: @unchecked Sendable {
32
28
  try? FileManager.default.createDirectory(at: cacheDirectory, withIntermediateDirectories: true)
33
29
  }
34
30
 
35
- /// Renders an SF Symbol to a PNG file and returns its `file://` URI.
36
- ///
37
- /// Skips rendering if the file already exists on disk.
38
- ///
39
- /// - Parameters:
40
- /// - artworkValue: The artwork string (e.g. "sf:heart.fill?bg=#000&fg=#fff" or "heart.fill")
41
- /// - canvasSize: The canvas size in points (rendered at device scale)
42
- /// - 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.
43
34
  func render(_ artworkValue: String, canvasSize: CGSize = defaultCanvasSize) -> String? {
44
35
  let safeArtwork = artworkValue.unicodeScalars
45
36
  .filter { CharacterSet.alphanumerics.contains($0) || $0 == "_" }
@@ -95,16 +86,15 @@ final class SFSymbolRenderer: @unchecked Sendable {
95
86
  width: size.width,
96
87
  height: size.height,
97
88
  ))
98
- }.withRenderingMode(.alwaysOriginal)
89
+ }.withRenderingMode(.alwaysOriginal) // Keeps the drawn tint inside a tinted view.
99
90
  }
100
91
 
101
- /// Whether the given artwork string is an SF Symbol reference.
102
92
  static func isSFSymbol(_ artwork: String) -> Bool {
103
93
  artwork.hasPrefix("sf:")
104
94
  }
105
95
 
106
- /// Parses an SF Symbol artwork string into symbol name and resolved colors.
107
- /// `"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.
108
98
  static func parseArtwork(_ value: String) -> (symbolName: String, backgroundColor: UIColor?, symbolColor: UIColor?) {
109
99
  let (symbolName, params) = parseArtworkValue(value)
110
100
  let bg = params["bg"].map { UIColor(hex: $0) }
@@ -112,8 +102,6 @@ final class SFSymbolRenderer: @unchecked Sendable {
112
102
  return (symbolName, bg, fg)
113
103
  }
114
104
 
115
- /// Parses an SF Symbol artwork string, stripping the `sf:` prefix if present.
116
- /// `"sf:heart.fill?bg=#000&fg=#fff"` → `("heart.fill", ["bg": "000", "fg": "fff"])`
117
105
  private static func parseArtworkValue(_ value: String) -> (symbolName: String, params: [String: String]) {
118
106
  let stripped = value.hasPrefix("sf:") ? String(value.dropFirst(3)) : value
119
107
  guard let questionMark = stripped.firstIndex(of: "?") else {
@@ -134,6 +122,8 @@ final class SFSymbolRenderer: @unchecked Sendable {
134
122
  }
135
123
 
136
124
  extension UIColor {
125
+ /// `#` optional. Any length but 3 or 6 is black; the digits are not validated
126
+ /// (`init(declaredHex:)` does that).
137
127
  convenience init(hex: String) {
138
128
  let hex = hex.trimmingCharacters(in: CharacterSet(charactersIn: "#"))
139
129
  var rgb: UInt64 = 0
@@ -155,11 +145,8 @@ extension UIColor {
155
145
  }
156
146
  }
157
147
 
158
- /// Failable form for *declared* colors (`style.cardTint`): anything but a
159
- /// 3- or 6-digit hex value is nil, so an unparseable declaration degrades
160
- /// to "no declaration" (the system default) instead of rendering black —
161
- /// matching how unknown enum values decode. `init(hex:)` keeps its lenient
162
- /// black fallback for the `sf:` artwork params it has always served.
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.
163
150
  convenience init?(declaredHex hex: String) {
164
151
  let digits = hex.trimmingCharacters(in: CharacterSet(charactersIn: "#"))
165
152
  guard [3, 6].contains(digits.count),
@@ -2,21 +2,18 @@ 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
- /// Kingfisher keys its cache on `identifier` alone (`ImageCache.computedKey`),
8
- /// and `.scaleFactor` never enters that key — so the render parameters have to,
9
- /// or two different rasterizations of the same URL would collide. Today only
10
- /// CarPlay rasterizes SVGs (one screen, one scale), so this is insurance
11
- /// against a second call site rather than a live fix.
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.
12
10
  var identifier: String {
13
11
  "com.audiobrowser.svgprocessor(\(size?.width ?? -1)x\(size?.height ?? -1)@\(scale))"
14
12
  }
15
13
 
16
- /// Target size for rendering (in points). If nil, uses SVG's intrinsic size.
14
+ /// Points; nil renders at the SVG's intrinsic size.
17
15
  let size: CGSize?
18
16
 
19
- /// Scale factor for rendering. Resolved at init time to avoid MainActor issues.
20
17
  let scale: CGFloat
21
18
 
22
19
  @MainActor
@@ -30,7 +27,6 @@ struct SVGProcessor: ImageProcessor {
30
27
  case let .data(data):
31
28
  return renderSVG(from: data)
32
29
  case let .image(image):
33
- // Already an image, return as-is
34
30
  return image
35
31
  @unknown default:
36
32
  return nil
@@ -1,7 +1,8 @@
1
1
  # TypeScript API
2
2
 
3
- The rules here are about the shape of the package's public surface. Both are
4
- enforced by tests, but the tests only tell you _after_ you've written it.
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.
5
6
 
6
7
  ## Everything you export is public
7
8
 
@@ -47,6 +48,10 @@ Two emitter classes, picked by what the event _is_:
47
48
  Both are created via `emitterize(cb => (nativeBrowser.onThing = cb))` and both
48
49
  return the instance. Neither class is exported from the package.
49
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
+
50
55
  `on*` observes; `handle*` overrides. `handleRemoteNext(cb)` is a plain setter
51
56
  that replaces the default behaviour and takes `undefined` to clear it, while
52
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":[]}
@@ -176,7 +176,7 @@ function flattenRoutes(routes, tabs, search) {
176
176
  return entries.length > 0 ? entries : undefined;
177
177
  }
178
178
 
179
- /** Android Auto / CarPlay display at most this many tabs. */
179
+ /** Android Auto displays at most this many tabs; CarPlay reads CPTabBarTemplate.maximumTabCount. */
180
180
  const MAX_TABS = 4;
181
181
 
182
182
  /**