@javascriptcommon/react-native-carplay 2.3.11 → 2.4.1-beta.0

package/lib/templates/android/PlaceListMapTemplate.d.ts

@@ -0,0 +1,58 @@
+import { Action, HeaderAction } from '../../interfaces/Action';
+import { AndroidNavigationBaseTemplate, AndroidNavigationBaseTemplateConfig } from './AndroidNavigationBaseTemplate';
+import { Place } from '../../interfaces/Place';
+import { ListItem } from '../../interfaces/ListItem';
+export interface PlaceListMapTemplateConfig extends AndroidNavigationBaseTemplateConfig {
+    /**
+     * Sets an ActionStrip with a list of template-scoped actions for this template.
+     * The Action buttons in Map Based Template are automatically adjusted based on the screen size. On narrow width screen, icon Actions show by default. If no icon specify, showing title Actions instead. On wider width screen, title Actions show by default. If no title specify, showing icon Actions instead.
+     * @limit This template allows up to 4 Actions in its ActionStrip. Of the 4 allowed Actions, it can either be a title Action as set via setTitle, or a icon Action as set via setIcon.
+     */
+    actions?: Action[];
+    /**
+     * Sets the anchor maker on the map.
+     * An anchor marker will not be displayed unless set with this method.
+     * The anchor marker is displayed differently from other markers by the host.
+     * If not null, an anchor marker will be shown at the specified CarLocation on the map. The camera will adapt to always have the anchor marker visible within its viewport, along with other places' markers from Row that are currently visible in the Pane. This can be used to provide a reference point on the map (e.g. the center of a search region) as the user pages through the Pane's markers, for example.
+     */
+    anchor?: Place;
+    /**
+     * Sets whether to show the current location in the map.
+     * The map template will show the user's current location on the map.
+     * This functionality requires the app to have either the ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION permission. When isEnabled is true, the host may receive location updates from the app in order to show the user's current location.
+     */
+    currentLocationEnabled?: boolean;
+    /**
+     * Sets the Action that will be displayed in the header of the template.
+     * Unless set with this method, the template will not have a header action.
+     * @limit This template only supports either one of APP_ICON and BACK as a header Action.
+     */
+    headerAction?: HeaderAction;
+    /**
+     * Sets an ItemList to show in a list view along with the map.
+     * Unless set with this method, the template will not show an item list.
+     * To show a marker corresponding to a point of interest represented by a row, set the Place instance via setMetadata. The host will display the PlaceMarker in both the map and the list view as the row becomes visible.
+     * @limit The number of items in the ItemList should be smaller or equal than the limit provided by CONTENT_LIMIT_TYPE_PLACE_LIST. The host will ignore any items over that limit. The list itself cannot be selectable as set via setOnSelectedListener. Each Row can add up to 2 lines of texts via addText and cannot contain a Toggle.
+     */
+    itemList?: ListItem[];
+    /**
+     * Sets whether the template is in a loading state.
+     */
+    loading?: boolean;
+    /**
+     * Title for the map
+     */
+    title?: string;
+}
+/**
+ * A template that displays a map along with a list of places.
+ * The map can display markers corresponding to the places in the list. See setItemList for details.
+ * Template Restrictions In regards to template refreshes, as described in onGetTemplate, this template is considered a refresh of a previous one if:
+ * - The previous template is in a loading state (see setLoading, or
+ * - The template title has not changed, and the number of rows and the title (not counting spans) of each row between the previous and new ItemLists have not changed.
+ * - The template is sent in response to a user-initiated content refresh request. (see setOnContentRefreshListener.
+ */
+export declare class PlaceListMapTemplate extends AndroidNavigationBaseTemplate<PlaceListMapTemplateConfig> {
+    get type(): string;
+}
+//# sourceMappingURL=PlaceListMapTemplate.d.ts.map

package/lib/templates/android/PlaceListMapTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceListMapTemplate.d.ts","sourceRoot":"","sources":["../../../src/templates/android/PlaceListMapTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,0BAA2B,SAAQ,mCAAmC;IACrF;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,6BAA6B,CAAC,0BAA0B,CAAC;IACjG,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/lib/templates/android/PlaceListNavigationTemplate.d.ts

@@ -0,0 +1,51 @@
+import { Action } from '../../interfaces/Action';
+import { Header } from '../../interfaces/Header';
+import { ListItem } from '../../interfaces/ListItem';
+import { AndroidNavigationBaseTemplate, AndroidNavigationBaseTemplateConfig } from './AndroidNavigationBaseTemplate';
+export interface PlaceListNavigationTemplateConfig extends AndroidNavigationBaseTemplateConfig {
+    /**
+     * Sets an ActionStrip with a list of template-scoped actions for this template.
+     * The Action buttons in Map Based Template are automatically adjusted based on the screen size. On narrow width screen, icon Actions show by default. If no icon specify, showing title Actions instead. On wider width screen, title Actions show by default. If no title specify, showing icon Actions instead.
+     * @limit This template allows up to 4 Actions in its ActionStrip. Of the 4 allowed Actions, it can either be a title Action as set via setTitle, or a icon Action as set via setIcon.
+     */
+    actions?: Action[];
+    /**
+     * Sets the Header for this template.
+     */
+    header?: Header;
+    /**
+     * Sets an ItemList to show in a list view along with the map.
+     * Unless set with this method, the template will not show an item list.
+     * To show a marker corresponding to a point of interest represented by a row, set the Place instance via setMetadata. The host will display the PlaceMarker in both the map and the list view as the row becomes visible.
+     * @limit The number of items in the ItemList should be smaller or equal than the limit provided by CONTENT_LIMIT_TYPE_PLACE_LIST. The host will ignore any items over that limit. The list itself cannot be selectable as set via setOnSelectedListener. Each Row can add up to 2 lines of texts via addText and cannot contain a Toggle.
+     */
+    itemList?: ListItem[];
+    /**
+     * Sets whether the template is in a loading state.
+     */
+    loading?: boolean;
+    /**
+     * Sets an ActionStrip with a list of map-control related actions for this template, such as pan or zoom.
+     * The host will draw the buttons in an area that is associated with map controls.
+     * If the app does not include the PAN button in this ActionStrip, the app will not receive the user input for panning gestures from SurfaceCallback methods, and the host will exit any previously activated pan mode.
+     * @limit This template allows up to 4 Actions in its map ActionStrip. Only Actions with icons set via setIcon are allowed.
+     */
+    mapButtons?: Action[];
+    /**
+     * Title for the map
+     */
+    title?: string;
+}
+/**
+ * A template that supports showing a list of places alongside a custom drawn map.
+ * The template itself does not expose a drawing surface. In order to draw on the canvas, use setSurfaceCallback.
+ * Template Restrictions In regards to template refreshes, as described in onGetTemplate, this template is considered a refresh of a previous one if:
+ * - The previous template is in a loading state (see setLoading, or
+ * - The template title has not changed, and the number of rows and the title (not counting spans) of each row between the previous and new ItemLists have not changed.
+ * - The template is sent in response to a user-initiated content refresh request. (see setOnContentRefreshListener.
+ * In order to use this template your car app MUST declare that it uses the **androidx.car.app.NAVIGATION_TEMPLATES** permission in the manifest.
+ */
+export declare class PlaceListNavigationTemplate extends AndroidNavigationBaseTemplate<PlaceListNavigationTemplateConfig> {
+    get type(): string;
+}
+//# sourceMappingURL=PlaceListNavigationTemplate.d.ts.map

package/lib/templates/android/PlaceListNavigationTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceListNavigationTemplate.d.ts","sourceRoot":"","sources":["../../../src/templates/android/PlaceListNavigationTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACpC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iCAAkC,SAAQ,mCAAmC;IAC5F;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,SAAQ,6BAA6B,CAAC,iCAAiC,CAAC;IAC/G,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/lib/templates/android/RoutePreviewNavigationTemplate.d.ts

@@ -0,0 +1,60 @@
+import { Action } from '../../interfaces/Action';
+import { Header } from '../../interfaces/Header';
+import { ListItem } from '../../interfaces/ListItem';
+import { AndroidNavigationBaseTemplate, AndroidNavigationBaseTemplateConfig } from './AndroidNavigationBaseTemplate';
+export interface RoutePreviewNavigationTemplateConfig extends AndroidNavigationBaseTemplateConfig {
+    /**
+     * Sets an ActionStrip with a list of template-scoped actions for this template.
+     * The Action buttons in Map Based Template are automatically adjusted based on the screen size. On narrow width screen, icon Actions show by default. If no icon specify, showing title Actions instead. On wider width screen, title Actions show by default. If no title specify, showing icon Actions instead.
+     * @limit This template allows up to 4 Actions in its ActionStrip. Of the 4 allowed Actions, it can either be a title Action as set via setTitle, or a icon Action as set via setIcon.
+     */
+    actions?: Action[];
+    /**
+     * Sets the Header for this template.
+     */
+    header?: Header;
+    /**
+     * Sets an ItemList to show in a list view along with the map.
+     * Unless set with this method, the template will not show an item list.
+     * To show a marker corresponding to a point of interest represented by a row, set the Place instance via setMetadata. The host will display the PlaceMarker in both the map and the list view as the row becomes visible.
+     * @limit The number of items in the ItemList should be smaller or equal than the limit provided by CONTENT_LIMIT_TYPE_PLACE_LIST. The host will ignore any items over that limit. The list itself cannot be selectable as set via setOnSelectedListener. Each Row can add up to 2 lines of texts via addText and cannot contain a Toggle.
+     */
+    itemList?: ListItem[];
+    /**
+     * Sets whether the template is in a loading state.
+     */
+    loading?: boolean;
+    /**
+     * Sets an ActionStrip with a list of map-control related actions for this template, such as pan or zoom.
+     * The host will draw the buttons in an area that is associated with map controls.
+     * If the app does not include the PAN button in this ActionStrip, the app will not receive the user input for panning gestures from SurfaceCallback methods, and the host will exit any previously activated pan mode.
+     * @limit This template allows up to 4 Actions in its map ActionStrip. Only Actions with icons set via setIcon are allowed.
+     */
+    mapButtons?: Action[];
+    /**
+     * Sets the Action to allow users to request navigation using the currently selected route.
+     * This should not be null if the template is not in a loading state (see #setIsLoading}), and the Action's title must be set.
+     * Spans are not supported in the navigate action and will be ignored.
+     */
+    navigateAction?: Action;
+    /**
+     * Title for the map
+     */
+    title?: string;
+}
+/**
+ * A template that supports showing a list of routes alongside a custom drawn map.
+ * The list must have its ItemList.OnSelectedListener set, and the template must have its navigate action set (see setNavigateAction). These are used in conjunction to inform the app that:
+ * - A route has been selected. The app should also highlight the route on the map surface.
+ * - A navigate action has been triggered. The app should begin navigation using the selected route.
+ * The template itself does not expose a drawing surface. In order to draw on the canvas, use setSurfaceCallback.
+ * Template Restrictions In regards to template refreshes, as described in onGetTemplate, this template is considered a refresh of a previous one if:
+ * - The previous template is in a loading state (see setLoading, or
+ * - The template title has not changed, and the number of rows and the title (not counting spans) of each row between the previous and new ItemLists have not changed.
+ * Note that specifically, this means the app should not use this template to continuously refresh the routes as the car moves.
+ * In order to use this template your car app MUST declare that it uses the **androidx.car.app.NAVIGATION_TEMPLATES** permission in the manifest.
+ */
+export declare class RoutePreviewNavigationTemplate extends AndroidNavigationBaseTemplate<RoutePreviewNavigationTemplateConfig> {
+    get type(): string;
+}
+//# sourceMappingURL=RoutePreviewNavigationTemplate.d.ts.map

package/lib/templates/android/RoutePreviewNavigationTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutePreviewNavigationTemplate.d.ts","sourceRoot":"","sources":["../../../src/templates/android/RoutePreviewNavigationTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,mCAAmC,EACpC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,oCAAqC,SAAQ,mCAAmC;IAC/F;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA+B,SAAQ,6BAA6B,CAAC,oCAAoC,CAAC;IACrH,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@javascriptcommon/react-native-carplay",
-  "version": "2.3.11",
+  "version": "2.4.1-beta.0",
   "description": "CarPlay for React Native",
   "main": "lib/index.js",
   "react-native": "src/index.ts",
@@ -9,6 +9,7 @@
     "src",
     "lib",
     "ios",
+    "android",
     "react-native-carplay.podspec"
   ],
   "podspecPath": "./react-native-carplay.podspec",
@@ -16,7 +17,7 @@
     "prepack": "yarn run build",
     "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
     "typecheck": "tsc --noEmit",
-    "build": "tsc",
+    "build": "tsc -p tsconfig.build.json",
     "fix-all-files": "eslint . --ext .ts,.tsx,.js,.jsx --fix"
   },
   "repository": {
@@ -55,7 +56,6 @@
     "@types/node": "17.0.25",
     "@types/react": "18.0.6",
     "@types/react-native": "0.67.5",
-    "babel-jest": "^29.2.1",
     "cross-env": "7.0.3",
     "docusaurus-plugin-typedoc": "0.19.2",
     "eslint": "^8.19.0",

package/react-native-carplay.podspec

@@ -3,7 +3,7 @@ require 'json'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
 Pod::Spec.new do |s|
-  s.name         = 'react-native-carplay'
+  s.name         = package['name']
   s.version      = package['version']
   s.summary      = package['description']
 
@@ -13,9 +13,9 @@ Pod::Spec.new do |s|
   s.authors      = package['author']
   s.ios.deployment_target = '12.0'
 
-  s.source       = { :git => "https://github.com/Spicy-Sparks/react-native-carplay.git" }
+  s.source       = { :git => "https://github.com/birkir/react-native-carplay.git" }
 
   s.source_files  = "ios/*.{h,m}"
 
-  s.dependency 'React-Core'
+  s.dependency 'React'
 end

package/src/CarPlay.ts

@@ -1,29 +1,35 @@
-import { ImageSourcePropType, NativeEventEmitter, NativeModule, NativeModules, Platform } from 'react-native';
+import {
+  ImageSourcePropType,
+  NativeEventEmitter,
+  NativeModule,
+  NativeModules,
+  Platform,
+} from 'react-native';
+import { Action } from './interfaces/Action';
+import { Maneuver } from './interfaces/Maneuver';
+import { PauseReason } from './interfaces/PauseReason';
+import { TextConfiguration } from './interfaces/TextConfiguration';
+import { TimeRemainingColor } from './interfaces/TimeRemainingColor';
+import { TravelEstimates } from './interfaces/TravelEstimates';
+import { TripConfig } from './navigation/Trip';
 import { ActionSheetTemplate } from './templates/ActionSheetTemplate';
 import { AlertTemplate } from './templates/AlertTemplate';
 import { ContactTemplate } from './templates/ContactTemplate';
 import { GridTemplate } from './templates/GridTemplate';
 import { InformationTemplate } from './templates/InformationTemplate';
 import { ListTemplate } from './templates/ListTemplate';
-import { NavigationTemplate } from './templates/android/NavigationTemplate';
-import { PlaceListMapTemplate } from './templates/android/PlaceListMapTemplate';
-import { PlaceListNavigationTemplate } from './templates/android/PlaceListNavigationTemplate';
-import { RoutePreviewNavigationTemplate } from './templates/android/RoutePreviewNavigationTemplate';
 import { MapTemplate } from './templates/MapTemplate';
+import { NowPlayingTemplate } from './templates/NowPlayingTemplate';
 import { PointOfInterestTemplate } from './templates/PointOfInterestTemplate';
 import { SearchTemplate } from './templates/SearchTemplate';
 import { TabBarTemplate } from './templates/TabBarTemplate';
 import { VoiceControlTemplate } from './templates/VoiceControlTemplate';
-import { NowPlayingTemplate } from './templates/NowPlayingTemplate';
-import { Maneuver } from './interfaces/Maneuver';
-import { TravelEstimates } from './interfaces/TravelEstimates';
-import { PauseReason } from './interfaces/PauseReason';
-import { TripConfig } from './navigation/Trip';
-import { TimeRemainingColor } from './interfaces/TimeRemainingColor';
-import { TextConfiguration } from './interfaces/TextConfiguration';
-import { Action } from './interfaces/Action';
 import { MessageTemplate } from './templates/android/MessageTemplate';
+import { NavigationTemplate } from './templates/android/NavigationTemplate';
 import { PaneTemplate } from './templates/android/PaneTemplate';
+import { PlaceListMapTemplate } from './templates/android/PlaceListMapTemplate';
+import { PlaceListNavigationTemplate } from './templates/android/PlaceListNavigationTemplate';
+import { RoutePreviewNavigationTemplate } from './templates/android/RoutePreviewNavigationTemplate';
 
 export interface InternalCarPlay extends NativeModule {
   checkForConnection(): void;
@@ -74,12 +80,13 @@ export interface InternalCarPlay extends NativeModule {
   dismissPanningInterface(id: string, animated: boolean): void;
   getMaximumListSectionCount(id: string): Promise<number>;
   getMaximumListItemCount(id: string): Promise<number>;
-  getMaximumRowItemsCount(id: string): Promise<number>;
+  getMaximumListItemImageSize(id: string): Promise<ImageSize>;
+  getMaximumNumberOfGridImages(id: string): Promise<number>;
+  getMaximumListImageRowItemImageSize(id: string): Promise<ImageSize>;
   reactToSelectedResult(status: boolean): void;
   updateListTemplateSections(id: string, config: unknown): void;
   updateListTemplateItem(id: string, config: unknown): void;
-  updateListTemplateRowItems(id: string, config: unknown): void;
-  reactToUpdatedSearchText(items: unknown): void;
+  reactToUpdatedSearchText(id: string, items: unknown): void;
   updateTabBarTemplates(id: string, config: unknown): void;
   activateVoiceControlState(id: string, identifier: string): void;
   // Android
@@ -121,6 +128,11 @@ export type WindowInformation = {
   scale: number;
 };
 
+export type ImageSize = {
+  width: number;
+  height: number;
+};
+
 export type OnConnectCallback = (window: WindowInformation) => void;
 export type OnDisconnectCallback = () => void;
 

package/src/interfaces/ListItem.ts

@@ -17,27 +17,33 @@ export interface ListItem {
    * Extra text displayed below the primary text in the list item cell.
    */
   detailText?: string;
+  /**
+   * Image from file system displayed on the leading edge of the list item cell.
+   */
+  placeholderImage?: ImageSourcePropType;
   /**
    * Image from file system displayed on the leading edge of the list item cell.
    */
   image?: ImageSourcePropType;
   /**
-   * The image name displayed on the leading edge of the list item cell.
+   * A list of images shown in the ListRowImageItem
+   * @namespace iOS
    */
-  imageName?: string;
+  placeholderImages?: ImageSourcePropType[];
   /**
-   * Url for image displayed on the leading edge of the list item cell.
+   * A list of images shown in the ListRowImageItem
+   * @namespace iOS
    */
-  imgUrl?: string;
+  images?: ImageSourcePropType[];
   /**
-   * Is Artist flag.
+   * Url for image displayed on the leading edge of the list item cell.
    */
-  isArtist?: boolean
+  imgUrl?: null;
   /**
-   * The sub items arranged in a row.
+   * Url for image displayed on the leading edge of the list item cell.
    * @namespace iOS
    */
-  rowItems?: ListItem[];
+  imgUrls?: string[];
   /**
    * A Boolean value indicating whether the list item cell shows a disclosure indicator on the trailing edge of the list item cell.
    * @namespace iOS

package/src/interfaces/ListSection.ts

@@ -17,5 +17,5 @@ export interface ListSection {
   /**
    * The list of items for the section.
    */
-  items?: ListItem[];
+  items: ListItem[];
 }

package/src/templates/ListTemplate.ts

@@ -1,10 +1,11 @@
+import { Platform } from 'react-native';
 import { CarPlay } from '../CarPlay';
+import { Action } from '../interfaces/Action';
+import { ListItem } from '../interfaces/ListItem';
 import { ListItemUpdate } from '../interfaces/ListItemUpdate';
 import { ListSection } from '../interfaces/ListSection';
 import { Template, TemplateConfig } from './Template';
 
-type CollectionType = '' | 'playlist' | 'artist' | 'groupedArtist' | 'editorial' | 'search' | 'user' | 'allTracks' | 'allRecent' | 'allFavorites'
-
 export interface ListTemplateConfig extends TemplateConfig {
   /**
    * The title displayed in the navigation bar while the list template is visible.
@@ -13,7 +14,12 @@ export interface ListTemplateConfig extends TemplateConfig {
   /**
    * The sections displayed in the list.
    */
-  sections: ListSection[];
+  sections?: ListSection[];
+  /**
+   * Sets a single ItemList to show in the template.
+   * @namespace Android
+   */
+  items?: ListItem[];
   /**
    *  An optional array of strings, ordered from most to least preferred.
    *  The variant strings should be provided as localized, displayable content.
@@ -23,6 +29,7 @@ export interface ListTemplateConfig extends TemplateConfig {
    *  that the template has no list items.
    *  If the list template is updated to contain items, the empty view will be automatically
    *  removed.
+   * @namespace iOS
    */
   emptyViewTitleVariants?: string[];
   /**
@@ -34,6 +41,7 @@ export interface ListTemplateConfig extends TemplateConfig {
    *  that the template has no list items.
    *  If the list template is updated to contain items, the empty view will be automatically
    *  removed.
+   *  @namespace iOS
    */
   emptyViewSubtitleVariants?: string[];
   /**
@@ -42,20 +50,19 @@ export interface ListTemplateConfig extends TemplateConfig {
    * When the returned promise is resolved the spinner will hide.
    * @param item Object with the selected index
    */
-  onItemSelect?(item: { index: number }): Promise<void>;
+  onItemSelect?(item: { templateId: string; index: number }): Promise<void>;
 
   /**
-   * Fired when row item is selected.
+   * Fired when image row item is selected.
    * Spinner shows by default.
    * When the returned promise is resolved the spinner will hide.
    * @param item Object with the selected index
    */
-  onRowItemSelect?(item: { index: number }): Promise<void>;
-
-  /**
-   * Fired when the template is loaded.
-   */
-  onTemplateLoaded?(): Promise<void>;
+  onImageRowItemSelect?(item: {
+    templateId: string;
+    index: number;
+    imageIndex: number;
+  }): Promise<void>;
 
   /**
    * Fired when the back button is pressed
@@ -64,18 +71,14 @@ export interface ListTemplateConfig extends TemplateConfig {
 
   /**
    * Option to hide back button
-   * (defaults to false)
+   * @default false
    */
   backButtonHidden?: boolean;
 
-  /**
-   * Back button title
-   */
-  backButtonTitle: string;
-
   /**
    * Assistant Configuration
    * @see https://developer.apple.com/documentation/carplay/cplisttemplate#3762508
+   * @namespace iOS
    */
   assistant?: {
     enabled: boolean;
@@ -83,16 +86,23 @@ export interface ListTemplateConfig extends TemplateConfig {
     visibility: 'off' | 'always' | 'limited';
     action: 'playMedia' | 'startCall';
   };
-
   /**
-   * Set to true if you are asynchronously updating an existing template
+   * Sets whether the template is in a loading state.
+   * If set to true, the UI will display a loading indicator where the list content would be otherwise. The caller is expected to call invalidate and send the new template content to the host once the data is ready.
+   * If set to false, the UI will display the contents of the ItemList instance(s) added via setSingleList or addSectionedList.
+   * @namespace Android
    */
-  updatingTemplate: boolean;
-
+  loading?: boolean;
+  /**
+   * Sets the Action that will be displayed in the header of the template.
+   * @namespace Android
+   */
+  headerAction?: Action<'appIcon' | 'back'>;
   /**
-   * Set to true if you want to receive the onTemplateLoaded callback
+   * Sets the ActionStrip for this template or null to not display an .
+   * This template allows up to 2 Actions. Of the 2 allowed Actions, one of them can contain a title as set via setTitle. Otherwise, only Actions with icons are allowed.
    */
-  needsTemplateLoadedCallback: boolean;
+  actions?: [Action<'custom'>] | [Action<'custom'>, Action<'custom'>];
 }
 
 /**
@@ -118,41 +128,43 @@ export class ListTemplate extends Template<ListTemplateConfig> {
   constructor(public config: ListTemplateConfig) {
     super(config);
 
-    CarPlay.emitter.addListener('didSelectListItem', e => {
+    CarPlay.emitter.addListener('didSelectListItem', (e: { templateId: string; index: number }) => {
       if (config.onItemSelect && e.templateId === this.id) {
         void Promise.resolve(config.onItemSelect(e)).then(() => {
-          CarPlay.bridge.reactToSelectedResult(true);
+          if (Platform.OS === 'ios') {
+            CarPlay.bridge.reactToSelectedResult(true);
+          }
         });
       }
     });
 
-    CarPlay.emitter.addListener('didSelectRowItem', e => {
-      if (config.onRowItemSelect && e.templateId === this.id) {
-        void Promise.resolve(config.onRowItemSelect(e)).then(() => {
-          CarPlay.bridge.reactToSelectedResult(true);
-        });
-      }
-    });
-
-    CarPlay.emitter.addListener('templateLoaded', e => {
-      if (config.onTemplateLoaded && e.templateId === this.id) {
-        void Promise.resolve(config.onTemplateLoaded())
-      }
-    });
+    CarPlay.emitter.addListener(
+      'didSelectListItemRowImage',
+      (e: { templateId: string; index: number; imageIndex: number }) => {
+        if (config.onImageRowItemSelect && e.templateId === this.id) {
+          void Promise.resolve(config.onImageRowItemSelect(e)).then(() => {
+            if (Platform.OS === 'ios') {
+              CarPlay.bridge.reactToSelectedResult(true);
+            }
+          });
+        }
+      },
+    );
   }
 
   public updateSections = (sections: ListSection[]) => {
+    this.config.sections = sections;
     return CarPlay.bridge.updateListTemplateSections(this.id, this.parseConfig(sections));
   };
 
   public updateListTemplateItem = (config: ListItemUpdate) => {
+    const section = this.config.sections?.[config.sectionIndex];
+    if (section) {
+      section.items[config.itemIndex] = config;
+    }
     return CarPlay.bridge.updateListTemplateItem(this.id, this.parseConfig(config));
   };
 
-  public updateListTemplateRowItems = (config: ListItemUpdate) => {
-    return CarPlay.bridge.updateListTemplateRowItems(this.id, this.parseConfig(config));
-  };
-
   public getMaximumListItemCount() {
     return CarPlay.bridge.getMaximumListItemCount(this.id);
   }
@@ -161,7 +173,15 @@ export class ListTemplate extends Template<ListTemplateConfig> {
     return CarPlay.bridge.getMaximumListSectionCount(this.id);
   }
 
-  public getMaximumRowItemsCount() {
-    return CarPlay.bridge.getMaximumRowItemsCount(this.id);
+  public getMaximumListItemImageSize() {
+    return CarPlay.bridge.getMaximumListItemImageSize(this.id);
+  }
+
+  public getMaximumNumberOfGridImages() {
+    return CarPlay.bridge.getMaximumNumberOfGridImages(this.id);
+  }
+
+  public getMaximumListImageRowItemImageSize() {
+    return CarPlay.bridge.getMaximumListImageRowItemImageSize(this.id);
   }
 }

package/src/templates/NowPlayingTemplate.ts

@@ -1,10 +1,17 @@
+import { ImageSourcePropType } from 'react-native';
 import { Template, TemplateConfig } from './Template';
 
 export type NowPlayingButton = {
   id: string;
-  imageName: string;
-  selected: boolean;
-};
+} & (
+  | {
+      type: 'shuffle' | 'add-to-library' | 'more' | 'playback' | 'repeat';
+    }
+  | {
+      type: 'image';
+      image: ImageSourcePropType;
+    }
+);
 
 export interface NowPlayingTemplateConfig extends TemplateConfig {
   albumArtistButtonEnabled?: boolean;

package/src/templates/SearchTemplate.ts

@@ -1,7 +1,7 @@
+import { Image, Platform } from 'react-native';
 import { CarPlay } from '../CarPlay';
 import { ListItem } from '../interfaces/ListItem';
 import { BaseEvent, Template, TemplateConfig } from './Template';
-import { Image, Platform } from 'react-native';
 
 export interface SearchTemplateConfig extends TemplateConfig {
   /**
@@ -49,7 +49,7 @@ export class SearchTemplate extends Template<SearchTemplateConfig> {
                 ...item,
                 image: item.image ? Image.resolveAssetSource(item.image) : undefined,
               }));
-              CarPlay.bridge.reactToUpdatedSearchText(parsedResults);
+              CarPlay.bridge.reactToUpdatedSearchText(e.templateId, parsedResults);
             }
           });
         }