react-native-audio-browser 0.2.0-next.13 → 0.2.0-next.14

package/nitrogen/generated/ios/swift/Section.swift

@@ -18,19 +18,13 @@ public extension Section {
   /**
    * Create a new instance of `Section`.
    */
-  init(title: String?, subtitle: String?, style: SectionStyle?, path: String?, children: [Track]) {
+  init(title: String?, style: SectionStyle?, path: String?, children: [Track]) {
     self.init({ () -> bridge.std__optional_std__string_ in
       if let __unwrappedValue = title {
         return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
       } else {
         return .init()
       }
-    }(), { () -> bridge.std__optional_std__string_ in
-      if let __unwrappedValue = subtitle {
-        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
-      } else {
-        return .init()
-      }
     }(), { () -> bridge.std__optional_SectionStyle_ in
       if let __unwrappedValue = style {
         return bridge.create_std__optional_SectionStyle_(__unwrappedValue)
@@ -64,18 +58,6 @@ public extension Section {
     }()
   }
   
-  @inline(__always)
-  var subtitle: String? {
-    return { () -> String? in
-      if bridge.has_value_std__optional_std__string_(self.__subtitle) {
-        let __unwrapped = bridge.get_std__optional_std__string_(self.__subtitle)
-        return String(__unwrapped)
-      } else {
-        return nil
-      }
-    }()
-  }
-  
   @inline(__always)
   var style: SectionStyle? {
     return self.__style.value

package/nitrogen/generated/shared/c++/NativeBrowserConfiguration.hpp

@@ -78,16 +78,17 @@ namespace margelo::nitro::audiobrowser {
     std::optional<bool> singleTrack     SWIFT_PRIVATE;
     std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const TrackLoadEvent& /* event */)>> handleTrackLoad     SWIFT_PRIVATE;
     std::optional<bool> androidControllerOfflineError     SWIFT_PRIVATE;
+    std::optional<std::function<std::shared_ptr<Promise<std::string>>()>> viewMoreTitle     SWIFT_PRIVATE;
     std::optional<std::string> carPlayLoadingTitle     SWIFT_PRIVATE;
     std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const Track& /* track */)>> resolveAlbumPath     SWIFT_PRIVATE;
     std::optional<std::function<std::shared_ptr<Promise<std::optional<FormattedNavigationError>>>(const FormatNavigationErrorParams& /* params */)>> formatNavigationError     SWIFT_PRIVATE;
 
   public:
     NativeBrowserConfiguration() = default;
-    explicit NativeBrowserConfiguration(std::optional<std::string> path, std::optional<TransformableRequestConfig> request, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<TransformableRequestConfig>>>>()>> requestResolver, std::optional<TransformableRequestConfig> browse, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<TransformableRequestConfig>>>>()>> browseResolver, std::optional<MediaRequestConfig> media, std::optional<ArtworkRequestConfig> artwork, std::optional<ArtworkRequestConfig> nowPlayingArtwork, std::optional<std::vector<NativeRouteEntry>> routes, std::optional<bool> singleTrack, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const TrackLoadEvent& /* event */)>> handleTrackLoad, std::optional<bool> androidControllerOfflineError, std::optional<std::string> carPlayLoadingTitle, std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const Track& /* track */)>> resolveAlbumPath, std::optional<std::function<std::shared_ptr<Promise<std::optional<FormattedNavigationError>>>(const FormatNavigationErrorParams& /* params */)>> formatNavigationError): path(path), request(request), requestResolver(requestResolver), browse(browse), browseResolver(browseResolver), media(media), artwork(artwork), nowPlayingArtwork(nowPlayingArtwork), routes(routes), singleTrack(singleTrack), handleTrackLoad(handleTrackLoad), androidControllerOfflineError(androidControllerOfflineError), carPlayLoadingTitle(carPlayLoadingTitle), resolveAlbumPath(resolveAlbumPath), formatNavigationError(formatNavigationError) {}
+    explicit NativeBrowserConfiguration(std::optional<std::string> path, std::optional<TransformableRequestConfig> request, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<TransformableRequestConfig>>>>()>> requestResolver, std::optional<TransformableRequestConfig> browse, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<TransformableRequestConfig>>>>()>> browseResolver, std::optional<MediaRequestConfig> media, std::optional<ArtworkRequestConfig> artwork, std::optional<ArtworkRequestConfig> nowPlayingArtwork, std::optional<std::vector<NativeRouteEntry>> routes, std::optional<bool> singleTrack, std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const TrackLoadEvent& /* event */)>> handleTrackLoad, std::optional<bool> androidControllerOfflineError, std::optional<std::function<std::shared_ptr<Promise<std::string>>()>> viewMoreTitle, std::optional<std::string> carPlayLoadingTitle, std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const Track& /* track */)>> resolveAlbumPath, std::optional<std::function<std::shared_ptr<Promise<std::optional<FormattedNavigationError>>>(const FormatNavigationErrorParams& /* params */)>> formatNavigationError): path(path), request(request), requestResolver(requestResolver), browse(browse), browseResolver(browseResolver), media(media), artwork(artwork), nowPlayingArtwork(nowPlayingArtwork), routes(routes), singleTrack(singleTrack), handleTrackLoad(handleTrackLoad), androidControllerOfflineError(androidControllerOfflineError), viewMoreTitle(viewMoreTitle), carPlayLoadingTitle(carPlayLoadingTitle), resolveAlbumPath(resolveAlbumPath), formatNavigationError(formatNavigationError) {}
 
   public:
-    // NativeBrowserConfiguration is not equatable because these properties are not equatable: request, requestResolver, browse, browseResolver, media, artwork, nowPlayingArtwork, routes, handleTrackLoad, resolveAlbumPath, formatNavigationError
+    // NativeBrowserConfiguration is not equatable because these properties are not equatable: request, requestResolver, browse, browseResolver, media, artwork, nowPlayingArtwork, routes, handleTrackLoad, viewMoreTitle, resolveAlbumPath, formatNavigationError
   };
 
 } // namespace margelo::nitro::audiobrowser
@@ -112,6 +113,7 @@ namespace margelo::nitro {
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "singleTrack"))),
         JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const margelo::nitro::audiobrowser::TrackLoadEvent&)>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "handleTrackLoad"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidControllerOfflineError"))),
+        JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::string>>()>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "viewMoreTitle"))),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "carPlayLoadingTitle"))),
         JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const margelo::nitro::audiobrowser::Track&)>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resolveAlbumPath"))),
         JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<margelo::nitro::audiobrowser::FormattedNavigationError>>>(const margelo::nitro::audiobrowser::FormatNavigationErrorParams&)>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formatNavigationError")))
@@ -131,6 +133,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "singleTrack"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.singleTrack));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "handleTrackLoad"), JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const margelo::nitro::audiobrowser::TrackLoadEvent&)>>>::toJSI(runtime, arg.handleTrackLoad));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "androidControllerOfflineError"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.androidControllerOfflineError));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "viewMoreTitle"), JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::string>>()>>>::toJSI(runtime, arg.viewMoreTitle));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "carPlayLoadingTitle"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.carPlayLoadingTitle));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "resolveAlbumPath"), JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const margelo::nitro::audiobrowser::Track&)>>>::toJSI(runtime, arg.resolveAlbumPath));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "formatNavigationError"), JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<margelo::nitro::audiobrowser::FormattedNavigationError>>>(const margelo::nitro::audiobrowser::FormatNavigationErrorParams&)>>>::toJSI(runtime, arg.formatNavigationError));
@@ -156,6 +159,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "singleTrack")))) return false;
       if (!JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<void>>>>(const margelo::nitro::audiobrowser::TrackLoadEvent&)>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "handleTrackLoad")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "androidControllerOfflineError")))) return false;
+      if (!JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::string>>()>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "viewMoreTitle")))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "carPlayLoadingTitle")))) return false;
       if (!JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<std::string>>>(const margelo::nitro::audiobrowser::Track&)>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resolveAlbumPath")))) return false;
       if (!JSIConverter<std::optional<std::function<std::shared_ptr<Promise<std::optional<margelo::nitro::audiobrowser::FormattedNavigationError>>>(const margelo::nitro::audiobrowser::FormatNavigationErrorParams&)>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "formatNavigationError")))) return false;

package/nitrogen/generated/shared/c++/Section.hpp

@@ -47,14 +47,13 @@ namespace margelo::nitro::audiobrowser {
   struct Section final {
   public:
     std::optional<std::string> title     SWIFT_PRIVATE;
-    std::optional<std::string> subtitle     SWIFT_PRIVATE;
     std::optional<SectionStyle> style     SWIFT_PRIVATE;
     std::optional<std::string> path     SWIFT_PRIVATE;
     std::vector<Track> children     SWIFT_PRIVATE;
 
   public:
     Section() = default;
-    explicit Section(std::optional<std::string> title, std::optional<std::string> subtitle, std::optional<SectionStyle> style, std::optional<std::string> path, std::vector<Track> children): title(title), subtitle(subtitle), style(style), path(path), children(children) {}
+    explicit Section(std::optional<std::string> title, std::optional<SectionStyle> style, std::optional<std::string> path, std::vector<Track> children): title(title), style(style), path(path), children(children) {}
 
   public:
     friend bool operator==(const Section& lhs, const Section& rhs) = default;
@@ -71,7 +70,6 @@ namespace margelo::nitro {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::audiobrowser::Section(
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "title"))),
-        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subtitle"))),
         JSIConverter<std::optional<margelo::nitro::audiobrowser::SectionStyle>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "style"))),
         JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "path"))),
         JSIConverter<std::vector<margelo::nitro::audiobrowser::Track>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "children")))
@@ -80,7 +78,6 @@ namespace margelo::nitro {
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::audiobrowser::Section& arg) {
       jsi::Object obj(runtime);
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "title"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.title));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "subtitle"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.subtitle));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "style"), JSIConverter<std::optional<margelo::nitro::audiobrowser::SectionStyle>>::toJSI(runtime, arg.style));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "path"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.path));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "children"), JSIConverter<std::vector<margelo::nitro::audiobrowser::Track>>::toJSI(runtime, arg.children));
@@ -95,7 +92,6 @@ namespace margelo::nitro {
         return false;
       }
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "title")))) return false;
-      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "subtitle")))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::audiobrowser::SectionStyle>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "style")))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "path")))) return false;
       if (!JSIConverter<std::vector<margelo::nitro::audiobrowser::Track>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "children")))) return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-audio-browser",
-  "version": "0.2.0-next.13",
+  "version": "0.2.0-next.14",
   "description": "react-native-audio-browser is a react native package built with Nitro",
   "keywords": [
     "react-native",

package/src/features/browser-config.ts

@@ -289,6 +289,7 @@ export function toNativeConfig(
     singleTrack: config.singleTrack,
     handleTrackLoad: config.handleTrackLoad,
     androidControllerOfflineError: config.androidControllerOfflineError,
+    viewMoreTitle: config.viewMoreTitle,
     carPlayLoadingTitle: config.carPlayLoadingTitle,
     resolveAlbumPath: config.resolveAlbumPath,
     formatNavigationError: config.formatNavigationError

package/src/types/browser-native.ts

@@ -14,7 +14,8 @@ import type {
   HandleTrackLoadCallback,
   MediaRequestConfig,
   SearchSourceCallback,
-  TransformableRequestConfig
+  TransformableRequestConfig,
+  ViewMoreTitleCallback
 } from './browser'
 import type { ResolvedTrack } from './browser-nodes'
 
@@ -73,6 +74,9 @@ export interface NativeBrowserConfiguration {
   singleTrack?: boolean
   handleTrackLoad?: HandleTrackLoadCallback
   androidControllerOfflineError?: boolean
+  // Title of the "view more" row appended to a pathed section where the header
+  // can't be tapped (Android Auto). Absent = native's "View more" default.
+  viewMoreTitle?: ViewMoreTitleCallback
 
   // CarPlay options
   carPlayLoadingTitle?: string

package/src/types/browser-nodes.ts

@@ -293,11 +293,6 @@ export type TrackArtwork = string | ArtworkVariants
 export interface Section {
   /** Header text. Absent = headerless group. */
   title?: string
-  /**
-   * Secondary line for the section's navigation surface — e.g. the label
-   * of the "view all" link a tile section gets on Android Auto.
-   */
-  subtitle?: string
   /**
    * Presentation, separated from content. Each surface renders the
    * declared layout's nearest supported form; on CarPlay
@@ -308,10 +303,20 @@ export interface Section {
    */
   style?: SectionStyle
   /**
-   * Navigation target for the section header / "view all" surface. A
-   * tile section's header tap (CarPlay) and appended "view all" link
-   * (Android Auto) navigate here. Absent = a self-contained section:
-   * the header is a plain label, not a link.
+   * Navigation target for the section's "view all" affordance — the
+   * fuller page this section is a teaser for. Absent = a self-contained
+   * section: the header is a plain label, not a link.
+   *
+   * The surface picks the form (ADR 0010), and each carries the copy
+   * itself — a `path` never adds words to the section:
+   *
+   * - **CarPlay** — a tile section's row draws a disclosure chevron and
+   *   the whole row navigates. A list section renders no affordance:
+   *   CarPlay has no "see all" idiom for one, and an invented row would
+   *   spend an item from the template's cap.
+   * - **Android Auto** — no header is tappable at any display, so the
+   *   section gets an appended browsable row, titled by the global
+   *   `viewMoreTitle` browser option ("View more" by default).
    */
   path?: string
   /** The section's tracks. */

package/src/types/browser.ts

@@ -931,6 +931,41 @@ export type BrowserConfiguration = {
    */
   androidControllerOfflineError?: boolean
 
+  /**
+   * Titles the "view more" row appended to a `Section` that carries a
+   * `Section.path` on surfaces whose section header cannot be tapped —
+   * Android Auto, today the only one.
+   *
+   * Leave it unset and the row is titled "View more" — the library's in-code
+   * default, the same arrangement `formatNavigationError` has. Set this to
+   * localize it: it is re-resolved once per content generation, so
+   * `invalidateAllContent()` after an in-app language switch picks up the new
+   * copy without reconfiguring the browser. That is why it is a callback rather
+   * than a plain string — an app whose locale is its own, not the system's,
+   * cannot express that with a value frozen at configure time.
+   *
+   * One string for every section by design — the row is a fallback for a
+   * surface that cannot draw a link in its header, so per-section wording would
+   * be ceremony most consumers never see rendered.
+   *
+   * For wording that varies by section — "View all 42 albums", "See every
+   * episode" — author the link yourself instead: append an ordinary browsable
+   * {@link Track} to the section's `children`, titled however you like, and
+   * leave `Section.path` unset so this row doesn't also appear. Since the
+   * row is Android-only, that branch is an ordinary platform check on the
+   * content you emit; CarPlay never sees the extra row.
+   *
+   * @default 'View more'
+   *
+   * @example
+   * ```typescript
+   * viewMoreTitle: () => t('View more')
+   * ```
+   *
+   * @platform android
+   */
+  viewMoreTitle?: ViewMoreTitleCallback
+
   /**
    * Title shown (as the list's centered empty state) on CarPlay screens whose
    * content is still loading — browse destinations while they resolve, and the
@@ -1093,3 +1128,6 @@ export type FormatNavigationErrorCallback = (
  * or `undefined` to do nothing. See `resolveAlbumPath`.
  */
 export type ResolveAlbumPathCallback = (track: Track) => string | undefined
+
+/** Supplies the title of the appended "view more" row. See `viewMoreTitle`. */
+export type ViewMoreTitleCallback = () => string

package/website/guide/android-auto.md

@@ -66,7 +66,7 @@ Android Auto reads a page's layout from the **parent item** that opens it — be
 ```
 
 - **`style.display` on the parent item** — `'list'` (rows) or `'grid'` (tiles). Below the root this is the only layout signal Android Auto honors, and it is only sent when you declare it — leave it off and the page renders as a list. In dev mode the library warns when an all-grid page is opened from a parent item with no declared `display`. (A section's "view all" page needs no declaration of its own: it reuses the section's `style`.)
-- **Sections** — declare `sections` on the page to group its tracks under headers; each [`Section`](/api/types/browser-nodes/#section)'s `title` renders as a header above its children, plus a "view all" link built from the section's `path` and `subtitle`.
+- **Sections** — declare `sections` on the page to group its tracks under headers; each [`Section`](/api/types/browser-nodes/#section)'s `title` renders as a header above its children. A section that carries a `path` also gets a browsable "view more" row appended after its children, navigating there. No header is tappable on Android Auto at any `display`, so the row is the only affordance the section's `path` has here; its title comes from the [`viewMoreTitle`](/api/types/browser/#viewmoretitle) browser option, defaulting to `"View more"` — one wording for every section. For per-section copy (`"View all 42 albums"`), leave `path` unset and append your own browsable `Track` to `children` instead, titled however you like; this page's content is Android-only anyway, so CarPlay never sees it.
 
 ::: warning AAOS lays out the whole page from the parent item's `display`
 On AOSP-based Android Automotive units — including mainstream cars' OEM skins — the parent item's `display` is the **only** below-root layout signal honored: the whole page renders as list or grid, uniformly. Per-section `display` differences (a single-line grid above a list, say) render on CarPlay and projected Android Auto, but an AAOS unit shows the page in the single declared layout. There is no way to describe a mixed page there — pick the layout that suits its dominant section, or split the content across pages. `gridWrap: false` also has no single-line container there: the grid wraps, showing more, never less.

package/website/guide/browser.md

@@ -76,7 +76,7 @@ A **page** is a [`ResolvedTrack`](/api/types/browser-nodes/#resolvedtrack): it r
 }
 ```
 
-A Section is `{ title?, subtitle?, style?, path?, children }`: `title` renders as a header above its tracks, `style` is a declaration block whose `display` picks the children's layout (`'list'` rows — the default — or `'grid'` artwork tiles; `gridWrap: false` keeps the grid to a single line), and `path` is the navigation target for the header / "view all" surface. See [Presentation](#presentation) for how each surface renders the declarations.
+A Section is `{ title?, style?, path?, children }`: `title` renders as a header above its tracks, `style` is a declaration block whose `display` picks the children's layout (`'list'` rows — the default — or `'grid'` artwork tiles; `gridWrap: false` keeps the grid to a single line), and `path` is the navigation target for the section's "view all" affordance. See [Presentation](#presentation) for how each surface renders the declarations.
 
 A flat page doesn't have to spell that out: authoring a plain `children: Track[]` — as most examples in this guide do — is sugar for one untitled section. Resolved output always carries `sections`; `children` is never populated on a resolved page.
 
@@ -512,24 +512,24 @@ The `code` values: `content-not-found`, `network-error`, `http-error`, `callback
 
 Presentation lives in `style` blocks, separate from content, plus a few Track fields and config options. Each surface applies the style properties it supports and ignores the rest — an unsupported property is a no-op, never an error.
 
-| Field                                            | On                       | Effect                                                                       | Platform            |
-| ------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------- | ------------------- |
-| `title`                                          | a section                | header above its tracks                                                      | all                 |
-| `style: { display: 'grid' }`                     | a section                | wrapping artwork-tile grid                                                   | all\*               |
-| `style: { display: 'grid', gridWrap: false }`    | a section                | a single line of artwork tiles                                               | all\*               |
-| `path` (+ `subtitle`)                            | a section                | header / "view all" navigation target                                        | all                 |
-| `style` (same block)                             | a page                   | declaration for the whole page — a section overrides it for its own children | all                 |
-| `style: { display: 'grid' }`                     | a browsable track        | the layout of the page it opens — Android Auto reads it from the parent item | Android Auto / AAOS |
-| `style: { artworkRendering: 'stencil' }`         | a track / section / page | tint monochrome artwork to the surface appearance                            | CarPlay             |
-| `style: { imageShape: 'circular' }`              | a track / section / page | crop grid-tile artwork circular (people) instead of rounded                  | CarPlay (iOS 26+)   |
-| `style: { accessorySymbol: 'lock.fill' }`        | a track / section / page | SF Symbol accessory on rows and tiles (`'none'` restores the derived one)    | CarPlay             |
-| `style: { gridTile: 'card' }`                    | a section / page         | the grid's tile kind: `'plain'` (default), `'card'`, or `'condensed'`        | CarPlay (iOS 26+)   |
-| `style: { cardTint: '#1e3a8a' }` (+ `cardImage`) | a track / section / page | card color and image mode (`'background'` fills the card full-height)        | CarPlay (iOS 26+)   |
-| `disabled: true`                                 | a track                  | unavailable: never plays; grayed where drawable, hidden elsewhere            | all                 |
-| `artwork: 'sf:heart.fill'`                       | any item                 | SF Symbol icon (supports `?bg=…&fg=…`)                                       | iOS                 |
-| `live: true`                                     | a track                  | live indicator                                                               | iOS                 |
-| `carPlaySiriListButton: 'top' \| 'bottom'`       | a page                   | place the Siri cell on the page                                              | iOS                 |
-| `albumPath` + `resolveAlbumPath`                 | track + config           | make the now-playing album line tappable                                     | CarPlay             |
+| Field                                            | On                       | Effect                                                                            | Platform            |
+| ------------------------------------------------ | ------------------------ | --------------------------------------------------------------------------------- | ------------------- |
+| `title`                                          | a section                | header above its tracks                                                           | all                 |
+| `style: { display: 'grid' }`                     | a section                | wrapping artwork-tile grid                                                        | all\*               |
+| `style: { display: 'grid', gridWrap: false }`    | a section                | a single line of artwork tiles                                                    | all\*               |
+| `path`                                           | a section                | "view all" target — a tappable header on CarPlay, an appended row on Android Auto | all                 |
+| `style` (same block)                             | a page                   | declaration for the whole page — a section overrides it for its own children      | all                 |
+| `style: { display: 'grid' }`                     | a browsable track        | the layout of the page it opens — Android Auto reads it from the parent item      | Android Auto / AAOS |
+| `style: { artworkRendering: 'stencil' }`         | a track / section / page | tint monochrome artwork to the surface appearance                                 | CarPlay             |
+| `style: { imageShape: 'circular' }`              | a track / section / page | crop grid-tile artwork circular (people) instead of rounded                       | CarPlay (iOS 26+)   |
+| `style: { accessorySymbol: 'lock.fill' }`        | a track / section / page | SF Symbol accessory on rows and tiles (`'none'` restores the derived one)         | CarPlay             |
+| `style: { gridTile: 'card' }`                    | a section / page         | the grid's tile kind: `'plain'` (default), `'card'`, or `'condensed'`             | CarPlay (iOS 26+)   |
+| `style: { cardTint: '#1e3a8a' }` (+ `cardImage`) | a track / section / page | card color and image mode (`'background'` fills the card full-height)             | CarPlay (iOS 26+)   |
+| `disabled: true`                                 | a track                  | unavailable: never plays; grayed where drawable, hidden elsewhere                 | all                 |
+| `artwork: 'sf:heart.fill'`                       | any item                 | SF Symbol icon (supports `?bg=…&fg=…`)                                            | iOS                 |
+| `live: true`                                     | a track                  | live indicator                                                                    | iOS                 |
+| `carPlaySiriListButton: 'top' \| 'bottom'`       | a page                   | place the Siri cell on the page                                                   | iOS                 |
+| `albumPath` + `resolveAlbumPath`                 | track + config           | make the now-playing album line tappable                                          | CarPlay             |
 
 ::: info Caveats from the table
 **`albumPath` requires `album`** — CarPlay renders the tappable line from the album metadata, so without an `album` there is no line to tap. **\*Layouts render each platform's nearest supported form** — a single-line grid (`gridWrap: false`) on CarPlay shows the tiles that fit (roughly eight, width-dependent) and truncates the rest; a wrapping grid takes as many lines as it needs on iOS 26+ and renders as a list before that. Android Auto's grid always wraps, so it shows more, never less. No car surface scrolls horizontally; an app UI typically renders `gridWrap: false` as a horizontal scroller. Truncation is visual only: tapping a tile queues the whole section (see [Playback behavior](#playback-behavior)). Item properties like `artworkRendering`, `imageShape`, and `accessorySymbol` are inherited — `track ?? section ?? page`, per property — so a section-wide value can be overridden per item; `accessorySymbol: 'none'` is the per-item escape from an inherited symbol, and where the accessory draws is the platform's choice per surface (trailing on list rows, leading the title on tiles). `display` is never inherited: it always describes the children of whatever it's set on. On a page or section it lays out that page or section; on a browsable track it declares the layout of the page that track opens — Android Auto needs it there, or that page renders as a list. `gridWrap` is inert unless `display` is `'grid'`. One AAOS caveat: AOSP-based Automotive units honor only the parent item's `display`, so a page mixing grid and list sections renders uniformly there — see [Android Auto → Browse display](/guide/android-auto#browse-display).