@reearth/core 0.0.7-alpha.4 → 0.0.7-alpha.41

package/dist/{index-DqatWUTw.js → index-DqGWVPtz.js}

@@ -1,4 +1,3 @@
-window.CESIUM_BASE_URL = "/cesium/";
 var oe = typeof global < "u" ? global : typeof self < "u" ? self : typeof window < "u" ? window : {}, P = [], M = [], Qt = typeof Uint8Array < "u" ? Uint8Array : Array, je = !1;
 function at() {
   je = !0;

package/dist/index.d.ts

@@ -17,7 +17,6 @@ import { PropsWithoutRef } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { RefObject } from 'react';
-import { RequireExactlyOne } from 'type-fest';
 import { WritableAtom } from 'jotai';
 
 export declare type AmbientOcclusionProperty = {
@@ -161,16 +160,16 @@ export declare type CameraProperty = {
 
 export declare type Cesium3DTilesAppearance = {
     show?: boolean;
+    height?: number;
     color?: string;
     styleUrl?: string;
     shadows?: "disabled" | "enabled" | "cast_only" | "receive_only";
-    colorBlendMode?: "highlight" | "replace" | "mix" | "default";
+    colorBlendMode?: "highlight" | "replace" | "mix";
     edgeWidth?: number;
     edgeColor?: string;
     selectedFeatureColor?: string;
     disableIndexingFeature?: boolean;
     tileset?: string;
-    apiKey?: string;
     experimental_clipping?: EXPERIMENTAL_clipping;
     pointSize?: number;
     meta?: unknown;
@@ -278,6 +277,7 @@ declare type CommonProps = {
     isHidden?: boolean;
     isSelected?: boolean;
     meta?: Record<string, unknown>;
+    sketchEditingFeature?: SketchEditingFeature;
 };
 
 export declare function computeAtom(cache?: typeof globalDataFeaturesCache): WritableAtom<ComputedLayer | undefined, Command, void>;
@@ -299,6 +299,8 @@ export declare type ConditionsExpression = {
     conditions: [string, string][];
 };
 
+declare type ControlPointMouseEventHandler = (index: number, isExtrudedPoint: boolean, type: "mousedown" | "click") => void;
+
 export declare function convertLayer(l: Layer): LegacyLayer | undefined;
 
 export declare function convertLegacyCluster(clusters: LegacyCluster[]): Cluster[];
@@ -320,6 +322,8 @@ declare type CoreContext = {
     handleCameraForceHorizontalRollChange?: (enable?: boolean) => void;
     handleInteractionModeChange?: (mode?: InteractionModeType | undefined) => void;
     onSketchPluginFeatureCreate?: (cb: SketchEventCallback) => void;
+    onSketchPluginFeatureUpdate?: (cb: SketchEventCallback) => void;
+    onSketchPluginFeatureDelete?: (cb: SketchEventCallback) => void;
     onSketchTypeChange?: (cb: (type: SketchType | undefined) => void) => void;
     onLayerVisibility?: (cb: (e: LayerVisibilityEvent) => void) => void;
     onLayerLoad?: (cb: (e: LayerLoadEvent) => void) => void;
@@ -352,6 +356,7 @@ export declare type CoreVisualizerProps = {
     ready?: boolean;
     hiddenLayers?: string[];
     zoomedLayerId?: string;
+    displayCredits?: boolean;
     onCameraChange?: (camera: Camera) => void;
     onLayerDrop?: (layerId: string, propertyKey: string, position: LatLng | undefined) => void;
     onLayerSelect?: (layerId: string | undefined, layer: (() => Promise<ComputedLayer | undefined>) | undefined, feature: ComputedFeature | undefined, reason: LayerSelectionReason | undefined) => void;
@@ -359,12 +364,26 @@ export declare type CoreVisualizerProps = {
     onMount?: () => void;
     onSketchTypeChangeProp?: (type: SketchType | undefined) => void;
     onSketchFeatureCreate?: (feature: SketchFeature | null) => void;
+    onSketchFeatureUpdate?: (feature: SketchFeature | null) => void;
+    onSketchFeatureDelete?: (layerId: string, featureId: string) => void;
     onInteractionModeChange?: (mode: InteractionModeType) => void;
+    onAPIReady?: () => void;
+    onCreditsUpdate?: (credits?: Credits) => void;
+};
+
+export declare type CreditItem = {
+    html?: string;
 };
 
-export declare type CursorType = "auto" | "grab" | "crosshair";
+export declare type Credits = {
+    engine: {
+        cesium?: CreditItem;
+    };
+    lightbox: CreditItem[];
+    screen: CreditItem[];
+};
 
-declare type CursorType_2 = "default" | "auto" | "help" | "pointer" | "grab" | "crosshair";
+declare type CursorType = "default" | "auto" | "help" | "pointer" | "grab" | "crosshair" | "wait";
 
 export declare type Data = {
     type: DataType;
@@ -376,6 +395,9 @@ export declare type Data = {
     updateInterval?: number;
     parameters?: Record<string, any>;
     idProperty?: string;
+    serviceTokens?: {
+        googleMapApiKey?: string;
+    };
     time?: {
         property?: string;
         interval?: number;
@@ -489,6 +511,7 @@ export declare type EngineProps = {
     isLayerDragging?: boolean;
     shouldRender?: boolean;
     meta?: Record<string, unknown>;
+    displayCredits?: boolean;
     layersRef?: RefObject<LayersRef>;
     requestingRenderMode?: MutableRefObject<RequestingRenderMode>;
     timelineManagerRef?: TimelineManagerRef;
@@ -503,6 +526,7 @@ export declare type EngineProps = {
     onLayerSelectWithRectStart?: (e: LayerSelectWithRectStart) => void;
     onLayerSelectWithRectMove?: (e: LayerSelectWithRectMove) => void;
     onLayerSelectWithRectEnd?: (e: LayerSelectWithRectEnd) => void;
+    onCreditsUpdate?: (credits?: Credits) => void;
 };
 
 export declare type EngineRef = {
@@ -531,7 +555,8 @@ export declare type EngineRef = {
     isPositionVisible: (position: [x: number, y: number, z: number]) => boolean;
     setView: (camera: CameraPosition) => void;
     toWindowPosition: (position: [x: number, y: number, z: number]) => [x: number, y: number] | undefined;
-    getExtrudedHeight: (position: [x: number, y: number, z: number], windowPosition: [x: number, y: number]) => number | undefined;
+    getExtrudedHeight: (position: [x: number, y: number, z: number], windowPosition: [x: number, y: number], allowNegative?: boolean) => number | undefined;
+    getExtrudedPoint: (position: [x: number, y: number, z: number], extrutedHeight: number) => Position3d | undefined;
     getSurfaceDistance: (point1: Cartesian3, point2: Cartesian3) => number | undefined;
     equalsEpsilon2d: (point1: Position2d, point2: Position2d, relativeEpsilon: number | undefined, absoluteEpsilon: number | undefined) => boolean;
     equalsEpsilon3d: (point1: Position3d, point2: Position3d, relativeEpsilon: number | undefined, absoluteEpsilon: number | undefined) => boolean;
@@ -539,7 +564,7 @@ export declare type EngineRef = {
         type: SketchType;
         controlPoints: Position3d[];
     }) => LineString | Polygon_2 | MultiPolygon | Point | undefined;
-    setCursor: (cursor: CursorType_2) => void;
+    setCursor: (cursor: CursorType) => void;
     flyTo: FlyTo;
     flyToBBox: (bbox: [number, number, number, number], options?: CameraOptions & {
         heading?: number;
@@ -589,6 +614,8 @@ export declare type EngineRef = {
     selectFeatures: (layerId: string, featureId: string[]) => void;
     unselectFeatures: (layerId: string, featureId: string[]) => void;
     pickManyFromViewport: (windowPosition: [x: number, y: number], windowWidth: number, windowHeight: number, condition?: (f: PickedFeature) => boolean) => PickedFeature[] | undefined;
+    calcRectangleControlPoint: (p1: Position3d, p2: Position3d, p3: Position3d) => [p1: Position3d, p2: Position3d, p3: Position3d];
+    getCredits: () => Credits | undefined;
 } & MouseEventHandles;
 
 export declare const engines: {
@@ -745,13 +772,19 @@ export declare type FrustumAppearance = {
     length?: number;
 };
 
-export declare type Geometry = Point | LineString | Polygon_2 | MultiPoint | MultiLineString | MultiPolygon;
+export declare type GeoidProperty = {
+    server: {
+        url: string;
+        geoidProperty: string;
+    };
+};
 
-declare type GeometryOptions = {
-    type: SketchType;
-    controlPoints: readonly Position3d[];
+declare type GeoidRef = {
+    getGeoidHeight: (lat?: number, lng?: number) => Promise<number | undefined>;
 };
 
+export declare type Geometry = Point | LineString | Polygon_2 | MultiPoint | MultiLineString | MultiPolygon;
+
 export declare type GeometryOptionsXYZ = {
     type: SketchType;
     controlPoints: Position3d[];
@@ -844,7 +877,7 @@ declare type InfoboxProperty = {
 
 export declare const INTERACTION_MODES: Record<InteractionModeType, number>;
 
-export declare type InteractionModeType = "default" | "move" | "selection" | "sketch";
+export declare type InteractionModeType = "default" | "move" | "selection" | "sketch" | "spatialId";
 
 export declare function isSketchType(value: unknown): value is SketchType;
 
@@ -954,6 +987,8 @@ export declare type LayersRef = {
     }) | null) => void;
     deleteLayer: (...ids: string[]) => void;
     isLayer: (obj: any) => obj is LazyLayer;
+    isComputedLayer: (obj: any) => obj is ComputedLayer;
+    isTempLayer: (layerId?: string) => boolean;
     layers: () => LazyLayer[];
     walk: <T>(fn: (layer: LazyLayer, index: number, parents: LazyLayer[]) => T | void) => T | undefined;
     find: (fn: (layer: LazyLayer, index: number, parents: LazyLayer[]) => boolean) => LazyLayer | undefined;
@@ -984,6 +1019,7 @@ export declare type LayerVisibilityEvent = {
  */
 export declare type LazyLayer = Readonly<Layer> & {
     computed?: Readonly<ComputedLayer>;
+    isTempLayer?: boolean;
     pluginId?: string;
     extensionId?: string;
     property?: any;
@@ -1074,15 +1110,16 @@ export declare type LUT = readonly ColorTuple[];
 declare const Map_2: ForwardRefExoticComponent<    {
 engines?: Record<string, Engine> | undefined;
 engine?: string | undefined;
-} & Omit<Props_2, "Feature" | "viewerProperty" | "selectionReason" | "delegatedDataTypes" | "clusterComponent" | "selectedLayerId"> & Omit<EngineProps, "onLayerSelect" | "selectedLayerId" | "layerSelectionReason"> & Omit<SketchProps, "engineRef" | "layersRef" | "SketchComponent"> & {
-cursor?: CursorType | undefined;
-} & RefAttributes<MapRef>>;
+onAPIReady?: (() => void) | undefined;
+} & Omit<Props_2, "Feature" | "viewerProperty" | "selectionReason" | "delegatedDataTypes" | "clusterComponent" | "selectedLayerId"> & Omit<EngineProps, "onLayerSelect" | "selectedLayerId" | "layerSelectionReason"> & Omit<SketchProps, "engineRef" | "SketchComponent" | "layersRef"> & RefAttributes<MapRef>>;
 export { Map_2 as Map }
 
 export declare type MapRef = {
     engine: WrappedRef<EngineRef>;
     layers: WrappedRef<LayersRef>;
     sketch: WrappedRef<SketchRef>;
+    spatialId?: WrappedRef<SpatialIdRef>;
+    geoid: WrappedRef<GeoidRef>;
     timeline?: TimelineManagerRef;
 };
 
@@ -1135,6 +1172,7 @@ export declare type ModelAppearance = {
     model?: string;
     url?: string;
     heightReference?: "none" | "clamp" | "relative";
+    height?: number;
     heading?: number;
     pitch?: number;
     roll?: number;
@@ -1272,6 +1310,7 @@ export declare type PolygonAppearance = {
     stroke?: boolean;
     strokeColor?: string;
     strokeWidth?: number;
+    height?: number;
     heightReference?: "none" | "clamp" | "relative";
     shadows?: "disabled" | "enabled" | "cast_only" | "receive_only";
     lineJoin?: CanvasLineJoin;
@@ -1316,9 +1355,8 @@ declare type PropertyItem<T> = {
 export declare type Props = {
     engines?: Record<string, Engine>;
     engine?: string;
-} & Omit<Props_2, "Feature" | "clusterComponent" | "selectionReason" | "delegatedDataTypes" | "selectedLayerId" | "viewerProperty"> & Omit<EngineProps, "onLayerSelect" | "layerSelectionReason" | "selectedLayerId"> & Omit<SketchProps, "layersRef" | "engineRef" | "SketchComponent"> & {
-    cursor?: CursorType;
-};
+    onAPIReady?: () => void;
+} & Omit<Props_2, "Feature" | "clusterComponent" | "selectionReason" | "delegatedDataTypes" | "selectedLayerId" | "viewerProperty"> & Omit<EngineProps, "onLayerSelect" | "layerSelectionReason" | "selectedLayerId"> & Omit<SketchProps, "layersRef" | "engineRef" | "SketchComponent">;
 
 declare type Props_2 = Omit<Props_3, "atomMap" | "isHidden" | "selectedLayerId"> & {
     selectedLayer?: {
@@ -1331,6 +1369,7 @@ declare type Props_2 = Omit<Props_3, "atomMap" | "isHidden" | "selectedLayerId">
     requestingRenderMode?: MutableRefObject<RequestingRenderMode>;
     engineRef?: RefObject<EngineRef>;
     onLayerSelect?: (layerId: string | undefined, featureId: string | undefined, layer: (() => Promise<ComputedLayer | undefined>) | undefined, reason: LayerSelectionReason | undefined, info: SelectedFeatureInfo | undefined) => void;
+    onMount?: () => void;
 };
 
 declare type Props_3 = {
@@ -1458,17 +1497,34 @@ export declare type ShadowProperty = {
 
 export declare type SketchAppearance = Partial<LayerAppearanceTypes>;
 
-declare type SketchComponentProps = RequireExactlyOne<{
-    geometry?: LineString | Polygon_2 | MultiPolygon | null;
-    geometryOptions?: GeometryOptions | null;
+declare type SketchComponentProps = {
+    geometryOptions?: {
+        type: SketchType;
+        controlPoints: readonly Position3d[];
+    } | null;
     extrudedHeight?: number;
+    extrudedPoint?: Position3d;
+    centroidBasePoint?: Position3d;
+    centroidExtrudedPoint?: Position3d;
     disableShadow?: boolean;
-    enableRelativeHeight?: boolean;
     color?: string;
-}, "geometry" | "geometryOptions">;
+    isEditing?: boolean;
+    catchedControlPointIndex?: number;
+    catchedExtrudedPoint?: boolean;
+    selectedControlPointIndex?: number;
+    handleControlPointMouseEvent?: ControlPointMouseEventHandler;
+    handleAddControlPoint?: (position: Position3d, index: number) => void;
+};
 
 export declare type SketchComponentType = ComponentType<SketchComponentProps>;
 
+export declare type SketchEditFeatureChangeCb = (feature: SketchEditingFeature | undefined) => void;
+
+export declare type SketchEditingFeature = {
+    layerId: string;
+    feature: ComputedFeature;
+};
+
 export declare type SketchEventCallback = (event: SketchEventProps) => void;
 
 export declare type SketchEventProps = {
@@ -1489,9 +1545,9 @@ export declare type SketchOptions = {
     appearance?: SketchAppearance;
     dataOnly?: boolean;
     disableShadow?: boolean;
-    enableRelativeHeight?: boolean;
     rightClickToAbort?: boolean;
     autoResetInteractionMode?: boolean;
+    useCentroidExtrudedHeight?: boolean;
 };
 
 export declare type SketchProps = {
@@ -1504,7 +1560,17 @@ export declare type SketchProps = {
     onSketchTypeChange?: (type: SketchType | undefined, from?: "editor" | "plugin") => void;
     onSketchFeatureCreate?: (feature: SketchFeature | null) => void;
     onSketchPluginFeatureCreate?: (props: SketchEventProps) => void;
+    onSketchFeatureUpdate?: (feature: SketchFeature | null) => void;
+    onSketchPluginFeatureUpdate?: (props: SketchEventProps) => void;
+    onSketchFeatureDelete?: (layerId: string, featureId: string) => void;
+    onSketchPluginFeatureDelete?: (props: {
+        layerId: string;
+        featureId: string;
+    }) => void;
     onLayerSelect?: OnLayerSelectType;
+    sketchEditingFeature?: SketchEditingFeature;
+    onSketchEditFeature?: (feature: SketchEditingFeature | undefined) => void;
+    onMount?: () => void;
 };
 
 export declare type SketchRef = {
@@ -1512,6 +1578,11 @@ export declare type SketchRef = {
     setType: (type: SketchType | undefined, from?: "editor" | "plugin") => void;
     getOptions: () => SketchOptions;
     overrideOptions: (options: SketchOptions) => void;
+    editFeature: (feature: SketchEditingFeature | undefined) => void;
+    cancelEdit: (ignoreAutoReSelect?: boolean) => void;
+    applyEdit: () => void;
+    deleteFeature: (layerId: string, featureId: string) => void;
+    onEditFeatureChange: (cb: SketchEditFeatureChangeCb) => void;
 };
 
 export declare type SketchType = "marker" | "polyline" | "circle" | "rectangle" | "polygon" | "extrudedCircle" | "extrudedRectangle" | "extrudedPolygon";
@@ -1542,6 +1613,49 @@ export declare type Spacing = {
     top: number;
 };
 
+declare type SpatialIdPickSpaceOptions = {
+    zoom?: number;
+    maxHeight?: number;
+    minHeight?: number;
+    dataOnly?: boolean;
+    rightClickToExit?: boolean;
+    color?: string;
+    outlineColor?: string;
+    groundIndicatorColor?: string;
+    selectorColor?: string;
+    selectorOutlineColor?: string;
+    verticalSpaceIndicatorColor?: string;
+    verticalSpaceIndicatorOutlineColor?: string;
+};
+
+declare type SpatialIdRef = {
+    pickSpace: (options?: SpatialIdPickSpaceOptions) => void;
+    exitPickSpace: () => void;
+    onSpacePick: (cb: (space: SpatialIdSpaceData) => void) => void;
+};
+
+declare type SpatialIdSpaceData = {
+    id: string;
+    center: {
+        lat: number;
+        lng: number;
+        alt?: number;
+    };
+    alt: number;
+    zoom: number;
+    zfxy: {
+        z: number;
+        f: number;
+        x: number;
+        y: number;
+    };
+    zfxyStr: string;
+    tilehash: string;
+    hilbertTilehash: string;
+    hilbertIndex: string;
+    vertices: [number, number, number][];
+};
+
 export declare type StyleExpression = ConditionsExpression | string;
 
 export declare type SunProperty = {
@@ -1580,6 +1694,8 @@ export declare type TileLabelProperty = {
     id: string;
     labelType: "japan_gsi_optimal_bvmap";
     style: Record<string, any>;
+    near?: number;
+    far?: number;
 };
 
 export declare type TileProperty = {
@@ -1700,6 +1816,7 @@ export declare type ValueTypes = {
 
 export declare type ViewerProperty = {
     globe?: GlobeProperty;
+    geoid?: GeoidProperty;
     terrain?: TerrainProperty;
     scene?: SceneProperty;
     tiles?: TileProperty[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reearth/core",
-  "version": "0.0.7-alpha.4",
+  "version": "0.0.7-alpha.41",
   "author": "Re:Earth contributors <community@reearth.io>",
   "license": "Apache-2.0",
   "description": "A library that abstracts a map engine as one common API.",
@@ -21,18 +21,29 @@
     "storybook": "storybook dev -p 6007",
     "build-storybook": "storybook build",
     "preversion": "yarn test run",
-    "version": "yarn build"
+    "version": "yarn build",
+    "sketch-typegen": "xstate typegen src/**/sketchMachine.ts"
   },
   "engines": {
     "node": ">=20"
   },
   "peerDependencies": {
-    "cesium": "1.x",
+    "cesium": "1.118.x",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "dependencies": {
-    "@reearth/cesium-mvt-imagery-provider": "1.5.4",
+    "@radix-ui/react-checkbox": "1.1.1",
+    "@radix-ui/react-dialog": "1.1.1",
+    "@radix-ui/react-icons": "1.3.0",
+    "@radix-ui/react-select": "2.1.1",
+    "@radix-ui/react-separator": "1.1.0",
+    "@radix-ui/react-slider": "1.2.2",
+    "@radix-ui/react-slot": "1.1.0",
+    "@radix-ui/react-switch": "1.1.0",
+    "@radix-ui/react-toggle": "1.1.0",
+    "@reearth/cesium-mvt-imagery-provider": "1.6.0",
+    "@reearth/spatial-id-sdk": "0.0.0",
     "@rot1024/use-transition": "1.0.0",
     "@seznam/compose-react-refs": "1.0.6",
     "@turf/invariant": "6.5.0",
@@ -61,8 +72,11 @@
     "react-error-boundary": "4.0.11",
     "react-nl2br": "1.0.4",
     "react-use": "17.5.0",
-    "resium": "^1.18.0",
+    "resium": "1.18.2",
     "suspend-react": "0.1.3",
+    "tailwind-merge": "2.5.2",
+    "tailwindcss": "3.4.10",
+    "tailwindcss-animate": "1.0.7",
     "tiny-invariant": "1.3.3",
     "use-callback-ref": "1.3.2",
     "use-custom-compare": "1.4.0",
@@ -89,26 +103,32 @@
     "@types/lodash-es": "4.17.12",
     "@types/node": "20.12.7",
     "@types/pbf": "3.0.5",
-    "@types/react": "18.2.6",
-    "@types/react-dom": "18.2.6",
+    "@types/react": "18.3.0",
+    "@types/react-dom": "18.3.0",
+    "@types/scheduler": "0.23.0",
     "@types/uuid": "9.0.8",
     "@typescript-eslint/eslint-plugin": "7.2.0",
     "@typescript-eslint/parser": "7.2.0",
     "@vitejs/plugin-react": "4.2.1",
-    "cesium": "1.116.0",
+    "@xstate/cli": "0.5.17",
+    "autoprefixer": "10.4.20",
+    "cesium": "1.118.0",
+    "class-variance-authority": "0.7.0",
+    "clsx": "2.1.1",
     "eslint": "8.57.0",
     "eslint-config-reearth": "0.3.0",
     "eslint-plugin-react-hooks": "4.6.0",
     "eslint-plugin-react-refresh": "0.4.6",
     "eslint-plugin-storybook": "0.8.0",
     "jsdom": "22.1.0",
+    "postcss": "8.4.41",
     "prettier": "3.2.5",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "storybook": "8.0.8",
     "typescript": "5.2.2",
     "vite": "5.0.8",
-    "vite-plugin-cesium": "1.2.22",
+    "vite-plugin-cesium": "1.2.23",
     "vite-plugin-dts": "3.8.1",
     "vite-plugin-svgr": "4.2.0",
     "vite-tsconfig-paths": "^4.3.2",

package/src/Map/Geoid/index.tsx

@@ -0,0 +1,68 @@
+import {
+  forwardRef,
+  ForwardRefRenderFunction,
+  useCallback,
+  useImperativeHandle,
+  useRef,
+} from "react";
+
+import { GeoidServer, GeoidRef } from "./types";
+
+export type GeoidProps = {
+  geoidServer?: GeoidServer;
+};
+
+const MAX_GEOID_CACHE_SIZE = 1000;
+
+const Geoid: ForwardRefRenderFunction<GeoidRef, GeoidProps> = ({ geoidServer }, ref) => {
+  const geoidCache = useRef<Map<string, number>>(new Map());
+
+  const getGeoidHeight = useCallback(
+    async (lng?: number, lat?: number): Promise<number | undefined> => {
+      if (!geoidServer?.url || !geoidServer?.geoidProperty) {
+        console.error("Geoid: Server is not set properly");
+        return Promise.resolve(undefined);
+      }
+
+      if (lat === undefined || lng === undefined) {
+        console.error("Geoid: Invalid lat or lng");
+        return Promise.resolve(undefined);
+      }
+
+      const cache = geoidCache.current.get(`${lng},${lat}`);
+      if (cache) return Promise.resolve(cache);
+
+      return fetch(
+        geoidServer.url.replace("${lng}", lng.toString()).replace("${lat}", lat.toString()),
+      )
+        .then(res => {
+          return res.json().then((result: any) => {
+            if (!result) return undefined;
+            const geoid = Number(result[geoidServer?.geoidProperty]);
+            if (!isNaN(geoid)) {
+              const cache = geoidCache.current;
+              if (cache.size > MAX_GEOID_CACHE_SIZE) {
+                const firstKey = cache.keys().next().value;
+                if (firstKey) cache.delete(firstKey);
+              }
+              cache.set(`${lng},${lat}`, geoid);
+              return geoid;
+            }
+            return undefined;
+          });
+        })
+        .catch(e => {
+          console.error("Failed to fetch geoid height", e);
+          return undefined;
+        });
+    },
+    [geoidServer?.url, geoidServer?.geoidProperty],
+  );
+
+  useImperativeHandle(ref, () => ({
+    getGeoidHeight,
+  }));
+  return null;
+};
+
+export default forwardRef(Geoid);

package/src/Map/Geoid/types.ts

@@ -0,0 +1,8 @@
+export type GeoidServer = {
+  url: string; // URL of the geoid server. use ${lat} ${lng} for lat/lng placeholders. Example: "https://mock.com/api/altitude?lat=${lat}&lng=${lng}"
+  geoidProperty: string; // TODO: support json path
+};
+
+export type GeoidRef = {
+  getGeoidHeight: (lat?: number, lng?: number) => Promise<number | undefined>;
+};

package/src/Map/Layer/hooks.ts

@@ -107,12 +107,15 @@ export default function useHooks({
     };
   }, [layer, forceUpdateFeatures]);
 
-  const prevForceUpdatableData = useRef<Pick<Data, "csv" | "jsonProperties">>();
+  const prevForceUpdatableData = useRef<Pick<Data, "csv" | "jsonProperties" | "value">>();
   useLayoutEffect(() => {
     const data = layer?.type === "simple" ? layer.data : undefined;
-    const forceUpdatableData = pick(data, "csv", "jsonProperties");
+    const forceUpdatableData = pick(data, "csv", "jsonProperties", "value");
 
-    if (isEqual(forceUpdatableData, prevForceUpdatableData.current) || !data?.url) {
+    if (
+      isEqual(forceUpdatableData, prevForceUpdatableData.current) ||
+      (!data?.url && !data?.value)
+    ) {
       return;
     }
 

package/src/Map/Layer/index.tsx

@@ -9,6 +9,7 @@ import type {
   ComputedFeature,
   LayerSimple,
 } from "../../mantle";
+import { SketchEditingFeature } from "../Sketch";
 import { ViewerProperty } from "../types";
 
 import useHooks, { type Atom, type EvalFeature } from "./hooks";
@@ -25,6 +26,7 @@ export type CommonProps = {
   isHidden?: boolean;
   isSelected?: boolean;
   meta?: Record<string, unknown>;
+  sketchEditingFeature?: SketchEditingFeature;
 };
 
 export type FeatureComponentProps = {

package/src/Map/Layers/hooks.ts

@@ -35,6 +35,7 @@ export type { Layer, NaiveLayer } from "../../mantle";
  */
 export type LazyLayer = Readonly<Layer> & {
   computed?: Readonly<ComputedLayer>;
+  isTempLayer?: boolean;
   // compat
   pluginId?: string;
   extensionId?: string;
@@ -52,6 +53,8 @@ export type Ref = {
   override: (id: string, layer?: (Partial<Layer> & { property?: any }) | null) => void;
   deleteLayer: (...ids: string[]) => void;
   isLayer: (obj: any) => obj is LazyLayer;
+  isComputedLayer: (obj: any) => obj is ComputedLayer;
+  isTempLayer: (layerId?: string) => boolean;
   layers: () => LazyLayer[];
   walk: <T>(
     fn: (layer: LazyLayer, index: number, parents: LazyLayer[]) => T | void,
@@ -118,6 +121,7 @@ export default function useHooks({
   requestingRenderMode,
   onLayerSelect,
   engineRef,
+  onMount,
 }: {
   layers?: Layer[];
   ref?: ForwardedRef<Ref>;
@@ -136,6 +140,7 @@ export default function useHooks({
     info: SelectedFeatureInfo | undefined,
   ) => void;
   engineRef?: RefObject<EngineRef>;
+  onMount?: () => void;
 }) {
   const layerMap = useMemo(() => new Map<string, Layer>(), []);
   const [overriddenLayers, setOverridenLayers] = useState<OverriddenLayer[]>([]);
@@ -455,6 +460,20 @@ export default function useHooks({
     [lazyLayerPrototype],
   );
 
+  const isTempLayer = useCallback(
+    (layerId?: string) => {
+      return tempLayersRef.current.some(l => l.id === layerId);
+    },
+    [tempLayersRef],
+  );
+
+  const isComputedLayer = useCallback(
+    (obj: any): obj is ComputedLayer => {
+      return typeof obj === "object" && Object.getPrototypeOf(obj) === lazyComputedLayerPrototype;
+    },
+    [lazyComputedLayerPrototype],
+  );
+
   const rootLayers = useCallback(() => {
     return [...(layersRef() ?? []), ...tempLayersRef.current]
       .map(l => findById(l.id))
@@ -551,6 +570,8 @@ export default function useHooks({
       deleteLayer,
       findByIds,
       isLayer,
+      isComputedLayer,
+      isTempLayer,
       layers: rootLayers,
       walk,
       find,
@@ -575,6 +596,8 @@ export default function useHooks({
       deleteLayer,
       findByIds,
       isLayer,
+      isComputedLayer,
+      isTempLayer,
       rootLayers,
       walk,
       find,
@@ -592,6 +615,10 @@ export default function useHooks({
     ],
   );
 
+  useEffect(() => {
+    onMount?.();
+  }, [onMount]);
+
   const prevLayers = useRef<Layer[] | undefined>([]);
   useLayoutEffect(() => {
     const ids = new Set<string>();