@accelint/map-toolkit 1.4.0 → 2.0.0

package/dist/deckgl/shapes/display-shape-layer/utils/elevation.js

@@ -0,0 +1,407 @@
+/*
+ * 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
+ *
+ * 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.
+ */
+
+
+'use client';
+
+import { isGeometryCollectionType, isLineGeometry, isLineStringType, isMultiLineStringType, isMultiPointType, isMultiPolygonType, isPointType, isPolygonGeometry, isPolygonType } from "../../shared/types.js";
+import { getLineColor } from "../../shared/utils/style-utils.js";
+import { BRIGHTNESS_FACTOR } from "../constants.js";
+import { brightenColor } from "./display-style.js";
+
+//#region src/deckgl/shapes/display-shape-layer/utils/elevation.ts
+/**
+* Extract elevation from 3D coordinates.
+* Drills into nested coordinate arrays to find the z-value.
+*
+* @param coordinates - GeoJSON coordinates (single, array, or nested)
+* @returns The z-coordinate if present, otherwise 0
+*
+* @example
+* ```typescript
+* getElevationFromCoordinates([10, 20, 5000]); // 5000
+* getElevationFromCoordinates([[10, 20, 5000], [11, 21, 6000]]); // 5000
+* getElevationFromCoordinates([10, 20]); // 0
+* ```
+*/
+const MAX_COORDINATE_DEPTH = 5;
+function getElevationFromCoordinates(coordinates) {
+	let current = coordinates;
+	let depth = 0;
+	while (Array.isArray(current) && depth < MAX_COORDINATE_DEPTH) {
+		if (!Array.isArray(current[0])) return current[2] ?? 0;
+		current = current[0];
+		depth++;
+	}
+	return 0;
+}
+/**
+* Get elevation from a feature's geometry.
+* Extracts z-coordinate, returning 0 for missing geometry or GeometryCollection.
+*
+* @param feature - The GeoJSON feature
+* @returns The elevation value, or 0
+*
+* @example
+* ```typescript
+* const elevation = getFeatureElevation(feature);
+* if (elevation > 0) {
+*   // Feature has 3D elevation
+* }
+* ```
+*/
+function getFeatureElevation(feature) {
+	const maxElevation = feature.properties?.maxElevation;
+	if (maxElevation !== void 0) return maxElevation;
+	const { geometry } = feature;
+	if (!geometry) return 0;
+	if (isGeometryCollectionType(geometry)) return 0;
+	return getElevationFromCoordinates(geometry.coordinates);
+}
+/**
+* Extract [lon, lat] from a coordinate array if valid.
+*/
+function extractLonLat(coords) {
+	if (!coords || coords.length < 2) return;
+	const [lon, lat] = coords;
+	return lon !== void 0 && lat !== void 0 ? [lon, lat] : void 0;
+}
+/**
+* Extract a representative coordinate from a feature for elevation indicators.
+*
+* @param geometry - The feature geometry
+* @returns [lon, lat] or undefined if coordinates cannot be extracted
+*/
+function getRepresentativeCoordinate(geometry) {
+	if (isPointType(geometry)) return extractLonLat(geometry.coordinates);
+	if (isLineStringType(geometry) || isMultiPointType(geometry)) return extractLonLat(geometry.coordinates[0]);
+	if (isMultiLineStringType(geometry)) return extractLonLat(geometry.coordinates[0]?.[0]);
+}
+/** Create a vertical line segment from ground to an elevated position. */
+function createVerticalSegment(lon, lat, elevation, color) {
+	return {
+		source: [
+			lon,
+			lat,
+			0
+		],
+		target: [
+			lon,
+			lat,
+			elevation
+		],
+		color
+	};
+}
+/** Process a coordinates array and create vertical segments for each elevated point. */
+function processCoordinates(coordinates, color) {
+	const segments = [];
+	for (const coord of coordinates) {
+		const [lon, lat, elevation] = coord;
+		if (lon !== void 0 && lat !== void 0 && elevation !== void 0 && elevation > 0) segments.push(createVerticalSegment(lon, lat, elevation, color));
+	}
+	return segments;
+}
+/**
+* Create elevation indicator line segments for a geometry.
+*
+* @param geometry - The feature geometry
+* @param color - RGBA color for the line segments
+* @returns Array of line segments from ground to elevated positions
+*
+* @example
+* ```typescript
+* const segments = createElevationLineSegments(
+*   feature.geometry,
+*   [255, 255, 255, 255],
+* );
+* // Each segment has { source: [lon, lat, 0], target: [lon, lat, elevation], color }
+* ```
+*/
+function createElevationLineSegments(geometry, color) {
+	if (isGeometryCollectionType(geometry)) return [];
+	if (isLineStringType(geometry)) return processCoordinates(geometry.coordinates, color);
+	if (isMultiLineStringType(geometry)) {
+		const allSegments = [];
+		const lines = geometry.coordinates;
+		for (const line of lines) for (const segment of processCoordinates(line, color)) allSegments.push(segment);
+		return allSegments;
+	}
+	const coords = getRepresentativeCoordinate(geometry);
+	if (coords) {
+		const [lon, lat] = coords;
+		const elevation = getElevationFromCoordinates(geometry.coordinates);
+		if (elevation > 0) return [createVerticalSegment(lon, lat, elevation, color)];
+	}
+	return [];
+}
+/**
+* Single-pass classification of features by geometry type and elevation.
+* Avoids multiple .filter() passes per render frame.
+*
+* @param features - The features to classify
+* @param getElevation - Elevation accessor function
+* @returns Classified features: lines, polygons, nonPolygons
+*
+* @example
+* ```typescript
+* const { lines, polygons, nonPolygons } = classifyElevatedFeatures(
+*   features,
+*   getFeatureElevation,
+* );
+* ```
+*/
+function classifyElevatedFeatures(features, getElevation) {
+	const lines = [];
+	const polygons = [];
+	const nonPolygons = [];
+	for (const f of features) {
+		if (getElevation(f) <= 0) continue;
+		const { geometry } = f;
+		if (isPolygonGeometry(geometry)) polygons.push(f);
+		else {
+			nonPolygons.push(f);
+			if (isLineGeometry(geometry)) lines.push(f);
+		}
+	}
+	return {
+		lines,
+		polygons,
+		nonPolygons
+	};
+}
+/**
+* Create curtain polygon features from a single LineString's coordinate array.
+* Each pair of consecutive coordinates becomes a vertical rectangular polygon.
+*
+* @param coordinates - Array of [lon, lat, elevation] coordinates
+* @param fillColor - RGBA fill color for the curtain
+* @param lineColor - RGBA line color for the curtain
+* @param shapeId - Optional shape ID for picking correlation
+* @returns Array of curtain polygon features
+*
+* @example
+* ```typescript
+* const curtains = createCurtainPolygonsFromLine(
+*   [[10, 20, 5000], [11, 21, 6000]],
+*   [98, 166, 255, 51],
+*   [98, 166, 255, 255],
+*   'shape-1',
+* );
+* ```
+*/
+function createCurtainPolygonsFromLine(coordinates, fillColor, lineColor, shapeId) {
+	const polygons = [];
+	for (let i = 0; i < coordinates.length - 1; i++) {
+		const coord1 = coordinates[i];
+		const coord2 = coordinates[i + 1];
+		if (coord1 === void 0 || coord2 === void 0) continue;
+		const [lon1, lat1, elev1] = coord1;
+		const [lon2, lat2, elev2] = coord2;
+		if (lon1 === void 0 || lat1 === void 0 || elev1 === void 0 || lon2 === void 0 || lat2 === void 0 || elev2 === void 0) continue;
+		if (elev1 === 0 && elev2 === 0) continue;
+		const ring = [
+			[
+				lon1,
+				lat1,
+				0
+			],
+			[
+				lon2,
+				lat2,
+				0
+			],
+			[
+				lon2,
+				lat2,
+				elev2
+			],
+			[
+				lon1,
+				lat1,
+				elev1
+			],
+			[
+				lon1,
+				lat1,
+				0
+			]
+		];
+		polygons.push({
+			type: "Feature",
+			geometry: {
+				type: "Polygon",
+				coordinates: [ring]
+			},
+			properties: {
+				fillColor,
+				lineColor,
+				shapeId
+			}
+		});
+	}
+	return polygons;
+}
+/**
+* Create vertical curtain polygon features from elevated LineString features.
+* Converts elevated LineStrings into vertical rectangular polygons from ground to elevation.
+*
+* @param elevatedLines - Features with LineString/MultiLineString geometry and elevation
+* @param applyBaseOpacity - Whether to apply reduced opacity to fills
+* @returns Array of curtain polygon features
+*
+* @example
+* ```typescript
+* const curtainFeatures = createCurtainPolygonFeatures(elevatedLines, true);
+* // Returns vertical polygon features for each consecutive coordinate pair
+* ```
+*/
+function createCurtainPolygonFeatures(elevatedLines, applyBaseOpacity) {
+	const curtainFeatures = [];
+	for (const feature of elevatedLines) {
+		const { geometry } = feature;
+		const lineColorRGBA = getLineColor(feature);
+		const shapeId = feature.properties?.shapeId;
+		const fillColor = applyBaseOpacity ? [
+			lineColorRGBA[0],
+			lineColorRGBA[1],
+			lineColorRGBA[2],
+			Math.round(lineColorRGBA[3] * .2)
+		] : lineColorRGBA;
+		let coordArrays;
+		if (isLineStringType(geometry)) coordArrays = [geometry.coordinates];
+		else coordArrays = geometry.coordinates;
+		for (const coords of coordArrays) for (const polygon of createCurtainPolygonsFromLine(coords, fillColor, lineColorRGBA, shapeId)) curtainFeatures.push(polygon);
+	}
+	return curtainFeatures;
+}
+/**
+* Returns a copy of a feature with Z coordinates stripped from its geometry.
+*
+* Use this to project a feature back to the ground plane. Common use cases:
+* - Highlight outlines that should render at ground level
+* - Extruded polygons where elevation must come solely from `getElevation`,
+*   not from coordinate Z (deck.gl's SolidPolygonLayer adds both together)
+*
+* @param feature - The feature to flatten
+* @returns A new feature with 2D coordinates, or the original if geometry
+*   type is not handled (Point, MultiPoint, GeometryCollection)
+*
+* @example
+* ```typescript
+* // Elevated LineString [lon, lat, 20000] → [lon, lat]
+* const flat = flattenFeatureTo2D(elevatedLineStringFeature);
+* // flat.geometry.coordinates: [[lon, lat], [lon, lat], ...]
+*
+* // Elevated Polygon [lon, lat, 43500] → [lon, lat]
+* const flat = flattenFeatureTo2D(elevatedPolygonFeature);
+* // flat.geometry.coordinates: [[[lon, lat], [lon, lat], ...]]
+* ```
+*/
+const stripZ = ([lon, lat]) => [lon, lat];
+function flattenFeatureTo2D(feature) {
+	const { geometry } = feature;
+	if (isLineStringType(geometry)) return {
+		...feature,
+		geometry: {
+			...geometry,
+			coordinates: geometry.coordinates.map(stripZ)
+		}
+	};
+	if (isMultiLineStringType(geometry) || isPolygonType(geometry)) return {
+		...feature,
+		geometry: {
+			...geometry,
+			coordinates: geometry.coordinates.map((ring) => ring.map(stripZ))
+		}
+	};
+	if (isMultiPolygonType(geometry)) return {
+		...feature,
+		geometry: {
+			...geometry,
+			coordinates: geometry.coordinates.map((polygon) => polygon.map((ring) => ring.map(stripZ)))
+		}
+	};
+	return feature;
+}
+/**
+* Partition curtain features by interaction state (main, hovered, selected).
+*
+* @param allCurtainFeatures - All curtain features to partition
+* @param hoveredShapeId - Currently hovered shape ID
+* @param selectedShapeId - Currently selected shape ID
+* @returns Partitioned curtain features by state
+*
+* @example
+* ```typescript
+* const { main, hovered, selected } = partitionCurtains(
+*   curtainFeatures,
+*   hoveredShapeId,
+*   selectedShapeId,
+* );
+* ```
+*/
+function partitionCurtains(allCurtainFeatures, hoveredShapeId, selectedShapeId) {
+	const main = [];
+	const hovered = [];
+	const selected = [];
+	for (const f of allCurtainFeatures) {
+		const id = f.properties.shapeId;
+		if (id === selectedShapeId) selected.push(f);
+		else if (id === hoveredShapeId) hovered.push(f);
+		else main.push(f);
+	}
+	return {
+		main,
+		hovered,
+		selected
+	};
+}
+/**
+* Build elevation indicator line segments for a set of elevated non-polygon features,
+* applying interaction-state colors (brightened on hover/select).
+*
+* @param elevatedNonPolygons - Features to generate segments for
+* @param features - Full feature array for hover-index lookup
+* @param selectedShapeId - Currently selected shape ID
+* @param hoverIndex - Currently hovered feature index
+* @returns Array of colored line segments from ground to elevation
+* @example
+* ```typescript
+* const lineData = buildIndicatorLineData(
+*   elevatedNonPolygons,
+*   allFeatures,
+*   selectedShapeId,
+*   hoverIndex,
+* );
+* // Each segment: { source: [lon, lat, 0], target: [lon, lat, elevation], color: [r, g, b, a] }
+* ```
+*/
+function buildIndicatorLineData(elevatedNonPolygons, features, selectedShapeId, hoverIndex) {
+	const lineData = [];
+	const hoveredFeatureShapeId = hoverIndex !== void 0 ? features[hoverIndex]?.properties?.shapeId : void 0;
+	for (const feature of elevatedNonPolygons) {
+		const { geometry } = feature;
+		const shapeId = feature.properties?.shapeId;
+		const isSelected = shapeId != null && shapeId === selectedShapeId;
+		const isHovered = shapeId != null && shapeId === hoveredFeatureShapeId;
+		const base = getLineColor(feature);
+		const factor = isSelected && isHovered ? BRIGHTNESS_FACTOR.HOVER_AND_SELECT : BRIGHTNESS_FACTOR.HOVER_OR_SELECT;
+		const color = isSelected || isHovered ? brightenColor(base, factor) : base;
+		for (const segment of createElevationLineSegments(geometry, color)) lineData.push(segment);
+	}
+	return lineData;
+}
+
+//#endregion
+export { buildIndicatorLineData, classifyElevatedFeatures, createCurtainPolygonFeatures, flattenFeatureTo2D, getFeatureElevation, partitionCurtains };
+//# sourceMappingURL=elevation.js.map

package/dist/deckgl/shapes/display-shape-layer/utils/elevation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevation.js","names":["segments: LineSegment[]","allSegments: LineSegment[]","lines: Shape['feature'][]","polygons: Shape['feature'][]","nonPolygons: Shape['feature'][]","polygons: CurtainFeature[]","ring: number[][]","curtainFeatures: CurtainFeature[]","fillColor: Rgba255Tuple","coordArrays: number[][][]","main: CurtainFeature[]","hovered: CurtainFeature[]","selected: CurtainFeature[]","lineData: LineSegment[]"],"sources":["../../../../../src/deckgl/shapes/display-shape-layer/utils/elevation.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  isGeometryCollectionType,\n  isLineGeometry,\n  isLineStringType,\n  isMultiLineStringType,\n  isMultiPointType,\n  isMultiPolygonType,\n  isPointType,\n  isPolygonGeometry,\n  isPolygonType,\n} from '../../shared/types';\nimport { getLineColor } from '../../shared/utils/style-utils';\nimport { BRIGHTNESS_FACTOR } from '../constants';\nimport { brightenColor } from './display-style';\nimport type { Rgba255Tuple } from '@accelint/predicates';\nimport type { Shape, ShapeId } from '../../shared/types';\nimport type {\n  CurtainFeature,\n  ElevatedFeatureClassification,\n  LineSegment,\n} from '../types';\n\n// =============================================================================\n// Coordinate Helpers\n// =============================================================================\n\n/**\n * Extract elevation from 3D coordinates.\n * Drills into nested coordinate arrays to find the z-value.\n *\n * @param coordinates - GeoJSON coordinates (single, array, or nested)\n * @returns The z-coordinate if present, otherwise 0\n *\n * @example\n * ```typescript\n * getElevationFromCoordinates([10, 20, 5000]); // 5000\n * getElevationFromCoordinates([[10, 20, 5000], [11, 21, 6000]]); // 5000\n * getElevationFromCoordinates([10, 20]); // 0\n * ```\n */\n// GeoJSON nesting is at most 4 levels deep (MultiPolygon → Polygon → Ring → Position)\nconst MAX_COORDINATE_DEPTH = 5;\n\nexport function getElevationFromCoordinates(coordinates: unknown): number {\n  let current = coordinates;\n  let depth = 0;\n\n  while (Array.isArray(current) && depth < MAX_COORDINATE_DEPTH) {\n    // Leaf coordinate: [lon, lat] or [lon, lat, elevation]\n    if (!Array.isArray(current[0])) {\n      return (current[2] as number) ?? 0;\n    }\n    // Drill into nested coordinate arrays (polygons, multi-polygons)\n    current = current[0];\n    depth++;\n  }\n\n  return 0;\n}\n\n/**\n * Get elevation from a feature's geometry.\n * Extracts z-coordinate, returning 0 for missing geometry or GeometryCollection.\n *\n * @param feature - The GeoJSON feature\n * @returns The elevation value, or 0\n *\n * @example\n * ```typescript\n * const elevation = getFeatureElevation(feature);\n * if (elevation > 0) {\n *   // Feature has 3D elevation\n * }\n * ```\n */\nexport function getFeatureElevation(feature: Shape['feature']): number {\n  // Prefer explicit maxElevation from feature properties (set at data creation time).\n  // This avoids needing to drill into coordinates and is the source of truth for\n  // Z-stripped polygons where coordinate Z has been removed.\n  const maxElevation = feature.properties?.maxElevation;\n  if (maxElevation !== undefined) {\n    return maxElevation;\n  }\n\n  const { geometry } = feature;\n\n  if (!geometry) {\n    return 0;\n  }\n\n  // GeometryCollection doesn't have coordinates property\n  if (isGeometryCollectionType(geometry)) {\n    return 0;\n  }\n\n  return getElevationFromCoordinates(geometry.coordinates);\n}\n\n/**\n * Extract [lon, lat] from a coordinate array if valid.\n */\nfunction extractLonLat(\n  coords: number[] | undefined,\n): [number, number] | undefined {\n  if (!coords || coords.length < 2) {\n    return undefined;\n  }\n  const [lon, lat] = coords;\n  return lon !== undefined && lat !== undefined ? [lon, lat] : undefined;\n}\n\n/**\n * Extract a representative coordinate from a feature for elevation indicators.\n *\n * @param geometry - The feature geometry\n * @returns [lon, lat] or undefined if coordinates cannot be extracted\n */\nfunction getRepresentativeCoordinate(\n  geometry: Shape['feature']['geometry'],\n): [number, number] | undefined {\n  if (isPointType(geometry)) {\n    return extractLonLat(geometry.coordinates as number[]);\n  }\n\n  if (isLineStringType(geometry) || isMultiPointType(geometry)) {\n    return extractLonLat(geometry.coordinates[0] as number[]);\n  }\n\n  if (isMultiLineStringType(geometry)) {\n    return extractLonLat(geometry.coordinates[0]?.[0] as number[] | undefined);\n  }\n\n  return undefined;\n}\n\n// =============================================================================\n// Line Segment Builders\n// =============================================================================\n\n/** Create a vertical line segment from ground to an elevated position. */\nfunction createVerticalSegment(\n  lon: number,\n  lat: number,\n  elevation: number,\n  color: Rgba255Tuple,\n): LineSegment {\n  return {\n    source: [lon, lat, 0] as [number, number, number],\n    target: [lon, lat, elevation] as [number, number, number],\n    color,\n  };\n}\n\n/** Process a coordinates array and create vertical segments for each elevated point. */\nfunction processCoordinates(\n  coordinates: number[][],\n  color: Rgba255Tuple,\n): LineSegment[] {\n  const segments: LineSegment[] = [];\n\n  for (const coord of coordinates) {\n    const [lon, lat, elevation] = coord;\n    if (\n      lon !== undefined &&\n      lat !== undefined &&\n      elevation !== undefined &&\n      elevation > 0\n    ) {\n      segments.push(createVerticalSegment(lon, lat, elevation, color));\n    }\n  }\n\n  return segments;\n}\n\n/**\n * Create elevation indicator line segments for a geometry.\n *\n * @param geometry - The feature geometry\n * @param color - RGBA color for the line segments\n * @returns Array of line segments from ground to elevated positions\n *\n * @example\n * ```typescript\n * const segments = createElevationLineSegments(\n *   feature.geometry,\n *   [255, 255, 255, 255],\n * );\n * // Each segment has { source: [lon, lat, 0], target: [lon, lat, elevation], color }\n * ```\n */\nexport function createElevationLineSegments(\n  geometry: Shape['feature']['geometry'],\n  color: Rgba255Tuple,\n): LineSegment[] {\n  // Skip GeometryCollection\n  if (isGeometryCollectionType(geometry)) {\n    return [];\n  }\n\n  if (isLineStringType(geometry)) {\n    // Create vertical lines at EACH coordinate to form a \"curtain\"\n    return processCoordinates(geometry.coordinates as number[][], color);\n  }\n\n  if (isMultiLineStringType(geometry)) {\n    // Create vertical lines for each coordinate in each line\n    const allSegments: LineSegment[] = [];\n    const lines = geometry.coordinates as number[][][];\n    for (const line of lines) {\n      for (const segment of processCoordinates(line, color)) {\n        allSegments.push(segment);\n      }\n    }\n    return allSegments;\n  }\n\n  // For Point and MultiPoint, use single representative coordinate\n  const coords = getRepresentativeCoordinate(geometry);\n  if (coords) {\n    const [lon, lat] = coords;\n    const elevation = getElevationFromCoordinates(geometry.coordinates);\n    if (elevation > 0) {\n      return [createVerticalSegment(lon, lat, elevation, color)];\n    }\n  }\n\n  return [];\n}\n\n// =============================================================================\n// Feature Classification\n// =============================================================================\n\n/**\n * Single-pass classification of features by geometry type and elevation.\n * Avoids multiple .filter() passes per render frame.\n *\n * @param features - The features to classify\n * @param getElevation - Elevation accessor function\n * @returns Classified features: lines, polygons, nonPolygons\n *\n * @example\n * ```typescript\n * const { lines, polygons, nonPolygons } = classifyElevatedFeatures(\n *   features,\n *   getFeatureElevation,\n * );\n * ```\n */\nexport function classifyElevatedFeatures(\n  features: Shape['feature'][],\n  getElevation: (feature: Shape['feature']) => number,\n): ElevatedFeatureClassification {\n  const lines: Shape['feature'][] = [];\n  const polygons: Shape['feature'][] = [];\n  const nonPolygons: Shape['feature'][] = [];\n\n  for (const f of features) {\n    const elevation = getElevation(f);\n    if (elevation <= 0) {\n      continue;\n    }\n\n    const { geometry } = f;\n    if (isPolygonGeometry(geometry)) {\n      polygons.push(f);\n    } else {\n      nonPolygons.push(f);\n      if (isLineGeometry(geometry)) {\n        lines.push(f);\n      }\n    }\n  }\n\n  return { lines, polygons, nonPolygons };\n}\n\n// =============================================================================\n// Curtain Polygon Builders\n// =============================================================================\n\n/**\n * Create curtain polygon features from a single LineString's coordinate array.\n * Each pair of consecutive coordinates becomes a vertical rectangular polygon.\n *\n * @param coordinates - Array of [lon, lat, elevation] coordinates\n * @param fillColor - RGBA fill color for the curtain\n * @param lineColor - RGBA line color for the curtain\n * @param shapeId - Optional shape ID for picking correlation\n * @returns Array of curtain polygon features\n *\n * @example\n * ```typescript\n * const curtains = createCurtainPolygonsFromLine(\n *   [[10, 20, 5000], [11, 21, 6000]],\n *   [98, 166, 255, 51],\n *   [98, 166, 255, 255],\n *   'shape-1',\n * );\n * ```\n */\nexport function createCurtainPolygonsFromLine(\n  coordinates: number[][],\n  fillColor: Rgba255Tuple,\n  lineColor: Rgba255Tuple,\n  shapeId?: ShapeId,\n): CurtainFeature[] {\n  const polygons: CurtainFeature[] = [];\n\n  // Create vertical polygon for each pair of consecutive coordinates\n  for (let i = 0; i < coordinates.length - 1; i++) {\n    const coord1 = coordinates[i];\n    const coord2 = coordinates[i + 1];\n    if (coord1 === undefined || coord2 === undefined) {\n      continue;\n    }\n\n    const [lon1, lat1, elev1] = coord1;\n    const [lon2, lat2, elev2] = coord2;\n\n    if (\n      lon1 === undefined ||\n      lat1 === undefined ||\n      elev1 === undefined ||\n      lon2 === undefined ||\n      lat2 === undefined ||\n      elev2 === undefined\n    ) {\n      continue;\n    }\n\n    // Skip if both points are at ground level\n    if (elev1 === 0 && elev2 === 0) {\n      continue;\n    }\n\n    // Create vertical rectangle as a polygon\n    // Winding order: counter-clockwise when viewed from outside\n    // Bottom-left -> Bottom-right -> Top-right -> Top-left -> Bottom-left (closing)\n    const ring: number[][] = [\n      [lon1, lat1, 0], // Bottom left (ground)\n      [lon2, lat2, 0], // Bottom right (ground)\n      [lon2, lat2, elev2], // Top right (elevated)\n      [lon1, lat1, elev1], // Top left (elevated)\n      [lon1, lat1, 0], // Close the ring\n    ];\n\n    polygons.push({\n      type: 'Feature',\n      geometry: {\n        type: 'Polygon',\n        coordinates: [ring],\n      },\n      properties: {\n        fillColor,\n        lineColor,\n        shapeId,\n      },\n    });\n  }\n\n  return polygons;\n}\n\n/**\n * Create vertical curtain polygon features from elevated LineString features.\n * Converts elevated LineStrings into vertical rectangular polygons from ground to elevation.\n *\n * @param elevatedLines - Features with LineString/MultiLineString geometry and elevation\n * @param applyBaseOpacity - Whether to apply reduced opacity to fills\n * @returns Array of curtain polygon features\n *\n * @example\n * ```typescript\n * const curtainFeatures = createCurtainPolygonFeatures(elevatedLines, true);\n * // Returns vertical polygon features for each consecutive coordinate pair\n * ```\n */\nexport function createCurtainPolygonFeatures(\n  elevatedLines: Shape['feature'][],\n  applyBaseOpacity: boolean | undefined,\n): CurtainFeature[] {\n  const curtainFeatures: CurtainFeature[] = [];\n\n  for (const feature of elevatedLines) {\n    const { geometry } = feature;\n    const lineColorRGBA = getLineColor(feature);\n    const shapeId = feature.properties?.shapeId;\n\n    // Create fill color with base opacity (same as polygon fills)\n    const fillColor: Rgba255Tuple = applyBaseOpacity\n      ? [\n          lineColorRGBA[0],\n          lineColorRGBA[1],\n          lineColorRGBA[2],\n          Math.round(lineColorRGBA[3] * 0.2),\n        ]\n      : lineColorRGBA;\n\n    // Normalize to array of coordinate arrays for both LineString and MultiLineString\n    // Safe cast: elevatedLines only contains LineString/MultiLineString features\n    let coordArrays: number[][][];\n    if (isLineStringType(geometry)) {\n      coordArrays = [geometry.coordinates as number[][]];\n    } else {\n      coordArrays = (geometry as { coordinates: number[][][] }).coordinates;\n    }\n\n    for (const coords of coordArrays) {\n      for (const polygon of createCurtainPolygonsFromLine(\n        coords,\n        fillColor,\n        lineColorRGBA,\n        shapeId,\n      )) {\n        curtainFeatures.push(polygon);\n      }\n    }\n  }\n\n  return curtainFeatures;\n}\n\n// =============================================================================\n// Coordinate Projection\n// =============================================================================\n\n/**\n * Returns a copy of a feature with Z coordinates stripped from its geometry.\n *\n * Use this to project a feature back to the ground plane. Common use cases:\n * - Highlight outlines that should render at ground level\n * - Extruded polygons where elevation must come solely from `getElevation`,\n *   not from coordinate Z (deck.gl's SolidPolygonLayer adds both together)\n *\n * @param feature - The feature to flatten\n * @returns A new feature with 2D coordinates, or the original if geometry\n *   type is not handled (Point, MultiPoint, GeometryCollection)\n *\n * @example\n * ```typescript\n * // Elevated LineString [lon, lat, 20000] → [lon, lat]\n * const flat = flattenFeatureTo2D(elevatedLineStringFeature);\n * // flat.geometry.coordinates: [[lon, lat], [lon, lat], ...]\n *\n * // Elevated Polygon [lon, lat, 43500] → [lon, lat]\n * const flat = flattenFeatureTo2D(elevatedPolygonFeature);\n * // flat.geometry.coordinates: [[[lon, lat], [lon, lat], ...]]\n * ```\n */\n\nconst stripZ = ([lon, lat]: number[]) => [lon, lat] as [number, number];\n\nexport function flattenFeatureTo2D(\n  feature: Shape['feature'],\n): Shape['feature'] {\n  const { geometry } = feature;\n  if (isLineStringType(geometry)) {\n    return {\n      ...feature,\n      geometry: {\n        ...geometry,\n        coordinates: (geometry.coordinates as number[][]).map(stripZ),\n      },\n    };\n  }\n  if (isMultiLineStringType(geometry) || isPolygonType(geometry)) {\n    return {\n      ...feature,\n      geometry: {\n        ...geometry,\n        coordinates: (geometry.coordinates as number[][][]).map((ring) =>\n          ring.map(stripZ),\n        ),\n      },\n    };\n  }\n  if (isMultiPolygonType(geometry)) {\n    return {\n      ...feature,\n      geometry: {\n        ...geometry,\n        coordinates: (geometry.coordinates as number[][][][]).map((polygon) =>\n          polygon.map((ring) => ring.map(stripZ)),\n        ),\n      },\n    };\n  }\n  return feature;\n}\n\n/**\n * Partition curtain features by interaction state (main, hovered, selected).\n *\n * @param allCurtainFeatures - All curtain features to partition\n * @param hoveredShapeId - Currently hovered shape ID\n * @param selectedShapeId - Currently selected shape ID\n * @returns Partitioned curtain features by state\n *\n * @example\n * ```typescript\n * const { main, hovered, selected } = partitionCurtains(\n *   curtainFeatures,\n *   hoveredShapeId,\n *   selectedShapeId,\n * );\n * ```\n */\nexport function partitionCurtains(\n  allCurtainFeatures: CurtainFeature[],\n  hoveredShapeId: ShapeId | undefined,\n  selectedShapeId: ShapeId | undefined,\n): {\n  main: CurtainFeature[];\n  hovered: CurtainFeature[];\n  selected: CurtainFeature[];\n} {\n  const main: CurtainFeature[] = [];\n  const hovered: CurtainFeature[] = [];\n  const selected: CurtainFeature[] = [];\n\n  for (const f of allCurtainFeatures) {\n    const id = f.properties.shapeId;\n    if (id === selectedShapeId) {\n      selected.push(f);\n    } else if (id === hoveredShapeId) {\n      hovered.push(f);\n    } else {\n      main.push(f);\n    }\n  }\n\n  return { main, hovered, selected };\n}\n\n/**\n * Build elevation indicator line segments for a set of elevated non-polygon features,\n * applying interaction-state colors (brightened on hover/select).\n *\n * @param elevatedNonPolygons - Features to generate segments for\n * @param features - Full feature array for hover-index lookup\n * @param selectedShapeId - Currently selected shape ID\n * @param hoverIndex - Currently hovered feature index\n * @returns Array of colored line segments from ground to elevation\n * @example\n * ```typescript\n * const lineData = buildIndicatorLineData(\n *   elevatedNonPolygons,\n *   allFeatures,\n *   selectedShapeId,\n *   hoverIndex,\n * );\n * // Each segment: { source: [lon, lat, 0], target: [lon, lat, elevation], color: [r, g, b, a] }\n * ```\n */\nexport function buildIndicatorLineData(\n  elevatedNonPolygons: Shape['feature'][],\n  features: Shape['feature'][],\n  selectedShapeId: ShapeId | undefined,\n  hoverIndex: number | undefined,\n): LineSegment[] {\n  const lineData: LineSegment[] = [];\n  const hoveredFeatureShapeId =\n    hoverIndex !== undefined\n      ? features[hoverIndex]?.properties?.shapeId\n      : undefined;\n\n  for (const feature of elevatedNonPolygons) {\n    const { geometry } = feature;\n    const shapeId = feature.properties?.shapeId;\n    const isSelected = shapeId != null && shapeId === selectedShapeId;\n    const isHovered = shapeId != null && shapeId === hoveredFeatureShapeId;\n\n    const base = getLineColor(feature);\n    const factor =\n      isSelected && isHovered\n        ? BRIGHTNESS_FACTOR.HOVER_AND_SELECT\n        : BRIGHTNESS_FACTOR.HOVER_OR_SELECT;\n    const color = isSelected || isHovered ? brightenColor(base, factor) : base;\n\n    for (const segment of createElevationLineSegments(geometry, color)) {\n      lineData.push(segment);\n    }\n  }\n\n  return lineData;\n}\n"],"mappings":"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"}

package/dist/deckgl/shapes/display-shape-layer/utils/icon-config.js

@@ -0,0 +1,151 @@
+/*
+ * 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
+ *
+ * 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.
+ */
+
+
+'use client';
+
+import { getLineColor } from "../../shared/utils/style-utils.js";
+import { COFFIN_CORNERS, MAP_INTERACTION } from "../constants.js";
+
+//#region src/deckgl/shapes/display-shape-layer/utils/icon-config.ts
+/**
+* Extract icon configuration from features in a single pass.
+* Returns the first icon's atlas and mapping (all shapes share the same atlas).
+* Uses early return for O(1) best case when the first feature has icons.
+*
+* @param features - Array of styled features to scan
+* @returns Icon configuration with atlas and mapping if any feature has icons
+*
+* @example
+* ```typescript
+* const { hasIcons, atlas, mapping } = getIconConfig(features);
+* if (hasIcons) {
+*   // Configure icon layer with atlas and mapping
+* }
+* ```
+*/
+function getIconConfig(features) {
+	for (const feature of features) {
+		const icon = feature.properties?.styleProperties?.icon;
+		if (icon) return {
+			hasIcons: true,
+			atlas: icon.atlas,
+			mapping: icon.mapping
+		};
+	}
+	return { hasIcons: false };
+}
+/**
+* Build icon layer props to spread onto a GeoJsonLayer.
+* Returns an empty object when icons are not present.
+*
+* @param hasIcons - Whether any feature has icon config
+* @param iconAtlas - Icon atlas URL or data
+* @param iconMapping - Icon name-to-position mapping
+* @returns Props object to spread onto GeoJsonLayer configuration
+*
+* @example
+* ```typescript
+* const iconProps = getIconLayerProps(hasIcons, iconAtlas, iconMapping);
+* const layer = new GeoJsonLayer({ ...iconProps, data: features });
+* ```
+*/
+function getIconLayerProps(hasIcons, iconAtlas, iconMapping) {
+	if (!hasIcons) return {};
+	const result = {
+		getIcon: (d) => d.properties?.styleProperties?.icon?.name ?? "marker",
+		getIconSize: (d) => d.properties?.styleProperties?.icon?.size ?? MAP_INTERACTION.ICON_SIZE,
+		getIconColor: getLineColor,
+		getIconPixelOffset: (d) => {
+			return [-1, -(d.properties?.styleProperties?.icon?.size ?? MAP_INTERACTION.ICON_SIZE) / 2];
+		},
+		iconBillboard: false
+	};
+	if (iconAtlas) result.iconAtlas = iconAtlas;
+	if (iconMapping) result.iconMapping = iconMapping;
+	return result;
+}
+/**
+* Build icon update triggers to spread onto GeoJsonLayer updateTriggers.
+* Returns an empty object when icons are not present.
+*
+* @param hasIcons - Whether any feature has icon config
+* @param features - Features array for trigger dependencies
+* @returns Update triggers object to spread onto updateTriggers
+*
+* @example
+* ```typescript
+* const layer = new GeoJsonLayer({
+*   updateTriggers: {
+*     ...getIconUpdateTriggers(hasIcons, features),
+*   },
+* });
+* ```
+*/
+function getIconUpdateTriggers(hasIcons, features) {
+	if (!hasIcons) return {};
+	return {
+		getIcon: [features],
+		getIconSize: [features],
+		getIconColor: [features],
+		getIconPixelOffset: [features]
+	};
+}
+/** WeakMap memoizing extended icon mappings by baseMapping identity. */
+const coffinCornerCache = /* @__PURE__ */ new WeakMap();
+/**
+* Extend an icon mapping with coffin corners entries for hover/selection feedback.
+* Memoized per baseMapping identity via WeakMap to avoid re-spreading per render frame.
+*
+* @param baseMapping - The original icon mapping from the feature's icon config
+* @returns Extended mapping with coffin corners icons added
+*
+* @example
+* ```typescript
+* const extendedMapping = extendMappingWithCoffinCorners(iconMapping);
+* // Result includes original mapping entries plus coffin corner icons
+* ```
+*/
+function extendMappingWithCoffinCorners(baseMapping) {
+	const cached = coffinCornerCache.get(baseMapping);
+	if (cached) return cached;
+	const result = {
+		...baseMapping,
+		[COFFIN_CORNERS.HOVER_ICON]: {
+			x: 0,
+			y: 0,
+			width: 76,
+			height: 76,
+			mask: false
+		},
+		[COFFIN_CORNERS.SELECTED_ICON]: {
+			x: 76,
+			y: 0,
+			width: 76,
+			height: 76,
+			mask: false
+		},
+		[COFFIN_CORNERS.SELECTED_HOVER_ICON]: {
+			x: 152,
+			y: 0,
+			width: 76,
+			height: 76,
+			mask: false
+		}
+	};
+	coffinCornerCache.set(baseMapping, result);
+	return result;
+}
+
+//#endregion
+export { extendMappingWithCoffinCorners, getIconConfig, getIconLayerProps, getIconUpdateTriggers };
+//# sourceMappingURL=icon-config.js.map

package/dist/deckgl/shapes/display-shape-layer/utils/icon-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-config.js","names":["result: Record<string, unknown>"],"sources":["../../../../../src/deckgl/shapes/display-shape-layer/utils/icon-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 { getLineColor } from '../../shared/utils/style-utils';\nimport { COFFIN_CORNERS, MAP_INTERACTION } from '../constants';\nimport type { Shape } from '../../shared/types';\n\n/** Icon mapping entry describing position and dimensions within an atlas. */\ntype IconMappingEntry = {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  mask?: boolean;\n};\n\n/** Result of scanning features for icon configuration. */\nexport type IconConfig = {\n  /** Whether any feature in the dataset has icon configuration */\n  hasIcons: boolean;\n  /** Icon atlas image URL or data (shared across all features) */\n  atlas?: string;\n  /** Icon name-to-position mapping within the atlas */\n  mapping?: Record<string, IconMappingEntry>;\n};\n\n/**\n * Extract icon configuration from features in a single pass.\n * Returns the first icon's atlas and mapping (all shapes share the same atlas).\n * Uses early return for O(1) best case when the first feature has icons.\n *\n * @param features - Array of styled features to scan\n * @returns Icon configuration with atlas and mapping if any feature has icons\n *\n * @example\n * ```typescript\n * const { hasIcons, atlas, mapping } = getIconConfig(features);\n * if (hasIcons) {\n *   // Configure icon layer with atlas and mapping\n * }\n * ```\n */\nexport function getIconConfig(features: Shape['feature'][]): IconConfig {\n  for (const feature of features) {\n    const icon = feature.properties?.styleProperties?.icon;\n    if (icon) {\n      return {\n        hasIcons: true,\n        atlas: icon.atlas,\n        mapping: icon.mapping,\n      };\n    }\n  }\n  return { hasIcons: false };\n}\n\n/**\n * Build icon layer props to spread onto a GeoJsonLayer.\n * Returns an empty object when icons are not present.\n *\n * @param hasIcons - Whether any feature has icon config\n * @param iconAtlas - Icon atlas URL or data\n * @param iconMapping - Icon name-to-position mapping\n * @returns Props object to spread onto GeoJsonLayer configuration\n *\n * @example\n * ```typescript\n * const iconProps = getIconLayerProps(hasIcons, iconAtlas, iconMapping);\n * const layer = new GeoJsonLayer({ ...iconProps, data: features });\n * ```\n */\nexport function getIconLayerProps(\n  hasIcons: boolean,\n  iconAtlas: string | undefined,\n  iconMapping: Record<string, IconMappingEntry> | undefined,\n): Record<string, unknown> {\n  if (!hasIcons) {\n    return {};\n  }\n\n  const result: Record<string, unknown> = {\n    getIcon: (d: Shape['feature']) =>\n      d.properties?.styleProperties?.icon?.name ?? 'marker',\n    getIconSize: (d: Shape['feature']) =>\n      d.properties?.styleProperties?.icon?.size ?? MAP_INTERACTION.ICON_SIZE,\n    getIconColor: getLineColor,\n    getIconPixelOffset: (d: Shape['feature']) => {\n      const iconSize =\n        d.properties?.styleProperties?.icon?.size ?? MAP_INTERACTION.ICON_SIZE;\n      return [-1, -iconSize / 2];\n    },\n    iconBillboard: false,\n  };\n\n  if (iconAtlas) {\n    result.iconAtlas = iconAtlas;\n  }\n\n  if (iconMapping) {\n    result.iconMapping = iconMapping;\n  }\n\n  return result;\n}\n\n/**\n * Build icon update triggers to spread onto GeoJsonLayer updateTriggers.\n * Returns an empty object when icons are not present.\n *\n * @param hasIcons - Whether any feature has icon config\n * @param features - Features array for trigger dependencies\n * @returns Update triggers object to spread onto updateTriggers\n *\n * @example\n * ```typescript\n * const layer = new GeoJsonLayer({\n *   updateTriggers: {\n *     ...getIconUpdateTriggers(hasIcons, features),\n *   },\n * });\n * ```\n */\nexport function getIconUpdateTriggers(\n  hasIcons: boolean,\n  features: Shape['feature'][],\n): Record<string, unknown[]> {\n  if (!hasIcons) {\n    return {};\n  }\n\n  return {\n    getIcon: [features],\n    getIconSize: [features],\n    getIconColor: [features],\n    getIconPixelOffset: [features],\n  };\n}\n\n/** WeakMap memoizing extended icon mappings by baseMapping identity. */\nconst coffinCornerCache = new WeakMap<\n  Record<string, IconMappingEntry>,\n  Record<string, IconMappingEntry>\n>();\n\n/**\n * Extend an icon mapping with coffin corners entries for hover/selection feedback.\n * Memoized per baseMapping identity via WeakMap to avoid re-spreading per render frame.\n *\n * @param baseMapping - The original icon mapping from the feature's icon config\n * @returns Extended mapping with coffin corners icons added\n *\n * @example\n * ```typescript\n * const extendedMapping = extendMappingWithCoffinCorners(iconMapping);\n * // Result includes original mapping entries plus coffin corner icons\n * ```\n */\nexport function extendMappingWithCoffinCorners(\n  baseMapping: Record<string, IconMappingEntry>,\n): Record<string, IconMappingEntry> {\n  const cached = coffinCornerCache.get(baseMapping);\n  if (cached) {\n    return cached;\n  }\n\n  const result = {\n    ...baseMapping,\n    [COFFIN_CORNERS.HOVER_ICON]: {\n      x: 0,\n      y: 0,\n      width: 76,\n      height: 76,\n      mask: false,\n    },\n    [COFFIN_CORNERS.SELECTED_ICON]: {\n      x: 76,\n      y: 0,\n      width: 76,\n      height: 76,\n      mask: false,\n    },\n    [COFFIN_CORNERS.SELECTED_HOVER_ICON]: {\n      x: 152,\n      y: 0,\n      width: 76,\n      height: 76,\n      mask: false,\n    },\n  };\n  coffinCornerCache.set(baseMapping, result);\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqDA,SAAgB,cAAc,UAA0C;AACtE,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,OAAO,QAAQ,YAAY,iBAAiB;AAClD,MAAI,KACF,QAAO;GACL,UAAU;GACV,OAAO,KAAK;GACZ,SAAS,KAAK;GACf;;AAGL,QAAO,EAAE,UAAU,OAAO;;;;;;;;;;;;;;;;;AAkB5B,SAAgB,kBACd,UACA,WACA,aACyB;AACzB,KAAI,CAAC,SACH,QAAO,EAAE;CAGX,MAAMA,SAAkC;EACtC,UAAU,MACR,EAAE,YAAY,iBAAiB,MAAM,QAAQ;EAC/C,cAAc,MACZ,EAAE,YAAY,iBAAiB,MAAM,QAAQ,gBAAgB;EAC/D,cAAc;EACd,qBAAqB,MAAwB;AAG3C,UAAO,CAAC,IAAI,EADV,EAAE,YAAY,iBAAiB,MAAM,QAAQ,gBAAgB,aACvC,EAAE;;EAE5B,eAAe;EAChB;AAED,KAAI,UACF,QAAO,YAAY;AAGrB,KAAI,YACF,QAAO,cAAc;AAGvB,QAAO;;;;;;;;;;;;;;;;;;;AAoBT,SAAgB,sBACd,UACA,UAC2B;AAC3B,KAAI,CAAC,SACH,QAAO,EAAE;AAGX,QAAO;EACL,SAAS,CAAC,SAAS;EACnB,aAAa,CAAC,SAAS;EACvB,cAAc,CAAC,SAAS;EACxB,oBAAoB,CAAC,SAAS;EAC/B;;;AAIH,MAAM,oCAAoB,IAAI,SAG3B;;;;;;;;;;;;;;AAeH,SAAgB,+BACd,aACkC;CAClC,MAAM,SAAS,kBAAkB,IAAI,YAAY;AACjD,KAAI,OACF,QAAO;CAGT,MAAM,SAAS;EACb,GAAG;GACF,eAAe,aAAa;GAC3B,GAAG;GACH,GAAG;GACH,OAAO;GACP,QAAQ;GACR,MAAM;GACP;GACA,eAAe,gBAAgB;GAC9B,GAAG;GACH,GAAG;GACH,OAAO;GACP,QAAQ;GACR,MAAM;GACP;GACA,eAAe,sBAAsB;GACpC,GAAG;GACH,GAAG;GACH,OAAO;GACP,QAAQ;GACR,MAAM;GACP;EACF;AACD,mBAAkB,IAAI,aAAa,OAAO;AAC1C,QAAO"}

package/dist/deckgl/shapes/display-shape-layer/utils/interaction.js

@@ -0,0 +1,50 @@
+/*
+ * 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
+ *
+ * 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.
+ */
+
+
+'use client';
+
+//#region src/deckgl/shapes/display-shape-layer/utils/interaction.ts
+/**
+* Compute hover/selection interaction state for a feature by index.
+*
+* @param feature - The feature to check
+* @param selectedShapeId - Currently selected shape ID
+* @param hoverIndex - Currently hovered feature index
+* @param shapeIdToIndex - Map of shapeId to feature index for O(1) lookup
+* @returns `{ isSelected, isHovered }`
+* @example
+* ```typescript
+* const { isSelected, isHovered } = getPointInteractionState(
+*   feature,
+*   selectedShapeId,
+*   hoverIndex,
+*   shapeIdToIndex, // Map<ShapeId, number> from getFeaturesWithId()
+* );
+* if (isSelected || isHovered) {
+*   // render interaction feedback
+* }
+* ```
+*/
+function getPointInteractionState(feature, selectedShapeId, hoverIndex, shapeIdToIndex) {
+	const shapeId = feature.properties?.shapeId;
+	const isSelected = shapeId != null && shapeId === selectedShapeId;
+	const featureIndex = shapeId ? shapeIdToIndex.get(shapeId) : void 0;
+	return {
+		isSelected,
+		isHovered: hoverIndex !== void 0 && featureIndex === hoverIndex
+	};
+}
+
+//#endregion
+export { getPointInteractionState };
+//# sourceMappingURL=interaction.js.map