react-native-cesium 1.2.18 → 1.2.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-cesium",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "description": "Experimental Cesium rendering for React Native via Nitro",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -65,7 +65,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "react-native-nitro-modules": "^0.35.9"
+    "react-native-nitro-modules": "^0.37.1"
   },
   "publishConfig": {
     "access": "public",
@@ -73,17 +73,17 @@
   },
   "devDependencies": {
     "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/changelog": "^7.0.0",
+    "@semantic-release/git": "^11.0.1",
     "@types/jest": "^29.5.14",
-    "@types/react": "19.2.17",
-    "conventional-changelog-conventionalcommits": "^9.3.1",
-    "nitrogen": "0.35.9",
-    "react": "19.2.3",
-    "react-native": "0.86.0",
-    "react-native-builder-bob": "^0.43.0",
-    "semantic-release": "^25.0.5",
-    "typescript": "^5.9.3"
+    "@types/react": "^19.3.0",
+    "conventional-changelog-conventionalcommits": "^10.4.1",
+    "nitrogen": "^0.37.1",
+    "react": "^19.3.0",
+    "react-native": "^0.87.1",
+    "react-native-builder-bob": "^0.43.2",
+    "semantic-release": "^25.0.9",
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/scripts/cesium/config.mjs

@@ -5,4 +5,4 @@
  */
 
 /** Git tag of CesiumGS/cesium-native to clone and build. */
-export const CESIUM_NATIVE_REF = 'v0.61.0'
+export const CESIUM_NATIVE_REF = 'v0.65.0'

package/scripts/cesium/vcpkg-triplets/arm64-ios-simulator.cmake

@@ -7,4 +7,7 @@ set(VCPKG_CRT_LINKAGE dynamic)
 set(VCPKG_LIBRARY_LINKAGE static)
 set(VCPKG_CMAKE_SYSTEM_NAME iOS)
 set(VCPKG_OSX_SYSROOT iphonesimulator)
+# Same iOS 15.1 floor as arm64-ios: Xcode 27 libc++ rejects older deployment
+# targets under -Werror (ktx/astc-encoder).
+set(VCPKG_OSX_DEPLOYMENT_TARGET 15.1)
 set(VCPKG_CMAKE_CONFIGURE_OPTIONS "-DHAVE_PIPE2=OFF;-DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY")

package/scripts/cesium/vcpkg-triplets/arm64-ios.cmake

@@ -11,4 +11,8 @@ set(VCPKG_CMAKE_SYSTEM_NAME iOS)
 # CMake defaults CMAKE_OSX_SYSROOT to the host MacOSX SDK and Clang builds with an invalid
 # --target=…-macabi mix (breaks ktx/astc-encoder on newer Xcode).
 set(VCPKG_OSX_SYSROOT iphoneos)
+# Xcode 27 libc++ warns (and ktx/astc-encoder builds with -Werror) when the
+# deployment target is below iOS 15. CMake's iOS default is 12.0. Match the
+# Cesium Native iOS build (CMAKE_OSX_DEPLOYMENT_TARGET=15.1).
+set(VCPKG_OSX_DEPLOYMENT_TARGET 15.1)
 set(VCPKG_CMAKE_CONFIGURE_OPTIONS "-DHAVE_PIPE2=OFF;-DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY")

package/src/specs/cesium-view.nitro.ts

@@ -11,6 +11,11 @@ import type {
 export interface CameraState {
   latitude: number
   longitude: number
+  /**
+   * Metres. Mean sea level unless `altitudeDatum` is `"ellipsoid"`, in which
+   * case this is WGS84 ellipsoidal height. `getActualCamera`,
+   * `getDemandCamera`, and `onActualCamera` report altitude in that same unit.
+   */
   altitude: number
   heading: number
   pitch: number
@@ -59,6 +64,16 @@ export interface CesiumViewProps extends HybridViewProps {
   /** 1 = off; 2 or 4 = MSAA when supported. */
   msaaSampleCount: number
   ionImageryAssetId: number
+  /**
+   * Vertical datum of public altitude numbers, in both directions.
+   * `"msl"` (default) is metres above mean sea level.
+   * `"ellipsoid"` is WGS84 ellipsoidal height (Android `Location.getAltitude`).
+   * Ellipsoidal heights are converted to mean sea level with EGM96 before the
+   * camera integrator, and converted back on read. Switching this prop does
+   * not move the camera: later reads use the new unit, and the next
+   * `setAltitude`, `setPosition`, or `teleport` is interpreted in that unit.
+   */
+  altitudeDatum?: string
 
   // ── Optional perf / quality knobs ────────────────────────────────────────
   // Note: all optional props below use "set once" semantics. Once a value has
@@ -98,12 +113,13 @@ export interface CesiumViewProps extends HybridViewProps {
    */
   taskProcessorThreads?: number
   /**
-   * Minimum clearance above the loaded terrain surface, in metres (added on top of the
-   * terrain MSL height at the camera position). Default 0 (no constraint).
-   * Set to e.g. 2 to prevent the camera from going underground.
-   * The clamp runs only after terrain tiles have been sampled; until then the demand
-   * altitude is used as-is. The demand altitude is not modified — only the rendered
-   * (actual) camera may be raised to meet this minimum.
+   * Clearance above the rendered terrain surface, in metres, added on top of the
+   * terrain height at the camera position. The floor is always on. 0 means the
+   * camera may sit on the surface and may not go below it.
+   * Until a terrain tile has been sampled, the camera is held at or above the
+   * WGS84 ellipsoid. The demand altitude is not modified — only the rendered
+   * (actual) camera is held to this minimum, and it follows the surface down
+   * when the demand is at or below the floor.
    */
   minAltitudeAboveTerrain?: number
 
@@ -156,10 +172,18 @@ export interface CesiumViewMethods extends HybridViewMethods {
    * for GPS or scripted position updates. Latitude is clamped to ±90 by the
    * integrator; longitude is continuous (no wrap normalisation) so the
    * shortest-arc residual maths stays correct across the antimeridian.
+   * When `altitudeDatum` is `"ellipsoid"`, a horizontal move keeps the
+   * demanded ellipsoidal height and recomputes mean sea level at the new
+   * point. Mean-sea-level mode leaves altitude unchanged.
    */
   setPosition(latitude: number, longitude: number): void
 
-  /** New altitude demand (metres above mean sea level). */
+  /**
+   * New altitude demand, in metres. Interpreted as mean sea level unless
+   * `altitudeDatum` is `"ellipsoid"`, in which case it is WGS84 height and
+   * converted to MSL before the integrator. A later read reports the same
+   * sample back in this unit.
+   */
   setAltitude(altitudeMeters: number): void
 
   /** New heading demand (degrees, 0 = north, increasing clockwise). */
@@ -194,14 +218,15 @@ export interface CesiumViewMethods extends HybridViewMethods {
    * Most recent camera that was rendered (post-integration). This is what
    * the user is currently looking at and is what a HUD overlay should
    * mirror. Differs from `getDemandCamera()` while a glide is in progress
-   * or when the terrain-floor clamp has raised the altitude.
+   * or when the terrain-floor clamp has raised the altitude. Altitude is in
+   * the unit selected by `altitudeDatum`.
    */
   getActualCamera(): Promise<CameraState>
 
   /**
    * What the consumer last asked for (per-DoF demand). Useful for
    * diagnostics or for showing the requested camera alongside the rendered
-   * one.
+   * one. Altitude is in the unit selected by `altitudeDatum`.
    */
   getDemandCamera(): Promise<CameraState>