@accelint/map-toolkit 0.6.0 → 1.0.0

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

@@ -10,6 +10,7 @@
  * 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";
@@ -20,7 +21,9 @@ import { Feature, LineString, Point, Polygon } from "geojson";
  */
 declare const ShapeFeatureType: {
   readonly Circle: "Circle";
+  readonly Ellipse: "Ellipse";
   readonly Polygon: "Polygon";
+  readonly Rectangle: "Rectangle";
   readonly LineString: "LineString";
   readonly Point: "Point";
 };
@@ -30,25 +33,27 @@ type ShapeFeatureType = (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType]
  */
 type ShapeId = UniqueId;
 /**
- * Stroke width options (in pixels)
+ * Border/outline width options (in pixels).
+ * Controls the width of shape outlines.
  */
-type StrokeWidth = 1 | 2 | 4 | 8;
+type LineWidth = 1 | 2 | 4 | 8;
 /**
- * Stroke pattern options
+ * Border/outline pattern options.
+ * Controls how shape outlines are rendered.
  */
-type StrokePattern = 'solid' | 'dashed' | 'dotted';
+type LinePattern = 'solid' | 'dashed' | 'dotted';
 /**
  * Style properties for rendering shapes
  */
 interface StyleProperties {
   /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */
   fillColor: Color;
-  /** Stroke color as RGBA array [r, g, b, a] where each value is 0-255 */
-  strokeColor: Color;
-  /** Stroke width in pixels */
-  strokeWidth: StrokeWidth;
-  /** Stroke pattern */
-  strokePattern: StrokePattern;
+  /** Border/outline color as RGBA array [r, g, b, a] where each value is 0-255 */
+  lineColor: Color;
+  /** Border/outline width in pixels */
+  lineWidth: LineWidth;
+  /** Border/outline pattern (solid, dashed, or dotted) */
+  linePattern: LinePattern;
   /** Optional icon properties for Point geometries */
   icon?: {
     /** Icon atlas URL or data */
@@ -86,31 +91,81 @@ interface CircleProperties {
   radius: {
     /** Radius value */
     value: number;
-    /** Units (hardcoded to kilometers for v1) */
-    units: 'kilometers';
+    /** 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];
+  /** X semi-axis (horizontal radius) with value and units */
+  xSemiAxis: {
+    /** X semi-axis value */
+    value: number;
+    /** Units for the measurement */
+    units: DistanceUnit;
+  };
+  /** Y semi-axis (vertical radius) with value and units */
+  ySemiAxis: {
+    /** Y semi-axis value */
+    value: number;
+    /** Units for the measurement */
+    units: DistanceUnit;
+  };
+  /** Rotation angle in degrees */
+  angle: number;
+}
 /**
  * Custom geometry types supported
  */
 type CustomGeometry = Point | LineString | Polygon;
+/**
+ * Properties for styled features.
+ *
+ * Note: circleProperties and ellipseProperties are optional at the type level
+ * but are guaranteed to be present for their respective shape types.
+ * Use the type guards (isCircleShape, isEllipseShape) for type narrowing.
+ */
+interface StyledFeatureProperties {
+  /** Style properties for rendering */
+  styleProperties: StyleProperties;
+  /** Shape ID for correlation */
+  shapeId?: ShapeId;
+  /** Circle properties (present for Circle shapes) */
+  circleProperties?: CircleProperties;
+  /** Ellipse properties (present for Ellipse shapes) */
+  ellipseProperties?: EllipseProperties;
+}
+/**
+ * Feature properties for Circle shapes (circleProperties required).
+ * Used by CircleShape for better type narrowing.
+ */
+interface CircleFeatureProperties extends 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 {
+  /** Ellipse properties (required for Ellipse shapes) */
+  ellipseProperties: EllipseProperties;
+}
 /**
  * GeoJSON Feature with style properties
  */
 interface StyledFeature extends Feature {
-  properties: {
-    /** Style properties for rendering */
-    styleProperties: StyleProperties;
-    /** Circle properties (only for Circle type shapes) */
-    circleProperties?: CircleProperties;
-    /** Shape ID for correlation */
-    shapeId?: ShapeId;
-  };
+  properties: StyledFeatureProperties;
 }
 /**
- * Shape data structure for DisplayShapeLayer
+ * Base shape properties shared by all shapes
  */
-interface DisplayShape {
+interface BaseShape {
   /** Unique identifier */
   id: ShapeId;
   /** Full shape name used internally and in UI */
@@ -121,18 +176,77 @@ interface DisplayShape {
    * Useful for showing abbreviated text on the map (e.g., "NYC" vs "New York City Office")
    */
   label?: string;
-  /** Shape type */
-  shapeType: ShapeFeatureTypeValues;
   /** GeoJSON feature with geometry and style properties */
   feature: ShapeFeature;
   /** UTC timestamp (only set when saved) */
   lastUpdated?: number;
+  /**
+   * Whether the shape is locked for editing
+   * Locked shapes cannot be modified due to data restrictions or user preference
+   */
+  locked?: boolean;
+}
+/**
+ * Circle shape with required circleProperties
+ */
+interface CircleShape extends BaseShape {
+  shape: typeof ShapeFeatureType.Circle;
+  feature: StyledFeature & {
+    properties: CircleFeatureProperties;
+  };
+}
+/**
+ * Ellipse shape with required ellipseProperties
+ */
+interface EllipseShape extends BaseShape {
+  shape: typeof ShapeFeatureType.Ellipse;
+  feature: StyledFeature & {
+    properties: EllipseFeatureProperties;
+  };
+}
+/**
+ * Polygon shape
+ */
+interface PolygonShape extends BaseShape {
+  shape: typeof ShapeFeatureType.Polygon;
+  feature: StyledFeature;
 }
 /**
- * Alias for backward compatibility
- * @deprecated Use DisplayShape instead
+ * Rectangle shape
  */
-type EditableShape = DisplayShape;
+interface RectangleShape extends BaseShape {
+  shape: typeof ShapeFeatureType.Rectangle;
+  feature: StyledFeature;
+}
+/**
+ * LineString shape
+ */
+interface LineStringShape extends BaseShape {
+  shape: typeof ShapeFeatureType.LineString;
+  feature: StyledFeature;
+}
+/**
+ * Point shape
+ */
+interface PointShape extends BaseShape {
+  shape: typeof ShapeFeatureType.Point;
+  feature: StyledFeature;
+}
+/**
+ * Discriminated union of all shape types.
+ *
+ * Use this for type narrowing based on shape:
+ * @example
+ * ```ts
+ * function handleShape(shape: Shape) {
+ *   if (shape.shape === 'Circle') {
+ *     // TypeScript knows shape.feature.properties.circleProperties exists
+ *     const { center, radius } = shape.feature.properties.circleProperties;
+ *   }
+ * }
+ * ```
+ */
+type Shape = CircleShape | EllipseShape | PolygonShape | RectangleShape | LineStringShape | PointShape;
 /**
  * Alias for ShapeFeatureType values
  */
@@ -153,6 +267,51 @@ 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.
+ *
+ * @example
+ * ```ts
+ * if (isCircleShape(shape)) {
+ *   // shape.feature.properties.circleProperties is available
+ *   const { center, radius } = shape.feature.properties.circleProperties;
+ * }
+ * ```
+ */
+declare function isCircleShape(shape: Shape): shape is CircleShape;
+/**
+ * Type guard for Ellipse shapes.
+ *
+ * @example
+ * ```ts
+ * if (isEllipseShape(shape)) {
+ *   // shape.feature.properties.ellipseProperties is available
+ *   const { center, xSemiAxis, ySemiAxis } = shape.feature.properties.ellipseProperties;
+ * }
+ * ```
+ */
+declare function isEllipseShape(shape: Shape): shape is EllipseShape;
+/**
+ * Type guard for Polygon shapes.
+ */
+declare function isPolygonShape(shape: Shape): shape is PolygonShape;
+/**
+ * Type guard for Rectangle shapes.
+ */
+declare function isRectangleShape(shape: Shape): shape is RectangleShape;
+/**
+ * Type guard for LineString shapes.
+ */
+declare function isLineStringShape(shape: Shape): shape is LineStringShape;
+/**
+ * Type guard for Point shapes.
+ */
+declare function isPointShape(shape: Shape): shape is PointShape;
 //#endregion
-export { CircleProperties, CircleRadius, Coordinate, CustomGeometry, DisplayShape, EditableShape, ShapeFeature, ShapeFeatureProperties, ShapeFeatureType, ShapeFeatureTypeValues, ShapeId, StrokePattern, StrokeWidth, StyleProperties, StyledFeature };
+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 };
 //# sourceMappingURL=types.d.ts.map

package/dist/deckgl/shapes/shared/types.js

@@ -19,11 +19,65 @@
 */
 const ShapeFeatureType = {
 	Circle: "Circle",
+	Ellipse: "Ellipse",
 	Polygon: "Polygon",
+	Rectangle: "Rectangle",
 	LineString: "LineString",
 	Point: "Point"
 };
+/**
+* Type guard for Circle shapes.
+*
+* @example
+* ```ts
+* if (isCircleShape(shape)) {
+*   // shape.feature.properties.circleProperties is available
+*   const { center, radius } = shape.feature.properties.circleProperties;
+* }
+* ```
+*/
+function isCircleShape(shape) {
+	return shape.shape === ShapeFeatureType.Circle;
+}
+/**
+* Type guard for Ellipse shapes.
+*
+* @example
+* ```ts
+* if (isEllipseShape(shape)) {
+*   // shape.feature.properties.ellipseProperties is available
+*   const { center, xSemiAxis, ySemiAxis } = shape.feature.properties.ellipseProperties;
+* }
+* ```
+*/
+function isEllipseShape(shape) {
+	return shape.shape === ShapeFeatureType.Ellipse;
+}
+/**
+* Type guard for Polygon shapes.
+*/
+function isPolygonShape(shape) {
+	return shape.shape === ShapeFeatureType.Polygon;
+}
+/**
+* Type guard for Rectangle shapes.
+*/
+function isRectangleShape(shape) {
+	return shape.shape === ShapeFeatureType.Rectangle;
+}
+/**
+* Type guard for LineString shapes.
+*/
+function isLineStringShape(shape) {
+	return shape.shape === ShapeFeatureType.LineString;
+}
+/**
+* Type guard for Point shapes.
+*/
+function isPointShape(shape) {
+	return shape.shape === ShapeFeatureType.Point;
+}
 
 //#endregion
-export { ShapeFeatureType };
+export { ShapeFeatureType, isCircleShape, isEllipseShape, isLineStringShape, isPointShape, isPolygonShape, isRectangleShape };
 //# sourceMappingURL=types.js.map

package/dist/deckgl/shapes/shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../../src/deckgl/shapes/shared/types.ts"],"sourcesContent":["/*\n * Copyright 2025 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 type { UniqueId } from '@accelint/core';\nimport type { Color } from '@deck.gl/core';\nimport type { Feature, LineString, Point, Polygon } from 'geojson';\n\n/**\n * Supported shape types\n */\nexport const ShapeFeatureType = {\n  Circle: 'Circle',\n  Polygon: 'Polygon',\n  LineString: 'LineString',\n  Point: 'Point',\n} as const;\n\nexport type ShapeFeatureType =\n  (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType];\n\n/**\n * Shape ID type - uses UniqueId from core\n */\nexport type ShapeId = UniqueId;\n\n/**\n * Stroke width options (in pixels)\n */\nexport type StrokeWidth = 1 | 2 | 4 | 8;\n\n/**\n * Stroke pattern options\n */\nexport type StrokePattern = 'solid' | 'dashed' | 'dotted';\n\n/**\n * Style properties for rendering shapes\n */\nexport interface StyleProperties {\n  /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */\n  fillColor: Color;\n  /** Stroke color as RGBA array [r, g, b, a] where each value is 0-255 */\n  strokeColor: Color;\n  /** Stroke width in pixels */\n  strokeWidth: StrokeWidth;\n  /** Stroke pattern */\n  strokePattern: StrokePattern;\n  /** Optional icon properties for Point geometries */\n  icon?: {\n    /** Icon atlas URL or data */\n    atlas?: string;\n    /** Icon mapping (name to position in atlas) */\n    mapping?: Record<\n      string,\n      { x: number; y: number; width: number; height: number; mask?: boolean }\n    >;\n    /** Icon name to use from mapping */\n    name?: string;\n    /** Icon size in pixels */\n    size?: number;\n  };\n  /** Optional custom label pixel offset [x, y] */\n  labelOffset?: [number, number];\n  /** Optional custom label vertical anchor */\n  labelVerticalAnchor?: 'top' | 'middle' | 'bottom';\n  /** Optional custom label horizontal anchor */\n  labelHorizontalAnchor?: 'left' | 'center' | 'right';\n  /** Optional custom label coordinate anchor (position along geometry) */\n  labelCoordinateAnchor?:\n    | 'center'\n    | 'start'\n    | 'middle'\n    | 'end'\n    | 'top'\n    | 'right'\n    | 'bottom'\n    | 'left';\n}\n\n/**\n * Circle-specific properties for precise rendering\n * Stored alongside the polygon approximation\n */\nexport interface CircleProperties {\n  /** Center point as [longitude, latitude] */\n  center: [number, number];\n  /** Radius with value and units */\n  radius: {\n    /** Radius value */\n    value: number;\n    /** Units (hardcoded to kilometers for v1) */\n    units: 'kilometers';\n  };\n}\n\n/**\n * Custom geometry types supported\n */\nexport type CustomGeometry = Point | LineString | Polygon;\n\n/**\n * GeoJSON Feature with style properties\n */\nexport interface StyledFeature extends Feature {\n  properties: {\n    /** Style properties for rendering */\n    styleProperties: StyleProperties;\n    /** Circle properties (only for Circle type shapes) */\n    circleProperties?: CircleProperties;\n    /** Shape ID for correlation */\n    shapeId?: ShapeId;\n  };\n}\n\n/**\n * Shape data structure for DisplayShapeLayer\n */\nexport interface DisplayShape {\n  /** Unique identifier */\n  id: ShapeId;\n  /** Full shape name used internally and in UI */\n  name: string;\n  /**\n   * Optional short display label shown on the map\n   * If not provided, the `name` property will be used instead\n   * Useful for showing abbreviated text on the map (e.g., \"NYC\" vs \"New York City Office\")\n   */\n  label?: string;\n  /** Shape type */\n  shapeType: ShapeFeatureTypeValues;\n  /** GeoJSON feature with geometry and style properties */\n  feature: ShapeFeature;\n  /** UTC timestamp (only set when saved) */\n  lastUpdated?: number;\n}\n\n/**\n * Alias for backward compatibility\n * @deprecated Use DisplayShape instead\n */\nexport type EditableShape = DisplayShape;\n\n/**\n * Alias for ShapeFeatureType values\n */\nexport type ShapeFeatureTypeValues = ShapeFeatureType;\n\n/**\n * Alias for StyledFeature (shape feature)\n */\nexport type ShapeFeature = StyledFeature;\n\n/**\n * Alias for StyledFeature properties\n */\nexport type ShapeFeatureProperties = StyledFeature['properties'];\n\n/**\n * Circle radius type\n */\nexport type CircleRadius = CircleProperties['radius'];\n\n/**\n * Coordinate as [longitude, latitude]\n */\nexport type Coordinate = [number, number];\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,SAAS;CACT,YAAY;CACZ,OAAO;CACR"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/deckgl/shapes/shared/types.ts"],"sourcesContent":["/*\n * Copyright 2025 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 type { UniqueId } from '@accelint/core';\nimport type { Color } from '@deck.gl/core';\nimport type { Feature, LineString, Point, Polygon } from 'geojson';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Supported shape types\n */\nexport const ShapeFeatureType = {\n  Circle: 'Circle',\n  Ellipse: 'Ellipse',\n  Polygon: 'Polygon',\n  Rectangle: 'Rectangle',\n  LineString: 'LineString',\n  Point: 'Point',\n} as const;\n\nexport type ShapeFeatureType =\n  (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType];\n\n/**\n * Shape ID type - uses UniqueId from core\n */\nexport type ShapeId = UniqueId;\n\n/**\n * Border/outline width options (in pixels).\n * Controls the width of shape outlines.\n */\nexport type LineWidth = 1 | 2 | 4 | 8;\n\n/**\n * Border/outline pattern options.\n * Controls how shape outlines are rendered.\n */\nexport type LinePattern = 'solid' | 'dashed' | 'dotted';\n\n/**\n * Style properties for rendering shapes\n */\nexport interface StyleProperties {\n  /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */\n  fillColor: Color;\n  /** Border/outline color as RGBA array [r, g, b, a] where each value is 0-255 */\n  lineColor: Color;\n  /** Border/outline width in pixels */\n  lineWidth: LineWidth;\n  /** Border/outline pattern (solid, dashed, or dotted) */\n  linePattern: LinePattern;\n  /** Optional icon properties for Point geometries */\n  icon?: {\n    /** Icon atlas URL or data */\n    atlas?: string;\n    /** Icon mapping (name to position in atlas) */\n    mapping?: Record<\n      string,\n      { x: number; y: number; width: number; height: number; mask?: boolean }\n    >;\n    /** Icon name to use from mapping */\n    name?: string;\n    /** Icon size in pixels */\n    size?: number;\n  };\n  /** Optional custom label pixel offset [x, y] */\n  labelOffset?: [number, number];\n  /** Optional custom label vertical anchor */\n  labelVerticalAnchor?: 'top' | 'middle' | 'bottom';\n  /** Optional custom label horizontal anchor */\n  labelHorizontalAnchor?: 'left' | 'center' | 'right';\n  /** Optional custom label coordinate anchor (position along geometry) */\n  labelCoordinateAnchor?:\n    | 'center'\n    | 'start'\n    | 'middle'\n    | 'end'\n    | 'top'\n    | 'right'\n    | 'bottom'\n    | 'left';\n}\n\n/**\n * Circle-specific properties for precise rendering\n * Stored alongside the polygon approximation\n */\nexport interface CircleProperties {\n  /** Center point as [longitude, latitude] */\n  center: [number, number];\n  /** Radius with value and units */\n  radius: {\n    /** Radius value */\n    value: number;\n    /** Units for the radius measurement */\n    units: DistanceUnit;\n  };\n}\n\n/**\n * Ellipse-specific properties for precise rendering\n * Stored alongside the polygon approximation\n */\nexport interface EllipseProperties {\n  /** Center point as [longitude, latitude] */\n  center: [number, number];\n  /** X semi-axis (horizontal radius) with value and units */\n  xSemiAxis: {\n    /** X semi-axis value */\n    value: number;\n    /** Units for the measurement */\n    units: DistanceUnit;\n  };\n  /** Y semi-axis (vertical radius) with value and units */\n  ySemiAxis: {\n    /** Y semi-axis value */\n    value: number;\n    /** Units for the measurement */\n    units: DistanceUnit;\n  };\n  /** Rotation angle in degrees */\n  angle: number;\n}\n\n/**\n * Custom geometry types supported\n */\nexport type CustomGeometry = Point | LineString | Polygon;\n\n/**\n * Properties for styled features.\n *\n * Note: circleProperties and ellipseProperties are optional at the type level\n * but are guaranteed to be present for their respective shape types.\n * Use the type guards (isCircleShape, isEllipseShape) for type narrowing.\n */\nexport interface StyledFeatureProperties {\n  /** Style properties for rendering */\n  styleProperties: StyleProperties;\n  /** Shape ID for correlation */\n  shapeId?: ShapeId;\n  /** Circle properties (present for Circle shapes) */\n  circleProperties?: CircleProperties;\n  /** Ellipse properties (present for Ellipse shapes) */\n  ellipseProperties?: EllipseProperties;\n}\n\n/**\n * Feature properties for Circle shapes (circleProperties required).\n * Used by CircleShape for better type narrowing.\n */\nexport interface CircleFeatureProperties extends StyledFeatureProperties {\n  /** Circle properties (required for Circle shapes) */\n  circleProperties: CircleProperties;\n}\n\n/**\n * Feature properties for Ellipse shapes (ellipseProperties required).\n * Used by EllipseShape for better type narrowing.\n */\nexport interface EllipseFeatureProperties extends StyledFeatureProperties {\n  /** Ellipse properties (required for Ellipse shapes) */\n  ellipseProperties: EllipseProperties;\n}\n\n/**\n * GeoJSON Feature with style properties\n */\nexport interface StyledFeature extends Feature {\n  properties: StyledFeatureProperties;\n}\n\n/**\n * Base shape properties shared by all shapes\n */\ninterface BaseShape {\n  /** Unique identifier */\n  id: ShapeId;\n  /** Full shape name used internally and in UI */\n  name: string;\n  /**\n   * Optional short display label shown on the map\n   * If not provided, the `name` property will be used instead\n   * Useful for showing abbreviated text on the map (e.g., \"NYC\" vs \"New York City Office\")\n   */\n  label?: string;\n  /** GeoJSON feature with geometry and style properties */\n  feature: ShapeFeature;\n  /** UTC timestamp (only set when saved) */\n  lastUpdated?: number;\n  /**\n   * Whether the shape is locked for editing\n   * Locked shapes cannot be modified due to data restrictions or user preference\n   */\n  locked?: boolean;\n}\n\n/**\n * Circle shape with required circleProperties\n */\nexport interface CircleShape extends BaseShape {\n  shape: typeof ShapeFeatureType.Circle;\n  feature: StyledFeature & { properties: CircleFeatureProperties };\n}\n\n/**\n * Ellipse shape with required ellipseProperties\n */\nexport interface EllipseShape extends BaseShape {\n  shape: typeof ShapeFeatureType.Ellipse;\n  feature: StyledFeature & { properties: EllipseFeatureProperties };\n}\n\n/**\n * Polygon shape\n */\nexport interface PolygonShape extends BaseShape {\n  shape: typeof ShapeFeatureType.Polygon;\n  feature: StyledFeature;\n}\n\n/**\n * Rectangle shape\n */\nexport interface RectangleShape extends BaseShape {\n  shape: typeof ShapeFeatureType.Rectangle;\n  feature: StyledFeature;\n}\n\n/**\n * LineString shape\n */\nexport interface LineStringShape extends BaseShape {\n  shape: typeof ShapeFeatureType.LineString;\n  feature: StyledFeature;\n}\n\n/**\n * Point shape\n */\nexport interface PointShape extends BaseShape {\n  shape: typeof ShapeFeatureType.Point;\n  feature: StyledFeature;\n}\n\n/**\n * Discriminated union of all shape types.\n *\n * Use this for type narrowing based on shape:\n * @example\n * ```ts\n * function handleShape(shape: Shape) {\n *   if (shape.shape === 'Circle') {\n *     // TypeScript knows shape.feature.properties.circleProperties exists\n *     const { center, radius } = shape.feature.properties.circleProperties;\n *   }\n * }\n * ```\n */\nexport type Shape =\n  | CircleShape\n  | EllipseShape\n  | PolygonShape\n  | RectangleShape\n  | LineStringShape\n  | PointShape;\n\n/**\n * Alias for ShapeFeatureType values\n */\nexport type ShapeFeatureTypeValues = ShapeFeatureType;\n\n/**\n * Alias for StyledFeature (shape feature)\n */\nexport type ShapeFeature = StyledFeature;\n\n/**\n * Alias for StyledFeature properties\n */\nexport type ShapeFeatureProperties = StyledFeature['properties'];\n\n/**\n * Circle radius type\n */\nexport type CircleRadius = CircleProperties['radius'];\n\n/**\n * Coordinate as [longitude, latitude]\n */\nexport type Coordinate = [number, number];\n\n/**\n * Function type for subscription (useSyncExternalStore pattern).\n * Used by draw-shape-layer and edit-shape-layer stores.\n */\nexport type Subscription = (onStoreChange: () => void) => () => void;\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard for Circle shapes.\n *\n * @example\n * ```ts\n * if (isCircleShape(shape)) {\n *   // shape.feature.properties.circleProperties is available\n *   const { center, radius } = shape.feature.properties.circleProperties;\n * }\n * ```\n */\nexport function isCircleShape(shape: Shape): shape is CircleShape {\n  return shape.shape === ShapeFeatureType.Circle;\n}\n\n/**\n * Type guard for Ellipse shapes.\n *\n * @example\n * ```ts\n * if (isEllipseShape(shape)) {\n *   // shape.feature.properties.ellipseProperties is available\n *   const { center, xSemiAxis, ySemiAxis } = shape.feature.properties.ellipseProperties;\n * }\n * ```\n */\nexport function isEllipseShape(shape: Shape): shape is EllipseShape {\n  return shape.shape === ShapeFeatureType.Ellipse;\n}\n\n/**\n * Type guard for Polygon shapes.\n */\nexport function isPolygonShape(shape: Shape): shape is PolygonShape {\n  return shape.shape === ShapeFeatureType.Polygon;\n}\n\n/**\n * Type guard for Rectangle shapes.\n */\nexport function isRectangleShape(shape: Shape): shape is RectangleShape {\n  return shape.shape === ShapeFeatureType.Rectangle;\n}\n\n/**\n * Type guard for LineString shapes.\n */\nexport function isLineStringShape(shape: Shape): shape is LineStringShape {\n  return shape.shape === ShapeFeatureType.LineString;\n}\n\n/**\n * Type guard for Point shapes.\n */\nexport function isPointShape(shape: Shape): shape is PointShape {\n  return shape.shape === ShapeFeatureType.Point;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,SAAS;CACT,SAAS;CACT,WAAW;CACX,YAAY;CACZ,OAAO;CACR;;;;;;;;;;;;AAwSD,SAAgB,cAAc,OAAoC;AAChE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;AAc1C,SAAgB,eAAe,OAAqC;AAClE,QAAO,MAAM,UAAU,iBAAiB;;;;;AAM1C,SAAgB,eAAe,OAAqC;AAClE,QAAO,MAAM,UAAU,iBAAiB;;;;;AAM1C,SAAgB,iBAAiB,OAAuC;AACtE,QAAO,MAAM,UAAU,iBAAiB;;;;;AAM1C,SAAgB,kBAAkB,OAAwC;AACxE,QAAO,MAAM,UAAU,iBAAiB;;;;;AAM1C,SAAgB,aAAa,OAAmC;AAC9D,QAAO,MAAM,UAAU,iBAAiB"}

package/dist/deckgl/shapes/shared/utils/geometry-measurements.js

@@ -0,0 +1,128 @@
+/*
+ * Copyright 2025 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
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+import { distance, point } from "@turf/turf";
+
+//#region src/deckgl/shapes/shared/utils/geometry-measurements.ts
+/**
+* Compute circle measurements from center and edge point.
+*
+* @param center - Center point as [longitude, latitude]
+* @param edgePoint - Point on the circle's edge as [longitude, latitude]
+* @param units - Distance units for the measurements
+* @returns Circle measurements including radius, diameter, and area
+*
+* @example
+* ```ts
+* const { radius, diameter, area } = computeCircleMeasurements(
+*   [-122.4, 37.8],
+*   [-122.3, 37.8],
+*   'kilometers'
+* );
+* ```
+*/
+function computeCircleMeasurements(center, edgePoint, units) {
+	const radius = distance(center, edgePoint, { units });
+	return {
+		radius,
+		diameter: radius * 2,
+		area: Math.PI * radius ** 2
+	};
+}
+/**
+* Compute rectangle measurements from adjacent corner points.
+*
+* Uses geodesic distance calculations for accurate measurements on Earth's surface.
+* Corners should be provided in order: corner0 -> corner1 -> corner2 where:
+* - corner0 to corner1 defines one edge (width)
+* - corner1 to corner2 defines the adjacent edge (height)
+*
+* @param corner0 - First corner as [longitude, latitude]
+* @param corner1 - Adjacent corner as [longitude, latitude]
+* @param corner2 - Corner adjacent to corner1 as [longitude, latitude]
+* @param units - Distance units for the measurements
+* @returns Rectangle measurements including width, height, and area
+*
+* @example
+* ```ts
+* const coords = polygon.geometry.coordinates[0];
+* const { width, height, area } = computeRectangleMeasurementsFromCorners(
+*   coords[0] as [number, number],
+*   coords[1] as [number, number],
+*   coords[2] as [number, number],
+*   'kilometers'
+* );
+* ```
+*/
+function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, units) {
+	const width = distance(point(corner0), point(corner1), { units });
+	const height = distance(point(corner1), point(corner2), { units });
+	return {
+		width,
+		height,
+		area: width * height
+	};
+}
+/**
+* Compute ellipse measurements from polygon coordinates.
+*
+* For an ellipse approximated as a polygon, calculates the major and minor axes
+* by measuring distances between opposite points on the perimeter.
+*
+* @param coordinates - Polygon ring coordinates as [[lon, lat], ...]
+* @param units - Distance units for the measurements
+* @returns Ellipse measurements including axes and area
+*
+* @example
+* ```ts
+* const coords = polygon.geometry.coordinates[0];
+* const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromPolygon(
+*   coords as [number, number][],
+*   'kilometers'
+* );
+* ```
+*/
+function computeEllipseMeasurementsFromPolygon(coordinates, units) {
+	const points = coordinates[0]?.[0] === coordinates[coordinates.length - 1]?.[0] && coordinates[0]?.[1] === coordinates[coordinates.length - 1]?.[1] ? coordinates.slice(0, -1) : coordinates;
+	if (points.length < 4) return {
+		majorAxis: 0,
+		minorAxis: 0,
+		area: 0
+	};
+	const halfLen = Math.floor(points.length / 2);
+	let maxDist = 0;
+	let minDist = Number.POSITIVE_INFINITY;
+	for (let i = 0; i < halfLen; i++) {
+		const p1 = points[i];
+		const p2 = points[i + halfLen];
+		if (!(p1 && p2)) continue;
+		const dist = distance([p1[0], p1[1]], [p2[0], p2[1]], { units });
+		if (dist > maxDist) maxDist = dist;
+		if (dist < minDist) minDist = dist;
+	}
+	const majorAxis = maxDist;
+	const minorAxis = minDist === Number.POSITIVE_INFINITY ? maxDist : minDist;
+	const semiMajor = majorAxis / 2;
+	const semiMinor = minorAxis / 2;
+	return {
+		majorAxis,
+		minorAxis,
+		area: Math.PI * semiMajor * semiMinor
+	};
+}
+
+//#endregion
+export { computeCircleMeasurements, computeEllipseMeasurementsFromPolygon, computeRectangleMeasurementsFromCorners };
+//# sourceMappingURL=geometry-measurements.js.map

package/dist/deckgl/shapes/shared/utils/geometry-measurements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry-measurements.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/geometry-measurements.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { distance, point } from '@turf/turf';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Circle measurement result containing radius, diameter, and area.\n */\nexport interface CircleMeasurements {\n  /** Radius in the specified units */\n  radius: number;\n  /** Diameter (radius * 2) in the specified units */\n  diameter: number;\n  /** Area (π * radius²) in the specified units squared */\n  area: number;\n}\n\n/**\n * Ellipse measurement result containing semi-axes and area.\n */\nexport interface EllipseMeasurements {\n  /** X semi-axis (horizontal radius) in the specified units */\n  xSemiAxis: number;\n  /** Y semi-axis (vertical radius) in the specified units */\n  ySemiAxis: number;\n  /** Major axis (full length of longer axis) in the specified units */\n  majorAxis: number;\n  /** Minor axis (full length of shorter axis) in the specified units */\n  minorAxis: number;\n  /** Area (π * xSemiAxis * ySemiAxis) in the specified units squared */\n  area: number;\n}\n\n/**\n * Rectangle measurement result containing width, height, and area.\n */\nexport interface RectangleMeasurements {\n  /** Width in the specified units */\n  width: number;\n  /** Height in the specified units */\n  height: number;\n  /** Area (width * height) in the specified units squared */\n  area: number;\n}\n\n/**\n * Compute circle measurements from center and edge point.\n *\n * @param center - Center point as [longitude, latitude]\n * @param edgePoint - Point on the circle's edge as [longitude, latitude]\n * @param units - Distance units for the measurements\n * @returns Circle measurements including radius, diameter, and area\n *\n * @example\n * ```ts\n * const { radius, diameter, area } = computeCircleMeasurements(\n *   [-122.4, 37.8],\n *   [-122.3, 37.8],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeCircleMeasurements(\n  center: [number, number],\n  edgePoint: [number, number],\n  units: DistanceUnit,\n): CircleMeasurements {\n  const radius = distance(center, edgePoint, { units });\n  const diameter = radius * 2;\n  const area = Math.PI * radius ** 2;\n\n  return { radius, diameter, area };\n}\n\n/**\n * Compute ellipse measurements from center and semi-axis lengths.\n *\n * @param xSemiAxis - X semi-axis (horizontal radius) in the specified units\n * @param ySemiAxis - Y semi-axis (vertical radius) in the specified units\n * @returns Ellipse measurements including axes and area\n *\n * @example\n * ```ts\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromAxes(100, 50);\n * ```\n */\nexport function computeEllipseMeasurementsFromAxes(\n  xSemiAxis: number,\n  ySemiAxis: number,\n): EllipseMeasurements {\n  const majorAxis = Math.max(xSemiAxis, ySemiAxis) * 2;\n  const minorAxis = Math.min(xSemiAxis, ySemiAxis) * 2;\n  const area = Math.PI * xSemiAxis * ySemiAxis;\n\n  return { xSemiAxis, ySemiAxis, majorAxis, minorAxis, area };\n}\n\n/**\n * Compute rectangle measurements from adjacent corner points.\n *\n * Uses geodesic distance calculations for accurate measurements on Earth's surface.\n * Corners should be provided in order: corner0 -> corner1 -> corner2 where:\n * - corner0 to corner1 defines one edge (width)\n * - corner1 to corner2 defines the adjacent edge (height)\n *\n * @param corner0 - First corner as [longitude, latitude]\n * @param corner1 - Adjacent corner as [longitude, latitude]\n * @param corner2 - Corner adjacent to corner1 as [longitude, latitude]\n * @param units - Distance units for the measurements\n * @returns Rectangle measurements including width, height, and area\n *\n * @example\n * ```ts\n * const coords = polygon.geometry.coordinates[0];\n * const { width, height, area } = computeRectangleMeasurementsFromCorners(\n *   coords[0] as [number, number],\n *   coords[1] as [number, number],\n *   coords[2] as [number, number],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeRectangleMeasurementsFromCorners(\n  corner0: [number, number],\n  corner1: [number, number],\n  corner2: [number, number],\n  units: DistanceUnit,\n): RectangleMeasurements {\n  const width = distance(point(corner0), point(corner1), { units });\n  const height = distance(point(corner1), point(corner2), { units });\n  const area = width * height;\n\n  return { width, height, area };\n}\n\n/**\n * Compute ellipse measurements from polygon coordinates.\n *\n * For an ellipse approximated as a polygon, calculates the major and minor axes\n * by measuring distances between opposite points on the perimeter.\n *\n * @param coordinates - Polygon ring coordinates as [[lon, lat], ...]\n * @param units - Distance units for the measurements\n * @returns Ellipse measurements including axes and area\n *\n * @example\n * ```ts\n * const coords = polygon.geometry.coordinates[0];\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromPolygon(\n *   coords as [number, number][],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeEllipseMeasurementsFromPolygon(\n  coordinates: [number, number][],\n  units: DistanceUnit,\n): { majorAxis: number; minorAxis: number; area: number } {\n  // Remove the closing point if it duplicates the first\n  const points =\n    coordinates[0]?.[0] === coordinates[coordinates.length - 1]?.[0] &&\n    coordinates[0]?.[1] === coordinates[coordinates.length - 1]?.[1]\n      ? coordinates.slice(0, -1)\n      : coordinates;\n\n  if (points.length < 4) {\n    return { majorAxis: 0, minorAxis: 0, area: 0 };\n  }\n\n  // For an ellipse polygon, opposite points are at index i and i + n/2\n  const halfLen = Math.floor(points.length / 2);\n  let maxDist = 0;\n  let minDist = Number.POSITIVE_INFINITY;\n\n  // Sample several diameter measurements\n  for (let i = 0; i < halfLen; i++) {\n    const p1 = points[i];\n    const p2 = points[i + halfLen];\n    if (!(p1 && p2)) {\n      continue;\n    }\n\n    const dist = distance(\n      [p1[0] as number, p1[1] as number],\n      [p2[0] as number, p2[1] as number],\n      { units },\n    );\n\n    if (dist > maxDist) {\n      maxDist = dist;\n    }\n    if (dist < minDist) {\n      minDist = dist;\n    }\n  }\n\n  const majorAxis = maxDist;\n  const minorAxis = minDist === Number.POSITIVE_INFINITY ? maxDist : minDist;\n\n  // Ellipse area = π × a × b (where a and b are semi-axes)\n  const semiMajor = majorAxis / 2;\n  const semiMinor = minorAxis / 2;\n  const ellipseArea = Math.PI * semiMajor * semiMinor;\n\n  return { majorAxis, minorAxis, area: ellipseArea };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,0BACd,QACA,WACA,OACoB;CACpB,MAAM,SAAS,SAAS,QAAQ,WAAW,EAAE,OAAO,CAAC;AAIrD,QAAO;EAAE;EAAQ,UAHA,SAAS;EAGC,MAFd,KAAK,KAAK,UAAU;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnC,SAAgB,wCACd,SACA,SACA,SACA,OACuB;CACvB,MAAM,QAAQ,SAAS,MAAM,QAAQ,EAAE,MAAM,QAAQ,EAAE,EAAE,OAAO,CAAC;CACjE,MAAM,SAAS,SAAS,MAAM,QAAQ,EAAE,MAAM,QAAQ,EAAE,EAAE,OAAO,CAAC;AAGlE,QAAO;EAAE;EAAO;EAAQ,MAFX,QAAQ;EAES;;;;;;;;;;;;;;;;;;;;;AAsBhC,SAAgB,sCACd,aACA,OACwD;CAExD,MAAM,SACJ,YAAY,KAAK,OAAO,YAAY,YAAY,SAAS,KAAK,MAC9D,YAAY,KAAK,OAAO,YAAY,YAAY,SAAS,KAAK,KAC1D,YAAY,MAAM,GAAG,GAAG,GACxB;AAEN,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,WAAW;EAAG,WAAW;EAAG,MAAM;EAAG;CAIhD,MAAM,UAAU,KAAK,MAAM,OAAO,SAAS,EAAE;CAC7C,IAAI,UAAU;CACd,IAAI,UAAU,OAAO;AAGrB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;EAChC,MAAM,KAAK,OAAO;EAClB,MAAM,KAAK,OAAO,IAAI;AACtB,MAAI,EAAE,MAAM,IACV;EAGF,MAAM,OAAO,SACX,CAAC,GAAG,IAAc,GAAG,GAAa,EAClC,CAAC,GAAG,IAAc,GAAG,GAAa,EAClC,EAAE,OAAO,CACV;AAED,MAAI,OAAO,QACT,WAAU;AAEZ,MAAI,OAAO,QACT,WAAU;;CAId,MAAM,YAAY;CAClB,MAAM,YAAY,YAAY,OAAO,oBAAoB,UAAU;CAGnE,MAAM,YAAY,YAAY;CAC9B,MAAM,YAAY,YAAY;AAG9B,QAAO;EAAE;EAAW;EAAW,MAFX,KAAK,KAAK,YAAY;EAEQ"}

package/dist/deckgl/shapes/shared/utils/layer-config.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright 2025 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
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
+import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
+
+//#region src/deckgl/shapes/shared/utils/layer-config.ts
+/**
+* Returns default props for EditableGeoJsonLayer configuration.
+*
+* This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:
+* - Edit handle colors
+* - Mode configuration with distance units
+* - Sublayer props for tooltips and handles
+*
+* @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.
+* @returns Default props to spread onto EditableGeoJsonLayer
+*
+* @example
+* ```tsx
+* <editableGeoJsonLayer
+*   {...getDefaultEditableLayerProps(unit)}
+*   // other props
+* />
+* ```
+*/
+function getDefaultEditableLayerProps(unitAbbrev) {
+	return {
+		getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,
+		getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,
+		modeConfig: { distanceUnits: unitAbbrev ? getDistanceUnitFromAbbreviation(unitAbbrev) ?? DEFAULT_DISTANCE_UNITS : DEFAULT_DISTANCE_UNITS },
+		_subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS
+	};
+}
+
+//#endregion
+export { getDefaultEditableLayerProps };
+//# sourceMappingURL=layer-config.js.map

package/dist/deckgl/shapes/shared/utils/layer-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-config.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.ts"],"sourcesContent":["/*\n * Copyright 2025 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 {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitFromAbbreviation,\n} from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport interface EditableLayerDefaultProps {\n  /** Edit handle point color */\n  getEditHandlePointColor: Color;\n  /** Edit handle point outline color */\n  getEditHandlePointOutlineColor: Color;\n  /** Mode configuration with distance units */\n  modeConfig: {\n    distanceUnits: DistanceUnit;\n  };\n  /** Sublayer props for tooltips and edit handles */\n  _subLayerProps: typeof EDITABLE_LAYER_SUBLAYER_PROPS;\n}\n\n/**\n * Returns default props for EditableGeoJsonLayer configuration.\n *\n * This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:\n * - Edit handle colors\n * - Mode configuration with distance units\n * - Sublayer props for tooltips and handles\n *\n * @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.\n * @returns Default props to spread onto EditableGeoJsonLayer\n *\n * @example\n * ```tsx\n * <editableGeoJsonLayer\n *   {...getDefaultEditableLayerProps(unit)}\n *   // other props\n * />\n * ```\n */\nexport function getDefaultEditableLayerProps(\n  unitAbbrev?: string,\n): EditableLayerDefaultProps {\n  return {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitAbbrev\n        ? (getDistanceUnitFromAbbreviation(unitAbbrev) ??\n          DEFAULT_DISTANCE_UNITS)\n        : DEFAULT_DISTANCE_UNITS,\n    },\n    // biome-ignore lint/style/useNamingConvention: deck.gl API convention\n    _subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,6BACd,YAC2B;AAC3B,QAAO;EACL,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,gCAAgC,WAAW,IAC5C,yBACA,wBACL;EAED,gBAAgB;EACjB"}