@accelint/map-toolkit 0.5.0 → 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["shapeProperty: string | undefined"],"sources":["../../../../src/deckgl/shapes/edit-shape-layer/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { 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"}

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

@@ -0,0 +1,154 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { filterGeometryAwarePicks } from "../../shared/utils/pick-filtering.js";
+import { CompositeMode } from "@deck.gl-community/editable-layers";
+
+//#region src/deckgl/shapes/edit-shape-layer/modes/base-transform-mode.ts
+/**
+* Abstract base class for composite transform modes.
+*
+* 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
+*
+* Subclasses define their specific modes and handle matchers, while this
+* base class handles the delegation logic.
+*/
+var BaseTransformMode = class extends CompositeMode {
+	/** Track which mode is currently handling the drag operation */
+	activeDragMode = null;
+	/** Track current Shift state for dynamic modifier behavior */
+	isShiftHeld = false;
+	/** Tooltip for operations that show live measurements */
+	tooltip = null;
+	/**
+	* Aggregates cursor updates from all child modes.
+	* The first non-null cursor from any mode is used.
+	*/
+	handlePointerMove(event, props) {
+		let updatedCursor = null;
+		super.handlePointerMove(event, {
+			...props,
+			onUpdateCursor: (cursor) => {
+				updatedCursor = cursor || updatedCursor;
+			}
+		});
+		props.onUpdateCursor(updatedCursor);
+	}
+	/**
+	* Determines which mode should handle the drag based on picked handles.
+	* Cancels map panning and delegates to the matched mode.
+	*/
+	handleStartDragging(event, props) {
+		if (event.picks.length) event.cancelPan();
+		const picks = event.picks ?? [];
+		const matchers = this.getHandleMatchers();
+		for (const matcher of matchers) if (picks.some(matcher.match)) {
+			this.activeDragMode = matcher.mode;
+			break;
+		}
+		if (!this.activeDragMode) this.activeDragMode = this.getDefaultMode();
+		this.activeDragMode.handleStartDragging(event, props);
+	}
+	/**
+	* Delegates dragging to the active mode with Shift key handling.
+	* Reads Shift state from the source event and applies configured modifiers.
+	*/
+	handleDragging(event, props) {
+		if (!this.activeDragMode) return;
+		this.isShiftHeld = event.sourceEvent?.shiftKey ?? false;
+		const shiftConfig = this.getHandleMatchers().find((m) => m.mode === this.activeDragMode)?.shiftConfig;
+		if (shiftConfig && this.isShiftHeld) {
+			const propsWithConfig = {
+				...props,
+				modeConfig: {
+					...props.modeConfig,
+					[shiftConfig.configKey]: shiftConfig.value ?? true
+				}
+			};
+			this.activeDragMode.handleDragging(event, propsWithConfig);
+		} else this.activeDragMode.handleDragging(event, props);
+		this.onDragging?.(event, props);
+	}
+	/**
+	* Delegates stop dragging to the active mode with final Shift state.
+	* Resets all drag-related state.
+	*/
+	handleStopDragging(event, props) {
+		if (!this.activeDragMode) return;
+		const shiftConfig = this.getHandleMatchers().find((m) => m.mode === this.activeDragMode)?.shiftConfig;
+		if (shiftConfig && this.isShiftHeld) {
+			const propsWithConfig = {
+				...props,
+				modeConfig: {
+					...props.modeConfig,
+					[shiftConfig.configKey]: shiftConfig.value ?? true
+				}
+			};
+			this.activeDragMode.handleStopDragging(event, propsWithConfig);
+		} else this.activeDragMode.handleStopDragging(event, props);
+		this.resetDragState();
+	}
+	/**
+	* Returns tooltips for display during drag operations.
+	* Subclasses update `this.tooltip` in their `onDragging` hook.
+	*/
+	getTooltips() {
+		return this.tooltip ? [this.tooltip] : [];
+	}
+	/**
+	* Filters picks to prevent TypeError from sublayer elements without geometry.
+	*
+	* Some child modes (like ModifyMode, ResizeCircleMode) access
+	* `pick.object.geometry.type` which throws if the pick doesn't have
+	* a geometry property. This happens when picks include sublayer elements
+	* like tooltip text that aren't GeoJSON features.
+	*/
+	getGuides(props) {
+		const picks = props.lastPointerMoveEvent?.picks;
+		if (picks && picks.length > 0) {
+			const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);
+			if (didFilter) {
+				const filteredProps = {
+					...props,
+					lastPointerMoveEvent: {
+						...props.lastPointerMoveEvent,
+						picks: filteredPicks
+					}
+				};
+				return super.getGuides(filteredProps);
+			}
+		}
+		return super.getGuides(props);
+	}
+	/**
+	* Resets drag-related state. Called after drag stops.
+	* Subclasses can override to reset additional state but should call super.
+	*/
+	resetDragState() {
+		this.activeDragMode = null;
+		this.isShiftHeld = false;
+		this.tooltip = null;
+	}
+};
+
+//#endregion
+export { BaseTransformMode };
+//# sourceMappingURL=base-transform-mode.js.map

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

@@ -0,0 +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 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\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"}

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

@@ -0,0 +1,147 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { formatEllipseTooltip, formatRectangleTooltip } from "../../shared/constants.js";
+import { DEFAULT_DISTANCE_UNITS, getDistanceUnitAbbreviation } from "../../../../shared/units.js";
+import { computeEllipseMeasurementsFromPolygon, computeRectangleMeasurementsFromCorners } from "../../shared/utils/geometry-measurements.js";
+import { BaseTransformMode } from "./base-transform-mode.js";
+import { RotateModeWithSnap } from "./rotate-mode-with-snap.js";
+import { ScaleModeWithFreeTransform } from "./scale-mode-with-free-transform.js";
+import { TranslateMode } from "@deck.gl-community/editable-layers";
+import { featureCollection } from "@turf/helpers";
+
+//#region src/deckgl/shapes/edit-shape-layer/modes/bounding-transform-mode.ts
+/**
+* Transform mode for shapes that use bounding box manipulation (no vertex editing).
+*
+* Use this mode for shapes like ellipses and rectangles where individual vertex
+* editing is not meaningful or desired. Instead, shapes are manipulated via their
+* bounding box handles.
+*
+* This composite mode provides:
+* - **Translation** (TranslateMode): Drag the shape body to move it
+* - **Scaling** (ScaleModeWithFreeTransform): Drag corner handles to resize
+*   - Default: Non-uniform scaling (can stretch/squish)
+*   - With Shift: Uniform scaling (maintains aspect ratio)
+* - **Rotation** (RotateModeWithSnap): Drag top handle to rotate
+*   - Default: Free rotation
+*   - With Shift: Snap to 45° intervals
+* - **Live tooltip**: Shows dimensions and area during scaling
+*
+* Unlike VertexTransformMode, this mode does NOT include vertex editing handles.
+*
+* 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
+*/
+var BoundingTransformMode = class extends BaseTransformMode {
+	translateMode;
+	scaleMode;
+	rotateMode;
+	constructor() {
+		const translateMode = new TranslateMode();
+		const scaleMode = new ScaleModeWithFreeTransform();
+		const rotateMode = new RotateModeWithSnap();
+		super([
+			scaleMode,
+			rotateMode,
+			translateMode
+		]);
+		this.translateMode = translateMode;
+		this.scaleMode = scaleMode;
+		this.rotateMode = rotateMode;
+	}
+	getHandleMatchers() {
+		return [{
+			match: (pick) => Boolean(pick.isGuide && pick.object?.properties?.editHandleType === "scale"),
+			mode: this.scaleMode,
+			shiftConfig: { configKey: "lockScaling" }
+		}, {
+			match: (pick) => Boolean(pick.isGuide && pick.object?.properties?.editHandleType === "rotate"),
+			mode: this.rotateMode,
+			shiftConfig: { configKey: "snapRotation" }
+		}];
+	}
+	getDefaultMode() {
+		return this.translateMode;
+	}
+	/**
+	* Update tooltip with shape dimensions during scaling.
+	*/
+	onDragging(event, props) {
+		if (this.activeDragMode !== this.scaleMode) return;
+		this.updateShapeTooltip(event, props);
+	}
+	/**
+	* Override getGuides to filter duplicate envelope guides.
+	*
+	* Both ScaleMode and RotateMode render the same bounding box envelope.
+	* We keep scale's envelope and filter rotate's duplicate.
+	* We also hide scale handles while rotating to avoid visual clutter.
+	*/
+	getGuides(props) {
+		return featureCollection(super.getGuides(props).features.filter((guide) => {
+			const properties = guide.properties || {};
+			const editHandleType = properties.editHandleType;
+			const guidesToFilterOut = [properties.mode];
+			if (this.rotateMode.getIsRotating()) guidesToFilterOut.push(editHandleType);
+			return !guidesToFilterOut.includes("scale");
+		}));
+	}
+	/**
+	* Update the tooltip with shape dimensions and area.
+	* Called during scaling to show live measurements.
+	* Handles both rectangles (5 points) and ellipses (many points).
+	*/
+	updateShapeTooltip(event, props) {
+		const { mapCoords } = event;
+		const distanceUnits = props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;
+		const selectedIndex = props.selectedIndexes?.[0];
+		if (selectedIndex === void 0) {
+			this.tooltip = null;
+			return;
+		}
+		const feature = props.data.features[selectedIndex];
+		if (!feature || feature.geometry.type !== "Polygon") {
+			this.tooltip = null;
+			return;
+		}
+		const coordinates = feature.geometry.coordinates[0];
+		if (!coordinates || coordinates.length < 4) {
+			this.tooltip = null;
+			return;
+		}
+		const isRectangle = feature.properties?.shape === "Rectangle";
+		let text;
+		const unitAbbrev = getDistanceUnitAbbreviation(distanceUnits);
+		if (isRectangle) {
+			const corner0 = coordinates[0];
+			const corner1 = coordinates[1];
+			const corner2 = coordinates[2];
+			const { width, height, area } = computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, distanceUnits);
+			text = formatRectangleTooltip(width, height, area, unitAbbrev);
+		} else {
+			const { majorAxis, minorAxis, area: ellipseArea } = computeEllipseMeasurementsFromPolygon(coordinates, distanceUnits);
+			text = formatEllipseTooltip(majorAxis, minorAxis, ellipseArea, unitAbbrev);
+		}
+		this.tooltip = {
+			position: mapCoords,
+			text
+		};
+	}
+};
+
+//#endregion
+export { BoundingTransformMode };
+//# sourceMappingURL=bounding-transform-mode.js.map

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

@@ -0,0 +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 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\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"}

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

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { formatCircleTooltip } from "../../shared/constants.js";
+import { DEFAULT_DISTANCE_UNITS, getDistanceUnitAbbreviation } from "../../../../shared/units.js";
+import { computeCircleMeasurements } from "../../shared/utils/geometry-measurements.js";
+import { BaseTransformMode } from "./base-transform-mode.js";
+import { ResizeCircleMode, TranslateMode } from "@deck.gl-community/editable-layers";
+import { centroid } from "@turf/turf";
+
+//#region src/deckgl/shapes/edit-shape-layer/modes/circle-transform-mode.ts
+/**
+* Transform mode for circles combining resize and translate.
+*
+* 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
+*/
+var CircleTransformMode = class extends BaseTransformMode {
+	resizeMode;
+	translateMode;
+	constructor() {
+		const resizeMode = new ResizeCircleMode();
+		const translateMode = new TranslateMode();
+		super([resizeMode, translateMode]);
+		this.resizeMode = resizeMode;
+		this.translateMode = translateMode;
+	}
+	getHandleMatchers() {
+		return [{
+			match: (pick) => Boolean(pick.isGuide && pick.object?.properties?.guideType === "editHandle" && pick.object?.properties?.editHandleType === "intermediate"),
+			mode: this.resizeMode
+		}];
+	}
+	getDefaultMode() {
+		return this.translateMode;
+	}
+	/**
+	* Update the tooltip with circle diameter and area during resize.
+	*/
+	onDragging(event, props) {
+		if (this.activeDragMode !== this.resizeMode) return;
+		const { mapCoords } = event;
+		const distanceUnits = props.modeConfig?.distanceUnits ?? DEFAULT_DISTANCE_UNITS;
+		const selectedIndex = props.selectedIndexes?.[0];
+		if (selectedIndex === void 0) {
+			this.tooltip = null;
+			return;
+		}
+		const feature = props.data.features[selectedIndex];
+		if (!feature || feature.geometry.type !== "Polygon") {
+			this.tooltip = null;
+			return;
+		}
+		const coordinates = feature.geometry.coordinates[0];
+		if (!coordinates || coordinates.length < 3) {
+			this.tooltip = null;
+			return;
+		}
+		const center = centroid(feature).geometry.coordinates;
+		const firstPoint = coordinates[0];
+		const { diameter, area: area$1 } = computeCircleMeasurements(center, firstPoint, distanceUnits);
+		this.tooltip = {
+			position: mapCoords,
+			text: formatCircleTooltip(diameter, area$1, getDistanceUnitAbbreviation(distanceUnits))
+		};
+	}
+};
+
+//#endregion
+export { CircleTransformMode };
+//# sourceMappingURL=circle-transform-mode.js.map

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

@@ -0,0 +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 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\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"}

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

@@ -0,0 +1,61 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { BoundingTransformMode } from "./bounding-transform-mode.js";
+import { CircleTransformMode } from "./circle-transform-mode.js";
+import { VertexTransformMode } from "./vertex-transform-mode.js";
+import { TranslateMode, ViewMode } from "@deck.gl-community/editable-layers";
+
+//#region src/deckgl/shapes/edit-shape-layer/modes/index.ts
+/**
+* Cached edit mode instances.
+*
+* CRITICAL: Mode instances must be cached at module level to prevent
+* deck.gl assertion failures. Creating new mode instances on each render
+* causes the EditableGeoJsonLayer to fail with assertion errors.
+*
+* BoundingTransformMode combines ScaleModeWithFreeTransform, RotateMode, and
+* TranslateMode for shapes without vertex editing (ellipses, rectangles),
+* allowing non-uniform scaling plus rotate/translate via bounding box handles.
+* Shows live dimension tooltips during scaling.
+*
+* VertexTransformMode combines ModifyMode with ScaleModeWithFreeTransform,
+* RotateMode, and TranslateMode for shapes that support vertex editing
+* (polygons, lines), allowing vertex manipulation plus scale/rotate/translate.
+*
+* CircleTransformMode combines ResizeCircleMode with TranslateMode
+* for circles, allowing resize from edge plus drag to translate.
+* Shows live diameter/area tooltips during resize.
+*
+* TranslateMode allows dragging to move the shape (used for points).
+*/
+const EDIT_MODE_INSTANCES = {
+	view: new ViewMode(),
+	"bounding-transform": new BoundingTransformMode(),
+	"vertex-transform": new VertexTransformMode(),
+	"circle-transform": new CircleTransformMode(),
+	translate: new TranslateMode()
+};
+/**
+* Get the cached mode instance for an edit mode.
+*
+* @param mode - The edit mode to get the instance for
+* @returns The cached mode instance
+*/
+function getEditModeInstance(mode) {
+	return EDIT_MODE_INSTANCES[mode];
+}
+
+//#endregion
+export { getEditModeInstance };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/deckgl/shapes/edit-shape-layer/modes/index.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\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"}

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

@@ -0,0 +1,109 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { ImmutableFeatureCollection, RotateMode } from "@deck.gl-community/editable-layers";
+import { bearing, centroid, transformRotate } from "@turf/turf";
+
+//#region src/deckgl/shapes/edit-shape-layer/modes/rotate-mode-with-snap.ts
+/** Snap interval in degrees (45° = 8 positions around the circle) */
+const SNAP_INTERVAL_DEGREES = 45;
+/**
+* Calculate the angle between two points relative to a centroid.
+* Uses turfBearing for geographic bearing convention (matches parent RotateMode).
+* Returns angle in degrees.
+*
+* Note: centroid must be a turf Point Feature (not just coordinates) to match
+* the parent RotateMode's behavior exactly.
+*/
+function getRotationAngle(centroidFeature, startPoint, endPoint) {
+	const bearing1 = bearing(centroidFeature, startPoint);
+	return bearing(centroidFeature, endPoint) - bearing1;
+}
+/**
+* Snap an angle to the nearest interval.
+*/
+function snapAngle(angle, interval) {
+	return Math.round(angle / interval) * 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.)
+*
+* This allows precise alignment of shapes to common angles.
+*/
+var RotateModeWithSnap = class extends RotateMode {
+	/**
+	* Override handleDragging to support snapped rotation.
+	* When snapRotation is true, rotates to nearest 45° interval.
+	* When snapRotation is false, delegates to parent for standard rotation.
+	*/
+	handleDragging(event, props) {
+		if (!(props.modeConfig?.snapRotation ?? false)) {
+			super.handleDragging(event, props);
+			return;
+		}
+		if (!this._isRotating) return;
+		const rotateAction = this.getRotateActionWithSnap(event.pointerDownMapCoords, event.mapCoords, "rotating", props);
+		if (rotateAction) props.onEdit(rotateAction);
+		event.cancelPan();
+	}
+	/**
+	* Override handleStopDragging to emit the final rotated geometry with snap.
+	* When snapRotation is false, delegates to parent for standard rotation.
+	*/
+	handleStopDragging(event, props) {
+		if (!(props.modeConfig?.snapRotation ?? false)) {
+			super.handleStopDragging(event, props);
+			return;
+		}
+		const self = this;
+		if (self._isRotating) {
+			const rotateAction = this.getRotateActionWithSnap(event.pointerDownMapCoords, event.mapCoords, "rotated", props);
+			if (rotateAction) props.onEdit(rotateAction);
+			self._geometryBeingRotated = null;
+			self._selectedEditHandle = null;
+			self._isRotating = false;
+		}
+	}
+	/**
+	* Get a rotate action, optionally snapping to 45° intervals.
+	*/
+	getRotateActionWithSnap(startDragPoint, currentPoint, editType, props) {
+		const self = this;
+		if (!self._geometryBeingRotated) return null;
+		const geometry = self._geometryBeingRotated;
+		const centerFeature = centroid(geometry);
+		let angle = getRotationAngle(centerFeature, startDragPoint, currentPoint);
+		if (props.modeConfig?.snapRotation ?? false) angle = snapAngle(angle, SNAP_INTERVAL_DEGREES);
+		const rotatedFeatures = transformRotate(geometry, angle, { pivot: centerFeature });
+		const selectedIndexes = props.selectedIndexes;
+		let updatedData = new ImmutableFeatureCollection(props.data);
+		for (let i = 0; i < selectedIndexes.length; i++) {
+			const selectedIndex = selectedIndexes[i];
+			const movedFeature = rotatedFeatures.features[i];
+			if (selectedIndex !== void 0 && movedFeature) updatedData = updatedData.replaceGeometry(selectedIndex, movedFeature.geometry);
+		}
+		return {
+			updatedData: updatedData.getObject(),
+			editType,
+			editContext: { featureIndexes: selectedIndexes }
+		};
+	}
+};
+
+//#endregion
+export { RotateModeWithSnap };
+//# sourceMappingURL=rotate-mode-with-snap.js.map