@iternio/react-native-auto-play 0.5.14-beta.1 → 0.6.0

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

@@ -36,6 +36,14 @@ namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct GlyphImage;
 namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct AssetImage; }
 // Forward declaration of `RemoteImage` to properly resolve imports.
 namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct RemoteImage; }
+// Forward declaration of `ListImageType` to properly resolve imports.
+namespace margelo::nitro::swe::iternio::reactnativeautoplay { enum class ListImageType; }
+// Forward declaration of `WaypointCoordinate` to properly resolve imports.
+namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct WaypointCoordinate; }
+// Forward declaration of `Distance` to properly resolve imports.
+namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct Distance; }
+// Forward declaration of `DurationWithTimeZone` to properly resolve imports.
+namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct DurationWithTimeZone; }
 
 #include "AutoText.hpp"
 #include <optional>
@@ -43,7 +51,12 @@ namespace margelo::nitro::swe::iternio::reactnativeautoplay { struct RemoteImage
 #include "AssetImage.hpp"
 #include "RemoteImage.hpp"
 #include <variant>
+#include "ListImageType.hpp"
 #include <functional>
+#include "WaypointCoordinate.hpp"
+#include "Distance.hpp"
+#include "DurationWithTimeZone.hpp"
+#include <string>
 
 namespace margelo::nitro::swe::iternio::reactnativeautoplay {
 
@@ -57,13 +70,19 @@ namespace margelo::nitro::swe::iternio::reactnativeautoplay {
     std::optional<bool> browsable     SWIFT_PRIVATE;
     bool enabled     SWIFT_PRIVATE;
     std::optional<std::variant<GlyphImage, AssetImage, RemoteImage>> image     SWIFT_PRIVATE;
+    std::optional<ListImageType> imageType     SWIFT_PRIVATE;
     std::optional<bool> checked     SWIFT_PRIVATE;
     std::optional<std::function<void(std::optional<bool> /* checked */)>> onPress     SWIFT_PRIVATE;
     std::optional<bool> selected     SWIFT_PRIVATE;
+    std::optional<WaypointCoordinate> coordinate     SWIFT_PRIVATE;
+    std::optional<Distance> distance     SWIFT_PRIVATE;
+    std::optional<DurationWithTimeZone> duration     SWIFT_PRIVATE;
+    std::optional<bool> travelEstimatesVisible     SWIFT_PRIVATE;
+    std::optional<std::string> address     SWIFT_PRIVATE;
 
   public:
     NitroRow() = default;
-    explicit NitroRow(AutoText title, std::optional<AutoText> detailedText, std::optional<bool> browsable, bool enabled, std::optional<std::variant<GlyphImage, AssetImage, RemoteImage>> image, std::optional<bool> checked, std::optional<std::function<void(std::optional<bool> /* checked */)>> onPress, std::optional<bool> selected): title(title), detailedText(detailedText), browsable(browsable), enabled(enabled), image(image), checked(checked), onPress(onPress), selected(selected) {}
+    explicit NitroRow(AutoText title, std::optional<AutoText> detailedText, std::optional<bool> browsable, bool enabled, std::optional<std::variant<GlyphImage, AssetImage, RemoteImage>> image, std::optional<ListImageType> imageType, std::optional<bool> checked, std::optional<std::function<void(std::optional<bool> /* checked */)>> onPress, std::optional<bool> selected, std::optional<WaypointCoordinate> coordinate, std::optional<Distance> distance, std::optional<DurationWithTimeZone> duration, std::optional<bool> travelEstimatesVisible, std::optional<std::string> address): title(title), detailedText(detailedText), browsable(browsable), enabled(enabled), image(image), imageType(imageType), checked(checked), onPress(onPress), selected(selected), coordinate(coordinate), distance(distance), duration(duration), travelEstimatesVisible(travelEstimatesVisible), address(address) {}
 
   public:
     // NitroRow is not equatable because these properties are not equatable: onPress
@@ -84,9 +103,15 @@ namespace margelo::nitro {
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "browsable"))),
         JSIConverter<bool>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "enabled"))),
         JSIConverter<std::optional<std::variant<margelo::nitro::swe::iternio::reactnativeautoplay::GlyphImage, margelo::nitro::swe::iternio::reactnativeautoplay::AssetImage, margelo::nitro::swe::iternio::reactnativeautoplay::RemoteImage>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "image"))),
+        JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::ListImageType>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "imageType"))),
         JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "checked"))),
         JSIConverter<std::optional<std::function<void(std::optional<bool>)>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "onPress"))),
-        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "selected")))
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "selected"))),
+        JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "coordinate"))),
+        JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::Distance>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "distance"))),
+        JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::DurationWithTimeZone>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration"))),
+        JSIConverter<std::optional<bool>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "travelEstimatesVisible"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "address")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::swe::iternio::reactnativeautoplay::NitroRow& arg) {
@@ -96,9 +121,15 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "browsable"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.browsable));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "enabled"), JSIConverter<bool>::toJSI(runtime, arg.enabled));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "image"), JSIConverter<std::optional<std::variant<margelo::nitro::swe::iternio::reactnativeautoplay::GlyphImage, margelo::nitro::swe::iternio::reactnativeautoplay::AssetImage, margelo::nitro::swe::iternio::reactnativeautoplay::RemoteImage>>>::toJSI(runtime, arg.image));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "imageType"), JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::ListImageType>>::toJSI(runtime, arg.imageType));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "checked"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.checked));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "onPress"), JSIConverter<std::optional<std::function<void(std::optional<bool>)>>>::toJSI(runtime, arg.onPress));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "selected"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.selected));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "coordinate"), JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate>>::toJSI(runtime, arg.coordinate));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "distance"), JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::Distance>>::toJSI(runtime, arg.distance));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "duration"), JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::DurationWithTimeZone>>::toJSI(runtime, arg.duration));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "travelEstimatesVisible"), JSIConverter<std::optional<bool>>::toJSI(runtime, arg.travelEstimatesVisible));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "address"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.address));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -114,9 +145,15 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "browsable")))) return false;
       if (!JSIConverter<bool>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "enabled")))) return false;
       if (!JSIConverter<std::optional<std::variant<margelo::nitro::swe::iternio::reactnativeautoplay::GlyphImage, margelo::nitro::swe::iternio::reactnativeautoplay::AssetImage, margelo::nitro::swe::iternio::reactnativeautoplay::RemoteImage>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "image")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::ListImageType>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "imageType")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "checked")))) return false;
       if (!JSIConverter<std::optional<std::function<void(std::optional<bool>)>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "onPress")))) return false;
       if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "selected")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "coordinate")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::Distance>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "distance")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::swe::iternio::reactnativeautoplay::DurationWithTimeZone>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "duration")))) return false;
+      if (!JSIConverter<std::optional<bool>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "travelEstimatesVisible")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "address")))) return false;
       return true;
     }
   };

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

@@ -0,0 +1,91 @@
+///
+/// WaypointCoordinate.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <optional>
+
+namespace margelo::nitro::swe::iternio::reactnativeautoplay {
+
+  /**
+   * A struct which can be represented as a JavaScript object (WaypointCoordinate).
+   */
+  struct WaypointCoordinate final {
+  public:
+    double latitude     SWIFT_PRIVATE;
+    double longitude     SWIFT_PRIVATE;
+    std::optional<double> altitude     SWIFT_PRIVATE;
+
+  public:
+    WaypointCoordinate() = default;
+    explicit WaypointCoordinate(double latitude, double longitude, std::optional<double> altitude): latitude(latitude), longitude(longitude), altitude(altitude) {}
+
+  public:
+    friend bool operator==(const WaypointCoordinate& lhs, const WaypointCoordinate& rhs) = default;
+  };
+
+} // namespace margelo::nitro::swe::iternio::reactnativeautoplay
+
+namespace margelo::nitro {
+
+  // C++ WaypointCoordinate <> JS WaypointCoordinate (object)
+  template <>
+  struct JSIConverter<margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate> final {
+    static inline margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "latitude"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "longitude"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "altitude")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::swe::iternio::reactnativeautoplay::WaypointCoordinate& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "latitude"), JSIConverter<double>::toJSI(runtime, arg.latitude));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "longitude"), JSIConverter<double>::toJSI(runtime, arg.longitude));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "altitude"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.altitude));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "latitude")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "longitude")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "altitude")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iternio/react-native-auto-play",
-  "version": "0.5.14-beta.1",
+  "version": "0.6.0",
   "description": "Android Auto and Apple CarPlay for react-native",
   "main": "lib/index",
   "module": "lib/index",

package/src/Constants.ts

@@ -0,0 +1,9 @@
+import { Platform } from 'react-native';
+
+const isIos27OrGreater = Platform.OS === 'ios' && Math.floor(Number(Platform.Version)) >= 27;
+
+const Constants: Readonly<{ isIos27OrGreater: boolean }> = {
+  isIos27OrGreater,
+};
+
+export { Constants };

package/src/index.ts

@@ -26,6 +26,7 @@ export enum AutoPlayModules {
   CarPlayDashboard = 'CarPlayDashboard',
 }
 
+export * from './Constants';
 export * from './components/SafeAreaView';
 export * from './hooks/useAndroidAutoTelemetry';
 export * from './hooks/useFocusedEffect';

package/src/specs/MapTemplate.nitro.ts

@@ -15,6 +15,7 @@ import type {
 import type { NitroNavigationAlert } from '../utils/NitroAlert';
 import type { NitroManeuver } from '../utils/NitroManeuver';
 import type { NitroMapButton } from '../utils/NitroMapButton';
+import type { NitroOptionsPanelConfig } from '../utils/NitroOptionsPanel';
 import type { NitroTemplateConfig } from './AutoPlay.nitro';
 
 interface MapTemplateConfig extends NitroTemplateConfig, NitroMapTemplateConfig {}
@@ -47,7 +48,8 @@ export interface MapTemplate extends HybridObject<{ android: 'kotlin'; ios: 'swi
   ): void;
   updateTravelEstimates(templateId: string, steps: Array<TripPoint>): void;
   updateManeuvers(templateId: string, maneuvers: NitroManeuver): void;
-  startNavigation(templateId: string, trip: TripConfig): void;
+  startNavigation(templateId: string, trip: TripConfig): Promise<void>;
   stopNavigation(templateId: string): void;
   setManeuverState(templateId: string, state: ManeuverState): void;
+  updateOptionsPanel(templateId: string, config?: NitroOptionsPanelConfig): Promise<void>;
 }

package/src/templates/GridTemplate.ts

@@ -1,10 +1,11 @@
+import { Platform } from 'react-native';
 import { NitroModules } from 'react-native-nitro-modules';
 import type { GridTemplate as NitroGridTemplate } from '../specs/GridTemplate.nitro';
 import type { AutoText } from '../types/Text';
 import { type NitroAction, NitroActionUtil } from '../utils/NitroAction';
 import { type GridButton, type NitroGridButton, NitroGridUtil } from '../utils/NitroGrid';
 import { NitroMapButton } from '../utils/NitroMapButton';
-import type { BaseMapTemplateConfig } from './MapTemplate';
+import type { BaseMapTemplateConfig, PanelHeaderActions } from './MapTemplate';
 import {
   type HeaderActions,
   type NitroBaseMapTemplateConfig,
@@ -15,10 +16,17 @@ import {
 
 const HybridGridTemplate = NitroModules.createHybridObject<NitroGridTemplate>('GridTemplate');
 
+/**
+ * Controls the size of Android grid items. A selected size requires Android Car API 8.
+ * @namespace Android
+ */
+export type GridImageSize = 'unset' | 'large' | 'medium' | 'small';
+
 export interface NitroGridTemplateConfig extends TemplateConfig {
   headerActions?: Array<NitroAction>;
   title: AutoText;
   buttons: Array<NitroGridButton>;
+  imageSize?: GridImageSize;
   mapConfig?: NitroBaseMapTemplateConfig;
 }
 
@@ -34,10 +42,25 @@ export type GridTemplateConfig = Omit<
   buttons: Array<GridButton<GridTemplate>>;
 
   /**
-   * If mapConfig is defined, it will use a MapWithContentTemplate with the current template. This results in a GridTemplate with a map in background. No actions need to be specified, can be empty object.
+   * Controls the size of all images in the Android grid. Defaults to `unset`, which preserves
+   * the platform's standard grid layout. `large`, `medium`, and `small` require Android Car API
+   * 8. Ignored (with a `__DEV__` warning) when `mapConfig` is also set — `MapWithContentTemplate`
+   * does not support the sized grid content type.
    * @namespace Android
    */
-  mapConfig?: BaseMapTemplateConfig<GridTemplate>;
+  imageSize?: GridImageSize;
+
+  /**
+   * If mapConfig is defined, it will use a MapWithContentTemplate with the current template. This results in a GridTemplate with a map in background. No actions need to be specified, can be empty object.
+   * @namespace Android - uses MapWithContentTemplate
+   * @namespace iOS - renders as a CPMapPanel on the current root map template (iOS 27+);
+   * `headerActions` here is Android-only — on iOS this template's own `headerActions` are
+   * applied to the root map template's nav bar instead, since CarPlay has no separate header
+   * for the map behind a panel.
+   */
+  mapConfig?: Omit<BaseMapTemplateConfig<GridTemplate>, 'headerActions'> & {
+    headerActions?: PanelHeaderActions<GridTemplate>;
+  };
 };
 
 export class GridTemplate extends Template<GridTemplateConfig, HeaderActions<GridTemplate>> {
@@ -48,6 +71,18 @@ export class GridTemplate extends Template<GridTemplateConfig, HeaderActions<Gri
 
     const { headerActions, buttons, mapConfig, ...rest } = config;
 
+    if (
+      __DEV__ &&
+      Platform.OS === 'android' &&
+      mapConfig != null &&
+      rest.imageSize != null &&
+      rest.imageSize !== 'unset'
+    ) {
+      console.warn(
+        'GridTemplate: imageSize is ignored on Android when mapConfig is set — MapWithContentTemplate does not support the sized grid content type'
+      );
+    }
+
     const nitroConfig: NitroGridTemplateConfig & NitroTemplateConfig = {
       ...rest,
       id: this.id,

package/src/templates/InformationTemplate.ts

@@ -7,7 +7,7 @@ import { type NitroAction, NitroActionUtil } from '../utils/NitroAction';
 import { NitroMapButton } from '../utils/NitroMapButton';
 import { type NitroSection, NitroSectionUtil } from '../utils/NitroSection';
 import type { SingleSection, TextRow } from './ListTemplate';
-import type { BaseMapTemplateConfig } from './MapTemplate';
+import type { BaseMapTemplateConfig, PanelActionsIos, PanelHeaderActions } from './MapTemplate';
 import {
   type HeaderActions,
   type NitroBaseMapTemplateConfig,
@@ -16,6 +16,10 @@ import {
   type TemplateConfig,
 } from './Template';
 
+type InformationActionsAndroid<T> =
+  | [CustomActionButtonAndroid<T>]
+  | [CustomActionButtonAndroid<T>, CustomActionButtonAndroid<T>];
+
 const HybridInformationTemplate =
   NitroModules.createHybridObject<NitroInformationTemplate>('InformationTemplate');
 
@@ -33,7 +37,7 @@ export type InformationItems =
   | [TextRow, TextRow, TextRow]
   | [TextRow, TextRow, TextRow, TextRow];
 
-export type InformationTemplateConfig = Omit<
+type InformationTemplateBaseConfig = Omit<
   NitroInformationTemplateConfig,
   'headerActions' | 'section' | 'mapConfig' | 'actions'
 > & {
@@ -47,35 +51,62 @@ export type InformationTemplateConfig = Omit<
    * @namespace iOS this is an InformationTemplate, ⚠️ the row image is NOT supported
    */
   items?: InformationItems;
-
-  /**
-   * If mapConfig is defined, it will use a MapWithContentTemplate with the current template. This results in a PaneTemplate with a map in background. No actions need to be specified, can be empty object.
-   * @namespace Android
-   */
-  mapConfig?: BaseMapTemplateConfig<InformationTemplate>;
-
-  /**
-   * @namespace Android up to 2 buttons of type TextButton, TextAndImageButton or ImageButton
-   * @namespace iOS - up to 3 buttons of type TextButton
-   */
-  actions?: {
-    android?:
-      | [CustomActionButtonAndroid<InformationTemplate>]
-      | [
-          CustomActionButtonAndroid<InformationTemplate>,
-          CustomActionButtonAndroid<InformationTemplate>,
-        ];
-    ios?:
-      | [
-          TextButton<InformationTemplate>,
-          TextButton<InformationTemplate>,
-          TextButton<InformationTemplate>,
-        ]
-      | [TextButton<InformationTemplate>, TextButton<InformationTemplate>]
-      | [TextButton<InformationTemplate>];
-  };
 };
 
+/**
+ * `actions`/`mapConfig` are a discriminated union — `mapConfig` restricts `actions.ios` to at
+ * most one `TextButton` plus one icon-only `ImageButton` (a `CPMapPanel` can't show more), vs. up
+ * to three `TextButton`s otherwise. If your `mapConfig` value comes from a variable/prop rather
+ * than an inline literal, TS can't narrow which branch applies — assign it to a local `const` and
+ * branch with `if (mapConfig) { ... } else { ... }` into two separate constructor calls instead
+ * of passing it straight through to one.
+ */
+export type InformationTemplateConfig = InformationTemplateBaseConfig &
+  (
+    | {
+        mapConfig?: undefined;
+
+        /**
+         * @namespace Android up to 2 buttons of type TextButton, TextAndImageButton or ImageButton
+         * @namespace iOS - up to 3 buttons of type TextButton
+         */
+        actions?: {
+          android?: InformationActionsAndroid<InformationTemplate>;
+          ios?:
+            | [
+                TextButton<InformationTemplate>,
+                TextButton<InformationTemplate>,
+                TextButton<InformationTemplate>,
+              ]
+            | [TextButton<InformationTemplate>, TextButton<InformationTemplate>]
+            | [TextButton<InformationTemplate>];
+        };
+      }
+    | {
+        /**
+         * If mapConfig is defined, it will use a MapWithContentTemplate with the current template. This results in a PaneTemplate with a map in background. No actions need to be specified, can be empty object.
+         * @namespace Android - uses MapWithContentTemplate
+         * @namespace iOS - renders as a CPMapPanel on the current root map template (iOS 27+);
+         * `headerActions` here is Android-only — on iOS this template's own `headerActions` are
+         * applied to the root map template's nav bar instead, since CarPlay has no separate
+         * header for the map behind a panel.
+         */
+        mapConfig: Omit<BaseMapTemplateConfig<InformationTemplate>, 'headerActions'> & {
+          headerActions?: PanelHeaderActions<InformationTemplate>;
+        };
+
+        /**
+         * @namespace Android up to 2 buttons of type TextButton, TextAndImageButton or ImageButton
+         * @namespace iOS - the panel can only show one TextButton plus one optional icon-only
+         * ImageButton, see PanelActionsIos
+         */
+        actions?: {
+          android?: InformationActionsAndroid<InformationTemplate>;
+          ios?: PanelActionsIos<InformationTemplate>;
+        };
+      }
+  );
+
 export class InformationTemplate extends Template<
   InformationTemplateConfig,
   HeaderActions<InformationTemplate>

package/src/templates/ListTemplate.ts

@@ -1,11 +1,10 @@
 import { NitroModules } from 'react-native-nitro-modules';
 import type { ListTemplate as NitroListTemplate } from '../specs/ListTemplate.nitro';
-import type { AutoImage } from '../types/Image';
 import type { AutoText } from '../types/Text';
 import { type NitroAction, NitroActionUtil } from '../utils/NitroAction';
 import { NitroMapButton } from '../utils/NitroMapButton';
-import { type NitroSection, NitroSectionUtil } from '../utils/NitroSection';
-import type { BaseMapTemplateConfig } from './MapTemplate';
+import { type NitroSection, NitroSectionUtil, type Section } from '../utils/NitroSection';
+import type { BaseMapTemplateConfig, PanelHeaderActions } from './MapTemplate';
 import {
   type HeaderActions,
   type NitroBaseMapTemplateConfig,
@@ -16,56 +15,23 @@ import {
 
 const HybridListTemplate = NitroModules.createHybridObject<NitroListTemplate>('ListTemplate');
 
-type BaseRow = {
-  title: AutoText;
-  enabled?: boolean;
-  image?: AutoImage;
-};
-
-export type DefaultRow<T> = BaseRow & {
-  type: 'default';
-  /**
-   * adds a chevron at the end of the row
-   */
-  browsable?: boolean;
-  onPress: (template: T) => void;
-  detailedText?: AutoText;
-};
-
-export type ToggleRow<T> = BaseRow & {
-  type: 'toggle';
-  checked: boolean;
-  onPress: (template: T, checked: boolean) => void;
-};
-
-export type RadioRow<T> = BaseRow & {
-  type: 'radio';
-  onPress: (template: T) => void;
-  selected?: boolean;
-};
-
-export type TextRow = BaseRow & {
-  type: 'text';
-  detailedText?: AutoText;
-};
-
-export type MultiSection<T> =
-  | {
-      type: 'default';
-      title: string;
-      items: Array<DefaultRow<T> | ToggleRow<T> | TextRow>;
-    }
-  | {
-      type: 'radio';
-      title: string;
-      items: Array<RadioRow<T>>;
-    };
-
-export type SingleSection<T> = {
-  [K in MultiSection<T> as K['type']]: Omit<K, 'title' | 'detailedText'>;
-}[MultiSection<T>['type']];
-
-export type Section<T> = Array<MultiSection<T>> | SingleSection<T>;
+/**
+ * Controls the Android image size for a list item.
+ * @namespace Android
+ */
+export type ListImageType = 'large' | 'medium' | 'small' | 'extra_small' | 'icon';
+
+export type {
+  DefaultRow,
+  MultiSection,
+  RadioRow,
+  Section,
+  SingleSection,
+  TextRow,
+  ToggleRow,
+  WaypointCoordinate,
+  WaypointRow,
+} from '../utils/NitroSection';
 
 export interface NitroListTemplateConfig extends TemplateConfig {
   headerActions?: Array<NitroAction>;
@@ -92,9 +58,15 @@ export type ListTemplateConfig = Omit<
   sections?: Section<ListTemplate>;
   /**
    * If mapConfig is defined, it will use a MapWithContentTemplate with the current template. This results in a ListTemplate with a map in background. No actions need to be specified, can be empty object.
-   * @namespace Android
+   * @namespace Android - uses MapWithContentTemplate
+   * @namespace iOS - renders as a CPMapPanel on the current root map template (iOS 27+);
+   * `headerActions` here is Android-only — on iOS this template's own `headerActions` are
+   * applied to the root map template's nav bar instead, since CarPlay has no separate header
+   * for the map behind a panel.
    */
-  mapConfig?: BaseMapTemplateConfig<ListTemplate>;
+  mapConfig?: Omit<BaseMapTemplateConfig<ListTemplate>, 'headerActions'> & {
+    headerActions?: PanelHeaderActions<ListTemplate>;
+  };
 };
 
 export class ListTemplate extends Template<ListTemplateConfig, HeaderActions<ListTemplate>> {

package/src/templates/MapTemplate.ts

@@ -7,7 +7,13 @@ import { SafeAreaInsetsProvider } from '../components/SafeAreaInsetsContext';
 import { WindowInformationWrapper } from '../components/WindowInformationWrapper';
 import { HybridAutoPlay } from '../hybrid/HybridAutoPlay';
 import type { MapTemplate as NitroMapTemplate } from '../specs/MapTemplate.nitro';
-import type { ActionButtonAndroid, MapButton, MapPanButton } from '../types/Button';
+import type {
+  ActionButtonAndroid,
+  ImageButton,
+  MapButton,
+  MapPanButton,
+  TextButton,
+} from '../types/Button';
 import type { AutoManeuver, ManeuverState } from '../types/Maneuver';
 import type { ColorScheme, RootComponentInitialProps } from '../types/RootComponent';
 import type {
@@ -21,6 +27,7 @@ import { type NavigationAlert, NitroAlertUtil } from '../utils/NitroAlert';
 import { type NitroColor, NitroColorUtil, type ThemedColor } from '../utils/NitroColor';
 import { NitroManeuverUtil, type NitroRoutingManeuver } from '../utils/NitroManeuver';
 import { NitroMapButton } from '../utils/NitroMapButton';
+import { NitroOptionsPanelUtil, type OptionsPanelConfig } from '../utils/NitroOptionsPanel';
 import {
   type HeaderActionsIos,
   type NitroBaseMapTemplateConfig,
@@ -31,6 +38,17 @@ import {
 
 const HybridMapTemplate = NitroModules.createHybridObject<NitroMapTemplate>('MapTemplate');
 
+export type {
+  ChargerLocation,
+  ChargerOutlet,
+  ChargingConnector,
+  OptionsPanelChargerSection,
+  OptionsPanelConfig,
+  OptionsPanelGridSection,
+  OptionsPanelListSection,
+  OptionsPanelSection,
+} from '../utils/NitroOptionsPanel';
+
 export type Point = { x: number; y: number };
 export type VisibleTravelEstimate = 'first' | 'last';
 
@@ -118,6 +136,19 @@ export type MapHeaderActions<T> = {
   ios?: HeaderActionsIos<T>;
 };
 
+/**
+ * @namespace iOS - not supported; CarPlay has no separate header for the map behind a panel, so
+ * the panel template's own `headerActions` are applied to the root map template's nav bar instead.
+ */
+export type PanelHeaderActions<T> = Omit<MapHeaderActions<T>, 'ios'>;
+
+/**
+ * @namespace iOS - a CPMapPanel can only show one CPTextButton (with a title) and one
+ * optional icon-only button (any title is dropped natively), so a second action must be an
+ * ImageButton rather than a TextButton, and a third action isn't supported at all.
+ */
+export type PanelActionsIos<T> = [TextButton<T>] | [TextButton<T>, ImageButton<T>];
+
 export type BaseMapTemplateConfig<T> = {
   /**
    * buttons that represent actions on the map template, usually on the bottom right corner
@@ -146,6 +177,13 @@ export type MapTemplateConfig = Omit<
      */
     component: React.ComponentType<RootComponentInitialProps>;
 
+    /**
+     * the panel shown when tapping the ellipsis button next to the travel estimates during active navigation (iOS 27+).
+     * No-op on Android
+     * @namespace iOS
+     */
+    optionsPanel?: OptionsPanelConfig<MapTemplate>;
+
     /**
      * Notification that navigation was stopped. May occur when another source such as the car head unit starts navigating.
      * The navigation session on Android Auto/CarPlay is stopped already when this callback is triggered, make sure to stop other things like TTS too.
@@ -185,6 +223,7 @@ export class MapTemplate extends Template<MapTemplateConfig, MapTemplateConfig['
       onStopNavigation,
       onAutoDriveEnabled,
       defaultGuidanceBackgroundColor,
+      optionsPanel,
       ...baseConfig
     } = config;
 
@@ -220,6 +259,25 @@ export class MapTemplate extends Template<MapTemplateConfig, MapTemplateConfig['
     };
 
     HybridMapTemplate.createMapTemplate(nitroConfig);
+
+    // routed through updateOptionsPanel, not embedded in nitroConfig above — nitrogen can't generate
+    // a spec for a variant type nested that deep inside NitroMapTemplateConfig.
+    this.updateOptionsPanel(optionsPanel);
+  }
+
+  /**
+   * @namespace iOS updates the panel shown when tapping the ellipsis button
+   * next to the travel estimates during navigation (iOS 27+).
+   */
+  public updateOptionsPanel(optionsPanel?: OptionsPanelConfig<MapTemplate>) {
+    if (Platform.OS !== 'ios') {
+      return;
+    }
+
+    return HybridMapTemplate.updateOptionsPanel(
+      this.id,
+      NitroOptionsPanelUtil.convert(this.template, optionsPanel)
+    );
   }
 
   public setMapButtons(mapButtons: MapTemplateConfig['mapButtons']) {
@@ -364,7 +422,7 @@ export class MapTemplate extends Template<MapTemplateConfig, MapTemplateConfig['
    * or use this to start a navigation session without asking the user
    */
   public startNavigation(trip: TripConfig) {
-    HybridMapTemplate.startNavigation(this.id, trip);
+    return HybridMapTemplate.startNavigation(this.id, trip);
   }
 
   public stopNavigation() {