@accelint/map-toolkit 1.1.0 → 1.3.0

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"}

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

@@ -22,14 +22,39 @@ import { centroid } from "@turf/turf";
 /**
 * Transform mode for circles combining resize and translate.
 *
+* ## Capabilities
 * This composite mode provides:
 * - **Resize** (ResizeCircleMode): Drag edge to resize from center
 * - **Translation** (TranslateMode): Drag the circle body to move it
 * - **Live tooltip**: Shows diameter and area during resize
 *
-* Priority logic:
-* - If dragging on the edge/handle, resize takes priority
-* - If dragging on the circle body, translate takes priority
+* ## Handle Priority Logic
+* When drag starts, modes are evaluated in this priority order:
+* 1. If dragging on the edge/handle → resize takes priority
+* 2. Otherwise → dragging the circle body translates it
+*
+* ## Resize Behavior
+* Unlike scale operations in BoundingTransformMode, circle resize maintains
+* the shape's circular geometry by resizing from the center point. The center
+* remains fixed while the radius changes based on cursor distance.
+*
+* @example
+* ```typescript
+* import { CircleTransformMode } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/circle-transform-mode';
+* import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';
+*
+* // Used internally by EditShapeLayer for circles
+* const mode = new CircleTransformMode();
+*
+* const layer = new EditableGeoJsonLayer({
+*   mode,
+*   data: circleFeatureCollection,
+*   selectedFeatureIndexes: [0],
+*   onEdit: handleEdit,
+*   modeConfig: { distanceUnits: 'kilometers' },
+*   // ... other props
+* });
+* ```
 */
 var CircleTransformMode = class extends BaseTransformMode {
 	resizeMode;

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

@@ -1 +1 @@
-{"version":3,"file":"circle-transform-mode.js","names":["area"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/circle-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 ModeProps,\n  ResizeCircleMode,\n  TranslateMode,\n} from '@deck.gl-community/editable-layers';\nimport { centroid } from '@turf/turf';\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitAbbreviation,\n} from '@/shared/units';\nimport { formatCircleTooltip } from '../../shared/constants';\nimport { computeCircleMeasurements } from '../../shared/utils/geometry-measurements';\nimport { BaseTransformMode, type HandleMatcher } from './base-transform-mode';\nimport type { Feature, Polygon } from 'geojson';\n\n/**\n * Transform mode for circles combining resize and translate.\n *\n * This composite mode provides:\n * - **Resize** (ResizeCircleMode): Drag edge to resize from center\n * - **Translation** (TranslateMode): Drag the circle body to move it\n * - **Live tooltip**: Shows diameter and area during resize\n *\n * Priority logic:\n * - If dragging on the edge/handle, resize takes priority\n * - If dragging on the circle body, translate takes priority\n */\nexport class CircleTransformMode extends BaseTransformMode {\n  private resizeMode: ResizeCircleMode;\n  private translateMode: TranslateMode;\n\n  constructor() {\n    const resizeMode = new ResizeCircleMode();\n    const translateMode = new TranslateMode();\n\n    // Order matters: resize first so edge handles take priority\n    super([resizeMode, translateMode]);\n\n    this.resizeMode = resizeMode;\n    this.translateMode = translateMode;\n  }\n\n  protected override getHandleMatchers(): HandleMatcher[] {\n    return [\n      {\n        // Resize handle: intermediate point on circle edge\n        match: (pick) =>\n          Boolean(\n            pick.isGuide &&\n              pick.object?.properties?.guideType === 'editHandle' &&\n              pick.object?.properties?.editHandleType === 'intermediate',\n          ),\n        mode: this.resizeMode,\n        // No shift config - resize doesn't have modifiers\n      },\n    ];\n  }\n\n  protected override getDefaultMode(): GeoJsonEditMode {\n    return this.translateMode;\n  }\n\n  /**\n   * Update the tooltip with circle diameter and area during resize.\n   */\n  protected override onDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void {\n    // Only show tooltip when resizing\n    if (this.activeDragMode !== this.resizeMode) {\n      return;\n    }\n\n    const { mapCoords } = event;\n    const distanceUnits =\n      props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;\n\n    // Get the selected feature to calculate radius from its geometry\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    // Calculate center and radius from the polygon geometry\n    const coordinates = feature.geometry.coordinates[0];\n    if (!coordinates || coordinates.length < 3) {\n      this.tooltip = null;\n      return;\n    }\n\n    const centerFeature = centroid(feature);\n    const center = centerFeature.geometry.coordinates as [number, number];\n    const firstPoint = coordinates[0] as [number, number];\n    const { diameter, area } = computeCircleMeasurements(\n      center,\n      firstPoint,\n      distanceUnits,\n    );\n    const unitAbbrev = getDistanceUnitAbbreviation(distanceUnits);\n\n    // Position tooltip at cursor - offset is applied via getPixelOffset in sublayer props\n    this.tooltip = {\n      position: mapCoords,\n      text: formatCircleTooltip(diameter, area, unitAbbrev),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,IAAa,sBAAb,cAAyC,kBAAkB;CACzD,AAAQ;CACR,AAAQ;CAER,cAAc;EACZ,MAAM,aAAa,IAAI,kBAAkB;EACzC,MAAM,gBAAgB,IAAI,eAAe;AAGzC,QAAM,CAAC,YAAY,cAAc,CAAC;AAElC,OAAK,aAAa;AAClB,OAAK,gBAAgB;;CAGvB,AAAmB,oBAAqC;AACtD,SAAO,CACL;GAEE,QAAQ,SACN,QACE,KAAK,WACH,KAAK,QAAQ,YAAY,cAAc,gBACvC,KAAK,QAAQ,YAAY,mBAAmB,eAC/C;GACH,MAAM,KAAK;GAEZ,CACF;;CAGH,AAAmB,iBAAkC;AACnD,SAAO,KAAK;;;;;CAMd,AAAmB,WACjB,OACA,OACM;AAEN,MAAI,KAAK,mBAAmB,KAAK,WAC/B;EAGF,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;;EAIF,MAAM,cAAc,QAAQ,SAAS,YAAY;AACjD,MAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,QAAK,UAAU;AACf;;EAIF,MAAM,SADgB,SAAS,QAAQ,CACV,SAAS;EACtC,MAAM,aAAa,YAAY;EAC/B,MAAM,EAAE,UAAU,iBAAS,0BACzB,QACA,YACA,cACD;AAID,OAAK,UAAU;GACb,UAAU;GACV,MAAM,oBAAoB,UAAUA,QALnB,4BAA4B,cAAc,CAKN;GACtD"}
+{"version":3,"file":"circle-transform-mode.js","names":["area"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/circle-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 ModeProps,\n  ResizeCircleMode,\n  TranslateMode,\n} from '@deck.gl-community/editable-layers';\nimport { centroid } from '@turf/turf';\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitAbbreviation,\n} from '@/shared/units';\nimport { formatCircleTooltip } from '../../shared/constants';\nimport { computeCircleMeasurements } from '../../shared/utils/geometry-measurements';\nimport { BaseTransformMode, type HandleMatcher } from './base-transform-mode';\nimport type { Feature, Polygon } from 'geojson';\n\n/**\n * Transform mode for circles combining resize and translate.\n *\n * ## Capabilities\n * This composite mode provides:\n * - **Resize** (ResizeCircleMode): Drag edge to resize from center\n * - **Translation** (TranslateMode): Drag the circle body to move it\n * - **Live tooltip**: Shows diameter and area during resize\n *\n * ## Handle Priority Logic\n * When drag starts, modes are evaluated in this priority order:\n * 1. If dragging on the edge/handle → resize takes priority\n * 2. Otherwise → dragging the circle body translates it\n *\n * ## Resize Behavior\n * Unlike scale operations in BoundingTransformMode, circle resize maintains\n * the shape's circular geometry by resizing from the center point. The center\n * remains fixed while the radius changes based on cursor distance.\n *\n * @example\n * ```typescript\n * import { CircleTransformMode } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/circle-transform-mode';\n * import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';\n *\n * // Used internally by EditShapeLayer for circles\n * const mode = new CircleTransformMode();\n *\n * const layer = new EditableGeoJsonLayer({\n *   mode,\n *   data: circleFeatureCollection,\n *   selectedFeatureIndexes: [0],\n *   onEdit: handleEdit,\n *   modeConfig: { distanceUnits: 'kilometers' },\n *   // ... other props\n * });\n * ```\n */\nexport class CircleTransformMode extends BaseTransformMode {\n  private resizeMode: ResizeCircleMode;\n  private translateMode: TranslateMode;\n\n  constructor() {\n    const resizeMode = new ResizeCircleMode();\n    const translateMode = new TranslateMode();\n\n    // Order matters: resize first so edge handles take priority\n    super([resizeMode, translateMode]);\n\n    this.resizeMode = resizeMode;\n    this.translateMode = translateMode;\n  }\n\n  protected override getHandleMatchers(): HandleMatcher[] {\n    return [\n      {\n        // Resize handle: intermediate point on circle edge\n        match: (pick) =>\n          Boolean(\n            pick.isGuide &&\n              pick.object?.properties?.guideType === 'editHandle' &&\n              pick.object?.properties?.editHandleType === 'intermediate',\n          ),\n        mode: this.resizeMode,\n        // No shift config - resize doesn't have modifiers\n      },\n    ];\n  }\n\n  protected override getDefaultMode(): GeoJsonEditMode {\n    return this.translateMode;\n  }\n\n  /**\n   * Update the tooltip with circle diameter and area during resize.\n   */\n  protected override onDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ): void {\n    // Only show tooltip when resizing\n    if (this.activeDragMode !== this.resizeMode) {\n      return;\n    }\n\n    const { mapCoords } = event;\n    const distanceUnits =\n      props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;\n\n    // Get the selected feature to calculate radius from its geometry\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    // Calculate center and radius from the polygon geometry\n    const coordinates = feature.geometry.coordinates[0];\n    if (!coordinates || coordinates.length < 3) {\n      this.tooltip = null;\n      return;\n    }\n\n    const centerFeature = centroid(feature);\n    const center = centerFeature.geometry.coordinates as [number, number];\n    const firstPoint = coordinates[0] as [number, number];\n    const { diameter, area } = computeCircleMeasurements(\n      center,\n      firstPoint,\n      distanceUnits,\n    );\n    const unitAbbrev = getDistanceUnitAbbreviation(distanceUnits);\n\n    // Position tooltip at cursor - offset is applied via getPixelOffset in sublayer props\n    this.tooltip = {\n      position: mapCoords,\n      text: formatCircleTooltip(diameter, area, unitAbbrev),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,IAAa,sBAAb,cAAyC,kBAAkB;CACzD,AAAQ;CACR,AAAQ;CAER,cAAc;EACZ,MAAM,aAAa,IAAI,kBAAkB;EACzC,MAAM,gBAAgB,IAAI,eAAe;AAGzC,QAAM,CAAC,YAAY,cAAc,CAAC;AAElC,OAAK,aAAa;AAClB,OAAK,gBAAgB;;CAGvB,AAAmB,oBAAqC;AACtD,SAAO,CACL;GAEE,QAAQ,SACN,QACE,KAAK,WACH,KAAK,QAAQ,YAAY,cAAc,gBACvC,KAAK,QAAQ,YAAY,mBAAmB,eAC/C;GACH,MAAM,KAAK;GAEZ,CACF;;CAGH,AAAmB,iBAAkC;AACnD,SAAO,KAAK;;;;;CAMd,AAAmB,WACjB,OACA,OACM;AAEN,MAAI,KAAK,mBAAmB,KAAK,WAC/B;EAGF,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;;EAIF,MAAM,cAAc,QAAQ,SAAS,YAAY;AACjD,MAAI,CAAC,eAAe,YAAY,SAAS,GAAG;AAC1C,QAAK,UAAU;AACf;;EAIF,MAAM,SADgB,SAAS,QAAQ,CACV,SAAS;EACtC,MAAM,aAAa,YAAY;EAC/B,MAAM,EAAE,UAAU,iBAAS,0BACzB,QACA,YACA,cACD;AAID,OAAK,UAAU;GACb,UAAU;GACV,MAAM,oBAAoB,UAAUA,QALnB,4BAA4B,cAAc,CAKN;GACtD"}

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

@@ -49,8 +49,32 @@ const EDIT_MODE_INSTANCES = {
 /**
 * Get the cached mode instance for an edit mode.
 *
+* Returns the pre-instantiated edit mode for the specified mode type.
+* Modes are cached at module level to prevent deck.gl assertion failures
+* that occur when creating new mode instances on each render.
+*
+* ## Available Edit Modes
+* - `'bounding-transform'`: For shapes without vertex editing (rectangles, ellipses)
+* - `'vertex-transform'`: For shapes with vertex editing (polygons, lines)
+* - `'circle-transform'`: For circles (resize from edge + translate)
+* - `'translate'`: For points (drag to move)
+*
 * @param mode - The edit mode to get the instance for
 * @returns The cached mode instance
+*
+* @example
+* ```typescript
+* import { getEditModeInstance } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes';
+*
+* // Get the bounding transform mode for editing rectangles/ellipses
+* const boundingMode = getEditModeInstance('bounding-transform');
+*
+* // Use with EditableGeoJsonLayer
+* const layer = new EditableGeoJsonLayer({
+*   mode: boundingMode,
+*   // ... other props
+* });
+* ```
 */
 function getEditModeInstance(mode) {
 	return EDIT_MODE_INSTANCES[mode];

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/index.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 { TranslateMode, ViewMode } from '@deck.gl-community/editable-layers';\nimport { BoundingTransformMode } from './bounding-transform-mode';\nimport { CircleTransformMode } from './circle-transform-mode';\nimport { VertexTransformMode } from './vertex-transform-mode';\nimport type { EditMode } from '../types';\n\n/**\n * Cached edit mode instances.\n *\n * CRITICAL: Mode instances must be cached at module level to prevent\n * deck.gl assertion failures. Creating new mode instances on each render\n * causes the EditableGeoJsonLayer to fail with assertion errors.\n *\n * BoundingTransformMode combines ScaleModeWithFreeTransform, RotateMode, and\n * TranslateMode for shapes without vertex editing (ellipses, rectangles),\n * allowing non-uniform scaling plus rotate/translate via bounding box handles.\n * Shows live dimension tooltips during scaling.\n *\n * VertexTransformMode combines ModifyMode with ScaleModeWithFreeTransform,\n * RotateMode, and TranslateMode for shapes that support vertex editing\n * (polygons, lines), allowing vertex manipulation plus scale/rotate/translate.\n *\n * CircleTransformMode combines ResizeCircleMode with TranslateMode\n * for circles, allowing resize from edge plus drag to translate.\n * Shows live diameter/area tooltips during resize.\n *\n * TranslateMode allows dragging to move the shape (used for points).\n */\nconst EDIT_MODE_INSTANCES = {\n  view: new ViewMode(),\n  'bounding-transform': new BoundingTransformMode(),\n  'vertex-transform': new VertexTransformMode(),\n  'circle-transform': new CircleTransformMode(),\n  translate: new TranslateMode(),\n} as const;\n\n/**\n * Get the cached mode instance for an edit mode.\n *\n * @param mode - The edit mode to get the instance for\n * @returns The cached mode instance\n */\nexport function getEditModeInstance(\n  mode: EditMode,\n): (typeof EDIT_MODE_INSTANCES)[EditMode] {\n  return EDIT_MODE_INSTANCES[mode];\n}\n\n/**\n * Get the ViewMode instance (for when not editing).\n *\n * @returns The cached ViewMode instance\n */\nexport function getViewModeInstance(): ViewMode {\n  return EDIT_MODE_INSTANCES.view;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAM,sBAAsB;CAC1B,MAAM,IAAI,UAAU;CACpB,sBAAsB,IAAI,uBAAuB;CACjD,oBAAoB,IAAI,qBAAqB;CAC7C,oBAAoB,IAAI,qBAAqB;CAC7C,WAAW,IAAI,eAAe;CAC/B;;;;;;;AAQD,SAAgB,oBACd,MACwC;AACxC,QAAO,oBAAoB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/index.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 { TranslateMode, ViewMode } from '@deck.gl-community/editable-layers';\nimport { BoundingTransformMode } from './bounding-transform-mode';\nimport { CircleTransformMode } from './circle-transform-mode';\nimport { VertexTransformMode } from './vertex-transform-mode';\nimport type { EditMode } from '../types';\n\n/**\n * Cached edit mode instances.\n *\n * CRITICAL: Mode instances must be cached at module level to prevent\n * deck.gl assertion failures. Creating new mode instances on each render\n * causes the EditableGeoJsonLayer to fail with assertion errors.\n *\n * BoundingTransformMode combines ScaleModeWithFreeTransform, RotateMode, and\n * TranslateMode for shapes without vertex editing (ellipses, rectangles),\n * allowing non-uniform scaling plus rotate/translate via bounding box handles.\n * Shows live dimension tooltips during scaling.\n *\n * VertexTransformMode combines ModifyMode with ScaleModeWithFreeTransform,\n * RotateMode, and TranslateMode for shapes that support vertex editing\n * (polygons, lines), allowing vertex manipulation plus scale/rotate/translate.\n *\n * CircleTransformMode combines ResizeCircleMode with TranslateMode\n * for circles, allowing resize from edge plus drag to translate.\n * Shows live diameter/area tooltips during resize.\n *\n * TranslateMode allows dragging to move the shape (used for points).\n */\nconst EDIT_MODE_INSTANCES = {\n  view: new ViewMode(),\n  'bounding-transform': new BoundingTransformMode(),\n  'vertex-transform': new VertexTransformMode(),\n  'circle-transform': new CircleTransformMode(),\n  translate: new TranslateMode(),\n} as const;\n\n/**\n * Get the cached mode instance for an edit mode.\n *\n * Returns the pre-instantiated edit mode for the specified mode type.\n * Modes are cached at module level to prevent deck.gl assertion failures\n * that occur when creating new mode instances on each render.\n *\n * ## Available Edit Modes\n * - `'bounding-transform'`: For shapes without vertex editing (rectangles, ellipses)\n * - `'vertex-transform'`: For shapes with vertex editing (polygons, lines)\n * - `'circle-transform'`: For circles (resize from edge + translate)\n * - `'translate'`: For points (drag to move)\n *\n * @param mode - The edit mode to get the instance for\n * @returns The cached mode instance\n *\n * @example\n * ```typescript\n * import { getEditModeInstance } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes';\n *\n * // Get the bounding transform mode for editing rectangles/ellipses\n * const boundingMode = getEditModeInstance('bounding-transform');\n *\n * // Use with EditableGeoJsonLayer\n * const layer = new EditableGeoJsonLayer({\n *   mode: boundingMode,\n *   // ... other props\n * });\n * ```\n */\nexport function getEditModeInstance(\n  mode: EditMode,\n): (typeof EDIT_MODE_INSTANCES)[EditMode] {\n  return EDIT_MODE_INSTANCES[mode];\n}\n\n/**\n * Get the ViewMode instance (for when not editing).\n *\n * Returns the pre-instantiated ViewMode which is the default mode when\n * no editing operation is active. This mode allows viewing and interacting\n * with the map without editing shapes.\n *\n * @returns The cached ViewMode instance\n *\n * @example\n * ```typescript\n * import { getViewModeInstance } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes';\n *\n * // Get the view mode (default when not editing)\n * const viewMode = getViewModeInstance();\n *\n * // Use with EditableGeoJsonLayer\n * const layer = new EditableGeoJsonLayer({\n *   mode: viewMode,\n *   // ... other props\n * });\n * ```\n */\nexport function getViewModeInstance(): ViewMode {\n  return EDIT_MODE_INSTANCES.view;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAM,sBAAsB;CAC1B,MAAM,IAAI,UAAU;CACpB,sBAAsB,IAAI,uBAAuB;CACjD,oBAAoB,IAAI,qBAAqB;CAC7C,oBAAoB,IAAI,qBAAqB;CAC7C,WAAW,IAAI,eAAe;CAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCD,SAAgB,oBACd,MACwC;AACxC,QAAO,oBAAoB"}

package/dist/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap.js

@@ -38,11 +38,40 @@ function snapAngle(angle, interval) {
 /**
 * Extends RotateMode to support snapping rotation to 45° intervals.
 *
-* Features:
-* - Default: Free rotation
-* - With modeConfig.snapRotation = true: Snap to 45° intervals (0°, 45°, 90°, etc.)
+* ## Features
+* - **Default**: Free rotation (smooth, continuous angles)
+* - **With Shift**: Snap to 45° intervals (0°, 45°, 90°, 135°, 180°, etc.)
 *
-* This allows precise alignment of shapes to common angles.
+* This allows precise alignment of shapes to common angles, making it easy to
+* create axis-aligned or diagonally-aligned shapes.
+*
+* ## Implementation
+* The snap behavior is controlled by the `modeConfig.snapRotation` property,
+* which is set by BaseTransformMode when the Shift key is held. This class
+* calculates the rotation angle and rounds it to the nearest 45° interval
+* when snapping is enabled.
+*
+* ## Snap Interval
+* The snap interval is fixed at 45° (8 positions around the circle), providing
+* these angles: 0°, 45°, 90°, 135°, 180°, 225°, 270°, 315°.
+*
+* @example
+* ```typescript
+* import { RotateModeWithSnap } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap';
+* import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';
+*
+* const mode = new RotateModeWithSnap();
+*
+* const layer = new EditableGeoJsonLayer({
+*   mode,
+*   data: featureCollection,
+*   selectedFeatureIndexes: [0],
+*   onEdit: handleEdit,
+*   modeConfig: {
+*     snapRotation: true, // Enable 45° snapping
+*   },
+* });
+* ```
 */
 var RotateModeWithSnap = class extends RotateMode {
 	/**

package/dist/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap.js.map

@@ -1 +1 @@
-{"version":3,"file":"rotate-mode-with-snap.js","names":["rotatedFeatures: FeatureCollection"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap.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  ImmutableFeatureCollection,\n  type ModeProps,\n  RotateMode,\n  type StopDraggingEvent,\n} from '@deck.gl-community/editable-layers';\nimport { bearing, centroid, transformRotate } from '@turf/turf';\nimport type { Position } from 'geojson';\n\n/** Snap interval in degrees (45° = 8 positions around the circle) */\nconst SNAP_INTERVAL_DEGREES = 45;\n\n/**\n * Calculate the angle between two points relative to a centroid.\n * Uses turfBearing for geographic bearing convention (matches parent RotateMode).\n * Returns angle in degrees.\n *\n * Note: centroid must be a turf Point Feature (not just coordinates) to match\n * the parent RotateMode's behavior exactly.\n */\nfunction getRotationAngle(\n  centroidFeature: ReturnType<typeof centroid>,\n  startPoint: Position,\n  endPoint: Position,\n): number {\n  const bearing1 = bearing(centroidFeature, startPoint);\n  const bearing2 = bearing(centroidFeature, endPoint);\n  return bearing2 - bearing1;\n}\n\n/**\n * Snap an angle to the nearest interval.\n */\nfunction snapAngle(angle: number, interval: number): number {\n  return Math.round(angle / interval) * interval;\n}\n\n/**\n * Extends RotateMode to support snapping rotation to 45° intervals.\n *\n * Features:\n * - Default: Free rotation\n * - With modeConfig.snapRotation = true: Snap to 45° intervals (0°, 45°, 90°, etc.)\n *\n * This allows precise alignment of shapes to common angles.\n */\nexport class RotateModeWithSnap extends RotateMode {\n  /**\n   * Override handleDragging to support snapped rotation.\n   * When snapRotation is true, rotates to nearest 45° interval.\n   * When snapRotation is false, delegates to parent for standard rotation.\n   */\n  override handleDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n\n    // If not snapping, use parent's rotation logic\n    if (!snapRotation) {\n      super.handleDragging(event, props);\n      return;\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (!self._isRotating) {\n      return;\n    }\n\n    const rotateAction = this.getRotateActionWithSnap(\n      event.pointerDownMapCoords,\n      event.mapCoords,\n      'rotating',\n      props,\n    );\n\n    if (rotateAction) {\n      props.onEdit(rotateAction);\n    }\n\n    event.cancelPan();\n  }\n\n  /**\n   * Override handleStopDragging to emit the final rotated geometry with snap.\n   * When snapRotation is false, delegates to parent for standard rotation.\n   */\n  override handleStopDragging(\n    event: StopDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n\n    // If not snapping, use parent's rotation logic\n    if (!snapRotation) {\n      super.handleStopDragging(event, props);\n      return;\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (self._isRotating) {\n      const rotateAction = this.getRotateActionWithSnap(\n        event.pointerDownMapCoords,\n        event.mapCoords,\n        'rotated',\n        props,\n      );\n\n      if (rotateAction) {\n        props.onEdit(rotateAction);\n      }\n\n      // Reset state\n      self._geometryBeingRotated = null;\n      self._selectedEditHandle = null;\n      self._isRotating = false;\n    }\n  }\n\n  /**\n   * Get a rotate action, optionally snapping to 45° intervals.\n   */\n  private getRotateActionWithSnap(\n    startDragPoint: Position,\n    currentPoint: Position,\n    editType: string,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (!self._geometryBeingRotated) {\n      return null;\n    }\n\n    const geometry = self._geometryBeingRotated as FeatureCollection;\n    // @ts-expect-error turf types differ from editable-layers types\n    const centerFeature = centroid(geometry);\n\n    // Calculate the rotation angle (pass centroid Feature to match parent RotateMode)\n    let angle = getRotationAngle(centerFeature, startDragPoint, currentPoint);\n\n    // Snap to 45° intervals if enabled\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n    if (snapRotation) {\n      angle = snapAngle(angle, SNAP_INTERVAL_DEGREES);\n    }\n\n    // Apply the rotation using turf (use centroid Feature as pivot to match parent)\n    // @ts-expect-error turf types differ from editable-layers types\n    const rotatedFeatures: FeatureCollection = transformRotate(\n      // @ts-expect-error turf types differ from editable-layers types\n      geometry,\n      angle,\n      {\n        pivot: centerFeature,\n      },\n    );\n\n    // Build the updated data using ImmutableFeatureCollection (matches parent RotateMode)\n    const selectedIndexes = props.selectedIndexes;\n    let updatedData = new ImmutableFeatureCollection(props.data);\n\n    for (let i = 0; i < selectedIndexes.length; i++) {\n      const selectedIndex = selectedIndexes[i];\n      const movedFeature = rotatedFeatures.features[i];\n      if (selectedIndex !== undefined && movedFeature) {\n        updatedData = updatedData.replaceGeometry(\n          selectedIndex,\n          movedFeature.geometry,\n        );\n      }\n    }\n\n    return {\n      updatedData: updatedData.getObject(),\n      editType,\n      editContext: {\n        featureIndexes: selectedIndexes,\n      },\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,MAAM,wBAAwB;;;;;;;;;AAU9B,SAAS,iBACP,iBACA,YACA,UACQ;CACR,MAAM,WAAW,QAAQ,iBAAiB,WAAW;AAErD,QADiB,QAAQ,iBAAiB,SAAS,GACjC;;;;;AAMpB,SAAS,UAAU,OAAe,UAA0B;AAC1D,QAAO,KAAK,MAAM,QAAQ,SAAS,GAAG;;;;;;;;;;;AAYxC,IAAa,qBAAb,cAAwC,WAAW;;;;;;CAMjD,AAAS,eACP,OACA,OACA;AAIA,MAAI,EAHiB,MAAM,YAAY,gBAAgB,QAGpC;AACjB,SAAM,eAAe,OAAO,MAAM;AAClC;;AAMF,MAAI,CAFS,KAEH,YACR;EAGF,MAAM,eAAe,KAAK,wBACxB,MAAM,sBACN,MAAM,WACN,YACA,MACD;AAED,MAAI,aACF,OAAM,OAAO,aAAa;AAG5B,QAAM,WAAW;;;;;;CAOnB,AAAS,mBACP,OACA,OACA;AAIA,MAAI,EAHiB,MAAM,YAAY,gBAAgB,QAGpC;AACjB,SAAM,mBAAmB,OAAO,MAAM;AACtC;;EAIF,MAAM,OAAO;AAEb,MAAI,KAAK,aAAa;GACpB,MAAM,eAAe,KAAK,wBACxB,MAAM,sBACN,MAAM,WACN,WACA,MACD;AAED,OAAI,aACF,OAAM,OAAO,aAAa;AAI5B,QAAK,wBAAwB;AAC7B,QAAK,sBAAsB;AAC3B,QAAK,cAAc;;;;;;CAOvB,AAAQ,wBACN,gBACA,cACA,UACA,OACA;EAEA,MAAM,OAAO;AAEb,MAAI,CAAC,KAAK,sBACR,QAAO;EAGT,MAAM,WAAW,KAAK;EAEtB,MAAM,gBAAgB,SAAS,SAAS;EAGxC,IAAI,QAAQ,iBAAiB,eAAe,gBAAgB,aAAa;AAIzE,MADqB,MAAM,YAAY,gBAAgB,MAErD,SAAQ,UAAU,OAAO,sBAAsB;EAKjD,MAAMA,kBAAqC,gBAEzC,UACA,OACA,EACE,OAAO,eACR,CACF;EAGD,MAAM,kBAAkB,MAAM;EAC9B,IAAI,cAAc,IAAI,2BAA2B,MAAM,KAAK;AAE5D,OAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,KAAK;GAC/C,MAAM,gBAAgB,gBAAgB;GACtC,MAAM,eAAe,gBAAgB,SAAS;AAC9C,OAAI,kBAAkB,UAAa,aACjC,eAAc,YAAY,gBACxB,eACA,aAAa,SACd;;AAIL,SAAO;GACL,aAAa,YAAY,WAAW;GACpC;GACA,aAAa,EACX,gBAAgB,iBACjB;GACF"}
+{"version":3,"file":"rotate-mode-with-snap.js","names":["rotatedFeatures: FeatureCollection"],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap.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  ImmutableFeatureCollection,\n  type ModeProps,\n  RotateMode,\n  type StopDraggingEvent,\n} from '@deck.gl-community/editable-layers';\nimport { bearing, centroid, transformRotate } from '@turf/turf';\nimport type { Position } from 'geojson';\n\n/** Snap interval in degrees (45° = 8 positions around the circle) */\nconst SNAP_INTERVAL_DEGREES = 45;\n\n/**\n * Calculate the angle between two points relative to a centroid.\n * Uses turfBearing for geographic bearing convention (matches parent RotateMode).\n * Returns angle in degrees.\n *\n * Note: centroid must be a turf Point Feature (not just coordinates) to match\n * the parent RotateMode's behavior exactly.\n */\nfunction getRotationAngle(\n  centroidFeature: ReturnType<typeof centroid>,\n  startPoint: Position,\n  endPoint: Position,\n): number {\n  const bearing1 = bearing(centroidFeature, startPoint);\n  const bearing2 = bearing(centroidFeature, endPoint);\n  return bearing2 - bearing1;\n}\n\n/**\n * Snap an angle to the nearest interval.\n */\nfunction snapAngle(angle: number, interval: number): number {\n  return Math.round(angle / interval) * interval;\n}\n\n/**\n * Extends RotateMode to support snapping rotation to 45° intervals.\n *\n * ## Features\n * - **Default**: Free rotation (smooth, continuous angles)\n * - **With Shift**: Snap to 45° intervals (0°, 45°, 90°, 135°, 180°, etc.)\n *\n * This allows precise alignment of shapes to common angles, making it easy to\n * create axis-aligned or diagonally-aligned shapes.\n *\n * ## Implementation\n * The snap behavior is controlled by the `modeConfig.snapRotation` property,\n * which is set by BaseTransformMode when the Shift key is held. This class\n * calculates the rotation angle and rounds it to the nearest 45° interval\n * when snapping is enabled.\n *\n * ## Snap Interval\n * The snap interval is fixed at 45° (8 positions around the circle), providing\n * these angles: 0°, 45°, 90°, 135°, 180°, 225°, 270°, 315°.\n *\n * @example\n * ```typescript\n * import { RotateModeWithSnap } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap';\n * import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';\n *\n * const mode = new RotateModeWithSnap();\n *\n * const layer = new EditableGeoJsonLayer({\n *   mode,\n *   data: featureCollection,\n *   selectedFeatureIndexes: [0],\n *   onEdit: handleEdit,\n *   modeConfig: {\n *     snapRotation: true, // Enable 45° snapping\n *   },\n * });\n * ```\n */\nexport class RotateModeWithSnap extends RotateMode {\n  /**\n   * Override handleDragging to support snapped rotation.\n   * When snapRotation is true, rotates to nearest 45° interval.\n   * When snapRotation is false, delegates to parent for standard rotation.\n   */\n  override handleDragging(\n    event: DraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n\n    // If not snapping, use parent's rotation logic\n    if (!snapRotation) {\n      super.handleDragging(event, props);\n      return;\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (!self._isRotating) {\n      return;\n    }\n\n    const rotateAction = this.getRotateActionWithSnap(\n      event.pointerDownMapCoords,\n      event.mapCoords,\n      'rotating',\n      props,\n    );\n\n    if (rotateAction) {\n      props.onEdit(rotateAction);\n    }\n\n    event.cancelPan();\n  }\n\n  /**\n   * Override handleStopDragging to emit the final rotated geometry with snap.\n   * When snapRotation is false, delegates to parent for standard rotation.\n   */\n  override handleStopDragging(\n    event: StopDraggingEvent,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n\n    // If not snapping, use parent's rotation logic\n    if (!snapRotation) {\n      super.handleStopDragging(event, props);\n      return;\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (self._isRotating) {\n      const rotateAction = this.getRotateActionWithSnap(\n        event.pointerDownMapCoords,\n        event.mapCoords,\n        'rotated',\n        props,\n      );\n\n      if (rotateAction) {\n        props.onEdit(rotateAction);\n      }\n\n      // Reset state\n      self._geometryBeingRotated = null;\n      self._selectedEditHandle = null;\n      self._isRotating = false;\n    }\n  }\n\n  /**\n   * Get a rotate action, optionally snapping to 45° intervals.\n   */\n  private getRotateActionWithSnap(\n    startDragPoint: Position,\n    currentPoint: Position,\n    editType: string,\n    props: ModeProps<FeatureCollection>,\n  ) {\n    // biome-ignore lint/suspicious/noExplicitAny: Accessing private properties from parent class\n    const self = this as any;\n\n    if (!self._geometryBeingRotated) {\n      return null;\n    }\n\n    const geometry = self._geometryBeingRotated as FeatureCollection;\n    // @ts-expect-error turf types differ from editable-layers types\n    const centerFeature = centroid(geometry);\n\n    // Calculate the rotation angle (pass centroid Feature to match parent RotateMode)\n    let angle = getRotationAngle(centerFeature, startDragPoint, currentPoint);\n\n    // Snap to 45° intervals if enabled\n    const snapRotation = props.modeConfig?.snapRotation ?? false;\n    if (snapRotation) {\n      angle = snapAngle(angle, SNAP_INTERVAL_DEGREES);\n    }\n\n    // Apply the rotation using turf (use centroid Feature as pivot to match parent)\n    // @ts-expect-error turf types differ from editable-layers types\n    const rotatedFeatures: FeatureCollection = transformRotate(\n      // @ts-expect-error turf types differ from editable-layers types\n      geometry,\n      angle,\n      {\n        pivot: centerFeature,\n      },\n    );\n\n    // Build the updated data using ImmutableFeatureCollection (matches parent RotateMode)\n    const selectedIndexes = props.selectedIndexes;\n    let updatedData = new ImmutableFeatureCollection(props.data);\n\n    for (let i = 0; i < selectedIndexes.length; i++) {\n      const selectedIndex = selectedIndexes[i];\n      const movedFeature = rotatedFeatures.features[i];\n      if (selectedIndex !== undefined && movedFeature) {\n        updatedData = updatedData.replaceGeometry(\n          selectedIndex,\n          movedFeature.geometry,\n        );\n      }\n    }\n\n    return {\n      updatedData: updatedData.getObject(),\n      editType,\n      editContext: {\n        featureIndexes: selectedIndexes,\n      },\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwBA,MAAM,wBAAwB;;;;;;;;;AAU9B,SAAS,iBACP,iBACA,YACA,UACQ;CACR,MAAM,WAAW,QAAQ,iBAAiB,WAAW;AAErD,QADiB,QAAQ,iBAAiB,SAAS,GACjC;;;;;AAMpB,SAAS,UAAU,OAAe,UAA0B;AAC1D,QAAO,KAAK,MAAM,QAAQ,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCxC,IAAa,qBAAb,cAAwC,WAAW;;;;;;CAMjD,AAAS,eACP,OACA,OACA;AAIA,MAAI,EAHiB,MAAM,YAAY,gBAAgB,QAGpC;AACjB,SAAM,eAAe,OAAO,MAAM;AAClC;;AAMF,MAAI,CAFS,KAEH,YACR;EAGF,MAAM,eAAe,KAAK,wBACxB,MAAM,sBACN,MAAM,WACN,YACA,MACD;AAED,MAAI,aACF,OAAM,OAAO,aAAa;AAG5B,QAAM,WAAW;;;;;;CAOnB,AAAS,mBACP,OACA,OACA;AAIA,MAAI,EAHiB,MAAM,YAAY,gBAAgB,QAGpC;AACjB,SAAM,mBAAmB,OAAO,MAAM;AACtC;;EAIF,MAAM,OAAO;AAEb,MAAI,KAAK,aAAa;GACpB,MAAM,eAAe,KAAK,wBACxB,MAAM,sBACN,MAAM,WACN,WACA,MACD;AAED,OAAI,aACF,OAAM,OAAO,aAAa;AAI5B,QAAK,wBAAwB;AAC7B,QAAK,sBAAsB;AAC3B,QAAK,cAAc;;;;;;CAOvB,AAAQ,wBACN,gBACA,cACA,UACA,OACA;EAEA,MAAM,OAAO;AAEb,MAAI,CAAC,KAAK,sBACR,QAAO;EAGT,MAAM,WAAW,KAAK;EAEtB,MAAM,gBAAgB,SAAS,SAAS;EAGxC,IAAI,QAAQ,iBAAiB,eAAe,gBAAgB,aAAa;AAIzE,MADqB,MAAM,YAAY,gBAAgB,MAErD,SAAQ,UAAU,OAAO,sBAAsB;EAKjD,MAAMA,kBAAqC,gBAEzC,UACA,OACA,EACE,OAAO,eACR,CACF;EAGD,MAAM,kBAAkB,MAAM;EAC9B,IAAI,cAAc,IAAI,2BAA2B,MAAM,KAAK;AAE5D,OAAK,IAAI,IAAI,GAAG,IAAI,gBAAgB,QAAQ,KAAK;GAC/C,MAAM,gBAAgB,gBAAgB;GACtC,MAAM,eAAe,gBAAgB,SAAS;AAC9C,OAAI,kBAAkB,UAAa,aACjC,eAAc,YAAY,gBACxB,eACA,aAAa,SACd;;AAIL,SAAO;GACL,aAAa,YAAY,WAAW;GACpC;GACA,aAAa,EACX,gBAAgB,iBACjB;GACF"}

package/dist/deckgl/shapes/edit-shape-layer/modes/scale-mode-with-free-transform.js

@@ -18,8 +18,8 @@ import { ScaleMode } from "@deck.gl-community/editable-layers";
 * Extends ScaleMode to support non-uniform (free) scaling.
 *
 * ## Features
-* - Default: Free scaling - can stretch/squish in any direction
-* - With modeConfig.lockScaling = true: Uniform scaling (maintains aspect ratio)
+* - **Default**: Free scaling - can stretch/squish in any direction
+* - **With Shift**: Uniform scaling (maintains aspect ratio)
 *
 * ## How Non-Uniform Scaling Works
 *
@@ -53,6 +53,25 @@ import { ScaleMode } from "@deck.gl-community/editable-layers";
 * All scale factors are clamped to a minimum of 0.01 to prevent:
 * - Shape inversion (negative scale flipping the shape inside-out)
 * - Shape collapse (scale of 0 making the shape a point/line)
+*
+* @example
+* ```typescript
+* import { ScaleModeWithFreeTransform } from '@accelint/map-toolkit/deckgl/shapes/edit-shape-layer/modes/scale-mode-with-free-transform';
+* import { EditableGeoJsonLayer } from '@deck.gl-community/editable-layers';
+*
+* const mode = new ScaleModeWithFreeTransform();
+*
+* const layer = new EditableGeoJsonLayer({
+*   mode,
+*   data: featureCollection,
+*   selectedFeatureIndexes: [0],
+*   onEdit: handleEdit,
+*   modeConfig: {
+*     lockScaling: false, // Default: free scaling (stretch/squish)
+*     // lockScaling: true, // Hold Shift: uniform scaling (maintain aspect ratio)
+*   },
+* });
+* ```
 */
 var ScaleModeWithFreeTransform = class extends ScaleMode {
 	/**