@accelint/map-toolkit 1.5.0 → 3.0.0

package/dist/deckgl/shapes/shared/hooks/use-shift-zoom-disable.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -27,8 +27,8 @@ import { useEmit } from "@accelint/bus/react";
 * - Shift for rotation snap during edit
 * - Shift for square constraint during rectangle drawing
 *
-* @param mapId - The map instance ID
-* @param isActive - Whether the hook should be active (e.g., when editing/drawing)
+* @param mapId - The map instance ID.
+* @param isActive - Whether the hook should be active (e.g., when editing/drawing).
 *
 * @example
 * ```typescript
@@ -47,31 +47,34 @@ function useShiftZoomDisable(mapId, isActive) {
 	const emitEnableZoom = useEmit(MapEvents.enableZoom);
 	const isZoomDisabledRef = useRef(false);
 	useEffect(() => {
-		if (!isActive) return;
-		const disableZoom = () => {
+		if (!isActive) {
+			isZoomDisabledRef.current = false;
+			return;
+		}
+		function disableZoom() {
 			if (!isZoomDisabledRef.current) {
 				isZoomDisabledRef.current = true;
 				emitDisableZoom({ id: mapId });
 			}
-		};
-		const enableZoom = () => {
+		}
+		function enableZoom() {
 			if (isZoomDisabledRef.current) {
 				isZoomDisabledRef.current = false;
 				emitEnableZoom({ id: mapId });
 			}
-		};
-		const handleKeyDown = (event) => {
+		}
+		function handleKeyDown(event) {
 			if (event.key === "Shift") disableZoom();
-		};
-		const handleKeyUp = (event) => {
+		}
+		function handleKeyUp(event) {
 			if (event.key === "Shift") enableZoom();
-		};
-		const handleMouseDown = (event) => {
+		}
+		function handleMouseDown(event) {
 			if (event.shiftKey) disableZoom();
-		};
-		const handleBlur = () => {
+		}
+		function handleBlur() {
 			enableZoom();
-		};
+		}
 		document.addEventListener("keydown", handleKeyDown);
 		document.addEventListener("keyup", handleKeyUp);
 		document.addEventListener("mousedown", handleMouseDown, { capture: true });

package/dist/deckgl/shapes/shared/hooks/use-shift-zoom-disable.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-shift-zoom-disable.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/hooks/use-shift-zoom-disable.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { useEmit } from '@accelint/bus/react';\nimport { useEffect, useRef } from 'react';\nimport { MapEvents } from '@/deckgl/base-map/events';\nimport type { UniqueId } from '@accelint/core';\nimport type {\n  MapDisableZoomEvent,\n  MapEnableZoomEvent,\n} from '@/deckgl/base-map/types';\n\n/**\n * Hook to disable map zoom while Shift key is held during shape operations.\n *\n * This prevents MapLibre's boxZoom (Shift+drag) from interfering with\n * Shift modifier constraints like:\n * - Shift for uniform scaling during edit\n * - Shift for rotation snap during edit\n * - Shift for square constraint during rectangle drawing\n *\n * @param mapId - The map instance ID\n * @param isActive - Whether the hook should be active (e.g., when editing/drawing)\n *\n * @example\n * ```typescript\n * function EditShapeLayer({ mapId }) {\n *   const isEditing = editStore.use(mapId).state?.editingShape != null;\n *\n *   // Disable zoom when editing to allow Shift modifiers to work\n *   useShiftZoomDisable(mapId, isEditing);\n *\n *   // ... rest of component\n * }\n * ```\n */\nexport function useShiftZoomDisable(mapId: UniqueId, isActive: boolean): void {\n  const emitDisableZoom = useEmit<MapDisableZoomEvent>(MapEvents.disableZoom);\n  const emitEnableZoom = useEmit<MapEnableZoomEvent>(MapEvents.enableZoom);\n  const isZoomDisabledRef = useRef(false);\n\n  useEffect(() => {\n    if (!isActive) {\n      return;\n    }\n\n    const disableZoom = () => {\n      if (!isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = true;\n        emitDisableZoom({ id: mapId });\n      }\n    };\n\n    const enableZoom = () => {\n      if (isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = false;\n        emitEnableZoom({ id: mapId });\n      }\n    };\n\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key === 'Shift') {\n        disableZoom();\n      }\n    };\n\n    const handleKeyUp = (event: KeyboardEvent) => {\n      if (event.key === 'Shift') {\n        enableZoom();\n      }\n    };\n\n    // Also catch Shift state on mousedown to handle edge cases where\n    // keydown might have been missed (e.g., focus issues)\n    const handleMouseDown = (event: MouseEvent) => {\n      if (event.shiftKey) {\n        disableZoom();\n      }\n    };\n\n    // Re-enable zoom if the window loses focus while Shift is held\n    const handleBlur = () => {\n      enableZoom();\n    };\n\n    document.addEventListener('keydown', handleKeyDown);\n    document.addEventListener('keyup', handleKeyUp);\n    document.addEventListener('mousedown', handleMouseDown, { capture: true });\n    window.addEventListener('blur', handleBlur);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeyDown);\n      document.removeEventListener('keyup', handleKeyUp);\n      document.removeEventListener('mousedown', handleMouseDown, {\n        capture: true,\n      });\n      window.removeEventListener('blur', handleBlur);\n\n      // Ensure zoom is re-enabled when unmounting\n      enableZoom();\n    };\n  }, [isActive, mapId, emitDisableZoom, emitEnableZoom]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,oBAAoB,OAAiB,UAAyB;CAC5E,MAAM,kBAAkB,QAA6B,UAAU,YAAY;CAC3E,MAAM,iBAAiB,QAA4B,UAAU,WAAW;CACxE,MAAM,oBAAoB,OAAO,MAAM;AAEvC,iBAAgB;AACd,MAAI,CAAC,SACH;EAGF,MAAM,oBAAoB;AACxB,OAAI,CAAC,kBAAkB,SAAS;AAC9B,sBAAkB,UAAU;AAC5B,oBAAgB,EAAE,IAAI,OAAO,CAAC;;;EAIlC,MAAM,mBAAmB;AACvB,OAAI,kBAAkB,SAAS;AAC7B,sBAAkB,UAAU;AAC5B,mBAAe,EAAE,IAAI,OAAO,CAAC;;;EAIjC,MAAM,iBAAiB,UAAyB;AAC9C,OAAI,MAAM,QAAQ,QAChB,cAAa;;EAIjB,MAAM,eAAe,UAAyB;AAC5C,OAAI,MAAM,QAAQ,QAChB,aAAY;;EAMhB,MAAM,mBAAmB,UAAsB;AAC7C,OAAI,MAAM,SACR,cAAa;;EAKjB,MAAM,mBAAmB;AACvB,eAAY;;AAGd,WAAS,iBAAiB,WAAW,cAAc;AACnD,WAAS,iBAAiB,SAAS,YAAY;AAC/C,WAAS,iBAAiB,aAAa,iBAAiB,EAAE,SAAS,MAAM,CAAC;AAC1E,SAAO,iBAAiB,QAAQ,WAAW;AAE3C,eAAa;AACX,YAAS,oBAAoB,WAAW,cAAc;AACtD,YAAS,oBAAoB,SAAS,YAAY;AAClD,YAAS,oBAAoB,aAAa,iBAAiB,EACzD,SAAS,MACV,CAAC;AACF,UAAO,oBAAoB,QAAQ,WAAW;AAG9C,eAAY;;IAEb;EAAC;EAAU;EAAO;EAAiB;EAAe,CAAC"}
+{"version":3,"file":"use-shift-zoom-disable.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/hooks/use-shift-zoom-disable.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { useEmit } from '@accelint/bus/react';\nimport { useEffect, useRef } from 'react';\nimport { MapEvents } from '@/deckgl/base-map/events';\nimport type { UniqueId } from '@accelint/core';\nimport type {\n  MapDisableZoomEvent,\n  MapEnableZoomEvent,\n} from '@/deckgl/base-map/types';\n\n/**\n * Hook to disable map zoom while Shift key is held during shape operations.\n *\n * This prevents MapLibre's boxZoom (Shift+drag) from interfering with\n * Shift modifier constraints like:\n * - Shift for uniform scaling during edit\n * - Shift for rotation snap during edit\n * - Shift for square constraint during rectangle drawing\n *\n * @param mapId - The map instance ID.\n * @param isActive - Whether the hook should be active (e.g., when editing/drawing).\n *\n * @example\n * ```typescript\n * function EditShapeLayer({ mapId }) {\n *   const isEditing = editStore.use(mapId).state?.editingShape != null;\n *\n *   // Disable zoom when editing to allow Shift modifiers to work\n *   useShiftZoomDisable(mapId, isEditing);\n *\n *   // ... rest of component\n * }\n * ```\n */\nexport function useShiftZoomDisable(mapId: UniqueId, isActive: boolean): void {\n  const emitDisableZoom = useEmit<MapDisableZoomEvent>(MapEvents.disableZoom);\n  const emitEnableZoom = useEmit<MapEnableZoomEvent>(MapEvents.enableZoom);\n  const isZoomDisabledRef = useRef(false);\n\n  useEffect(() => {\n    if (!isActive) {\n      isZoomDisabledRef.current = false;\n\n      return;\n    }\n\n    function disableZoom(): void {\n      if (!isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = true;\n        emitDisableZoom({ id: mapId });\n      }\n    }\n\n    function enableZoom(): void {\n      if (isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = false;\n        emitEnableZoom({ id: mapId });\n      }\n    }\n\n    function handleKeyDown(event: KeyboardEvent): void {\n      if (event.key === 'Shift') {\n        disableZoom();\n      }\n    }\n\n    function handleKeyUp(event: KeyboardEvent): void {\n      if (event.key === 'Shift') {\n        enableZoom();\n      }\n    }\n\n    // Also catch Shift state on mousedown to handle edge cases where\n    // keydown might have been missed (e.g., focus issues)\n    function handleMouseDown(event: MouseEvent): void {\n      if (event.shiftKey) {\n        disableZoom();\n      }\n    }\n\n    // Re-enable zoom if the window loses focus while Shift is held\n    function handleBlur(): void {\n      enableZoom();\n    }\n\n    document.addEventListener('keydown', handleKeyDown);\n    document.addEventListener('keyup', handleKeyUp);\n    document.addEventListener('mousedown', handleMouseDown, { capture: true });\n    window.addEventListener('blur', handleBlur);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeyDown);\n      document.removeEventListener('keyup', handleKeyUp);\n      document.removeEventListener('mousedown', handleMouseDown, {\n        capture: true,\n      });\n      window.removeEventListener('blur', handleBlur);\n\n      // Ensure zoom is re-enabled when unmounting\n      enableZoom();\n    };\n  }, [isActive, mapId, emitDisableZoom, emitEnableZoom]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,oBAAoB,OAAiB,UAAyB;CAC5E,MAAM,kBAAkB,QAA6B,UAAU,YAAY;CAC3E,MAAM,iBAAiB,QAA4B,UAAU,WAAW;CACxE,MAAM,oBAAoB,OAAO,MAAM;AAEvC,iBAAgB;AACd,MAAI,CAAC,UAAU;AACb,qBAAkB,UAAU;AAE5B;;EAGF,SAAS,cAAoB;AAC3B,OAAI,CAAC,kBAAkB,SAAS;AAC9B,sBAAkB,UAAU;AAC5B,oBAAgB,EAAE,IAAI,OAAO,CAAC;;;EAIlC,SAAS,aAAmB;AAC1B,OAAI,kBAAkB,SAAS;AAC7B,sBAAkB,UAAU;AAC5B,mBAAe,EAAE,IAAI,OAAO,CAAC;;;EAIjC,SAAS,cAAc,OAA4B;AACjD,OAAI,MAAM,QAAQ,QAChB,cAAa;;EAIjB,SAAS,YAAY,OAA4B;AAC/C,OAAI,MAAM,QAAQ,QAChB,aAAY;;EAMhB,SAAS,gBAAgB,OAAyB;AAChD,OAAI,MAAM,SACR,cAAa;;EAKjB,SAAS,aAAmB;AAC1B,eAAY;;AAGd,WAAS,iBAAiB,WAAW,cAAc;AACnD,WAAS,iBAAiB,SAAS,YAAY;AAC/C,WAAS,iBAAiB,aAAa,iBAAiB,EAAE,SAAS,MAAM,CAAC;AAC1E,SAAO,iBAAiB,QAAQ,WAAW;AAE3C,eAAa;AACX,YAAS,oBAAoB,WAAW,cAAc;AACtD,YAAS,oBAAoB,SAAS,YAAY;AAClD,YAAS,oBAAoB,aAAa,iBAAiB,EACzD,SAAS,MACV,CAAC;AACF,UAAO,oBAAoB,QAAQ,WAAW;AAG9C,eAAY;;IAEb;EAAC;EAAU;EAAO;EAAiB;EAAe,CAAC"}

package/dist/deckgl/shapes/shared/types.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -10,10 +10,10 @@
  * governing permissions and limitations under the License.
  */
 
-import { DistanceUnit } from "../../../shared/units.js";
 import { UniqueId } from "@accelint/core";
 import { Color } from "@deck.gl/core";
-import { Feature, LineString, Point, Polygon } from "geojson";
+import { DistanceUnit } from "@accelint/constants/units";
+import { Feature, Geometry, GeometryCollection, LineString, MultiLineString, MultiPoint, MultiPolygon, Point, Polygon } from "geojson";
 
 //#region src/deckgl/shapes/shared/types.d.ts
 /**
@@ -27,6 +27,7 @@ declare const ShapeFeatureType: {
   readonly LineString: "LineString";
   readonly Point: "Point";
 };
+/** Union of all supported shape feature type string literals. */
 type ShapeFeatureType = (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType];
 /**
  * Shape ID type - uses UniqueId from core
@@ -45,7 +46,7 @@ type LinePattern = 'solid' | 'dashed' | 'dotted';
 /**
  * Style properties for rendering shapes
  */
-interface StyleProperties {
+type StyleProperties = {
   /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */
   fillColor: Color;
   /** Border/outline color as RGBA array [r, g, b, a] where each value is 0-255 */
@@ -79,14 +80,21 @@ interface StyleProperties {
   labelHorizontalAnchor?: 'left' | 'center' | 'right';
   /** Optional custom label coordinate anchor (position along geometry) */
   labelCoordinateAnchor?: 'center' | 'start' | 'middle' | 'end' | 'top' | 'right' | 'bottom' | 'left';
-}
+};
+/**
+ * Geographic position as [longitude, latitude] with optional elevation.
+ *
+ * Similar to GeoJSON's `Position` (`number[]`) but with stricter typing
+ * that guarantees at least two elements.
+ */
+type GeoPosition = [number, number] | [number, number, number];
 /**
  * Circle-specific properties for precise rendering
  * Stored alongside the polygon approximation
  */
-interface CircleProperties {
-  /** Center point as [longitude, latitude] */
-  center: [number, number];
+type CircleProperties = {
+  /** Center point as [longitude, latitude] or [longitude, latitude, elevation] */
+  center: GeoPosition;
   /** Radius with value and units */
   radius: {
     /** Radius value */
@@ -94,14 +102,14 @@ interface CircleProperties {
     /** Units for the radius measurement */
     units: DistanceUnit;
   };
-}
+};
 /**
  * Ellipse-specific properties for precise rendering
  * Stored alongside the polygon approximation
  */
-interface EllipseProperties {
-  /** Center point as [longitude, latitude] */
-  center: [number, number];
+type EllipseProperties = {
+  /** Center point as [longitude, latitude] or [longitude, latitude, elevation] */
+  center: GeoPosition;
   /** X semi-axis (horizontal radius) with value and units */
   xSemiAxis: {
     /** X semi-axis value */
@@ -118,11 +126,7 @@ interface EllipseProperties {
   };
   /** Rotation angle in degrees */
   angle: number;
-}
-/**
- * Custom geometry types supported
- */
-type CustomGeometry = Point | LineString | Polygon;
+};
 /**
  * Properties for styled features.
  *
@@ -130,7 +134,7 @@ type CustomGeometry = Point | LineString | Polygon;
  * but are guaranteed to be present for their respective shape types.
  * Use the type guards (isCircleShape, isEllipseShape) for type narrowing.
  */
-interface StyledFeatureProperties {
+type StyledFeatureProperties = {
   /** Style properties for rendering */
   styleProperties: StyleProperties;
   /** Shape ID for correlation */
@@ -139,33 +143,37 @@ interface StyledFeatureProperties {
   circleProperties?: CircleProperties;
   /** Ellipse properties (present for Ellipse shapes) */
   ellipseProperties?: EllipseProperties;
-}
+  /** Minimum elevation in meters (optional) */
+  minElevation?: number;
+  /** Maximum elevation in meters (optional) */
+  maxElevation?: number;
+};
 /**
  * Feature properties for Circle shapes (circleProperties required).
  * Used by CircleShape for better type narrowing.
  */
-interface CircleFeatureProperties extends StyledFeatureProperties {
+type CircleFeatureProperties = StyledFeatureProperties & {
   /** Circle properties (required for Circle shapes) */
   circleProperties: CircleProperties;
-}
+};
 /**
  * Feature properties for Ellipse shapes (ellipseProperties required).
  * Used by EllipseShape for better type narrowing.
  */
-interface EllipseFeatureProperties extends StyledFeatureProperties {
+type EllipseFeatureProperties = StyledFeatureProperties & {
   /** Ellipse properties (required for Ellipse shapes) */
   ellipseProperties: EllipseProperties;
-}
+};
 /**
  * GeoJSON Feature with style properties
  */
-interface StyledFeature extends Feature {
+type StyledFeature = Feature & {
   properties: StyledFeatureProperties;
-}
+};
 /**
- * Base shape properties shared by all shapes
+ * Base shape properties shared by all shapes.
  */
-interface BaseShape {
+type BaseShape = {
   /** Unique identifier */
   id: ShapeId;
   /** Full shape name used internally and in UI */
@@ -185,53 +193,53 @@ interface BaseShape {
    * Locked shapes cannot be modified due to data restrictions or user preference
    */
   locked?: boolean;
-}
+};
 /**
  * Circle shape with required circleProperties
  */
-interface CircleShape extends BaseShape {
+type CircleShape = BaseShape & {
   shape: typeof ShapeFeatureType.Circle;
   feature: StyledFeature & {
     properties: CircleFeatureProperties;
   };
-}
+};
 /**
  * Ellipse shape with required ellipseProperties
  */
-interface EllipseShape extends BaseShape {
+type EllipseShape = BaseShape & {
   shape: typeof ShapeFeatureType.Ellipse;
   feature: StyledFeature & {
     properties: EllipseFeatureProperties;
   };
-}
+};
 /**
  * Polygon shape
  */
-interface PolygonShape extends BaseShape {
+type PolygonShape = BaseShape & {
   shape: typeof ShapeFeatureType.Polygon;
   feature: StyledFeature;
-}
+};
 /**
  * Rectangle shape
  */
-interface RectangleShape extends BaseShape {
+type RectangleShape = BaseShape & {
   shape: typeof ShapeFeatureType.Rectangle;
   feature: StyledFeature;
-}
+};
 /**
  * LineString shape
  */
-interface LineStringShape extends BaseShape {
+type LineStringShape = BaseShape & {
   shape: typeof ShapeFeatureType.LineString;
   feature: StyledFeature;
-}
+};
 /**
  * Point shape
  */
-interface PointShape extends BaseShape {
+type PointShape = BaseShape & {
   shape: typeof ShapeFeatureType.Point;
   feature: StyledFeature;
-}
+};
 /**
  * Discriminated union of all shape types.
  *
@@ -247,10 +255,6 @@ interface PointShape extends BaseShape {
  * ```
  */
 type Shape = CircleShape | EllipseShape | PolygonShape | RectangleShape | LineStringShape | PointShape;
-/**
- * Alias for ShapeFeatureType values
- */
-type ShapeFeatureTypeValues = ShapeFeatureType;
 /**
  * Alias for StyledFeature (shape feature)
  */
@@ -263,18 +267,12 @@ type ShapeFeatureProperties = StyledFeature['properties'];
  * Circle radius type
  */
 type CircleRadius = CircleProperties['radius'];
-/**
- * Coordinate as [longitude, latitude]
- */
-type Coordinate = [number, number];
-/**
- * Function type for subscription (useSyncExternalStore pattern).
- * Used by draw-shape-layer and edit-shape-layer stores.
- */
-type Subscription = (onStoreChange: () => void) => () => void;
 /**
  * Type guard for Circle shapes.
  *
+ * @param shape - The shape to test.
+ * @returns True if shape is a CircleShape.
+ *
  * @example
  * ```typescript
  * if (isCircleShape(shape)) {
@@ -287,6 +285,9 @@ declare function isCircleShape(shape: Shape): shape is CircleShape;
 /**
  * Type guard for Ellipse shapes.
  *
+ * @param shape - The shape to test.
+ * @returns True if shape is an EllipseShape.
+ *
  * @example
  * ```typescript
  * if (isEllipseShape(shape)) {
@@ -298,20 +299,147 @@ declare function isCircleShape(shape: Shape): shape is CircleShape;
 declare function isEllipseShape(shape: Shape): shape is EllipseShape;
 /**
  * Type guard for Polygon shapes.
+ *
+ * @param shape - The shape to test
+ * @returns True if shape is a PolygonShape
+ * @example
+ * ```typescript
+ * if (isPolygonShape(shape)) {
+ *   // TypeScript narrows shape to PolygonShape
+ * }
+ * ```
  */
 declare function isPolygonShape(shape: Shape): shape is PolygonShape;
 /**
  * Type guard for Rectangle shapes.
+ *
+ * @param shape - The shape to test
+ * @returns True if shape is a RectangleShape
+ * @example
+ * ```typescript
+ * if (isRectangleShape(shape)) {
+ *   // TypeScript narrows shape to RectangleShape
+ * }
+ * ```
  */
 declare function isRectangleShape(shape: Shape): shape is RectangleShape;
 /**
  * Type guard for LineString shapes.
+ *
+ * @param shape - The shape to test
+ * @returns True if shape is a LineStringShape
+ * @example
+ * ```typescript
+ * if (isLineStringShape(shape)) {
+ *   // TypeScript narrows shape to LineStringShape
+ * }
+ * ```
  */
 declare function isLineStringShape(shape: Shape): shape is LineStringShape;
 /**
  * Type guard for Point shapes.
+ *
+ * @param shape - The shape to test
+ * @returns True if shape is a PointShape
+ * @example
+ * ```typescript
+ * if (isPointShape(shape)) {
+ *   // TypeScript narrows shape to PointShape
+ * }
+ * ```
  */
 declare function isPointShape(shape: Shape): shape is PointShape;
+/**
+ * Narrow a GeoJSON geometry to the Point type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a Point.
+ */
+declare function isPointType(geometry: Geometry): geometry is Point;
+/**
+ * Narrow a GeoJSON geometry to the MultiPoint type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a MultiPoint.
+ */
+declare function isMultiPointType(geometry: Geometry): geometry is MultiPoint;
+/**
+ * Narrow a GeoJSON geometry to the LineString type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a LineString.
+ */
+declare function isLineStringType(geometry: Geometry): geometry is LineString;
+/**
+ * Narrow a GeoJSON geometry to the MultiLineString type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a MultiLineString.
+ */
+declare function isMultiLineStringType(geometry: Geometry): geometry is MultiLineString;
+/**
+ * Narrow a GeoJSON geometry to the Polygon type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a Polygon.
+ */
+declare function isPolygonType(geometry: Geometry): geometry is Polygon;
+/**
+ * Narrow a GeoJSON geometry to the MultiPolygon type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a MultiPolygon.
+ */
+declare function isMultiPolygonType(geometry: Geometry): geometry is MultiPolygon;
+/**
+ * Narrow a GeoJSON geometry to the GeometryCollection type.
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a GeometryCollection.
+ */
+declare function isGeometryCollectionType(geometry: Geometry): geometry is GeometryCollection;
+/**
+ * Narrow a GeoJSON geometry to polygon-like types (Polygon or MultiPolygon).
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a Polygon or MultiPolygon.
+ *
+ * @example
+ * ```typescript
+ * if (isPolygonGeometry(feature.geometry)) {
+ *   // geometry narrowed to Polygon | MultiPolygon
+ * }
+ * ```
+ */
+declare function isPolygonGeometry(geometry: Geometry): geometry is Polygon | MultiPolygon;
+/**
+ * Narrow a GeoJSON geometry to line-like types (LineString or MultiLineString).
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a LineString or MultiLineString.
+ *
+ * @example
+ * ```typescript
+ * if (isLineGeometry(feature.geometry)) {
+ *   // geometry narrowed to LineString | MultiLineString
+ * }
+ * ```
+ */
+declare function isLineGeometry(geometry: Geometry): geometry is LineString | MultiLineString;
+/**
+ * Narrow a GeoJSON geometry to point-like types (Point or MultiPoint).
+ *
+ * @param geometry - The GeoJSON geometry to test.
+ * @returns True if the geometry is a Point or MultiPoint.
+ *
+ * @example
+ * ```typescript
+ * if (isPointGeometry(feature.geometry)) {
+ *   // geometry narrowed to Point | MultiPoint
+ * }
+ * ```
+ */
+declare function isPointGeometry(geometry: Geometry): geometry is Point | MultiPoint;
 //#endregion
-export { CircleFeatureProperties, CircleProperties, CircleRadius, CircleShape, Coordinate, CustomGeometry, EllipseFeatureProperties, EllipseProperties, EllipseShape, LinePattern, LineStringShape, LineWidth, PointShape, PolygonShape, RectangleShape, Shape, ShapeFeature, ShapeFeatureProperties, ShapeFeatureType, ShapeFeatureTypeValues, ShapeId, StyleProperties, StyledFeature, StyledFeatureProperties, Subscription, isCircleShape, isEllipseShape, isLineStringShape, isPointShape, isPolygonShape, isRectangleShape };
+export { CircleFeatureProperties, CircleProperties, CircleRadius, CircleShape, EllipseFeatureProperties, EllipseProperties, EllipseShape, GeoPosition, LinePattern, LineStringShape, LineWidth, PointShape, PolygonShape, RectangleShape, Shape, ShapeFeature, ShapeFeatureProperties, ShapeFeatureType, ShapeId, StyleProperties, StyledFeature, StyledFeatureProperties, isCircleShape, isEllipseShape, isGeometryCollectionType, isLineGeometry, isLineStringShape, isLineStringType, isMultiLineStringType, isMultiPointType, isMultiPolygonType, isPointGeometry, isPointShape, isPointType, isPolygonGeometry, isPolygonShape, isPolygonType, isRectangleShape };
 //# sourceMappingURL=types.d.ts.map