react-native-audio-browser 0.2.0-next.10 → 0.2.0-next.12

package/ios/Tests/CarPlayArtworkResolverTests.swift

@@ -10,7 +10,7 @@ struct SFSymbolTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "sf:heart.fill",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -22,7 +22,7 @@ struct SFSymbolTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "sf:play.circle?bg=#000&fg=#fff",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 24, targetHeight: 24,
       displayScale: 3.0,
       urlResolver: nil,
@@ -35,7 +35,7 @@ struct SFSymbolTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "sf:music.note",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in
@@ -51,7 +51,7 @@ struct SFSymbolTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: nil,
       artworkSourceUri: "sf:star.fill",
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 20, targetHeight: 20,
       displayScale: 2.0,
       urlResolver: nil,
@@ -68,7 +68,7 @@ struct NoArtworkTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: nil,
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -80,7 +80,7 @@ struct NoArtworkTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: nil,
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in nil },
@@ -97,7 +97,7 @@ struct URLResolutionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/art.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: false,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { pixelWidth, pixelHeight in
@@ -121,7 +121,7 @@ struct URLResolutionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/art.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 24, targetHeight: 24,
       displayScale: 3.0,
       urlResolver: { _, _ in
@@ -140,7 +140,7 @@ struct URLResolutionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/art.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in nil },
@@ -157,7 +157,7 @@ struct URLResolutionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/fallback.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in
@@ -180,7 +180,7 @@ struct URLResolutionTests {
     _ = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/art.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 50, targetHeight: 30,
       displayScale: 2.5,
       urlResolver: { w, h in
@@ -202,7 +202,7 @@ struct DirectFallbackTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/artwork.png",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -219,7 +219,7 @@ struct DirectFallbackTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: nil,
       artworkSourceUri: "https://example.com/source.jpg",
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -236,7 +236,7 @@ struct DirectFallbackTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/artwork.jpg",
       artworkSourceUri: "https://example.com/source.jpg",
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -253,7 +253,7 @@ struct DirectFallbackTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -270,7 +270,7 @@ struct SVGDetectionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/icon.svg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -287,7 +287,7 @@ struct SVGDetectionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/icon.SVG",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -304,7 +304,7 @@ struct SVGDetectionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/art.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in
@@ -323,7 +323,7 @@ struct SVGDetectionTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/photo.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -341,11 +341,11 @@ struct SVGDetectionTests {
 
 @Suite("tinting")
 struct TintingTests {
-  @Test func artworkCarPlayTintedTrue_setsShouldTint() async {
+  @Test func stencilTrue_setsShouldTint() async {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/icon.png",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: true,
+      stencil: true,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -358,28 +358,11 @@ struct TintingTests {
     ))
   }
 
-  @Test func artworkCarPlayTintedFalse_doesNotTint() async {
+  @Test func stencilFalse_doesNotTint() async {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/photo.jpg",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: false,
-      targetWidth: 40, targetHeight: 40,
-      displayScale: 2.0,
-      urlResolver: nil,
-    )
-    #expect(action == .fetch(
-      uri: "https://example.com/photo.jpg",
-      headers: nil,
-      shouldTint: false,
-      isSvg: false,
-    ))
-  }
-
-  @Test func artworkCarPlayTintedNil_defaultsToFalse() async {
-    let action = await CarPlayArtworkResolver.resolve(
-      artwork: "https://example.com/photo.jpg",
-      artworkSourceUri: nil,
-      artworkCarPlayTinted: nil,
+      stencil: false,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: nil,
@@ -396,7 +379,7 @@ struct TintingTests {
     let action = await CarPlayArtworkResolver.resolve(
       artwork: "https://example.com/icon.png",
       artworkSourceUri: nil,
-      artworkCarPlayTinted: true,
+      stencil: true,
       targetWidth: 40, targetHeight: 40,
       displayScale: 2.0,
       urlResolver: { _, _ in

package/ios/Tests/JsonModelsTests.swift

@@ -40,7 +40,7 @@ struct JsonTrackArtworkTests {
     // The shape that shipped broken: a container decodes its children eagerly,
     // so one unparseable row rejected the whole page rather than losing an image.
     let json = """
-    { "url": "/favorites", "title": "Favorites", "children": [
+    { "path": "/favorites", "title": "Favorites", "children": [
       { "title": "Playlist", "artwork": { "light": "https://e.example/l.png", "dark": "https://e.example/d.png" } }
     ] }
     """.data(using: .utf8)!
@@ -56,3 +56,77 @@ struct JsonTrackArtworkTests {
     }
   }
 }
+
+// MARK: - Style blocks (ADR 0011)
+
+@Suite("JsonTrack.style")
+struct JsonStyleTests {
+  @Test func decodesABlockOntoTrackStyle() throws {
+    let json = Data(
+      """
+      {"title":"X","style":{"display":"grid","artworkRendering":"stencil"}}
+      """.utf8)
+    let track = try JSONDecoder().decode(JsonTrack.self, from: json).toNitro()
+    #expect(track.style?.display == .grid)
+    #expect(track.style?.artworkRendering == .stencil)
+  }
+
+  @Test func decodesABlockOntoSectionStyle() throws {
+    let json = Data(
+      """
+      {"path":"/home","title":"Home","sections":[
+        {"style":{"display":"grid","gridWrap":false},"children":[{"title":"C","src":"s"}]}
+      ]}
+      """.utf8)
+    let resolved = try JSONDecoder().decode(JsonResolvedTrack.self, from: json).toNitro()
+    let style = resolved.sections?.first?.style
+    #expect(style?.display == .grid)
+    #expect(style?.gridWrap == false)
+  }
+
+  @Test func staleStringStyleDecodesAsNoDeclaration() throws {
+    // The retired string vocabulary must never kill the page (tolerant
+    // decoding, ADR 0011) — it decodes as an empty block.
+    let json = Data(
+      """
+      {"path":"/home","title":"Home","style":"rail","children":[
+        {"title":"C","src":"s","style":"grid"}
+      ]}
+      """.utf8)
+    let resolved = try JSONDecoder().decode(JsonResolvedTrack.self, from: json).toNitro()
+    #expect(resolved.style == nil)
+    #expect(resolved.children?.first?.style == nil)
+  }
+
+  @Test func unknownEnumValuesDecodeAsNoDeclaration() throws {
+    let json = Data(
+      """
+      {"title":"X","style":{"display":"carousel","artworkRendering":"embossed","gridWrap":"yes"}}
+      """.utf8)
+    let track = try JSONDecoder().decode(JsonTrack.self, from: json).toNitro()
+    // All-unknown declarations collapse to "no block" — one shape for "no
+    // declaration" on every platform.
+    #expect(track.style == nil)
+  }
+
+  @Test func decodesDisabled() throws {
+    let json = Data("""
+    {"title":"X","src":"s","disabled":true}
+    """.utf8)
+    let track = try JSONDecoder().decode(JsonTrack.self, from: json).toNitro()
+    #expect(track.disabled == true)
+  }
+
+  @Test func styleAndDisabledSurviveThePersistenceRoundTrip() throws {
+    // Restored queues keep their visible fidelity across process death.
+    let original = JsonTrack(
+      title: "X", src: "s",
+      style: JsonStyle(display: "grid", artworkRendering: "stencil"),
+      disabled: true,
+    )
+    let encoded = try JSONEncoder().encode(original)
+    let decoded = try JSONDecoder().decode(JsonTrack.self, from: encoded)
+    #expect(decoded.style == original.style)
+    #expect(decoded.disabled == true)
+  }
+}

package/ios/Tests/PlaybackStateStoreTests.swift

@@ -14,10 +14,11 @@ struct PlaybackStateStoreTests {
 
   private func sampleTrack() -> JsonTrack {
     JsonTrack(
-      id: "abc", url: nil, title: "Test FM", subtitle: nil, artwork: nil,
-      artist: "City, Country", albumUrl: nil, album: nil, description: nil,
+      id: "abc", path: nil, title: "Test FM", subtitle: nil, artwork: nil,
+      artist: "City, Country", albumPath: nil, album: nil, description: nil,
       genre: nil, duration: nil, src: "/listen/abc/channel.mp3", request: nil,
-      style: nil, childrenStyle: nil, groupTitle: nil, live: true, imageRow: nil,
+      style: JsonStyle(display: "grid", artworkRendering: "stencil"),
+      disabled: false, live: true,
     )
   }
 

package/ios/Tests/QueueManagerTests.swift

@@ -813,13 +813,13 @@ struct ComputedPropertyTests {
     let q = QueueManager()
     q.setQueue(tracks("a", "b", "c", "d"))
     q.shuffleEnabled = true
-    let nextFromProp = q.nextTracks.map(\.id)
+    let nextFromProp = q.nextTracks.map { $0.id! }
     // Navigate forward only as many times as nextTracks reports
     // (nextTracks does not include wrapped tracks)
     var nextFromNav: [String] = []
     for _ in 0 ..< nextFromProp.count {
       _ = q.next()
-      nextFromNav.append(q.currentTrack!.id)
+      nextFromNav.append(q.currentTrack!.id!)
     }
     #expect(nextFromProp == nextFromNav)
   }
@@ -832,12 +832,12 @@ struct ComputedPropertyTests {
     for _ in 0 ..< 3 {
       _ = q.next()
     }
-    let prevFromProp = q.previousTracks.map(\.id)
+    let prevFromProp = q.previousTracks.map { $0.id! }
     // Navigate backward the same number of times
     var prevFromNav: [String] = []
     for _ in 0 ..< prevFromProp.count {
       _ = q.previous()
-      prevFromNav.insert(q.currentTrack!.id, at: 0)
+      prevFromNav.insert(q.currentTrack!.id!, at: 0)
     }
     #expect(prevFromProp == prevFromNav)
   }

package/ios/Tests/ResolvedTrackCopyingTests.swift

@@ -3,17 +3,18 @@ import Testing
 @testable import AudioBrowserTestable
 
 private func makeResolvedTrack(
-  url: String = "/test",
+  path: String = "/test",
   title: String = "Test Track",
 ) -> ResolvedTrack {
   ResolvedTrack(
-    url: url,
+    path: path,
+    style: nil,
+    sections: nil,
     children: nil,
     carPlaySiriListButton: nil,
     src: nil,
     artwork: nil,
     artworkSource: nil,
-    artworkCarPlayTinted: nil,
     title: title,
     subtitle: nil,
     artist: nil,
@@ -21,25 +22,23 @@ private func makeResolvedTrack(
     description: nil,
     genre: nil,
     duration: nil,
-    style: nil,
-    childrenStyle: nil,
+    disabled: nil,
     favorited: nil,
-    groupTitle: nil,
     live: nil,
-    imageRow: nil,
   )
 }
 
 private func makeFullResolvedTrack() -> ResolvedTrack {
   ResolvedTrack(
-    url: "/original",
-    children: [Track(id: "t1", url: "/t1")],
+    path: "/original",
+    style: SectionStyle(gridWrap: false, display: .grid, artworkRendering: .stencil),
+    sections: [Section(title: "Group A", subtitle: nil, style: nil, path: nil, children: [])],
+    children: [Track(id: "t1", path: "/t1")],
     carPlaySiriListButton: .top,
     id: "original-id",
     src: "src.mp3",
     artwork: .first("art.jpg"),
     artworkSource: ImageSource(uri: "resolved-art.jpg"),
-    artworkCarPlayTinted: true,
     title: "Original Title",
     subtitle: "Original Subtitle",
     artist: "Original Artist",
@@ -47,12 +46,9 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
     description: "Original Description",
     genre: "Rock",
     duration: 180.0,
-    style: .list,
-    childrenStyle: .grid,
+    disabled: false,
     favorited: true,
-    groupTitle: "Group A",
     live: false,
-    imageRow: [ImageRowItem(title: "Row 1")],
   )
 }
 
@@ -64,12 +60,12 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
   #expect(copy == original)
 }
 
-// MARK: - non-optional fields (url, title)
+// MARK: - non-optional fields (path, title)
 
-@Test func copyingOverridesUrl() {
-  let original = makeResolvedTrack(url: "/old")
-  let copy = original.copying(url: "/new")
-  #expect(copy.url == "/new")
+@Test func copyingOverridesPath() {
+  let original = makeResolvedTrack(path: "/old")
+  let copy = original.copying(path: "/new")
+  #expect(copy.path == "/new")
   #expect(copy.title == "Test Track")
 }
 
@@ -77,14 +73,14 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
   let original = makeResolvedTrack(title: "Old")
   let copy = original.copying(title: "New")
   #expect(copy.title == "New")
-  #expect(copy.url == "/test")
+  #expect(copy.path == "/test")
 }
 
 // MARK: - optional fields: set value
 
 @Test func copyingOverridesChildren() {
   let original = makeResolvedTrack()
-  let children = [Track(id: "c1", url: "/c1"), Track(id: "c2", url: "/c2")]
+  let children = [Track(id: "c1", path: "/c1"), Track(id: "c2", path: "/c2")]
   let copy = original.copying(children: children)
   #expect(copy.children?.count == 2)
   #expect(copy.children?[0].id == "c1")
@@ -135,8 +131,14 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
 
 @Test func copyingOverridesStyle() {
   let original = makeResolvedTrack()
-  let copy = original.copying(style: .grid)
-  #expect(copy.style == .grid)
+  let copy = original.copying(style: SectionStyle(gridWrap: nil, display: .grid, artworkRendering: nil))
+  #expect(copy.style?.display == .grid)
+}
+
+@Test func copyingOverridesDisabled() {
+  let original = makeResolvedTrack()
+  let copy = original.copying(disabled: true)
+  #expect(copy.disabled == true)
 }
 
 @Test func copyingOverridesFavorited() {
@@ -157,11 +159,13 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
   #expect(copy.carPlaySiriListButton == .bottom)
 }
 
-@Test func copyingOverridesImageRow() {
+@Test func copyingOverridesSections() {
   let original = makeResolvedTrack()
-  let items = [ImageRowItem(title: "Item 1"), ImageRowItem(title: "Item 2")]
-  let copy = original.copying(imageRow: items)
-  #expect(copy.imageRow == items)
+  let sections = [
+    Section(title: "A", subtitle: nil, style: nil, path: nil, children: [Track(id: "c1", src: "c1")]),
+  ]
+  let copy = original.copying(sections: sections)
+  #expect(copy.sections == sections)
 }
 
 // MARK: - optional fields: set to nil via .some(nil)
@@ -206,13 +210,13 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
 @Test func copyingOverridesMultipleFields() {
   let original = makeResolvedTrack()
   let copy = original.copying(
-    url: "/updated",
+    path: "/updated",
     title: "Updated Title",
     artist: "New Artist",
     duration: 240.0,
     favorited: true,
   )
-  #expect(copy.url == "/updated")
+  #expect(copy.path == "/updated")
   #expect(copy.title == "Updated Title")
   #expect(copy.artist == "New Artist")
   #expect(copy.duration == 240.0)
@@ -230,23 +234,21 @@ private func makeFullResolvedTrack() -> ResolvedTrack {
   let copy = original.copying(title: "Changed Only Title")
   #expect(copy.title == "Changed Only Title")
   // All other fields unchanged
-  #expect(copy.url == "/original")
+  #expect(copy.path == "/original")
   #expect(copy.children?.count == 1)
   #expect(copy.carPlaySiriListButton == .top)
   #expect(copy.src == "src.mp3")
   #expect(copy.artwork?.url == "art.jpg")
   #expect(copy.artworkSource == ImageSource(uri: "resolved-art.jpg"))
-  #expect(copy.artworkCarPlayTinted == true)
   #expect(copy.subtitle == "Original Subtitle")
   #expect(copy.artist == "Original Artist")
   #expect(copy.album == "Original Album")
   #expect(copy.description == "Original Description")
   #expect(copy.genre == "Rock")
   #expect(copy.duration == 180.0)
-  #expect(copy.style == .list)
-  #expect(copy.childrenStyle == .grid)
+  #expect(copy.style == SectionStyle(gridWrap: false, display: .grid, artworkRendering: .stencil))
+  #expect(copy.disabled == false)
   #expect(copy.favorited == true)
-  #expect(copy.groupTitle == "Group A")
+  #expect(copy.sections?.first?.title == "Group A")
   #expect(copy.live == false)
-  #expect(copy.imageRow == [ImageRowItem(title: "Row 1")])
 }

package/ios/Tests/SearchDrillInTests.swift

@@ -4,14 +4,14 @@ import Testing
 
 private struct Item: PlayableSearchItem {
   let src: String?
-  let url: String?
+  let path: String?
 }
 
 @Suite("SearchDrillIn.playable")
 struct SearchDrillInTests {
   /// A resolver that fails the test if the drill-in path calls it.
-  private func unusedResolver(_ url: String) async throws -> [Item] {
-    Issue.record("resolveChildren should not have been called (url: \(url))")
+  private func unusedResolver(_ path: String) async throws -> [Item] {
+    Issue.record("resolveChildren should not have been called (path: \(path))")
     return []
   }
 
@@ -22,9 +22,9 @@ struct SearchDrillInTests {
 
   @Test func firstPlayable_returnsFlatPlayable_inOrder_withoutResolving() async throws {
     let items = [
-      Item(src: "/a.mp3", url: nil),
-      Item(src: nil, url: "/page/x"), // browsable, filtered out
-      Item(src: "/b.mp3", url: nil),
+      Item(src: "/a.mp3", path: nil),
+      Item(src: nil, path: "/page/x"), // browsable, filtered out
+      Item(src: "/b.mp3", path: nil),
     ]
     let result = try await SearchDrillIn.playable(from: items, resolveChildren: unusedResolver)
     #expect(result?.compactMap(\.src) == ["/a.mp3", "/b.mp3"])
@@ -32,31 +32,31 @@ struct SearchDrillInTests {
 
   @Test func firstBrowsable_drillsIntoIt_andPlaysItsChildren() async throws {
     let items = [
-      Item(src: nil, url: "/page/place"), // browsable first result
-      Item(src: "/later.mp3", url: nil), // would win without drill-in
+      Item(src: nil, path: "/page/place"), // browsable first result
+      Item(src: "/later.mp3", path: nil), // would win without drill-in
     ]
-    let result = try await SearchDrillIn.playable(from: items) { url in
-      #expect(url == "/page/place")
-      return [Item(src: "/station1.mp3", url: nil), Item(src: "/station2.mp3", url: nil)]
+    let result = try await SearchDrillIn.playable(from: items) { path in
+      #expect(path == "/page/place")
+      return [Item(src: "/station1.mp3", path: nil), Item(src: "/station2.mp3", path: nil)]
     }
     #expect(result?.compactMap(\.src) == ["/station1.mp3", "/station2.mp3"])
   }
 
   @Test func browsableDrillYieldsNothing_fallsBackToFlat() async throws {
     let items = [
-      Item(src: nil, url: "/page/empty"),
-      Item(src: "/fallback.mp3", url: nil),
+      Item(src: nil, path: "/page/empty"),
+      Item(src: "/fallback.mp3", path: nil),
     ]
     let result = try await SearchDrillIn.playable(from: items) { _ in
-      [Item(src: nil, url: "/page/nested")] // nothing playable inside
+      [Item(src: nil, path: "/page/nested")] // nothing playable inside
     }
     #expect(result?.compactMap(\.src) == ["/fallback.mp3"])
   }
 
   @Test func nothingPlayableAnywhere_returnsNil() async throws {
-    let items = [Item(src: nil, url: "/page/a"), Item(src: nil, url: "/page/b")]
+    let items = [Item(src: nil, path: "/page/a"), Item(src: nil, path: "/page/b")]
     let result = try await SearchDrillIn.playable(from: items) { _ in
-      [Item(src: nil, url: "/page/nested")]
+      [Item(src: nil, path: "/page/nested")]
     }
     #expect(result == nil)
   }

package/ios/Tests/SectionPresentationTests.swift

@@ -0,0 +1,61 @@
+import Testing
+
+@testable import AudioBrowserTestable
+
+// The (resolved style, platform capability) → rendered-form mapping (ADR
+// 0011): degradation drops decorations before layout, and the one layout drop
+// is a wrapping grid on a platform without a wrapping tile container.
+
+@Suite("SectionPresentation")
+struct SectionPresentationTests {
+  private func style(display: StyleDisplay?, gridWrap: Bool? = nil) -> SectionStyle {
+    SectionStyle(gridWrap: gridWrap, display: display, artworkRendering: nil)
+  }
+
+  @Test func noStyleRendersAList() {
+    #expect(SectionPresentation(for: nil, supportsWrappingGrid: true) == .list)
+    #expect(SectionPresentation(for: nil, supportsWrappingGrid: false) == .list)
+  }
+
+  @Test func listDisplayRendersAList() {
+    #expect(SectionPresentation(for: style(display: .list), supportsWrappingGrid: true) == .list)
+  }
+
+  @Test func wrappingGridNeedsTheWrappingContainer() {
+    #expect(
+      SectionPresentation(for: style(display: .grid), supportsWrappingGrid: true) == .wrappingGrid)
+    // The one layout drop: a wrapping grid has nowhere to go but a list —
+    // every item stays reachable instead of truncating at an unknowable width.
+    #expect(SectionPresentation(for: style(display: .grid), supportsWrappingGrid: false) == .list)
+  }
+
+  @Test func singleLineGridRendersOnEveryOS() {
+    // gridWrap: false is the legacy image row's own shape, so it never
+    // degrades — declaring it INCREASES pre-26 fidelity.
+    #expect(
+      SectionPresentation(for: style(display: .grid, gridWrap: false), supportsWrappingGrid: true)
+        == .singleLineRow)
+    #expect(
+      SectionPresentation(for: style(display: .grid, gridWrap: false), supportsWrappingGrid: false)
+        == .singleLineRow)
+  }
+
+  @Test func explicitWrapTrueBehavesLikeTheDefault() {
+    #expect(
+      SectionPresentation(for: style(display: .grid, gridWrap: true), supportsWrappingGrid: true)
+        == .wrappingGrid)
+    #expect(
+      SectionPresentation(for: style(display: .grid, gridWrap: true), supportsWrappingGrid: false)
+        == .list)
+  }
+
+  @Test func gridWrapIsInertOnLists() {
+    // Declaring a decoration never changes the layout you'd get without it.
+    #expect(
+      SectionPresentation(for: style(display: .list, gridWrap: false), supportsWrappingGrid: true)
+        == .list)
+    #expect(
+      SectionPresentation(for: style(display: nil, gridWrap: false), supportsWrappingGrid: true)
+        == .list)
+  }
+}