@accelint/map-toolkit 1.2.0 → 1.3.0

package/dist/deckgl/shapes/draw-shape-layer/utils/feature-conversion.js

@@ -16,8 +16,8 @@
 import { DEFAULT_STYLE_PROPERTIES } from "../../shared/constants.js";
 import { ShapeFeatureType } from "../../shared/types.js";
 import { DEFAULT_DISTANCE_UNITS } from "../../../../shared/units.js";
-import { uuid } from "@accelint/core";
 import { getLogger } from "@accelint/logger";
+import { uuid } from "@accelint/core";
 import { centroid, distance } from "@turf/turf";
 
 //#region src/deckgl/shapes/draw-shape-layer/utils/feature-conversion.ts
@@ -28,16 +28,58 @@ const logger = getLogger({
 	pretty: true
 });
 /**
-* Generate a default name for a shape based on its type
+* Generate a default name for a shape based on its type.
+*
+* Creates a name in the format "New {ShapeType} (HH:MM:SS AM/PM)" using the
+* current time. This provides a default name for shapes created through the
+* drawing interface that includes a timestamp for uniqueness.
+*
+* @param shape - The shape type to generate a name for
+* @returns A formatted name string with timestamp
+*
+* @example
+* ```typescript
+* import { generateShapeName } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';
+* import { ShapeFeatureType } from '@accelint/map-toolkit/deckgl/shapes/shared/types';
+*
+* const name = generateShapeName(ShapeFeatureType.Polygon);
+* // Returns: "New Polygon (2:30:45 PM)"
+* ```
 */
 function generateShapeName(shape) {
 	return `New ${shape} (${(/* @__PURE__ */ new Date()).toLocaleTimeString()})`;
 }
 /**
-* Compute circle properties from a polygon geometry (circle approximation)
+* Compute circle properties from a polygon geometry (circle approximation).
+*
+* The EditableGeoJsonLayer creates circles as polygon approximations with multiple
+* vertices arranged in a circular pattern. This function extracts the original circle's
+* center and radius from that polygon approximation.
+*
+* The center is calculated using Turf's centroid function, and the radius is computed
+* as the distance from the center to the first edge point.
+*
+* @param geometry - Polygon geometry representing a circle approximation
+* @returns Circle properties with center and radius, or undefined if computation fails
+*
+* @example
+* ```typescript
+* import { computeCircleProperties } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';
+* import type { Polygon } from 'geojson';
+*
+* const polygonGeometry: Polygon = {
+*   type: 'Polygon',
+*   coordinates: [[
+*     [-122.4, 37.8],
+*     [-122.39, 37.81],
+*     // ... more points forming a circle
+*     [-122.4, 37.8], // closing point
+*   ]],
+* };
 *
-* The EditableGeoJsonLayer creates circles as polygon approximations.
-* This function extracts the center and radius from that polygon.
+* const circleProps = computeCircleProperties(polygonGeometry);
+* // Returns: { center: [-122.395, 37.805], radius: { value: 1.5, units: 'kilometers' } }
+* ```
 */
 function computeCircleProperties(geometry) {
 	const coordinates = geometry.coordinates[0];
@@ -72,10 +114,40 @@ function computeCircleProperties(geometry) {
 	};
 }
 /**
-* Compute ellipse properties from a feature's editProperties
+* Compute ellipse properties from a feature's editProperties.
 *
 * The DrawEllipseUsingThreePointsMode attaches ellipse metadata to the feature's
-* properties.editProperties. This function extracts and normalizes that data.
+* properties.editProperties field. This function extracts and normalizes that data
+* into the standard EllipseProperties format used by Shape objects.
+*
+* The function validates that editProperties exists and has the correct shape
+* discriminator before extracting the ellipse parameters.
+*
+* @param feature - GeoJSON feature with editProperties attached by the draw mode
+* @returns Normalized ellipse properties, or undefined if extraction fails
+*
+* @example
+* ```typescript
+* import { computeEllipseProperties } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';
+* import type { Feature } from 'geojson';
+*
+* const feature: Feature = {
+*   type: 'Feature',
+*   geometry: { type: 'Polygon', coordinates: [[...]] },
+*   properties: {
+*     editProperties: {
+*       shape: 'Ellipse',
+*       center: [-122.4, 37.8],
+*       xSemiAxis: { value: 2.5, unit: 'kilometers' },
+*       ySemiAxis: { value: 1.5, unit: 'kilometers' },
+*       angle: 45,
+*     },
+*   },
+* };
+*
+* const ellipseProps = computeEllipseProperties(feature);
+* // Returns normalized ellipse properties with standard distance units
+* ```
 */
 function computeEllipseProperties(feature) {
 	const editProps = feature.properties?.editProperties;
@@ -97,20 +169,69 @@ function computeEllipseProperties(feature) {
 	};
 }
 /**
-* Convert a raw GeoJSON Feature from EditableGeoJsonLayer to a Shape
+* Convert a raw GeoJSON Feature from EditableGeoJsonLayer to a Shape.
+*
+* This function transforms the raw GeoJSON features produced by deck.gl's
+* EditableGeoJsonLayer into the Shape format used throughout the map-toolkit.
+* It handles geometry normalization, style property merging, and special handling
+* for Circle and Ellipse shapes which are stored as polygon approximations.
 *
-* The returned Shape includes:
-* - Auto-generated UUID
-* - Auto-generated name with timestamp (e.g., "New Polygon (2:30:45 PM)")
-* - Merged style properties (defaults + overrides)
-* - Circle/ellipse properties computed from geometry if applicable
-* - `lastUpdated` timestamp
-* - `locked: false` (newly created shapes are always unlocked)
+* ## The returned Shape includes:
+* - **Auto-generated UUID**: Unique identifier for the shape
+* - **Auto-generated name**: Format "New {ShapeType} (HH:MM:SS AM/PM)"
+* - **Merged style properties**: Defaults + optional custom overrides
+* - **Circle/ellipse properties**: Computed from geometry if applicable
+* - **lastUpdated timestamp**: UTC timestamp when created
+* - **locked: false**: Newly created shapes are always unlocked
+*
+* ## Special Handling
+* - **Circles**: Extracts center and radius from polygon approximation
+* - **Ellipses**: Extracts center, semi-axes, and angle from editProperties
 *
 * @param feature - The raw GeoJSON feature from the editable layer
 * @param shape - The type of shape being created
-* @param styleDefaults - Optional style overrides
-* @returns A complete Shape ready for use
+* @param styleDefaults - Optional style property overrides (colors, line width, etc.)
+* @returns A complete Shape object ready for use in DisplayShapeLayer
+*
+* @example Basic usage with polygon
+* ```typescript
+* import { convertFeatureToShape } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';
+* import { ShapeFeatureType } from '@accelint/map-toolkit/deckgl/shapes/shared/types';
+* import type { Feature } from 'geojson';
+*
+* const feature: Feature = {
+*   type: 'Feature',
+*   geometry: {
+*     type: 'Polygon',
+*     coordinates: [[
+*       [-122.4, 37.8],
+*       [-122.3, 37.8],
+*       [-122.3, 37.9],
+*       [-122.4, 37.9],
+*       [-122.4, 37.8],
+*     ]],
+*   },
+*   properties: {},
+* };
+*
+* const shape = convertFeatureToShape(feature, ShapeFeatureType.Polygon);
+* // Returns: { id: 'uuid...', name: 'New Polygon (2:30:45 PM)', shape: 'Polygon', ... }
+* ```
+*
+* @example With custom style defaults
+* ```typescript
+* const shape = convertFeatureToShape(
+*   feature,
+*   ShapeFeatureType.Circle,
+*   {
+*     fillColor: [255, 100, 100, 180],   // RGBA: red fill
+*     lineColor: [200, 0, 0, 255],        // RGBA: dark red line
+*     lineWidth: 4,
+*     linePattern: 'solid',
+*   }
+* );
+* // Returns a shape with custom colors applied
+* ```
 */
 function convertFeatureToShape(feature, shape, styleDefaults) {
 	const id = uuid();

package/dist/deckgl/shapes/draw-shape-layer/utils/feature-conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-conversion.js","names":["styleProperties: StyleProperties","circleProperties: CircleProperties | undefined","ShapeFeatureTypeEnum","ellipseProperties: EllipseProperties | undefined"],"sources":["../../../../../src/deckgl/shapes/draw-shape-layer/utils/feature-conversion.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 { uuid } from '@accelint/core';\nimport { getLogger } from '@accelint/logger';\nimport { centroid, distance } from '@turf/turf';\nimport { DEFAULT_DISTANCE_UNITS } from '@/shared/units';\nimport { DEFAULT_STYLE_PROPERTIES } from '../../shared/constants';\nimport {\n  type CircleProperties,\n  type EllipseProperties,\n  type Shape,\n  type ShapeFeature,\n  type ShapeFeatureType,\n  ShapeFeatureType as ShapeFeatureTypeEnum,\n  type StyleProperties,\n} from '../../shared/types';\nimport type { Feature, Polygon, Position } from 'geojson';\n\nconst logger = getLogger({\n  enabled: process.env.NODE_ENV !== 'production',\n  level: 'warn',\n  prefix: '[FeatureConversion]',\n  pretty: true,\n});\n\n/**\n * Generate a default name for a shape based on its type\n */\nfunction generateShapeName(shape: ShapeFeatureType): string {\n  const timestamp = new Date().toLocaleTimeString();\n  return `New ${shape} (${timestamp})`;\n}\n\n/**\n * Compute circle properties from a polygon geometry (circle approximation)\n *\n * The EditableGeoJsonLayer creates circles as polygon approximations.\n * This function extracts the center and radius from that polygon.\n */\nfunction computeCircleProperties(\n  geometry: Polygon,\n): CircleProperties | undefined {\n  const coordinates = geometry.coordinates[0];\n  if (!coordinates || coordinates.length < 3) {\n    logger.warn(\n      'Cannot compute circle properties: polygon has insufficient coordinates',\n    );\n    return undefined;\n  }\n\n  // Calculate center using turf centroid\n  const centerFeature = centroid({\n    type: 'Polygon',\n    coordinates: geometry.coordinates,\n  });\n  const center = centerFeature.geometry.coordinates as [number, number];\n\n  // Validate center coordinates are valid numbers\n  const isCenterValid =\n    Number.isFinite(center[0]) && Number.isFinite(center[1]);\n  if (!isCenterValid) {\n    logger.warn('Cannot compute circle properties: invalid center coordinates');\n    return undefined;\n  }\n\n  // Calculate radius as distance from center to first point\n  const firstPoint = coordinates[0] as Position;\n\n  // Validate first point coordinates\n  const isFirstPointValid =\n    firstPoint &&\n    Number.isFinite(firstPoint[0]) &&\n    Number.isFinite(firstPoint[1]);\n  if (!isFirstPointValid) {\n    logger.warn(\n      'Cannot compute circle properties: invalid edge point coordinates',\n    );\n    return undefined;\n  }\n\n  const radius = distance(center, firstPoint, {\n    units: DEFAULT_DISTANCE_UNITS,\n  });\n\n  // Validate computed radius\n  if (!Number.isFinite(radius) || radius <= 0) {\n    logger.warn('Cannot compute circle properties: invalid radius computed');\n    return undefined;\n  }\n\n  return {\n    center,\n    radius: {\n      value: radius,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n  };\n}\n\n/**\n * Edit properties attached by DrawEllipseUsingThreePointsMode\n */\ninterface EllipseEditProperties {\n  shape: 'Ellipse';\n  xSemiAxis: { value: number; unit: string };\n  ySemiAxis: { value: number; unit: string };\n  angle: number;\n  center: [number, number];\n}\n\n/**\n * Compute ellipse properties from a feature's editProperties\n *\n * The DrawEllipseUsingThreePointsMode attaches ellipse metadata to the feature's\n * properties.editProperties. This function extracts and normalizes that data.\n */\nfunction computeEllipseProperties(\n  feature: Feature,\n): EllipseProperties | undefined {\n  const editProps = (\n    feature.properties as { editProperties?: EllipseEditProperties } | null\n  )?.editProperties;\n\n  if (!editProps || editProps.shape !== 'Ellipse') {\n    logger.warn(\n      'Cannot compute ellipse properties: feature missing editProperties or not an ellipse',\n    );\n    return undefined;\n  }\n\n  return {\n    center: editProps.center,\n    xSemiAxis: {\n      value: editProps.xSemiAxis.value,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n    ySemiAxis: {\n      value: editProps.ySemiAxis.value,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n    angle: editProps.angle,\n  };\n}\n\n/**\n * Convert a raw GeoJSON Feature from EditableGeoJsonLayer to a Shape\n *\n * The returned Shape includes:\n * - Auto-generated UUID\n * - Auto-generated name with timestamp (e.g., \"New Polygon (2:30:45 PM)\")\n * - Merged style properties (defaults + overrides)\n * - Circle/ellipse properties computed from geometry if applicable\n * - `lastUpdated` timestamp\n * - `locked: false` (newly created shapes are always unlocked)\n *\n * @param feature - The raw GeoJSON feature from the editable layer\n * @param shape - The type of shape being created\n * @param styleDefaults - Optional style overrides\n * @returns A complete Shape ready for use\n */\nexport function convertFeatureToShape(\n  feature: Feature,\n  shape: ShapeFeatureType,\n  styleDefaults?: Partial<StyleProperties> | null,\n): Shape {\n  const id = uuid();\n  const name = generateShapeName(shape);\n\n  // Merge default styles with any provided defaults\n  const styleProperties: StyleProperties = {\n    ...DEFAULT_STYLE_PROPERTIES,\n    ...(styleDefaults ?? {}),\n  };\n\n  // Compute circle properties if this is a circle\n  let circleProperties: CircleProperties | undefined;\n  if (\n    shape === ShapeFeatureTypeEnum.Circle &&\n    feature.geometry.type === 'Polygon'\n  ) {\n    circleProperties = computeCircleProperties(feature.geometry);\n  }\n\n  // Compute ellipse properties if this is an ellipse\n  let ellipseProperties: EllipseProperties | undefined;\n  if (\n    shape === ShapeFeatureTypeEnum.Ellipse &&\n    feature.geometry.type === 'Polygon'\n  ) {\n    ellipseProperties = computeEllipseProperties(feature);\n  }\n\n  // Create the styled feature\n  const styledFeature: ShapeFeature = {\n    type: 'Feature',\n    geometry: feature.geometry,\n    properties: {\n      styleProperties,\n      circleProperties,\n      ellipseProperties,\n      shapeId: id,\n    },\n  };\n\n  // Type assertion needed because TypeScript can't narrow the return type\n  // based on the runtime shape value. The constructed object satisfies\n  // the Shape union at runtime based on which shape was passed in.\n  return {\n    id,\n    name,\n    shape,\n    feature: styledFeature,\n    lastUpdated: Date.now(),\n    locked: false,\n  } as Shape;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAM,SAAS,UAAU;CACvB,SAAS,QAAQ,IAAI,aAAa;CAClC,OAAO;CACP,QAAQ;CACR,QAAQ;CACT,CAAC;;;;AAKF,SAAS,kBAAkB,OAAiC;AAE1D,QAAO,OAAO,MAAM,qBADF,IAAI,MAAM,EAAC,oBAAoB,CACf;;;;;;;;AASpC,SAAS,wBACP,UAC8B;CAC9B,MAAM,cAAc,SAAS,YAAY;AACzC,KAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,SAAO,KACL,yEACD;AACD;;CAQF,MAAM,SAJgB,SAAS;EAC7B,MAAM;EACN,aAAa,SAAS;EACvB,CAAC,CAC2B,SAAS;AAKtC,KAAI,EADF,OAAO,SAAS,OAAO,GAAG,IAAI,OAAO,SAAS,OAAO,GAAG,GACtC;AAClB,SAAO,KAAK,+DAA+D;AAC3E;;CAIF,MAAM,aAAa,YAAY;AAO/B,KAAI,EAHF,cACA,OAAO,SAAS,WAAW,GAAG,IAC9B,OAAO,SAAS,WAAW,GAAG,GACR;AACtB,SAAO,KACL,mEACD;AACD;;CAGF,MAAM,SAAS,SAAS,QAAQ,YAAY,EAC1C,OAAO,wBACR,CAAC;AAGF,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,UAAU,GAAG;AAC3C,SAAO,KAAK,4DAA4D;AACxE;;AAGF,QAAO;EACL;EACA,QAAQ;GACN,OAAO;GACP,OAAO;GACR;EACF;;;;;;;;AAoBH,SAAS,yBACP,SAC+B;CAC/B,MAAM,YACJ,QAAQ,YACP;AAEH,KAAI,CAAC,aAAa,UAAU,UAAU,WAAW;AAC/C,SAAO,KACL,sFACD;AACD;;AAGF,QAAO;EACL,QAAQ,UAAU;EAClB,WAAW;GACT,OAAO,UAAU,UAAU;GAC3B,OAAO;GACR;EACD,WAAW;GACT,OAAO,UAAU,UAAU;GAC3B,OAAO;GACR;EACD,OAAO,UAAU;EAClB;;;;;;;;;;;;;;;;;;AAmBH,SAAgB,sBACd,SACA,OACA,eACO;CACP,MAAM,KAAK,MAAM;CACjB,MAAM,OAAO,kBAAkB,MAAM;CAGrC,MAAMA,kBAAmC;EACvC,GAAG;EACH,GAAI,iBAAiB,EAAE;EACxB;CAGD,IAAIC;AACJ,KACE,UAAUC,iBAAqB,UAC/B,QAAQ,SAAS,SAAS,UAE1B,oBAAmB,wBAAwB,QAAQ,SAAS;CAI9D,IAAIC;AACJ,KACE,UAAUD,iBAAqB,WAC/B,QAAQ,SAAS,SAAS,UAE1B,qBAAoB,yBAAyB,QAAQ;AAkBvD,QAAO;EACL;EACA;EACA;EACA,SAlBkC;GAClC,MAAM;GACN,UAAU,QAAQ;GAClB,YAAY;IACV;IACA;IACA;IACA,SAAS;IACV;GACF;EAUC,aAAa,KAAK,KAAK;EACvB,QAAQ;EACT"}
+{"version":3,"file":"feature-conversion.js","names":["styleProperties: StyleProperties","circleProperties: CircleProperties | undefined","ShapeFeatureTypeEnum","ellipseProperties: EllipseProperties | undefined"],"sources":["../../../../../src/deckgl/shapes/draw-shape-layer/utils/feature-conversion.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 { uuid } from '@accelint/core';\nimport { getLogger } from '@accelint/logger';\nimport { centroid, distance } from '@turf/turf';\nimport { DEFAULT_DISTANCE_UNITS } from '@/shared/units';\nimport { DEFAULT_STYLE_PROPERTIES } from '../../shared/constants';\nimport {\n  type CircleProperties,\n  type EllipseProperties,\n  type Shape,\n  type ShapeFeature,\n  type ShapeFeatureType,\n  ShapeFeatureType as ShapeFeatureTypeEnum,\n  type StyleProperties,\n} from '../../shared/types';\nimport type { Feature, Polygon, Position } from 'geojson';\n\nconst logger = getLogger({\n  enabled: process.env.NODE_ENV !== 'production',\n  level: 'warn',\n  prefix: '[FeatureConversion]',\n  pretty: true,\n});\n\n/**\n * Generate a default name for a shape based on its type.\n *\n * Creates a name in the format \"New {ShapeType} (HH:MM:SS AM/PM)\" using the\n * current time. This provides a default name for shapes created through the\n * drawing interface that includes a timestamp for uniqueness.\n *\n * @param shape - The shape type to generate a name for\n * @returns A formatted name string with timestamp\n *\n * @example\n * ```typescript\n * import { generateShapeName } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';\n * import { ShapeFeatureType } from '@accelint/map-toolkit/deckgl/shapes/shared/types';\n *\n * const name = generateShapeName(ShapeFeatureType.Polygon);\n * // Returns: \"New Polygon (2:30:45 PM)\"\n * ```\n */\nfunction generateShapeName(shape: ShapeFeatureType): string {\n  const timestamp = new Date().toLocaleTimeString();\n  return `New ${shape} (${timestamp})`;\n}\n\n/**\n * Compute circle properties from a polygon geometry (circle approximation).\n *\n * The EditableGeoJsonLayer creates circles as polygon approximations with multiple\n * vertices arranged in a circular pattern. This function extracts the original circle's\n * center and radius from that polygon approximation.\n *\n * The center is calculated using Turf's centroid function, and the radius is computed\n * as the distance from the center to the first edge point.\n *\n * @param geometry - Polygon geometry representing a circle approximation\n * @returns Circle properties with center and radius, or undefined if computation fails\n *\n * @example\n * ```typescript\n * import { computeCircleProperties } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';\n * import type { Polygon } from 'geojson';\n *\n * const polygonGeometry: Polygon = {\n *   type: 'Polygon',\n *   coordinates: [[\n *     [-122.4, 37.8],\n *     [-122.39, 37.81],\n *     // ... more points forming a circle\n *     [-122.4, 37.8], // closing point\n *   ]],\n * };\n *\n * const circleProps = computeCircleProperties(polygonGeometry);\n * // Returns: { center: [-122.395, 37.805], radius: { value: 1.5, units: 'kilometers' } }\n * ```\n */\nfunction computeCircleProperties(\n  geometry: Polygon,\n): CircleProperties | undefined {\n  const coordinates = geometry.coordinates[0];\n  if (!coordinates || coordinates.length < 3) {\n    logger.warn(\n      'Cannot compute circle properties: polygon has insufficient coordinates',\n    );\n    return undefined;\n  }\n\n  // Calculate center using turf centroid\n  const centerFeature = centroid({\n    type: 'Polygon',\n    coordinates: geometry.coordinates,\n  });\n  const center = centerFeature.geometry.coordinates as [number, number];\n\n  // Validate center coordinates are valid numbers\n  const isCenterValid =\n    Number.isFinite(center[0]) && Number.isFinite(center[1]);\n  if (!isCenterValid) {\n    logger.warn('Cannot compute circle properties: invalid center coordinates');\n    return undefined;\n  }\n\n  // Calculate radius as distance from center to first point\n  const firstPoint = coordinates[0] as Position;\n\n  // Validate first point coordinates\n  const isFirstPointValid =\n    firstPoint &&\n    Number.isFinite(firstPoint[0]) &&\n    Number.isFinite(firstPoint[1]);\n  if (!isFirstPointValid) {\n    logger.warn(\n      'Cannot compute circle properties: invalid edge point coordinates',\n    );\n    return undefined;\n  }\n\n  const radius = distance(center, firstPoint, {\n    units: DEFAULT_DISTANCE_UNITS,\n  });\n\n  // Validate computed radius\n  if (!Number.isFinite(radius) || radius <= 0) {\n    logger.warn('Cannot compute circle properties: invalid radius computed');\n    return undefined;\n  }\n\n  return {\n    center,\n    radius: {\n      value: radius,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n  };\n}\n\n/**\n * Edit properties attached by DrawEllipseUsingThreePointsMode.\n *\n * The DrawEllipseUsingThreePointsMode from @deck.gl-community/editable-layers\n * attaches ellipse metadata to the feature's properties.editProperties field.\n * This interface defines the structure of that metadata.\n *\n * @internal\n */\ninterface EllipseEditProperties {\n  /** Shape discriminator - always 'Ellipse' */\n  shape: 'Ellipse';\n  /** X semi-axis (horizontal radius) with value and unit */\n  xSemiAxis: { value: number; unit: string };\n  /** Y semi-axis (vertical radius) with value and unit */\n  ySemiAxis: { value: number; unit: string };\n  /** Rotation angle in degrees */\n  angle: number;\n  /** Center point coordinates [longitude, latitude] */\n  center: [number, number];\n}\n\n/**\n * Compute ellipse properties from a feature's editProperties.\n *\n * The DrawEllipseUsingThreePointsMode attaches ellipse metadata to the feature's\n * properties.editProperties field. This function extracts and normalizes that data\n * into the standard EllipseProperties format used by Shape objects.\n *\n * The function validates that editProperties exists and has the correct shape\n * discriminator before extracting the ellipse parameters.\n *\n * @param feature - GeoJSON feature with editProperties attached by the draw mode\n * @returns Normalized ellipse properties, or undefined if extraction fails\n *\n * @example\n * ```typescript\n * import { computeEllipseProperties } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';\n * import type { Feature } from 'geojson';\n *\n * const feature: Feature = {\n *   type: 'Feature',\n *   geometry: { type: 'Polygon', coordinates: [[...]] },\n *   properties: {\n *     editProperties: {\n *       shape: 'Ellipse',\n *       center: [-122.4, 37.8],\n *       xSemiAxis: { value: 2.5, unit: 'kilometers' },\n *       ySemiAxis: { value: 1.5, unit: 'kilometers' },\n *       angle: 45,\n *     },\n *   },\n * };\n *\n * const ellipseProps = computeEllipseProperties(feature);\n * // Returns normalized ellipse properties with standard distance units\n * ```\n */\nfunction computeEllipseProperties(\n  feature: Feature,\n): EllipseProperties | undefined {\n  const editProps = (\n    feature.properties as { editProperties?: EllipseEditProperties } | null\n  )?.editProperties;\n\n  if (!editProps || editProps.shape !== 'Ellipse') {\n    logger.warn(\n      'Cannot compute ellipse properties: feature missing editProperties or not an ellipse',\n    );\n    return undefined;\n  }\n\n  return {\n    center: editProps.center,\n    xSemiAxis: {\n      value: editProps.xSemiAxis.value,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n    ySemiAxis: {\n      value: editProps.ySemiAxis.value,\n      units: DEFAULT_DISTANCE_UNITS,\n    },\n    angle: editProps.angle,\n  };\n}\n\n/**\n * Convert a raw GeoJSON Feature from EditableGeoJsonLayer to a Shape.\n *\n * This function transforms the raw GeoJSON features produced by deck.gl's\n * EditableGeoJsonLayer into the Shape format used throughout the map-toolkit.\n * It handles geometry normalization, style property merging, and special handling\n * for Circle and Ellipse shapes which are stored as polygon approximations.\n *\n * ## The returned Shape includes:\n * - **Auto-generated UUID**: Unique identifier for the shape\n * - **Auto-generated name**: Format \"New {ShapeType} (HH:MM:SS AM/PM)\"\n * - **Merged style properties**: Defaults + optional custom overrides\n * - **Circle/ellipse properties**: Computed from geometry if applicable\n * - **lastUpdated timestamp**: UTC timestamp when created\n * - **locked: false**: Newly created shapes are always unlocked\n *\n * ## Special Handling\n * - **Circles**: Extracts center and radius from polygon approximation\n * - **Ellipses**: Extracts center, semi-axes, and angle from editProperties\n *\n * @param feature - The raw GeoJSON feature from the editable layer\n * @param shape - The type of shape being created\n * @param styleDefaults - Optional style property overrides (colors, line width, etc.)\n * @returns A complete Shape object ready for use in DisplayShapeLayer\n *\n * @example Basic usage with polygon\n * ```typescript\n * import { convertFeatureToShape } from '@accelint/map-toolkit/deckgl/shapes/draw-shape-layer/utils/feature-conversion';\n * import { ShapeFeatureType } from '@accelint/map-toolkit/deckgl/shapes/shared/types';\n * import type { Feature } from 'geojson';\n *\n * const feature: Feature = {\n *   type: 'Feature',\n *   geometry: {\n *     type: 'Polygon',\n *     coordinates: [[\n *       [-122.4, 37.8],\n *       [-122.3, 37.8],\n *       [-122.3, 37.9],\n *       [-122.4, 37.9],\n *       [-122.4, 37.8],\n *     ]],\n *   },\n *   properties: {},\n * };\n *\n * const shape = convertFeatureToShape(feature, ShapeFeatureType.Polygon);\n * // Returns: { id: 'uuid...', name: 'New Polygon (2:30:45 PM)', shape: 'Polygon', ... }\n * ```\n *\n * @example With custom style defaults\n * ```typescript\n * const shape = convertFeatureToShape(\n *   feature,\n *   ShapeFeatureType.Circle,\n *   {\n *     fillColor: [255, 100, 100, 180],   // RGBA: red fill\n *     lineColor: [200, 0, 0, 255],        // RGBA: dark red line\n *     lineWidth: 4,\n *     linePattern: 'solid',\n *   }\n * );\n * // Returns a shape with custom colors applied\n * ```\n */\nexport function convertFeatureToShape(\n  feature: Feature,\n  shape: ShapeFeatureType,\n  styleDefaults?: Partial<StyleProperties> | null,\n): Shape {\n  const id = uuid();\n  const name = generateShapeName(shape);\n\n  // Merge default styles with any provided defaults\n  const styleProperties: StyleProperties = {\n    ...DEFAULT_STYLE_PROPERTIES,\n    ...(styleDefaults ?? {}),\n  };\n\n  // Compute circle properties if this is a circle\n  let circleProperties: CircleProperties | undefined;\n  if (\n    shape === ShapeFeatureTypeEnum.Circle &&\n    feature.geometry.type === 'Polygon'\n  ) {\n    circleProperties = computeCircleProperties(feature.geometry);\n  }\n\n  // Compute ellipse properties if this is an ellipse\n  let ellipseProperties: EllipseProperties | undefined;\n  if (\n    shape === ShapeFeatureTypeEnum.Ellipse &&\n    feature.geometry.type === 'Polygon'\n  ) {\n    ellipseProperties = computeEllipseProperties(feature);\n  }\n\n  // Create the styled feature\n  const styledFeature: ShapeFeature = {\n    type: 'Feature',\n    geometry: feature.geometry,\n    properties: {\n      styleProperties,\n      circleProperties,\n      ellipseProperties,\n      shapeId: id,\n    },\n  };\n\n  // Type assertion needed because TypeScript can't narrow the return type\n  // based on the runtime shape value. The constructed object satisfies\n  // the Shape union at runtime based on which shape was passed in.\n  return {\n    id,\n    name,\n    shape,\n    feature: styledFeature,\n    lastUpdated: Date.now(),\n    locked: false,\n  } as Shape;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAM,SAAS,UAAU;CACvB,SAAS,QAAQ,IAAI,aAAa;CAClC,OAAO;CACP,QAAQ;CACR,QAAQ;CACT,CAAC;;;;;;;;;;;;;;;;;;;;AAqBF,SAAS,kBAAkB,OAAiC;AAE1D,QAAO,OAAO,MAAM,qBADF,IAAI,MAAM,EAAC,oBAAoB,CACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCpC,SAAS,wBACP,UAC8B;CAC9B,MAAM,cAAc,SAAS,YAAY;AACzC,KAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,SAAO,KACL,yEACD;AACD;;CAQF,MAAM,SAJgB,SAAS;EAC7B,MAAM;EACN,aAAa,SAAS;EACvB,CAAC,CAC2B,SAAS;AAKtC,KAAI,EADF,OAAO,SAAS,OAAO,GAAG,IAAI,OAAO,SAAS,OAAO,GAAG,GACtC;AAClB,SAAO,KAAK,+DAA+D;AAC3E;;CAIF,MAAM,aAAa,YAAY;AAO/B,KAAI,EAHF,cACA,OAAO,SAAS,WAAW,GAAG,IAC9B,OAAO,SAAS,WAAW,GAAG,GACR;AACtB,SAAO,KACL,mEACD;AACD;;CAGF,MAAM,SAAS,SAAS,QAAQ,YAAY,EAC1C,OAAO,wBACR,CAAC;AAGF,KAAI,CAAC,OAAO,SAAS,OAAO,IAAI,UAAU,GAAG;AAC3C,SAAO,KAAK,4DAA4D;AACxE;;AAGF,QAAO;EACL;EACA,QAAQ;GACN,OAAO;GACP,OAAO;GACR;EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DH,SAAS,yBACP,SAC+B;CAC/B,MAAM,YACJ,QAAQ,YACP;AAEH,KAAI,CAAC,aAAa,UAAU,UAAU,WAAW;AAC/C,SAAO,KACL,sFACD;AACD;;AAGF,QAAO;EACL,QAAQ,UAAU;EAClB,WAAW;GACT,OAAO,UAAU,UAAU;GAC3B,OAAO;GACR;EACD,WAAW;GACT,OAAO,UAAU,UAAU;GAC3B,OAAO;GACR;EACD,OAAO,UAAU;EAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEH,SAAgB,sBACd,SACA,OACA,eACO;CACP,MAAM,KAAK,MAAM;CACjB,MAAM,OAAO,kBAAkB,MAAM;CAGrC,MAAMA,kBAAmC;EACvC,GAAG;EACH,GAAI,iBAAiB,EAAE;EACxB;CAGD,IAAIC;AACJ,KACE,UAAUC,iBAAqB,UAC/B,QAAQ,SAAS,SAAS,UAE1B,oBAAmB,wBAAwB,QAAQ,SAAS;CAI9D,IAAIC;AACJ,KACE,UAAUD,iBAAqB,WAC/B,QAAQ,SAAS,SAAS,UAE1B,qBAAoB,yBAAyB,QAAQ;AAkBvD,QAAO;EACL;EACA;EACA;EACA,SAlBkC;GAClC,MAAM;GACN,UAAU,QAAQ;GAClB,YAAY;IACV;IACA;IACA;IACA,SAAS;IACV;GACF;EAUC,aAAa,KAAK,KAAK;EACvB,QAAQ;EACT"}

package/dist/deckgl/shapes/edit-shape-layer/events.js

@@ -34,7 +34,7 @@
 *
 * When emitting these events via the bus, use type assertions:
 * @example
-* ```ts
+* ```typescript
 * bus.emit('shapes:updated', {
 *   type: 'shapes:updated',
 *   payload: { shape, mapId },

package/dist/deckgl/shapes/edit-shape-layer/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../../../src/deckgl/shapes/edit-shape-layer/events.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/**\n * Edit Shape Events\n *\n * Note on event payload structure:\n * These events define explicit payload types rather than using the `Payload<T, P>` helper\n * from @accelint/bus. This is because the `Shape` type contains GeoJSON `Feature` objects\n * from the `geojson` package, which don't satisfy TypeScript's `StructuredCloneable` type\n * constraint used by the bus.\n *\n * The issue: `StructuredCloneable` (from type-fest) requires objects to have an index\n * signature `[key: string]: StructuredCloneable`, but GeoJSON interfaces define strict\n * property types without index signatures. At runtime, GeoJSON data IS structurally\n * cloneable (can be passed through postMessage, stored in IndexedDB, etc.), but\n * TypeScript can't verify this statically.\n *\n * Events that only contain primitive values (like ShapeId, mapId) can use the `Payload`\n * helper directly - see shared/events.ts for examples.\n *\n * When emitting these events via the bus, use type assertions:\n * @example\n * ```ts\n * bus.emit('shapes:updated', {\n *   type: 'shapes:updated',\n *   payload: { shape, mapId },\n *   source: componentId,\n * } as unknown as Payload);\n * ```\n */\n\n'use client';\n\nimport type { UniqueId } from '@accelint/core';\nimport type { Shape } from '../shared/types';\n\n/**\n * Edit shape lifecycle events\n */\nexport const EditShapeEvents = {\n  /** Editing has started for a shape */\n  editing: 'shapes:editing',\n  /** Shape has been successfully updated */\n  updated: 'shapes:updated',\n  /** Editing was canceled */\n  canceled: 'shapes:edit-canceled',\n} as const;\n\nexport type EditShapeEventType =\n  (typeof EditShapeEvents)[keyof typeof EditShapeEvents];\n\n/**\n * Payload for shapes:editing event.\n */\nexport type ShapeEditingPayload = {\n  /** The shape being edited */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:editing\n * Emitted when editing starts\n */\nexport type ShapeEditingEvent = {\n  type: 'shapes:editing';\n  payload: ShapeEditingPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Payload for shapes:updated event.\n */\nexport type ShapeUpdatedPayload = {\n  /** The updated shape with new geometry */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:updated\n * Emitted when shape edits are saved\n */\nexport type ShapeUpdatedEvent = {\n  type: 'shapes:updated';\n  payload: ShapeUpdatedPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Payload for shapes:edit-canceled event.\n */\nexport type ShapeEditCanceledPayload = {\n  /** The shape that was being edited (original, unchanged) */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:edit-canceled\n * Emitted when editing is canceled\n */\nexport type ShapeEditCanceledEvent = {\n  type: 'shapes:edit-canceled';\n  payload: ShapeEditCanceledPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Union of all edit shape event types\n */\nexport type EditShapeEvent =\n  | ShapeEditingEvent\n  | ShapeUpdatedEvent\n  | ShapeEditCanceledEvent;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,MAAa,kBAAkB;CAE7B,SAAS;CAET,SAAS;CAET,UAAU;CACX"}
+{"version":3,"file":"events.js","names":[],"sources":["../../../../src/deckgl/shapes/edit-shape-layer/events.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/**\n * Edit Shape Events\n *\n * Note on event payload structure:\n * These events define explicit payload types rather than using the `Payload<T, P>` helper\n * from @accelint/bus. This is because the `Shape` type contains GeoJSON `Feature` objects\n * from the `geojson` package, which don't satisfy TypeScript's `StructuredCloneable` type\n * constraint used by the bus.\n *\n * The issue: `StructuredCloneable` (from type-fest) requires objects to have an index\n * signature `[key: string]: StructuredCloneable`, but GeoJSON interfaces define strict\n * property types without index signatures. At runtime, GeoJSON data IS structurally\n * cloneable (can be passed through postMessage, stored in IndexedDB, etc.), but\n * TypeScript can't verify this statically.\n *\n * Events that only contain primitive values (like ShapeId, mapId) can use the `Payload`\n * helper directly - see shared/events.ts for examples.\n *\n * When emitting these events via the bus, use type assertions:\n * @example\n * ```typescript\n * bus.emit('shapes:updated', {\n *   type: 'shapes:updated',\n *   payload: { shape, mapId },\n *   source: componentId,\n * } as unknown as Payload);\n * ```\n */\n\n'use client';\n\nimport type { UniqueId } from '@accelint/core';\nimport type { Shape } from '../shared/types';\n\n/**\n * Edit shape lifecycle events\n */\nexport const EditShapeEvents = {\n  /** Editing has started for a shape */\n  editing: 'shapes:editing',\n  /** Shape has been successfully updated */\n  updated: 'shapes:updated',\n  /** Editing was canceled */\n  canceled: 'shapes:edit-canceled',\n} as const;\n\nexport type EditShapeEventType =\n  (typeof EditShapeEvents)[keyof typeof EditShapeEvents];\n\n/**\n * Payload for shapes:editing event.\n */\nexport type ShapeEditingPayload = {\n  /** The shape being edited */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:editing\n * Emitted when editing starts\n */\nexport type ShapeEditingEvent = {\n  type: 'shapes:editing';\n  payload: ShapeEditingPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Payload for shapes:updated event.\n */\nexport type ShapeUpdatedPayload = {\n  /** The updated shape with new geometry */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:updated\n * Emitted when shape edits are saved\n */\nexport type ShapeUpdatedEvent = {\n  type: 'shapes:updated';\n  payload: ShapeUpdatedPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Payload for shapes:edit-canceled event.\n */\nexport type ShapeEditCanceledPayload = {\n  /** The shape that was being edited (original, unchanged) */\n  shape: Shape;\n  /** Map instance ID for multi-map event isolation */\n  mapId: UniqueId;\n};\n\n/**\n * Event payload for shapes:edit-canceled\n * Emitted when editing is canceled\n */\nexport type ShapeEditCanceledEvent = {\n  type: 'shapes:edit-canceled';\n  payload: ShapeEditCanceledPayload;\n  source: UniqueId;\n  target?: UniqueId;\n};\n\n/**\n * Union of all edit shape event types\n */\nexport type EditShapeEvent =\n  | ShapeEditingEvent\n  | ShapeUpdatedEvent\n  | ShapeEditCanceledEvent;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,MAAa,kBAAkB;CAE7B,SAAS;CAET,SAAS;CAET,UAAU;CACX"}

package/dist/deckgl/shapes/edit-shape-layer/index.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { EditShapeLayerProps } from "./types.js";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 
 //#region src/deckgl/shapes/edit-shape-layer/index.d.ts
 
@@ -57,7 +57,7 @@ declare function EditShapeLayer({
   id,
   mapId,
   unit
-}: EditShapeLayerProps): react_jsx_runtime3.JSX.Element | null;
+}: EditShapeLayerProps): react_jsx_runtime1.JSX.Element | null;
 //#endregion
 export { EditShapeLayer };
 //# sourceMappingURL=index.d.ts.map

package/dist/deckgl/shapes/edit-shape-layer/index.js

@@ -26,9 +26,23 @@ import { useContext, useEffect, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/deckgl/shapes/edit-shape-layer/index.tsx
+/**
+* Check if an edit type is a continuous event (fires during drag).
+* Continuous events are batched with RAF for smooth performance.
+*
+* @param editType - The edit type string from EditableGeoJsonLayer
+* @returns True if the edit type is continuous (e.g., 'translating', 'scaling', 'rotating')
+*/
 function isContinuousEditType(editType) {
 	return CONTINUOUS_EDIT_TYPES.has(editType);
 }
+/**
+* Check if an edit type is a completion event (fires at drag end).
+* Completion events update state immediately without RAF batching.
+*
+* @param editType - The edit type string from EditableGeoJsonLayer
+* @returns True if the edit type is a completion event (e.g., 'translated', 'scaled', 'rotated')
+*/
 function isCompletionEditType(editType) {
 	return COMPLETION_EDIT_TYPES.has(editType);
 }

package/dist/deckgl/shapes/edit-shape-layer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["shapeProperty: string | undefined"],"sources":["../../../../src/deckgl/shapes/edit-shape-layer/index.tsx"],"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 { useContext, useEffect, useRef } from 'react';\nimport { MapContext } from '../../base-map/provider';\nimport { useShiftZoomDisable } from '../shared/hooks/use-shift-zoom-disable';\nimport { ShapeFeatureType, type ShapeFeatureTypeValues } from '../shared/types';\nimport { getDefaultEditableLayerProps } from '../shared/utils/layer-config';\nimport { getFillColor, getLineColor } from '../shared/utils/style-utils';\nimport {\n  COMPLETION_EDIT_TYPES,\n  CONTINUOUS_EDIT_TYPES,\n  EDIT_SHAPE_LAYER_ID,\n} from './constants';\nimport { getEditModeInstance } from './modes';\nimport {\n  cancelEditingFromLayer,\n  editStore,\n  updateFeatureFromLayer,\n} from './store';\nimport type {\n  EditAction,\n  FeatureCollection,\n} from '@deck.gl-community/editable-layers';\nimport type { Feature } from 'geojson';\nimport type { EditShapeLayerProps } from './types';\n\nfunction isContinuousEditType(editType: string): boolean {\n  return CONTINUOUS_EDIT_TYPES.has(editType);\n}\n\nfunction isCompletionEditType(editType: string): boolean {\n  return COMPLETION_EDIT_TYPES.has(editType);\n}\n\n/**\n * Convert a GeoJSON Feature to a FeatureCollection for EditableGeoJsonLayer.\n * The editable-layers library accepts standard GeoJSON FeatureCollection at runtime,\n * but has stricter internal types. We use the geojson types which are compatible.\n *\n * For circles, adds the `shape: 'Circle'` property required by ResizeCircleMode.\n * ResizeCircleMode checks `properties.shape.includes('Circle')` to identify circles.\n *\n * For rectangles, adds the `shape: 'Rectangle'` property required by ModifyMode's\n * lockRectangles feature. ModifyMode checks `properties.shape === 'Rectangle'`.\n */\nfunction toFeatureCollection(\n  feature: Feature,\n  shape: ShapeFeatureTypeValues,\n): import('geojson').FeatureCollection {\n  // Add shape property for modes that require it\n  // - ResizeCircleMode requires shape: 'Circle'\n  // - ModifyMode lockRectangles requires shape: 'Rectangle'\n  let shapeProperty: string | undefined;\n  if (shape === ShapeFeatureType.Circle) {\n    shapeProperty = 'Circle';\n  } else if (shape === ShapeFeatureType.Rectangle) {\n    shapeProperty = 'Rectangle';\n  }\n\n  const featureWithShape = shapeProperty\n    ? {\n        ...feature,\n        properties: {\n          ...feature.properties,\n          shape: shapeProperty,\n        },\n      }\n    : feature;\n\n  return {\n    type: 'FeatureCollection',\n    features: [featureWithShape],\n  };\n}\n\n/**\n * EditShapeLayer - A React component for editing existing shapes on the map.\n *\n * This component wraps the EditableGeoJsonLayer from @deck.gl-community/editable-layers\n * and integrates with the map-mode and map-cursor systems for proper coordination.\n *\n * Key features:\n * - Renders only when actively editing (returns null otherwise)\n * - Uses cached mode instances to prevent deck.gl assertion errors\n * - Integrates with the editing store for state management\n * - Neutral mode authorization (lets UI decide how to handle mode conflicts)\n * - Circles use ResizeCircleMode with tooltip, other shapes use ModifyMode\n * - Fill colors rendered at 20% opacity, edit handles are white\n * - Live dimension/area tooltips during editing\n * - requestAnimationFrame() batching for smooth drag performance\n *\n * @example\n * ```tsx\n * // Import the fiber registration for JSX support\n * import '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/fiber';\n * import '@accelint/map-toolkit/deckgl/shapes/display-shape-layer/fiber';\n *\n * function Map({ mapId }) {\n *   const { editingShape } = useEditShape(mapId);\n *\n *   return (\n *     <BaseMap id={mapId}>\n *       <displayShapeLayer\n *         data={shapes}\n *         mapId={mapId}\n *         selectedShapeId={editingShape?.id}\n *       />\n *       <EditShapeLayer mapId={mapId} />\n *     </BaseMap>\n *   );\n * }\n * ```\n */\nexport function EditShapeLayer({\n  id = EDIT_SHAPE_LAYER_ID,\n  mapId,\n  unit,\n}: EditShapeLayerProps) {\n  // Get mapId from context if not provided\n  const contextId = useContext(MapContext);\n  const actualMapId = mapId ?? contextId;\n\n  if (!actualMapId) {\n    throw new Error(\n      'EditShapeLayer requires either a mapId prop or to be used within a MapProvider',\n    );\n  }\n\n  // Subscribe to editing state using the v2 store API\n  const { state: editingState } = editStore.use(actualMapId);\n\n  const isEditing = editingState?.editingShape != null;\n\n  // Disable zoom while Shift is held during editing\n  // This prevents boxZoom (Shift+drag) from interfering with Shift modifier constraints\n  // (e.g., Shift for uniform scaling, Shift for rotation snap)\n  useShiftZoomDisable(actualMapId, isEditing);\n\n  // RAF batching for movePosition events to reduce React updates during drag\n  const pendingUpdateRef = useRef<{\n    feature: Feature;\n    rafId: number;\n  } | null>(null);\n\n  // Cleanup RAF on unmount\n  useEffect(() => {\n    return () => {\n      if (pendingUpdateRef.current) {\n        cancelAnimationFrame(pendingUpdateRef.current.rafId);\n      }\n    };\n  }, []);\n\n  // If not editing, return null (don't render the editable layer)\n  if (!editingState?.editingShape) {\n    return null;\n  }\n\n  const { editingShape, editMode, featureBeingEdited } = editingState;\n\n  // Get the cached mode instance\n  const mode = getEditModeInstance(editMode);\n\n  // Use the live feature being edited, or fall back to original shape\n  const featureToRender = featureBeingEdited ?? editingShape.feature;\n  const data = toFeatureCollection(featureToRender, editingShape.shape);\n\n  // Helper to cancel any pending RAF update\n  const cancelPendingUpdate = () => {\n    if (pendingUpdateRef.current) {\n      cancelAnimationFrame(pendingUpdateRef.current.rafId);\n      pendingUpdateRef.current = null;\n    }\n  };\n\n  // Handle edit events from EditableGeoJsonLayer\n  const handleEdit = ({\n    updatedData,\n    editType,\n  }: EditAction<FeatureCollection>) => {\n    const feature = updatedData.features[0];\n\n    // Continuous events (during drag): batch with RAF for smooth performance\n    if (isContinuousEditType(editType) && feature) {\n      cancelPendingUpdate();\n      const rafId = requestAnimationFrame(() => {\n        updateFeatureFromLayer(actualMapId, feature as Feature);\n        pendingUpdateRef.current = null;\n      });\n      pendingUpdateRef.current = { feature: feature as Feature, rafId };\n      return;\n    }\n\n    // Completion events (drag end): update immediately\n    if (isCompletionEditType(editType)) {\n      cancelPendingUpdate();\n      if (feature) {\n        updateFeatureFromLayer(actualMapId, feature as Feature);\n      }\n      return;\n    }\n\n    // ESC key cancellation\n    if (editType === 'cancelFeature') {\n      cancelPendingUpdate();\n      cancelEditingFromLayer(actualMapId);\n    }\n  };\n\n  // Get colors from the shape's existing style properties with base opacity applied\n  const fillColor = getFillColor(editingShape.feature, true);\n  const lineColor = getLineColor(editingShape.feature);\n\n  return (\n    <editableGeoJsonLayer\n      id={id}\n      data={data}\n      mode={mode}\n      selectedFeatureIndexes={[0]}\n      onEdit={handleEdit}\n      getFillColor={fillColor}\n      getLineColor={lineColor}\n      getTentativeFillColor={fillColor}\n      getTentativeLineColor={lineColor}\n      {...getDefaultEditableLayerProps(unit)}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAS,qBAAqB,UAA2B;AACvD,QAAO,sBAAsB,IAAI,SAAS;;AAG5C,SAAS,qBAAqB,UAA2B;AACvD,QAAO,sBAAsB,IAAI,SAAS;;;;;;;;;;;;;AAc5C,SAAS,oBACP,SACA,OACqC;CAIrC,IAAIA;AACJ,KAAI,UAAU,iBAAiB,OAC7B,iBAAgB;UACP,UAAU,iBAAiB,UACpC,iBAAgB;AAalB,QAAO;EACL,MAAM;EACN,UAAU,CAZa,gBACrB;GACE,GAAG;GACH,YAAY;IACV,GAAG,QAAQ;IACX,OAAO;IACR;GACF,GACD,QAI0B;EAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCH,SAAgB,eAAe,EAC7B,KAAK,qBACL,OACA,QACsB;CAEtB,MAAM,YAAY,WAAW,WAAW;CACxC,MAAM,cAAc,SAAS;AAE7B,KAAI,CAAC,YACH,OAAM,IAAI,MACR,iFACD;CAIH,MAAM,EAAE,OAAO,iBAAiB,UAAU,IAAI,YAAY;AAO1D,qBAAoB,aALF,cAAc,gBAAgB,KAKL;CAG3C,MAAM,mBAAmB,OAGf,KAAK;AAGf,iBAAgB;AACd,eAAa;AACX,OAAI,iBAAiB,QACnB,sBAAqB,iBAAiB,QAAQ,MAAM;;IAGvD,EAAE,CAAC;AAGN,KAAI,CAAC,cAAc,aACjB,QAAO;CAGT,MAAM,EAAE,cAAc,UAAU,uBAAuB;CAGvD,MAAM,OAAO,oBAAoB,SAAS;CAI1C,MAAM,OAAO,oBADW,sBAAsB,aAAa,SACT,aAAa,MAAM;CAGrE,MAAM,4BAA4B;AAChC,MAAI,iBAAiB,SAAS;AAC5B,wBAAqB,iBAAiB,QAAQ,MAAM;AACpD,oBAAiB,UAAU;;;CAK/B,MAAM,cAAc,EAClB,aACA,eACmC;EACnC,MAAM,UAAU,YAAY,SAAS;AAGrC,MAAI,qBAAqB,SAAS,IAAI,SAAS;AAC7C,wBAAqB;AAKrB,oBAAiB,UAAU;IAAW;IAAoB,OAJ5C,4BAA4B;AACxC,4BAAuB,aAAa,QAAmB;AACvD,sBAAiB,UAAU;MAC3B;IAC+D;AACjE;;AAIF,MAAI,qBAAqB,SAAS,EAAE;AAClC,wBAAqB;AACrB,OAAI,QACF,wBAAuB,aAAa,QAAmB;AAEzD;;AAIF,MAAI,aAAa,iBAAiB;AAChC,wBAAqB;AACrB,0BAAuB,YAAY;;;CAKvC,MAAM,YAAY,aAAa,aAAa,SAAS,KAAK;CAC1D,MAAM,YAAY,aAAa,aAAa,QAAQ;AAEpD,QACE,oBAAC;EACK;EACE;EACA;EACN,wBAAwB,CAAC,EAAE;EAC3B,QAAQ;EACR,cAAc;EACd,cAAc;EACd,uBAAuB;EACvB,uBAAuB;EACvB,GAAI,6BAA6B,KAAK;GACtC"}
+{"version":3,"file":"index.js","names":["shapeProperty: string | undefined"],"sources":["../../../../src/deckgl/shapes/edit-shape-layer/index.tsx"],"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 { useContext, useEffect, useRef } from 'react';\nimport { MapContext } from '../../base-map/provider';\nimport { useShiftZoomDisable } from '../shared/hooks/use-shift-zoom-disable';\nimport { ShapeFeatureType, type ShapeFeatureTypeValues } from '../shared/types';\nimport { getDefaultEditableLayerProps } from '../shared/utils/layer-config';\nimport { getFillColor, getLineColor } from '../shared/utils/style-utils';\nimport {\n  COMPLETION_EDIT_TYPES,\n  CONTINUOUS_EDIT_TYPES,\n  EDIT_SHAPE_LAYER_ID,\n} from './constants';\nimport { getEditModeInstance } from './modes';\nimport {\n  cancelEditingFromLayer,\n  editStore,\n  updateFeatureFromLayer,\n} from './store';\nimport type {\n  EditAction,\n  FeatureCollection,\n} from '@deck.gl-community/editable-layers';\nimport type { Feature } from 'geojson';\nimport type { EditShapeLayerProps } from './types';\n\n/**\n * Check if an edit type is a continuous event (fires during drag).\n * Continuous events are batched with RAF for smooth performance.\n *\n * @param editType - The edit type string from EditableGeoJsonLayer\n * @returns True if the edit type is continuous (e.g., 'translating', 'scaling', 'rotating')\n */\nfunction isContinuousEditType(editType: string): boolean {\n  return CONTINUOUS_EDIT_TYPES.has(editType);\n}\n\n/**\n * Check if an edit type is a completion event (fires at drag end).\n * Completion events update state immediately without RAF batching.\n *\n * @param editType - The edit type string from EditableGeoJsonLayer\n * @returns True if the edit type is a completion event (e.g., 'translated', 'scaled', 'rotated')\n */\nfunction isCompletionEditType(editType: string): boolean {\n  return COMPLETION_EDIT_TYPES.has(editType);\n}\n\n/**\n * Convert a GeoJSON Feature to a FeatureCollection for EditableGeoJsonLayer.\n * The editable-layers library accepts standard GeoJSON FeatureCollection at runtime,\n * but has stricter internal types. We use the geojson types which are compatible.\n *\n * For circles, adds the `shape: 'Circle'` property required by ResizeCircleMode.\n * ResizeCircleMode checks `properties.shape.includes('Circle')` to identify circles.\n *\n * For rectangles, adds the `shape: 'Rectangle'` property required by ModifyMode's\n * lockRectangles feature. ModifyMode checks `properties.shape === 'Rectangle'`.\n */\nfunction toFeatureCollection(\n  feature: Feature,\n  shape: ShapeFeatureTypeValues,\n): import('geojson').FeatureCollection {\n  // Add shape property for modes that require it\n  // - ResizeCircleMode requires shape: 'Circle'\n  // - ModifyMode lockRectangles requires shape: 'Rectangle'\n  let shapeProperty: string | undefined;\n  if (shape === ShapeFeatureType.Circle) {\n    shapeProperty = 'Circle';\n  } else if (shape === ShapeFeatureType.Rectangle) {\n    shapeProperty = 'Rectangle';\n  }\n\n  const featureWithShape = shapeProperty\n    ? {\n        ...feature,\n        properties: {\n          ...feature.properties,\n          shape: shapeProperty,\n        },\n      }\n    : feature;\n\n  return {\n    type: 'FeatureCollection',\n    features: [featureWithShape],\n  };\n}\n\n/**\n * EditShapeLayer - A React component for editing existing shapes on the map.\n *\n * This component wraps the EditableGeoJsonLayer from @deck.gl-community/editable-layers\n * and integrates with the map-mode and map-cursor systems for proper coordination.\n *\n * Key features:\n * - Renders only when actively editing (returns null otherwise)\n * - Uses cached mode instances to prevent deck.gl assertion errors\n * - Integrates with the editing store for state management\n * - Neutral mode authorization (lets UI decide how to handle mode conflicts)\n * - Circles use ResizeCircleMode with tooltip, other shapes use ModifyMode\n * - Fill colors rendered at 20% opacity, edit handles are white\n * - Live dimension/area tooltips during editing\n * - requestAnimationFrame() batching for smooth drag performance\n *\n * @example\n * ```tsx\n * // Import the fiber registration for JSX support\n * import '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/fiber';\n * import '@accelint/map-toolkit/deckgl/shapes/display-shape-layer/fiber';\n *\n * function Map({ mapId }) {\n *   const { editingShape } = useEditShape(mapId);\n *\n *   return (\n *     <BaseMap id={mapId}>\n *       <displayShapeLayer\n *         data={shapes}\n *         mapId={mapId}\n *         selectedShapeId={editingShape?.id}\n *       />\n *       <EditShapeLayer mapId={mapId} />\n *     </BaseMap>\n *   );\n * }\n * ```\n */\nexport function EditShapeLayer({\n  id = EDIT_SHAPE_LAYER_ID,\n  mapId,\n  unit,\n}: EditShapeLayerProps) {\n  // Get mapId from context if not provided\n  const contextId = useContext(MapContext);\n  const actualMapId = mapId ?? contextId;\n\n  if (!actualMapId) {\n    throw new Error(\n      'EditShapeLayer requires either a mapId prop or to be used within a MapProvider',\n    );\n  }\n\n  // Subscribe to editing state using the v2 store API\n  const { state: editingState } = editStore.use(actualMapId);\n\n  const isEditing = editingState?.editingShape != null;\n\n  // Disable zoom while Shift is held during editing\n  // This prevents boxZoom (Shift+drag) from interfering with Shift modifier constraints\n  // (e.g., Shift for uniform scaling, Shift for rotation snap)\n  useShiftZoomDisable(actualMapId, isEditing);\n\n  // RAF batching for movePosition events to reduce React updates during drag\n  const pendingUpdateRef = useRef<{\n    feature: Feature;\n    rafId: number;\n  } | null>(null);\n\n  // Cleanup RAF on unmount\n  useEffect(() => {\n    return () => {\n      if (pendingUpdateRef.current) {\n        cancelAnimationFrame(pendingUpdateRef.current.rafId);\n      }\n    };\n  }, []);\n\n  // If not editing, return null (don't render the editable layer)\n  if (!editingState?.editingShape) {\n    return null;\n  }\n\n  const { editingShape, editMode, featureBeingEdited } = editingState;\n\n  // Get the cached mode instance\n  const mode = getEditModeInstance(editMode);\n\n  // Use the live feature being edited, or fall back to original shape\n  const featureToRender = featureBeingEdited ?? editingShape.feature;\n  const data = toFeatureCollection(featureToRender, editingShape.shape);\n\n  // Helper to cancel any pending RAF update\n  const cancelPendingUpdate = () => {\n    if (pendingUpdateRef.current) {\n      cancelAnimationFrame(pendingUpdateRef.current.rafId);\n      pendingUpdateRef.current = null;\n    }\n  };\n\n  // Handle edit events from EditableGeoJsonLayer\n  const handleEdit = ({\n    updatedData,\n    editType,\n  }: EditAction<FeatureCollection>) => {\n    const feature = updatedData.features[0];\n\n    // Continuous events (during drag): batch with RAF for smooth performance\n    if (isContinuousEditType(editType) && feature) {\n      cancelPendingUpdate();\n      const rafId = requestAnimationFrame(() => {\n        updateFeatureFromLayer(actualMapId, feature as Feature);\n        pendingUpdateRef.current = null;\n      });\n      pendingUpdateRef.current = { feature: feature as Feature, rafId };\n      return;\n    }\n\n    // Completion events (drag end): update immediately\n    if (isCompletionEditType(editType)) {\n      cancelPendingUpdate();\n      if (feature) {\n        updateFeatureFromLayer(actualMapId, feature as Feature);\n      }\n      return;\n    }\n\n    // ESC key cancellation\n    if (editType === 'cancelFeature') {\n      cancelPendingUpdate();\n      cancelEditingFromLayer(actualMapId);\n    }\n  };\n\n  // Get colors from the shape's existing style properties with base opacity applied\n  const fillColor = getFillColor(editingShape.feature, true);\n  const lineColor = getLineColor(editingShape.feature);\n\n  return (\n    <editableGeoJsonLayer\n      id={id}\n      data={data}\n      mode={mode}\n      selectedFeatureIndexes={[0]}\n      onEdit={handleEdit}\n      getFillColor={fillColor}\n      getLineColor={lineColor}\n      getTentativeFillColor={fillColor}\n      getTentativeLineColor={lineColor}\n      {...getDefaultEditableLayerProps(unit)}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAS,qBAAqB,UAA2B;AACvD,QAAO,sBAAsB,IAAI,SAAS;;;;;;;;;AAU5C,SAAS,qBAAqB,UAA2B;AACvD,QAAO,sBAAsB,IAAI,SAAS;;;;;;;;;;;;;AAc5C,SAAS,oBACP,SACA,OACqC;CAIrC,IAAIA;AACJ,KAAI,UAAU,iBAAiB,OAC7B,iBAAgB;UACP,UAAU,iBAAiB,UACpC,iBAAgB;AAalB,QAAO;EACL,MAAM;EACN,UAAU,CAZa,gBACrB;GACE,GAAG;GACH,YAAY;IACV,GAAG,QAAQ;IACX,OAAO;IACR;GACF,GACD,QAI0B;EAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCH,SAAgB,eAAe,EAC7B,KAAK,qBACL,OACA,QACsB;CAEtB,MAAM,YAAY,WAAW,WAAW;CACxC,MAAM,cAAc,SAAS;AAE7B,KAAI,CAAC,YACH,OAAM,IAAI,MACR,iFACD;CAIH,MAAM,EAAE,OAAO,iBAAiB,UAAU,IAAI,YAAY;AAO1D,qBAAoB,aALF,cAAc,gBAAgB,KAKL;CAG3C,MAAM,mBAAmB,OAGf,KAAK;AAGf,iBAAgB;AACd,eAAa;AACX,OAAI,iBAAiB,QACnB,sBAAqB,iBAAiB,QAAQ,MAAM;;IAGvD,EAAE,CAAC;AAGN,KAAI,CAAC,cAAc,aACjB,QAAO;CAGT,MAAM,EAAE,cAAc,UAAU,uBAAuB;CAGvD,MAAM,OAAO,oBAAoB,SAAS;CAI1C,MAAM,OAAO,oBADW,sBAAsB,aAAa,SACT,aAAa,MAAM;CAGrE,MAAM,4BAA4B;AAChC,MAAI,iBAAiB,SAAS;AAC5B,wBAAqB,iBAAiB,QAAQ,MAAM;AACpD,oBAAiB,UAAU;;;CAK/B,MAAM,cAAc,EAClB,aACA,eACmC;EACnC,MAAM,UAAU,YAAY,SAAS;AAGrC,MAAI,qBAAqB,SAAS,IAAI,SAAS;AAC7C,wBAAqB;AAKrB,oBAAiB,UAAU;IAAW;IAAoB,OAJ5C,4BAA4B;AACxC,4BAAuB,aAAa,QAAmB;AACvD,sBAAiB,UAAU;MAC3B;IAC+D;AACjE;;AAIF,MAAI,qBAAqB,SAAS,EAAE;AAClC,wBAAqB;AACrB,OAAI,QACF,wBAAuB,aAAa,QAAmB;AAEzD;;AAIF,MAAI,aAAa,iBAAiB;AAChC,wBAAqB;AACrB,0BAAuB,YAAY;;;CAKvC,MAAM,YAAY,aAAa,aAAa,SAAS,KAAK;CAC1D,MAAM,YAAY,aAAa,aAAa,QAAQ;AAEpD,QACE,oBAAC;EACK;EACE;EACA;EACN,wBAAwB,CAAC,EAAE;EAC3B,QAAQ;EACR,cAAc;EACd,cAAc;EACd,uBAAuB;EACvB,uBAAuB;EACvB,GAAI,6BAA6B,KAAK;GACtC"}

package/dist/deckgl/shapes/edit-shape-layer/modes/base-transform-mode.js

@@ -21,15 +21,63 @@ import { CompositeMode } from "@deck.gl-community/editable-layers";
 * This class extracts the common patterns shared by CircleTransformMode,
 * BoundingTransformMode, and VertexTransformMode:
 *
-* - Active mode tracking during drag operations
-* - Cursor aggregation from child modes
-* - Pick-based mode selection at drag start
-* - Shift key modifier handling for scale/rotate operations
-* - Clean state reset on drag stop
-* - Pick filtering to prevent TypeError from sublayer elements
+* ## Core Responsibilities
+* - **Active mode tracking**: Tracks which child mode is handling the drag operation
+* - **Cursor aggregation**: Combines cursor updates from all child modes
+* - **Pick-based delegation**: Selects mode at drag start based on picked handles
+* - **Shift key modifiers**: Dynamic Shift key handling for scale/rotate operations
+* - **State management**: Clean state reset on drag stop
+* - **Pick filtering**: Prevents TypeError from sublayer elements without geometry
 *
-* Subclasses define their specific modes and handle matchers, while this
-* base class handles the delegation logic.
+* ## Implementation Pattern
+* Subclasses define their specific child modes and handle matchers, while this
+* base class handles the delegation logic. The pattern is:
+*
+* 1. Define child mode instances in constructor
+* 2. Implement `getHandleMatchers()` to map picks to modes
+* 3. Implement `getDefaultMode()` for fallback behavior
+* 4. Optionally override `onDragging()` for tooltips or side effects
+*
+* ## How Mode Selection Works
+* At drag start, the base class evaluates handle matchers in order:
+* - First matcher that matches any pick wins
+* - If no matcher matches, uses the default mode
+* - Selected mode remains active for the entire drag operation
+*
+* @example Implementing a custom transform mode
+* ```typescript
+* import { BaseTransformMode, type HandleMatcher } from './base-transform-mode';
+* import { TranslateMode, RotateMode } from '@deck.gl-community/editable-layers';
+*
+* class MyTransformMode extends BaseTransformMode {
+*   private translateMode: TranslateMode;
+*   private rotateMode: RotateMode;
+*
+*   constructor() {
+*     const translateMode = new TranslateMode();
+*     const rotateMode = new RotateMode();
+*     super([rotateMode, translateMode]); // Order matters for cursor handling
+*
+*     this.translateMode = translateMode;
+*     this.rotateMode = rotateMode;
+*   }
+*
+*   protected getHandleMatchers(): HandleMatcher[] {
+*     return [
+*       {
+*         match: (pick) =>
+*           Boolean(pick.isGuide && pick.object?.properties?.editHandleType === 'rotate'),
+*         mode: this.rotateMode,
+*         shiftConfig: { configKey: 'snapRotation' },
+*       },
+*     ];
+*   }
+*
+*   protected getDefaultMode() {
+*     return this.translateMode; // Dragging body translates by default
+*   }
+* }
+* ```
 */
 var BaseTransformMode = class extends CompositeMode {
 	/** Track which mode is currently handling the drag operation */

package/dist/deckgl/shapes/edit-shape-layer/modes/base-transform-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-transform-mode.js","names":["updatedCursor: string | null | undefined","propsWithConfig: ModeProps<FeatureCollection>","filteredProps: ModeProps<FeatureCollection>"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/base-transform-mode.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  CompositeMode,\n  type DraggingEvent,\n  type FeatureCollection,\n  type GeoJsonEditMode,\n  type GuideFeatureCollection,\n  type ModeProps,\n  type PointerMoveEvent,\n  type StartDraggingEvent,\n  type StopDraggingEvent,\n  type Tooltip,\n} from '@deck.gl-community/editable-layers';\nimport { filterGeometryAwarePicks } from '../../shared/utils/pick-filtering';\n\n/**\n * Configuration for how a mode handles the Shift key modifier.\n */\nexport type ShiftKeyConfig = {\n  /** The modeConfig property name to set (e.g., 'lockScaling', 'snapRotation') */\n  configKey: string;\n  /** The value to set when Shift is held (defaults to true) */\n  value?: boolean;\n};\n\n/**\n * Definition for how to detect and handle a specific edit handle type.\n */\nexport type HandleMatcher = {\n  /** Function to determine if a pick matches this handle type */\n  match: (pick: {\n    isGuide?: boolean;\n    object?: {\n      properties?: {\n        guideType?: string;\n        editHandleType?: string;\n        mode?: string;\n      };\n    };\n  }) => boolean;\n  /** The mode instance to delegate to when this handle is matched */\n  mode: GeoJsonEditMode;\n  /** Optional Shift key configuration for this mode */\n  shiftConfig?: ShiftKeyConfig;\n};\n\n/**\n * Abstract base class for composite transform modes.\n *\n * This class extracts the common patterns shared by CircleTransformMode,\n * BoundingTransformMode, and VertexTransformMode:\n *\n * - Active mode tracking during drag operations\n * - Cursor aggregation from child modes\n * - Pick-based mode selection at drag start\n * - Shift key modifier handling for scale/rotate operations\n * - Clean state reset on drag stop\n * - Pick filtering to prevent TypeError from sublayer elements\n *\n * Subclasses define their specific modes and handle matchers, while this\n * base class handles the delegation logic.\n */\nexport abstract class BaseTransformMode extends CompositeMode {\n  /** Track which mode is currently handling the drag operation */\n  protected activeDragMode: GeoJsonEditMode | null = null;\n\n  /** Track current Shift state for dynamic modifier behavior */\n  protected isShiftHeld = false;\n\n  /** Tooltip for operations that show live measurements */\n  protected tooltip: Tooltip | null = null;\n\n  /**\n   * Get the handle matchers that define how picks map to modes.\n   * Matchers are evaluated in order; first match wins.\n   * The last matcher should typically be a catch-all for the default mode.\n   */\n  protected abstract getHandleMatchers(): HandleMatcher[];\n\n  /**\n   * Get the default mode to use when no handle matchers match.\n   * This is typically TranslateMode for dragging the shape body.\n   */\n  protected abstract getDefaultMode(): GeoJsonEditMode;\n\n  /**\n   * Optional hook called during drag when the active mode is set.\n   * Subclasses can override to update tooltips or perform other side effects.\n   */\n  protected onDragging?(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void;\n\n  /**\n   * Aggregates cursor updates from all child modes.\n   * The first non-null cursor from any mode is used.\n   */\n  override handlePointerMove(\n    event: PointerMoveEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    let updatedCursor: string | null | undefined = null;\n\n    super.handlePointerMove(event, {\n      ...props,\n      onUpdateCursor: (cursor: string | null | undefined) => {\n        updatedCursor = cursor || updatedCursor;\n      },\n    });\n\n    props.onUpdateCursor(updatedCursor);\n  }\n\n  /**\n   * Determines which mode should handle the drag based on picked handles.\n   * Cancels map panning and delegates to the matched mode.\n   */\n  override handleStartDragging(\n    event: StartDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (event.picks.length) {\n      event.cancelPan();\n    }\n\n    const picks = event.picks ?? [];\n    const matchers = this.getHandleMatchers();\n\n    // Find the first matcher that matches any pick\n    for (const matcher of matchers) {\n      if (picks.some(matcher.match)) {\n        this.activeDragMode = matcher.mode;\n        break;\n      }\n    }\n\n    // Fall back to default mode if no matcher matched\n    if (!this.activeDragMode) {\n      this.activeDragMode = this.getDefaultMode();\n    }\n\n    this.activeDragMode.handleStartDragging(event, props);\n  }\n\n  /**\n   * Delegates dragging to the active mode with Shift key handling.\n   * Reads Shift state from the source event and applies configured modifiers.\n   */\n  override handleDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (!this.activeDragMode) {\n      return;\n    }\n\n    const sourceEvent = event.sourceEvent as KeyboardEvent | undefined;\n    this.isShiftHeld = sourceEvent?.shiftKey ?? false;\n\n    // Find the matcher for the active mode to get shift config\n    const matchers = this.getHandleMatchers();\n    const activeMatcher = matchers.find((m) => m.mode === this.activeDragMode);\n    const shiftConfig = activeMatcher?.shiftConfig;\n\n    // Apply shift key modifier if configured\n    if (shiftConfig && this.isShiftHeld) {\n      const propsWithConfig: ModeProps<FeatureCollection> = {\n        ...props,\n        modeConfig: {\n          ...props.modeConfig,\n          [shiftConfig.configKey]: shiftConfig.value ?? true,\n        },\n      };\n      this.activeDragMode.handleDragging(event, propsWithConfig);\n    } else {\n      this.activeDragMode.handleDragging(event, props);\n    }\n\n    // Call subclass hook for tooltips or other side effects\n    this.onDragging?.(event, props);\n  }\n\n  /**\n   * Delegates stop dragging to the active mode with final Shift state.\n   * Resets all drag-related state.\n   */\n  override handleStopDragging(\n    event: StopDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (!this.activeDragMode) {\n      return;\n    }\n\n    // Find the matcher for the active mode to get shift config\n    const matchers = this.getHandleMatchers();\n    const activeMatcher = matchers.find((m) => m.mode === this.activeDragMode);\n    const shiftConfig = activeMatcher?.shiftConfig;\n\n    // Apply shift key modifier if configured (use last known state)\n    if (shiftConfig && this.isShiftHeld) {\n      const propsWithConfig: ModeProps<FeatureCollection> = {\n        ...props,\n        modeConfig: {\n          ...props.modeConfig,\n          [shiftConfig.configKey]: shiftConfig.value ?? true,\n        },\n      };\n      this.activeDragMode.handleStopDragging(event, propsWithConfig);\n    } else {\n      this.activeDragMode.handleStopDragging(event, props);\n    }\n\n    this.resetDragState();\n  }\n\n  /**\n   * Returns tooltips for display during drag operations.\n   * Subclasses update `this.tooltip` in their `onDragging` hook.\n   */\n  override getTooltips(): Tooltip[] {\n    return this.tooltip ? [this.tooltip] : [];\n  }\n\n  /**\n   * Filters picks to prevent TypeError from sublayer elements without geometry.\n   *\n   * Some child modes (like ModifyMode, ResizeCircleMode) access\n   * `pick.object.geometry.type` which throws if the pick doesn't have\n   * a geometry property. This happens when picks include sublayer elements\n   * like tooltip text that aren't GeoJSON features.\n   */\n  override getGuides(\n    props: ModeProps<FeatureCollection>,\n  ): GuideFeatureCollection {\n    const picks = props.lastPointerMoveEvent?.picks;\n\n    if (picks && picks.length > 0) {\n      const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);\n\n      if (didFilter) {\n        const filteredProps: ModeProps<FeatureCollection> = {\n          ...props,\n          lastPointerMoveEvent: {\n            ...props.lastPointerMoveEvent,\n            picks: filteredPicks,\n          },\n        };\n        return super.getGuides(filteredProps);\n      }\n    }\n\n    return super.getGuides(props);\n  }\n\n  /**\n   * Resets drag-related state. Called after drag stops.\n   * Subclasses can override to reset additional state but should call super.\n   */\n  protected resetDragState(): void {\n    this.activeDragMode = null;\n    this.isShiftHeld = false;\n    this.tooltip = null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,IAAsB,oBAAtB,cAAgD,cAAc;;CAE5D,AAAU,iBAAyC;;CAGnD,AAAU,cAAc;;CAGxB,AAAU,UAA0B;;;;;CA4BpC,AAAS,kBACP,OACA,OACA;EACA,IAAIA,gBAA2C;AAE/C,QAAM,kBAAkB,OAAO;GAC7B,GAAG;GACH,iBAAiB,WAAsC;AACrD,oBAAgB,UAAU;;GAE7B,CAAC;AAEF,QAAM,eAAe,cAAc;;;;;;CAOrC,AAAS,oBACP,OACA,OACA;AACA,MAAI,MAAM,MAAM,OACd,OAAM,WAAW;EAGnB,MAAM,QAAQ,MAAM,SAAS,EAAE;EAC/B,MAAM,WAAW,KAAK,mBAAmB;AAGzC,OAAK,MAAM,WAAW,SACpB,KAAI,MAAM,KAAK,QAAQ,MAAM,EAAE;AAC7B,QAAK,iBAAiB,QAAQ;AAC9B;;AAKJ,MAAI,CAAC,KAAK,eACR,MAAK,iBAAiB,KAAK,gBAAgB;AAG7C,OAAK,eAAe,oBAAoB,OAAO,MAAM;;;;;;CAOvD,AAAS,eACP,OACA,OACA;AACA,MAAI,CAAC,KAAK,eACR;AAIF,OAAK,cADe,MAAM,aACM,YAAY;EAK5C,MAAM,cAFW,KAAK,mBAAmB,CACV,MAAM,MAAM,EAAE,SAAS,KAAK,eAAe,EACvC;AAGnC,MAAI,eAAe,KAAK,aAAa;GACnC,MAAMC,kBAAgD;IACpD,GAAG;IACH,YAAY;KACV,GAAG,MAAM;MACR,YAAY,YAAY,YAAY,SAAS;KAC/C;IACF;AACD,QAAK,eAAe,eAAe,OAAO,gBAAgB;QAE1D,MAAK,eAAe,eAAe,OAAO,MAAM;AAIlD,OAAK,aAAa,OAAO,MAAM;;;;;;CAOjC,AAAS,mBACP,OACA,OACA;AACA,MAAI,CAAC,KAAK,eACR;EAMF,MAAM,cAFW,KAAK,mBAAmB,CACV,MAAM,MAAM,EAAE,SAAS,KAAK,eAAe,EACvC;AAGnC,MAAI,eAAe,KAAK,aAAa;GACnC,MAAMA,kBAAgD;IACpD,GAAG;IACH,YAAY;KACV,GAAG,MAAM;MACR,YAAY,YAAY,YAAY,SAAS;KAC/C;IACF;AACD,QAAK,eAAe,mBAAmB,OAAO,gBAAgB;QAE9D,MAAK,eAAe,mBAAmB,OAAO,MAAM;AAGtD,OAAK,gBAAgB;;;;;;CAOvB,AAAS,cAAyB;AAChC,SAAO,KAAK,UAAU,CAAC,KAAK,QAAQ,GAAG,EAAE;;;;;;;;;;CAW3C,AAAS,UACP,OACwB;EACxB,MAAM,QAAQ,MAAM,sBAAsB;AAE1C,MAAI,SAAS,MAAM,SAAS,GAAG;GAC7B,MAAM,EAAE,eAAe,cAAc,yBAAyB,MAAM;AAEpE,OAAI,WAAW;IACb,MAAMC,gBAA8C;KAClD,GAAG;KACH,sBAAsB;MACpB,GAAG,MAAM;MACT,OAAO;MACR;KACF;AACD,WAAO,MAAM,UAAU,cAAc;;;AAIzC,SAAO,MAAM,UAAU,MAAM;;;;;;CAO/B,AAAU,iBAAuB;AAC/B,OAAK,iBAAiB;AACtB,OAAK,cAAc;AACnB,OAAK,UAAU"}
+{"version":3,"file":"base-transform-mode.js","names":["updatedCursor: string | null | undefined","propsWithConfig: ModeProps<FeatureCollection>","filteredProps: ModeProps<FeatureCollection>"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/base-transform-mode.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  CompositeMode,\n  type DraggingEvent,\n  type FeatureCollection,\n  type GeoJsonEditMode,\n  type GuideFeatureCollection,\n  type ModeProps,\n  type PointerMoveEvent,\n  type StartDraggingEvent,\n  type StopDraggingEvent,\n  type Tooltip,\n} from '@deck.gl-community/editable-layers';\nimport { filterGeometryAwarePicks } from '../../shared/utils/pick-filtering';\n\n/**\n * Configuration for how a mode handles the Shift key modifier.\n */\nexport type ShiftKeyConfig = {\n  /** The modeConfig property name to set (e.g., 'lockScaling', 'snapRotation') */\n  configKey: string;\n  /** The value to set when Shift is held (defaults to true) */\n  value?: boolean;\n};\n\n/**\n * Definition for how to detect and handle a specific edit handle type.\n */\nexport type HandleMatcher = {\n  /** Function to determine if a pick matches this handle type */\n  match: (pick: {\n    isGuide?: boolean;\n    object?: {\n      properties?: {\n        guideType?: string;\n        editHandleType?: string;\n        mode?: string;\n      };\n    };\n  }) => boolean;\n  /** The mode instance to delegate to when this handle is matched */\n  mode: GeoJsonEditMode;\n  /** Optional Shift key configuration for this mode */\n  shiftConfig?: ShiftKeyConfig;\n};\n\n/**\n * Abstract base class for composite transform modes.\n *\n * This class extracts the common patterns shared by CircleTransformMode,\n * BoundingTransformMode, and VertexTransformMode:\n *\n * ## Core Responsibilities\n * - **Active mode tracking**: Tracks which child mode is handling the drag operation\n * - **Cursor aggregation**: Combines cursor updates from all child modes\n * - **Pick-based delegation**: Selects mode at drag start based on picked handles\n * - **Shift key modifiers**: Dynamic Shift key handling for scale/rotate operations\n * - **State management**: Clean state reset on drag stop\n * - **Pick filtering**: Prevents TypeError from sublayer elements without geometry\n *\n * ## Implementation Pattern\n * Subclasses define their specific child modes and handle matchers, while this\n * base class handles the delegation logic. The pattern is:\n *\n * 1. Define child mode instances in constructor\n * 2. Implement `getHandleMatchers()` to map picks to modes\n * 3. Implement `getDefaultMode()` for fallback behavior\n * 4. Optionally override `onDragging()` for tooltips or side effects\n *\n * ## How Mode Selection Works\n * At drag start, the base class evaluates handle matchers in order:\n * - First matcher that matches any pick wins\n * - If no matcher matches, uses the default mode\n * - Selected mode remains active for the entire drag operation\n *\n * @example Implementing a custom transform mode\n * ```typescript\n * import { BaseTransformMode, type HandleMatcher } from './base-transform-mode';\n * import { TranslateMode, RotateMode } from '@deck.gl-community/editable-layers';\n *\n * class MyTransformMode extends BaseTransformMode {\n *   private translateMode: TranslateMode;\n *   private rotateMode: RotateMode;\n *\n *   constructor() {\n *     const translateMode = new TranslateMode();\n *     const rotateMode = new RotateMode();\n *     super([rotateMode, translateMode]); // Order matters for cursor handling\n *\n *     this.translateMode = translateMode;\n *     this.rotateMode = rotateMode;\n *   }\n *\n *   protected getHandleMatchers(): HandleMatcher[] {\n *     return [\n *       {\n *         match: (pick) =>\n *           Boolean(pick.isGuide && pick.object?.properties?.editHandleType === 'rotate'),\n *         mode: this.rotateMode,\n *         shiftConfig: { configKey: 'snapRotation' },\n *       },\n *     ];\n *   }\n *\n *   protected getDefaultMode() {\n *     return this.translateMode; // Dragging body translates by default\n *   }\n * }\n * ```\n */\nexport abstract class BaseTransformMode extends CompositeMode {\n  /** Track which mode is currently handling the drag operation */\n  protected activeDragMode: GeoJsonEditMode | null = null;\n\n  /** Track current Shift state for dynamic modifier behavior */\n  protected isShiftHeld = false;\n\n  /** Tooltip for operations that show live measurements */\n  protected tooltip: Tooltip | null = null;\n\n  /**\n   * Get the handle matchers that define how picks map to modes.\n   * Matchers are evaluated in order; first match wins.\n   * The last matcher should typically be a catch-all for the default mode.\n   */\n  protected abstract getHandleMatchers(): HandleMatcher[];\n\n  /**\n   * Get the default mode to use when no handle matchers match.\n   * This is typically TranslateMode for dragging the shape body.\n   */\n  protected abstract getDefaultMode(): GeoJsonEditMode;\n\n  /**\n   * Optional hook called during drag when the active mode is set.\n   * Subclasses can override to update tooltips or perform other side effects.\n   */\n  protected onDragging?(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void;\n\n  /**\n   * Aggregates cursor updates from all child modes.\n   * The first non-null cursor from any mode is used.\n   */\n  override handlePointerMove(\n    event: PointerMoveEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    let updatedCursor: string | null | undefined = null;\n\n    super.handlePointerMove(event, {\n      ...props,\n      onUpdateCursor: (cursor: string | null | undefined) => {\n        updatedCursor = cursor || updatedCursor;\n      },\n    });\n\n    props.onUpdateCursor(updatedCursor);\n  }\n\n  /**\n   * Determines which mode should handle the drag based on picked handles.\n   * Cancels map panning and delegates to the matched mode.\n   */\n  override handleStartDragging(\n    event: StartDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (event.picks.length) {\n      event.cancelPan();\n    }\n\n    const picks = event.picks ?? [];\n    const matchers = this.getHandleMatchers();\n\n    // Find the first matcher that matches any pick\n    for (const matcher of matchers) {\n      if (picks.some(matcher.match)) {\n        this.activeDragMode = matcher.mode;\n        break;\n      }\n    }\n\n    // Fall back to default mode if no matcher matched\n    if (!this.activeDragMode) {\n      this.activeDragMode = this.getDefaultMode();\n    }\n\n    this.activeDragMode.handleStartDragging(event, props);\n  }\n\n  /**\n   * Delegates dragging to the active mode with Shift key handling.\n   * Reads Shift state from the source event and applies configured modifiers.\n   */\n  override handleDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (!this.activeDragMode) {\n      return;\n    }\n\n    const sourceEvent = event.sourceEvent as KeyboardEvent | undefined;\n    this.isShiftHeld = sourceEvent?.shiftKey ?? false;\n\n    // Find the matcher for the active mode to get shift config\n    const matchers = this.getHandleMatchers();\n    const activeMatcher = matchers.find((m) => m.mode === this.activeDragMode);\n    const shiftConfig = activeMatcher?.shiftConfig;\n\n    // Apply shift key modifier if configured\n    if (shiftConfig && this.isShiftHeld) {\n      const propsWithConfig: ModeProps<FeatureCollection> = {\n        ...props,\n        modeConfig: {\n          ...props.modeConfig,\n          [shiftConfig.configKey]: shiftConfig.value ?? true,\n        },\n      };\n      this.activeDragMode.handleDragging(event, propsWithConfig);\n    } else {\n      this.activeDragMode.handleDragging(event, props);\n    }\n\n    // Call subclass hook for tooltips or other side effects\n    this.onDragging?.(event, props);\n  }\n\n  /**\n   * Delegates stop dragging to the active mode with final Shift state.\n   * Resets all drag-related state.\n   */\n  override handleStopDragging(\n    event: StopDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    if (!this.activeDragMode) {\n      return;\n    }\n\n    // Find the matcher for the active mode to get shift config\n    const matchers = this.getHandleMatchers();\n    const activeMatcher = matchers.find((m) => m.mode === this.activeDragMode);\n    const shiftConfig = activeMatcher?.shiftConfig;\n\n    // Apply shift key modifier if configured (use last known state)\n    if (shiftConfig && this.isShiftHeld) {\n      const propsWithConfig: ModeProps<FeatureCollection> = {\n        ...props,\n        modeConfig: {\n          ...props.modeConfig,\n          [shiftConfig.configKey]: shiftConfig.value ?? true,\n        },\n      };\n      this.activeDragMode.handleStopDragging(event, propsWithConfig);\n    } else {\n      this.activeDragMode.handleStopDragging(event, props);\n    }\n\n    this.resetDragState();\n  }\n\n  /**\n   * Returns tooltips for display during drag operations.\n   * Subclasses update `this.tooltip` in their `onDragging` hook.\n   */\n  override getTooltips(): Tooltip[] {\n    return this.tooltip ? [this.tooltip] : [];\n  }\n\n  /**\n   * Filters picks to prevent TypeError from sublayer elements without geometry.\n   *\n   * Some child modes (like ModifyMode, ResizeCircleMode) access\n   * `pick.object.geometry.type` which throws if the pick doesn't have\n   * a geometry property. This happens when picks include sublayer elements\n   * like tooltip text that aren't GeoJSON features.\n   */\n  override getGuides(\n    props: ModeProps<FeatureCollection>,\n  ): GuideFeatureCollection {\n    const picks = props.lastPointerMoveEvent?.picks;\n\n    if (picks && picks.length > 0) {\n      const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);\n\n      if (didFilter) {\n        const filteredProps: ModeProps<FeatureCollection> = {\n          ...props,\n          lastPointerMoveEvent: {\n            ...props.lastPointerMoveEvent,\n            picks: filteredPicks,\n          },\n        };\n        return super.getGuides(filteredProps);\n      }\n    }\n\n    return super.getGuides(props);\n  }\n\n  /**\n   * Resets drag-related state. Called after drag stops.\n   * Subclasses can override to reset additional state but should call super.\n   */\n  protected resetDragState(): void {\n    this.activeDragMode = null;\n    this.isShiftHeld = false;\n    this.tooltip = null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHA,IAAsB,oBAAtB,cAAgD,cAAc;;CAE5D,AAAU,iBAAyC;;CAGnD,AAAU,cAAc;;CAGxB,AAAU,UAA0B;;;;;CA4BpC,AAAS,kBACP,OACA,OACA;EACA,IAAIA,gBAA2C;AAE/C,QAAM,kBAAkB,OAAO;GAC7B,GAAG;GACH,iBAAiB,WAAsC;AACrD,oBAAgB,UAAU;;GAE7B,CAAC;AAEF,QAAM,eAAe,cAAc;;;;;;CAOrC,AAAS,oBACP,OACA,OACA;AACA,MAAI,MAAM,MAAM,OACd,OAAM,WAAW;EAGnB,MAAM,QAAQ,MAAM,SAAS,EAAE;EAC/B,MAAM,WAAW,KAAK,mBAAmB;AAGzC,OAAK,MAAM,WAAW,SACpB,KAAI,MAAM,KAAK,QAAQ,MAAM,EAAE;AAC7B,QAAK,iBAAiB,QAAQ;AAC9B;;AAKJ,MAAI,CAAC,KAAK,eACR,MAAK,iBAAiB,KAAK,gBAAgB;AAG7C,OAAK,eAAe,oBAAoB,OAAO,MAAM;;;;;;CAOvD,AAAS,eACP,OACA,OACA;AACA,MAAI,CAAC,KAAK,eACR;AAIF,OAAK,cADe,MAAM,aACM,YAAY;EAK5C,MAAM,cAFW,KAAK,mBAAmB,CACV,MAAM,MAAM,EAAE,SAAS,KAAK,eAAe,EACvC;AAGnC,MAAI,eAAe,KAAK,aAAa;GACnC,MAAMC,kBAAgD;IACpD,GAAG;IACH,YAAY;KACV,GAAG,MAAM;MACR,YAAY,YAAY,YAAY,SAAS;KAC/C;IACF;AACD,QAAK,eAAe,eAAe,OAAO,gBAAgB;QAE1D,MAAK,eAAe,eAAe,OAAO,MAAM;AAIlD,OAAK,aAAa,OAAO,MAAM;;;;;;CAOjC,AAAS,mBACP,OACA,OACA;AACA,MAAI,CAAC,KAAK,eACR;EAMF,MAAM,cAFW,KAAK,mBAAmB,CACV,MAAM,MAAM,EAAE,SAAS,KAAK,eAAe,EACvC;AAGnC,MAAI,eAAe,KAAK,aAAa;GACnC,MAAMA,kBAAgD;IACpD,GAAG;IACH,YAAY;KACV,GAAG,MAAM;MACR,YAAY,YAAY,YAAY,SAAS;KAC/C;IACF;AACD,QAAK,eAAe,mBAAmB,OAAO,gBAAgB;QAE9D,MAAK,eAAe,mBAAmB,OAAO,MAAM;AAGtD,OAAK,gBAAgB;;;;;;CAOvB,AAAS,cAAyB;AAChC,SAAO,KAAK,UAAU,CAAC,KAAK,QAAQ,GAAG,EAAE;;;;;;;;;;CAW3C,AAAS,UACP,OACwB;EACxB,MAAM,QAAQ,MAAM,sBAAsB;AAE1C,MAAI,SAAS,MAAM,SAAS,GAAG;GAC7B,MAAM,EAAE,eAAe,cAAc,yBAAyB,MAAM;AAEpE,OAAI,WAAW;IACb,MAAMC,gBAA8C;KAClD,GAAG;KACH,sBAAsB;MACpB,GAAG,MAAM;MACT,OAAO;MACR;KACF;AACD,WAAO,MAAM,UAAU,cAAc;;;AAIzC,SAAO,MAAM,UAAU,MAAM;;;;;;CAO/B,AAAU,iBAAuB;AAC/B,OAAK,iBAAiB;AACtB,OAAK,cAAc;AACnB,OAAK,UAAU"}

package/dist/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode.js

@@ -28,6 +28,7 @@ import { featureCollection } from "@turf/helpers";
 * editing is not meaningful or desired. Instead, shapes are manipulated via their
 * bounding box handles.
 *
+* ## Capabilities
 * This composite mode provides:
 * - **Translation** (TranslateMode): Drag the shape body to move it
 * - **Scaling** (ScaleModeWithFreeTransform): Drag corner handles to resize
@@ -38,12 +39,33 @@ import { featureCollection } from "@turf/helpers";
 *   - With Shift: Snap to 45° intervals
 * - **Live tooltip**: Shows dimensions and area during scaling
 *
+* ## Differences from VertexTransformMode
 * Unlike VertexTransformMode, this mode does NOT include vertex editing handles.
+* This prevents accidental distortion of shapes that have specific geometric constraints
+* (e.g., ellipses must maintain their elliptical shape, rectangles must maintain right angles).
 *
-* Priority logic:
-* - If hovering over a scale handle, scaling takes priority
-* - If hovering over the rotate handle, rotation takes priority
-* - Otherwise, dragging the shape body translates it
+* ## Handle Priority Logic
+* When drag starts, modes are evaluated in this priority order:
+* 1. If hovering over a scale handle → scaling takes priority
+* 2. If hovering over the rotate handle → rotation takes priority
+* 3. Otherwise → dragging the shape body translates it
+*
+* @example
+* ```typescript
+* import { BoundingTransformMode } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode';
+* import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';
+*
+* // Used internally by EditShapeLayer for rectangles and ellipses
+* const mode = new BoundingTransformMode();
+*
+* const layer = new EditableGeoJsonLayer({
+*   mode,
+*   data: rectangleFeatureCollection,
+*   selectedFeatureIndexes: [0],
+*   onEdit: handleEdit,
+*   // ... other props
+* });
+* ```
 */
 var BoundingTransformMode = class extends BaseTransformMode {
 	translateMode;

package/dist/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"bounding-transform-mode.js","names":["guidesToFilterOut: string[]","text: string"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode.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  type DraggingEvent,\n  type FeatureCollection,\n  type GeoJsonEditMode,\n  type GuideFeatureCollection,\n  type ModeProps,\n  TranslateMode,\n} from '@deck.gl-community/editable-layers';\nimport { featureCollection } from '@turf/helpers';\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitAbbreviation,\n} from '@/shared/units';\nimport {\n  formatEllipseTooltip,\n  formatRectangleTooltip,\n} from '../../shared/constants';\nimport {\n  computeEllipseMeasurementsFromPolygon,\n  computeRectangleMeasurementsFromCorners,\n} from '../../shared/utils/geometry-measurements';\nimport { BaseTransformMode, type HandleMatcher } from './base-transform-mode';\nimport { RotateModeWithSnap } from './rotate-mode-with-snap';\nimport { ScaleModeWithFreeTransform } from './scale-mode-with-free-transform';\nimport type { Feature, Polygon } from 'geojson';\n\n/**\n * Transform mode for shapes that use bounding box manipulation (no vertex editing).\n *\n * Use this mode for shapes like ellipses and rectangles where individual vertex\n * editing is not meaningful or desired. Instead, shapes are manipulated via their\n * bounding box handles.\n *\n * This composite mode provides:\n * - **Translation** (TranslateMode): Drag the shape body to move it\n * - **Scaling** (ScaleModeWithFreeTransform): Drag corner handles to resize\n *   - Default: Non-uniform scaling (can stretch/squish)\n *   - With Shift: Uniform scaling (maintains aspect ratio)\n * - **Rotation** (RotateModeWithSnap): Drag top handle to rotate\n *   - Default: Free rotation\n *   - With Shift: Snap to 45° intervals\n * - **Live tooltip**: Shows dimensions and area during scaling\n *\n * Unlike VertexTransformMode, this mode does NOT include vertex editing handles.\n *\n * Priority logic:\n * - If hovering over a scale handle, scaling takes priority\n * - If hovering over the rotate handle, rotation takes priority\n * - Otherwise, dragging the shape body translates it\n */\nexport class BoundingTransformMode extends BaseTransformMode {\n  private translateMode: TranslateMode;\n  private scaleMode: ScaleModeWithFreeTransform;\n  private rotateMode: RotateModeWithSnap;\n\n  constructor() {\n    const translateMode = new TranslateMode();\n    const scaleMode = new ScaleModeWithFreeTransform();\n    const rotateMode = new RotateModeWithSnap();\n\n    // Order: scale and rotate first so their handles take priority over translate\n    super([scaleMode, rotateMode, translateMode]);\n\n    this.translateMode = translateMode;\n    this.scaleMode = scaleMode;\n    this.rotateMode = rotateMode;\n  }\n\n  protected override getHandleMatchers(): HandleMatcher[] {\n    return [\n      {\n        // Scale handle: corner handles on bounding box\n        match: (pick) =>\n          Boolean(\n            pick.isGuide && pick.object?.properties?.editHandleType === 'scale',\n          ),\n        mode: this.scaleMode,\n        shiftConfig: { configKey: 'lockScaling' },\n      },\n      {\n        // Rotate handle: top handle on bounding box\n        match: (pick) =>\n          Boolean(\n            pick.isGuide &&\n              pick.object?.properties?.editHandleType === 'rotate',\n          ),\n        mode: this.rotateMode,\n        shiftConfig: { configKey: 'snapRotation' },\n      },\n    ];\n  }\n\n  protected override getDefaultMode(): GeoJsonEditMode {\n    return this.translateMode;\n  }\n\n  /**\n   * Update tooltip with shape dimensions during scaling.\n   */\n  protected override onDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void {\n    // Only show tooltip when scaling\n    if (this.activeDragMode !== this.scaleMode) {\n      return;\n    }\n\n    this.updateShapeTooltip(event, props);\n  }\n\n  /**\n   * Override getGuides to filter duplicate envelope guides.\n   *\n   * Both ScaleMode and RotateMode render the same bounding box envelope.\n   * We keep scale's envelope and filter rotate's duplicate.\n   * We also hide scale handles while rotating to avoid visual clutter.\n   */\n  override getGuides(\n    props: ModeProps<FeatureCollection>,\n  ): GuideFeatureCollection {\n    const allGuides = super.getGuides(props);\n\n    // biome-ignore lint/suspicious/noExplicitAny: Guide properties vary by mode, safely accessing with optional chaining\n    const filteredGuides = allGuides.features.filter((guide: any) => {\n      const properties = guide.properties || {};\n      const editHandleType = properties.editHandleType;\n      const mode = properties.mode;\n\n      // Both scale and rotate modes have the same enveloping box as a guide - only need one\n      const guidesToFilterOut: string[] = [mode as string];\n\n      // Do not render scaling edit handles if rotating\n      if (this.rotateMode.getIsRotating()) {\n        guidesToFilterOut.push(editHandleType as string);\n      }\n\n      return !guidesToFilterOut.includes('scale');\n    });\n\n    // biome-ignore lint/suspicious/noExplicitAny: turf types mismatch with editable-layers GeoJSON types\n    return featureCollection(filteredGuides as any) as any;\n  }\n\n  /**\n   * Update the tooltip with shape dimensions and area.\n   * Called during scaling to show live measurements.\n   * Handles both rectangles (5 points) and ellipses (many points).\n   */\n  private updateShapeTooltip(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const { mapCoords } = event;\n    const distanceUnits =\n      props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;\n\n    // Get the selected feature\n    const selectedIndexes = props.selectedIndexes;\n    const selectedIndex = selectedIndexes?.[0];\n    if (selectedIndex === undefined) {\n      this.tooltip = null;\n      return;\n    }\n\n    const feature = props.data.features[selectedIndex] as\n      | Feature<Polygon>\n      | undefined;\n    if (!feature || feature.geometry.type !== 'Polygon') {\n      this.tooltip = null;\n      return;\n    }\n\n    const coordinates = feature.geometry.coordinates[0];\n    if (!coordinates || coordinates.length < 4) {\n      this.tooltip = null;\n      return;\n    }\n\n    // Check if this is a rectangle (has shape: 'Rectangle' property)\n    const isRectangle = feature.properties?.shape === 'Rectangle';\n\n    let text: string;\n    const unitAbbrev = getDistanceUnitAbbreviation(distanceUnits);\n\n    if (isRectangle) {\n      // Rectangle: calculate width and height from corners\n      const corner0 = coordinates[0] as [number, number];\n      const corner1 = coordinates[1] as [number, number];\n      const corner2 = coordinates[2] as [number, number];\n\n      const { width, height, area } = computeRectangleMeasurementsFromCorners(\n        corner0,\n        corner1,\n        corner2,\n        distanceUnits,\n      );\n\n      text = formatRectangleTooltip(width, height, area, unitAbbrev);\n    } else {\n      // Ellipse: calculate major/minor axes using consolidated utility\n      const {\n        majorAxis,\n        minorAxis,\n        area: ellipseArea,\n      } = computeEllipseMeasurementsFromPolygon(\n        coordinates as [number, number][],\n        distanceUnits,\n      );\n\n      text = formatEllipseTooltip(\n        majorAxis,\n        minorAxis,\n        ellipseArea,\n        unitAbbrev,\n      );\n    }\n\n    // Position tooltip at cursor - offset is applied via getPixelOffset in sublayer props\n    this.tooltip = {\n      position: mapCoords,\n      text,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DA,IAAa,wBAAb,cAA2C,kBAAkB;CAC3D,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,cAAc;EACZ,MAAM,gBAAgB,IAAI,eAAe;EACzC,MAAM,YAAY,IAAI,4BAA4B;EAClD,MAAM,aAAa,IAAI,oBAAoB;AAG3C,QAAM;GAAC;GAAW;GAAY;GAAc,CAAC;AAE7C,OAAK,gBAAgB;AACrB,OAAK,YAAY;AACjB,OAAK,aAAa;;CAGpB,AAAmB,oBAAqC;AACtD,SAAO,CACL;GAEE,QAAQ,SACN,QACE,KAAK,WAAW,KAAK,QAAQ,YAAY,mBAAmB,QAC7D;GACH,MAAM,KAAK;GACX,aAAa,EAAE,WAAW,eAAe;GAC1C,EACD;GAEE,QAAQ,SACN,QACE,KAAK,WACH,KAAK,QAAQ,YAAY,mBAAmB,SAC/C;GACH,MAAM,KAAK;GACX,aAAa,EAAE,WAAW,gBAAgB;GAC3C,CACF;;CAGH,AAAmB,iBAAkC;AACnD,SAAO,KAAK;;;;;CAMd,AAAmB,WACjB,OACA,OACM;AAEN,MAAI,KAAK,mBAAmB,KAAK,UAC/B;AAGF,OAAK,mBAAmB,OAAO,MAAM;;;;;;;;;CAUvC,AAAS,UACP,OACwB;AAqBxB,SAAO,kBApBW,MAAM,UAAU,MAAM,CAGP,SAAS,QAAQ,UAAe;GAC/D,MAAM,aAAa,MAAM,cAAc,EAAE;GACzC,MAAM,iBAAiB,WAAW;GAIlC,MAAMA,oBAA8B,CAHvB,WAAW,KAG4B;AAGpD,OAAI,KAAK,WAAW,eAAe,CACjC,mBAAkB,KAAK,eAAyB;AAGlD,UAAO,CAAC,kBAAkB,SAAS,QAAQ;IAC3C,CAG6C;;;;;;;CAQjD,AAAQ,mBACN,OACA,OACA;EACA,MAAM,EAAE,cAAc;EACtB,MAAM,gBACJ,MAAM,YAAY,iBAAiB;EAIrC,MAAM,gBADkB,MAAM,kBACU;AACxC,MAAI,kBAAkB,QAAW;AAC/B,QAAK,UAAU;AACf;;EAGF,MAAM,UAAU,MAAM,KAAK,SAAS;AAGpC,MAAI,CAAC,WAAW,QAAQ,SAAS,SAAS,WAAW;AACnD,QAAK,UAAU;AACf;;EAGF,MAAM,cAAc,QAAQ,SAAS,YAAY;AACjD,MAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,QAAK,UAAU;AACf;;EAIF,MAAM,cAAc,QAAQ,YAAY,UAAU;EAElD,IAAIC;EACJ,MAAM,aAAa,4BAA4B,cAAc;AAE7D,MAAI,aAAa;GAEf,MAAM,UAAU,YAAY;GAC5B,MAAM,UAAU,YAAY;GAC5B,MAAM,UAAU,YAAY;GAE5B,MAAM,EAAE,OAAO,QAAQ,SAAS,wCAC9B,SACA,SACA,SACA,cACD;AAED,UAAO,uBAAuB,OAAO,QAAQ,MAAM,WAAW;SACzD;GAEL,MAAM,EACJ,WACA,WACA,MAAM,gBACJ,sCACF,aACA,cACD;AAED,UAAO,qBACL,WACA,WACA,aACA,WACD;;AAIH,OAAK,UAAU;GACb,UAAU;GACV;GACD"}
+{"version":3,"file":"bounding-transform-mode.js","names":["guidesToFilterOut: string[]","text: string"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode.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  type DraggingEvent,\n  type FeatureCollection,\n  type GeoJsonEditMode,\n  type GuideFeatureCollection,\n  type ModeProps,\n  TranslateMode,\n} from '@deck.gl-community/editable-layers';\nimport { featureCollection } from '@turf/helpers';\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitAbbreviation,\n} from '@/shared/units';\nimport {\n  formatEllipseTooltip,\n  formatRectangleTooltip,\n} from '../../shared/constants';\nimport {\n  computeEllipseMeasurementsFromPolygon,\n  computeRectangleMeasurementsFromCorners,\n} from '../../shared/utils/geometry-measurements';\nimport { BaseTransformMode, type HandleMatcher } from './base-transform-mode';\nimport { RotateModeWithSnap } from './rotate-mode-with-snap';\nimport { ScaleModeWithFreeTransform } from './scale-mode-with-free-transform';\nimport type { Feature, Polygon } from 'geojson';\n\n/**\n * Transform mode for shapes that use bounding box manipulation (no vertex editing).\n *\n * Use this mode for shapes like ellipses and rectangles where individual vertex\n * editing is not meaningful or desired. Instead, shapes are manipulated via their\n * bounding box handles.\n *\n * ## Capabilities\n * This composite mode provides:\n * - **Translation** (TranslateMode): Drag the shape body to move it\n * - **Scaling** (ScaleModeWithFreeTransform): Drag corner handles to resize\n *   - Default: Non-uniform scaling (can stretch/squish)\n *   - With Shift: Uniform scaling (maintains aspect ratio)\n * - **Rotation** (RotateModeWithSnap): Drag top handle to rotate\n *   - Default: Free rotation\n *   - With Shift: Snap to 45° intervals\n * - **Live tooltip**: Shows dimensions and area during scaling\n *\n * ## Differences from VertexTransformMode\n * Unlike VertexTransformMode, this mode does NOT include vertex editing handles.\n * This prevents accidental distortion of shapes that have specific geometric constraints\n * (e.g., ellipses must maintain their elliptical shape, rectangles must maintain right angles).\n *\n * ## Handle Priority Logic\n * When drag starts, modes are evaluated in this priority order:\n * 1. If hovering over a scale handle → scaling takes priority\n * 2. If hovering over the rotate handle → rotation takes priority\n * 3. Otherwise → dragging the shape body translates it\n *\n * @example\n * ```typescript\n * import { BoundingTransformMode } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode';\n * import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';\n *\n * // Used internally by EditShapeLayer for rectangles and ellipses\n * const mode = new BoundingTransformMode();\n *\n * const layer = new EditableGeoJsonLayer({\n *   mode,\n *   data: rectangleFeatureCollection,\n *   selectedFeatureIndexes: [0],\n *   onEdit: handleEdit,\n *   // ... other props\n * });\n * ```\n */\nexport class BoundingTransformMode extends BaseTransformMode {\n  private translateMode: TranslateMode;\n  private scaleMode: ScaleModeWithFreeTransform;\n  private rotateMode: RotateModeWithSnap;\n\n  constructor() {\n    const translateMode = new TranslateMode();\n    const scaleMode = new ScaleModeWithFreeTransform();\n    const rotateMode = new RotateModeWithSnap();\n\n    // Order: scale and rotate first so their handles take priority over translate\n    super([scaleMode, rotateMode, translateMode]);\n\n    this.translateMode = translateMode;\n    this.scaleMode = scaleMode;\n    this.rotateMode = rotateMode;\n  }\n\n  protected override getHandleMatchers(): HandleMatcher[] {\n    return [\n      {\n        // Scale handle: corner handles on bounding box\n        match: (pick) =>\n          Boolean(\n            pick.isGuide && pick.object?.properties?.editHandleType === 'scale',\n          ),\n        mode: this.scaleMode,\n        shiftConfig: { configKey: 'lockScaling' },\n      },\n      {\n        // Rotate handle: top handle on bounding box\n        match: (pick) =>\n          Boolean(\n            pick.isGuide &&\n              pick.object?.properties?.editHandleType === 'rotate',\n          ),\n        mode: this.rotateMode,\n        shiftConfig: { configKey: 'snapRotation' },\n      },\n    ];\n  }\n\n  protected override getDefaultMode(): GeoJsonEditMode {\n    return this.translateMode;\n  }\n\n  /**\n   * Update tooltip with shape dimensions during scaling.\n   */\n  protected override onDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void {\n    // Only show tooltip when scaling\n    if (this.activeDragMode !== this.scaleMode) {\n      return;\n    }\n\n    this.updateShapeTooltip(event, props);\n  }\n\n  /**\n   * Override getGuides to filter duplicate envelope guides.\n   *\n   * Both ScaleMode and RotateMode render the same bounding box envelope.\n   * We keep scale's envelope and filter rotate's duplicate.\n   * We also hide scale handles while rotating to avoid visual clutter.\n   */\n  override getGuides(\n    props: ModeProps<FeatureCollection>,\n  ): GuideFeatureCollection {\n    const allGuides = super.getGuides(props);\n\n    // biome-ignore lint/suspicious/noExplicitAny: Guide properties vary by mode, safely accessing with optional chaining\n    const filteredGuides = allGuides.features.filter((guide: any) => {\n      const properties = guide.properties || {};\n      const editHandleType = properties.editHandleType;\n      const mode = properties.mode;\n\n      // Both scale and rotate modes have the same enveloping box as a guide - only need one\n      const guidesToFilterOut: string[] = [mode as string];\n\n      // Do not render scaling edit handles if rotating\n      if (this.rotateMode.getIsRotating()) {\n        guidesToFilterOut.push(editHandleType as string);\n      }\n\n      return !guidesToFilterOut.includes('scale');\n    });\n\n    // biome-ignore lint/suspicious/noExplicitAny: turf types mismatch with editable-layers GeoJSON types\n    return featureCollection(filteredGuides as any) as any;\n  }\n\n  /**\n   * Update the tooltip with shape dimensions and area.\n   * Called during scaling to show live measurements.\n   * Handles both rectangles (5 points) and ellipses (many points).\n   */\n  private updateShapeTooltip(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const { mapCoords } = event;\n    const distanceUnits =\n      props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;\n\n    // Get the selected feature\n    const selectedIndexes = props.selectedIndexes;\n    const selectedIndex = selectedIndexes?.[0];\n    if (selectedIndex === undefined) {\n      this.tooltip = null;\n      return;\n    }\n\n    const feature = props.data.features[selectedIndex] as\n      | Feature<Polygon>\n      | undefined;\n    if (!feature || feature.geometry.type !== 'Polygon') {\n      this.tooltip = null;\n      return;\n    }\n\n    const coordinates = feature.geometry.coordinates[0];\n    if (!coordinates || coordinates.length < 4) {\n      this.tooltip = null;\n      return;\n    }\n\n    // Check if this is a rectangle (has shape: 'Rectangle' property)\n    const isRectangle = feature.properties?.shape === 'Rectangle';\n\n    let text: string;\n    const unitAbbrev = getDistanceUnitAbbreviation(distanceUnits);\n\n    if (isRectangle) {\n      // Rectangle: calculate width and height from corners\n      const corner0 = coordinates[0] as [number, number];\n      const corner1 = coordinates[1] as [number, number];\n      const corner2 = coordinates[2] as [number, number];\n\n      const { width, height, area } = computeRectangleMeasurementsFromCorners(\n        corner0,\n        corner1,\n        corner2,\n        distanceUnits,\n      );\n\n      text = formatRectangleTooltip(width, height, area, unitAbbrev);\n    } else {\n      // Ellipse: calculate major/minor axes using consolidated utility\n      const {\n        majorAxis,\n        minorAxis,\n        area: ellipseArea,\n      } = computeEllipseMeasurementsFromPolygon(\n        coordinates as [number, number][],\n        distanceUnits,\n      );\n\n      text = formatEllipseTooltip(\n        majorAxis,\n        minorAxis,\n        ellipseArea,\n        unitAbbrev,\n      );\n    }\n\n    // Position tooltip at cursor - offset is applied via getPixelOffset in sublayer props\n    this.tooltip = {\n      position: mapCoords,\n      text,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,IAAa,wBAAb,cAA2C,kBAAkB;CAC3D,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,cAAc;EACZ,MAAM,gBAAgB,IAAI,eAAe;EACzC,MAAM,YAAY,IAAI,4BAA4B;EAClD,MAAM,aAAa,IAAI,oBAAoB;AAG3C,QAAM;GAAC;GAAW;GAAY;GAAc,CAAC;AAE7C,OAAK,gBAAgB;AACrB,OAAK,YAAY;AACjB,OAAK,aAAa;;CAGpB,AAAmB,oBAAqC;AACtD,SAAO,CACL;GAEE,QAAQ,SACN,QACE,KAAK,WAAW,KAAK,QAAQ,YAAY,mBAAmB,QAC7D;GACH,MAAM,KAAK;GACX,aAAa,EAAE,WAAW,eAAe;GAC1C,EACD;GAEE,QAAQ,SACN,QACE,KAAK,WACH,KAAK,QAAQ,YAAY,mBAAmB,SAC/C;GACH,MAAM,KAAK;GACX,aAAa,EAAE,WAAW,gBAAgB;GAC3C,CACF;;CAGH,AAAmB,iBAAkC;AACnD,SAAO,KAAK;;;;;CAMd,AAAmB,WACjB,OACA,OACM;AAEN,MAAI,KAAK,mBAAmB,KAAK,UAC/B;AAGF,OAAK,mBAAmB,OAAO,MAAM;;;;;;;;;CAUvC,AAAS,UACP,OACwB;AAqBxB,SAAO,kBApBW,MAAM,UAAU,MAAM,CAGP,SAAS,QAAQ,UAAe;GAC/D,MAAM,aAAa,MAAM,cAAc,EAAE;GACzC,MAAM,iBAAiB,WAAW;GAIlC,MAAMA,oBAA8B,CAHvB,WAAW,KAG4B;AAGpD,OAAI,KAAK,WAAW,eAAe,CACjC,mBAAkB,KAAK,eAAyB;AAGlD,UAAO,CAAC,kBAAkB,SAAS,QAAQ;IAC3C,CAG6C;;;;;;;CAQjD,AAAQ,mBACN,OACA,OACA;EACA,MAAM,EAAE,cAAc;EACtB,MAAM,gBACJ,MAAM,YAAY,iBAAiB;EAIrC,MAAM,gBADkB,MAAM,kBACU;AACxC,MAAI,kBAAkB,QAAW;AAC/B,QAAK,UAAU;AACf;;EAGF,MAAM,UAAU,MAAM,KAAK,SAAS;AAGpC,MAAI,CAAC,WAAW,QAAQ,SAAS,SAAS,WAAW;AACnD,QAAK,UAAU;AACf;;EAGF,MAAM,cAAc,QAAQ,SAAS,YAAY;AACjD,MAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,QAAK,UAAU;AACf;;EAIF,MAAM,cAAc,QAAQ,YAAY,UAAU;EAElD,IAAIC;EACJ,MAAM,aAAa,4BAA4B,cAAc;AAE7D,MAAI,aAAa;GAEf,MAAM,UAAU,YAAY;GAC5B,MAAM,UAAU,YAAY;GAC5B,MAAM,UAAU,YAAY;GAE5B,MAAM,EAAE,OAAO,QAAQ,SAAS,wCAC9B,SACA,SACA,SACA,cACD;AAED,UAAO,uBAAuB,OAAO,QAAQ,MAAM,WAAW;SACzD;GAEL,MAAM,EACJ,WACA,WACA,MAAM,gBACJ,sCACF,aACA,cACD;AAED,UAAO,qBACL,WACA,WACA,aACA,WACD;;AAIH,OAAK,UAAU;GACb,UAAU;GACV;GACD"}