react-native-audio-browser 0.2.0-next.3 → 0.2.0-next.30

package/README.md

@@ -63,23 +63,23 @@ import AudioBrowser from 'react-native-audio-browser'
 await AudioBrowser.setupPlayer()
 
 AudioBrowser.configureBrowser({
-  tabs: [{ title: 'Browse', url: '/browse' }],
+  tabs: [{ title: 'Browse', path: '/browse' }],
   routes: {
     // Every path under /browse is fetched from your API, on demand.
-    '/browse/**': { baseUrl: 'https://api.example.com' },
-  },
+    '/browse/**': { baseUrl: 'https://api.example.com' }
+  }
 })
 ```
 
-Each route returns a page of children — a child with a `url` is browsable (open it for more), one with a `src` is a playable track (plus optional `artist`, `artwork`, …):
+Each route returns a page of children — a child with a `path` is browsable (open it for more), one with a `src` is a playable track (plus optional `artist`, `artwork`, …):
 
 ```jsonc
 // GET https://api.example.com/browse/jazz  →
 {
-  "url": "/browse/jazz",
+  "path": "/browse/jazz",
   "title": "Jazz",
   "children": [
-    { "title": "Smooth Floret FM", "url": "/browse/jazz/floret-fm" },           // url → open for children
+    { "title": "Smooth Floret FM", "path": "/browse/jazz/floret-fm" }, // path → open for children
     { "title": "The Stalk 88.5", "src": "https://stream.example.com/stalk.mp3" } // src → play this stream
   ]
 }
@@ -91,7 +91,9 @@ The player works standalone, too — no browse tree required:
 import AudioBrowser from 'react-native-audio-browser'
 
 await AudioBrowser.setupPlayer()
-AudioBrowser.setQueue([{ title: 'Track', artist: 'Artist', src: 'https://example.com/track.mp3' }])
+AudioBrowser.setQueue([
+  { title: 'Track', artist: 'Artist', src: 'https://example.com/track.mp3' }
+])
 AudioBrowser.play()
 ```
 
@@ -99,16 +101,16 @@ AudioBrowser.play()
 
 Reactive hooks for your in-app UI — they update automatically as playback, the queue, and browse state change. Call `setupPlayer()` once at startup, before rendering any component that uses them.
 
-| Hook | Returns |
-| --- | --- |
-| `usePlayingState()` | `{ playing, buffering }` |
-| `useProgress()` | `{ position, duration, buffered }` (seconds) |
-| `useActiveTrack()` | the current `Track` |
-| `useNowPlaying()` | now-playing metadata |
-| `useQueue()` | the current queue |
-| `useRepeatMode()` / `useShuffle()` | repeat / shuffle state |
-| `useSleepTimer()` | sleep-timer state |
-| `useCarConnected()` | whether a car is connected |
+| Hook                                       | Returns                                                              |
+| ------------------------------------------ | -------------------------------------------------------------------- |
+| `usePlayingState()`                        | `{ playing, buffering }`                                             |
+| `useProgress()`                            | `{ position, duration, buffered }` (seconds)                         |
+| `useActiveTrack()`                         | the current `Track`                                                  |
+| `useNowPlaying()`                          | now-playing metadata                                                 |
+| `useQueue()`                               | the current queue                                                    |
+| `useRepeatMode()` / `useShuffle()`         | repeat / shuffle state                                               |
+| `useSleepTimer()`                          | sleep-timer state                                                    |
+| `useCarConnected()`                        | whether a car is connected                                           |
 | `usePath()` / `useTabs()` / `useContent()` | current browse path, tabs, and the resolved page at the current path |
 
 …and more — see the [Hooks guide](https://audiobrowser.dev/guide/hooks) and the [API Reference](https://audiobrowser.dev/api/).
@@ -118,18 +120,20 @@ import { View, Text, Button } from 'react-native'
 import AudioBrowser, {
   usePlayingState,
   useProgress,
-  useActiveTrack,
+  useActiveTrack
 } from 'react-native-audio-browser'
 
 function PlayerBar() {
-  const { playing } = usePlayingState()        // { playing, buffering }
+  const { playing } = usePlayingState() // { playing, buffering }
   const { position, duration } = useProgress() // in seconds
-  const track = useActiveTrack()               // Track | undefined
+  const track = useActiveTrack() // Track | undefined
 
   return (
     <View>
       <Text>{track?.title}</Text>
-      <Text>{Math.floor(position)} / {Math.floor(duration)}s</Text>
+      <Text>
+        {Math.floor(position)} / {Math.floor(duration)}s
+      </Text>
       <Button
         title={playing ? 'Pause' : 'Play'}
         onPress={() => AudioBrowser.togglePlayback()}
@@ -168,7 +172,17 @@ Full guides and the complete [API Reference](https://audiobrowser.dev/api/) live
 
 **Troubleshooting** — [Networking in native callbacks](https://audiobrowser.dev/guide/native-callback-fetch) · [Android SSL / trust anchors](https://audiobrowser.dev/guide/android-certificates)
 
-The example app in [`apps/example-native`](https://github.com/radio-garden/react-native-audio-browser/tree/main/apps/example-native) browses archive.org's audio collection — in-app, on CarPlay, and on Android Auto — with search, favorites, and the gate.
+The example app in [`apps/example-native`](https://github.com/radio-garden/react-native-audio-browser/tree/main/apps/example-native) browses archive.org's audio collection — in-app, on CarPlay, and on Android Auto — with search, favorites, and the gate. Its **Style Lab** tab renders every CarPlay `style` declaration, each shelf titled with the block it draws ([source](https://github.com/radio-garden/react-native-audio-browser/blob/main/apps/example-native/src/utils/style-lab.ts)).
+
+### For coding agents
+
+Every page is also served as raw Markdown — append `.md` to any URL, e.g.
+[`audiobrowser.dev/guide/queue.md`](https://audiobrowser.dev/guide/queue.md).
+
+- [`/llms.txt`](https://audiobrowser.dev/llms.txt) — an index of every page with a one-line summary, to pick what to read.
+- [`/llms-full.txt`](https://audiobrowser.dev/llms-full.txt) — every guide in one file.
+
+The same guide Markdown ships in the package, so it can be read straight off disk without a network fetch: `node_modules/react-native-audio-browser/website/guide/`.
 
 ## Support
 

package/android/build.gradle

@@ -33,13 +33,19 @@ if (isNewArchitectureEnabled()) {
   apply plugin: "com.facebook.react"
 }
 
-ktfmt {  googleStyle()
+ktfmt {
+  googleStyle()
 }
 
 tasks.register("format") {
   dependsOn "ktfmtFormat"
 }
 
+// Fails instead of rewriting — what CI runs.
+tasks.register("formatCheck") {
+  dependsOn "ktfmtCheck"
+}
+
 def getExtOrDefault(name) {
   return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["AudioBrowser_" + name]
 }
@@ -56,12 +62,13 @@ android {
   ndkVersion getExtOrDefault("ndkVersion")
   compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
-  // JVM unit tests don't link the Android framework, so un-mocked android.* calls
-  // (e.g. android.util.LruCache.evictAll) throw "not mocked". Returning default
-  // values makes them no-ops so logic-only tests (e.g. layer-generation caching)
-  // can exercise code paths that touch framework types.
+  // Deliberately left off (the AGP default). Turning it on is global: every un-mocked
+  // android.* call in every unit test silently returns 0/false/null instead of throwing,
+  // so a test can pass while the code under test never ran. Tests that need real framework
+  // behaviour run under Robolectric instead — see BrowserManagerLayerResolutionTest, whose
+  // android.util.LruCache.evictAll() is what this flag used to paper over.
   testOptions {
-    unitTests.returnDefaultValues = true
+    unitTests.returnDefaultValues = false
   }
 
   defaultConfig {
@@ -151,6 +158,13 @@ repositories {
   google()
 }
 
+// Mockito's inline mock maker needs a Byte Buddy agent in the running JVM. Left to itself it
+// installs one through the JVM attach mechanism, which binds a unix socket under $TMPDIR —
+// denied inside sandboxed shells, and disabled by default on JDK 24+. Resolving the agent as its
+// own configuration lets the test JVM pre-load it with -javaagent, so no attach is needed.
+configurations {
+  mockitoAgent
+}
 
 dependencies {
   // For < 0.71, this will be from the local maven repo
@@ -168,14 +182,10 @@ dependencies {
   implementation "androidx.core:core-ktx:1.13.1"
   // CarConnection: the documented Android Auto / Automotive connection signal
   implementation "androidx.car.app:app:1.4.0"
-  implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.1.0"
   implementation "androidx.lifecycle:lifecycle-process:2.8.6"
   implementation 'androidx.media:media:1.7.0'
 
   implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.6")
-  implementation("androidx.activity:activity-compose:1.9.3")
-  implementation("androidx.compose.ui:ui")
-  implementation("androidx.compose.ui:ui-graphics")
 
   // Media3 dependencies for audio playback.
   // Version is configurable via rootProject.ext.media3Version or AudioBrowser_media3Version
@@ -189,6 +199,7 @@ dependencies {
   implementation("androidx.media3:media3-exoplayer-dash:${media3Version}")
   implementation("androidx.media3:media3-exoplayer-smoothstreaming:${media3Version}")
   implementation("androidx.media3:media3-common:${media3Version}")
+  implementation("androidx.media3:media3-datasource-okhttp:${media3Version}")
 
   implementation "com.google.guava:guava:33.0.0-android"
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.8.0"
@@ -207,18 +218,30 @@ dependencies {
   implementation("io.coil-kt.coil3:coil-network-okhttp:3.3.0")
 
   // Testing dependencies
+  def mockitoVersion = "5.8.0"
   testImplementation 'junit:junit:4.13.2'
-  testImplementation 'org.mockito:mockito-core:5.8.0'
+  testImplementation "org.mockito:mockito-core:${mockitoVersion}"
+  // Resolved transitively so the agent jar always matches the Byte Buddy that Mockito uses.
+  mockitoAgent "org.mockito:mockito-core:${mockitoVersion}"
   testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.3'
   testImplementation 'org.robolectric:robolectric:4.11.1'
 
   api 'com.jakewharton.timber:timber:5.0.1'
 }
 
+tasks.withType(Test).configureEach {
+  def agentJar = configurations.mockitoAgent.find { it.name.startsWith("byte-buddy-agent") }
+  if (agentJar == null) {
+    throw new GradleException("No byte-buddy-agent jar in the mockitoAgent configuration; " +
+        "Mockito would fall back to runtime self-attach. Check the mockito-core coordinates.")
+  }
+  jvmArgs "-javaagent:${agentJar}"
+}
+
 if (isNewArchitectureEnabled()) {
   react {
     jsRootDir = file("../src/")
     libraryName = "AudioBrowser"
     codegenJavaPackageName = "com.audiobrowser"
   }
-}
+}

package/android/gradle.properties

@@ -1,6 +1,6 @@
 AudioBrowser_kotlinVersion=2.1.20
 AudioBrowser_minSdkVersion=23
 AudioBrowser_targetSdkVersion=35
-AudioBrowser_compileSdkVersion=34
+AudioBrowser_compileSdkVersion=35
 AudioBrowser_ndkVersion=27.1.12297006
-AudioBrowser_media3Version=1.10.1
+AudioBrowser_media3Version=1.11.1

package/android/src/main/AndroidManifest.xml

@@ -23,7 +23,9 @@
                 <action android:name="androidx.media3.session.MediaSessionService" />
             </intent-filter>
 
-            <!-- For Android Auto support -->
+            <!-- Voice "play <query>". Any app can send it, but that is a subset of what an
+                 unauthenticated MediaController already has: onConnect admits everyone.
+                 Restrict connections there, not here. -->
             <intent-filter>
                 <action android:name="android.media.action.MEDIA_PLAY_FROM_SEARCH" />
                 <category android:name="android.intent.category.DEFAULT" />