@accelint/map-toolkit 0.6.0 → 1.0.0

package/dist/deckgl/shapes/display-shape-layer/types.d.ts

@@ -10,12 +10,19 @@
  * governing permissions and limitations under the License.
  */
 
-import { EditableShape, ShapeId, StyledFeature as StyledFeature$1 } from "../shared/types.js";
+import { Shape, ShapeId, StyledFeature as StyledFeature$1 } from "../shared/types.js";
 import { LabelPositionOptions } from "./utils/labels.js";
 import { UniqueId } from "@accelint/core";
 import { CompositeLayerProps } from "@deck.gl/core";
 
 //#region src/deckgl/shapes/display-shape-layer/types.d.ts
+/**
+ * Label display mode for shapes
+ * - `'always'`: Show labels for all shapes
+ * - `'hover'`: Show label only for the currently hovered shape
+ * - `'never'`: Never show labels
+ */
+type ShowLabelsMode = 'always' | 'hover' | 'never';
 /**
  * Re-export StyledFeature from shared types
  */
@@ -50,7 +57,7 @@ interface DisplayShapeLayerProps extends CompositeLayerProps {
    * Array of shapes to display
    * Each shape must have a GeoJSON feature with styleProperties
    */
-  data: EditableShape[];
+  data: Shape[];
   /**
    * Currently selected shape ID (for highlighting)
    * When set, renders a highlight layer around the selected shape
@@ -61,19 +68,23 @@ interface DisplayShapeLayerProps extends CompositeLayerProps {
    * Also triggers a shapes:selected event on the event bus
    * @param shape - The clicked shape with full properties
    */
-  onShapeClick?: (shape: EditableShape) => void;
+  onShapeClick?: (shape: Shape) => void;
   /**
    * Callback when a shape is hovered
    * Called with null when hover ends
    * @param shape - The hovered shape, or null when hover ends
    */
-  onShapeHover?: (shape: EditableShape | null) => void;
+  onShapeHover?: (shape: Shape | null) => void;
   /**
-   * Whether to show labels on shapes
+   * Label display mode for shapes
+   * - `'always'`: Show labels for all shapes
+   * - `'hover'`: Show label only for the currently hovered shape (requires `pickable={true}`, the default)
+   * - `'never'`: Never show labels
+   *
    * Labels use the shape's `label` property, or `name` if label is not set
-   * @default true
+   * @default 'always'
    */
-  showLabels?: boolean;
+  showLabels?: ShowLabelsMode;
   /**
    * Global label positioning options
    * Can be overridden per-shape via styleProperties
@@ -98,18 +109,18 @@ interface DisplayShapeLayerProps extends CompositeLayerProps {
    */
   highlightColor?: [number, number, number, number];
   /**
-   * When true (default), applies 60% opacity multiplier to fill colors for standard semi-transparent look.
-   * This is a convenience prop for achieving the standard map shape appearance.
+   * When true (default), multiplies fill color alpha by 0.2 (reducing to 20% of original opacity)
+   * for a standard semi-transparent look.
    * When false, colors are rendered exactly as specified in styleProperties.
    * @default true
    * @example Standard semi-transparent fills
    * ```tsx
    * <DisplayShapeLayer data={shapes} applyBaseOpacity />
-   * // Shape with fillColor [98, 166, 255, 255] renders at alpha 153
+   * // Shape with fillColor [98, 166, 255, 255] renders at alpha 51 (255 × 0.2)
    * ```
    */
   applyBaseOpacity?: boolean;
 }
 //#endregion
-export { DisplayShapeLayerProps, StyledFeature, StyledFeatureProperties };
+export { DisplayShapeLayerProps, ShowLabelsMode, StyledFeature, StyledFeatureProperties };
 //# sourceMappingURL=types.d.ts.map

package/dist/deckgl/shapes/display-shape-layer/{use-shape-selection.d.ts → use-select-shape.d.ts}

@@ -13,11 +13,11 @@
 import { ShapeId } from "../shared/types.js";
 import { UniqueId } from "@accelint/core";
 
-//#region src/deckgl/shapes/display-shape-layer/use-shape-selection.d.ts
+//#region src/deckgl/shapes/display-shape-layer/use-select-shape.d.ts
 /**
- * Return type for useShapeSelection hook
+ * Return type for useSelectShape hook
  */
-interface UseShapeSelectionReturn {
+interface UseSelectShapeReturn {
   /** Currently selected shape ID, or undefined if nothing selected */
   selectedId: ShapeId | undefined;
   /** Manually set the selected shape ID (useful for programmatic selection) */
@@ -43,10 +43,10 @@ interface UseShapeSelectionReturn {
  *
  * @example Basic usage
  * ```tsx
- * import { useShapeSelection } from '@accelint/map-toolkit/deckgl/shapes';
+ * import { useSelectShape } from '@accelint/map-toolkit/deckgl/shapes';
  *
  * function MapWithShapes() {
- *   const { selectedId } = useShapeSelection(MAP_ID);
+ *   const { selectedId } = useSelectShape(MAP_ID);
  *
  *   return (
  *     <BaseMap id={MAP_ID}>
@@ -64,7 +64,7 @@ interface UseShapeSelectionReturn {
  * @example With programmatic selection control
  * ```tsx
  * function MapWithShapes() {
- *   const { selectedId, setSelectedId, clearSelection } = useShapeSelection(MAP_ID);
+ *   const { selectedId, setSelectedId, clearSelection } = useSelectShape(MAP_ID);
  *
  *   return (
  *     <>
@@ -83,7 +83,7 @@ interface UseShapeSelectionReturn {
  * }
  * ```
  */
-declare function useShapeSelection(mapId: UniqueId): UseShapeSelectionReturn;
+declare function useSelectShape(mapId: UniqueId): UseSelectShapeReturn;
 //#endregion
-export { UseShapeSelectionReturn, useShapeSelection };
-//# sourceMappingURL=use-shape-selection.d.ts.map
+export { UseSelectShapeReturn, useSelectShape };
+//# sourceMappingURL=use-select-shape.d.ts.map

package/dist/deckgl/shapes/display-shape-layer/{use-shape-selection.js → use-select-shape.js}

@@ -13,10 +13,9 @@
 
 'use client';
 
-import { getOrCreateClearSelection, getOrCreateServerSnapshot, getOrCreateSetSelectedId, getOrCreateSnapshot, getOrCreateSubscription } from "./store.js";
-import { useSyncExternalStore } from "react";
+import { shapeSelectionStore } from "./store.js";
 
-//#region src/deckgl/shapes/display-shape-layer/use-shape-selection.ts
+//#region src/deckgl/shapes/display-shape-layer/use-select-shape.ts
 /**
 * Hook to manage shape selection state with automatic deselection
 *
@@ -35,10 +34,10 @@ import { useSyncExternalStore } from "react";
 *
 * @example Basic usage
 * ```tsx
-* import { useShapeSelection } from '@accelint/map-toolkit/deckgl/shapes';
+* import { useSelectShape } from '@accelint/map-toolkit/deckgl/shapes';
 *
 * function MapWithShapes() {
-*   const { selectedId } = useShapeSelection(MAP_ID);
+*   const { selectedId } = useSelectShape(MAP_ID);
 *
 *   return (
 *     <BaseMap id={MAP_ID}>
@@ -56,7 +55,7 @@ import { useSyncExternalStore } from "react";
 * @example With programmatic selection control
 * ```tsx
 * function MapWithShapes() {
-*   const { selectedId, setSelectedId, clearSelection } = useShapeSelection(MAP_ID);
+*   const { selectedId, setSelectedId, clearSelection } = useSelectShape(MAP_ID);
 *
 *   return (
 *     <>
@@ -75,14 +74,15 @@ import { useSyncExternalStore } from "react";
 * }
 * ```
 */
-function useShapeSelection(mapId) {
+function useSelectShape(mapId) {
+	const { state, setSelectedId, clearSelection } = shapeSelectionStore.use(mapId);
 	return {
-		selectedId: useSyncExternalStore(getOrCreateSubscription(mapId), getOrCreateSnapshot(mapId), getOrCreateServerSnapshot(mapId)),
-		setSelectedId: getOrCreateSetSelectedId(mapId),
-		clearSelection: getOrCreateClearSelection(mapId)
+		selectedId: state.selectedId,
+		setSelectedId,
+		clearSelection
 	};
 }
 
 //#endregion
-export { useShapeSelection };
-//# sourceMappingURL=use-shape-selection.js.map
+export { useSelectShape };
+//# sourceMappingURL=use-select-shape.js.map

package/dist/deckgl/shapes/display-shape-layer/use-select-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-select-shape.js","names":[],"sources":["../../../../src/deckgl/shapes/display-shape-layer/use-select-shape.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { shapeSelectionStore } from './store';\nimport type { UniqueId } from '@accelint/core';\nimport type { ShapeId } from '../shared/types';\n\n/**\n * Return type for useSelectShape hook\n */\nexport interface UseSelectShapeReturn {\n  /** Currently selected shape ID, or undefined if nothing selected */\n  selectedId: ShapeId | undefined;\n  /** Manually set the selected shape ID (useful for programmatic selection) */\n  setSelectedId: (id: ShapeId | undefined) => void;\n  /** Manually clear the selection */\n  clearSelection: () => void;\n}\n\n/**\n * Hook to manage shape selection state with automatic deselection\n *\n * This hook encapsulates the common pattern of:\n * 1. Listening to `shapes:selected` events and updating state\n * 2. Listening to `shapes:deselected` events and clearing state\n * 3. Listening to map clicks on empty space and emitting `shapes:deselected`\n *\n * Uses a store pattern with `useSyncExternalStore` for proper listener cleanup\n * during HMR (Hot Module Replacement) in development. The store ensures only\n * one bus listener exists per map instance, regardless of how many React\n * components subscribe.\n *\n * @param mapId - The map instance ID for event filtering\n * @returns Selection state and control functions\n *\n * @example Basic usage\n * ```tsx\n * import { useSelectShape } from '@accelint/map-toolkit/deckgl/shapes';\n *\n * function MapWithShapes() {\n *   const { selectedId } = useSelectShape(MAP_ID);\n *\n *   return (\n *     <BaseMap id={MAP_ID}>\n *       <displayShapeLayer\n *         id=\"shapes\"\n *         mapId={MAP_ID}\n *         data={shapes}\n *         selectedShapeId={selectedId}\n *       />\n *     </BaseMap>\n *   );\n * }\n * ```\n *\n * @example With programmatic selection control\n * ```tsx\n * function MapWithShapes() {\n *   const { selectedId, setSelectedId, clearSelection } = useSelectShape(MAP_ID);\n *\n *   return (\n *     <>\n *       <button onClick={() => setSelectedId(shapes[0].id)}>Select First Shape</button>\n *       <button onClick={clearSelection}>Clear Selection</button>\n *       <BaseMap id={MAP_ID}>\n *         <displayShapeLayer\n *           id=\"shapes\"\n *           mapId={MAP_ID}\n *           data={shapes}\n *           selectedShapeId={selectedId}\n *         />\n *       </BaseMap>\n *     </>\n *   );\n * }\n * ```\n */\nexport function useSelectShape(mapId: UniqueId): UseSelectShapeReturn {\n  const { state, setSelectedId, clearSelection } =\n    shapeSelectionStore.use(mapId);\n\n  return {\n    selectedId: state.selectedId,\n    setSelectedId,\n    clearSelection,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFA,SAAgB,eAAe,OAAuC;CACpE,MAAM,EAAE,OAAO,eAAe,mBAC5B,oBAAoB,IAAI,MAAM;AAEhC,QAAO;EACL,YAAY,MAAM;EAClB;EACA;EACD"}

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

@@ -13,73 +13,12 @@
 
 'use client';
 
-import { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_STROKE_WIDTH, HIGHLIGHT_WIDTH_INCREASE, HOVER_WIDTH_INCREASE } from "../../shared/constants.js";
+import { DEFAULT_COLORS, HIGHLIGHT_WIDTH_INCREASE, HOVER_WIDTH_INCREASE } from "../../shared/constants.js";
+import { getLineWidth, normalizeColor } from "../../shared/utils/style-utils.js";
 
 //#region src/deckgl/shapes/display-shape-layer/utils/display-style.ts
 /**
-* 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.6)
-* @returns RGBA color array
-*/
-function getFillColor(feature, applyBaseOpacity = false) {
-	const rgba = normalizeColor((feature.properties?.styleProperties)?.fillColor ?? DEFAULT_COLORS.fill);
-	if (applyBaseOpacity) return [
-		rgba[0],
-		rgba[1],
-		rgba[2],
-		Math.round(rgba[3] * BASE_FILL_OPACITY)
-	];
-	return rgba;
-}
-/**
-* Get stroke color for a feature
-* Strokes are always rendered at their literal alpha value
-*
-* @param feature - The styled feature
-* @returns RGBA color array
-*/
-function getStrokeColor(feature) {
-	return normalizeColor((feature.properties?.styleProperties)?.strokeColor ?? DEFAULT_COLORS.stroke);
-}
-/**
-* Normalize a Color to a 4-element RGBA array
-* Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays
-*/
-function normalizeColor(color) {
-	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) return [
-		color[0] ?? 0,
-		color[1] ?? 0,
-		color[2] ?? 0,
-		color[3] ?? 255
-	];
-	return [
-		color[0],
-		color[1],
-		color[2],
-		color[3] ?? 255
-	];
-}
-/**
-* Get line width for a feature
-*/
-function getLineWidth(feature) {
-	return (feature.properties?.styleProperties)?.strokeWidth ?? DEFAULT_STROKE_WIDTH;
-}
-/**
-* Alias for getLineWidth (for compatibility)
-*/
-const getStrokeWidth = getLineWidth;
-/**
-* Get dash array for stroke pattern
-*/
-function getDashArray(feature) {
-	return DASH_ARRAYS[(feature.properties?.styleProperties)?.strokePattern ?? "solid"] || null;
-}
-/**
-* Get hover-enhanced line width
+* Get hover-enhanced border/outline width
 */
 function getHoverLineWidth(feature, isHovered) {
 	const baseWidth = getLineWidth(feature);
@@ -100,12 +39,12 @@ function getHighlightColor(opacity) {
 	return rgba;
 }
 /**
-* Get highlight line width (base width + increase)
+* Get highlight border/outline width (base width + increase)
 */
 function getHighlightLineWidth(feature) {
 	return getLineWidth(feature) + HIGHLIGHT_WIDTH_INCREASE;
 }
 
 //#endregion
-export { getDashArray, getFillColor, getHighlightColor, getHighlightLineWidth, getHoverLineWidth, getLineWidth, getStrokeColor, getStrokeWidth };
+export { getHighlightColor, getHighlightLineWidth, getHoverLineWidth };
 //# sourceMappingURL=display-style.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"display-style.js","names":[],"sources":["../../../../../src/deckgl/shapes/display-shape-layer/utils/display-style.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport {\n  BASE_FILL_OPACITY,\n  DASH_ARRAYS,\n  DEFAULT_COLORS,\n  DEFAULT_STROKE_WIDTH,\n  HIGHLIGHT_WIDTH_INCREASE,\n  HOVER_WIDTH_INCREASE,\n} from '../../shared/constants';\nimport type { Color } from '@deck.gl/core';\nimport type { StyledFeature } from '../../shared/types';\n\n/**\n * Get fill color for a feature\n * Colors are passed through as-is unless applyBaseOpacity is true\n *\n * @param feature - The styled feature\n * @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.6)\n * @returns RGBA color array\n */\nexport function getFillColor(\n  feature: StyledFeature,\n  applyBaseOpacity = false,\n): Color {\n  const styleProps = feature.properties?.styleProperties;\n  const color = styleProps?.fillColor ?? DEFAULT_COLORS.fill;\n\n  // Normalize to 4-element array\n  const rgba = normalizeColor(color);\n\n  if (applyBaseOpacity) {\n    // Apply base opacity multiplier to alpha channel\n    return [rgba[0], rgba[1], rgba[2], Math.round(rgba[3] * BASE_FILL_OPACITY)];\n  }\n\n  return rgba;\n}\n\n/**\n * Get stroke color for a feature\n * Strokes are always rendered at their literal alpha value\n *\n * @param feature - The styled feature\n * @returns RGBA color array\n */\nexport function getStrokeColor(feature: StyledFeature): Color {\n  const styleProps = feature.properties?.styleProperties;\n  const color = styleProps?.strokeColor ?? DEFAULT_COLORS.stroke;\n\n  return normalizeColor(color);\n}\n\n/**\n * Normalize a Color to a 4-element RGBA array\n * Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays\n */\nfunction normalizeColor(color: Color): [number, number, number, number] {\n  if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) {\n    return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n  }\n\n  // Handle RGB (3-element) or RGBA (4-element) arrays\n  return [color[0], color[1], color[2], color[3] ?? 255];\n}\n\n/**\n * Get line width for a feature\n */\nexport function getLineWidth(feature: StyledFeature): number {\n  const styleProps = feature.properties?.styleProperties;\n  return styleProps?.strokeWidth ?? DEFAULT_STROKE_WIDTH;\n}\n\n/**\n * Alias for getLineWidth (for compatibility)\n */\nexport const getStrokeWidth = getLineWidth;\n\n/**\n * Get dash array for stroke pattern\n */\nexport function getDashArray(feature: StyledFeature): [number, number] | null {\n  const styleProps = feature.properties?.styleProperties;\n  const pattern = styleProps?.strokePattern ?? 'solid';\n\n  return DASH_ARRAYS[pattern] || null;\n}\n\n/**\n * Get hover-enhanced line width\n */\nexport function getHoverLineWidth(\n  feature: StyledFeature,\n  isHovered: boolean,\n): number {\n  const baseWidth = getLineWidth(feature);\n  return isHovered ? baseWidth + HOVER_WIDTH_INCREASE : baseWidth;\n}\n\n/**\n * Get selection highlight color\n * Returns the default highlight color or allows custom opacity override\n */\nexport function getHighlightColor(\n  opacity?: number,\n): [number, number, number, number] {\n  const rgba = normalizeColor(DEFAULT_COLORS.highlight);\n\n  if (opacity !== undefined) {\n    return [rgba[0], rgba[1], rgba[2], Math.round(opacity * 255)];\n  }\n\n  return rgba;\n}\n\n/**\n * Get highlight line width (base width + increase)\n */\nexport function getHighlightLineWidth(feature: StyledFeature): number {\n  const baseWidth = getLineWidth(feature);\n  return baseWidth + HIGHLIGHT_WIDTH_INCREASE;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,aACd,SACA,mBAAmB,OACZ;CAKP,MAAM,OAAO,gBAJM,QAAQ,YAAY,kBACb,aAAa,eAAe,KAGpB;AAElC,KAAI,iBAEF,QAAO;EAAC,KAAK;EAAI,KAAK;EAAI,KAAK;EAAI,KAAK,MAAM,KAAK,KAAK,kBAAkB;EAAC;AAG7E,QAAO;;;;;;;;;AAUT,SAAgB,eAAe,SAA+B;AAI5D,QAAO,gBAHY,QAAQ,YAAY,kBACb,eAAe,eAAe,OAE5B;;;;;;AAO9B,SAAS,eAAe,OAAgD;AACtE,KAAI,iBAAiB,cAAc,iBAAiB,kBAClD,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;AAIvE,QAAO;EAAC,MAAM;EAAI,MAAM;EAAI,MAAM;EAAI,MAAM,MAAM;EAAI;;;;;AAMxD,SAAgB,aAAa,SAAgC;AAE3D,SADmB,QAAQ,YAAY,kBACpB,eAAe;;;;;AAMpC,MAAa,iBAAiB;;;;AAK9B,SAAgB,aAAa,SAAiD;AAI5E,QAAO,aAHY,QAAQ,YAAY,kBACX,iBAAiB,YAEd;;;;;AAMjC,SAAgB,kBACd,SACA,WACQ;CACR,MAAM,YAAY,aAAa,QAAQ;AACvC,QAAO,YAAY,YAAY,uBAAuB;;;;;;AAOxD,SAAgB,kBACd,SACkC;CAClC,MAAM,OAAO,eAAe,eAAe,UAAU;AAErD,KAAI,YAAY,OACd,QAAO;EAAC,KAAK;EAAI,KAAK;EAAI,KAAK;EAAI,KAAK,MAAM,UAAU,IAAI;EAAC;AAG/D,QAAO;;;;;AAMT,SAAgB,sBAAsB,SAAgC;AAEpE,QADkB,aAAa,QAAQ,GACpB"}
+{"version":3,"file":"display-style.js","names":[],"sources":["../../../../../src/deckgl/shapes/display-shape-layer/utils/display-style.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport {\n  DEFAULT_COLORS,\n  HIGHLIGHT_WIDTH_INCREASE,\n  HOVER_WIDTH_INCREASE,\n} from '../../shared/constants';\nimport { getLineWidth, normalizeColor } from '../../shared/utils/style-utils';\nimport type { StyledFeature } from '../../shared/types';\n\n/**\n * Get hover-enhanced border/outline width\n */\nexport function getHoverLineWidth(\n  feature: StyledFeature,\n  isHovered: boolean,\n): number {\n  const baseWidth = getLineWidth(feature);\n  return isHovered ? baseWidth + HOVER_WIDTH_INCREASE : baseWidth;\n}\n\n/**\n * Get selection highlight color\n * Returns the default highlight color or allows custom opacity override\n */\nexport function getHighlightColor(\n  opacity?: number,\n): [number, number, number, number] {\n  const rgba = normalizeColor(DEFAULT_COLORS.highlight);\n\n  if (opacity !== undefined) {\n    return [rgba[0], rgba[1], rgba[2], Math.round(opacity * 255)];\n  }\n\n  return rgba;\n}\n\n/**\n * Get highlight border/outline width (base width + increase)\n */\nexport function getHighlightLineWidth(feature: StyledFeature): number {\n  const baseWidth = getLineWidth(feature);\n  return baseWidth + HIGHLIGHT_WIDTH_INCREASE;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,kBACd,SACA,WACQ;CACR,MAAM,YAAY,aAAa,QAAQ;AACvC,QAAO,YAAY,YAAY,uBAAuB;;;;;;AAOxD,SAAgB,kBACd,SACkC;CAClC,MAAM,OAAO,eAAe,eAAe,UAAU;AAErD,KAAI,YAAY,OACd,QAAO;EAAC,KAAK;EAAI,KAAK;EAAI,KAAK;EAAI,KAAK,MAAM,UAAU,IAAI;EAAC;AAG/D,QAAO;;;;;AAMT,SAAgB,sBAAsB,SAAgC;AAEpE,QADkB,aAAa,QAAQ,GACpB"}

package/dist/deckgl/shapes/display-shape-layer/utils/labels.d.ts

@@ -10,7 +10,7 @@
  * governing permissions and limitations under the License.
  */
 
-import { EditableShape } from "../../shared/types.js";
+import "../../shared/types.js";
 
 //#region src/deckgl/shapes/display-shape-layer/utils/labels.d.ts
 /**
@@ -26,38 +26,6 @@ interface LabelPosition2d {
   /** Pixel offset from coordinates [x, y] */
   pixelOffset: [number, number];
 }
-/**
- * Calculate a point along a line segment
- * @param start - Start coordinate [lon, lat]
- * @param end - End coordinate [lon, lat]
- * @param ratio - Position along segment (0 = start, 0.5 = middle, 1 = end)
- * @returns Interpolated coordinate [lon, lat]
- *
- * @example
- * // Get a point 25% along a line segment
- * const start: [number, number] = [-122.4, 37.8];
- * const end: [number, number] = [-122.3, 37.9];
- * const point = interpolatePoint(start, end, 0.25);
- */
-declare function interpolatePoint(start: [number, number], end: [number, number], ratio: number): [number, number];
-/**
- * Get the midpoint of a LineString
- * @param coordinates - LineString coordinates array
- * @returns Midpoint coordinate [lon, lat]
- */
-declare function getLineStringMidpoint(coordinates: [number, number][]): [number, number];
-/**
- * Get the end point of a LineString
- * @param coordinates - LineString coordinates array
- * @returns End coordinate [lon, lat]
- */
-declare function getLineStringEndpoint(coordinates: [number, number][]): [number, number];
-/**
- * Get the midpoint of a Polygon's outer ring
- * @param coordinates - Polygon coordinates array (rings)
- * @returns Midpoint of outer ring [lon, lat]
- */
-declare function getPolygonMidpoint(coordinates: [number, number][][]): [number, number];
 /**
  * Vertical label position relative to anchor point
  */
@@ -160,37 +128,6 @@ interface LabelPositionOptions {
   /** Pixel offset for Circle labels [x, y] @default [0, 10] */
   circleLabelOffset?: [number, number];
 }
-/**
- * Get 2D position for label based on geometry type
- * Uses pixel-based offsets for consistent positioning at all zoom levels
- *
- * Priority for positioning:
- * 1. Per-shape properties in styleProperties (highest)
- * 2. Global labelOptions from layer props
- * 3. Default values (fallback)
- *
- * Returns null if no valid coordinates can be determined
- */
-declare function getLabelPosition2d(shape: EditableShape, options?: LabelPositionOptions): LabelPosition2d | null;
-/**
- * Get label text for a shape
- *
- * Returns the display label for the shape on the map in uppercase.
- * - `label`: Optional short display name shown on the map (e.g., "NYC")
- * - `name`: Full shape name used internally (e.g., "New York City Office")
- *
- * If `label` is not provided, falls back to using `name`.
- * Text is automatically converted to uppercase for display.
- */
-declare function getLabelText(shape: EditableShape): string;
-/**
- * Get label background color (uses RGB from shape fill color with fixed label opacity)
- */
-declare function getLabelFillColor(shape: EditableShape): [number, number, number, number];
-/**
- * Get label border color (uses RGB from shape stroke color with full opacity)
- */
-declare function getLabelBorderColor(shape: EditableShape): [number, number, number, number];
 //#endregion
-export { CardinalLabelCoordinateAnchor, LabelHorizontalPosition, LabelPosition2d, LabelPositionOptions, LabelVerticalPosition, getLabelBorderColor, getLabelFillColor, getLabelPosition2d, getLabelText, getLineStringEndpoint, getLineStringMidpoint, getPolygonMidpoint, interpolatePoint };
+export { CardinalLabelCoordinateAnchor, LabelHorizontalPosition, LabelPosition2d, LabelPositionOptions, LabelVerticalPosition };
 //# sourceMappingURL=labels.d.ts.map

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

@@ -13,7 +13,7 @@
 
 'use client';
 
-import { LABEL_BACKGROUND_OPACITY, LABEL_BORDER_OPACITY } from "../../shared/constants.js";
+import { isCircleShape } from "../../shared/types.js";
 
 //#region src/deckgl/shapes/display-shape-layer/utils/labels.ts
 /**
@@ -59,90 +59,6 @@ import { LABEL_BACKGROUND_OPACITY, LABEL_BORDER_OPACITY } from "../../shared/con
 * ```
 */
 /**
-* Calculate a point along a line segment
-* @param start - Start coordinate [lon, lat]
-* @param end - End coordinate [lon, lat]
-* @param ratio - Position along segment (0 = start, 0.5 = middle, 1 = end)
-* @returns Interpolated coordinate [lon, lat]
-*
-* @example
-* // Get a point 25% along a line segment
-* const start: [number, number] = [-122.4, 37.8];
-* const end: [number, number] = [-122.3, 37.9];
-* const point = interpolatePoint(start, end, 0.25);
-*/
-function interpolatePoint(start, end, ratio) {
-	const clampedRatio = Math.max(0, Math.min(1, ratio));
-	return [start[0] + (end[0] - start[0]) * clampedRatio, start[1] + (end[1] - start[1]) * clampedRatio];
-}
-/**
-* Calculate segment lengths for a line
-*/
-function calculateSegmentLengths(coordinates) {
-	let total = 0;
-	const lengths = [];
-	for (let i = 0; i < coordinates.length - 1; i++) {
-		const start = coordinates[i];
-		const end = coordinates[i + 1];
-		if (start && end) {
-			const length = Math.sqrt((end[0] - start[0]) ** 2 + (end[1] - start[1]) ** 2);
-			lengths.push(length);
-			total += length;
-		}
-	}
-	return {
-		lengths,
-		total
-	};
-}
-/**
-* Find point at specific distance along line
-*/
-function findPointAtDistance(coordinates, segmentLengths, targetDistance) {
-	let accumulatedLength = 0;
-	for (let i = 0; i < segmentLengths.length; i++) {
-		const segmentLength = segmentLengths[i];
-		if (!segmentLength) continue;
-		if (accumulatedLength + segmentLength >= targetDistance) {
-			const start = coordinates[i];
-			const end = coordinates[i + 1];
-			if (start && end) return interpolatePoint(start, end, (targetDistance - accumulatedLength) / segmentLength);
-		}
-		accumulatedLength += segmentLength;
-	}
-	return coordinates[coordinates.length - 1] ?? [0, 0];
-}
-/**
-* Get the midpoint of a LineString
-* @param coordinates - LineString coordinates array
-* @returns Midpoint coordinate [lon, lat]
-*/
-function getLineStringMidpoint(coordinates) {
-	if (coordinates.length === 0) return [0, 0];
-	if (coordinates.length === 1) return coordinates[0] ?? [0, 0];
-	const { lengths, total } = calculateSegmentLengths(coordinates);
-	return findPointAtDistance(coordinates, lengths, total / 2);
-}
-/**
-* Get the end point of a LineString
-* @param coordinates - LineString coordinates array
-* @returns End coordinate [lon, lat]
-*/
-function getLineStringEndpoint(coordinates) {
-	if (coordinates.length === 0) return [0, 0];
-	return coordinates[coordinates.length - 1] ?? [0, 0];
-}
-/**
-* Get the midpoint of a Polygon's outer ring
-* @param coordinates - Polygon coordinates array (rings)
-* @returns Midpoint of outer ring [lon, lat]
-*/
-function getPolygonMidpoint(coordinates) {
-	const outerRing = coordinates[0];
-	if (!outerRing || outerRing.length === 0) return [0, 0];
-	return getLineStringMidpoint(outerRing);
-}
-/**
 * Convert vertical/horizontal position to deck.gl textAnchor and alignmentBaseline
 */
 function convertPositionToAnchors(vertical, horizontal) {
@@ -277,7 +193,7 @@ function getCirclePosition(ring, shapeOffset, shapeVertical, shapeHorizontal, sh
 */
 function getPolygonPosition(geometry, shape, shapeOffset, shapeVertical, shapeHorizontal, shapeCoordinateAnchor, options) {
 	const ring = geometry.coordinates[0];
-	if (shape.shapeType === "Circle") return getCirclePosition(ring, shapeOffset, shapeVertical, shapeHorizontal, shapeCoordinateAnchor, options);
+	if (isCircleShape(shape)) return getCirclePosition(ring, shapeOffset, shapeVertical, shapeHorizontal, shapeCoordinateAnchor, options);
 	const defaultOffset = [0, 10];
 	const defaultVertical = "top";
 	const defaultHorizontal = "center";
@@ -328,41 +244,7 @@ function getLabelPosition2d(shape, options) {
 function getLabelText(shape) {
 	return (shape.label || shape.name).toUpperCase();
 }
-/**
-* Get label background color (uses RGB from shape fill color with fixed label opacity)
-*/
-function getLabelFillColor(shape) {
-	const fillColor = (shape.feature.properties?.styleProperties)?.fillColor ?? [
-		98,
-		166,
-		255,
-		255
-	];
-	return [
-		fillColor[0] ?? 98,
-		fillColor[1] ?? 166,
-		fillColor[2] ?? 255,
-		LABEL_BACKGROUND_OPACITY
-	];
-}
-/**
-* Get label border color (uses RGB from shape stroke color with full opacity)
-*/
-function getLabelBorderColor(shape) {
-	const strokeColor = (shape.feature.properties?.styleProperties)?.strokeColor ?? [
-		98,
-		166,
-		255,
-		255
-	];
-	return [
-		strokeColor[0] ?? 98,
-		strokeColor[1] ?? 166,
-		strokeColor[2] ?? 255,
-		LABEL_BORDER_OPACITY
-	];
-}
 
 //#endregion
-export { getLabelBorderColor, getLabelFillColor, getLabelPosition2d, getLabelText, getLineStringEndpoint, getLineStringMidpoint, getPolygonMidpoint, interpolatePoint };
+export { getLabelPosition2d, getLabelText };
 //# sourceMappingURL=labels.js.map