@accelint/map-toolkit 1.5.0 → 3.0.0

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,14 @@
  */
 
 
-'use client';
-
-import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
+import { DEFAULT_DISTANCE_UNITS } from "../../../../shared/units.js";
 import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
+import { DISTANCE_UNIT_BY_SYMBOL } from "@accelint/constants/units";
 
 //#region src/deckgl/shapes/shared/utils/layer-config.ts
+let cachedSymbol;
+let cachedProps;
+let hasCache = false;
 /**
 * Returns default props for EditableGeoJsonLayer configuration.
 *
@@ -25,8 +27,8 @@ import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../con
 * - Mode configuration with distance units
 * - 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
+* @param unitSymbol - Optional unit symbol (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.
+* @returns Default props to spread onto EditableGeoJsonLayer.
 *
 * @example
 * ```tsx
@@ -36,13 +38,17 @@ import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../con
 * />
 * ```
 */
-function getDefaultEditableLayerProps(unitAbbrev) {
-	return {
+function getDefaultEditableLayerProps(unitSymbol) {
+	if (hasCache && cachedSymbol === unitSymbol && cachedProps) return cachedProps;
+	hasCache = true;
+	cachedSymbol = unitSymbol;
+	cachedProps = {
 		getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,
 		getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,
-		modeConfig: { distanceUnits: unitAbbrev ? getDistanceUnitFromAbbreviation(unitAbbrev) ?? DEFAULT_DISTANCE_UNITS : DEFAULT_DISTANCE_UNITS },
+		modeConfig: { distanceUnits: unitSymbol ? DISTANCE_UNIT_BY_SYMBOL[unitSymbol] ?? 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":["cachedSymbol: DistanceUnitSymbol | undefined","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 { DISTANCE_UNIT_BY_SYMBOL } from '@accelint/constants/units';\nimport { DEFAULT_DISTANCE_UNITS } from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type {\n  DistanceUnit,\n  DistanceUnitSymbol,\n} from '@accelint/constants/units';\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 cachedSymbol: DistanceUnitSymbol | undefined;\nlet cachedProps: EditableLayerDefaultProps | undefined;\nlet hasCache = false;\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 unitSymbol - Optional unit symbol (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  unitSymbol?: DistanceUnitSymbol,\n): EditableLayerDefaultProps {\n  if (hasCache && cachedSymbol === unitSymbol && cachedProps) {\n    return cachedProps;\n  }\n\n  hasCache = true;\n  cachedSymbol = unitSymbol;\n  cachedProps = {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitSymbol\n        ? (DISTANCE_UNIT_BY_SYMBOL[unitSymbol] ?? 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;AACJ,IAAIC;AACJ,IAAI,WAAW;;;;;;;;;;;;;;;;;;;;AAqBf,SAAgB,6BACd,YAC2B;AAC3B,KAAI,YAAY,iBAAiB,cAAc,YAC7C,QAAO;AAGT,YAAW;AACX,gBAAe;AACf,eAAc;EACZ,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,wBAAwB,eAAe,yBACxC,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

package/dist/deckgl/shapes/shared/utils/style-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 { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_LINE_WIDTH } from "../constants.js";
 
 //#region src/deckgl/shapes/shared/utils/style-utils.ts
@@ -20,45 +18,44 @@ import { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_LINE_WIDTH } fr
 * 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]
+* ```
 */
 function normalizeColor(color) {
-	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) return [
+	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray || Array.isArray(color) && color.length >= 3) return [
 		color[0] ?? 0,
 		color[1] ?? 0,
 		color[2] ?? 0,
 		color[3] ?? 255
 	];
-	if (!Array.isArray(color) || color.length < 3) return [
+	return [
 		0,
 		0,
 		0,
 		255
 	];
-	return [
-		color[0] ?? 0,
-		color[1] ?? 0,
-		color[2] ?? 0,
-		color[3] ?? 255
-	];
 }
 /**
 * 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)
+* ```
 */
 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)
-	];
+	const rgba = normalizeColor(feature.properties.styleProperties?.fillColor ?? DEFAULT_COLORS.fill);
+	if (applyBaseOpacity) rgba[3] = Math.round(rgba[3] * BASE_FILL_OPACITY);
 	return rgba;
 }
 /**
@@ -68,11 +65,15 @@ function getFillColor(feature, applyBaseOpacity = false) {
 * 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)
+* ```
 */
 function getLineColor(feature) {
-	return normalizeColor((feature.properties?.styleProperties)?.lineColor ?? DEFAULT_COLORS.line);
+	return normalizeColor(feature.properties.styleProperties?.lineColor ?? DEFAULT_COLORS.line);
 }
 /**
 * Get border/outline width for a feature.
@@ -80,20 +81,30 @@ function getLineColor(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)
+* ```
 */
 function getLineWidth(feature) {
-	return (feature.properties?.styleProperties)?.lineWidth ?? DEFAULT_LINE_WIDTH;
+	return feature.properties.styleProperties?.lineWidth ?? DEFAULT_LINE_WIDTH;
 }
 /**
 * 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]
+* ```
 */
 function getDashArray(feature) {
-	return DASH_ARRAYS[(feature.properties?.styleProperties)?.linePattern ?? "solid"] || null;
+	return DASH_ARRAYS[feature.properties.styleProperties?.linePattern ?? "solid"] ?? null;
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"style-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/style-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 {\n  BASE_FILL_OPACITY,\n  DASH_ARRAYS,\n  DEFAULT_COLORS,\n  DEFAULT_LINE_WIDTH,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { StyledFeature } from '../types';\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 *\n * @param color - The color to normalize\n * @returns 4-element RGBA array [r, g, b, a]\n */\nexport function 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  // Validate array has at least 3 elements for RGB\n  if (!Array.isArray(color) || color.length < 3) {\n    return [0, 0, 0, 255]; // Fallback to opaque black\n  }\n  return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n}\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.2)\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 border/outline color for a feature.\n * Outlines are always rendered at their literal alpha value.\n *\n * Named to match deck.gl's `getLineColor` accessor convention.\n * Reads from `lineColor` in the feature's style properties.\n *\n * @param feature - The styled feature\n * @returns RGBA color array\n */\nexport function getLineColor(feature: StyledFeature): Color {\n  const styleProps = feature.properties?.styleProperties;\n  const color = styleProps?.lineColor ?? DEFAULT_COLORS.line;\n\n  return normalizeColor(color);\n}\n\n/**\n * Get border/outline width for a feature.\n *\n * Named to match deck.gl's `getLineWidth` accessor convention.\n * Reads from `lineWidth` in the feature's style properties.\n *\n * @param feature - The styled feature\n * @returns Border/outline width in pixels\n */\nexport function getLineWidth(feature: StyledFeature): number {\n  const styleProps = feature.properties?.styleProperties;\n  return styleProps?.lineWidth ?? DEFAULT_LINE_WIDTH;\n}\n\n/**\n * Get dash array for border/outline pattern.\n *\n * @param feature - The styled feature\n * @returns Dash array [dash, gap] or null for solid outlines\n */\nexport function getDashArray(feature: StyledFeature): [number, number] | null {\n  const styleProps = feature.properties?.styleProperties;\n  const pattern = styleProps?.linePattern ?? 'solid';\n\n  return DASH_ARRAYS[pattern] || null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,eAAe,OAAgD;AAC7E,KAAI,iBAAiB,cAAc,iBAAiB,kBAClD,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;AAKvE,KAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS,EAC1C,QAAO;EAAC;EAAG;EAAG;EAAG;EAAI;AAEvB,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;;;;;;;;;;AAWvE,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;;;;;;;;;;;;AAaT,SAAgB,aAAa,SAA+B;AAI1D,QAAO,gBAHY,QAAQ,YAAY,kBACb,aAAa,eAAe,KAE1B;;;;;;;;;;;AAY9B,SAAgB,aAAa,SAAgC;AAE3D,SADmB,QAAQ,YAAY,kBACpB,aAAa;;;;;;;;AASlC,SAAgB,aAAa,SAAiD;AAI5E,QAAO,aAHY,QAAQ,YAAY,kBACX,eAAe,YAEZ"}
+{"version":3,"file":"style-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/style-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 {\n  BASE_FILL_OPACITY,\n  DASH_ARRAYS,\n  DEFAULT_COLORS,\n  DEFAULT_LINE_WIDTH,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { StyledFeature } from '../types';\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 *\n * @param color - The color to normalize.\n * @returns 4-element RGBA array [r, g, b, a].\n * @example\n * ```typescript\n * normalizeColor([255, 128, 0]);        // → [255, 128, 0, 255]\n * normalizeColor([255, 128, 0, 200]);   // → [255, 128, 0, 200]\n * ```\n */\nexport function normalizeColor(color: Color): [number, number, number, number] {\n  if (\n    color instanceof Uint8Array ||\n    color instanceof Uint8ClampedArray ||\n    (Array.isArray(color) && color.length >= 3)\n  ) {\n    return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n  }\n\n  return [0, 0, 0, 255]; // Fallback to opaque black for malformed input\n}\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.2).\n * @returns RGBA color array.\n * @example\n * ```typescript\n * getFillColor(feature);        // → [255, 255, 255, 255]  (full opacity)\n * getFillColor(feature, true);  // → [255, 255, 255, 51]   (255 × 0.2)\n * ```\n */\nexport function getFillColor(\n  feature: StyledFeature,\n  applyBaseOpacity = false,\n): [number, number, number, number] {\n  const color =\n    feature.properties.styleProperties?.fillColor ?? DEFAULT_COLORS.fill;\n\n  const rgba = normalizeColor(color);\n\n  if (applyBaseOpacity) {\n    rgba[3] = Math.round(rgba[3] * BASE_FILL_OPACITY);\n  }\n\n  return rgba;\n}\n\n/**\n * Get border/outline color for a feature.\n * Outlines are always rendered at their literal alpha value.\n *\n * Named to match deck.gl's `getLineColor` accessor convention.\n * Reads from `lineColor` in the feature's style properties.\n *\n * @param feature - The styled feature.\n * @returns RGBA color array.\n * @example\n * ```typescript\n * getLineColor(feature); // → [136, 138, 143, 255]  (default line color)\n * ```\n */\nexport function getLineColor(\n  feature: StyledFeature,\n): [number, number, number, number] {\n  const color =\n    feature.properties.styleProperties?.lineColor ?? DEFAULT_COLORS.line;\n\n  return normalizeColor(color);\n}\n\n/**\n * Get border/outline width for a feature.\n *\n * Named to match deck.gl's `getLineWidth` accessor convention.\n * Reads from `lineWidth` in the feature's style properties.\n *\n * @param feature - The styled feature.\n * @returns Border/outline width in pixels.\n * @example\n * ```typescript\n * getLineWidth(feature); // → 2  (default width)\n * ```\n */\nexport function getLineWidth(feature: StyledFeature): number {\n  return feature.properties.styleProperties?.lineWidth ?? DEFAULT_LINE_WIDTH;\n}\n\n/**\n * Get dash array for border/outline pattern.\n *\n * @param feature - The styled feature.\n * @returns Dash array [dash, gap] or null for solid outlines.\n * @example\n * ```typescript\n * getDashArray(solidFeature);   // → null\n * getDashArray(dashedFeature);  // → [8, 4]\n * getDashArray(dottedFeature);  // → [2, 4]\n * ```\n */\nexport function getDashArray(feature: StyledFeature): [number, number] | null {\n  const pattern = feature.properties.styleProperties?.linePattern ?? 'solid';\n\n  return DASH_ARRAYS[pattern] ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,eAAe,OAAgD;AAC7E,KACE,iBAAiB,cACjB,iBAAiB,qBAChB,MAAM,QAAQ,MAAM,IAAI,MAAM,UAAU,EAEzC,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;AAGvE,QAAO;EAAC;EAAG;EAAG;EAAG;EAAI;;;;;;;;;;;;;;;AAgBvB,SAAgB,aACd,SACA,mBAAmB,OACe;CAIlC,MAAM,OAAO,eAFX,QAAQ,WAAW,iBAAiB,aAAa,eAAe,KAEhC;AAElC,KAAI,iBACF,MAAK,KAAK,KAAK,MAAM,KAAK,KAAK,kBAAkB;AAGnD,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,aACd,SACkC;AAIlC,QAAO,eAFL,QAAQ,WAAW,iBAAiB,aAAa,eAAe,KAEtC;;;;;;;;;;;;;;;AAgB9B,SAAgB,aAAa,SAAgC;AAC3D,QAAO,QAAQ,WAAW,iBAAiB,aAAa;;;;;;;;;;;;;;AAe1D,SAAgB,aAAa,SAAiD;AAG5E,QAAO,YAFS,QAAQ,WAAW,iBAAiB,eAAe,YAEpC"}

package/dist/deckgl/symbol-layer/fiber.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
@@ -10,6 +10,8 @@
  * governing permissions and limitations under the License.
  */
 
+import { CoffinCornerExtensionProps } from "../extensions/coffin-corner/types.js";
+import "../extensions/index.js";
 import { SymbolLayerProps } from "./index.js";
 
 //#region src/deckgl/symbol-layer/fiber.d.ts
@@ -35,7 +37,7 @@ declare global {
          * />
          * ```
          */
-        symbolLayer: SymbolLayerProps;
+        symbolLayer: CoffinCornerExtensionProps<SymbolLayerProps>;
       }
     }
   }

package/dist/deckgl/symbol-layer/fiber.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

package/dist/deckgl/symbol-layer/fiber.js.map

@@ -1 +1 @@
-{"version":3,"file":"fiber.js","names":[],"sources":["../../../src/deckgl/symbol-layer/fiber.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 { extend } from '@deckgl-fiber-renderer/dom';\nimport { SymbolLayer, type SymbolLayerProps } from './index';\n\nextend({ SymbolLayer });\n\ndeclare global {\n  namespace React {\n    // biome-ignore lint/style/useNamingConvention: Built-in React namespace.\n    namespace JSX {\n      interface IntrinsicElements {\n        /**\n         * A Deck.gl Fiber layer for rendering MIL-STD-2525 and APP-6 military symbols.\n         *\n         * Automatically generates symbol icons from SIDC codes with support for\n         * multiple symbology standards and customizable rendering options.\n         *\n         * @example\n         * ```tsx\n         * <symbolLayer\n         *   id=\"military-units\"\n         *   data={units}\n         *   getSidc={d => d.sidc}\n         *   getPosition={d => d.position}\n         *   getSize={32}\n         *   defaultSymbolOptions={{ colorMode: 'Dark' }}\n         * />\n         * ```\n         */\n        symbolLayer: SymbolLayerProps;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAeA,OAAO,EAAE,aAAa,CAAC"}
+{"version":3,"file":"fiber.js","names":[],"sources":["../../../src/deckgl/symbol-layer/fiber.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 { extend } from '@deckgl-fiber-renderer/dom';\nimport { SymbolLayer, type SymbolLayerProps } from './index';\nimport type { CoffinCornerExtensionProps } from '../extensions';\n\nextend({ SymbolLayer });\n\ndeclare global {\n  namespace React {\n    // biome-ignore lint/style/useNamingConvention: Built-in React namespace.\n    namespace JSX {\n      interface IntrinsicElements {\n        /**\n         * A Deck.gl Fiber layer for rendering MIL-STD-2525 and APP-6 military symbols.\n         *\n         * Automatically generates symbol icons from SIDC codes with support for\n         * multiple symbology standards and customizable rendering options.\n         *\n         * @example\n         * ```tsx\n         * <symbolLayer\n         *   id=\"military-units\"\n         *   data={units}\n         *   getSidc={d => d.sidc}\n         *   getPosition={d => d.position}\n         *   getSize={32}\n         *   defaultSymbolOptions={{ colorMode: 'Dark' }}\n         * />\n         * ```\n         */\n        symbolLayer: CoffinCornerExtensionProps<SymbolLayerProps>;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,OAAO,EAAE,aAAa,CAAC"}

package/dist/deckgl/symbol-layer/index.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

package/dist/deckgl/symbol-layer/index.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