react-native-cesium 1.0.1

package/scripts/cesium/clean.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * Remove outputs from `yarn run build` (native prebuilts, staging, CMake build trees).
+ * Does not remove vendor/cesium-native source (`yarn update`) or vendor/vcpkg.
+ * For other ignored artifacts (e.g. `lib/`, Android `.cxx/`), run `git clean -dfX` yourself
+ * and exclude paths you need to keep (see `.gitignore`).
+ */
+import { existsSync, rmSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = join(__dirname, '..', '..')
+const cesiumSrc = join(root, 'vendor', 'cesium-native')
+
+const paths = [
+  join(root, 'vendor', 'android'),
+  join(root, 'vendor', 'ios'),
+  join(root, 'vendor', '.cesium-staging'),
+  join(cesiumSrc, 'build-android-arm64'),
+  join(cesiumSrc, 'build-ios-device'),
+  join(cesiumSrc, 'build-ios-simulator'),
+]
+
+let removed = 0
+for (const p of paths) {
+  if (!existsSync(p)) continue
+  rmSync(p, { recursive: true, force: true })
+  console.log(`Removed ${p}`)
+  removed++
+}
+
+if (removed === 0) {
+  console.log('No Cesium native build outputs to remove (already clean).')
+}

package/scripts/cesium/clone.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Clone or update CesiumGS/cesium-native at a pinned tag into vendor/cesium-native (gitignored).
+ */
+import { execFileSync } from 'node:child_process'
+import { existsSync, mkdirSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = join(__dirname, '..', '..')
+const vendor = join(root, 'vendor')
+const dest = join(vendor, 'cesium-native')
+const repo = 'https://github.com/CesiumGS/cesium-native.git'
+const ref = 'v0.59.0'
+
+function run(cmd, args, opts = {}) {
+  execFileSync(cmd, args, { stdio: 'inherit', ...opts })
+}
+
+mkdirSync(vendor, { recursive: true })
+
+if (!existsSync(dest)) {
+  run('git', ['clone', '--branch', ref, '--depth', '1', repo, dest], {
+    cwd: root,
+  })
+  console.log(`Cloned Cesium Native ${ref} into ${dest}`)
+} else {
+  run('git', ['-C', dest, 'fetch', '--depth', '1', 'origin', 'tag', ref])
+  run('git', ['-C', dest, 'checkout', '--detach', '--force', ref])
+  console.log(`Updated Cesium Native at ${dest} to ${ref}`)
+}

package/scripts/cesium/ensure-native.mjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * If Cesium Native vendor output is missing for the requested platform(s), run
+ * `npm|yarn run update` then `CESIUM_BUILD_ONLY=… npm|yarn run build`.
+ *
+ * Invoked from CocoaPods (podspec prepare_command) and Android Gradle (preBuild).
+ *
+ * Opt out (CI without toolchains): REACT_NATIVE_CESIUM_SKIP_NATIVE_BUILD=1 — fails fast if artifacts are still missing.
+ */
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const root = resolve(join(__dirname, '..', '..'))
+
+const MARKER_IOS = join(root, 'vendor', 'ios', 'CesiumNative.xcframework', 'Info.plist')
+const MARKER_ANDROID = join(
+  root,
+  'vendor',
+  'android',
+  'share',
+  'cesium-native',
+  'cmake',
+  'cesium-nativeConfig.cmake'
+)
+
+function parseArgs(argv) {
+  const want = { ios: false, android: false }
+  for (const a of argv) {
+    if (a === '--ios') want.ios = true
+    else if (a === '--android') want.android = true
+  }
+  if (!want.ios && !want.android) {
+    want.ios = true
+    want.android = true
+  }
+  return want
+}
+
+function useYarn() {
+  return existsSync(join(root, 'yarn.lock'))
+}
+
+function runScript(name, extraEnv) {
+  const yarn = useYarn()
+  const cmd = yarn ? 'yarn' : 'npm'
+  const args = yarn ? ['run', name] : ['run', name]
+  const env = { ...process.env, ...extraEnv }
+  const r = spawnSync(cmd, args, { cwd: root, env, stdio: 'inherit' })
+  if (r.error) {
+    console.error(r.error)
+    process.exit(1)
+  }
+  const code = r.status
+  if (code !== 0) {
+    process.exit(code === null ? 1 : code)
+  }
+}
+
+function main() {
+  const skip = process.env.REACT_NATIVE_CESIUM_SKIP_NATIVE_BUILD === '1'
+  const want = parseArgs(process.argv.slice(2))
+
+  const needIos = want.ios && !existsSync(MARKER_IOS)
+  const needAndroid = want.android && !existsSync(MARKER_ANDROID)
+
+  if (!needIos && !needAndroid) {
+    return
+  }
+
+  if (skip) {
+    console.error(
+      'react-native-cesium: Cesium Native vendor output is missing, but REACT_NATIVE_CESIUM_SKIP_NATIVE_BUILD=1.\n' +
+        'Build the native libraries on a machine with the required toolchains, or unset the variable and retry.\n' +
+        `Expected iOS: ${MARKER_IOS}\n` +
+        `Expected Android: ${MARKER_ANDROID}\n` +
+        'See the package README (Build Cesium Native locally).'
+    )
+    process.exit(1)
+  }
+
+  if (needIos && process.platform !== 'darwin') {
+    console.error(
+      'react-native-cesium: iOS Cesium Native output is missing; building it requires macOS with Xcode.\n' +
+        `Expected: ${MARKER_IOS}`
+    )
+    process.exit(1)
+  }
+
+  if (!existsSync(join(root, 'vendor', 'cesium-native'))) {
+    console.log('react-native-cesium: running package update (clone Cesium Native / vcpkg prep)…')
+    runScript('update', {})
+  }
+
+  if (needIos && !existsSync(MARKER_IOS)) {
+    console.log('react-native-cesium: building Cesium Native for iOS (this can take a long time)…')
+    runScript('build', { CESIUM_BUILD_ONLY: 'ios' })
+  }
+  if (needAndroid && !existsSync(MARKER_ANDROID)) {
+    console.log('react-native-cesium: building Cesium Native for Android (this can take a long time)…')
+    runScript('build', { CESIUM_BUILD_ONLY: 'android' })
+  }
+
+  if (needIos && !existsSync(MARKER_IOS)) {
+    console.error(`react-native-cesium: iOS build finished but marker missing: ${MARKER_IOS}`)
+    process.exit(1)
+  }
+  if (needAndroid && !existsSync(MARKER_ANDROID)) {
+    console.error(`react-native-cesium: Android build finished but marker missing: ${MARKER_ANDROID}`)
+    process.exit(1)
+  }
+}
+
+main()

package/scripts/cesium/vcpkg-ports/zstd/fix-emscripten-and-clang-cl.patch

@@ -0,0 +1,31 @@
+diff --git a/build/cmake/CMakeModules/AddZstdCompilationFlags.cmake b/build/cmake/CMakeModules/AddZstdCompilationFlags.cmake
+index 5f381c6..f1e9b32 100644
+--- a/build/cmake/CMakeModules/AddZstdCompilationFlags.cmake
++++ b/build/cmake/CMakeModules/AddZstdCompilationFlags.cmake
+@@ -79,10 +79,22 @@ macro(ADD_ZSTD_COMPILATION_FLAGS)
+         endif ()
+         # Add noexecstack flags
+         # LDFLAGS
+-        EnableCompilerFlag("-Wl,-z,noexecstack" false false true)
+-        # CFLAGS & CXXFLAGS
+-        EnableCompilerFlag("-Qunused-arguments" true true false)
+-        EnableCompilerFlag("-Wa,--noexecstack" true true false)
++        if(MSVC)
++            # UNICODE SUPPORT
++            EnableCompilerFlag("/D_UNICODE" true true false)
++            EnableCompilerFlag("/DUNICODE" true true false)
++            # Enable asserts in Debug mode
++            if (CMAKE_BUILD_TYPE MATCHES "Debug")
++                EnableCompilerFlag("/DDEBUGLEVEL=1" true true false)
++            endif ()
++        else()
++        if(NOT EMSCRIPTEN)
++            EnableCompilerFlag("-z noexecstack" false false true)
++        endif()
++            # CFLAGS & CXXFLAGS
++            EnableCompilerFlag("-Qunused-arguments" true true false)
++            EnableCompilerFlag("-Wa,--noexecstack" true true false)
++        endif()
+         # NOTE: Using 3 nested ifs because the variables are sometimes
+         # empty if the condition is false, and sometimes equal to false.
+         # This implicitly converts them to truthy values. There may be

package/scripts/cesium/vcpkg-ports/zstd/fix-windows-rc-compile.patch

@@ -0,0 +1,13 @@
+diff --git a/build/cmake/lib/CMakeLists.txt b/build/cmake/lib/CMakeLists.txt
+index 5d514ccb..dd79efb7 100644
+--- a/build/cmake/lib/CMakeLists.txt
++++ b/build/cmake/lib/CMakeLists.txt
+@@ -123,7 +123,7 @@ set(PUBLIC_INCLUDE_DIRS ${LIBRARY_DIR})
+ set(library_targets)
+ if (ZSTD_BUILD_SHARED)
+     add_library(libzstd_shared SHARED ${Sources} ${Headers} ${PlatformDependResources})
+-    target_include_directories(libzstd_shared INTERFACE $<BUILD_INTERFACE:${PUBLIC_INCLUDE_DIRS}>)
++    target_include_directories(libzstd_shared PUBLIC $<BUILD_INTERFACE:${PUBLIC_INCLUDE_DIRS}>)
+     list(APPEND library_targets libzstd_shared)
+     if (ZSTD_MULTITHREAD_SUPPORT)
+         set_property(TARGET libzstd_shared APPEND PROPERTY COMPILE_DEFINITIONS "ZSTD_MULTITHREAD")

package/scripts/cesium/vcpkg-ports/zstd/no-static-suffix.patch

@@ -0,0 +1,13 @@
+diff --git a/build/cmake/lib/CMakeLists.txt b/build/cmake/lib/CMakeLists.txt
+index 8234060..765f003 100644
+--- a/build/cmake/lib/CMakeLists.txt
++++ b/build/cmake/lib/CMakeLists.txt
+@@ -118,7 +118,7 @@ endif ()
+ 
+ # With MSVC static library needs to be renamed to avoid conflict with import library
+ if (MSVC OR (WIN32 AND CMAKE_CXX_COMPILER_ID STREQUAL "Clang" AND NOT MINGW))
+-    set(STATIC_LIBRARY_BASE_NAME zstd_static)
++    set(STATIC_LIBRARY_BASE_NAME zstd)
+ else ()
+     set(STATIC_LIBRARY_BASE_NAME zstd)
+ endif ()

package/scripts/cesium/vcpkg-ports/zstd/portfile.cmake

@@ -0,0 +1,77 @@
+# Overlay of microsoft/vcpkg ports/zstd: disable multithreaded zstd on iOS so the installed
+# CMake package does not call find_dependency(Threads). Downstream ports (e.g. ktx) then
+# configure without FindThreads failing on iphoneOS try_compile.
+vcpkg_from_github(
+    OUT_SOURCE_PATH SOURCE_PATH
+    REPO facebook/zstd
+    REF "v${VERSION}"
+    SHA512 26e441267305f6e58080460f96ab98645219a90d290a533410b1b0b1d2f870721c95f8384e342ee647c5e968385a5b7e30c2d04340c37f59b3e6d86762c3260c
+    HEAD_REF dev
+    PATCHES
+        no-static-suffix.patch
+        fix-emscripten-and-clang-cl.patch
+        fix-windows-rc-compile.patch
+)
+
+string(COMPARE EQUAL "${VCPKG_LIBRARY_LINKAGE}" "static" ZSTD_BUILD_STATIC)
+string(COMPARE EQUAL "${VCPKG_LIBRARY_LINKAGE}" "dynamic" ZSTD_BUILD_SHARED)
+
+if("tools" IN_LIST FEATURES)
+   set(ZSTD_BUILD_PROGRAMS 1)
+else()
+   set(ZSTD_BUILD_PROGRAMS 0)
+endif()
+
+if(VCPKG_TARGET_IS_IOS)
+    set(ZSTD_MULTITHREAD_SUPPORT 0)
+else()
+    set(ZSTD_MULTITHREAD_SUPPORT 1)
+endif()
+
+vcpkg_cmake_configure(
+    SOURCE_PATH "${SOURCE_PATH}/build/cmake"
+    OPTIONS
+        -DZSTD_BUILD_SHARED=${ZSTD_BUILD_SHARED}
+        -DZSTD_BUILD_STATIC=${ZSTD_BUILD_STATIC}
+        -DZSTD_LEGACY_SUPPORT=1
+        -DZSTD_BUILD_TESTS=0
+        -DZSTD_BUILD_CONTRIB=0
+        -DZSTD_MULTITHREAD_SUPPORT=${ZSTD_MULTITHREAD_SUPPORT}
+    OPTIONS_RELEASE
+        -DZSTD_BUILD_PROGRAMS=${ZSTD_BUILD_PROGRAMS}
+    OPTIONS_DEBUG
+        -DZSTD_BUILD_PROGRAMS=OFF
+)
+
+vcpkg_cmake_install()
+vcpkg_copy_pdbs()
+vcpkg_cmake_config_fixup(CONFIG_PATH lib/cmake/zstd)
+vcpkg_fixup_pkgconfig()
+
+file(READ "${CURRENT_PACKAGES_DIR}/share/zstd/zstdTargets.cmake" targets)
+if(targets MATCHES "-pthread")
+    vcpkg_replace_string("${CURRENT_PACKAGES_DIR}/lib/pkgconfig/libzstd.pc" " -lzstd" " -lzstd -pthread")
+    if(NOT VCPKG_BUILD_TYPE)
+        vcpkg_replace_string("${CURRENT_PACKAGES_DIR}/debug/lib/pkgconfig/libzstd.pc" " -lzstd" " -lzstd -pthread")
+    endif()
+endif()
+
+file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/include" "${CURRENT_PACKAGES_DIR}/debug/share")
+
+if(VCPKG_TARGET_IS_WINDOWS AND VCPKG_LIBRARY_LINKAGE STREQUAL "dynamic")
+    foreach(HEADER IN ITEMS zdict.h zstd.h zstd_errors.h)
+        vcpkg_replace_string("${CURRENT_PACKAGES_DIR}/include/${HEADER}" "defined(ZSTD_DLL_IMPORT) && (ZSTD_DLL_IMPORT==1)" "1" )
+    endforeach()
+endif()
+
+if(VCPKG_TARGET_IS_WINDOWS AND ZSTD_BUILD_PROGRAMS)
+    vcpkg_copy_tools(TOOL_NAMES zstd AUTO_CLEAN)
+endif()
+
+file(INSTALL "${CMAKE_CURRENT_LIST_DIR}/usage" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}")
+vcpkg_install_copyright(
+    COMMENT "ZSTD is dual licensed under BSD and GPLv2."
+    FILE_LIST
+        "${SOURCE_PATH}/LICENSE"
+        "${SOURCE_PATH}/COPYING"
+)

package/scripts/cesium/vcpkg-ports/zstd/usage

@@ -0,0 +1,4 @@
+zstd provides CMake targets:
+
+  find_package(zstd CONFIG REQUIRED)
+  target_link_libraries(main PRIVATE zstd::libzstd)

package/scripts/cesium/vcpkg-ports/zstd/vcpkg.json

@@ -0,0 +1,23 @@
+{
+  "name": "zstd",
+  "version": "1.5.7",
+  "description": "Zstandard - Fast real-time compression algorithm",
+  "homepage": "https://facebook.github.io/zstd/",
+  "license": "BSD-3-Clause OR GPL-2.0-only",
+  "dependencies": [
+    {
+      "name": "vcpkg-cmake",
+      "host": true
+    },
+    {
+      "name": "vcpkg-cmake-config",
+      "host": true
+    }
+  ],
+  "features": {
+    "tools": {
+      "description": "Build zstd binary",
+      "supports": "!uwp & static"
+    }
+  }
+}

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

@@ -0,0 +1,10 @@
+# Overlay for microsoft/vcpkg triplets/community/arm64-ios-simulator.cmake — curl's CMake can set
+# HAVE_PIPE2 even though iOS has no pipe2(); that fails with -Werror=implicit-function-declaration.
+#
+# CMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY: FindThreads / pthread checks (e.g. via zstd → ktx).
+set(VCPKG_TARGET_ARCHITECTURE arm64)
+set(VCPKG_CRT_LINKAGE dynamic)
+set(VCPKG_LIBRARY_LINKAGE static)
+set(VCPKG_CMAKE_SYSTEM_NAME iOS)
+set(VCPKG_OSX_SYSROOT iphonesimulator)
+set(VCPKG_CMAKE_CONFIGURE_OPTIONS "-DHAVE_PIPE2=OFF;-DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY")

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

@@ -0,0 +1,14 @@
+# Overlay for microsoft/vcpkg triplets/community/arm64-ios.cmake — curl's CMake can set
+# HAVE_PIPE2 even though iOS has no pipe2(); that fails with -Werror=implicit-function-declaration.
+#
+# CMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY: FindThreads (pulled in via zstdConfig → ktx, etc.)
+# fails on iOS when try_compile builds an executable; static libs avoid that toolchain quirk.
+set(VCPKG_TARGET_ARCHITECTURE arm64)
+set(VCPKG_CRT_LINKAGE dynamic)
+set(VCPKG_LIBRARY_LINKAGE static)
+set(VCPKG_CMAKE_SYSTEM_NAME iOS)
+# vcpkg scripts/toolchains/ios.cmake only sets a sysroot for simulator archs; without this,
+# 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)
+set(VCPKG_CMAKE_CONFIGURE_OPTIONS "-DHAVE_PIPE2=OFF;-DCMAKE_TRY_COMPILE_TARGET_TYPE=STATIC_LIBRARY")

package/src/CesiumView.tsx

@@ -0,0 +1,13 @@
+import { getHostComponent } from 'react-native-nitro-modules'
+import type {
+  CesiumViewProps,
+  CesiumViewMethods,
+} from './specs/cesium-view.nitro'
+import CesiumViewConfig from '../nitrogen/generated/shared/json/CesiumViewConfig.json'
+
+/** For `hybridRef`, use `callback(...)` from `react-native-nitro-modules` or a ref object —
+ *  unwrapped functions are turned into booleans by RN and never reach native. */
+export const CesiumView = getHostComponent<CesiumViewProps, CesiumViewMethods>(
+  'CesiumView',
+  () => CesiumViewConfig
+)

package/src/index.ts

@@ -0,0 +1,7 @@
+export { CesiumView } from './CesiumView'
+export type {
+  CameraState,
+  CesiumMetrics,
+  CesiumViewProps,
+  CesiumViewMethods,
+} from './specs/cesium-view.nitro'

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

@@ -0,0 +1,51 @@
+import type {
+  HybridView,
+  HybridViewProps,
+  HybridViewMethods,
+} from 'react-native-nitro-modules'
+
+/** Snapshot of the native camera for persistence / sync with React state. */
+export interface CameraState {
+  latitude: number
+  longitude: number
+  altitude: number
+  heading: number
+  pitch: number
+  roll: number
+  verticalFovDeg: number
+}
+
+/** Throttled telemetry for dashboards (see `onMetrics` prop). */
+export interface CesiumMetrics {
+  fps: number
+  tilesRendered: number
+  tilesLoading: number
+  tilesVisited: number
+  ionTokenConfigured: boolean
+  tilesetReady: boolean
+  creditsPlainText: string
+}
+
+export interface CesiumViewProps extends HybridViewProps {
+  ionAccessToken: string
+  ionAssetId: number
+  /** Construction-time seed camera. Use `setCamera()` for runtime updates. */
+  initialCamera: CameraState
+  pauseRendering: boolean
+  maximumScreenSpaceError: number
+  maximumSimultaneousTileLoads: number
+  loadingDescendantLimit: number
+  /** 1 = off; 2 or 4 = MSAA when supported. */
+  msaaSampleCount: number
+  ionImageryAssetId: number
+  onMetrics?: (metrics: CesiumMetrics) => void
+}
+
+export interface CesiumViewMethods extends HybridViewMethods {
+  /** Returns the current native camera state. */
+  getCameraState(): Promise<CameraState>
+  /** Runtime camera control path after the view has been created. */
+  setCamera(camera: CameraState): void
+}
+
+export type CesiumView = HybridView<CesiumViewProps, CesiumViewMethods>