@accelint/design-toolkit 7.0.1 → 8.0.0

package/dist/components/combobox-field/styles.module.css

@@ -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.
+ */
+
+@reference '../../index.module.css';
+
+@layer components.l1 {
+  .field {
+    @apply gap-xs flex flex-col;
+  }
+
+  .control {
+    @apply rounded-medium px-s py-xs fg-primary-bold outline-interactive flex items-center outline;
+
+    @variant placeholder {
+      @apply fg-primary-muted;
+    }
+
+    @variant hover {
+      @apply outline-interactive-hover;
+    }
+
+    @variant focus-visible {
+      @apply outline-interactive-hover;
+    }
+
+    @variant focus-within {
+      @apply outline-accent-primary-bold;
+    }
+
+    @variant pressed {
+      @apply outline-interactive-pressed;
+    }
+
+    @variant group-size-medium/combobox-field {
+      @apply max-w-[400px] min-w-[160px];
+    }
+
+    @variant group-size-small/combobox-field {
+      @apply max-w-[200px] min-w-[80px];
+    }
+
+    @variant group-invalid/combobox-field {
+      @apply outline-serious-bold;
+    }
+
+    @variant group-disabled/combobox-field {
+      @apply fg-disabled outline-interactive-disabled;
+    }
+  }
+
+  .input {
+    @apply font-display grow outline-none;
+
+    @variant group-size-medium/combobox-field {
+      @apply text-body-s;
+    }
+
+    @variant group-size-small/combobox-field {
+      @apply text-body-xs;
+    }
+  }
+
+  .trigger {
+    @apply fg-primary-bold;
+
+    @variant group-open/combobox-field {
+      @apply rotate-180 transform;
+    }
+
+    @variant group-disabled/combobox-field {
+      @apply fg-disabled;
+    }
+  }
+
+  .description {
+    @apply fg-primary-muted text-body-xs;
+
+    @variant group-disabled/combobox-field {
+      @apply fg-disabled;
+    }
+  }
+
+  .error {
+    @apply fg-serious-bold text-body-xs;
+  }
+
+  .popover {
+    --trigger-width: initial; /* is inlined by react aria components on render */
+    @apply -ml-s;
+    min-width: calc(var(--trigger-width) + (var(--spacing-s) * 2));
+  }
+}

package/dist/components/combobox-field/types.d.ts

@@ -2,10 +2,7 @@ import { RefAttributes } from 'react';
 import { ComboBoxProps, VirtualizerProps, ListLayoutOptions, LabelProps, InputProps, FieldErrorProps, PopoverProps } from 'react-aria-components';
 import { ButtonProps } from '../button/types.js';
 import { OptionsDataItem, OptionsProps } from '../options/types.js';
-import 'tailwind-variants';
 import '../../lib/types.js';
-import '../button/styles.js';
-import 'tailwind-merge';
 import '../icon/types.js';
 
 type ComboBoxFieldProps<T extends OptionsDataItem> = Omit<ComboBoxProps<T>, 'children' | 'className'> & Pick<VirtualizerProps<ListLayoutOptions>, 'layoutOptions'> & Pick<OptionsProps<T>, 'children'> & RefAttributes<HTMLDivElement> & {

package/dist/components/coordinate-field/context.d.ts

@@ -0,0 +1,77 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ContextValue } from 'react-aria-components';
+import { ProviderProps } from '../../lib/types.js';
+import { CoordinateFieldProps, CoordinateFieldState } from './types.js';
+
+/**
+ * CoordinateField Context Architecture
+ *
+ * This file defines two separate contexts following the React Aria component pattern:
+ *
+ * 1. CoordinateFieldContext (Props Context):
+ *    - Contains user-provided props for the component
+ *    - Used for React Aria's context-based prop merging
+ *    - Part of the public composition API
+ *
+ * 2. CoordinateFieldStateContext (State Context):
+ *    - Contains derived/computed runtime state
+ *    - Used to share state with child components (e.g., CoordinateSegment)
+ *    - Primarily for internal use
+
+ * Separation keeps the public API (props) distinct from internal
+ * implementation details (state), improving maintainability and composition.
+ */
+/**
+ * Props Context for CoordinateField component.
+ *
+ * Contains user-provided props (label, format, size, value, onChange, etc.)
+ * and is used by React Aria's useContextProps hook for context-based prop merging.
+ * This enables parent components to provide default props to nested CoordinateField
+ * components, supporting composition patterns.
+ *
+ * Part of the public API - external consumers can use this for component composition.
+ *
+ * @see CoordinateFieldStateContext for internal runtime state
+ */
+declare const CoordinateFieldContext: react.Context<ContextValue<CoordinateFieldProps, HTMLDivElement>>;
+/**
+ * State Context for CoordinateField component.
+ *
+ * Contains derived/computed runtime state (segmentValues, currentValue,
+ * validationErrors, registerTimeout, etc.) that is shared with child components
+ * like CoordinateSegment. This avoids prop drilling for deeply nested children.
+ *
+ * This follows the React Aria pattern of separating props context (public API)
+ * from state context (internal implementation). While exported for composition
+ * scenarios and testing, this is primarily for internal use.
+ *
+ * @see CoordinateFieldContext for user-provided props
+ * @example
+ * // Used internally by child components
+ * const state = useCoordinateFieldStateContext();
+ * const { segmentValues, isDisabled, registerTimeout } = state;
+ */
+declare const CoordinateFieldStateContext: react.Context<CoordinateFieldState | null>;
+/**
+ * Provider component for CoordinateField context
+ * Wraps children with CoordinateFieldContext
+ */
+declare function CoordinateFieldProvider({ children, ...props }: ProviderProps<CoordinateFieldProps>): react_jsx_runtime.JSX.Element;
+/**
+ * Provider component for CoordinateField state context
+ * Wraps children with CoordinateFieldStateContext
+ */
+declare function CoordinateFieldStateProvider({ children, value, }: {
+    children: React.ReactNode;
+    value: CoordinateFieldState;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access CoordinateField state context
+ * Must be used within a CoordinateField component
+ * @throws {Error} If used outside of CoordinateField
+ * @returns {CoordinateFieldState} The coordinate field state
+ */
+declare const useCoordinateFieldStateContext: () => CoordinateFieldState;
+
+export { CoordinateFieldContext, CoordinateFieldProvider, CoordinateFieldStateContext, CoordinateFieldStateProvider, useCoordinateFieldStateContext };

package/dist/components/coordinate-field/context.js

@@ -0,0 +1,2 @@
+import {jsx}from'react/jsx-runtime';import {createContext,useContext}from'react';const d=createContext(null),r=createContext(null);function l({children:e,...t}){return jsx(d.Provider,{value:t,children:e})}function C({children:e,value:t}){return jsx(r.Provider,{value:t,children:e})}const p=()=>{const e=useContext(r);if(!e)throw new Error("useCoordinateFieldStateContext must be used within CoordinateField");return e};export{d as CoordinateFieldContext,l as CoordinateFieldProvider,r as CoordinateFieldStateContext,C as CoordinateFieldStateProvider,p as useCoordinateFieldStateContext};//# sourceMappingURL=context.js.map
+//# sourceMappingURL=context.js.map

package/dist/components/coordinate-field/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/coordinate-field/context.tsx"],"names":["CoordinateFieldContext","createContext","CoordinateFieldStateContext","CoordinateFieldProvider","children","props","jsx","CoordinateFieldStateProvider","value","useCoordinateFieldStateContext","context","useContext"],"mappings":"iFAkDO,MAAMA,EACXC,aAAAA,CAAkE,IAAI,CAAA,CAmB3DC,CAAAA,CACXD,cAA2C,IAAI,EAM1C,SAASE,CAAAA,CAAwB,CACtC,QAAA,CAAAC,CAAAA,CACA,GAAGC,CACL,EAAwC,CACtC,OACEC,GAAAA,CAACN,CAAAA,CAAuB,SAAvB,CAAgC,KAAA,CAAOK,CAAAA,CACrC,QAAA,CAAAD,EACH,CAEJ,CAMO,SAASG,CAAAA,CAA6B,CAC3C,QAAA,CAAAH,CAAAA,CACA,KAAA,CAAAI,CACF,EAGG,CACD,OACEF,GAAAA,CAACJ,CAAAA,CAA4B,SAA5B,CAAqC,KAAA,CAAOM,CAAAA,CAC1C,QAAA,CAAAJ,EACH,CAEJ,CAQO,MAAMK,CAAAA,CAAiC,IAAM,CAClD,MAAMC,CAAAA,CAAUC,UAAAA,CAAWT,CAA2B,CAAA,CACtD,GAAI,CAACQ,CAAAA,CACH,MAAM,IAAI,KAAA,CACR,oEACF,CAAA,CAEF,OAAOA,CACT","file":"context.js","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 { createContext, useContext } from 'react';\nimport type { ContextValue } from 'react-aria-components';\nimport type { ProviderProps } from '@/lib/types';\nimport type { CoordinateFieldProps, CoordinateFieldState } from './types';\n\n/**\n * CoordinateField Context Architecture\n *\n * This file defines two separate contexts following the React Aria component pattern:\n *\n * 1. CoordinateFieldContext (Props Context):\n *    - Contains user-provided props for the component\n *    - Used for React Aria's context-based prop merging\n *    - Part of the public composition API\n *\n * 2. CoordinateFieldStateContext (State Context):\n *    - Contains derived/computed runtime state\n *    - Used to share state with child components (e.g., CoordinateSegment)\n *    - Primarily for internal use\n\n * Separation keeps the public API (props) distinct from internal\n * implementation details (state), improving maintainability and composition.\n */\n\n/**\n * Props Context for CoordinateField component.\n *\n * Contains user-provided props (label, format, size, value, onChange, etc.)\n * and is used by React Aria's useContextProps hook for context-based prop merging.\n * This enables parent components to provide default props to nested CoordinateField\n * components, supporting composition patterns.\n *\n * Part of the public API - external consumers can use this for component composition.\n *\n * @see CoordinateFieldStateContext for internal runtime state\n */\nexport const CoordinateFieldContext =\n  createContext<ContextValue<CoordinateFieldProps, HTMLDivElement>>(null);\n\n/**\n * State Context for CoordinateField component.\n *\n * Contains derived/computed runtime state (segmentValues, currentValue,\n * validationErrors, registerTimeout, etc.) that is shared with child components\n * like CoordinateSegment. This avoids prop drilling for deeply nested children.\n *\n * This follows the React Aria pattern of separating props context (public API)\n * from state context (internal implementation). While exported for composition\n * scenarios and testing, this is primarily for internal use.\n *\n * @see CoordinateFieldContext for user-provided props\n * @example\n * // Used internally by child components\n * const state = useCoordinateFieldStateContext();\n * const { segmentValues, isDisabled, registerTimeout } = state;\n */\nexport const CoordinateFieldStateContext =\n  createContext<CoordinateFieldState | null>(null);\n\n/**\n * Provider component for CoordinateField context\n * Wraps children with CoordinateFieldContext\n */\nexport function CoordinateFieldProvider({\n  children,\n  ...props\n}: ProviderProps<CoordinateFieldProps>) {\n  return (\n    <CoordinateFieldContext.Provider value={props}>\n      {children}\n    </CoordinateFieldContext.Provider>\n  );\n}\n\n/**\n * Provider component for CoordinateField state context\n * Wraps children with CoordinateFieldStateContext\n */\nexport function CoordinateFieldStateProvider({\n  children,\n  value,\n}: {\n  children: React.ReactNode;\n  value: CoordinateFieldState;\n}) {\n  return (\n    <CoordinateFieldStateContext.Provider value={value}>\n      {children}\n    </CoordinateFieldStateContext.Provider>\n  );\n}\n\n/**\n * Hook to access CoordinateField state context\n * Must be used within a CoordinateField component\n * @throws {Error} If used outside of CoordinateField\n * @returns {CoordinateFieldState} The coordinate field state\n */\nexport const useCoordinateFieldStateContext = () => {\n  const context = useContext(CoordinateFieldStateContext);\n  if (!context) {\n    throw new Error(\n      'useCoordinateFieldStateContext must be used within CoordinateField',\n    );\n  }\n  return context;\n};\n"]}

package/dist/components/coordinate-field/coordinate-utils.d.ts

@@ -0,0 +1,282 @@
+import { CoordinateValue, CoordinateSystem, ParsedCoordinateMatch } from './types.js';
+import 'react';
+import 'react-aria-components';
+
+/** Epsilon for coordinate equality comparison (≈11cm precision at equator) */
+declare const COORDINATE_EPSILON = 0.000001;
+/**
+ * Error message constants for coordinate format conversion
+ * @internal
+ */
+declare const COORDINATE_ERROR_MESSAGES: {
+    readonly INVALID: "Invalid coordinate";
+    readonly CONVERSION_FAILED: "Conversion failed";
+    readonly NOT_AVAILABLE_AT_POLES: "Not available at poles";
+};
+/**
+ * Result of coordinate format conversion
+ */
+interface CoordinateFormatResult {
+    /** The formatted coordinate string or error message */
+    value: string;
+    /** Whether the coordinate format is valid and can be used/copied */
+    isValid: boolean;
+}
+/**
+ * Format segment values into a coordinate string suitable for @accelint/geo parsing
+ *
+ * Converts an array of segment values into a string format that the geo package
+ * parsers can understand. Each format has different requirements:
+ *
+ * DD: [lat, lon] → "lat, lon"
+ * DDM: [latDeg, latMin, latDir, lonDeg, lonMin, lonDir] → "latDeg° latMin' latDir, lonDeg° lonMin' lonDir"
+ * DMS: [latDeg, latMin, latSec, latDir, lonDeg, lonMin, lonSec, lonDir] → "latDeg° latMin' latSec\" latDir, lonDeg° lonMin' lonSec\" lonDir"
+ * MGRS: [zone, band, grid, easting, northing] → "zone+band grid easting northing"
+ * UTM: [zone, hemisphere, easting, northing] → "zone+hemisphere easting northing"
+ *
+ * @param segments - Array of segment values from user input
+ * @param format - The coordinate system format
+ * @returns Formatted coordinate string, or null if segments are invalid
+ */
+declare function formatSegmentsToCoordinateString(segments: string[], format: CoordinateSystem): string | null;
+/**
+ * Parse a coordinate string into segment values
+ *
+ * Converts a formatted coordinate string (from @accelint/geo output or user input)
+ * back into individual segment values for display.
+ *
+ * This is the inverse of formatSegmentsToCoordinateString.
+ *
+ * **Note on Duplication**: This function and its helpers (parseDDCoordinateString,
+ * parseDDMCoordinateString, etc.) duplicate parsing logic that already exists in
+ * the @accelint/geo package parsers:
+ *
+ * - Geo parsers: parseDecimalDegrees, parseDegreesDecimalMinutes, etc.
+ * - These functions: parseDDCoordinateString, parseDDMCoordinateString, etc.
+ *
+ * Both use regex patterns to extract coordinate components from strings. The duplication
+ * exists because:
+ *
+ * 1. **Geo parsers** extract components, validate them, convert to DD, then format back to strings
+ * 2. **This function** extracts components from those formatted strings for the UI
+ *
+ * We're essentially undoing the formatting that geo just did. This is the second half
+ * of the circular conversion described in convertDDToDisplaySegments.
+ *
+ * **Why we can't use geo parsers directly**: The geo parsers return coord objects with
+ * only `coord.raw` (DD numbers) and formatting methods. They don't expose the parsed
+ * segment components we need for the UI (e.g., the degrees, minutes, and direction values).
+ *
+ * **Parsing Order**:
+ * - **convertDisplaySegmentsToDD**: Segments → String → **Geo parse** → DD ✓ (efficient)
+ * - **convertDDToDisplaySegments**: DD → String → Geo parse → Geo format → **This parse** → Segments ✗ (circular)
+ *
+ * @param coordString - Formatted coordinate string
+ * @param format - The coordinate system format
+ * @returns Array of segment values, or null if parsing fails
+ */
+declare function parseCoordinateStringToSegments(coordString: string, format: CoordinateSystem): string[] | null;
+/**
+ * Convert DD (internal format) to display format segment values
+ *
+ * Takes a CoordinateValue in Decimal Degrees format and converts it to the
+ * segment values needed for the specified display format.
+ *
+ * Uses @accelint/geo to ensure accurate conversion between coordinate systems.
+ *
+ * **Note on Circular Conversion**: This function demonstrates the circular conversion
+ * pattern discussed in the module documentation. The flow is:
+ *
+ * 1. Start with DD value: `{ lat: 40.7128, lon: -74.0060 }`
+ * 2. Convert to coordinate string: `"40.7128 / -74.006"`
+ * 3. Parse with geo package (creates coord object with internal parsed state)
+ * 4. Format to target system using geo: `coord.ddm()` → `"40 42.768 N / 74 0.36 W"`
+ * 5. Parse the formatted string AGAIN with regex to extract segments: `['40', '42.768', 'N', ...]`
+ *
+ * This is inefficient because:
+ * - The geo package already has the component values (degrees, minutes, direction) internally
+ * - We format them into a string, then immediately parse the string back apart
+ * - The regex parsing duplicates work the geo parsers already did
+ *
+ * However, this approach is necessary because:
+ * - The geo package only exposes `coord.raw` (DD numbers) and formatted strings
+ * - It doesn't expose the intermediate component values we need for the UI segments
+ * - We need individual segment values for separate input fields
+ *
+ * **Future Improvement**: If geo package exported component extractors like:
+ * ```typescript
+ * coord.components.ddm // { latDeg: 40, latMin: 42.768, latDir: 'N', ... }
+ * ```
+ * Then we could eliminate the format→parse cycle entirely.
+ *
+ * @param value - Coordinate value in DD format `{ lat: number, lon: number }`
+ * @param format - Target display format
+ * @returns Array of segment values for display, or null if conversion fails
+ *
+ * @example
+ * const segments = convertDDToDisplaySegments({ lat: 40.7128, lon: -74.0060 }, 'ddm');
+ * // Returns: ['40', '42.7680', 'N', '74', '0.3600', 'W']
+ */
+declare function convertDDToDisplaySegments(value: CoordinateValue, format: CoordinateSystem): string[] | null;
+/**
+ * Convert display format segment values to DD (internal format)
+ *
+ * Takes segment values from user input and converts them to a CoordinateValue
+ * in Decimal Degrees format using @accelint/geo for validation and conversion.
+ *
+ * **Note on Efficiency**: This function demonstrates the EFFICIENT conversion direction.
+ * The flow is:
+ *
+ * 1. Start with UI segments: `['40', '42.768', 'N', '74', '0.36', 'W']`
+ * 2. Build coordinate string: `"40° 42.768' N, 74° 0.36' W"`
+ * 3. Parse with geo package (validates and converts internally)
+ * 4. Extract DD from coord.raw: `{ lat: 40.7128, lon: -74.0060 }`
+ *
+ * This is efficient because:
+ * - We let geo do what it's designed for: parsing and validating coordinate strings
+ * - We extract the DD values directly from `coord.raw` (no string parsing needed)
+ * - Single direction: Segments → String → Geo Parse → DD (no circular conversion)
+ *
+ * Contrast with `convertDDToDisplaySegments` which has the circular pattern:
+ * DD → String → Geo Parse → Geo Format → String → Regex Parse → Segments
+ *
+ * @param segments - Array of segment values from user input
+ * @param format - The coordinate system format of the segments
+ * @returns CoordinateValue in DD format, or null if invalid
+ *
+ * @example
+ * const coord = convertDisplaySegmentsToDD(['40', '42.7680', 'N', '74', '0.3600', 'W'], 'ddm');
+ * // Returns: { lat: 40.7128, lon: -74.0060 }
+ */
+declare function convertDisplaySegmentsToDD(segments: string[], format: CoordinateSystem): CoordinateValue | null;
+/**
+ * Validate coordinate segments and return errors
+ *
+ * Uses @accelint/geo to validate the segments and returns any validation errors.
+ * Only validates when all required segments are filled.
+ *
+ * @param segments - Array of segment values from user input
+ * @param format - The coordinate system format
+ * @returns Array of error messages, empty if valid or incomplete
+ *
+ * @example
+ * const errors = validateCoordinateSegments(['91', '0', 'N', '0', '0', 'E'], 'ddm');
+ * // Returns: ['Invalid coordinate value']
+ */
+declare function validateCoordinateSegments(segments: string[], format: CoordinateSystem): string[];
+/**
+ * Check if all segments are filled
+ *
+ * Helper to determine if the user has completed entering all segment values.
+ * Used to determine when to trigger validation.
+ *
+ * @param segments - Array of segment values
+ * @returns True if all segments have values, false otherwise
+ */
+declare function areAllSegmentsFilled(segments: string[]): boolean;
+/**
+ * Check if any segments have values
+ *
+ * Helper to determine if the user has started entering coordinate values.
+ *
+ * @param segments - Array of segment values
+ * @returns True if any segment has a value, false if all empty
+ */
+declare function hasAnySegmentValue(segments: string[]): boolean;
+/**
+ * Get all coordinate formats for a given DD value
+ *
+ * Converts a Decimal Degrees coordinate to all 5 supported coordinate systems
+ * for display in the format conversion popover.
+ *
+ * Each format is tried independently - if one fails (e.g., UTM/MGRS at poles),
+ * the others can still succeed.
+ *
+ * @param value - Coordinate value in DD format `{ lat: number, lon: number }`
+ * @returns Object containing formatted strings and validity status for all coordinate systems
+ *
+ * @example
+ * const formats = getAllCoordinateFormats({ lat: 40.7128, lon: -74.0060 });
+ * // Returns: {
+ * //   dd: { value: "40.7128 N / 74.006 W", isValid: true },
+ * //   ddm: { value: "40 42.768 N / 74 0.36 W", isValid: true },
+ * //   dms: { value: "40 42 46.08 N / 74 0 21.6 W", isValid: true },
+ * //   mgrs: { value: "18T WL 80654 06346", isValid: true },
+ * //   utm: { value: "18N 585628 4511644", isValid: true }
+ * // }
+ *
+ * @example
+ * const formats = getAllCoordinateFormats({ lat: 90, lon: 0 });
+ * // Returns: {
+ * //   dd: { value: "90 N / 0 E", isValid: true },
+ * //   ddm: { value: "90 0 N / 0 0 E", isValid: true },
+ * //   dms: { value: "90 0 0 N / 0 0 0 E", isValid: true },
+ * //   mgrs: { value: "Not available at poles", isValid: false },
+ * //   utm: { value: "Not available at poles", isValid: false }
+ * // }
+ */
+declare function getAllCoordinateFormats(value: CoordinateValue | null): Record<CoordinateSystem, CoordinateFormatResult>;
+/**
+ * Check if pasted text looks like a complete coordinate string
+ *
+ * Uses heuristics to detect if the pasted text contains a full coordinate
+ * rather than just a single segment value. This prevents intercepting
+ * single-segment pastes.
+ *
+ * Indicators of a complete coordinate:
+ * - Contains separators: comma, slash, or multiple consecutive spaces
+ * - Contains coordinate symbols: °, ′, ″, ', "
+ * - Multiple numbers separated by whitespace
+ *
+ * @param text - The pasted text to check
+ * @returns True if it looks like a complete coordinate string
+ *
+ * @example
+ * isCompleteCoordinate("40.7128, -74.0060") // true - contains comma
+ * isCompleteCoordinate("40° 42' 46\" N / 74° 0' 22\" W") // true - contains symbols
+ * isCompleteCoordinate("18T WM 12345 67890") // true - multiple parts
+ * isCompleteCoordinate("42") // false - single number
+ * isCompleteCoordinate("N") // false - single letter
+ */
+declare function isCompleteCoordinate(text: string): boolean;
+/**
+ * Attempt to parse pasted text as all coordinate formats
+ *
+ * Tries to parse the pasted text using each of the 5 coordinate system parsers.
+ * Returns all formats that successfully parse the text.
+ *
+ * This enables automatic detection of coordinate format and disambiguation
+ * when multiple formats match the same input string.
+ *
+ * @param pastedText - The raw text from clipboard
+ * @returns Array of successfully parsed coordinate matches (may be empty)
+ *
+ * @example
+ * const matches = parseCoordinatePaste("40.7128, -74.0060");
+ * // Returns: [{ format: 'dd', value: { lat: 40.7128, lon: -74.0060 }, displayString: "..." }]
+ *
+ * @example
+ * const matches = parseCoordinatePaste("18T WM 12345 67890");
+ * // Returns: [{ format: 'mgrs', value: { lat: ..., lon: ... }, displayString: "..." }]
+ *
+ * @example
+ * const matches = parseCoordinatePaste("invalid text");
+ * // Returns: []
+ */
+declare function parseCoordinatePaste(pastedText: string): ParsedCoordinateMatch[];
+/**
+ * Check if two coordinates are equal within epsilon tolerance
+ */
+declare function areCoordinatesEqual(coord1: {
+    lat: number;
+    lon: number;
+}, coord2: {
+    lat: number;
+    lon: number;
+}, epsilon?: number): boolean;
+/**
+ * Deduplicate coordinate matches by location, keeping first match for each unique location
+ */
+declare function deduplicateMatchesByLocation(matches: ParsedCoordinateMatch[]): ParsedCoordinateMatch[];
+
+export { COORDINATE_EPSILON, COORDINATE_ERROR_MESSAGES, type CoordinateFormatResult, areAllSegmentsFilled, areCoordinatesEqual, convertDDToDisplaySegments, convertDisplaySegmentsToDD, deduplicateMatchesByLocation, formatSegmentsToCoordinateString, getAllCoordinateFormats, hasAnySegmentValue, isCompleteCoordinate, parseCoordinatePaste, parseCoordinateStringToSegments, validateCoordinateSegments };

package/dist/components/coordinate-field/coordinate-utils.js

@@ -0,0 +1,2 @@
+import {getLogger}from'@accelint/logger';import {createCoordinate,coordinateSystems}from'@accelint/geo';import {COORDINATE_SYSTEMS}from'./types.js';const u=getLogger({enabled:process.env.NODE_ENV!=="production",level:"debug",prefix:"[CoordinateField]",pretty:true});const h=1e-6,l={INVALID:"Invalid coordinate",CONVERSION_FAILED:"Conversion failed",NOT_AVAILABLE_AT_POLES:"Not available at poles"};function S(t){if(t.length<2)return null;const r=Number.parseFloat(t[0]),n=Number.parseFloat(t[1]);if(Number.isNaN(r)||Number.isNaN(n))return null;const e=r>=0?"N":"S",a=n>=0?"E":"W";return `${Math.abs(r)} ${e} / ${Math.abs(n)} ${a}`}function C(t){return t.length<6?null:`${t[0]}\xB0 ${t[1]}' ${t[2]}, ${t[3]}\xB0 ${t[4]}' ${t[5]}`}function p(t){return t.length<8?null:`${t[0]}\xB0 ${t[1]}' ${t[2]}" ${t[3]}, ${t[4]}\xB0 ${t[5]}' ${t[6]}" ${t[7]}`}function N(t){return t.length<5?null:`${t[0]}${t[1]} ${t[2]} ${t[3]} ${t[4]}`}function b(t){return t.length<4?null:`${t[0]}${t[1]} ${t[2]} ${t[3]}`}function f(t,r){if(t.some(n=>n===""||n===void 0))return null;try{switch(r){case "dd":return S(t);case "ddm":return C(t);case "dms":return p(t);case "mgrs":return N(t);case "utm":return b(t);default:return null}}catch{return null}}function y(t){const r=t.match(/([-]?\d+\.?\d*)°?\s*([NS])?\s*[,/\s]+\s*([-]?\d+\.?\d*)°?\s*([EW])?/i);if(!r)return null;let n=r[1],e=r[3];return n&&e?(r[2]?.toUpperCase()==="S"&&!n.startsWith("-")&&(n=`-${n}`),r[4]?.toUpperCase()==="W"&&!e.startsWith("-")&&(e=`-${e}`),[n,e]):null}function D(t){const r=t.match(/(\d+)°?\s+([\d.]+)'?\s+([NS])\s*[,/]\s*(\d+)°?\s+([\d.]+)'?\s+([EW])/i);return r?[r[1],r[2],r[3],r[4],r[5],r[6]]:null}function $(t){const r=t.match(/(\d+)°?\s+(\d+)'?\s+([\d.]+)"?\s+([NS])\s*[,/]\s*(\d+)°?\s+(\d+)'?\s+([\d.]+)"?\s+([EW])/i);return r?[r[1],r[2],r[3],r[4],r[5],r[6],r[7],r[8]]:null}function v(t){const r=t.match(/(\d+)([A-Z])\s+([A-Z]{2})\s+(\d+)\s+(\d+)/i);return r?[r[1],r[2],r[3],r[4],r[5]]:null}function A(t){const r=t.match(/(\d+)\s*([NS])\s+(\d+)\s+(\d+)/i);return r?[r[1],r[2],r[3],r[4]]:null}function V(t,r){if(!t)return null;try{switch(r){case "dd":return y(t);case "ddm":return D(t);case "dms":return $(t);case "mgrs":return v(t);case "utm":return A(t);default:return null}}catch{return null}}function k(t,r){if(!t||typeof t.lat!="number"||typeof t.lon!="number")return null;try{const n=createCoordinate(coordinateSystems.dd,"LATLON"),e=Number(t.lat.toFixed(5)),a=Number(t.lon.toFixed(5)),s=`${e} / ${a}`,i=n(s);if(!i.valid)return null;let o;switch(r){case "dd":o=i.dd();break;case "ddm":o=i.ddm();break;case "dms":o=i.dms();break;case "mgrs":o=i.mgrs();break;case "utm":o=i.utm();break;default:return null}return V(o,r)}catch(n){return u.withContext({value:String(t),format:String(r)}).withError(n).error("Failed to convert DD to display"),null}}function x(t,r){const n=f(t,r);if(!n)return null;try{const a=createCoordinate(coordinateSystems[r],"LATLON")(n);if(!a.valid)return null;const{LAT:s,LON:i}=a.raw;return {lat:s,lon:i}}catch(e){return u.withContext({segments:JSON.stringify(t),format:String(r)}).withError(e).error("Failed to convert display to DD"),null}}function _(t,r){if(t.some(e=>e===""||e===void 0))return [];const n=f(t,r);if(!n)return ["Invalid coordinate value"];try{return createCoordinate(coordinateSystems[r],"LATLON")(n).valid?[]:["Invalid coordinate value"]}catch{return ["Invalid coordinate value"]}}function P(t){return t.every(r=>r!==""&&r!==void 0)}function U(t){return t.some(r=>r!==""&&r!==void 0)}function L(){return {dd:{value:l.INVALID,isValid:false},ddm:{value:l.INVALID,isValid:false},dms:{value:l.INVALID,isValid:false},mgrs:{value:l.INVALID,isValid:false},utm:{value:l.INVALID,isValid:false}}}function E(t){return t!==null&&typeof t.lat=="number"&&typeof t.lon=="number"}function I(t){const r=t instanceof Error?t.message:String(t);return r.includes("outside UTM limits")||r.includes("invalid UTM zone")}function M(t,r,n){try{let e;switch(r){case "dd":e=t.dd();break;case "ddm":e=t.ddm();break;case "dms":e=t.dms();break;case "mgrs":e=t.mgrs();break;case "utm":e=t.utm();break;default:return {value:l.INVALID,isValid:!1}}return {value:e,isValid:!0}}catch(e){return (r==="mgrs"||r==="utm")&&I(e)?{value:l.NOT_AVAILABLE_AT_POLES,isValid:false}:(u.withContext({value:JSON.stringify(n)}).withError(e).error(`Failed to convert to ${r}`),{value:l.CONVERSION_FAILED,isValid:false})}}function W(t){const r=L();if(!E(t))return r;const n=t;try{const a=createCoordinate(coordinateSystems.dd,"LATLON")(`${n.lat} / ${n.lon}`);if(!a.valid)return r;const s={};for(const i of COORDINATE_SYSTEMS)s[i]=M(a,i,n);return s}catch(e){return u.withContext({value:JSON.stringify(n)}).withError(e).error("Failed to get all coordinate formats"),r}}function G(t){if(!t||t.trim()==="")return  false;const r=/[,/]|°|′|″|['"]|\s{2,}/.test(t),e=(t.match(/\d+/g)||[]).length>=2,a=/^\d{1,2}[A-Z]\s+[A-Z]{2}\s+\d+\s+\d+$/i.test(t.trim()),s=/^\d{1,2}[NS]\s+\d+\s+\d+$/i.test(t.trim());return r||e||a||s}function Z(t){if(!t||t.trim()==="")return [];const r=[];for(const n of COORDINATE_SYSTEMS)try{const a=createCoordinate(coordinateSystems[n],"LATLON")(t.trim());if(a.valid){const{LAT:s,LON:i}=a.raw;let o;switch(n){case "dd":o=a.dd();break;case "ddm":o=a.ddm();break;case "dms":o=a.dms();break;case "mgrs":o=a.mgrs();break;case "utm":o=a.utm();break;default:o="";}r.push({format:n,value:{lat:s,lon:i},displayString:o});}}catch(e){u.withContext({pastedText:t.trim(),format:String(n)}).withError(e).warn(`Failed to parse as ${n}`);}return r}function O(t,r,n=h){return Math.abs(t.lat-r.lat)<n&&Math.abs(t.lon-r.lon)<n}function B(t){const r=[];for(const n of t)r.some(a=>O(a.value,n.value))||r.push(n);return r}export{h as COORDINATE_EPSILON,l as COORDINATE_ERROR_MESSAGES,P as areAllSegmentsFilled,O as areCoordinatesEqual,k as convertDDToDisplaySegments,x as convertDisplaySegmentsToDD,B as deduplicateMatchesByLocation,f as formatSegmentsToCoordinateString,W as getAllCoordinateFormats,U as hasAnySegmentValue,G as isCompleteCoordinate,Z as parseCoordinatePaste,V as parseCoordinateStringToSegments,_ as validateCoordinateSegments};//# sourceMappingURL=coordinate-utils.js.map
+//# sourceMappingURL=coordinate-utils.js.map

package/dist/components/coordinate-field/coordinate-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/coordinate-field/coordinate-utils.ts"],"names":["logger","getLogger","segments","lonNum","lonDir","latNum","latDir","format","seg","match","lat","lon","coordString","value","coordinateSystems","c","d","inputCoordString","coord","create","LAT","LON","error","formattedValue","isValidCoordinateValue","validValue","COORDINATE_SYSTEMS","convertToFormat","text","hasMultipleNumbers","isMGRS","isUTM","pastedText","displayString","matches","coord2","epsilon","COORDINATE_EPSILON","coord1","areCoordinatesEqual","existing","uniqueMatches"],"mappings":"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","file":"coordinate-utils.js","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 { getLogger } from '@accelint/logger';\n\nconst logger = getLogger({\n  enabled: process.env.NODE_ENV !== 'production',\n  level: 'debug',\n  prefix: '[CoordinateField]',\n  pretty: true,\n});\n\n/**\n * Coordinate Conversion Utilities\n *\n * This module provides utilities for converting between:\n * 1. Segment values (user input) → Coordinate strings (for @accelint/geo parsing)\n * 2. Coordinate strings (from @accelint/geo output) → Segment values (for display)\n * 3. Decimal Degrees (internal format) ↔ Display format segment values\n *\n * All conversions use the local @accelint/geo package for accurate coordinate parsing\n * and conversion between coordinate systems.\n *\n * ## Architecture: Bridge Layer Between UI and Geo Package\n *\n * This module serves as a bridge layer to handle the impedance mismatch between:\n * - **UI Requirements**: Individual segment fields (e.g., degrees, minutes, seconds, direction)\n * - **Geo Package API**: Complete coordinate strings (e.g., \"40° 42' 46\" N / 74° 0' 22\" W\")\n *\n * ### Why This Bridge Layer Exists\n *\n * The @accelint/geo package provides excellent coordinate parsing, validation, and conversion,\n * but its API is designed around complete coordinate strings:\n *\n * ```typescript\n * // What geo provides:\n * const coord = createCoordinate(coordinateSystems.ddm, 'LATLON')('40 42.768 N / 74 0.36 W');\n * coord.dd()   // Returns: \"40.7128 N / 74.006 W\"  (formatted string)\n * coord.ddm()  // Returns: \"40 42.768 N / 74 0.36 W\" (formatted string)\n * coord.raw    // Returns: { LAT: 40.7128, LON: -74.006 } (only DD numbers)\n * ```\n *\n * The coordinate-field component needs segment-level data for individual input fields:\n * - DDM: ['40', '42.768', 'N', '74', '0.36', 'W'] ← Not provided by geo\n * - DMS: ['40', '42', '46.08', 'N', '74', '0', '21.6', 'W'] ← Not provided by geo\n *\n * ### Current Limitations and Duplication\n *\n * Because the geo package only exposes:\n * 1. **Formatters** that return complete strings (coord.ddm(), coord.dms(), etc.)\n * 2. **Raw values** in Decimal Degrees only (coord.raw)\n *\n * This module must:\n * 1. Build coordinate strings from segments → Pass to geo for parsing\n * 2. Parse geo's formatted output strings → Extract segments using regex\n *\n * This creates a circular conversion flow for DD → Display Segments:\n * ```\n * DD value → String → Geo parse → Geo format → String → Regex parse → Segments\n * ```\n *\n * **Note on Duplication**: The regex parsing in this module duplicates work that the\n * geo package parsers already do internally. However, since geo doesn't expose the\n * parsed segment components (only formatted strings and raw DD values), we must\n * re-parse its output to extract the individual segments for the UI.\n *\n * ### What Would Eliminate This Duplication\n *\n * If the geo package exported component-level converters like:\n * ```typescript\n * // Hypothetical API that would eliminate the bridge layer:\n * export function ddToDdmComponents(dd: number): {\n *   degrees: number;\n *   minutes: number;\n *   direction: 'N' | 'S' | 'E' | 'W';\n * }\n * ```\n *\n * Then this bridge layer could be significantly simplified. The math for these conversions\n * exists in the geo package's formatters (e.g., formatDegreesDecimalMinutes), but it's\n * wrapped in string formatting logic rather than exposed as standalone utilities.\n *\n * ### Conversion Efficiency\n *\n * - **Efficient Path** (Display Segments → DD): Segments → String → Geo parse → DD\n *   - Uses geo package for all parsing and validation ✓\n *\n * - **Inefficient Path** (DD → Display Segments): DD → String → Geo parse → Geo format → Regex parse → Segments\n *   - Circular conversion with redundant string parsing/formatting ✗\n *   - Necessary given current geo API limitations\n */\n\nimport { coordinateSystems, createCoordinate } from '@accelint/geo';\nimport {\n  COORDINATE_SYSTEMS,\n  type CoordinateSystem,\n  type CoordinateValue,\n  type ParsedCoordinateMatch,\n} from './types';\n\n/** Epsilon for coordinate equality comparison (≈11cm precision at equator) */\nexport const COORDINATE_EPSILON = 0.000001;\n\n/**\n * Error message constants for coordinate format conversion\n * @internal\n */\nexport const COORDINATE_ERROR_MESSAGES = {\n  INVALID: 'Invalid coordinate',\n  CONVERSION_FAILED: 'Conversion failed',\n  NOT_AVAILABLE_AT_POLES: 'Not available at poles',\n} as const;\n\n/**\n * Result of coordinate format conversion\n */\nexport interface CoordinateFormatResult {\n  /** The formatted coordinate string or error message */\n  value: string;\n  /** Whether the coordinate format is valid and can be used/copied */\n  isValid: boolean;\n}\n\n/**\n * Format DD (Decimal Degrees) segments to coordinate string\n *\n * Bridge function that builds a coordinate string from UI segment values\n * for passing to the geo package parser. Part of the Segments → String → Geo Parse flow.\n *\n * @internal\n */\nfunction formatDDSegments(segments: string[]): string | null {\n  if (segments.length < 2) {\n    return null;\n  }\n  const latNum = Number.parseFloat(segments[0] as string);\n  const lonNum = Number.parseFloat(segments[1] as string);\n\n  if (Number.isNaN(latNum) || Number.isNaN(lonNum)) {\n    return null;\n  }\n\n  const latDir = latNum >= 0 ? 'N' : 'S';\n  const lonDir = lonNum >= 0 ? 'E' : 'W';\n\n  return `${Math.abs(latNum)} ${latDir} / ${Math.abs(lonNum)} ${lonDir}`;\n}\n\n/**\n * Format DDM (Degrees Decimal Minutes) segments to coordinate string\n *\n * Bridge function that builds a coordinate string from UI segment values\n * for passing to the geo package parser. Part of the Segments → String → Geo Parse flow.\n *\n * @internal\n */\nfunction formatDDMSegments(segments: string[]): string | null {\n  if (segments.length < 6) {\n    return null;\n  }\n  return `${segments[0]}° ${segments[1]}' ${segments[2]}, ${segments[3]}° ${segments[4]}' ${segments[5]}`;\n}\n\n/**\n * Format DMS (Degrees Minutes Seconds) segments to coordinate string\n *\n * Bridge function that builds a coordinate string from UI segment values\n * for passing to the geo package parser. Part of the Segments → String → Geo Parse flow.\n *\n * @internal\n */\nfunction formatDMSSegments(segments: string[]): string | null {\n  if (segments.length < 8) {\n    return null;\n  }\n  return `${segments[0]}° ${segments[1]}' ${segments[2]}\" ${segments[3]}, ${segments[4]}° ${segments[5]}' ${segments[6]}\" ${segments[7]}`;\n}\n\n/**\n * Format MGRS (Military Grid Reference System) segments to coordinate string\n *\n * Bridge function that builds a coordinate string from UI segment values\n * for passing to the geo package parser. Part of the Segments → String → Geo Parse flow.\n *\n * @internal\n */\nfunction formatMGRSSegments(segments: string[]): string | null {\n  if (segments.length < 5) {\n    return null;\n  }\n  return `${segments[0]}${segments[1]} ${segments[2]} ${segments[3]} ${segments[4]}`;\n}\n\n/**\n * Format UTM (Universal Transverse Mercator) segments to coordinate string\n *\n * Bridge function that builds a coordinate string from UI segment values\n * for passing to the geo package parser. Part of the Segments → String → Geo Parse flow.\n *\n * @internal\n */\nfunction formatUTMSegments(segments: string[]): string | null {\n  if (segments.length < 4) {\n    return null;\n  }\n  return `${segments[0]}${segments[1]} ${segments[2]} ${segments[3]}`;\n}\n\n/**\n * Format segment values into a coordinate string suitable for @accelint/geo parsing\n *\n * Converts an array of segment values into a string format that the geo package\n * parsers can understand. Each format has different requirements:\n *\n * DD: [lat, lon] → \"lat, lon\"\n * DDM: [latDeg, latMin, latDir, lonDeg, lonMin, lonDir] → \"latDeg° latMin' latDir, lonDeg° lonMin' lonDir\"\n * DMS: [latDeg, latMin, latSec, latDir, lonDeg, lonMin, lonSec, lonDir] → \"latDeg° latMin' latSec\\\" latDir, lonDeg° lonMin' lonSec\\\" lonDir\"\n * MGRS: [zone, band, grid, easting, northing] → \"zone+band grid easting northing\"\n * UTM: [zone, hemisphere, easting, northing] → \"zone+hemisphere easting northing\"\n *\n * @param segments - Array of segment values from user input\n * @param format - The coordinate system format\n * @returns Formatted coordinate string, or null if segments are invalid\n */\nexport function formatSegmentsToCoordinateString(\n  segments: string[],\n  format: CoordinateSystem,\n): string | null {\n  if (segments.some((seg) => seg === '' || seg === undefined)) {\n    return null;\n  }\n\n  try {\n    switch (format) {\n      case 'dd':\n        return formatDDSegments(segments);\n      case 'ddm':\n        return formatDDMSegments(segments);\n      case 'dms':\n        return formatDMSSegments(segments);\n      case 'mgrs':\n        return formatMGRSSegments(segments);\n      case 'utm':\n        return formatUTMSegments(segments);\n      default:\n        return null;\n    }\n  } catch (_error) {\n    return null;\n  }\n}\n\n/**\n * Parse DD coordinate string to segments\n *\n * Extracts segment values from a formatted DD coordinate string. This duplicates\n * parsing logic from @accelint/geo's parseDecimalDegrees, but is necessary because\n * geo doesn't expose the parsed components - only formatted strings and raw DD numbers.\n *\n * Part of the Geo Format → String → Regex Parse → Segments flow (circular conversion).\n *\n * @internal\n */\nfunction parseDDCoordinateString(coordString: string): string[] | null {\n  // DD formats from @accelint/geo (no degree symbols):\n  // \"40.7128 N / -74.006 W\" or \"0 N / 180 W\"\n  // Also handle user input with symbols:\n  // \"89.765432° N / 123.456789° W\" or \"89.765432, -123.456789\"\n\n  // Match DD format with optional degree symbols and optional direction letters\n  const match = coordString.match(\n    /([-]?\\d+\\.?\\d*)°?\\s*([NS])?\\s*[,/\\s]+\\s*([-]?\\d+\\.?\\d*)°?\\s*([EW])?/i,\n  );\n  if (!match) {\n    return null;\n  }\n\n  let lat = match[1];\n  let lon = match[3];\n\n  if (!(lat && lon)) {\n    return null;\n  }\n\n  if (match[2]?.toUpperCase() === 'S' && !lat.startsWith('-')) {\n    lat = `-${lat}`;\n  }\n  if (match[4]?.toUpperCase() === 'W' && !lon.startsWith('-')) {\n    lon = `-${lon}`;\n  }\n\n  return [lat, lon];\n}\n\n/**\n * Parse DDM coordinate string to segments\n *\n * Extracts segment values from a formatted DDM coordinate string. This duplicates\n * parsing logic from @accelint/geo's parseDegreesDecimalMinutes, but is necessary because\n * geo doesn't expose the parsed components - only formatted strings and raw DD numbers.\n *\n * Part of the Geo Format → String → Regex Parse → Segments flow (circular conversion).\n *\n * @internal\n */\nfunction parseDDMCoordinateString(coordString: string): string[] | null {\n  // DDM formats from @accelint/geo (no symbols):\n  // \"40 42.768 N / 74 0.36 W\"\n  // Also handle user input with symbols:\n  // \"89° 45.9259' N / 123° 27.4073' W\"\n\n  // Match DDM format with optional degree and minute symbols\n  const match = coordString.match(\n    /(\\d+)°?\\s+([\\d.]+)'?\\s+([NS])\\s*[,/]\\s*(\\d+)°?\\s+([\\d.]+)'?\\s+([EW])/i,\n  );\n  if (!match) {\n    return null;\n  }\n  return [\n    match[1] as string,\n    match[2] as string,\n    match[3] as string,\n    match[4] as string,\n    match[5] as string,\n    match[6] as string,\n  ];\n}\n\n/**\n * Parse DMS coordinate string to segments\n *\n * Extracts segment values from a formatted DMS coordinate string. This duplicates\n * parsing logic from @accelint/geo's parseDegreesMinutesSeconds, but is necessary because\n * geo doesn't expose the parsed components - only formatted strings and raw DD numbers.\n *\n * Part of the Geo Format → String → Regex Parse → Segments flow (circular conversion).\n *\n * @internal\n */\nfunction parseDMSCoordinateString(coordString: string): string[] | null {\n  // DMS formats from @accelint/geo (no symbols):\n  // \"40 42 46.08 N / 74 0 21.60 W\"\n  // Also handle user input with symbols:\n  // \"89° 45' 55.56\" N / 123° 27' 24.44\" W\"\n\n  // Match DMS format with optional degree, minute, and second symbols\n  const match = coordString.match(\n    /(\\d+)°?\\s+(\\d+)'?\\s+([\\d.]+)\"?\\s+([NS])\\s*[,/]\\s*(\\d+)°?\\s+(\\d+)'?\\s+([\\d.]+)\"?\\s+([EW])/i,\n  );\n  if (!match) {\n    return null;\n  }\n  return [\n    match[1] as string,\n    match[2] as string,\n    match[3] as string,\n    match[4] as string,\n    match[5] as string,\n    match[6] as string,\n    match[7] as string,\n    match[8] as string,\n  ];\n}\n\n/**\n * Parse MGRS coordinate string to segments\n *\n * Extracts segment values from a formatted MGRS coordinate string. This duplicates\n * parsing logic from @accelint/geo's parseMGRS, but is necessary because\n * geo doesn't expose the parsed components - only formatted strings and raw DD numbers.\n *\n * Part of the Geo Format → String → Regex Parse → Segments flow (circular conversion).\n *\n * @internal\n */\nfunction parseMGRSCoordinateString(coordString: string): string[] | null {\n  // MGRS: \"18T WM 12345 67890\"\n  const match = coordString.match(/(\\d+)([A-Z])\\s+([A-Z]{2})\\s+(\\d+)\\s+(\\d+)/i);\n  if (!match) {\n    return null;\n  }\n  return [\n    match[1] as string,\n    match[2] as string,\n    match[3] as string,\n    match[4] as string,\n    match[5] as string,\n  ];\n}\n\n/**\n * Parse UTM coordinate string to segments\n *\n * Extracts segment values from a formatted UTM coordinate string. This duplicates\n * parsing logic from @accelint/geo's parseUTM, but is necessary because\n * geo doesn't expose the parsed components - only formatted strings and raw DD numbers.\n *\n * Part of the Geo Format → String → Regex Parse → Segments flow (circular conversion).\n *\n * @internal\n */\nfunction parseUTMCoordinateString(coordString: string): string[] | null {\n  // UTM: \"18N 585628 4511644\" or \"18 N 585628 4511644\" (with optional space)\n  const match = coordString.match(/(\\d+)\\s*([NS])\\s+(\\d+)\\s+(\\d+)/i);\n  if (!match) {\n    return null;\n  }\n  return [\n    match[1] as string,\n    match[2] as string,\n    match[3] as string,\n    match[4] as string,\n  ];\n}\n\n/**\n * Parse a coordinate string into segment values\n *\n * Converts a formatted coordinate string (from @accelint/geo output or user input)\n * back into individual segment values for display.\n *\n * This is the inverse of formatSegmentsToCoordinateString.\n *\n * **Note on Duplication**: This function and its helpers (parseDDCoordinateString,\n * parseDDMCoordinateString, etc.) duplicate parsing logic that already exists in\n * the @accelint/geo package parsers:\n *\n * - Geo parsers: parseDecimalDegrees, parseDegreesDecimalMinutes, etc.\n * - These functions: parseDDCoordinateString, parseDDMCoordinateString, etc.\n *\n * Both use regex patterns to extract coordinate components from strings. The duplication\n * exists because:\n *\n * 1. **Geo parsers** extract components, validate them, convert to DD, then format back to strings\n * 2. **This function** extracts components from those formatted strings for the UI\n *\n * We're essentially undoing the formatting that geo just did. This is the second half\n * of the circular conversion described in convertDDToDisplaySegments.\n *\n * **Why we can't use geo parsers directly**: The geo parsers return coord objects with\n * only `coord.raw` (DD numbers) and formatting methods. They don't expose the parsed\n * segment components we need for the UI (e.g., the degrees, minutes, and direction values).\n *\n * **Parsing Order**:\n * - **convertDisplaySegmentsToDD**: Segments → String → **Geo parse** → DD ✓ (efficient)\n * - **convertDDToDisplaySegments**: DD → String → Geo parse → Geo format → **This parse** → Segments ✗ (circular)\n *\n * @param coordString - Formatted coordinate string\n * @param format - The coordinate system format\n * @returns Array of segment values, or null if parsing fails\n */\nexport function parseCoordinateStringToSegments(\n  coordString: string,\n  format: CoordinateSystem,\n): string[] | null {\n  if (!coordString) {\n    return null;\n  }\n\n  try {\n    switch (format) {\n      case 'dd':\n        return parseDDCoordinateString(coordString);\n      case 'ddm':\n        return parseDDMCoordinateString(coordString);\n      case 'dms':\n        return parseDMSCoordinateString(coordString);\n      case 'mgrs':\n        return parseMGRSCoordinateString(coordString);\n      case 'utm':\n        return parseUTMCoordinateString(coordString);\n      default:\n        return null;\n    }\n  } catch (_error) {\n    return null;\n  }\n}\n\n/**\n * Convert DD (internal format) to display format segment values\n *\n * Takes a CoordinateValue in Decimal Degrees format and converts it to the\n * segment values needed for the specified display format.\n *\n * Uses @accelint/geo to ensure accurate conversion between coordinate systems.\n *\n * **Note on Circular Conversion**: This function demonstrates the circular conversion\n * pattern discussed in the module documentation. The flow is:\n *\n * 1. Start with DD value: `{ lat: 40.7128, lon: -74.0060 }`\n * 2. Convert to coordinate string: `\"40.7128 / -74.006\"`\n * 3. Parse with geo package (creates coord object with internal parsed state)\n * 4. Format to target system using geo: `coord.ddm()` → `\"40 42.768 N / 74 0.36 W\"`\n * 5. Parse the formatted string AGAIN with regex to extract segments: `['40', '42.768', 'N', ...]`\n *\n * This is inefficient because:\n * - The geo package already has the component values (degrees, minutes, direction) internally\n * - We format them into a string, then immediately parse the string back apart\n * - The regex parsing duplicates work the geo parsers already did\n *\n * However, this approach is necessary because:\n * - The geo package only exposes `coord.raw` (DD numbers) and formatted strings\n * - It doesn't expose the intermediate component values we need for the UI segments\n * - We need individual segment values for separate input fields\n *\n * **Future Improvement**: If geo package exported component extractors like:\n * ```typescript\n * coord.components.ddm // { latDeg: 40, latMin: 42.768, latDir: 'N', ... }\n * ```\n * Then we could eliminate the format→parse cycle entirely.\n *\n * @param value - Coordinate value in DD format `{ lat: number, lon: number }`\n * @param format - Target display format\n * @returns Array of segment values for display, or null if conversion fails\n *\n * @example\n * const segments = convertDDToDisplaySegments({ lat: 40.7128, lon: -74.0060 }, 'ddm');\n * // Returns: ['40', '42.7680', 'N', '74', '0.3600', 'W']\n */\nexport function convertDDToDisplaySegments(\n  value: CoordinateValue,\n  format: CoordinateSystem,\n): string[] | null {\n  if (\n    !value ||\n    typeof value.lat !== 'number' ||\n    typeof value.lon !== 'number'\n  ) {\n    return null;\n  }\n\n  try {\n    const create = createCoordinate(coordinateSystems.dd, 'LATLON');\n\n    // Round to 5 decimal places to prevent precision issues with geo package\n    // Use signed numbers (not cardinal directions) for reliable conversions to all formats\n    const lat = Number(value.lat.toFixed(5));\n    const lon = Number(value.lon.toFixed(5));\n    const inputCoordString = `${lat} / ${lon}`;\n\n    const coord = create(inputCoordString);\n\n    if (!coord.valid) {\n      return null;\n    }\n\n    // Format the coordinate using geo package formatters\n    // These return complete coordinate strings (e.g., \"40 42.768 N / 74 0.36 W\")\n    let coordString: string;\n    switch (format) {\n      case 'dd':\n        coordString = coord.dd();\n        break;\n      case 'ddm':\n        coordString = coord.ddm();\n        break;\n      case 'dms':\n        coordString = coord.dms();\n        break;\n      case 'mgrs':\n        coordString = coord.mgrs();\n        break;\n      case 'utm':\n        coordString = coord.utm();\n        break;\n      default:\n        return null;\n    }\n\n    // Parse the formatted string to extract individual segment values\n    // This is the circular part: geo formatted it, now we parse it back apart\n    // Necessary because geo doesn't expose the components directly\n    const segments = parseCoordinateStringToSegments(coordString, format);\n    return segments;\n  } catch (error) {\n    logger\n      .withContext({\n        value: String(value),\n        format: String(format),\n      })\n      .withError(error)\n      .error('Failed to convert DD to display');\n    return null;\n  }\n}\n\n/**\n * Convert display format segment values to DD (internal format)\n *\n * Takes segment values from user input and converts them to a CoordinateValue\n * in Decimal Degrees format using @accelint/geo for validation and conversion.\n *\n * **Note on Efficiency**: This function demonstrates the EFFICIENT conversion direction.\n * The flow is:\n *\n * 1. Start with UI segments: `['40', '42.768', 'N', '74', '0.36', 'W']`\n * 2. Build coordinate string: `\"40° 42.768' N, 74° 0.36' W\"`\n * 3. Parse with geo package (validates and converts internally)\n * 4. Extract DD from coord.raw: `{ lat: 40.7128, lon: -74.0060 }`\n *\n * This is efficient because:\n * - We let geo do what it's designed for: parsing and validating coordinate strings\n * - We extract the DD values directly from `coord.raw` (no string parsing needed)\n * - Single direction: Segments → String → Geo Parse → DD (no circular conversion)\n *\n * Contrast with `convertDDToDisplaySegments` which has the circular pattern:\n * DD → String → Geo Parse → Geo Format → String → Regex Parse → Segments\n *\n * @param segments - Array of segment values from user input\n * @param format - The coordinate system format of the segments\n * @returns CoordinateValue in DD format, or null if invalid\n *\n * @example\n * const coord = convertDisplaySegmentsToDD(['40', '42.7680', 'N', '74', '0.3600', 'W'], 'ddm');\n * // Returns: { lat: 40.7128, lon: -74.0060 }\n */\nexport function convertDisplaySegmentsToDD(\n  segments: string[],\n  format: CoordinateSystem,\n): CoordinateValue | null {\n  // Build coordinate string from segments for geo parsing\n  const coordString = formatSegmentsToCoordinateString(segments, format);\n  if (!coordString) {\n    return null;\n  }\n\n  try {\n    // Parse and validate with geo package\n    const create = createCoordinate(coordinateSystems[format], 'LATLON');\n    const coord = create(coordString);\n\n    if (!coord.valid) {\n      // Return null for invalid coordinates (errors will be handled separately)\n      return null;\n    }\n\n    // Extract DD values directly from coord.raw (no string parsing needed)\n    const { LAT, LON } = coord.raw;\n\n    return {\n      lat: LAT,\n      lon: LON,\n    };\n  } catch (error) {\n    logger\n      .withContext({\n        segments: JSON.stringify(segments),\n        format: String(format),\n      })\n      .withError(error)\n      .error('Failed to convert display to DD');\n    return null;\n  }\n}\n\n/**\n * Validate coordinate segments and return errors\n *\n * Uses @accelint/geo to validate the segments and returns any validation errors.\n * Only validates when all required segments are filled.\n *\n * @param segments - Array of segment values from user input\n * @param format - The coordinate system format\n * @returns Array of error messages, empty if valid or incomplete\n *\n * @example\n * const errors = validateCoordinateSegments(['91', '0', 'N', '0', '0', 'E'], 'ddm');\n * // Returns: ['Invalid coordinate value']\n */\nexport function validateCoordinateSegments(\n  segments: string[],\n  format: CoordinateSystem,\n): string[] {\n  if (segments.some((seg) => seg === '' || seg === undefined)) {\n    return [];\n  }\n\n  const coordString = formatSegmentsToCoordinateString(segments, format);\n  if (!coordString) {\n    return ['Invalid coordinate value'];\n  }\n\n  try {\n    const create = createCoordinate(coordinateSystems[format], 'LATLON');\n    const coord = create(coordString);\n\n    if (!coord.valid) {\n      return ['Invalid coordinate value'];\n    }\n\n    return [];\n  } catch (_error) {\n    return ['Invalid coordinate value'];\n  }\n}\n\n/**\n * Check if all segments are filled\n *\n * Helper to determine if the user has completed entering all segment values.\n * Used to determine when to trigger validation.\n *\n * @param segments - Array of segment values\n * @returns True if all segments have values, false otherwise\n */\nexport function areAllSegmentsFilled(segments: string[]): boolean {\n  return segments.every((seg) => seg !== '' && seg !== undefined);\n}\n\n/**\n * Check if any segments have values\n *\n * Helper to determine if the user has started entering coordinate values.\n *\n * @param segments - Array of segment values\n * @returns True if any segment has a value, false if all empty\n */\nexport function hasAnySegmentValue(segments: string[]): boolean {\n  return segments.some((seg) => seg !== '' && seg !== undefined);\n}\n\n/**\n * Create an invalid result object for all coordinate systems\n * @internal\n */\nfunction createInvalidResult(): Record<\n  CoordinateSystem,\n  CoordinateFormatResult\n> {\n  return {\n    dd: { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false },\n    ddm: { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false },\n    dms: { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false },\n    mgrs: { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false },\n    utm: { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false },\n  };\n}\n\n/**\n * Validate coordinate value\n * @internal\n */\nfunction isValidCoordinateValue(value: CoordinateValue | null): boolean {\n  return (\n    value !== null &&\n    typeof value.lat === 'number' &&\n    typeof value.lon === 'number'\n  );\n}\n\n/**\n * Check if error is due to geographic limitation (poles)\n * @internal\n */\nfunction isGeographicLimitationError(error: unknown): boolean {\n  const errorMessage = error instanceof Error ? error.message : String(error);\n  return (\n    errorMessage.includes('outside UTM limits') ||\n    errorMessage.includes('invalid UTM zone')\n  );\n}\n\n/**\n * Convert coordinate to a specific format with error handling\n * @internal\n */\nfunction convertToFormat(\n  coord: {\n    dd: () => string;\n    ddm: () => string;\n    dms: () => string;\n    mgrs: () => string;\n    utm: () => string;\n  },\n  format: CoordinateSystem,\n  value: CoordinateValue,\n): CoordinateFormatResult {\n  try {\n    let formattedValue: string;\n    switch (format) {\n      case 'dd':\n        formattedValue = coord.dd();\n        break;\n      case 'ddm':\n        formattedValue = coord.ddm();\n        break;\n      case 'dms':\n        formattedValue = coord.dms();\n        break;\n      case 'mgrs':\n        formattedValue = coord.mgrs();\n        break;\n      case 'utm':\n        formattedValue = coord.utm();\n        break;\n      default:\n        return { value: COORDINATE_ERROR_MESSAGES.INVALID, isValid: false };\n    }\n    return { value: formattedValue, isValid: true };\n  } catch (error) {\n    // Handle geographic limitations for MGRS/UTM\n    if (\n      (format === 'mgrs' || format === 'utm') &&\n      isGeographicLimitationError(error)\n    ) {\n      return {\n        value: COORDINATE_ERROR_MESSAGES.NOT_AVAILABLE_AT_POLES,\n        isValid: false,\n      };\n    }\n\n    // Log other errors in development\n    logger\n      .withContext({\n        value: JSON.stringify(value),\n      })\n      .withError(error)\n      .error(`Failed to convert to ${format}`);\n    return {\n      value: COORDINATE_ERROR_MESSAGES.CONVERSION_FAILED,\n      isValid: false,\n    };\n  }\n}\n\n/**\n * Get all coordinate formats for a given DD value\n *\n * Converts a Decimal Degrees coordinate to all 5 supported coordinate systems\n * for display in the format conversion popover.\n *\n * Each format is tried independently - if one fails (e.g., UTM/MGRS at poles),\n * the others can still succeed.\n *\n * @param value - Coordinate value in DD format `{ lat: number, lon: number }`\n * @returns Object containing formatted strings and validity status for all coordinate systems\n *\n * @example\n * const formats = getAllCoordinateFormats({ lat: 40.7128, lon: -74.0060 });\n * // Returns: {\n * //   dd: { value: \"40.7128 N / 74.006 W\", isValid: true },\n * //   ddm: { value: \"40 42.768 N / 74 0.36 W\", isValid: true },\n * //   dms: { value: \"40 42 46.08 N / 74 0 21.6 W\", isValid: true },\n * //   mgrs: { value: \"18T WL 80654 06346\", isValid: true },\n * //   utm: { value: \"18N 585628 4511644\", isValid: true }\n * // }\n *\n * @example\n * const formats = getAllCoordinateFormats({ lat: 90, lon: 0 });\n * // Returns: {\n * //   dd: { value: \"90 N / 0 E\", isValid: true },\n * //   ddm: { value: \"90 0 N / 0 0 E\", isValid: true },\n * //   dms: { value: \"90 0 0 N / 0 0 0 E\", isValid: true },\n * //   mgrs: { value: \"Not available at poles\", isValid: false },\n * //   utm: { value: \"Not available at poles\", isValid: false }\n * // }\n */\nexport function getAllCoordinateFormats(\n  value: CoordinateValue | null,\n): Record<CoordinateSystem, CoordinateFormatResult> {\n  const invalidResult = createInvalidResult();\n\n  if (!isValidCoordinateValue(value)) {\n    return invalidResult;\n  }\n\n  const validValue = value as CoordinateValue;\n\n  try {\n    const create = createCoordinate(coordinateSystems.dd, 'LATLON');\n    const coord = create(`${validValue.lat} / ${validValue.lon}`);\n\n    if (!coord.valid) {\n      return invalidResult;\n    }\n\n    const result = {} as Record<CoordinateSystem, CoordinateFormatResult>;\n\n    for (const format of COORDINATE_SYSTEMS) {\n      result[format] = convertToFormat(coord, format, validValue);\n    }\n\n    return result;\n  } catch (error) {\n    logger\n      .withContext({\n        value: JSON.stringify(validValue),\n      })\n      .withError(error)\n      .error('Failed to get all coordinate formats');\n    return invalidResult;\n  }\n}\n\n/**\n * Check if pasted text looks like a complete coordinate string\n *\n * Uses heuristics to detect if the pasted text contains a full coordinate\n * rather than just a single segment value. This prevents intercepting\n * single-segment pastes.\n *\n * Indicators of a complete coordinate:\n * - Contains separators: comma, slash, or multiple consecutive spaces\n * - Contains coordinate symbols: °, ′, ″, ', \"\n * - Multiple numbers separated by whitespace\n *\n * @param text - The pasted text to check\n * @returns True if it looks like a complete coordinate string\n *\n * @example\n * isCompleteCoordinate(\"40.7128, -74.0060\") // true - contains comma\n * isCompleteCoordinate(\"40° 42' 46\\\" N / 74° 0' 22\\\" W\") // true - contains symbols\n * isCompleteCoordinate(\"18T WM 12345 67890\") // true - multiple parts\n * isCompleteCoordinate(\"42\") // false - single number\n * isCompleteCoordinate(\"N\") // false - single letter\n */\nexport function isCompleteCoordinate(text: string): boolean {\n  if (!text || text.trim() === '') {\n    return false;\n  }\n\n  const hasSeparators = /[,/]|°|′|″|['\"]|\\s{2,}/.test(text);\n  const numbers = text.match(/\\d+/g) || [];\n  const hasMultipleNumbers = numbers.length >= 2;\n\n  // Explicitly detect MGRS format: <zone><band> <grid> <easting> <northing>\n  // Example: \"18T WL 80654 06346\"\n  const isMGRS = /^\\d{1,2}[A-Z]\\s+[A-Z]{2}\\s+\\d+\\s+\\d+$/i.test(text.trim());\n\n  // Explicitly detect UTM format: <zone><hemisphere> <easting> <northing>\n  // Example: \"18N 585628 4511644\"\n  const isUTM = /^\\d{1,2}[NS]\\s+\\d+\\s+\\d+$/i.test(text.trim());\n\n  return hasSeparators || hasMultipleNumbers || isMGRS || isUTM;\n}\n\n/**\n * Attempt to parse pasted text as all coordinate formats\n *\n * Tries to parse the pasted text using each of the 5 coordinate system parsers.\n * Returns all formats that successfully parse the text.\n *\n * This enables automatic detection of coordinate format and disambiguation\n * when multiple formats match the same input string.\n *\n * @param pastedText - The raw text from clipboard\n * @returns Array of successfully parsed coordinate matches (may be empty)\n *\n * @example\n * const matches = parseCoordinatePaste(\"40.7128, -74.0060\");\n * // Returns: [{ format: 'dd', value: { lat: 40.7128, lon: -74.0060 }, displayString: \"...\" }]\n *\n * @example\n * const matches = parseCoordinatePaste(\"18T WM 12345 67890\");\n * // Returns: [{ format: 'mgrs', value: { lat: ..., lon: ... }, displayString: \"...\" }]\n *\n * @example\n * const matches = parseCoordinatePaste(\"invalid text\");\n * // Returns: []\n */\nexport function parseCoordinatePaste(\n  pastedText: string,\n): ParsedCoordinateMatch[] {\n  if (!pastedText || pastedText.trim() === '') {\n    return [];\n  }\n\n  const matches: ParsedCoordinateMatch[] = [];\n\n  for (const format of COORDINATE_SYSTEMS) {\n    try {\n      const create = createCoordinate(coordinateSystems[format], 'LATLON');\n      const coord = create(pastedText.trim());\n\n      if (coord.valid) {\n        const { LAT, LON } = coord.raw;\n\n        let displayString: string;\n        switch (format) {\n          case 'dd':\n            displayString = coord.dd();\n            break;\n          case 'ddm':\n            displayString = coord.ddm();\n            break;\n          case 'dms':\n            displayString = coord.dms();\n            break;\n          case 'mgrs':\n            displayString = coord.mgrs();\n            break;\n          case 'utm':\n            displayString = coord.utm();\n            break;\n          default:\n            displayString = '';\n        }\n\n        matches.push({\n          format,\n          value: { lat: LAT, lon: LON },\n          displayString,\n        });\n      }\n    } catch (error) {\n      // Log parsing errors in development for debugging\n      logger\n        .withContext({\n          pastedText: pastedText.trim(),\n          format: String(format),\n        })\n        .withError(error)\n        .warn(`Failed to parse as ${format}`);\n      // Continue trying other parsers\n    }\n  }\n\n  return matches;\n}\n\n/**\n * Check if two coordinates are equal within epsilon tolerance\n */\nexport function areCoordinatesEqual(\n  coord1: { lat: number; lon: number },\n  coord2: { lat: number; lon: number },\n  epsilon = COORDINATE_EPSILON,\n): boolean {\n  return (\n    Math.abs(coord1.lat - coord2.lat) < epsilon &&\n    Math.abs(coord1.lon - coord2.lon) < epsilon\n  );\n}\n\n/**\n * Deduplicate coordinate matches by location, keeping first match for each unique location\n */\nexport function deduplicateMatchesByLocation(\n  matches: ParsedCoordinateMatch[],\n): ParsedCoordinateMatch[] {\n  const uniqueMatches: ParsedCoordinateMatch[] = [];\n\n  for (const match of matches) {\n    const isDuplicate = uniqueMatches.some((existing) =>\n      areCoordinatesEqual(existing.value, match.value),\n    );\n\n    if (!isDuplicate) {\n      uniqueMatches.push(match);\n    }\n  }\n\n  return uniqueMatches;\n}\n"]}