@jacques_gordon/expo-mapbox-navigation 1.0.7 → 2.0.1

package/ExpoMapboxNavigation.podspec

@@ -0,0 +1,39 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExpoMapboxNavigation'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = { :ios => '14.0' }
+  s.swift_version  = '5.7'
+  s.source         = { git: package['repository']['url'], tag: "v#{s.version}" }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # ── iOS: Mapbox Navigation bundled as xcframework ──────────────────────────
+  # The Navigation SDK v3 for iOS does not support CocoaPods natively.
+  # xcframeworks are bundled directly. See README for how to rebuild them.
+  # ────────────────────────────────────────────────────────────────────────────
+  s.vendored_frameworks = 'ios/MapboxNavigationUIKit.xcframework',
+                          'ios/MapboxNavigationCore.xcframework',
+                          'ios/MapboxDirections.xcframework'
+
+  # Mapbox Maps SDK (via CocoaPods — available as of Maps SDK 11.x)
+  s.dependency 'MapboxMaps', '>= 11.11.0'
+
+  s.source_files = 'ios/**/*.{swift,m,mm}'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    # 16 KB page alignment for iOS (Apple Silicon + future-proof)
+    'OTHER_LDFLAGS' => '-Wl,-dead_strip_dylibs',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule'
+  }
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jacques Gordon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,276 +1,170 @@
 # @jacques_gordon/expo-mapbox-navigation
 
-Plugin Expo pour la navigation Mapbox **turn-by-turn**, compatible **Expo SDK 53** avec **Expo Dev Client**.
+[![npm version](https://badge.fury.io/js/@jacques_gordon%2Fexpo-mapbox-navigation.svg)](https://www.npmjs.com/package/@jacques_gordon/expo-mapbox-navigation)
 
-Supporte **iOS** et **Android**, avec waypoints multiples, instructions vocales, reroutage automatique, restrictions de gabarit de véhicule et personnalisation de la carte.
+Expo module for Mapbox Navigation SDK — forked from [`@badatgil/expo-mapbox-navigation`](https://github.com/uju777/expo-mapbox-navigation) with the following fixes and improvements:
 
-> ⚠️ Nécessite **Expo Dev Client** — incompatible avec Expo Go.
-
----
-
-## Fonctionnalités
-
-- ✅ Navigation turn-by-turn complète (iOS & Android)
-- ✅ Waypoints multiples
-- ✅ Instructions vocales
-- ✅ Reroutage automatique
-- ✅ Détection hors-route
-- ✅ Restrictions de gabarit de véhicule (hauteur / largeur)
-- ✅ Map Matching API (trajet explicite selon les coordonnées)
-- ✅ Routes alternatives
-- ✅ Style de carte personnalisable
-- ✅ Couche raster personnalisée
-- ✅ Multilangue
-- ✅ Compatible avec `@rnmapbox/maps`
+| Change | Details |
+|--------|---------|
+| 🐛 **Fix #43** | Android crash: `NoSuchMethodError` for `CameraAnimationsUtils.calculateCameraAnimationHint` — caused by Mapbox Maps/Navigation SDK version mismatch. Fixed by pinning `mapbox-maps-android ≥ 11.11.0` and Navigation SDK `3.7.0`. |
+| 🐛 **Fix #31** | Voice instructions always defaulted to imperial units. New `voiceUnits` prop (`"metric"` \| `"imperial"`) added. |
+| ✅ **NDK 27** | Forced NDK `27.0.12077973` for full 16 KB page size compatibility (Android 15+ requirement). |
+| ✅ **16 KB page size** | `jniLibs.useLegacyPackaging = false` + `ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON` — required for Google Play compliance from 2025 onwards. |
+| ✅ **Expo SDK 53+** | Compatible with Expo SDK ≥ 53 and React Native 0.79+. |
+| ✅ **Maps v11.11.0** | Minimum Mapbox Maps Android SDK enforced to 11.11.0 (config plugin validates this). |
 
 ---
 
 ## Installation
 
-### 1. Installer `@rnmapbox/maps` (dépendance requise)
-
-Suivre les [instructions officielles de @rnmapbox/maps](https://rnmapbox.github.io/docs/install).  
-La version recommandée est `11.11.0`. **Important : définir explicitement `RNMapboxMapsVersion`.**
-
-### 2. Installer le package
-
 ```bash
-npm install @jacques_gordon/expo-mapbox-navigation
+npx expo install @jacques_gordon/expo-mapbox-navigation @rnmapbox/maps
 ```
 
-Et additionnellement le package (parfois optionnelle)
+### Setup @rnmapbox/maps first
 
-```bash
-npm install metro-cache-key 
-```
-
-### 3. Configurer le plugin dans `app.json`
+Follow the [full @rnmapbox/maps installation guide](https://rnmapbox.github.io/docs/install). Set `RNMapboxMapsVersion` to `11.11.0` or higher.
 
 ```json
-{
-  "expo": {
-    "plugins": [
-      [
-        "expo-build-properties",
-        {
-          "ios": {
-            "useFrameworks": "static"
-          }
-        }
-      ],
-      [
-        "@jacques_gordon/expo-mapbox-navigation",
-        {
-          "accessToken": "pk.eyJ1IjoiVk9UUkVfVE9LRU4iLCJhIjoiY...",
-          "mapboxMapsVersion": "11.11.0",
-          "androidColorOverrides": {
-            "mapbox_main_maneuver_background_color": "#1E88E5"
-          }
-        }
-      ]
-    ]
-  }
-}
+"plugins": [
+  [
+    "@rnmapbox/maps",
+    {
+      "RNMapboxMapsImpl": "mapbox",
+      "RNMapboxMapsVersion": "11.11.0",
+      "RNMapboxMapsDownloadToken": "sk.your_secret_token"
+    }
+  ]
+]
 ```
 
-### 4. Configurer les tokens secrets
-
-#### iOS — `~/.netrc`
+### Add this plugin
 
-```
-machine api.mapbox.com
-  login mapbox
-  password sk.eyJ1IjoiVk9UUkVfVE9LRU5fU0VDUkVUIiwiYSI6Ii4uLiJ9...
+```json
+"plugins": [
+  [
+    "@jacques_gordon/expo-mapbox-navigation",
+    {
+      "accessToken": "pk.your_public_token",
+      "mapboxMapsVersion": "11.11.0"
+    }
+  ]
+]
 ```
 
-#### Android — `~/.gradle/gradle.properties`
+> ⚠️ `mapboxMapsVersion` must match the version set in `@rnmapbox/maps`. Minimum: `11.11.0`.
 
-```properties
-MAPBOX_DOWNLOADS_TOKEN=sk.eyJ1IjoiVk9UUkVfVE9LRU5fU0VDUkVUIiwiYSI6Ii4uLiJ9...
-```
-
-### 5. Prebuild + Dev Client
+### iOS: enable static frameworks
 
-```bash
-npx expo prebuild --clean
-npx expo run:ios     # ou run:android
+```json
+"plugins": [
+  ["expo-build-properties", { "ios": { "useFrameworks": "static" } }]
+]
 ```
 
 ---
 
-## Utilisation
-
-### Exemple de base
+## Usage
 
 ```tsx
 import { MapboxNavigationView } from '@jacques_gordon/expo-mapbox-navigation';
 
-export default function NavigationScreen() {
+export default function Navigation() {
   return (
     <MapboxNavigationView
       style={{ flex: 1 }}
       coordinates={[
-        { latitude: 48.8566, longitude: 2.3522 },  // Paris — départ
-        { latitude: 43.2965, longitude: 5.3698 },  // Marseille — destination
+        { latitude: 48.8566, longitude: 2.3522 },  // Paris
+        { latitude: 51.5074, longitude: -0.1278 },  // London
       ]}
-      locale="fr"
-      onFinalDestinationArrival={() => console.log('Arrivé !')}
-      onCancelNavigation={() => navigation.goBack()}
+      voiceUnits="metric"           // Fix for issue #31
+      language="fr"
+      navigationProfile="driving-traffic"
+      onArrival={() => console.log('Arrived!')}
+      onRoutesFailed={({ nativeEvent }) =>
+        console.error('Routes failed:', nativeEvent.message)
+      }
     />
   );
 }
 ```
 
-### Exemple complet (compatible avec la page de navigation)
+---
 
-```tsx
-import { MapboxNavigationView } from '@jacques_gordon/expo-mapbox-navigation';
+## Props
 
-export default function NavigationScreen({ navigation, reservation, currentPosition }) {
-  const coordinates = [
-    currentPosition,                              // départ (position actuelle)
-    { latitude: 45.7640, longitude: 4.8357 },    // Lyon — waypoint intermédiaire
-    reservation.address_to_lat_long,              // destination finale
-  ];
-
-  return (
-    <MapboxNavigationView
-      style={{ flex: 1 }}
-      coordinates={coordinates}
-      locale="fr"
-      vehicleMaxHeight={5.0}
-      vehicleMaxWidth={2.5}
-      showsEndOfRouteFeedback
-      onRouteProgressChanged={async (event) => {
-        const { distanceRemaining, durationRemaining, distanceTraveled, fractionTraveled } =
-          event.nativeEvent;
-
-        // Notifier le client que le chauffeur approche
-        if (distanceRemaining <= 60) {
-          AXIOS_POST('reservations/livetracking/drivernear', { reservation });
-        }
-
-        const eta = new Date(Date.now() + durationRemaining * 1000);
-        dispatch(setNavigationData({ eta, distanceRemaining, durationRemaining }));
-      }}
-      onWaypointArrival={(event) => {
-        console.log('Waypoint atteint !', event.nativeEvent);
-      }}
-      onFinalDestinationArrival={async () => {
-        await playSound(SOUNDS.ROAD_RECALCULATE);
-        showToast({ toast_type: 'validation', title: 'Arrivée', body: 'Destination atteinte !' });
-      }}
-      onCancelNavigation={() => navigation.goBack()}
-      onRouteChanged={() => console.log('Reroutage en cours...')}
-      onUserOffRoute={() => console.log('Hors route !')}
-      onRoutesLoaded={() => console.log('Routes chargées')}
-    />
-  );
-}
-```
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `coordinates` | `Coordinate[]` | required | Route waypoints. Min 2 items. |
+| `waypointIndices` | `number[]` | all points | Which coordinates are waypoints. |
+| `language` | `string` | device locale | BCP-47 locale (e.g. `"fr"`, `"en-US"`). |
+| `voiceUnits` | `"metric" \| "imperial"` | auto | **Fix #31** — Voice/distance units. |
+| `navigationProfile` | `string` | `"driving-traffic"` | Mapbox routing profile. |
+| `excludeTypes` | `string[]` | — | Road types to avoid. |
+| `mapStyle` | `string` | Mapbox Navigation Day | Map style URL. |
+| `mute` | `boolean` | `false` | Silence voice instructions. |
+| `maxHeight` | `number` | — | Max vehicle height (m). |
+| `maxWidth` | `number` | — | Max vehicle width (m). |
+| `useMapMatching` | `boolean` | `false` | Use Map Matching API. |
+| `customRasterTileUrl` | `string` | — | Custom tile URL with `{x}/{y}/{z}`. |
+| `customRasterAboveLayerId` | `string` | — | Layer ID to place custom raster above. |
 
 ---
 
-## Props
+## Events
 
-### Route
-
-| Prop | Type | Requis | Description |
-|------|------|--------|-------------|
-| `coordinates` | `Coordinate[]` | **Oui** | Tableau de `{latitude, longitude}`. Minimum 2 points. |
-| `waypointIndices` | `number[]` | Non | Indices des points considérés comme waypoints. Par défaut: tous. |
-
-### Options de routing
-
-| Prop | Type | Défaut | Description |
-|------|------|--------|-------------|
-| `locale` | `string` | locale appareil | Langue des instructions. Ex: `"fr"`, `"en"`, `"de"` |
-| `routeProfile` | `string` | `"mapbox/driving-traffic"` | Profil de routing. Android: sans `"mapbox/"`. |
-| `routeExcludeList` | `string[]` | `[]` | Routes à exclure: `"toll"`, `"ferry"`, `"motorway"` |
-| `useRouteMatchingApi` | `boolean` | `false` | Utilise l'API Map Matching au lieu de l'API Directions |
-| `disableAlternativeRoutes` | `boolean` | `false` | Désactive les routes alternatives |
-| `mute` | `boolean` | `false` | Coupe le son de navigation au démarrage |
-| `vehicleMaxHeight` | `number` | — | Hauteur max du véhicule en mètres |
-| `vehicleMaxWidth` | `number` | — | Largeur max du véhicule en mètres |
-
-### Personnalisation visuelle
-
-| Prop | Type | Défaut | Description |
-|------|------|--------|-------------|
-| `mapStyle` | `string` | style par défaut | URL du style Mapbox |
-| `customRasterSourceUrl` | `string` | — | URL template raster personnalisée (ex: OpenStreetMap) |
-| `placeCustomRasterLayerAbove` | `string` | — | ID du layer au-dessus duquel placer la couche raster |
-| `showsEndOfRouteFeedback` | `boolean` | `false` | Affiche l'UI de feedback à l'arrivée |
-
-### Callbacks
-
-| Prop | Paramètres | Description |
-|------|-----------|-------------|
-| `onRouteProgressChanged` | `{ nativeEvent: RouteProgress }` | Progression sur la route (appelé fréquemment) |
-| `onWaypointArrival` | `{ nativeEvent: RouteProgress }` (Android only) | Arrivée à un waypoint intermédiaire |
-| `onFinalDestinationArrival` | — | Arrivée à la destination finale |
-| `onCancelNavigation` | — | Annulation de la navigation par l'utilisateur |
-| `onRouteChanged` | — | Route modifiée ou reroutage |
-| `onUserOffRoute` | — | L'utilisateur est sorti de la route |
-| `onRoutesLoaded` | — | Routes chargées et prêtes |
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `onRoutesReady` | `{ routeCount, distanceMeters, durationSeconds }` | Routes calculated. |
+| `onRouteProgressChanged` | `{ distanceRemaining, durationRemaining, ... }` | Progress update. |
+| `onArrival` | `{}` | User reached destination. |
+| `onNavigationCancelled` | `{}` | User cancelled navigation. |
+| `onNavigationFinished` | `{}` | Session ended normally. |
+| `onRoutesFailed` | `{ message }` | Route calculation failed. |
 
 ---
 
-## Types TypeScript
+## Android Color Overrides
 
-```ts
-interface Coordinate {
-  latitude: number;
-  longitude: number;
-}
+Customize the Navigation UI colors by overriding Mapbox resource values:
 
-interface RouteProgress {
-  distanceRemaining: number;   // mètres restants
-  distanceTraveled: number;    // mètres parcourus
-  durationRemaining: number;   // secondes restantes
-  fractionTraveled: number;    // 0.0 → 1.0
-}
+```json
+["@jacques_gordon/expo-mapbox-navigation", {
+  "accessToken": "pk.your_token",
+  "mapboxMapsVersion": "11.11.0",
+  "androidColorOverrides": {
+    "mapbox_main_maneuver_background_color": "#FF5500",
+    "mapbox_primary_route_color": "#0055FF"
+  }
+}]
 ```
 
 ---
 
-## Plugin `app.json` — Options complètes
+## 16 KB Page Size Compatibility
 
-```json
-[
-  "@jacques_gordon/expo-mapbox-navigation",
-  {
-    "accessToken": "pk.eyJ1...",
-    "mapboxMapsVersion": "11.11.0",
-    "androidColorOverrides": {
-      "mapbox_main_maneuver_background_color": "#1E88E5",
-      "mapbox_sub_maneuver_background_color": "#1565C0",
-      "mapbox_banner_background_color": "#FFFFFF"
-    }
-  }
-]
-```
+Android 15 (API 35) requires all `.so` native libraries to be aligned to 16 KB boundaries for devices using 16 KB memory page sizes.
 
-## Notes importantes
+This package enforces:
+- **NDK 27** (`27.0.12077973`) — the first NDK version with full 16 KB support
+- **`jniLibs.useLegacyPackaging = false`** — prevents `.so` compression, enabling proper alignment
+- **64-bit-only ABI filters** (`arm64-v8a`, `x86_64`) — 16 KB requirement applies to 64-bit only
 
-- Nécessite **Expo Dev Client** (Expo Go non supporté)
-- iOS minimum : **14.0**
-- Android minimum SDK : **24**
-- Le SDK Mapbox Navigation est propriétaire — facturation via votre compte Mapbox
-- Pour iOS, les `.xcframework` du SDK Mapbox Navigation doivent être compilés et inclus dans `ios/Frameworks/`
-  (voir [instructions dans le README du repo source](https://github.com/uju777/expo-mapbox-navigation))
+More info: [Android 16 KB page size guide](https://developer.android.com/guide/practices/page-sizes)
 
 ---
 
-## Obtenir vos tokens Mapbox
+## Changelog
 
-1. Créer un compte sur [mapbox.com](https://www.mapbox.com/)
-2. Aller dans [Account > Tokens](https://account.mapbox.com/access-tokens/)
-3. **Token public** (`pk.eyJ1...`) — token par défaut ou nouveau token
-4. **Token secret** (`sk.eyJ1...`) — nouveau token avec le scope `Downloads:Read`
+### 2.0.1
+- Fix #43: `CameraAnimationsUtils.calculateCameraAnimationHint` NoSuchMethodError on Android
+- Fix #31: Add `voiceUnits` prop for metric/imperial voice instructions
+- Force NDK 27 for 16 KB page size support
+- Enforce Mapbox Maps Android ≥ 11.11.0
+- Expo SDK 53 compatibility
 
 ---
 
-## Licence
+## License
 
 MIT

package/android/build.gradle

@@ -2,53 +2,115 @@ apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 apply plugin: 'maven-publish'
 
-buildscript {
-  def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
-  if (expoModulesCorePlugin.exists()) {
-    apply from: expoModulesCorePlugin
-    applyKotlinExpoModulesCorePlugin()
-  }
-}
+// ─────────────────────────────────────────────────────────────────────────────
+// Mapbox Navigation SDK version used by this module.
+// Must be aligned with the Mapbox Maps SDK version used in @rnmapbox/maps.
+// Minimum required: 3.x compatible with mapbox-maps-android 11.11.0
+// ─────────────────────────────────────────────────────────────────────────────
+def MAPBOX_NAVIGATION_VERSION = "3.7.0"
+
+// Forces minimum Mapbox Maps Android version to 11.11.0 to ensure
+// CameraAnimationsUtils.calculateCameraAnimationHint(...) is available (fixes #43)
+def MAPBOX_MAPS_MIN_VERSION = "11.11.0"
+
+// ─────────────────────────────────────────────────────────────────────────────
+// NDK 27 — required for 16 KB page size compatibility (Android 15+)
+// See: https://developer.android.com/guide/practices/page-sizes
+// NDK 27 added full support for 16 KB page alignment via -DALIGN_16KB flag
+// ─────────────────────────────────────────────────────────────────────────────
+def REQUIRED_NDK_VERSION = "27.0.12077973"
 
 android {
-  compileSdkVersion 34
-  namespace "expo.modules.mapboxnavigation"
-
-  defaultConfig {
-    minSdkVersion 24
-    targetSdkVersion 34
-  }
-
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_17
-    targetCompatibility JavaVersion.VERSION_17
-  }
-
-  kotlinOptions {
-    jvmTarget = "17"
-  }
+    compileSdkVersion safeExtGet("compileSdkVersion", 35)
+    namespace "expo.modules.mapboxnavigation"
+
+    // Force NDK 27 for 16 KB page size compatibility
+    ndkVersion REQUIRED_NDK_VERSION
+
+    defaultConfig {
+        minSdkVersion safeExtGet("minSdkVersion", 24)
+        targetSdkVersion safeExtGet("targetSdkVersion", 35)
+
+        // ─────────────────────────────────────────────────────────────────
+        // 16 KB PAGE SIZE SUPPORT (Android 15 / API 35+)
+        // Required for Google Play compliance starting Feb 2025 (64-bit apps)
+        // This ensures native .so libraries are aligned to 16 KB boundaries.
+        // ─────────────────────────────────────────────────────────────────
+        externalNativeBuild {
+            cmake {
+                arguments "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+            }
+        }
+
+        ndk {
+            // Only build for 64-bit ABIs — 16 KB page size requirement is 64-bit only
+            abiFilters "arm64-v8a", "x86_64"
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_17.majorVersion
+    }
+
+    packagingOptions {
+        // Ensure .so files are NOT compressed — required for 16 KB page size support
+        // Compressed .so files cannot be aligned in the APK
+        jniLibs {
+            useLegacyPackaging = false
+        }
+    }
+
+    buildFeatures {
+        buildConfig true
+    }
 }
 
 repositories {
-  maven {
-    url 'https://api.mapbox.com/downloads/v2/releases/maven'
-    authentication {
-      basic(BasicAuthentication)
-    }
-    credentials {
-      username = "mapbox"
-      password = project.properties['MAPBOX_DOWNLOADS_TOKEN'] ?: System.getenv("MAPBOX_DOWNLOADS_TOKEN") ?: ""
+    mavenCentral()
+    google()
+
+    // Mapbox Maven repository — requires a secret token (sk.*)
+    maven {
+        url 'https://api.mapbox.com/downloads/v2/releases/maven'
+        authentication {
+            basic(BasicAuthentication)
+        }
+        credentials {
+            username = 'mapbox'
+            password = project.hasProperty('MAPBOX_DOWNLOADS_TOKEN')
+                    ? project.property('MAPBOX_DOWNLOADS_TOKEN')
+                    : System.getenv('MAPBOX_DOWNLOADS_TOKEN') ?: ""
+        }
     }
-  }
-  google()
-  mavenCentral()
 }
 
 dependencies {
-  implementation project(':expo-modules-core')
-  implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:${kotlinVersion()}"
+    implementation project(':expo-modules-core')
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:${safeExtGet('kotlinVersion', '1.9.0')}"
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Mapbox Navigation SDK for Android
+    // Version pinned to 3.7.0 which ships with mapbox-maps-android 11.11.0+
+    // This resolves the NoSuchMethodError for calculateCameraAnimationHint (issue #43)
+    // ─────────────────────────────────────────────────────────────────────────
+    implementation "com.mapbox.navigation:android:${MAPBOX_NAVIGATION_VERSION}"
+
+    // Explicitly pin Mapbox Maps SDK to ≥ 11.11.0 to guarantee method compatibility
+    // Prevents gradle from resolving an older transitive version (issue #43 root cause)
+    implementation("com.mapbox.maps:android:${MAPBOX_MAPS_MIN_VERSION}") {
+        transitive = true
+    }
+
+    // Lifecycle support
+    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0'
+    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.7.0'
+}
 
-  // Mapbox Navigation SDK v3 + Drop-in UI
-  api "com.mapbox.navigation:android:3.3.0"
-  api "com.mapbox.navigation:ui-dropin:3.3.0"
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
 }