@accelint/map-toolkit 1.4.0 → 2.0.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,18 +11,16 @@
  */
 
 
-'use client';
-
-import { distance, point } from "@turf/turf";
+import { distance } from "@turf/turf";
 
 //#region src/deckgl/shapes/shared/utils/geometry-measurements.ts
 /**
 * Compute circle measurements from center and edge point.
 *
-* @param center - Center point as [longitude, latitude]
-* @param edgePoint - Point on the circle's edge as [longitude, latitude]
-* @param units - Distance units for the measurements
-* @returns Circle measurements including radius, diameter, and area
+* @param center - Center point as [longitude, latitude].
+* @param edgePoint - Point on the circle's edge as [longitude, latitude].
+* @param units - Distance units for the measurements.
+* @returns Circle measurements including radius, diameter, and area.
 *
 * @example
 * ```typescript
@@ -49,11 +47,11 @@ function computeCircleMeasurements(center, edgePoint, units) {
 * - corner0 to corner1 defines one edge (width)
 * - corner1 to corner2 defines the adjacent edge (height)
 *
-* @param corner0 - First corner as [longitude, latitude]
-* @param corner1 - Adjacent corner as [longitude, latitude]
-* @param corner2 - Corner adjacent to corner1 as [longitude, latitude]
-* @param units - Distance units for the measurements
-* @returns Rectangle measurements including width, height, and area
+* @param corner0 - First corner as [longitude, latitude].
+* @param corner1 - Adjacent corner as [longitude, latitude].
+* @param corner2 - Corner adjacent to corner1 as [longitude, latitude].
+* @param units - Distance units for the measurements.
+* @returns Rectangle measurements including width, height, and area.
 *
 * @example
 * ```typescript
@@ -67,8 +65,9 @@ function computeCircleMeasurements(center, edgePoint, units) {
 * ```
 */
 function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, units) {
-	const width = distance(point(corner0), point(corner1), { units });
-	const height = distance(point(corner1), point(corner2), { units });
+	const options = { units };
+	const width = distance(corner0, corner1, options);
+	const height = distance(corner1, corner2, options);
 	return {
 		width,
 		height,
@@ -81,9 +80,9 @@ function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, unit
 * For an ellipse approximated as a polygon, calculates the major and minor axes
 * by measuring distances between opposite points on the perimeter.
 *
-* @param coordinates - Polygon ring coordinates as [[lon, lat], ...]
-* @param units - Distance units for the measurements
-* @returns Ellipse measurements including axes and area
+* @param coordinates - Polygon ring coordinates as [[lon, lat], ...].
+* @param units - Distance units for the measurements.
+* @returns Ellipse measurements including axes and area.
 *
 * @example
 * ```typescript
@@ -95,20 +94,24 @@ function computeRectangleMeasurementsFromCorners(corner0, corner1, corner2, unit
 * ```
 */
 function computeEllipseMeasurementsFromPolygon(coordinates, units) {
-	const points = coordinates[0]?.[0] === coordinates[coordinates.length - 1]?.[0] && coordinates[0]?.[1] === coordinates[coordinates.length - 1]?.[1] ? coordinates.slice(0, -1) : coordinates;
-	if (points.length < 4) return {
+	const len = coordinates.length;
+	const pointCount = len > 0 && coordinates[0]?.[0] === coordinates[len - 1]?.[0] && coordinates[0]?.[1] === coordinates[len - 1]?.[1] ? len - 1 : len;
+	if (pointCount < 4) return {
+		xSemiAxis: 0,
+		ySemiAxis: 0,
 		majorAxis: 0,
 		minorAxis: 0,
 		area: 0
 	};
-	const halfLen = Math.floor(points.length / 2);
+	const halfLen = Math.floor(pointCount / 2);
+	const options = { units };
 	let maxDist = 0;
 	let minDist = Number.POSITIVE_INFINITY;
 	for (let i = 0; i < halfLen; i++) {
-		const p1 = points[i];
-		const p2 = points[i + halfLen];
+		const p1 = coordinates[i];
+		const p2 = coordinates[i + halfLen];
 		if (!(p1 && p2)) continue;
-		const dist = distance([p1[0], p1[1]], [p2[0], p2[1]], { units });
+		const dist = distance(p1, p2, options);
 		if (dist > maxDist) maxDist = dist;
 		if (dist < minDist) minDist = dist;
 	}
@@ -117,6 +120,8 @@ function computeEllipseMeasurementsFromPolygon(coordinates, units) {
 	const semiMajor = majorAxis / 2;
 	const semiMinor = minorAxis / 2;
 	return {
+		xSemiAxis: semiMajor,
+		ySemiAxis: semiMinor,
 		majorAxis,
 		minorAxis,
 		area: Math.PI * semiMajor * semiMinor

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

@@ -1 +1 @@
-{"version":3,"file":"geometry-measurements.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/geometry-measurements.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { distance, point } from '@turf/turf';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Circle measurement result containing radius, diameter, and area.\n */\nexport interface CircleMeasurements {\n  /** Radius in the specified units */\n  radius: number;\n  /** Diameter (radius * 2) in the specified units */\n  diameter: number;\n  /** Area (π * radius²) in the specified units squared */\n  area: number;\n}\n\n/**\n * Ellipse measurement result containing semi-axes and area.\n */\nexport interface EllipseMeasurements {\n  /** X semi-axis (horizontal radius) in the specified units */\n  xSemiAxis: number;\n  /** Y semi-axis (vertical radius) in the specified units */\n  ySemiAxis: number;\n  /** Major axis (full length of longer axis) in the specified units */\n  majorAxis: number;\n  /** Minor axis (full length of shorter axis) in the specified units */\n  minorAxis: number;\n  /** Area (π * xSemiAxis * ySemiAxis) in the specified units squared */\n  area: number;\n}\n\n/**\n * Rectangle measurement result containing width, height, and area.\n */\nexport interface RectangleMeasurements {\n  /** Width in the specified units */\n  width: number;\n  /** Height in the specified units */\n  height: number;\n  /** Area (width * height) in the specified units squared */\n  area: number;\n}\n\n/**\n * Compute circle measurements from center and edge point.\n *\n * @param center - Center point as [longitude, latitude]\n * @param edgePoint - Point on the circle's edge as [longitude, latitude]\n * @param units - Distance units for the measurements\n * @returns Circle measurements including radius, diameter, and area\n *\n * @example\n * ```typescript\n * const { radius, diameter, area } = computeCircleMeasurements(\n *   [-122.4, 37.8],\n *   [-122.3, 37.8],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeCircleMeasurements(\n  center: [number, number],\n  edgePoint: [number, number],\n  units: DistanceUnit,\n): CircleMeasurements {\n  const radius = distance(center, edgePoint, { units });\n  const diameter = radius * 2;\n  const area = Math.PI * radius ** 2;\n\n  return { radius, diameter, area };\n}\n\n/**\n * Compute ellipse measurements from center and semi-axis lengths.\n *\n * @param xSemiAxis - X semi-axis (horizontal radius) in the specified units\n * @param ySemiAxis - Y semi-axis (vertical radius) in the specified units\n * @returns Ellipse measurements including axes and area\n *\n * @example\n * ```typescript\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromAxes(100, 50);\n * ```\n */\nexport function computeEllipseMeasurementsFromAxes(\n  xSemiAxis: number,\n  ySemiAxis: number,\n): EllipseMeasurements {\n  const majorAxis = Math.max(xSemiAxis, ySemiAxis) * 2;\n  const minorAxis = Math.min(xSemiAxis, ySemiAxis) * 2;\n  const area = Math.PI * xSemiAxis * ySemiAxis;\n\n  return { xSemiAxis, ySemiAxis, majorAxis, minorAxis, area };\n}\n\n/**\n * Compute rectangle measurements from adjacent corner points.\n *\n * Uses geodesic distance calculations for accurate measurements on Earth's surface.\n * Corners should be provided in order: corner0 -> corner1 -> corner2 where:\n * - corner0 to corner1 defines one edge (width)\n * - corner1 to corner2 defines the adjacent edge (height)\n *\n * @param corner0 - First corner as [longitude, latitude]\n * @param corner1 - Adjacent corner as [longitude, latitude]\n * @param corner2 - Corner adjacent to corner1 as [longitude, latitude]\n * @param units - Distance units for the measurements\n * @returns Rectangle measurements including width, height, and area\n *\n * @example\n * ```typescript\n * const coords = polygon.geometry.coordinates[0];\n * const { width, height, area } = computeRectangleMeasurementsFromCorners(\n *   coords[0] as [number, number],\n *   coords[1] as [number, number],\n *   coords[2] as [number, number],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeRectangleMeasurementsFromCorners(\n  corner0: [number, number],\n  corner1: [number, number],\n  corner2: [number, number],\n  units: DistanceUnit,\n): RectangleMeasurements {\n  const width = distance(point(corner0), point(corner1), { units });\n  const height = distance(point(corner1), point(corner2), { units });\n  const area = width * height;\n\n  return { width, height, area };\n}\n\n/**\n * Compute ellipse measurements from polygon coordinates.\n *\n * For an ellipse approximated as a polygon, calculates the major and minor axes\n * by measuring distances between opposite points on the perimeter.\n *\n * @param coordinates - Polygon ring coordinates as [[lon, lat], ...]\n * @param units - Distance units for the measurements\n * @returns Ellipse measurements including axes and area\n *\n * @example\n * ```typescript\n * const coords = polygon.geometry.coordinates[0];\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromPolygon(\n *   coords as [number, number][],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeEllipseMeasurementsFromPolygon(\n  coordinates: [number, number][],\n  units: DistanceUnit,\n): { majorAxis: number; minorAxis: number; area: number } {\n  // Remove the closing point if it duplicates the first\n  const points =\n    coordinates[0]?.[0] === coordinates[coordinates.length - 1]?.[0] &&\n    coordinates[0]?.[1] === coordinates[coordinates.length - 1]?.[1]\n      ? coordinates.slice(0, -1)\n      : coordinates;\n\n  if (points.length < 4) {\n    return { majorAxis: 0, minorAxis: 0, area: 0 };\n  }\n\n  // For an ellipse polygon, opposite points are at index i and i + n/2\n  const halfLen = Math.floor(points.length / 2);\n  let maxDist = 0;\n  let minDist = Number.POSITIVE_INFINITY;\n\n  // Sample several diameter measurements\n  for (let i = 0; i < halfLen; i++) {\n    const p1 = points[i];\n    const p2 = points[i + halfLen];\n    if (!(p1 && p2)) {\n      continue;\n    }\n\n    const dist = distance(\n      [p1[0] as number, p1[1] as number],\n      [p2[0] as number, p2[1] as number],\n      { units },\n    );\n\n    if (dist > maxDist) {\n      maxDist = dist;\n    }\n    if (dist < minDist) {\n      minDist = dist;\n    }\n  }\n\n  const majorAxis = maxDist;\n  const minorAxis = minDist === Number.POSITIVE_INFINITY ? maxDist : minDist;\n\n  // Ellipse area = π × a × b (where a and b are semi-axes)\n  const semiMajor = majorAxis / 2;\n  const semiMinor = minorAxis / 2;\n  const ellipseArea = Math.PI * semiMajor * semiMinor;\n\n  return { majorAxis, minorAxis, area: ellipseArea };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,0BACd,QACA,WACA,OACoB;CACpB,MAAM,SAAS,SAAS,QAAQ,WAAW,EAAE,OAAO,CAAC;AAIrD,QAAO;EAAE;EAAQ,UAHA,SAAS;EAGC,MAFd,KAAK,KAAK,UAAU;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnC,SAAgB,wCACd,SACA,SACA,SACA,OACuB;CACvB,MAAM,QAAQ,SAAS,MAAM,QAAQ,EAAE,MAAM,QAAQ,EAAE,EAAE,OAAO,CAAC;CACjE,MAAM,SAAS,SAAS,MAAM,QAAQ,EAAE,MAAM,QAAQ,EAAE,EAAE,OAAO,CAAC;AAGlE,QAAO;EAAE;EAAO;EAAQ,MAFX,QAAQ;EAES;;;;;;;;;;;;;;;;;;;;;AAsBhC,SAAgB,sCACd,aACA,OACwD;CAExD,MAAM,SACJ,YAAY,KAAK,OAAO,YAAY,YAAY,SAAS,KAAK,MAC9D,YAAY,KAAK,OAAO,YAAY,YAAY,SAAS,KAAK,KAC1D,YAAY,MAAM,GAAG,GAAG,GACxB;AAEN,KAAI,OAAO,SAAS,EAClB,QAAO;EAAE,WAAW;EAAG,WAAW;EAAG,MAAM;EAAG;CAIhD,MAAM,UAAU,KAAK,MAAM,OAAO,SAAS,EAAE;CAC7C,IAAI,UAAU;CACd,IAAI,UAAU,OAAO;AAGrB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;EAChC,MAAM,KAAK,OAAO;EAClB,MAAM,KAAK,OAAO,IAAI;AACtB,MAAI,EAAE,MAAM,IACV;EAGF,MAAM,OAAO,SACX,CAAC,GAAG,IAAc,GAAG,GAAa,EAClC,CAAC,GAAG,IAAc,GAAG,GAAa,EAClC,EAAE,OAAO,CACV;AAED,MAAI,OAAO,QACT,WAAU;AAEZ,MAAI,OAAO,QACT,WAAU;;CAId,MAAM,YAAY;CAClB,MAAM,YAAY,YAAY,OAAO,oBAAoB,UAAU;CAGnE,MAAM,YAAY,YAAY;CAC9B,MAAM,YAAY,YAAY;AAG9B,QAAO;EAAE;EAAW;EAAW,MAFX,KAAK,KAAK,YAAY;EAEQ"}
+{"version":3,"file":"geometry-measurements.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/geometry-measurements.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { distance } from '@turf/turf';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Circle measurement result containing radius, diameter, and area.\n */\nexport type CircleMeasurements = {\n  /** Radius in the specified units. */\n  radius: number;\n  /** Diameter (radius * 2) in the specified units. */\n  diameter: number;\n  /** Area (π * radius²) in the specified units squared. */\n  area: number;\n};\n\n/**\n * Ellipse measurement result containing semi-axes and area.\n */\nexport type EllipseMeasurements = {\n  /** X semi-axis (horizontal radius) in the specified units. */\n  xSemiAxis: number;\n  /** Y semi-axis (vertical radius) in the specified units. */\n  ySemiAxis: number;\n  /** Major axis (full length of longer axis) in the specified units. */\n  majorAxis: number;\n  /** Minor axis (full length of shorter axis) in the specified units. */\n  minorAxis: number;\n  /** Area (π * xSemiAxis * ySemiAxis) in the specified units squared. */\n  area: number;\n};\n\n/**\n * Rectangle measurement result containing width, height, and area.\n */\nexport type RectangleMeasurements = {\n  /** Width in the specified units. */\n  width: number;\n  /** Height in the specified units. */\n  height: number;\n  /** Area (width * height) in the specified units squared. */\n  area: number;\n};\n\n/**\n * Compute circle measurements from center and edge point.\n *\n * @param center - Center point as [longitude, latitude].\n * @param edgePoint - Point on the circle's edge as [longitude, latitude].\n * @param units - Distance units for the measurements.\n * @returns Circle measurements including radius, diameter, and area.\n *\n * @example\n * ```typescript\n * const { radius, diameter, area } = computeCircleMeasurements(\n *   [-122.4, 37.8],\n *   [-122.3, 37.8],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeCircleMeasurements(\n  center: [number, number],\n  edgePoint: [number, number],\n  units: DistanceUnit,\n): CircleMeasurements {\n  const radius = distance(center, edgePoint, { units });\n  const diameter = radius * 2;\n  const area = Math.PI * radius ** 2;\n\n  return { radius, diameter, area };\n}\n\n/**\n * Compute ellipse measurements from semi-axis lengths.\n *\n * @param xSemiAxis - X semi-axis (horizontal radius) in the specified units.\n * @param ySemiAxis - Y semi-axis (vertical radius) in the specified units.\n * @returns Ellipse measurements including axes and area.\n *\n * @example\n * ```typescript\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromAxes(100, 50);\n * ```\n */\nexport function computeEllipseMeasurementsFromAxes(\n  xSemiAxis: number,\n  ySemiAxis: number,\n): EllipseMeasurements {\n  const majorAxis = Math.max(xSemiAxis, ySemiAxis) * 2;\n  const minorAxis = Math.min(xSemiAxis, ySemiAxis) * 2;\n  const area = Math.PI * xSemiAxis * ySemiAxis;\n\n  return { xSemiAxis, ySemiAxis, majorAxis, minorAxis, area };\n}\n\n/**\n * Compute rectangle measurements from adjacent corner points.\n *\n * Uses geodesic distance calculations for accurate measurements on Earth's surface.\n * Corners should be provided in order: corner0 -> corner1 -> corner2 where:\n * - corner0 to corner1 defines one edge (width)\n * - corner1 to corner2 defines the adjacent edge (height)\n *\n * @param corner0 - First corner as [longitude, latitude].\n * @param corner1 - Adjacent corner as [longitude, latitude].\n * @param corner2 - Corner adjacent to corner1 as [longitude, latitude].\n * @param units - Distance units for the measurements.\n * @returns Rectangle measurements including width, height, and area.\n *\n * @example\n * ```typescript\n * const coords = polygon.geometry.coordinates[0];\n * const { width, height, area } = computeRectangleMeasurementsFromCorners(\n *   coords[0] as [number, number],\n *   coords[1] as [number, number],\n *   coords[2] as [number, number],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeRectangleMeasurementsFromCorners(\n  corner0: [number, number],\n  corner1: [number, number],\n  corner2: [number, number],\n  units: DistanceUnit,\n): RectangleMeasurements {\n  const options = { units };\n  const width = distance(corner0, corner1, options);\n  const height = distance(corner1, corner2, options);\n  const area = width * height;\n\n  return { width, height, area };\n}\n\n/**\n * Compute ellipse measurements from polygon coordinates.\n *\n * For an ellipse approximated as a polygon, calculates the major and minor axes\n * by measuring distances between opposite points on the perimeter.\n *\n * @param coordinates - Polygon ring coordinates as [[lon, lat], ...].\n * @param units - Distance units for the measurements.\n * @returns Ellipse measurements including axes and area.\n *\n * @example\n * ```typescript\n * const coords = polygon.geometry.coordinates[0];\n * const { majorAxis, minorAxis, area } = computeEllipseMeasurementsFromPolygon(\n *   coords as [number, number][],\n *   'kilometers'\n * );\n * ```\n */\nexport function computeEllipseMeasurementsFromPolygon(\n  coordinates: [number, number][],\n  units: DistanceUnit,\n): EllipseMeasurements {\n  // Determine effective point count without allocating a new array\n  const len = coordinates.length;\n  const isClosed =\n    len > 0 &&\n    coordinates[0]?.[0] === coordinates[len - 1]?.[0] &&\n    coordinates[0]?.[1] === coordinates[len - 1]?.[1];\n  const pointCount = isClosed ? len - 1 : len;\n\n  if (pointCount < 4) {\n    return { xSemiAxis: 0, ySemiAxis: 0, majorAxis: 0, minorAxis: 0, area: 0 };\n  }\n\n  // For an ellipse polygon, opposite points are at index i and i + n/2\n  const halfLen = Math.floor(pointCount / 2);\n  const options = { units };\n  let maxDist = 0;\n  let minDist = Number.POSITIVE_INFINITY;\n\n  // Sample several diameter measurements\n  for (let i = 0; i < halfLen; i++) {\n    const p1 = coordinates[i];\n    const p2 = coordinates[i + halfLen];\n    if (!(p1 && p2)) {\n      continue;\n    }\n\n    const dist = distance(p1, p2, options);\n\n    if (dist > maxDist) {\n      maxDist = dist;\n    }\n    if (dist < minDist) {\n      minDist = dist;\n    }\n  }\n\n  const majorAxis = maxDist;\n  const minorAxis = minDist === Number.POSITIVE_INFINITY ? maxDist : minDist;\n\n  // Ellipse area = π × a × b (where a and b are semi-axes)\n  const semiMajor = majorAxis / 2;\n  const semiMinor = minorAxis / 2;\n  const area = Math.PI * semiMajor * semiMinor;\n\n  return {\n    xSemiAxis: semiMajor,\n    ySemiAxis: semiMinor,\n    majorAxis,\n    minorAxis,\n    area,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEA,SAAgB,0BACd,QACA,WACA,OACoB;CACpB,MAAM,SAAS,SAAS,QAAQ,WAAW,EAAE,OAAO,CAAC;AAIrD,QAAO;EAAE;EAAQ,UAHA,SAAS;EAGC,MAFd,KAAK,KAAK,UAAU;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDnC,SAAgB,wCACd,SACA,SACA,SACA,OACuB;CACvB,MAAM,UAAU,EAAE,OAAO;CACzB,MAAM,QAAQ,SAAS,SAAS,SAAS,QAAQ;CACjD,MAAM,SAAS,SAAS,SAAS,SAAS,QAAQ;AAGlD,QAAO;EAAE;EAAO;EAAQ,MAFX,QAAQ;EAES;;;;;;;;;;;;;;;;;;;;;AAsBhC,SAAgB,sCACd,aACA,OACqB;CAErB,MAAM,MAAM,YAAY;CAKxB,MAAM,aAHJ,MAAM,KACN,YAAY,KAAK,OAAO,YAAY,MAAM,KAAK,MAC/C,YAAY,KAAK,OAAO,YAAY,MAAM,KAAK,KACnB,MAAM,IAAI;AAExC,KAAI,aAAa,EACf,QAAO;EAAE,WAAW;EAAG,WAAW;EAAG,WAAW;EAAG,WAAW;EAAG,MAAM;EAAG;CAI5E,MAAM,UAAU,KAAK,MAAM,aAAa,EAAE;CAC1C,MAAM,UAAU,EAAE,OAAO;CACzB,IAAI,UAAU;CACd,IAAI,UAAU,OAAO;AAGrB,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;EAChC,MAAM,KAAK,YAAY;EACvB,MAAM,KAAK,YAAY,IAAI;AAC3B,MAAI,EAAE,MAAM,IACV;EAGF,MAAM,OAAO,SAAS,IAAI,IAAI,QAAQ;AAEtC,MAAI,OAAO,QACT,WAAU;AAEZ,MAAI,OAAO,QACT,WAAU;;CAId,MAAM,YAAY;CAClB,MAAM,YAAY,YAAY,OAAO,oBAAoB,UAAU;CAGnE,MAAM,YAAY,YAAY;CAC9B,MAAM,YAAY,YAAY;AAG9B,QAAO;EACL,WAAW;EACX,WAAW;EACX;EACA;EACA,MAPW,KAAK,KAAK,YAAY;EAQlC"}

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,12 +11,12 @@
  */
 
 
-'use client';
-
-import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
 import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
+import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
 
 //#region src/deckgl/shapes/shared/utils/layer-config.ts
+let cachedAbbrev = null;
+let cachedProps;
 /**
 * Returns default props for EditableGeoJsonLayer configuration.
 *
@@ -26,7 +26,7 @@ import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../.
 * - Sublayer props for tooltips and handles
 *
 * @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.
-* @returns Default props to spread onto EditableGeoJsonLayer
+* @returns Default props to spread onto EditableGeoJsonLayer.
 *
 * @example
 * ```tsx
@@ -37,12 +37,15 @@ import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../.
 * ```
 */
 function getDefaultEditableLayerProps(unitAbbrev) {
-	return {
+	if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) return cachedProps;
+	cachedAbbrev = unitAbbrev;
+	cachedProps = {
 		getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,
 		getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,
 		modeConfig: { distanceUnits: unitAbbrev ? getDistanceUnitFromAbbreviation(unitAbbrev) ?? DEFAULT_DISTANCE_UNITS : DEFAULT_DISTANCE_UNITS },
 		_subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS
 	};
+	return cachedProps;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"layer-config.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  getDistanceUnitFromAbbreviation,\n} from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { DistanceUnit } from '@/shared/units';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport interface EditableLayerDefaultProps {\n  /** Edit handle point color */\n  getEditHandlePointColor: Color;\n  /** Edit handle point outline color */\n  getEditHandlePointOutlineColor: Color;\n  /** Mode configuration with distance units */\n  modeConfig: {\n    distanceUnits: DistanceUnit;\n  };\n  /** Sublayer props for tooltips and edit handles */\n  _subLayerProps: typeof EDITABLE_LAYER_SUBLAYER_PROPS;\n}\n\n/**\n * Returns default props for EditableGeoJsonLayer configuration.\n *\n * This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:\n * - Edit handle colors\n * - Mode configuration with distance units\n * - Sublayer props for tooltips and handles\n *\n * @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.\n * @returns Default props to spread onto EditableGeoJsonLayer\n *\n * @example\n * ```tsx\n * <editableGeoJsonLayer\n *   {...getDefaultEditableLayerProps(unit)}\n *   // other props\n * />\n * ```\n */\nexport function getDefaultEditableLayerProps(\n  unitAbbrev?: string,\n): EditableLayerDefaultProps {\n  return {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitAbbrev\n        ? (getDistanceUnitFromAbbreviation(unitAbbrev) ??\n          DEFAULT_DISTANCE_UNITS)\n        : DEFAULT_DISTANCE_UNITS,\n    },\n    // biome-ignore lint/style/useNamingConvention: deck.gl API convention\n    _subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,6BACd,YAC2B;AAC3B,QAAO;EACL,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,gCAAgC,WAAW,IAC5C,yBACA,wBACL;EAED,gBAAgB;EACjB"}
+{"version":3,"file":"layer-config.js","names":["cachedAbbrev: DistanceUnitAbbreviation | undefined | null","cachedProps: EditableLayerDefaultProps | undefined"],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  DEFAULT_DISTANCE_UNITS,\n  type DistanceUnit,\n  type DistanceUnitAbbreviation,\n  getDistanceUnitFromAbbreviation,\n} from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport type EditableLayerDefaultProps = {\n  /** Edit handle point color. */\n  getEditHandlePointColor: Color;\n  /** Edit handle point outline color. */\n  getEditHandlePointOutlineColor: Color;\n  /** Mode configuration with distance units. */\n  modeConfig: {\n    distanceUnits: DistanceUnit;\n  };\n  /** Sublayer props for tooltips and edit handles. */\n  _subLayerProps: typeof EDITABLE_LAYER_SUBLAYER_PROPS;\n};\n\nlet cachedAbbrev: DistanceUnitAbbreviation | undefined | null = null;\nlet cachedProps: EditableLayerDefaultProps | undefined;\n\n/**\n * Returns default props for EditableGeoJsonLayer configuration.\n *\n * This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:\n * - Edit handle colors\n * - Mode configuration with distance units\n * - Sublayer props for tooltips and handles\n *\n * @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.\n * @returns Default props to spread onto EditableGeoJsonLayer.\n *\n * @example\n * ```tsx\n * <editableGeoJsonLayer\n *   {...getDefaultEditableLayerProps(unit)}\n *   // other props\n * />\n * ```\n */\nexport function getDefaultEditableLayerProps(\n  unitAbbrev?: DistanceUnitAbbreviation,\n): EditableLayerDefaultProps {\n  if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) {\n    return cachedProps;\n  }\n\n  cachedAbbrev = unitAbbrev;\n  cachedProps = {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitAbbrev\n        ? (getDistanceUnitFromAbbreviation(unitAbbrev) ??\n          DEFAULT_DISTANCE_UNITS)\n        : DEFAULT_DISTANCE_UNITS,\n    },\n    // biome-ignore lint/style/useNamingConvention: deck.gl API convention\n    _subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS,\n  };\n\n  return cachedProps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyCA,IAAIA,eAA4D;AAChE,IAAIC;;;;;;;;;;;;;;;;;;;;AAqBJ,SAAgB,6BACd,YAC2B;AAC3B,KAAI,iBAAiB,QAAQ,iBAAiB,cAAc,YAC1D,QAAO;AAGT,gBAAe;AACf,eAAc;EACZ,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,gCAAgC,WAAW,IAC5C,yBACA,wBACL;EAED,gBAAgB;EACjB;AAED,QAAO"}

package/dist/deckgl/shapes/shared/utils/mode-utils.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,8 +11,6 @@
  */
 
 
-'use client';
-
 import { MapModeEvents } from "../../../../map-mode/events.js";
 import { MapCursorEvents } from "../../../../map-cursor/events.js";
 import { cursorStore } from "../../../../map-cursor/store.js";
@@ -24,15 +22,22 @@ import { Broadcast } from "@accelint/bus";
 */
 const mapModeBus = Broadcast.getInstance();
 const mapCursorBus = Broadcast.getInstance();
+/** The idle mode name used when releasing ownership. */
+const DEFAULT_MODE = "default";
 /**
 * Request a map mode change.
 *
 * Emits a mode change request through the event bus. The mode store will
 * handle authorization and apply the change if approved.
 *
-* @param mapId - The map instance ID
-* @param desiredMode - The mode to switch to
-* @param owner - The identifier of the component requesting the change
+* @param mapId - The map instance ID.
+* @param desiredMode - The mode to switch to.
+* @param owner - The identifier of the component requesting the change.
+*
+* @example
+* ```typescript
+* requestModeChange(mapId, 'draw', 'draw-shape-layer');
+* ```
 */
 function requestModeChange(mapId, desiredMode, owner) {
 	mapModeBus.emit(MapModeEvents.changeRequest, {
@@ -46,20 +51,30 @@ function requestModeChange(mapId, desiredMode, owner) {
 *
 * Convenience function to request a mode change back to 'default'.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing the mode
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing the mode.
+*
+* @example
+* ```typescript
+* releaseMode(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseMode(mapId, owner) {
-	requestModeChange(mapId, "default", owner);
+	requestModeChange(mapId, DEFAULT_MODE, owner);
 }
 /**
 * Request a cursor change.
 *
 * Emits a cursor change request through the event bus.
 *
-* @param mapId - The map instance ID
-* @param cursor - The CSS cursor type to set
-* @param owner - The identifier of the component requesting the change
+* @param mapId - The map instance ID.
+* @param cursor - The CSS cursor type to set.
+* @param owner - The identifier of the component requesting the change.
+*
+* @example
+* ```typescript
+* requestCursorChange(mapId, 'crosshair', 'draw-shape-layer');
+* ```
 */
 function requestCursorChange(mapId, cursor, owner) {
 	mapCursorBus.emit(MapCursorEvents.changeRequest, {
@@ -73,8 +88,13 @@ function requestCursorChange(mapId, cursor, owner) {
 *
 * Uses the cursor store's clear function to release the cursor.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing the cursor
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing the cursor.
+*
+* @example
+* ```typescript
+* releaseCursor(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseCursor(mapId, owner) {
 	cursorStore.actions(mapId).clearCursor(owner);
@@ -86,10 +106,15 @@ function releaseCursor(mapId, owner) {
 * requires authorization. When the mode change is approved, the cursor
 * will be automatically applied via getEffectiveCursor.
 *
-* @param mapId - The map instance ID
-* @param desiredMode - The mode to switch to
-* @param cursor - The CSS cursor type to set
-* @param owner - The identifier of the component requesting the changes
+* @param mapId - The map instance ID.
+* @param desiredMode - The mode to switch to.
+* @param cursor - The CSS cursor type to set.
+* @param owner - The identifier of the component requesting the changes.
+*
+* @example
+* ```typescript
+* requestModeAndCursor(mapId, 'draw', 'crosshair', 'draw-shape-layer');
+* ```
 */
 function requestModeAndCursor(mapId, desiredMode, cursor, owner) {
 	requestModeChange(mapId, desiredMode, owner);
@@ -100,8 +125,13 @@ function requestModeAndCursor(mapId, desiredMode, cursor, owner) {
 *
 * Common pattern when ending an operation.
 *
-* @param mapId - The map instance ID
-* @param owner - The identifier of the component releasing mode and cursor
+* @param mapId - The map instance ID.
+* @param owner - The identifier of the component releasing mode and cursor.
+*
+* @example
+* ```typescript
+* releaseModeAndCursor(mapId, 'draw-shape-layer');
+* ```
 */
 function releaseModeAndCursor(mapId, owner) {
 	releaseMode(mapId, owner);

package/dist/deckgl/shapes/shared/utils/mode-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"mode-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/mode-utils.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { Broadcast } from '@accelint/bus';\nimport { MapCursorEvents } from '@/map-cursor/events';\nimport { cursorStore } from '@/map-cursor/store';\nimport { MapModeEvents } from '@/map-mode/events';\nimport type { UniqueId } from '@accelint/core';\nimport type { CSSCursorType, MapCursorEventType } from '@/map-cursor/types';\nimport type { MapModeEventType } from '@/map-mode/types';\n\n/**\n * Typed event bus instances for mode and cursor communication.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\nconst mapCursorBus = Broadcast.getInstance<MapCursorEventType>();\n\n/**\n * Request a map mode change.\n *\n * Emits a mode change request through the event bus. The mode store will\n * handle authorization and apply the change if approved.\n *\n * @param mapId - The map instance ID\n * @param desiredMode - The mode to switch to\n * @param owner - The identifier of the component requesting the change\n */\nexport function requestModeChange(\n  mapId: UniqueId,\n  desiredMode: string,\n  owner: string,\n): void {\n  mapModeBus.emit(MapModeEvents.changeRequest, {\n    desiredMode,\n    owner,\n    id: mapId,\n  });\n}\n\n/**\n * Release mode back to default.\n *\n * Convenience function to request a mode change back to 'default'.\n *\n * @param mapId - The map instance ID\n * @param owner - The identifier of the component releasing the mode\n */\nexport function releaseMode(mapId: UniqueId, owner: string): void {\n  requestModeChange(mapId, 'default', owner);\n}\n\n/**\n * Request a cursor change.\n *\n * Emits a cursor change request through the event bus.\n *\n * @param mapId - The map instance ID\n * @param cursor - The CSS cursor type to set\n * @param owner - The identifier of the component requesting the change\n */\nexport function requestCursorChange(\n  mapId: UniqueId,\n  cursor: CSSCursorType,\n  owner: string,\n): void {\n  mapCursorBus.emit(MapCursorEvents.changeRequest, {\n    cursor,\n    owner,\n    id: mapId,\n  });\n}\n\n/**\n * Release cursor back to default.\n *\n * Uses the cursor store's clear function to release the cursor.\n *\n * @param mapId - The map instance ID\n * @param owner - The identifier of the component releasing the cursor\n */\nexport function releaseCursor(mapId: UniqueId, owner: string): void {\n  cursorStore.actions(mapId).clearCursor(owner);\n}\n\n/**\n * Request both mode and cursor changes together.\n *\n * The cursor is stored for registered mode owners even if the mode change\n * requires authorization. When the mode change is approved, the cursor\n * will be automatically applied via getEffectiveCursor.\n *\n * @param mapId - The map instance ID\n * @param desiredMode - The mode to switch to\n * @param cursor - The CSS cursor type to set\n * @param owner - The identifier of the component requesting the changes\n */\nexport function requestModeAndCursor(\n  mapId: UniqueId,\n  desiredMode: string,\n  cursor: CSSCursorType,\n  owner: string,\n): void {\n  requestModeChange(mapId, desiredMode, owner);\n  requestCursorChange(mapId, cursor, owner);\n}\n\n/**\n * Release both mode and cursor back to defaults.\n *\n * Common pattern when ending an operation.\n *\n * @param mapId - The map instance ID\n * @param owner - The identifier of the component releasing mode and cursor\n */\nexport function releaseModeAndCursor(mapId: UniqueId, owner: string): void {\n  releaseMode(mapId, owner);\n  releaseCursor(mapId, owner);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,aAAa,UAAU,aAA+B;AAC5D,MAAM,eAAe,UAAU,aAAiC;;;;;;;;;;;AAYhE,SAAgB,kBACd,OACA,aACA,OACM;AACN,YAAW,KAAK,cAAc,eAAe;EAC3C;EACA;EACA,IAAI;EACL,CAAC;;;;;;;;;;AAWJ,SAAgB,YAAY,OAAiB,OAAqB;AAChE,mBAAkB,OAAO,WAAW,MAAM;;;;;;;;;;;AAY5C,SAAgB,oBACd,OACA,QACA,OACM;AACN,cAAa,KAAK,gBAAgB,eAAe;EAC/C;EACA;EACA,IAAI;EACL,CAAC;;;;;;;;;;AAWJ,SAAgB,cAAc,OAAiB,OAAqB;AAClE,aAAY,QAAQ,MAAM,CAAC,YAAY,MAAM;;;;;;;;;;;;;;AAe/C,SAAgB,qBACd,OACA,aACA,QACA,OACM;AACN,mBAAkB,OAAO,aAAa,MAAM;AAC5C,qBAAoB,OAAO,QAAQ,MAAM;;;;;;;;;;AAW3C,SAAgB,qBAAqB,OAAiB,OAAqB;AACzE,aAAY,OAAO,MAAM;AACzB,eAAc,OAAO,MAAM"}
+{"version":3,"file":"mode-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/mode-utils.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 { Broadcast } from '@accelint/bus';\nimport { MapCursorEvents } from '@/map-cursor/events';\nimport { cursorStore } from '@/map-cursor/store';\nimport { MapModeEvents } from '@/map-mode/events';\nimport type { UniqueId } from '@accelint/core';\nimport type { CSSCursorType, MapCursorEventType } from '@/map-cursor/types';\nimport type { MapModeEventType } from '@/map-mode/types';\n\n/**\n * Typed event bus instances for mode and cursor communication.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\nconst mapCursorBus = Broadcast.getInstance<MapCursorEventType>();\n\n/** The idle mode name used when releasing ownership. */\nconst DEFAULT_MODE = 'default';\n\n/**\n * Request a map mode change.\n *\n * Emits a mode change request through the event bus. The mode store will\n * handle authorization and apply the change if approved.\n *\n * @param mapId - The map instance ID.\n * @param desiredMode - The mode to switch to.\n * @param owner - The identifier of the component requesting the change.\n *\n * @example\n * ```typescript\n * requestModeChange(mapId, 'draw', 'draw-shape-layer');\n * ```\n */\nexport function requestModeChange(\n  mapId: UniqueId,\n  desiredMode: string,\n  owner: string,\n): void {\n  mapModeBus.emit(MapModeEvents.changeRequest, {\n    desiredMode,\n    owner,\n    id: mapId,\n  });\n}\n\n/**\n * Release mode back to default.\n *\n * Convenience function to request a mode change back to 'default'.\n *\n * @param mapId - The map instance ID.\n * @param owner - The identifier of the component releasing the mode.\n *\n * @example\n * ```typescript\n * releaseMode(mapId, 'draw-shape-layer');\n * ```\n */\nexport function releaseMode(mapId: UniqueId, owner: string): void {\n  requestModeChange(mapId, DEFAULT_MODE, owner);\n}\n\n/**\n * Request a cursor change.\n *\n * Emits a cursor change request through the event bus.\n *\n * @param mapId - The map instance ID.\n * @param cursor - The CSS cursor type to set.\n * @param owner - The identifier of the component requesting the change.\n *\n * @example\n * ```typescript\n * requestCursorChange(mapId, 'crosshair', 'draw-shape-layer');\n * ```\n */\nexport function requestCursorChange(\n  mapId: UniqueId,\n  cursor: CSSCursorType,\n  owner: string,\n): void {\n  mapCursorBus.emit(MapCursorEvents.changeRequest, {\n    cursor,\n    owner,\n    id: mapId,\n  });\n}\n\n/**\n * Release cursor back to default.\n *\n * Uses the cursor store's clear function to release the cursor.\n *\n * @param mapId - The map instance ID.\n * @param owner - The identifier of the component releasing the cursor.\n *\n * @example\n * ```typescript\n * releaseCursor(mapId, 'draw-shape-layer');\n * ```\n */\nexport function releaseCursor(mapId: UniqueId, owner: string): void {\n  cursorStore.actions(mapId).clearCursor(owner);\n}\n\n/**\n * Request both mode and cursor changes together.\n *\n * The cursor is stored for registered mode owners even if the mode change\n * requires authorization. When the mode change is approved, the cursor\n * will be automatically applied via getEffectiveCursor.\n *\n * @param mapId - The map instance ID.\n * @param desiredMode - The mode to switch to.\n * @param cursor - The CSS cursor type to set.\n * @param owner - The identifier of the component requesting the changes.\n *\n * @example\n * ```typescript\n * requestModeAndCursor(mapId, 'draw', 'crosshair', 'draw-shape-layer');\n * ```\n */\nexport function requestModeAndCursor(\n  mapId: UniqueId,\n  desiredMode: string,\n  cursor: CSSCursorType,\n  owner: string,\n): void {\n  requestModeChange(mapId, desiredMode, owner);\n  requestCursorChange(mapId, cursor, owner);\n}\n\n/**\n * Release both mode and cursor back to defaults.\n *\n * Common pattern when ending an operation.\n *\n * @param mapId - The map instance ID.\n * @param owner - The identifier of the component releasing mode and cursor.\n *\n * @example\n * ```typescript\n * releaseModeAndCursor(mapId, 'draw-shape-layer');\n * ```\n */\nexport function releaseModeAndCursor(mapId: UniqueId, owner: string): void {\n  releaseMode(mapId, owner);\n  releaseCursor(mapId, owner);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,aAAa,UAAU,aAA+B;AAC5D,MAAM,eAAe,UAAU,aAAiC;;AAGhE,MAAM,eAAe;;;;;;;;;;;;;;;;AAiBrB,SAAgB,kBACd,OACA,aACA,OACM;AACN,YAAW,KAAK,cAAc,eAAe;EAC3C;EACA;EACA,IAAI;EACL,CAAC;;;;;;;;;;;;;;;AAgBJ,SAAgB,YAAY,OAAiB,OAAqB;AAChE,mBAAkB,OAAO,cAAc,MAAM;;;;;;;;;;;;;;;;AAiB/C,SAAgB,oBACd,OACA,QACA,OACM;AACN,cAAa,KAAK,gBAAgB,eAAe;EAC/C;EACA;EACA,IAAI;EACL,CAAC;;;;;;;;;;;;;;;AAgBJ,SAAgB,cAAc,OAAiB,OAAqB;AAClE,aAAY,QAAQ,MAAM,CAAC,YAAY,MAAM;;;;;;;;;;;;;;;;;;;AAoB/C,SAAgB,qBACd,OACA,aACA,QACA,OACM;AACN,mBAAkB,OAAO,aAAa,MAAM;AAC5C,qBAAoB,OAAO,QAAQ,MAAM;;;;;;;;;;;;;;;AAgB3C,SAAgB,qBAAqB,OAAiB,OAAqB;AACzE,aAAY,OAAO,MAAM;AACzB,eAAc,OAAO,MAAM"}

package/dist/deckgl/shapes/shared/utils/pick-filtering.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,8 +11,6 @@
  */
 
 
-'use client';
-
 //#region src/deckgl/shapes/shared/utils/pick-filtering.ts
 /**
 * Filters picks to only include valid geometry elements.
@@ -21,11 +19,12 @@
 * when modes try to access pick.object.geometry.type. Only picks that are
 * either guide features (pick.isGuide) or have valid geometry are included.
 *
-* Uses a single-pass algorithm for efficiency - filters and tracks changes
-* in one loop iteration.
+* On the common path where all picks are valid, returns the original array
+* with zero allocations.
 *
-* @param picks - The picks array from a pointer event
-* @returns Object containing filtered picks and whether filtering occurred
+* @template T - The pick type, constrained to PickLike.
+* @param picks - The picks array from a pointer event.
+* @returns Object containing filtered picks and whether filtering occurred.
 *
 * @example
 * ```typescript
@@ -39,16 +38,24 @@
 * ```
 */
 function filterGeometryAwarePicks(picks) {
-	const filteredPicks = [];
-	let didFilter = false;
-	for (const pick of picks) {
-		const pickObj = pick;
-		if (pickObj.isGuide || pickObj.object?.geometry?.type !== void 0) filteredPicks.push(pick);
-		else didFilter = true;
+	const len = picks.length;
+	for (let i = 0; i < len; i++) {
+		const pick = picks[i];
+		if (!pick?.isGuide && pick?.object?.geometry?.type === void 0) {
+			const filteredPicks = picks.slice(0, i);
+			for (let j = i + 1; j < len; j++) {
+				const p = picks[j];
+				if (p?.isGuide || p?.object?.geometry?.type !== void 0) filteredPicks.push(p);
+			}
+			return {
+				filteredPicks,
+				didFilter: true
+			};
+		}
 	}
 	return {
-		filteredPicks,
-		didFilter
+		filteredPicks: picks,
+		didFilter: false
 	};
 }
 

package/dist/deckgl/shapes/shared/utils/pick-filtering.js.map

@@ -1 +1 @@
-{"version":3,"file":"pick-filtering.js","names":["filteredPicks: T[]"],"sources":["../../../../../src/deckgl/shapes/shared/utils/pick-filtering.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\n/**\n * Result of filtering picks for geometry-aware processing.\n * Generic to support both deck.gl/core PickingInfo and editable-layers Pick types.\n */\nexport interface FilteredPicksResult<T> {\n  /** The filtered picks array (only valid geometry picks) */\n  filteredPicks: T[];\n  /** Whether any picks were removed during filtering */\n  didFilter: boolean;\n}\n\n/**\n * Filters picks to only include valid geometry elements.\n *\n * This prevents TypeError from sublayer elements that don't have geometry\n * when modes try to access pick.object.geometry.type. Only picks that are\n * either guide features (pick.isGuide) or have valid geometry are included.\n *\n * Uses a single-pass algorithm for efficiency - filters and tracks changes\n * in one loop iteration.\n *\n * @param picks - The picks array from a pointer event\n * @returns Object containing filtered picks and whether filtering occurred\n *\n * @example\n * ```typescript\n * const picks = props.lastPointerMoveEvent?.picks;\n * if (picks && picks.length > 0) {\n *   const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);\n *   if (didFilter) {\n *     // Use filteredPicks in modified props\n *   }\n * }\n * ```\n */\nexport function filterGeometryAwarePicks<T>(\n  picks: T[],\n): FilteredPicksResult<T> {\n  const filteredPicks: T[] = [];\n  let didFilter = false;\n\n  for (const pick of picks) {\n    // Keep picks that are guides or have valid geometry\n    // biome-ignore lint/suspicious/noExplicitAny: deck.gl picks have dynamic object structure\n    const pickObj = pick as any;\n    if (pickObj.isGuide || pickObj.object?.geometry?.type !== undefined) {\n      filteredPicks.push(pick);\n    } else {\n      didFilter = true;\n    }\n  }\n\n  return { filteredPicks, didFilter };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,yBACd,OACwB;CACxB,MAAMA,gBAAqB,EAAE;CAC7B,IAAI,YAAY;AAEhB,MAAK,MAAM,QAAQ,OAAO;EAGxB,MAAM,UAAU;AAChB,MAAI,QAAQ,WAAW,QAAQ,QAAQ,UAAU,SAAS,OACxD,eAAc,KAAK,KAAK;MAExB,aAAY;;AAIhB,QAAO;EAAE;EAAe;EAAW"}
+{"version":3,"file":"pick-filtering.js","names":["filteredPicks: T[]"],"sources":["../../../../../src/deckgl/shapes/shared/utils/pick-filtering.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 * Minimal shape required for pick filtering.\n * Satisfied by both deck.gl/core PickingInfo and editable-layers Pick types.\n */\ntype PickLike = {\n  isGuide?: boolean;\n  object?: {\n    geometry?: {\n      type?: string;\n    };\n  };\n};\n\n/**\n * Result of filtering picks for geometry-aware processing.\n * Generic to support both deck.gl/core PickingInfo and editable-layers Pick types.\n *\n * @template T - The pick type, must satisfy PickLike shape.\n */\nexport type FilteredPicksResult<T> = {\n  /** The filtered picks array (only valid geometry picks). */\n  filteredPicks: T[];\n  /** Whether any picks were removed during filtering. */\n  didFilter: boolean;\n};\n\n/**\n * Filters picks to only include valid geometry elements.\n *\n * This prevents TypeError from sublayer elements that don't have geometry\n * when modes try to access pick.object.geometry.type. Only picks that are\n * either guide features (pick.isGuide) or have valid geometry are included.\n *\n * On the common path where all picks are valid, returns the original array\n * with zero allocations.\n *\n * @template T - The pick type, constrained to PickLike.\n * @param picks - The picks array from a pointer event.\n * @returns Object containing filtered picks and whether filtering occurred.\n *\n * @example\n * ```typescript\n * const picks = props.lastPointerMoveEvent?.picks;\n * if (picks && picks.length > 0) {\n *   const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);\n *   if (didFilter) {\n *     // Use filteredPicks in modified props\n *   }\n * }\n * ```\n */\nexport function filterGeometryAwarePicks<T extends PickLike>(\n  picks: T[],\n): FilteredPicksResult<T> {\n  const len = picks.length;\n\n  for (let i = 0; i < len; i++) {\n    const pick = picks[i];\n    if (!pick?.isGuide && pick?.object?.geometry?.type === undefined) {\n      // Found a pick that needs filtering — build filtered array from here\n      const filteredPicks: T[] = picks.slice(0, i);\n      for (let j = i + 1; j < len; j++) {\n        const p = picks[j];\n        if (p?.isGuide || p?.object?.geometry?.type !== undefined) {\n          filteredPicks.push(p);\n        }\n      }\n      return { filteredPicks, didFilter: true };\n    }\n  }\n\n  return { filteredPicks: picks, didFilter: false };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,yBACd,OACwB;CACxB,MAAM,MAAM,MAAM;AAElB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;EAC5B,MAAM,OAAO,MAAM;AACnB,MAAI,CAAC,MAAM,WAAW,MAAM,QAAQ,UAAU,SAAS,QAAW;GAEhE,MAAMA,gBAAqB,MAAM,MAAM,GAAG,EAAE;AAC5C,QAAK,IAAI,IAAI,IAAI,GAAG,IAAI,KAAK,KAAK;IAChC,MAAM,IAAI,MAAM;AAChB,QAAI,GAAG,WAAW,GAAG,QAAQ,UAAU,SAAS,OAC9C,eAAc,KAAK,EAAE;;AAGzB,UAAO;IAAE;IAAe,WAAW;IAAM;;;AAI7C,QAAO;EAAE,eAAe;EAAO,WAAW;EAAO"}

package/dist/deckgl/shapes/shared/utils/style-utils.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -18,19 +18,29 @@ import { Color } from "@deck.gl/core";
  * Normalize a Color to a 4-element RGBA array.
  * Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays.
  *
- * @param color - The color to normalize
- * @returns 4-element RGBA array [r, g, b, a]
+ * @param color - The color to normalize.
+ * @returns 4-element RGBA array [r, g, b, a].
+ * @example
+ * ```typescript
+ * normalizeColor([255, 128, 0]);        // → [255, 128, 0, 255]
+ * normalizeColor([255, 128, 0, 200]);   // → [255, 128, 0, 200]
+ * ```
  */
 declare function normalizeColor(color: Color): [number, number, number, number];
 /**
  * Get fill color for a feature.
  * Colors are passed through as-is unless applyBaseOpacity is true.
  *
- * @param feature - The styled feature
- * @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2)
- * @returns RGBA color array
+ * @param feature - The styled feature.
+ * @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2).
+ * @returns RGBA color array.
+ * @example
+ * ```typescript
+ * getFillColor(feature);        // → [255, 255, 255, 255]  (full opacity)
+ * getFillColor(feature, true);  // → [255, 255, 255, 51]   (255 × 0.2)
+ * ```
  */
-declare function getFillColor(feature: StyledFeature, applyBaseOpacity?: boolean): Color;
+declare function getFillColor(feature: StyledFeature, applyBaseOpacity?: boolean): [number, number, number, number];
 /**
  * Get border/outline color for a feature.
  * Outlines are always rendered at their literal alpha value.
@@ -38,25 +48,39 @@ declare function getFillColor(feature: StyledFeature, applyBaseOpacity?: boolean
  * Named to match deck.gl's `getLineColor` accessor convention.
  * Reads from `lineColor` in the feature's style properties.
  *
- * @param feature - The styled feature
- * @returns RGBA color array
+ * @param feature - The styled feature.
+ * @returns RGBA color array.
+ * @example
+ * ```typescript
+ * getLineColor(feature); // → [136, 138, 143, 255]  (default line color)
+ * ```
  */
-declare function getLineColor(feature: StyledFeature): Color;
+declare function getLineColor(feature: StyledFeature): [number, number, number, number];
 /**
  * Get border/outline width for a feature.
  *
  * Named to match deck.gl's `getLineWidth` accessor convention.
  * Reads from `lineWidth` in the feature's style properties.
  *
- * @param feature - The styled feature
- * @returns Border/outline width in pixels
+ * @param feature - The styled feature.
+ * @returns Border/outline width in pixels.
+ * @example
+ * ```typescript
+ * getLineWidth(feature); // → 2  (default width)
+ * ```
  */
 declare function getLineWidth(feature: StyledFeature): number;
 /**
  * Get dash array for border/outline pattern.
  *
- * @param feature - The styled feature
- * @returns Dash array [dash, gap] or null for solid outlines
+ * @param feature - The styled feature.
+ * @returns Dash array [dash, gap] or null for solid outlines.
+ * @example
+ * ```typescript
+ * getDashArray(solidFeature);   // → null
+ * getDashArray(dashedFeature);  // → [8, 4]
+ * getDashArray(dottedFeature);  // → [2, 4]
+ * ```
  */
 declare function getDashArray(feature: StyledFeature): [number, number] | null;
 //#endregion