@accelint/map-toolkit 0.5.0 → 1.0.0

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

@@ -0,0 +1,113 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+import { MapModeEvents } from "../../../../map-mode/events.js";
+import { MapCursorEvents } from "../../../../map-cursor/events.js";
+import { cursorStore } from "../../../../map-cursor/store.js";
+import { Broadcast } from "@accelint/bus";
+
+//#region src/deckgl/shapes/shared/utils/mode-utils.ts
+/**
+* Typed event bus instances for mode and cursor communication.
+*/
+const mapModeBus = Broadcast.getInstance();
+const mapCursorBus = Broadcast.getInstance();
+/**
+* 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
+*/
+function requestModeChange(mapId, desiredMode, owner) {
+	mapModeBus.emit(MapModeEvents.changeRequest, {
+		desiredMode,
+		owner,
+		id: mapId
+	});
+}
+/**
+* Release mode back to default.
+*
+* 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
+*/
+function releaseMode(mapId, owner) {
+	requestModeChange(mapId, "default", 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
+*/
+function requestCursorChange(mapId, cursor, owner) {
+	mapCursorBus.emit(MapCursorEvents.changeRequest, {
+		cursor,
+		owner,
+		id: mapId
+	});
+}
+/**
+* Release cursor back to default.
+*
+* 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
+*/
+function releaseCursor(mapId, owner) {
+	cursorStore.actions(mapId).clearCursor(owner);
+}
+/**
+* Request both mode and cursor changes together.
+*
+* The cursor is stored for registered mode owners even if the mode change
+* 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
+*/
+function requestModeAndCursor(mapId, desiredMode, cursor, owner) {
+	requestModeChange(mapId, desiredMode, owner);
+	requestCursorChange(mapId, cursor, owner);
+}
+/**
+* Release both mode and cursor back to defaults.
+*
+* Common pattern when ending an operation.
+*
+* @param mapId - The map instance ID
+* @param owner - The identifier of the component releasing mode and cursor
+*/
+function releaseModeAndCursor(mapId, owner) {
+	releaseMode(mapId, owner);
+	releaseCursor(mapId, owner);
+}
+
+//#endregion
+export { releaseModeAndCursor, requestCursorChange, requestModeAndCursor, requestModeChange };
+//# sourceMappingURL=mode-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mode-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/mode-utils.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 { 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"}

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

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+//#region src/deckgl/shapes/shared/utils/pick-filtering.ts
+/**
+* Filters picks to only include valid geometry elements.
+*
+* This prevents TypeError from sublayer elements that don't have geometry
+* 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.
+*
+* @param picks - The picks array from a pointer event
+* @returns Object containing filtered picks and whether filtering occurred
+*
+* @example
+* ```ts
+* const picks = props.lastPointerMoveEvent?.picks;
+* if (picks && picks.length > 0) {
+*   const { filteredPicks, didFilter } = filterGeometryAwarePicks(picks);
+*   if (didFilter) {
+*     // Use filteredPicks in modified props
+*   }
+* }
+* ```
+*/
+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;
+	}
+	return {
+		filteredPicks,
+		didFilter
+	};
+}
+
+//#endregion
+export { filterGeometryAwarePicks };
+//# sourceMappingURL=pick-filtering.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pick-filtering.js","names":["filteredPicks: T[]"],"sources":["../../../../../src/deckgl/shapes/shared/utils/pick-filtering.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\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 * ```ts\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"}

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

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { StyledFeature } from "../types.js";
+import { Color } from "@deck.gl/core";
+
+//#region src/deckgl/shapes/shared/utils/style-utils.d.ts
+/**
+ * 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]
+ */
+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
+ */
+declare function getFillColor(feature: StyledFeature, applyBaseOpacity?: boolean): Color;
+/**
+ * Get border/outline color for a feature.
+ * Outlines are always rendered at their literal alpha value.
+ *
+ * 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
+ */
+declare function getLineColor(feature: StyledFeature): Color;
+/**
+ * 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
+ */
+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
+ */
+declare function getDashArray(feature: StyledFeature): [number, number] | null;
+//#endregion
+export { getDashArray, getFillColor, getLineColor, getLineWidth, normalizeColor };
+//# sourceMappingURL=style-utils.d.ts.map

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

@@ -0,0 +1,101 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'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
+/**
+* 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]
+*/
+function normalizeColor(color) {
+	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) return [
+		color[0] ?? 0,
+		color[1] ?? 0,
+		color[2] ?? 0,
+		color[3] ?? 255
+	];
+	if (!Array.isArray(color) || color.length < 3) 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
+*/
+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 border/outline color for a feature.
+* Outlines are always rendered at their literal alpha value.
+*
+* 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
+*/
+function getLineColor(feature) {
+	return normalizeColor((feature.properties?.styleProperties)?.lineColor ?? DEFAULT_COLORS.line);
+}
+/**
+* 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
+*/
+function getLineWidth(feature) {
+	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
+*/
+function getDashArray(feature) {
+	return DASH_ARRAYS[(feature.properties?.styleProperties)?.linePattern ?? "solid"] || null;
+}
+
+//#endregion
+export { getDashArray, getFillColor, getLineColor, getLineWidth, normalizeColor };
+//# sourceMappingURL=style-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/style-utils.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_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"}

package/dist/deckgl/symbol-layer/index.d.ts

@@ -10,9 +10,9 @@
  * governing permissions and limitations under the License.
  */
 
+import { AccessorContext, AccessorFunction, DefaultProps } from "@deck.gl/core";
 import { IconLayer, IconLayerProps } from "@deck.gl/layers";
 import { SymbolOptions } from "milsymbol";
-import { AccessorContext, AccessorFunction, DefaultProps } from "@deck.gl/core";
 
 //#region src/deckgl/symbol-layer/index.d.ts
 type _SymbolLayerProps<TData = unknown> = {

package/dist/deckgl/text-layer/default-settings.js

@@ -11,35 +11,15 @@
  */
 
 
+import { DEFAULT_TEXT_STYLE } from "../text-settings.js";
+
 //#region src/deckgl/text-layer/default-settings.ts
 const defaultSettings = {
+	...DEFAULT_TEXT_STYLE,
 	fontFamily: "system-ui, sans-serif",
-	fontSettings: {
-		fontSize: 22,
-		sdf: true,
-		buffer: 10,
-		cutoff: .19,
-		radius: 10,
-		smoothing: .1
-	},
-	fontWeight: 500,
 	getAlignmentBaseline: "center",
-	getColor: [
-		255,
-		255,
-		255,
-		255
-	],
-	getSize: 12,
 	getTextAnchor: "middle",
-	lineHeight: 1,
-	outlineColor: [
-		0,
-		0,
-		0,
-		255
-	],
-	outlineWidth: 2
+	lineHeight: 1
 };
 
 //#endregion

package/dist/deckgl/text-layer/default-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-settings.js","names":["defaultSettings: Partial<DglTextLayerProps>"],"sources":["../../../src/deckgl/text-layer/default-settings.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { Color } from '@deck.gl/core';\nimport type { TextLayerProps as DglTextLayerProps } from '@deck.gl/layers';\n\nexport const defaultSettings: Partial<DglTextLayerProps> = {\n  fontFamily: 'system-ui, sans-serif',\n  fontSettings: {\n    fontSize: 22,\n    sdf: true,\n    buffer: 10,\n    cutoff: 0.19,\n    radius: 10,\n    smoothing: 0.1,\n  },\n  fontWeight: 500,\n  getAlignmentBaseline: 'center',\n  getColor: [255, 255, 255, 255] as Color,\n  getSize: 12,\n  getTextAnchor: 'middle',\n  lineHeight: 1,\n  outlineColor: [0, 0, 0, 255] as Color,\n  outlineWidth: 2,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAaA,kBAA8C;CACzD,YAAY;CACZ,cAAc;EACZ,UAAU;EACV,KAAK;EACL,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,WAAW;EACZ;CACD,YAAY;CACZ,sBAAsB;CACtB,UAAU;EAAC;EAAK;EAAK;EAAK;EAAI;CAC9B,SAAS;CACT,eAAe;CACf,YAAY;CACZ,cAAc;EAAC;EAAG;EAAG;EAAG;EAAI;CAC5B,cAAc;CACf"}
+{"version":3,"file":"default-settings.js","names":["defaultSettings: Partial<DglTextLayerProps>"],"sources":["../../../src/deckgl/text-layer/default-settings.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { DEFAULT_TEXT_STYLE } from '../text-settings';\nimport type { TextLayerProps as DglTextLayerProps } from '@deck.gl/layers';\n\nexport const defaultSettings: Partial<DglTextLayerProps> = {\n  ...DEFAULT_TEXT_STYLE,\n  fontFamily: 'system-ui, sans-serif',\n  getAlignmentBaseline: 'center',\n  getTextAnchor: 'middle',\n  lineHeight: 1,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAaA,kBAA8C;CACzD,GAAG;CACH,YAAY;CACZ,sBAAsB;CACtB,eAAe;CACf,YAAY;CACb"}

package/dist/deckgl/text-settings.d.ts

@@ -0,0 +1,77 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { Color } from "@deck.gl/core";
+import { TextLayerProps } from "@deck.gl/layers";
+
+//#region src/deckgl/text-settings.d.ts
+/**
+ * Shared font settings for SDF (Signed Distance Field) text rendering.
+ *
+ * These settings are optimized for cross-platform legibility, particularly
+ * on Windows machines where text can appear thin/hard to read without
+ * proper SDF configuration.
+ *
+ * Used by:
+ * - TextLayer component
+ * - Shape label layers
+ * - Draw/edit mode tooltips
+ */
+declare const SDF_FONT_SETTINGS: NonNullable<TextLayerProps['fontSettings']>;
+/**
+ * Default text size in pixels for deck.gl TextLayer.
+ * Works in conjunction with SDF_FONT_SETTINGS for proper rendering.
+ */
+declare const DEFAULT_TEXT_SIZE = 12;
+/**
+ * Default text color (white) for deck.gl TextLayer.
+ */
+declare const DEFAULT_TEXT_COLOR: Color;
+/**
+ * Default text outline color (black) for deck.gl TextLayer.
+ */
+declare const DEFAULT_TEXT_OUTLINE_COLOR: Color;
+/**
+ * Default text outline width in pixels for deck.gl TextLayer.
+ */
+declare const DEFAULT_TEXT_OUTLINE_WIDTH = 2;
+/**
+ * Default font weight for deck.gl TextLayer.
+ */
+declare const DEFAULT_FONT_WEIGHT = 500;
+/**
+ * Combined default text style settings for deck.gl TextLayer.
+ * Spread this object into TextLayer props for consistent cross-platform rendering.
+ *
+ * Includes: fontSettings, fontWeight, getSize, getColor, outlineWidth, outlineColor
+ */
+declare const DEFAULT_TEXT_STYLE: {
+  fontSettings: {
+    fontFamily?: string;
+    fontWeight?: string | number;
+    characterSet?: Set<string> | string[] | string;
+    fontSize?: number;
+    buffer?: number;
+    sdf?: boolean;
+    cutoff?: number;
+    radius?: number;
+    smoothing?: number;
+  };
+  fontWeight: number;
+  getSize: number;
+  getColor: [number, number, number, number];
+  outlineWidth: number;
+  outlineColor: [number, number, number, number];
+};
+//#endregion
+export { DEFAULT_FONT_WEIGHT, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_OUTLINE_COLOR, DEFAULT_TEXT_OUTLINE_WIDTH, DEFAULT_TEXT_SIZE, DEFAULT_TEXT_STYLE, SDF_FONT_SETTINGS };
+//# sourceMappingURL=text-settings.d.ts.map

package/dist/deckgl/text-settings.js

@@ -0,0 +1,83 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/deckgl/text-settings.ts
+/**
+* Shared font settings for SDF (Signed Distance Field) text rendering.
+*
+* These settings are optimized for cross-platform legibility, particularly
+* on Windows machines where text can appear thin/hard to read without
+* proper SDF configuration.
+*
+* Used by:
+* - TextLayer component
+* - Shape label layers
+* - Draw/edit mode tooltips
+*/
+const SDF_FONT_SETTINGS = {
+	fontSize: 22,
+	sdf: true,
+	buffer: 10,
+	cutoff: .19,
+	radius: 10,
+	smoothing: .1
+};
+/**
+* Default text size in pixels for deck.gl TextLayer.
+* Works in conjunction with SDF_FONT_SETTINGS for proper rendering.
+*/
+const DEFAULT_TEXT_SIZE = 12;
+/**
+* Default text color (white) for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_COLOR = [
+	255,
+	255,
+	255,
+	255
+];
+/**
+* Default text outline color (black) for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_OUTLINE_COLOR = [
+	0,
+	0,
+	0,
+	255
+];
+/**
+* Default text outline width in pixels for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_OUTLINE_WIDTH = 2;
+/**
+* Default font weight for deck.gl TextLayer.
+*/
+const DEFAULT_FONT_WEIGHT = 500;
+/**
+* Combined default text style settings for deck.gl TextLayer.
+* Spread this object into TextLayer props for consistent cross-platform rendering.
+*
+* Includes: fontSettings, fontWeight, getSize, getColor, outlineWidth, outlineColor
+*/
+const DEFAULT_TEXT_STYLE = {
+	fontSettings: { ...SDF_FONT_SETTINGS },
+	fontWeight: DEFAULT_FONT_WEIGHT,
+	getSize: DEFAULT_TEXT_SIZE,
+	getColor: DEFAULT_TEXT_COLOR,
+	outlineWidth: DEFAULT_TEXT_OUTLINE_WIDTH,
+	outlineColor: DEFAULT_TEXT_OUTLINE_COLOR
+};
+
+//#endregion
+export { DEFAULT_FONT_WEIGHT, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_OUTLINE_COLOR, DEFAULT_TEXT_OUTLINE_WIDTH, DEFAULT_TEXT_SIZE, DEFAULT_TEXT_STYLE, SDF_FONT_SETTINGS };
+//# sourceMappingURL=text-settings.js.map

package/dist/deckgl/text-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-settings.js","names":["SDF_FONT_SETTINGS: NonNullable<TextLayerProps['fontSettings']>","DEFAULT_TEXT_COLOR: Color","DEFAULT_TEXT_OUTLINE_COLOR: Color"],"sources":["../../src/deckgl/text-settings.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { Color } from '@deck.gl/core';\nimport type { TextLayerProps } from '@deck.gl/layers';\n\n/**\n * Shared font settings for SDF (Signed Distance Field) text rendering.\n *\n * These settings are optimized for cross-platform legibility, particularly\n * on Windows machines where text can appear thin/hard to read without\n * proper SDF configuration.\n *\n * Used by:\n * - TextLayer component\n * - Shape label layers\n * - Draw/edit mode tooltips\n */\nexport const SDF_FONT_SETTINGS: NonNullable<TextLayerProps['fontSettings']> = {\n  fontSize: 22,\n  sdf: true,\n  buffer: 10,\n  cutoff: 0.19,\n  radius: 10,\n  smoothing: 0.1,\n};\n\n/**\n * Default text size in pixels for deck.gl TextLayer.\n * Works in conjunction with SDF_FONT_SETTINGS for proper rendering.\n */\nexport const DEFAULT_TEXT_SIZE = 12;\n\n/**\n * Default text color (white) for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_COLOR: Color = [255, 255, 255, 255];\n\n/**\n * Default text outline color (black) for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_OUTLINE_COLOR: Color = [0, 0, 0, 255];\n\n/**\n * Default text outline width in pixels for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_OUTLINE_WIDTH = 2;\n\n/**\n * Default font weight for deck.gl TextLayer.\n */\nexport const DEFAULT_FONT_WEIGHT = 500;\n\n/**\n * Combined default text style settings for deck.gl TextLayer.\n * Spread this object into TextLayer props for consistent cross-platform rendering.\n *\n * Includes: fontSettings, fontWeight, getSize, getColor, outlineWidth, outlineColor\n */\nexport const DEFAULT_TEXT_STYLE = {\n  fontSettings: { ...SDF_FONT_SETTINGS },\n  fontWeight: DEFAULT_FONT_WEIGHT,\n  getSize: DEFAULT_TEXT_SIZE,\n  getColor: DEFAULT_TEXT_COLOR,\n  outlineWidth: DEFAULT_TEXT_OUTLINE_WIDTH,\n  outlineColor: DEFAULT_TEXT_OUTLINE_COLOR,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAaA,oBAAiE;CAC5E,UAAU;CACV,KAAK;CACL,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACZ;;;;;AAMD,MAAa,oBAAoB;;;;AAKjC,MAAaC,qBAA4B;CAAC;CAAK;CAAK;CAAK;CAAI;;;;AAK7D,MAAaC,6BAAoC;CAAC;CAAG;CAAG;CAAG;CAAI;;;;AAK/D,MAAa,6BAA6B;;;;AAK1C,MAAa,sBAAsB;;;;;;;AAQnC,MAAa,qBAAqB;CAChC,cAAc,EAAE,GAAG,mBAAmB;CACtC,YAAY;CACZ,SAAS;CACT,UAAU;CACV,cAAc;CACd,cAAc;CACf"}

package/dist/map-cursor/index.d.ts

@@ -12,6 +12,6 @@
 
 import { MapCursorEvents } from "./events.js";
 import { CSSCursorType, CursorChangeRequestEvent, CursorChangedEvent, CursorRejectedEvent, MapCursorEventType } from "./types.js";
-import { destroyStore, getOrCreateStore } from "./store.js";
+import { clearCursorState, cursorStore, getCursor } from "./store.js";
 import { UseMapCursorReturn, useMapCursor, useMapCursorEffect } from "./use-map-cursor.js";
-export { type CSSCursorType, type CursorChangeRequestEvent, type CursorChangedEvent, type CursorRejectedEvent, type MapCursorEventType, MapCursorEvents, type UseMapCursorReturn, destroyStore, getOrCreateStore, useMapCursor, useMapCursorEffect };
+export { type CSSCursorType, type CursorChangeRequestEvent, type CursorChangedEvent, type CursorRejectedEvent, type MapCursorEventType, MapCursorEvents, type UseMapCursorReturn, clearCursorState, cursorStore, getCursor, useMapCursor, useMapCursorEffect };

package/dist/map-cursor/index.js

@@ -12,7 +12,7 @@
 
 
 import { MapCursorEvents } from "./events.js";
-import { destroyStore, getOrCreateStore } from "./store.js";
+import { clearCursorState, cursorStore, getCursor } from "./store.js";
 import { useMapCursor, useMapCursorEffect } from "./use-map-cursor.js";
 
-export { MapCursorEvents, destroyStore, getOrCreateStore, useMapCursor, useMapCursorEffect };
+export { MapCursorEvents, clearCursorState, cursorStore, getCursor, useMapCursor, useMapCursorEffect };