@accelint/map-toolkit 1.5.0 → 2.0.0

package/dist/deckgl/shapes/shared/types.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
@@ -28,6 +28,9 @@ const ShapeFeatureType = {
 /**
 * Type guard for Circle shapes.
 *
+* @param shape - The shape to test.
+* @returns True if shape is a CircleShape.
+*
 * @example
 * ```typescript
 * if (isCircleShape(shape)) {
@@ -42,6 +45,9 @@ function isCircleShape(shape) {
 /**
 * Type guard for Ellipse shapes.
 *
+* @param shape - The shape to test.
+* @returns True if shape is an EllipseShape.
+*
 * @example
 * ```typescript
 * if (isEllipseShape(shape)) {
@@ -55,29 +61,176 @@ function isEllipseShape(shape) {
 }
 /**
 * 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
+* }
+* ```
 */
 function isPolygonShape(shape) {
 	return shape.shape === ShapeFeatureType.Polygon;
 }
 /**
 * 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
+* }
+* ```
 */
 function isRectangleShape(shape) {
 	return shape.shape === ShapeFeatureType.Rectangle;
 }
 /**
 * 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
+* }
+* ```
 */
 function isLineStringShape(shape) {
 	return shape.shape === ShapeFeatureType.LineString;
 }
 /**
 * 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
+* }
+* ```
 */
 function isPointShape(shape) {
 	return shape.shape === ShapeFeatureType.Point;
 }
+/**
+* Narrow a GeoJSON geometry to the Point type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a Point.
+*/
+function isPointType(geometry) {
+	return geometry.type === "Point";
+}
+/**
+* Narrow a GeoJSON geometry to the MultiPoint type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a MultiPoint.
+*/
+function isMultiPointType(geometry) {
+	return geometry.type === "MultiPoint";
+}
+/**
+* Narrow a GeoJSON geometry to the LineString type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a LineString.
+*/
+function isLineStringType(geometry) {
+	return geometry.type === "LineString";
+}
+/**
+* Narrow a GeoJSON geometry to the MultiLineString type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a MultiLineString.
+*/
+function isMultiLineStringType(geometry) {
+	return geometry.type === "MultiLineString";
+}
+/**
+* Narrow a GeoJSON geometry to the Polygon type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a Polygon.
+*/
+function isPolygonType(geometry) {
+	return geometry.type === "Polygon";
+}
+/**
+* Narrow a GeoJSON geometry to the MultiPolygon type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a MultiPolygon.
+*/
+function isMultiPolygonType(geometry) {
+	return geometry.type === "MultiPolygon";
+}
+/**
+* Narrow a GeoJSON geometry to the GeometryCollection type.
+*
+* @param geometry - The GeoJSON geometry to test.
+* @returns True if the geometry is a GeometryCollection.
+*/
+function isGeometryCollectionType(geometry) {
+	return geometry.type === "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
+* }
+* ```
+*/
+function isPolygonGeometry(geometry) {
+	return geometry.type === "Polygon" || geometry.type === "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
+* }
+* ```
+*/
+function isLineGeometry(geometry) {
+	return geometry.type === "LineString" || geometry.type === "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
+* }
+* ```
+*/
+function isPointGeometry(geometry) {
+	return geometry.type === "Point" || geometry.type === "MultiPoint";
+}
 
 //#endregion
-export { ShapeFeatureType, isCircleShape, isEllipseShape, isLineStringShape, isPointShape, isPolygonShape, isRectangleShape };
+export { ShapeFeatureType, isCircleShape, isEllipseShape, isGeometryCollectionType, isLineGeometry, isLineStringShape, isLineStringType, isMultiLineStringType, isMultiPointType, isMultiPolygonType, isPointGeometry, isPointShape, isPointType, isPolygonGeometry, isPolygonShape, isPolygonType, 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 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 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 * ```typescript\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 * ```typescript\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 * ```typescript\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"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/deckgl/shapes/shared/types.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 type { UniqueId } from '@accelint/core';\nimport type { Color } from '@deck.gl/core';\nimport type {\n  Feature,\n  Geometry,\n  GeometryCollection,\n  LineString,\n  MultiLineString,\n  MultiPoint,\n  MultiPolygon,\n  Point,\n  Polygon,\n} 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\n/** Union of all supported shape feature type string literals. */\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 type 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 type CircleProperties = {\n  /** Center point as [longitude, latitude] or [longitude, latitude, elevation] */\n  center: [number, 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 type EllipseProperties = {\n  /** Center point as [longitude, latitude] or [longitude, latitude, elevation] */\n  center: [number, 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 * 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 type 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  /** Minimum elevation in meters (optional) */\n  minElevation?: number;\n  /** Maximum elevation in meters (optional) */\n  maxElevation?: number;\n};\n\n/**\n * Feature properties for Circle shapes (circleProperties required).\n * Used by CircleShape for better type narrowing.\n */\nexport type CircleFeatureProperties = 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 type EllipseFeatureProperties = StyledFeatureProperties & {\n  /** Ellipse properties (required for Ellipse shapes) */\n  ellipseProperties: EllipseProperties;\n};\n\n/**\n * GeoJSON Feature with style properties\n */\nexport type StyledFeature = Feature & {\n  properties: StyledFeatureProperties;\n};\n\n/**\n * Base shape properties shared by all shapes.\n */\ntype 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 type CircleShape = BaseShape & {\n  shape: typeof ShapeFeatureType.Circle;\n  feature: StyledFeature & { properties: CircleFeatureProperties };\n};\n\n/**\n * Ellipse shape with required ellipseProperties\n */\nexport type EllipseShape = BaseShape & {\n  shape: typeof ShapeFeatureType.Ellipse;\n  feature: StyledFeature & { properties: EllipseFeatureProperties };\n};\n\n/**\n * Polygon shape\n */\nexport type PolygonShape = BaseShape & {\n  shape: typeof ShapeFeatureType.Polygon;\n  feature: StyledFeature;\n};\n\n/**\n * Rectangle shape\n */\nexport type RectangleShape = BaseShape & {\n  shape: typeof ShapeFeatureType.Rectangle;\n  feature: StyledFeature;\n};\n\n/**\n * LineString shape\n */\nexport type LineStringShape = BaseShape & {\n  shape: typeof ShapeFeatureType.LineString;\n  feature: StyledFeature;\n};\n\n/**\n * Point shape\n */\nexport type PointShape = 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 * ```typescript\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 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// Type Guards\n// =============================================================================\n\n/**\n * Type guard for Circle shapes.\n *\n * @param shape - The shape to test.\n * @returns True if shape is a CircleShape.\n *\n * @example\n * ```typescript\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 * @param shape - The shape to test.\n * @returns True if shape is an EllipseShape.\n *\n * @example\n * ```typescript\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 *\n * @param shape - The shape to test\n * @returns True if shape is a PolygonShape\n * @example\n * ```typescript\n * if (isPolygonShape(shape)) {\n *   // TypeScript narrows shape to PolygonShape\n * }\n * ```\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 *\n * @param shape - The shape to test\n * @returns True if shape is a RectangleShape\n * @example\n * ```typescript\n * if (isRectangleShape(shape)) {\n *   // TypeScript narrows shape to RectangleShape\n * }\n * ```\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 *\n * @param shape - The shape to test\n * @returns True if shape is a LineStringShape\n * @example\n * ```typescript\n * if (isLineStringShape(shape)) {\n *   // TypeScript narrows shape to LineStringShape\n * }\n * ```\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 *\n * @param shape - The shape to test\n * @returns True if shape is a PointShape\n * @example\n * ```typescript\n * if (isPointShape(shape)) {\n *   // TypeScript narrows shape to PointShape\n * }\n * ```\n */\nexport function isPointShape(shape: Shape): shape is PointShape {\n  return shape.shape === ShapeFeatureType.Point;\n}\n\n// =============================================================================\n// Geometry Type Predicates\n// =============================================================================\n// These narrow GeoJSON Geometry unions (e.g. Polygon, MultiPolygon),\n// distinct from the Shape type guards above which check shape.shape ('Circle', etc.).\n\n// --- Granular geometry predicates (single GeoJSON type) ---\n\n/**\n * Narrow a GeoJSON geometry to the Point type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a Point.\n */\nexport function isPointType(geometry: Geometry): geometry is Point {\n  return geometry.type === 'Point';\n}\n\n/**\n * Narrow a GeoJSON geometry to the MultiPoint type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a MultiPoint.\n */\nexport function isMultiPointType(geometry: Geometry): geometry is MultiPoint {\n  return geometry.type === 'MultiPoint';\n}\n\n/**\n * Narrow a GeoJSON geometry to the LineString type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a LineString.\n */\nexport function isLineStringType(geometry: Geometry): geometry is LineString {\n  return geometry.type === 'LineString';\n}\n\n/**\n * Narrow a GeoJSON geometry to the MultiLineString type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a MultiLineString.\n */\nexport function isMultiLineStringType(\n  geometry: Geometry,\n): geometry is MultiLineString {\n  return geometry.type === 'MultiLineString';\n}\n\n/**\n * Narrow a GeoJSON geometry to the Polygon type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a Polygon.\n */\nexport function isPolygonType(geometry: Geometry): geometry is Polygon {\n  return geometry.type === 'Polygon';\n}\n\n/**\n * Narrow a GeoJSON geometry to the MultiPolygon type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a MultiPolygon.\n */\nexport function isMultiPolygonType(\n  geometry: Geometry,\n): geometry is MultiPolygon {\n  return geometry.type === 'MultiPolygon';\n}\n\n/**\n * Narrow a GeoJSON geometry to the GeometryCollection type.\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a GeometryCollection.\n */\nexport function isGeometryCollectionType(\n  geometry: Geometry,\n): geometry is GeometryCollection {\n  return geometry.type === 'GeometryCollection';\n}\n\n// --- Composite geometry predicates (multiple GeoJSON types) ---\n\n/**\n * Narrow a GeoJSON geometry to polygon-like types (Polygon or MultiPolygon).\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a Polygon or MultiPolygon.\n *\n * @example\n * ```typescript\n * if (isPolygonGeometry(feature.geometry)) {\n *   // geometry narrowed to Polygon | MultiPolygon\n * }\n * ```\n */\nexport function isPolygonGeometry(\n  geometry: Geometry,\n): geometry is Polygon | MultiPolygon {\n  return geometry.type === 'Polygon' || geometry.type === 'MultiPolygon';\n}\n\n/**\n * Narrow a GeoJSON geometry to line-like types (LineString or MultiLineString).\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a LineString or MultiLineString.\n *\n * @example\n * ```typescript\n * if (isLineGeometry(feature.geometry)) {\n *   // geometry narrowed to LineString | MultiLineString\n * }\n * ```\n */\nexport function isLineGeometry(\n  geometry: Geometry,\n): geometry is LineString | MultiLineString {\n  return geometry.type === 'LineString' || geometry.type === 'MultiLineString';\n}\n\n/**\n * Narrow a GeoJSON geometry to point-like types (Point or MultiPoint).\n *\n * @param geometry - The GeoJSON geometry to test.\n * @returns True if the geometry is a Point or MultiPoint.\n *\n * @example\n * ```typescript\n * if (isPointGeometry(feature.geometry)) {\n *   // geometry narrowed to Point | MultiPoint\n * }\n * ```\n */\nexport function isPointGeometry(\n  geometry: Geometry,\n): geometry is Point | MultiPoint {\n  return geometry.type === 'Point' || geometry.type === 'MultiPoint';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgCA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,SAAS;CACT,SAAS;CACT,WAAW;CACX,YAAY;CACZ,OAAO;CACR;;;;;;;;;;;;;;;AA2RD,SAAgB,cAAc,OAAoC;AAChE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;;;;AAiB1C,SAAgB,eAAe,OAAqC;AAClE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;;AAe1C,SAAgB,eAAe,OAAqC;AAClE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;;AAe1C,SAAgB,iBAAiB,OAAuC;AACtE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;;AAe1C,SAAgB,kBAAkB,OAAwC;AACxE,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;;;;;;;AAe1C,SAAgB,aAAa,OAAmC;AAC9D,QAAO,MAAM,UAAU,iBAAiB;;;;;;;;AAiB1C,SAAgB,YAAY,UAAuC;AACjE,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,iBAAiB,UAA4C;AAC3E,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,iBAAiB,UAA4C;AAC3E,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,sBACd,UAC6B;AAC7B,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,cAAc,UAAyC;AACrE,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,mBACd,UAC0B;AAC1B,QAAO,SAAS,SAAS;;;;;;;;AAS3B,SAAgB,yBACd,UACgC;AAChC,QAAO,SAAS,SAAS;;;;;;;;;;;;;;;AAkB3B,SAAgB,kBACd,UACoC;AACpC,QAAO,SAAS,SAAS,aAAa,SAAS,SAAS;;;;;;;;;;;;;;;AAgB1D,SAAgB,eACd,UAC0C;AAC1C,QAAO,SAAS,SAAS,gBAAgB,SAAS,SAAS;;;;;;;;;;;;;;;AAgB7D,SAAgB,gBACd,UACgC;AAChC,QAAO,SAAS,SAAS,WAAW,SAAS,SAAS"}

package/dist/deckgl/shapes/shared/utils/geometry-measurements.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
@@ -11,18 +11,16 @@
  */
 
 
-'use client';
-
-import { distance, point } from "@turf/turf";
+import { distance } 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
+* @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
 * ```typescript
@@ -49,11 +47,11 @@ function computeCircleMeasurements(center, edgePoint, units) {
 * - 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
+* @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
 * ```typescript
@@ -67,8 +65,9 @@ function computeCircleMeasurements(center, edgePoint, units) {
 * ```
 */
 function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, units) {
-	const width = distance(point(corner0), point(corner1), { units });
-	const height = distance(point(corner1), point(corner2), { units });
+	const options = { units };
+	const width = distance(corner0, corner1, options);
+	const height = distance(corner1, corner2, options);
 	return {
 		width,
 		height,
@@ -81,9 +80,9 @@ function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, unit
 * 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
+* @param coordinates - Polygon ring coordinates as [[lon, lat], ...].
+* @param units - Distance units for the measurements.
+* @returns Ellipse measurements including axes and area.
 *
 * @example
 * ```typescript
@@ -95,20 +94,24 @@ function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, unit
 * ```
 */
 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 {
+	const len = coordinates.length;
+	const pointCount = len > 0 && coordinates[0]?.[0] === coordinates[len - 1]?.[0] && coordinates[0]?.[1] === coordinates[len - 1]?.[1] ? len - 1 : len;
+	if (pointCount < 4) return {
+		xSemiAxis: 0,
+		ySemiAxis: 0,
 		majorAxis: 0,
 		minorAxis: 0,
 		area: 0
 	};
-	const halfLen = Math.floor(points.length / 2);
+	const halfLen = Math.floor(pointCount / 2);
+	const options = { units };
 	let maxDist = 0;
 	let minDist = Number.POSITIVE_INFINITY;
 	for (let i = 0; i < halfLen; i++) {
-		const p1 = points[i];
-		const p2 = points[i + halfLen];
+		const p1 = coordinates[i];
+		const p2 = coordinates[i + halfLen];
 		if (!(p1 && p2)) continue;
-		const dist = distance([p1[0], p1[1]], [p2[0], p2[1]], { units });
+		const dist = distance(p1, p2, options);
 		if (dist > maxDist) maxDist = dist;
 		if (dist < minDist) minDist = dist;
 	}
@@ -117,6 +120,8 @@ function computeEllipseMeasurementsFromPolygon(coordinates, units) {
 	const semiMajor = majorAxis / 2;
 	const semiMinor = minorAxis / 2;
 	return {
+		xSemiAxis: semiMajor,
+		ySemiAxis: semiMinor,
 		majorAxis,
 		minorAxis,
 		area: Math.PI * semiMajor * semiMinor

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

@@ -1 +1 @@
-{"version":3,"file":"geometry-measurements.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/geometry-measurements.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 { 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 * ```typescript\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 * ```typescript\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 * ```typescript\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 * ```typescript\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"}
+{"version":3,"file":"geometry-measurements.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/geometry-measurements.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\nimport { distance } from '@turf/turf';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Circle measurement result containing radius, diameter, and area.\n */\nexport type 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 type 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 type 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 * ```typescript\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 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 * ```typescript\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 * ```typescript\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 options = { units };\n  const width = distance(corner0, corner1, options);\n  const height = distance(corner1, corner2, options);\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 * ```typescript\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): EllipseMeasurements {\n  // Determine effective point count without allocating a new array\n  const len = coordinates.length;\n  const isClosed =\n    len > 0 &&\n    coordinates[0]?.[0] === coordinates[len - 1]?.[0] &&\n    coordinates[0]?.[1] === coordinates[len - 1]?.[1];\n  const pointCount = isClosed ? len - 1 : len;\n\n  if (pointCount < 4) {\n    return { xSemiAxis: 0, ySemiAxis: 0, 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(pointCount / 2);\n  const options = { units };\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 = coordinates[i];\n    const p2 = coordinates[i + halfLen];\n    if (!(p1 && p2)) {\n      continue;\n    }\n\n    const dist = distance(p1, p2, options);\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 area = Math.PI * semiMajor * semiMinor;\n\n  return {\n    xSemiAxis: semiMajor,\n    ySemiAxis: semiMinor,\n    majorAxis,\n    minorAxis,\n    area,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEA,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,UAAU,EAAE,OAAO;CACzB,MAAM,QAAQ,SAAS,SAAS,SAAS,QAAQ;CACjD,MAAM,SAAS,SAAS,SAAS,SAAS,QAAQ;AAGlD,QAAO;EAAE;EAAO;EAAQ,MAFX,QAAQ;EAES;;;;;;;;;;;;;;;;;;;;;AAsBhC,SAAgB,sCACd,aACA,OACqB;CAErB,MAAM,MAAM,YAAY;CAKxB,MAAM,aAHJ,MAAM,KACN,YAAY,KAAK,OAAO,YAAY,MAAM,KAAK,MAC/C,YAAY,KAAK,OAAO,YAAY,MAAM,KAAK,KACnB,MAAM,IAAI;AAExC,KAAI,aAAa,EACf,QAAO;EAAE,WAAW;EAAG,WAAW;EAAG,WAAW;EAAG,WAAW;EAAG,MAAM;EAAG;CAI5E,MAAM,UAAU,KAAK,MAAM,aAAa,EAAE;CAC1C,MAAM,UAAU,EAAE,OAAO;CACzB,IAAI,UAAU;CACd,IAAI,UAAU,OAAO;AAGrB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;EAChC,MAAM,KAAK,YAAY;EACvB,MAAM,KAAK,YAAY,IAAI;AAC3B,MAAI,EAAE,MAAM,IACV;EAGF,MAAM,OAAO,SAAS,IAAI,IAAI,QAAQ;AAEtC,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;EACL,WAAW;EACX,WAAW;EACX;EACA;EACA,MAPW,KAAK,KAAK,YAAY;EAQlC"}

package/dist/deckgl/shapes/shared/utils/layer-config.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
@@ -11,12 +11,12 @@
  */
 
 
-'use client';
-
 import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
 import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
 
 //#region src/deckgl/shapes/shared/utils/layer-config.ts
+let cachedAbbrev = null;
+let cachedProps;
 /**
 * Returns default props for EditableGeoJsonLayer configuration.
 *
@@ -26,7 +26,7 @@ import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../con
 * - 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
+* @returns Default props to spread onto EditableGeoJsonLayer.
 *
 * @example
 * ```tsx
@@ -37,12 +37,15 @@ import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../con
 * ```
 */
 function getDefaultEditableLayerProps(unitAbbrev) {
-	return {
+	if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) return cachedProps;
+	cachedAbbrev = unitAbbrev;
+	cachedProps = {
 		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
 	};
+	return cachedProps;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"layer-config.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.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 {\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"}
+{"version":3,"file":"layer-config.js","names":["cachedAbbrev: DistanceUnitAbbreviation | undefined | null","cachedProps: EditableLayerDefaultProps | undefined"],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.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\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  type DistanceUnit,\n  type DistanceUnitAbbreviation,\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';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport type 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\nlet cachedAbbrev: DistanceUnitAbbreviation | undefined | null = null;\nlet cachedProps: EditableLayerDefaultProps | undefined;\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?: DistanceUnitAbbreviation,\n): EditableLayerDefaultProps {\n  if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) {\n    return cachedProps;\n  }\n\n  cachedAbbrev = unitAbbrev;\n  cachedProps = {\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  return cachedProps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyCA,IAAIA,eAA4D;AAChE,IAAIC;;;;;;;;;;;;;;;;;;;;AAqBJ,SAAgB,6BACd,YAC2B;AAC3B,KAAI,iBAAiB,QAAQ,iBAAiB,cAAc,YAC1D,QAAO;AAGT,gBAAe;AACf,eAAc;EACZ,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,gCAAgC,WAAW,IAC5C,yBACA,wBACL;EAED,gBAAgB;EACjB;AAED,QAAO"}

package/dist/deckgl/shapes/shared/utils/mode-utils.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
@@ -11,8 +11,6 @@
  */
 
 
-'use client';
-
 import { MapModeEvents } from "../../../../map-mode/events.js";
 import { MapCursorEvents } from "../../../../map-cursor/events.js";
 import { cursorStore } from "../../../../map-cursor/store.js";
@@ -24,15 +22,22 @@ import { Broadcast } from "@accelint/bus";
 */
 const mapModeBus = Broadcast.getInstance();
 const mapCursorBus = Broadcast.getInstance();
+/** The idle mode name used when releasing ownership. */
+const DEFAULT_MODE = "default";
 /**
 * Request a map mode change.
 *
 * Emits a mode change request through the event bus. The mode store will
 * handle authorization and apply the change if approved.
 *
-* @param mapId - The map instance ID
-* @param desiredMode - The mode to switch to
-* @param owner - The identifier of the component requesting the change
+* @param mapId - The map instance ID.
+* @param desiredMode - The mode to switch to.
+* @param owner - The identifier of the component requesting the change.
+*
+* @example
+* ```typescript
+* requestModeChange(mapId, 'draw', 'draw-shape-layer');
+* ```
 */
 function requestModeChange(mapId, desiredMode, owner) {
 	mapModeBus.emit(MapModeEvents.changeRequest, {
@@ -46,20 +51,30 @@ function requestModeChange(mapId, desiredMode, owner) {
 *
 * Convenience function to request a mode change back to 'default'.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing the mode
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing the mode.
+*
+* @example
+* ```typescript
+* releaseMode(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseMode(mapId, owner) {
-	requestModeChange(mapId, "default", owner);
+	requestModeChange(mapId, DEFAULT_MODE, owner);
 }
 /**
 * Request a cursor change.
 *
 * Emits a cursor change request through the event bus.
 *
-* @param mapId - The map instance ID
-* @param cursor - The CSS cursor type to set
-* @param owner - The identifier of the component requesting the change
+* @param mapId - The map instance ID.
+* @param cursor - The CSS cursor type to set.
+* @param owner - The identifier of the component requesting the change.
+*
+* @example
+* ```typescript
+* requestCursorChange(mapId, 'crosshair', 'draw-shape-layer');
+* ```
 */
 function requestCursorChange(mapId, cursor, owner) {
 	mapCursorBus.emit(MapCursorEvents.changeRequest, {
@@ -73,8 +88,13 @@ function requestCursorChange(mapId, cursor, owner) {
 *
 * Uses the cursor store's clear function to release the cursor.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing the cursor
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing the cursor.
+*
+* @example
+* ```typescript
+* releaseCursor(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseCursor(mapId, owner) {
 	cursorStore.actions(mapId).clearCursor(owner);
@@ -86,10 +106,15 @@ function releaseCursor(mapId, owner) {
 * requires authorization. When the mode change is approved, the cursor
 * will be automatically applied via getEffectiveCursor.
 *
-* @param mapId - The map instance ID
-* @param desiredMode - The mode to switch to
-* @param cursor - The CSS cursor type to set
-* @param owner - The identifier of the component requesting the changes
+* @param mapId - The map instance ID.
+* @param desiredMode - The mode to switch to.
+* @param cursor - The CSS cursor type to set.
+* @param owner - The identifier of the component requesting the changes.
+*
+* @example
+* ```typescript
+* requestModeAndCursor(mapId, 'draw', 'crosshair', 'draw-shape-layer');
+* ```
 */
 function requestModeAndCursor(mapId, desiredMode, cursor, owner) {
 	requestModeChange(mapId, desiredMode, owner);
@@ -100,8 +125,13 @@ function requestModeAndCursor(mapId, desiredMode, cursor, owner) {
 *
 * Common pattern when ending an operation.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing mode and cursor
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing mode and cursor.
+*
+* @example
+* ```typescript
+* releaseModeAndCursor(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseModeAndCursor(mapId, owner) {
 	releaseMode(mapId, owner);