expo-arcgis 0.1.2 → 0.1.3

package/android/src/main/java/expo/modules/arcgis/DynamicEntityLayerRef.kt

@@ -39,6 +39,18 @@ class DynamicEntityLayerRef(appContext: AppContext, props: Map<String, Any?>) :
         emit("onConnectionStatusChange", mapOf("status" to connectionStatusString(status)))
       }
     }
+    // Emit entity-received events (new/updated observation arrived for an entity).
+    scope.launch {
+      dataSource.dynamicEntityReceivedEvent.collect { info ->
+        emit("onDynamicEntityChange", dynamicEntityPayload("received", info.dynamicEntity))
+      }
+    }
+    // Emit entity-purged events (entity evicted by purge rules).
+    scope.launch {
+      dataSource.dynamicEntityPurgedEvent.collect { info ->
+        emit("onDynamicEntityChange", dynamicEntityPayload("purged", info.dynamicEntity))
+      }
+    }
   }
 
   /** Pushes an observation into a custom data source (no-op for a stream service). */
@@ -97,6 +109,24 @@ fun connectionStatusString(status: ConnectionStatus): String = when (status) {
   is ConnectionStatus.Failed -> "failed"
 }
 
+/**
+ * Builds a compact payload for the `onDynamicEntityChange` event.
+ * Only `received` and `purged` change types are emitted (observation-only updates are
+ * captured within `dynamicEntityReceivedEvent` which fires per-entity arrival, not per
+ * observation, so the event rate is bounded to entity lifecycle changes).
+ * Geometry is serialized only when present; attributes are passed as-is (the map returned
+ * by the SDK is a shallow snapshot of the current entity attributes).
+ */
+private fun dynamicEntityPayload(changeType: String, entity: com.arcgismaps.realtime.DynamicEntity): Map<String, Any?> {
+  val payload = mutableMapOf<String, Any?>(
+    "changeType" to changeType,
+    "entityId" to entity.id,
+    "attributes" to entity.attributes.toMap(),
+  )
+  entity.geometry?.let { payload["geometry"] = dictFromGeometry(it) }
+  return payload
+}
+
 /** Builds the real-time data source: a custom feed (push from JS) or a stream service. */
 private fun buildDataSource(
   props: Map<String, Any?>,

package/android/src/main/java/expo/modules/arcgis/ExpoArcgisExtrasModule.kt

@@ -1,5 +1,7 @@
 package expo.modules.arcgis
 
+import com.arcgismaps.ArcGISEnvironment
+import com.arcgismaps.httpcore.authentication.TokenCredential
 import expo.modules.kotlin.functions.Coroutine
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
@@ -71,6 +73,19 @@ class ExpoArcgisExtrasModule : Module() {
       }
     }
 
+    // Per-service token credential — mint a token for a specific URL and add it to the store.
+    AsyncFunction("setServiceCredential") Coroutine { serviceUrl: String, username: String, password: String, tokenExpirationMinutes: Int? ->
+      val credential = TokenCredential.create(serviceUrl, username, password, tokenExpirationMinutes)
+        .getOrThrow()
+      ArcGISEnvironment.authenticationManager.arcGISCredentialStore.add(credential, serviceUrl)
+        .getOrThrow()
+    }
+
+    // Tile-cache size estimation — quick estimate before committing to a download.
+    AsyncFunction("estimateTileCacheSize") Coroutine { tileServiceUrl: String, areaOfInterest: Map<String, Any?>, options: Map<String, Any?>? ->
+      estimateTileCacheSize(tileServiceUrl, areaOfInterest, options)
+    }
+
     // Turn-by-turn navigation — solve a route and track device locations against it.
     AsyncFunction("createRouteTracker") Coroutine { stops: List<Map<String, Any?>>, params: Map<String, Any?> ->
       createRouteTracker(appContext, stops, params)

package/android/src/main/java/expo/modules/arcgis/ExpoArcgisGeometryModule.kt

@@ -59,6 +59,8 @@ class ExpoArcgisGeometryModule : Module() {
     Function("geMove", ::geMove)
     Function("geRotate", ::geRotate)
     Function("geScale", ::geScale)
+    Function("geEllipseGeodesic", ::geEllipseGeodesic)
+    Function("geSectorGeodesic", ::geSectorGeodesic)
 
     // CoordinateFormatter — point <-> notation strings, exposed as the JS `coordinateFormatter` namespace.
     Function("cfToLatLong", ::cfToLatLong)

package/android/src/main/java/expo/modules/arcgis/ExpoArcgisModule.kt

@@ -234,12 +234,13 @@ class ExpoArcgisModule : Module() {
       Function("applyProps") { ref: OgcFeatureLayerRef, changed: Map<String, Any?> -> ref.applyProps(changed) }
     }
 
-    // Real-time DynamicEntityLayer (stream service) — emits onConnectionStatusChange.
+    // Real-time DynamicEntityLayer (stream service) — emits onConnectionStatusChange +
+    // onDynamicEntityChange (received/purged entity events).
     Class(DynamicEntityLayerRef::class) {
       Constructor { props: Map<String, Any?> ->
         DynamicEntityLayerRef(appContext, props).also { it.applyProps(props) }
       }
-      Events("onConnectionStatusChange")
+      Events("onConnectionStatusChange", "onDynamicEntityChange")
       Function("applyProps") { ref: DynamicEntityLayerRef, changed: Map<String, Any?> ->
         ref.applyProps(changed)
       }
@@ -405,6 +406,10 @@ class ExpoArcgisModule : Module() {
         view.setCamera(camera)
       }
 
+      Prop("cameraController") { view: ExpoArcgisSceneView, value: Map<String, Any?>? ->
+        view.setCameraController(value)
+      }
+
       Prop("sunLighting") { view: ExpoArcgisSceneView, value: String? ->
         view.setSunLighting(value)
       }

package/android/src/main/java/expo/modules/arcgis/ExpoArcgisSceneView.kt

@@ -9,7 +9,9 @@ import com.arcgismaps.geometry.Point
 import com.arcgismaps.geometry.SpatialReference
 import com.arcgismaps.mapping.view.AtmosphereEffect
 import com.arcgismaps.mapping.view.Camera
+import com.arcgismaps.mapping.view.GlobeCameraController
 import com.arcgismaps.mapping.view.LightingMode
+import com.arcgismaps.mapping.view.OrbitLocationCameraController
 import com.arcgismaps.mapping.view.SceneView
 import com.arcgismaps.mapping.view.ScreenCoordinate
 import expo.modules.kotlin.AppContext
@@ -147,6 +149,24 @@ class ExpoArcgisSceneView(context: Context, appContext: AppContext) : ExpoView(c
     scope.launch { sceneView.setViewpointCameraAnimated(camera, 0.5f) }
   }
 
+  /** Sets or clears the scene's camera controller (orbit/globe). `null` restores the SDK default. */
+  fun setCameraController(c: Map<String, Any?>?) {
+    sceneView.cameraController = when (c?.get("type") as? String) {
+      "orbitLocation" -> {
+        val target = c["target"] as? Map<*, *>
+        val x = (target?.get("x") as? Number)?.toDouble() ?: 0.0
+        val y = (target?.get("y") as? Number)?.toDouble() ?: 0.0
+        val z = (target?.get("z") as? Number)?.toDouble()
+        val point = if (z != null) Point(x, y, z, SpatialReference.wgs84())
+                    else Point(x, y, SpatialReference.wgs84())
+        val distance = (c["distance"] as? Number)?.toDouble() ?: 1500.0
+        OrbitLocationCameraController(point, distance)
+      }
+      "globe" -> GlobeCameraController()
+      else -> GlobeCameraController() // null/absent → restore SDK default (GlobeCameraController)
+    }
+  }
+
   /** Sun lighting mode (shadows). */
   fun setSunLighting(s: String?) {
     sceneView.sunLighting = when (s) {

package/android/src/main/java/expo/modules/arcgis/GeometryEngineFunctions.kt

@@ -1,6 +1,8 @@
 package expo.modules.arcgis
 
 import com.arcgismaps.geometry.Envelope
+import com.arcgismaps.geometry.GeodesicEllipseParameters
+import com.arcgismaps.geometry.GeodesicSectorParameters
 import com.arcgismaps.geometry.Geometry
 import com.arcgismaps.geometry.GeometryEngine
 import com.arcgismaps.geometry.Multipart
@@ -256,3 +258,69 @@ internal fun geScale(
     else GeometryEngine.scale(geometry, factorX, factorY),
   )
 }
+
+// region Geodesic construction
+
+internal fun geEllipseGeodesic(params: Map<String, Any?>): Map<String, Any?>? {
+  val centerDict = params["center"] as? Map<String, Any?> ?: return null
+  val center = parsePoint(centerDict) ?: return null
+
+  val semiAxis1Length = (params["semiAxis1Length"] as? Number)?.toDouble() ?: 0.0
+  val semiAxis2Length = (params["semiAxis2Length"] as? Number)?.toDouble() ?: 0.0
+  val axisDirection   = (params["axisDirection"] as? Number)?.toDouble() ?: 0.0
+  val angUnit         = angularUnit(params["angularUnit"] as? String)
+  val linUnit         = linearUnit(params["linearUnit"] as? String)
+  val maxSegLen       = (params["maxSegmentLength"] as? Number)?.toDouble() ?: 0.0
+  val maxPtCount      = (params["maxPointCount"] as? Number)?.toLong() ?: 10L
+  val geoType         = params["geometryType"] as? String
+
+  val p: GeodesicEllipseParameters = when (geoType) {
+    "polyline"   -> GeodesicEllipseParameters.Companion.createForPolyline()
+    "multipoint" -> GeodesicEllipseParameters.Companion.createForMultipoint()
+    else         -> GeodesicEllipseParameters.Companion.createForPolygon()
+  }
+  p.center = center
+  p.semiAxis1Length = semiAxis1Length
+  p.semiAxis2Length = semiAxis2Length
+  p.axisDirection = axisDirection
+  p.angularUnit = angUnit
+  p.linearUnit = linUnit
+  p.maxSegmentLength = maxSegLen
+  p.maxPointCount = maxPtCount
+
+  return encode(GeometryEngine.ellipseGeodesicOrNull(p))
+}
+
+internal fun geSectorGeodesic(params: Map<String, Any?>): Map<String, Any?>? {
+  val centerDict = params["center"] as? Map<String, Any?> ?: return null
+  val center = parsePoint(centerDict) ?: return null
+
+  val semiAxis1Length = (params["semiAxis1Length"] as? Number)?.toDouble() ?: 0.0
+  val semiAxis2Length = (params["semiAxis2Length"] as? Number)?.toDouble() ?: 0.0
+  val axisDirection   = (params["axisDirection"] as? Number)?.toDouble() ?: 0.0
+  val sectorAngle     = (params["sectorAngle"] as? Number)?.toDouble() ?: 0.0
+  val startDirection  = (params["startDirection"] as? Number)?.toDouble() ?: 0.0
+  val angUnit         = angularUnit(params["angularUnit"] as? String)
+  val linUnit         = linearUnit(params["linearUnit"] as? String)
+  val maxSegLen       = (params["maxSegmentLength"] as? Number)?.toDouble() ?: 0.0
+  val maxPtCount      = (params["maxPointCount"] as? Number)?.toLong() ?: 10L
+  val geoType         = params["geometryType"] as? String
+
+  val p: GeodesicSectorParameters = when (geoType) {
+    "polyline"   -> GeodesicSectorParameters.Companion.createForPolyline()
+    "multipoint" -> GeodesicSectorParameters.Companion.createForMultipoint()
+    else         -> GeodesicSectorParameters.Companion.createForPolygon()
+  }
+  p.center = center
+  p.semiAxis1Length = semiAxis1Length
+  p.semiAxis2Length = semiAxis2Length
+  p.axisDirection = axisDirection
+  p.sectorAngle = sectorAngle
+  p.startDirection = startDirection
+  p.angularUnit = angUnit
+  p.linearUnit = linUnit
+  p.maxSegmentLength = maxSegLen
+  p.maxPointCount = maxPtCount
+
+  return encode(GeometryEngine.sectorGeodesicOrNull(p))
+}

package/android/src/main/java/expo/modules/arcgis/GeoprocessingFunctions.kt

@@ -4,12 +4,15 @@ import com.arcgismaps.data.FeatureCollectionTable
 import com.arcgismaps.mapping.view.Graphic
 import com.arcgismaps.tasks.geoprocessing.GeoprocessingTask
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingBoolean
+import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingDataFile
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingDate
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingDouble
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingFeatures
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingLinearUnit
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingLong
+import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingMultiValue
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingParameter
+import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingParameterType
 import com.arcgismaps.tasks.geoprocessing.geoprocessingparameters.GeoprocessingString
 import expo.modules.kotlin.AppContext
 import java.time.Instant
@@ -60,6 +63,28 @@ private fun buildGeoprocessingParameter(d: Map<*, *>): GeoprocessingParameter? =
       ?.map { Graphic().apply { geometry = it } } ?: emptyList()
     GeoprocessingFeatures(FeatureCollectionTable(graphics, emptyList()))
   }
+  "multiValue" -> {
+    // JS numbers → GeoprocessingDouble, JS strings → GeoprocessingString.
+    val rawValues = d["values"] as? List<*> ?: emptyList<Any>()
+    val elements: List<GeoprocessingParameter> = rawValues.mapNotNull { v ->
+      when (v) {
+        is Number -> GeoprocessingDouble(v.toDouble())
+        is String -> GeoprocessingString(v)
+        else -> null
+      }
+    }
+    // Use the element type of the first item to determine the multiValue's parameterType;
+    // fall back to GeoprocessingParameterType.GeoprocessingString when the list is empty.
+    val paramType = if (elements.firstOrNull() is GeoprocessingDouble)
+      GeoprocessingParameterType.GeoprocessingDouble
+    else
+      GeoprocessingParameterType.GeoprocessingString
+    GeoprocessingMultiValue(paramType, elements)
+  }
+  "dataFile" -> {
+    val url = d["url"] as? String ?: return null
+    GeoprocessingDataFile.Companion.createWithUrl(url)
+  }
   else -> null
 }
 

package/android/src/main/java/expo/modules/arcgis/GraphicsOverlayRef.kt

@@ -8,6 +8,7 @@ import com.arcgismaps.mapping.reduction.ClusteringFeatureReduction
 import com.arcgismaps.mapping.reduction.FeatureReduction
 import com.arcgismaps.mapping.symbology.ClassBreak
 import com.arcgismaps.mapping.symbology.ClassBreaksRenderer
+import com.arcgismaps.mapping.symbology.CompositeSymbol
 import com.arcgismaps.mapping.symbology.HorizontalAlignment
 import com.arcgismaps.mapping.symbology.Renderer
 import com.arcgismaps.mapping.symbology.SceneSymbolAnchorPosition
@@ -213,6 +214,12 @@ private fun buildSymbol(s: Map<*, *>): Symbol? = when (s["type"]) {
     }
     composite
   }
+  "composite" -> {
+    val symbolList = (s["symbols"] as? List<*> ?: emptyList<Any>()).mapNotNull { item ->
+      (item as? Map<*, *>)?.let(::buildSymbol)
+    }
+    CompositeSymbol(symbolList)
+  }
   else -> null
 }
 

package/android/src/main/java/expo/modules/arcgis/OfflineFunctions.kt

@@ -10,6 +10,7 @@ import com.arcgismaps.mapping.MobileMapPackage
 import com.arcgismaps.tasks.offlinemaptask.OfflineMapSyncTask
 import com.arcgismaps.tasks.offlinemaptask.OfflineMapTask
 import com.arcgismaps.tasks.tilecache.ExportTileCacheTask
+import com.arcgismaps.tasks.tilecache.EstimateTileCacheSizeJob
 import expo.modules.kotlin.AppContext
 import java.io.File
 
@@ -151,6 +152,24 @@ internal suspend fun exportTileCache(
   }
 }
 
+/**
+ * Estimates the on-disk file size and tile count for an [exportTileCache] download WITHOUT
+ * downloading. Runs the [EstimateTileCacheSizeJob] to completion and returns `{fileSize, tileCount}`.
+ */
+internal suspend fun estimateTileCacheSize(
+  tileServiceUrl: String,
+  areaOfInterest: Map<String, Any?>,
+  @Suppress("UNUSED_PARAMETER") options: Map<String, Any?>?,
+): Map<String, Any?> {
+  val area = geometryFromDict(areaOfInterest) ?: throw IllegalArgumentException("Invalid area of interest")
+  val task = ExportTileCacheTask(tileServiceUrl)
+  val parameters = task.createDefaultExportTileCacheParameters(area, 0.0, 0.0).getOrThrow()
+  val job = task.createEstimateTileCacheSizeJob(parameters)
+  job.start()
+  val estimate = job.result().getOrThrow()
+  return mapOf("fileSize" to estimate.fileSize, "tileCount" to estimate.tileCount)
+}
+
 internal suspend fun exportVectorTiles(
   appContext: AppContext,
   baseDir: File?,

package/build/DynamicEntityLayer.d.ts

@@ -1,4 +1,4 @@
-import type { ConnectionStatus, DynamicEntityLayerHandle } from './ExpoArcgis.types';
+import type { ConnectionStatus, DynamicEntityChange, DynamicEntityLayerHandle } from './ExpoArcgis.types';
 /**
  * Declarative real-time `DynamicEntityLayer`. Adds itself to the nearest `<Map>` / `<Scene>`, shows
  * live moving entities from a `streamServiceUrl` (or a `customSource` you feed via the ref), reports
@@ -14,5 +14,8 @@ export declare const DynamicEntityLayer: import("react").ForwardRefExoticCompone
         geometry?: import("./ExpoArcgis.types").Geometry;
     };
     onConnectionStatusChange?: (status: ConnectionStatus) => void;
+    onDynamicEntityChange?: (event: {
+        nativeEvent: DynamicEntityChange;
+    }) => void;
 } & import("react").RefAttributes<DynamicEntityLayerHandle>>;
 //# sourceMappingURL=DynamicEntityLayer.d.ts.map

package/build/DynamicEntityLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicEntityLayer.d.ts","sourceRoot":"","sources":["../src/DynamicEntityLayer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAO5B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;mBA8CuspB,CAAC;gBAAkB,CAAC;;;4DADzvpB,CAAC"}
+{"version":3,"file":"DynamicEntityLayer.d.ts","sourceRoot":"","sources":["../src/DynamicEntityLayer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EAEzB,MAAM,oBAAoB,CAAC;AAO5B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;mBAwDszqB,CAAC;gBAAkB,CAAC;;;;;;4DADx2qB,CAAC"}

package/build/DynamicEntityLayer.js

@@ -10,7 +10,7 @@ import { getPropsDiffs } from './utils/getPropsDiffs';
  * connection state through `onConnectionStatusChange`, and exposes `queryDynamicEntities` /
  * `pushObservation` through a `ref`.
  */
-export const DynamicEntityLayer = forwardRef(function DynamicEntityLayer({ onConnectionStatusChange, ...layerProps }, handle) {
+export const DynamicEntityLayer = forwardRef(function DynamicEntityLayer({ onConnectionStatusChange, onDynamicEntityChange, ...layerProps }, handle) {
     const model = useGeoModel();
     const ref = useRef(undefined);
     if (!ref.current) {
@@ -33,6 +33,13 @@ export const DynamicEntityLayer = forwardRef(function DynamicEntityLayer({ onCon
         const sub = ref.current.addListener('onConnectionStatusChange', (event) => onConnectionStatusChange(event.status));
         return () => sub.remove();
     }, [onConnectionStatusChange]);
+    // The entity-change callback is wired as an event listener.
+    useEffect(() => {
+        if (!onDynamicEntityChange)
+            return;
+        const sub = ref.current.addListener('onDynamicEntityChange', (event) => onDynamicEntityChange({ nativeEvent: event }));
+        return () => sub.remove();
+    }, [onDynamicEntityChange]);
     useUpdateEffect(() => {
         const diffs = getPropsDiffs(prev, layerProps);
         if (diffs.length === 0)

package/build/DynamicEntityLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"DynamicEntityLayer.js","sourceRoot":"","sources":["../src/DynamicEntityLayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAO3E,OAAO,gBAAgD,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAC1C,SAAS,kBAAkB,CAAC,EAAE,wBAAwB,EAAE,GAAG,UAAU,EAAE,EAAE,MAAM;IAC7E,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAoC,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,GAAG,CAAC,OAAQ,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACzB,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,iGAAiG;IACjG,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,wBAAwB;YAAE,OAAO;QACtC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAQ,CAAC,WAAW,CAClC,0BAA0B,EAC1B,CAAC,KAAmC,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAChF,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACpB,OAAO,CAAC,GAAa,CAAC,GAAI,UAAsC,CAAC,GAAa,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,yFAAyF;IACzF,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAQ,EAAE,EAAE,CAAC,CAAC;IAEpD,OAAO,IAAI,CAAC;AACd,CAAC,CACF,CAAC","sourcesContent":["import { forwardRef, useEffect, useImperativeHandle, useRef } from 'react';\n\nimport type {\n  ConnectionStatus,\n  DynamicEntityLayerHandle,\n  DynamicEntityLayerProps,\n} from './ExpoArcgis.types';\nimport ExpoArcgisModule, { type DynamicEntityLayerRef } from './ExpoArcgisModule';\nimport { useGeoModel } from './contexts';\nimport { usePrevious } from './hooks/usePrevious';\nimport { useUpdateEffect } from './hooks/useUpdateEffect';\nimport { getPropsDiffs } from './utils/getPropsDiffs';\n\n/**\n * Declarative real-time `DynamicEntityLayer`. Adds itself to the nearest `<Map>` / `<Scene>`, shows\n * live moving entities from a `streamServiceUrl` (or a `customSource` you feed via the ref), reports\n * connection state through `onConnectionStatusChange`, and exposes `queryDynamicEntities` /\n * `pushObservation` through a `ref`.\n */\nexport const DynamicEntityLayer = forwardRef<DynamicEntityLayerHandle, DynamicEntityLayerProps>(\n  function DynamicEntityLayer({ onConnectionStatusChange, ...layerProps }, handle) {\n    const model = useGeoModel();\n    const ref = useRef<DynamicEntityLayerRef | undefined>(undefined);\n    if (!ref.current) {\n      ref.current = new ExpoArcgisModule.DynamicEntityLayerRef(layerProps);\n    }\n\n    const prev = usePrevious(layerProps);\n\n    useEffect(() => {\n      const layer = ref.current!;\n      model.addLayer(layer);\n      return () => {\n        model.removeLayer(layer);\n        layer.release();\n      };\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    // The connection-status callback is wired as an event listener (functions can't cross as props).\n    useEffect(() => {\n      if (!onConnectionStatusChange) return;\n      const sub = ref.current!.addListener(\n        'onConnectionStatusChange',\n        (event: { status: ConnectionStatus }) => onConnectionStatusChange(event.status)\n      );\n      return () => sub.remove();\n    }, [onConnectionStatusChange]);\n\n    useUpdateEffect(() => {\n      const diffs = getPropsDiffs(prev, layerProps);\n      if (diffs.length === 0) return;\n      const changed: Record<string, unknown> = {};\n      diffs.forEach((key) => {\n        changed[key as string] = (layerProps as Record<string, unknown>)[key as string];\n      });\n      ref.current?.applyProps(changed);\n    }, [layerProps]);\n\n    // The native ref exposes queryDynamicEntities / pushObservation — hand it over directly.\n    useImperativeHandle(handle, () => ref.current!, []);\n\n    return null;\n  }\n);\n"]}
+{"version":3,"file":"DynamicEntityLayer.js","sourceRoot":"","sources":["../src/DynamicEntityLayer.tsx"],"names":[],"mappings":"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","sourcesContent":["import { forwardRef, useEffect, useImperativeHandle, useRef } from 'react';\n\nimport type {\n  ConnectionStatus,\n  DynamicEntityChange,\n  DynamicEntityLayerHandle,\n  DynamicEntityLayerProps,\n} from './ExpoArcgis.types';\nimport ExpoArcgisModule, { type DynamicEntityLayerRef } from './ExpoArcgisModule';\nimport { useGeoModel } from './contexts';\nimport { usePrevious } from './hooks/usePrevious';\nimport { useUpdateEffect } from './hooks/useUpdateEffect';\nimport { getPropsDiffs } from './utils/getPropsDiffs';\n\n/**\n * Declarative real-time `DynamicEntityLayer`. Adds itself to the nearest `<Map>` / `<Scene>`, shows\n * live moving entities from a `streamServiceUrl` (or a `customSource` you feed via the ref), reports\n * connection state through `onConnectionStatusChange`, and exposes `queryDynamicEntities` /\n * `pushObservation` through a `ref`.\n */\nexport const DynamicEntityLayer = forwardRef<DynamicEntityLayerHandle, DynamicEntityLayerProps>(\n  function DynamicEntityLayer({ onConnectionStatusChange, onDynamicEntityChange, ...layerProps }, handle) {\n    const model = useGeoModel();\n    const ref = useRef<DynamicEntityLayerRef | undefined>(undefined);\n    if (!ref.current) {\n      ref.current = new ExpoArcgisModule.DynamicEntityLayerRef(layerProps);\n    }\n\n    const prev = usePrevious(layerProps);\n\n    useEffect(() => {\n      const layer = ref.current!;\n      model.addLayer(layer);\n      return () => {\n        model.removeLayer(layer);\n        layer.release();\n      };\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    // The connection-status callback is wired as an event listener (functions can't cross as props).\n    useEffect(() => {\n      if (!onConnectionStatusChange) return;\n      const sub = ref.current!.addListener(\n        'onConnectionStatusChange',\n        (event: { status: ConnectionStatus }) => onConnectionStatusChange(event.status)\n      );\n      return () => sub.remove();\n    }, [onConnectionStatusChange]);\n\n    // The entity-change callback is wired as an event listener.\n    useEffect(() => {\n      if (!onDynamicEntityChange) return;\n      const sub = ref.current!.addListener(\n        'onDynamicEntityChange',\n        (event: DynamicEntityChange) => onDynamicEntityChange({ nativeEvent: event })\n      );\n      return () => sub.remove();\n    }, [onDynamicEntityChange]);\n\n    useUpdateEffect(() => {\n      const diffs = getPropsDiffs(prev, layerProps);\n      if (diffs.length === 0) return;\n      const changed: Record<string, unknown> = {};\n      diffs.forEach((key) => {\n        changed[key as string] = (layerProps as Record<string, unknown>)[key as string];\n      });\n      ref.current?.applyProps(changed);\n    }, [layerProps]);\n\n    // The native ref exposes queryDynamicEntities / pushObservation — hand it over directly.\n    useImperativeHandle(handle, () => ref.current!, []);\n\n    return null;\n  }\n);\n"]}

package/build/ExpoArcgis.types.d.ts

@@ -522,6 +522,27 @@ export type OgcFeatureLayerProps = LayerProps & {
 };
 /** Connection state of a real-time `DynamicEntityDataSource`. Mirrors `ConnectionStatus`. */
 export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'failed';
+/**
+ * The kind of entity lifecycle event emitted by `onDynamicEntityChange`.
+ * - `received` — a new or updated entity observation arrived (fires once per entity, not per
+ *   observation, so attribute-only updates within the same entity are collapsed).
+ * - `purged` — the entity was evicted by the data source's purge rules.
+ */
+export type DynamicEntityChangeType = 'received' | 'purged';
+/**
+ * Payload for the `<DynamicEntityLayer onDynamicEntityChange>` event.
+ * Contains the entity's current attribute snapshot and geometry at the time of the event.
+ */
+export type DynamicEntityChange = {
+    /** Whether the entity arrived/updated (`received`) or was evicted (`purged`). */
+    changeType: DynamicEntityChangeType;
+    /** The entity's unique numeric id (from the data source's `entityIDField`). */
+    entityId: number;
+    /** The entity's current attribute values (snapshot at event time). */
+    attributes: Record<string, unknown>;
+    /** The entity's current geometry, or `undefined` when unavailable. */
+    geometry?: Geometry;
+};
 /** Track display options for a `<DynamicEntityLayer>` (history of past observations). */
 export type TrackDisplay = {
     /** How many past observations to keep per track. */
@@ -557,6 +578,14 @@ export type DynamicEntityLayerProps = LayerProps & {
     };
     /** Fired as the data source connects / disconnects. */
     onConnectionStatusChange?: (status: ConnectionStatus) => void;
+    /**
+     * Fired when a dynamic entity is received (new/updated) or purged. High-frequency on busy
+     * stream services — only entity lifecycle events are emitted (one per entity arrival or purge),
+     * not per-observation attribute updates.
+     */
+    onDynamicEntityChange?: (event: {
+        nativeEvent: DynamicEntityChange;
+    }) => void;
 };
 /** A live dynamic entity returned by `queryDynamicEntities`. */
 export type DynamicEntityInfo = {
@@ -659,6 +688,54 @@ export type AreaUnit = 'squareMeters' | 'squareKilometers' | 'squareFeet' | 'squ
 export type GeodeticCurveType = 'geodesic' | 'loxodrome' | 'greatElliptic' | 'normalSection' | 'shapePreserving';
 /** Join style for `geometryEngine.offset`. Defaults to `mitered`. */
 export type GeometryOffsetType = 'mitered' | 'bevelled' | 'rounded' | 'squared';
+/**
+ * Angular unit for geodesic ellipse / sector construction. Defaults to `degrees`.
+ * Maps to the native `AngularUnit`.
+ */
+export type AngularUnit = 'degrees' | 'radians';
+/**
+ * Output geometry type for `geometryEngine.ellipseGeodesic` / `sectorGeodesic`.
+ * Defaults to `polygon`. Maps to the native `GeometryType`.
+ */
+export type GeodesicGeometryType = 'polygon' | 'polyline' | 'multipoint';
+/**
+ * Parameters for `geometryEngine.ellipseGeodesic`. Mirrors the native
+ * `GeodesicEllipseParameters` (Swift) / `com.arcgismaps.geometry.GeodesicEllipseParameters` (Kotlin).
+ */
+export type GeodesicEllipseParams = {
+    /** Center point of the ellipse. */
+    center: PointGeometry;
+    /** Length of the semi-major axis. */
+    semiAxis1Length: number;
+    /** Length of the semi-minor axis. */
+    semiAxis2Length: number;
+    /**
+     * Direction of the major axis, in `angularUnit` clockwise from north. Defaults to `0`.
+     */
+    axisDirection?: number;
+    /** Unit for `axisDirection`. Defaults to `degrees`. */
+    angularUnit?: AngularUnit;
+    /** Unit for `semiAxis1Length` / `semiAxis2Length`. Defaults to `meters`. */
+    linearUnit?: LinearUnit;
+    /**
+     * Maximum segment length on the output geometry. `0` / omitted lets the SDK choose.
+     */
+    maxSegmentLength?: number;
+    /** Maximum number of vertices on the output geometry. Defaults to `10` (SDK default). */
+    maxPointCount?: number;
+    /** Output geometry type. Defaults to `polygon`. */
+    geometryType?: GeodesicGeometryType;
+};
+/**
+ * Parameters for `geometryEngine.sectorGeodesic`. Extends `GeodesicEllipseParams` with
+ * the sector angle and start direction. Mirrors the native `GeodesicSectorParameters`.
+ */
+export type GeodesicSectorParams = GeodesicEllipseParams & {
+    /** The angular size of the sector, in `angularUnit`. */
+    sectorAngle: number;
+    /** The direction from which the sector opens, in `angularUnit` clockwise from north. */
+    startDirection: number;
+};
 /** Result of `geometryEngine.geodesicDistance` — distance plus the two azimuths (degrees). */
 export type GeodeticDistanceResult = {
     distance: number;
@@ -925,6 +1002,16 @@ export type GeoprocessingInput = {
 } | {
     type: 'features';
     geometries: Geometry[];
+}
+/** An array of homogeneous strings or numbers — maps to `GeoprocessingMultiValue`. */
+ | {
+    type: 'multiValue';
+    values: (string | number)[];
+}
+/** A remote file input (URL) — maps to `GeoprocessingDataFile`. */
+ | {
+    type: 'dataFile';
+    url: string;
 };
 /** Result of `geoprocessor.execute`. Mirrors the native `GeoprocessingResult`. */
 export type GeoprocessingResult = {
@@ -1049,6 +1136,13 @@ export type OfflineTileResult = {
     /** Local filesystem path of the downloaded tile package (`.tpkx` / `.vtpk`). */
     path: string;
 };
+/** Result of `offline.estimateTileCacheSize` — an estimate of the download footprint. */
+export type TileCacheSizeEstimate = {
+    /** Estimated on-disk size of the tile cache in bytes. */
+    fileSize: number;
+    /** Estimated number of tiles in the tile cache. */
+    tileCount: number;
+};
 /** The kind of geometry a `<GeometryEditor>` sketches. */
 export type GeometryEditorType = 'point' | 'multipoint' | 'polyline' | 'polygon' | 'envelope';
 /**
@@ -1198,8 +1292,26 @@ export type DistanceCompositeSceneSymbol = {
     type: 'distance-composite-scene';
     ranges: DistanceSymbolRange[];
 };
+/**
+ * A composite symbol that overlays multiple symbols stacked on top of each other.
+ * Useful for combining a marker with a label, or layering two markers for a ring effect.
+ * Mirrors the native `CompositeSymbol`.
+ *
+ * @example
+ * ```ts
+ * { type: 'composite', symbols: [
+ *   { type: 'simple-marker', color: '#fff', size: 18 },
+ *   { type: 'simple-marker', color: '#e63946', size: 10 },
+ * ] }
+ * ```
+ */
+export type CompositeSymbolType = {
+    type: 'composite';
+    /** The symbols to stack, drawn in order (first = bottom, last = top). */
+    symbols: Symbol[];
+};
 /** Any symbol usable by a `<Graphic>`. Mirrors the native `Symbol` hierarchy. */
-export type Symbol = SimpleMarkerSymbol | SimpleLineSymbol | SimpleFillSymbol | TextSymbol | SimpleMarkerSceneSymbol | PictureMarkerSymbol | PictureFillSymbol | DistanceCompositeSceneSymbol;
+export type Symbol = SimpleMarkerSymbol | SimpleLineSymbol | SimpleFillSymbol | TextSymbol | SimpleMarkerSceneSymbol | PictureMarkerSymbol | PictureFillSymbol | DistanceCompositeSceneSymbol | CompositeSymbolType;
 /** A renderer that draws every feature/graphic with the same `symbol`. */
 export type SimpleRenderer = {
     type: 'simple';
@@ -1307,11 +1419,31 @@ export type SceneProps = {
 export type SunLighting = 'off' | 'light' | 'lightAndShadows';
 /** Atmosphere rendering for a 3D scene view. */
 export type AtmosphereEffect = 'off' | 'horizonOnly' | 'realistic';
+/**
+ * Camera controller for a `<SceneView>`.
+ * - `orbitLocation` — orbits around a fixed target point (`OrbitLocationCameraController`).
+ * - `globe` — free globe navigation (`GlobeCameraController`).
+ */
+export type CameraController = {
+    type: 'orbitLocation';
+    /** The point the camera orbits around (WGS84 longitude/latitude, optional altitude). */
+    target: Point;
+    /** Initial camera distance from the target, in meters. */
+    distance: number;
+} | {
+    type: 'globe';
+};
 /** Props for the `<SceneView>` host component. */
 export type SceneViewProps = {
     style?: StyleProp<ViewStyle>;
     /** Animates the view to this 3D camera whenever the value changes (runtime camera control). */
     camera?: Camera;
+    /**
+     * Swaps the scene's camera-control mode. Omit (or pass `null`) to use the SDK default.
+     * - `{ type: 'orbitLocation', target, distance }` — orbit around a fixed point.
+     * - `{ type: 'globe' }` — free globe navigation.
+     */
+    cameraController?: CameraController | null;
     /** Sun lighting mode (shadows). Defaults to `off`. */
     sunLighting?: SunLighting;
     /** Atmosphere rendering. Defaults to `horizonOnly`. */