@accelint/design-toolkit 9.11.2 → 9.12.0

package/dist/components/view-stack/context.d.ts

@@ -12,12 +12,12 @@
 
 import { ViewStackContextValue } from "./types.js";
 import "client-only";
-import * as react43 from "react";
+import * as react53 from "react";
 import { UniqueId } from "@accelint/core";
 
 //#region src/components/view-stack/context.d.ts
 /** Context for sharing state across ViewStack components */
-declare const ViewStackContext: react43.Context<ViewStackContextValue>;
+declare const ViewStackContext: react53.Context<ViewStackContextValue>;
 /** Event handlers for ViewStack events */
 declare const ViewStackEventHandlers: {
   readonly back: (stack: UniqueId) => void;

package/dist/components/view-stack/index.d.ts

@@ -12,7 +12,7 @@
 
 import { ViewStackProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime180 from "react/jsx-runtime";
+import * as react_jsx_runtime211 from "react/jsx-runtime";
 
 //#region src/components/view-stack/index.d.ts
 
@@ -47,7 +47,7 @@ declare function ViewStack({
   children,
   defaultView,
   onChange
-}: ViewStackProps): react_jsx_runtime180.JSX.Element;
+}: ViewStackProps): react_jsx_runtime211.JSX.Element;
 //#endregion
 export { ViewStack };
 //# sourceMappingURL=index.d.ts.map

package/dist/components/view-stack/trigger.d.ts

@@ -12,7 +12,7 @@
 
 import { ViewStackTriggerProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime181 from "react/jsx-runtime";
+import * as react_jsx_runtime212 from "react/jsx-runtime";
 
 //#region src/components/view-stack/trigger.d.ts
 
@@ -45,7 +45,7 @@ import * as react_jsx_runtime181 from "react/jsx-runtime";
 declare function ViewStackTrigger({
   children,
   for: types
-}: ViewStackTriggerProps): react_jsx_runtime181.JSX.Element;
+}: ViewStackTriggerProps): react_jsx_runtime212.JSX.Element;
 //#endregion
 export { ViewStackTrigger };
 //# sourceMappingURL=trigger.d.ts.map

package/dist/components/view-stack/view.d.ts

@@ -12,7 +12,7 @@
 
 import { ViewStackViewProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime182 from "react/jsx-runtime";
+import * as react_jsx_runtime213 from "react/jsx-runtime";
 
 //#region src/components/view-stack/view.d.ts
 
@@ -43,7 +43,7 @@ import * as react_jsx_runtime182 from "react/jsx-runtime";
 declare function ViewStackView({
   id,
   children
-}: ViewStackViewProps): react_jsx_runtime182.JSX.Element | null;
+}: ViewStackViewProps): react_jsx_runtime213.JSX.Element | null;
 //#endregion
 export { ViewStackView };
 //# sourceMappingURL=view.d.ts.map

package/dist/hooks/coordinate-field/use-coordinate-field-state.js

@@ -70,6 +70,7 @@ function useCoordinateFieldState({ value, defaultValue, format, onChange, onErro
 	const [internalValue, setInternalValue] = useState(defaultValue || null);
 	const [validationErrors, setValidationErrors] = useState([]);
 	const validationTimeoutRef = useRef(null);
+	const lastEmittedValueRef = useRef(void 0);
 	const currentValue = value !== void 0 ? value : internalValue;
 	const clearValidationTimeout = () => {
 		if (validationTimeoutRef.current) {
@@ -78,6 +79,7 @@ function useCoordinateFieldState({ value, defaultValue, format, onChange, onErro
 		}
 	};
 	const handleChange = (newValue) => {
+		lastEmittedValueRef.current = newValue;
 		if (value === void 0) setInternalValue(newValue);
 		onChange?.(newValue);
 	};
@@ -108,7 +110,9 @@ function useCoordinateFieldState({ value, defaultValue, format, onChange, onErro
 		convertValueToSegmentsOrClear
 	]);
 	useEffect(() => {
-		if (value !== void 0) convertValueToSegmentsOrClear(value);
+		if (value === void 0) return;
+		const lastEmitted = lastEmittedValueRef.current;
+		if (!(lastEmitted !== void 0 && (value === lastEmitted || value !== null && lastEmitted !== null && value.lat === lastEmitted.lat && value.lon === lastEmitted.lon))) convertValueToSegmentsOrClear(value);
 	}, [value, convertValueToSegmentsOrClear]);
 	/**
 	* Validates segment values and updates the coordinate state

package/dist/hooks/coordinate-field/use-coordinate-field-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-coordinate-field-state.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-coordinate-field-state.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  areAllSegmentsFilled,\n  convertDDToDisplaySegments,\n  convertDisplaySegmentsToDD,\n  validateCoordinateSegments,\n} from '../../components/coordinate-field/coordinate-utils';\nimport { getSegmentConfigs } from '../../components/coordinate-field/segment-configs';\nimport type {\n  CoordinateSystem,\n  CoordinateValue,\n  SegmentConfig,\n} from '../../components/coordinate-field/types';\n\n/** Options for the useCoordinateFieldState hook */\nexport interface UseCoordinateFieldStateOptions {\n  /** Controlled coordinate value */\n  value?: CoordinateValue | null;\n  /** Default value for uncontrolled mode */\n  defaultValue?: CoordinateValue;\n  /** Coordinate format system (dd, ddm, dms, mgrs, utm) */\n  format: CoordinateSystem;\n  /** Callback when coordinate value changes */\n  onChange?:\n    | Dispatch<SetStateAction<CoordinateValue | null>>\n    | ((value: CoordinateValue | null) => void);\n  /** Callback for validation errors */\n  onError?: (message: string, context?: Record<string, unknown>) => void;\n  /** Register timeouts for cleanup on unmount */\n  registerTimeout?: (timeoutId: NodeJS.Timeout) => void;\n}\n\n/** Return value from the useCoordinateFieldState hook */\nexport interface UseCoordinateFieldStateResult {\n  /** Current coordinate value (null if incomplete/invalid) */\n  currentValue: CoordinateValue | null;\n  /** Array of display values for each segment */\n  segmentValues: string[];\n  /** Array of validation error messages */\n  validationErrors: string[];\n  /** All segment configurations including literals */\n  segmentConfigs: SegmentConfig[];\n  /** Only editable segment configurations */\n  editableSegmentConfigs: SegmentConfig[];\n  /** Handle change of a single segment */\n  handleSegmentChange: (index: number, newValue: string) => void;\n  /** Handle blur event for a segment */\n  handleSegmentBlur: (index: number) => void;\n  /** Set all segment values at once */\n  setSegmentValues: (values: string[]) => void;\n  /** Set validation errors */\n  setValidationErrors: (errors: string[]) => void;\n  /** First validation error or null */\n  effectiveErrorMessage: string | null;\n  /** Apply a pasted coordinate value */\n  applyPastedCoordinate: (pastedValue: CoordinateValue) => void;\n  /** Immediately run pending validation */\n  flushPendingValidation: () => void;\n}\n\n/**\n * Manages coordinate segment values, validation, and format conversion\n *\n * @example\n * ```tsx\n * function CoordinateInputs() {\n *   const [value, setValue] = useState<CoordinateValue | null>(null);\n *   const { registerTimeout } = useTimeoutCleanup();\n *\n *   const {\n *     currentValue,\n *     segmentValues,\n *     validationErrors,\n *     editableSegmentConfigs,\n *     handleSegmentChange,\n *   } = useCoordinateFieldState({\n *     value,\n *     format: 'ddm',\n *     onChange: setValue,\n *     onError: (msg) => console.error(msg),\n *     registerTimeout,\n *   });\n *\n *   return (\n *     <div>\n *       {editableSegmentConfigs.map((config, i) => (\n *         <input\n *           key={i}\n *           value={segmentValues[i]}\n *           onChange={(e) => handleSegmentChange(i, e.target.value)}\n *           placeholder={config.placeholder}\n *         />\n *       ))}\n *       {validationErrors.map((error, i) => (\n *         <span key={i}>{error}</span>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n *\n * @param options - {@link UseCoordinateFieldStateOptions}\n * @param options.value - Controlled coordinate value.\n * @param options.defaultValue - Default value for uncontrolled mode.\n * @param options.format - Coordinate format system (dd, ddm, dms, mgrs, utm).\n * @param options.onChange - Callback when coordinate value changes.\n * @param options.onError - Callback for validation errors.\n * @param options.registerTimeout - Register timeouts for cleanup on unmount.\n * @returns {@link UseCoordinateFieldStateResult} Segment state, validation, and change handlers.\n */\nexport function useCoordinateFieldState({\n  value,\n  defaultValue,\n  format,\n  onChange,\n  onError,\n  registerTimeout,\n}: UseCoordinateFieldStateOptions): UseCoordinateFieldStateResult {\n  const [internalValue, setInternalValue] = useState<CoordinateValue | null>(\n    defaultValue || null,\n  );\n  const [validationErrors, setValidationErrors] = useState<string[]>([]);\n  const validationTimeoutRef = useRef<NodeJS.Timeout | null>(null);\n\n  const currentValue = value !== undefined ? value : internalValue;\n\n  const clearValidationTimeout = () => {\n    if (validationTimeoutRef.current) {\n      clearTimeout(validationTimeoutRef.current);\n      validationTimeoutRef.current = null;\n    }\n  };\n\n  const handleChange = (newValue: CoordinateValue | null) => {\n    if (value === undefined) {\n      setInternalValue(newValue);\n    }\n    onChange?.(newValue);\n  };\n\n  const segmentConfigs = useMemo(() => getSegmentConfigs(format), [format]);\n\n  const editableSegmentConfigs = useMemo(\n    () => segmentConfigs.flat().filter((config) => config.type !== 'literal'),\n    [segmentConfigs],\n  );\n\n  const [segmentValues, setSegmentValues] = useState<string[]>(() => {\n    const initialValue = value !== undefined ? value : defaultValue;\n    if (!initialValue) {\n      return new Array(editableSegmentConfigs.length).fill('');\n    }\n\n    const segments = convertDDToDisplaySegments(initialValue, format);\n    if (!segments) {\n      return new Array(editableSegmentConfigs.length).fill('');\n    }\n\n    return segments;\n  });\n\n  const convertValueToSegmentsOrClear = useCallback(\n    (valueToConvert: CoordinateValue | null) => {\n      // Clear any pending validation when value changes\n      clearValidationTimeout();\n\n      const segments = valueToConvert\n        ? convertDDToDisplaySegments(valueToConvert, format)\n        : null;\n\n      setSegmentValues(\n        segments || new Array(editableSegmentConfigs.length).fill(''),\n      );\n      setValidationErrors([]);\n    },\n    [format, editableSegmentConfigs.length],\n  );\n\n  const prevFormatRef = useRef(format);\n\n  useEffect(() => {\n    if (prevFormatRef.current !== format) {\n      prevFormatRef.current = format;\n      const valueToConvert = value !== undefined ? value : internalValue;\n      convertValueToSegmentsOrClear(valueToConvert);\n    }\n  }, [format, value, internalValue, convertValueToSegmentsOrClear]);\n\n  useEffect(() => {\n    if (value !== undefined) {\n      convertValueToSegmentsOrClear(value);\n    }\n  }, [value, convertValueToSegmentsOrClear]);\n\n  /**\n   * Validates segment values and updates the coordinate state\n   *\n   * When validation fails, calls onError with \"Invalid coordinate value\" message\n   * and context containing the detailed validation errors from @accelint/geo.\n   *\n   * @param updatedValues - Array of segment values to validate\n   */\n  const validateAndUpdateCoordinate = (updatedValues: string[]) => {\n    const errors = validateCoordinateSegments(updatedValues, format);\n\n    if (errors.length > 0) {\n      setValidationErrors(errors);\n      onError?.('Invalid coordinate value', {\n        errors,\n        format,\n        segments: updatedValues,\n      });\n      handleChange(null);\n      return;\n    }\n\n    const ddValue = convertDisplaySegmentsToDD(updatedValues, format);\n    if (!ddValue) {\n      const errorMsg = 'Invalid coordinate value';\n      setValidationErrors([errorMsg]);\n      onError?.(errorMsg, { format, segments: updatedValues });\n      handleChange(null);\n      return;\n    }\n\n    setValidationErrors([]);\n    handleChange(ddValue);\n  };\n\n  const handleSegmentChange = (index: number, newValue: string) => {\n    const updatedValues = [...segmentValues];\n\n    // Normalize MGRS letter inputs (Band/Grid): uppercase only\n    if (\n      format === 'mgrs' &&\n      (index === 1 || index === 2) &&\n      /^[a-zA-Z]+$/.test(newValue)\n    ) {\n      updatedValues[index] = newValue.toUpperCase();\n    } else {\n      updatedValues[index] = newValue;\n    }\n\n    setSegmentValues(updatedValues);\n\n    if (areAllSegmentsFilled(updatedValues)) {\n      // Clear any pending validation timeout\n      clearValidationTimeout();\n\n      // Capture segment values at timeout creation\n      const capturedValues = [...updatedValues];\n\n      // Debounce validation by 400ms when all segments are full\n      const timeoutId = setTimeout(() => {\n        validateAndUpdateCoordinate(capturedValues);\n        validationTimeoutRef.current = null;\n      }, 400);\n\n      validationTimeoutRef.current = timeoutId;\n      registerTimeout?.(timeoutId);\n    } else {\n      // Clear any pending validation when segments become incomplete\n      clearValidationTimeout();\n      setValidationErrors([]);\n      if (currentValue !== null) {\n        handleChange(null);\n      }\n    }\n  };\n\n  const handleSegmentBlur = (index: number) => {\n    // MGRS zone field: add leading zero to single-digit values on blur\n    if (format === 'mgrs' && index === 0) {\n      const currentVal = segmentValues[0];\n      if (currentVal && currentVal.length === 1 && /^\\d$/.test(currentVal)) {\n        const updatedValues = [...segmentValues];\n        updatedValues[0] = currentVal.padStart(2, '0');\n        setSegmentValues(updatedValues);\n      }\n    }\n  };\n\n  const applyPastedCoordinate = (pastedValue: CoordinateValue) => {\n    // Clear any pending validation when applying pasted coordinate\n    clearValidationTimeout();\n\n    const segments = convertDDToDisplaySegments(pastedValue, format);\n\n    if (segments) {\n      setSegmentValues(segments);\n      setValidationErrors([]);\n      handleChange(pastedValue);\n    }\n  };\n\n  const flushPendingValidation = () => {\n    if (validationTimeoutRef.current) {\n      clearValidationTimeout();\n\n      // Immediately validate if all segments are filled\n      if (areAllSegmentsFilled(segmentValues)) {\n        validateAndUpdateCoordinate(segmentValues);\n      }\n    }\n  };\n\n  const effectiveErrorMessage = useMemo(\n    () => validationErrors[0] || null,\n    [validationErrors],\n  );\n\n  return {\n    currentValue,\n    segmentValues,\n    validationErrors,\n    segmentConfigs,\n    editableSegmentConfigs,\n    handleSegmentChange,\n    handleSegmentBlur,\n    setSegmentValues,\n    setValidationErrors,\n    effectiveErrorMessage,\n    applyPastedCoordinate,\n    flushPendingValidation,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-coordinate-field-state.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-coordinate-field-state.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport {\n  areAllSegmentsFilled,\n  convertDDToDisplaySegments,\n  convertDisplaySegmentsToDD,\n  validateCoordinateSegments,\n} from '../../components/coordinate-field/coordinate-utils';\nimport { getSegmentConfigs } from '../../components/coordinate-field/segment-configs';\nimport type {\n  CoordinateSystem,\n  CoordinateValue,\n  SegmentConfig,\n} from '../../components/coordinate-field/types';\n\n/** Options for the useCoordinateFieldState hook */\nexport interface UseCoordinateFieldStateOptions {\n  /** Controlled coordinate value */\n  value?: CoordinateValue | null;\n  /** Default value for uncontrolled mode */\n  defaultValue?: CoordinateValue;\n  /** Coordinate format system (dd, ddm, dms, mgrs, utm) */\n  format: CoordinateSystem;\n  /** Callback when coordinate value changes */\n  onChange?:\n    | Dispatch<SetStateAction<CoordinateValue | null>>\n    | ((value: CoordinateValue | null) => void);\n  /** Callback for validation errors */\n  onError?: (message: string, context?: Record<string, unknown>) => void;\n  /** Register timeouts for cleanup on unmount */\n  registerTimeout?: (timeoutId: NodeJS.Timeout) => void;\n}\n\n/** Return value from the useCoordinateFieldState hook */\nexport interface UseCoordinateFieldStateResult {\n  /** Current coordinate value (null if incomplete/invalid) */\n  currentValue: CoordinateValue | null;\n  /** Array of display values for each segment */\n  segmentValues: string[];\n  /** Array of validation error messages */\n  validationErrors: string[];\n  /** All segment configurations including literals */\n  segmentConfigs: SegmentConfig[];\n  /** Only editable segment configurations */\n  editableSegmentConfigs: SegmentConfig[];\n  /** Handle change of a single segment */\n  handleSegmentChange: (index: number, newValue: string) => void;\n  /** Handle blur event for a segment */\n  handleSegmentBlur: (index: number) => void;\n  /** Set all segment values at once */\n  setSegmentValues: (values: string[]) => void;\n  /** Set validation errors */\n  setValidationErrors: (errors: string[]) => void;\n  /** First validation error or null */\n  effectiveErrorMessage: string | null;\n  /** Apply a pasted coordinate value */\n  applyPastedCoordinate: (pastedValue: CoordinateValue) => void;\n  /** Immediately run pending validation */\n  flushPendingValidation: () => void;\n}\n\n/**\n * Manages coordinate segment values, validation, and format conversion\n *\n * @example\n * ```tsx\n * function CoordinateInputs() {\n *   const [value, setValue] = useState<CoordinateValue | null>(null);\n *   const { registerTimeout } = useTimeoutCleanup();\n *\n *   const {\n *     currentValue,\n *     segmentValues,\n *     validationErrors,\n *     editableSegmentConfigs,\n *     handleSegmentChange,\n *   } = useCoordinateFieldState({\n *     value,\n *     format: 'ddm',\n *     onChange: setValue,\n *     onError: (msg) => console.error(msg),\n *     registerTimeout,\n *   });\n *\n *   return (\n *     <div>\n *       {editableSegmentConfigs.map((config, i) => (\n *         <input\n *           key={i}\n *           value={segmentValues[i]}\n *           onChange={(e) => handleSegmentChange(i, e.target.value)}\n *           placeholder={config.placeholder}\n *         />\n *       ))}\n *       {validationErrors.map((error, i) => (\n *         <span key={i}>{error}</span>\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n *\n * @param options - {@link UseCoordinateFieldStateOptions}\n * @param options.value - Controlled coordinate value.\n * @param options.defaultValue - Default value for uncontrolled mode.\n * @param options.format - Coordinate format system (dd, ddm, dms, mgrs, utm).\n * @param options.onChange - Callback when coordinate value changes.\n * @param options.onError - Callback for validation errors.\n * @param options.registerTimeout - Register timeouts for cleanup on unmount.\n * @returns {@link UseCoordinateFieldStateResult} Segment state, validation, and change handlers.\n */\nexport function useCoordinateFieldState({\n  value,\n  defaultValue,\n  format,\n  onChange,\n  onError,\n  registerTimeout,\n}: UseCoordinateFieldStateOptions): UseCoordinateFieldStateResult {\n  const [internalValue, setInternalValue] = useState<CoordinateValue | null>(\n    defaultValue || null,\n  );\n  const [validationErrors, setValidationErrors] = useState<string[]>([]);\n  const validationTimeoutRef = useRef<NodeJS.Timeout | null>(null);\n  // Last value emitted via onChange; `undefined` means nothing emitted yet.\n  const lastEmittedValueRef = useRef<CoordinateValue | null | undefined>(\n    undefined,\n  );\n\n  const currentValue = value !== undefined ? value : internalValue;\n\n  const clearValidationTimeout = () => {\n    if (validationTimeoutRef.current) {\n      clearTimeout(validationTimeoutRef.current);\n      validationTimeoutRef.current = null;\n    }\n  };\n\n  const handleChange = (newValue: CoordinateValue | null) => {\n    lastEmittedValueRef.current = newValue;\n    if (value === undefined) {\n      setInternalValue(newValue);\n    }\n    onChange?.(newValue);\n  };\n\n  const segmentConfigs = useMemo(() => getSegmentConfigs(format), [format]);\n\n  const editableSegmentConfigs = useMemo(\n    () => segmentConfigs.flat().filter((config) => config.type !== 'literal'),\n    [segmentConfigs],\n  );\n\n  const [segmentValues, setSegmentValues] = useState<string[]>(() => {\n    const initialValue = value !== undefined ? value : defaultValue;\n    if (!initialValue) {\n      return new Array(editableSegmentConfigs.length).fill('');\n    }\n\n    const segments = convertDDToDisplaySegments(initialValue, format);\n    if (!segments) {\n      return new Array(editableSegmentConfigs.length).fill('');\n    }\n\n    return segments;\n  });\n\n  const convertValueToSegmentsOrClear = useCallback(\n    (valueToConvert: CoordinateValue | null) => {\n      // Clear any pending validation when value changes\n      clearValidationTimeout();\n\n      const segments = valueToConvert\n        ? convertDDToDisplaySegments(valueToConvert, format)\n        : null;\n\n      setSegmentValues(\n        segments || new Array(editableSegmentConfigs.length).fill(''),\n      );\n      setValidationErrors([]);\n    },\n    [format, editableSegmentConfigs.length],\n  );\n\n  const prevFormatRef = useRef(format);\n\n  useEffect(() => {\n    if (prevFormatRef.current !== format) {\n      prevFormatRef.current = format;\n      const valueToConvert = value !== undefined ? value : internalValue;\n      convertValueToSegmentsOrClear(valueToConvert);\n    }\n  }, [format, value, internalValue, convertValueToSegmentsOrClear]);\n\n  useEffect(() => {\n    if (value === undefined) {\n      return;\n    }\n\n    /*\n     * Skip re-syncing when the controlled `value` is just the echo of our own\n     * onChange (the parent storing what we emitted). Without this guard, the\n     * `handleChange(null)` fired for an in-progress edit (one segment emptied,\n     * or an invalid entry) comes straight back and wipes every segment and any\n     * validation error that was just set.\n     */\n    const lastEmitted = lastEmittedValueRef.current;\n    const isEchoOfEmit =\n      lastEmitted !== undefined &&\n      (value === lastEmitted ||\n        (value !== null &&\n          lastEmitted !== null &&\n          value.lat === lastEmitted.lat &&\n          value.lon === lastEmitted.lon));\n\n    if (!isEchoOfEmit) {\n      convertValueToSegmentsOrClear(value);\n    }\n  }, [value, convertValueToSegmentsOrClear]);\n\n  /**\n   * Validates segment values and updates the coordinate state\n   *\n   * When validation fails, calls onError with \"Invalid coordinate value\" message\n   * and context containing the detailed validation errors from @accelint/geo.\n   *\n   * @param updatedValues - Array of segment values to validate\n   */\n  const validateAndUpdateCoordinate = (updatedValues: string[]) => {\n    const errors = validateCoordinateSegments(updatedValues, format);\n\n    if (errors.length > 0) {\n      setValidationErrors(errors);\n      onError?.('Invalid coordinate value', {\n        errors,\n        format,\n        segments: updatedValues,\n      });\n      handleChange(null);\n      return;\n    }\n\n    const ddValue = convertDisplaySegmentsToDD(updatedValues, format);\n    if (!ddValue) {\n      const errorMsg = 'Invalid coordinate value';\n      setValidationErrors([errorMsg]);\n      onError?.(errorMsg, { format, segments: updatedValues });\n      handleChange(null);\n      return;\n    }\n\n    setValidationErrors([]);\n    handleChange(ddValue);\n  };\n\n  const handleSegmentChange = (index: number, newValue: string) => {\n    const updatedValues = [...segmentValues];\n\n    // Normalize MGRS letter inputs (Band/Grid): uppercase only\n    if (\n      format === 'mgrs' &&\n      (index === 1 || index === 2) &&\n      /^[a-zA-Z]+$/.test(newValue)\n    ) {\n      updatedValues[index] = newValue.toUpperCase();\n    } else {\n      updatedValues[index] = newValue;\n    }\n\n    setSegmentValues(updatedValues);\n\n    if (areAllSegmentsFilled(updatedValues)) {\n      // Clear any pending validation timeout\n      clearValidationTimeout();\n\n      // Capture segment values at timeout creation\n      const capturedValues = [...updatedValues];\n\n      // Debounce validation by 400ms when all segments are full\n      const timeoutId = setTimeout(() => {\n        validateAndUpdateCoordinate(capturedValues);\n        validationTimeoutRef.current = null;\n      }, 400);\n\n      validationTimeoutRef.current = timeoutId;\n      registerTimeout?.(timeoutId);\n    } else {\n      // Clear any pending validation when segments become incomplete\n      clearValidationTimeout();\n      setValidationErrors([]);\n      if (currentValue !== null) {\n        handleChange(null);\n      }\n    }\n  };\n\n  const handleSegmentBlur = (index: number) => {\n    // MGRS zone field: add leading zero to single-digit values on blur\n    if (format === 'mgrs' && index === 0) {\n      const currentVal = segmentValues[0];\n      if (currentVal && currentVal.length === 1 && /^\\d$/.test(currentVal)) {\n        const updatedValues = [...segmentValues];\n        updatedValues[0] = currentVal.padStart(2, '0');\n        setSegmentValues(updatedValues);\n      }\n    }\n  };\n\n  const applyPastedCoordinate = (pastedValue: CoordinateValue) => {\n    // Clear any pending validation when applying pasted coordinate\n    clearValidationTimeout();\n\n    const segments = convertDDToDisplaySegments(pastedValue, format);\n\n    if (segments) {\n      setSegmentValues(segments);\n      setValidationErrors([]);\n      handleChange(pastedValue);\n    }\n  };\n\n  const flushPendingValidation = () => {\n    if (validationTimeoutRef.current) {\n      clearValidationTimeout();\n\n      // Immediately validate if all segments are filled\n      if (areAllSegmentsFilled(segmentValues)) {\n        validateAndUpdateCoordinate(segmentValues);\n      }\n    }\n  };\n\n  const effectiveErrorMessage = useMemo(\n    () => validationErrors[0] || null,\n    [validationErrors],\n  );\n\n  return {\n    currentValue,\n    segmentValues,\n    validationErrors,\n    segmentConfigs,\n    editableSegmentConfigs,\n    handleSegmentChange,\n    handleSegmentBlur,\n    setSegmentValues,\n    setValidationErrors,\n    effectiveErrorMessage,\n    applyPastedCoordinate,\n    flushPendingValidation,\n  };\n}\n"],"mappings":"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"}

package/dist/providers/portal.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { PropsWithChildren, RefObject } from "react";
-import * as react_jsx_runtime83 from "react/jsx-runtime";
+import * as react_jsx_runtime15 from "react/jsx-runtime";
 
 //#region src/providers/portal.d.ts
 /**
@@ -30,7 +30,7 @@ declare function PortalProvider({
 }: PropsWithChildren<{
   parentRef?: RefObject<HTMLElement | null>;
   inject?: HTMLElement | null;
-}>): react_jsx_runtime83.JSX.Element;
+}>): react_jsx_runtime15.JSX.Element;
 //#endregion
 export { PortalProvider };
 //# sourceMappingURL=portal.d.ts.map

package/dist/providers/theme-provider.d.ts

@@ -12,7 +12,7 @@
 
 import "client-only";
 import { PropsWithChildren } from "react";
-import * as react_jsx_runtime79 from "react/jsx-runtime";
+import * as react_jsx_runtime16 from "react/jsx-runtime";
 import { PartialDeep } from "type-fest";
 import { DomainColorTokens, SemanticColorTokens, ThemeTokens } from "@accelint/design-foundation/tokens/types";
 
@@ -46,7 +46,7 @@ declare function ThemeProvider({
   defaultMode,
   onChange,
   overrides
-}: ThemeProviderProps): react_jsx_runtime79.JSX.Element;
+}: ThemeProviderProps): react_jsx_runtime16.JSX.Element;
 /**
  * Access the current theme context
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@accelint/design-toolkit",
   "description": "An open-source component library to serve as part of the entire ecosystem of UX for Accelint.",
-  "version": "9.11.2",
+  "version": "9.12.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "devDependencies": {
@@ -56,11 +56,11 @@
     "@accelint/converters": "1.0.1",
     "@accelint/core": "0.6.0",
     "@accelint/design-foundation": "3.2.0",
+    "@accelint/geo": "0.6.1",
     "@accelint/icons": "3.0.0",
     "@accelint/logger": "1.1.0",
-    "@accelint/predicates": "0.5.2",
     "@accelint/postcss-tailwind-css-modules": "1.1.0",
-    "@accelint/geo": "0.6.0",
+    "@accelint/predicates": "0.5.2",
     "@accelint/prettier-config": "0.2.1",
     "@accelint/temporal": "0.1.4",
     "@accelint/vitest-config": "0.1.6",
@@ -467,14 +467,14 @@
     "uuid": "^11.1.0",
     "zod": "^4.1.12",
     "zustand": "^5.0.3",
-    "@accelint/bus": "4.0.0",
-    "@accelint/core": "0.6.0",
     "@accelint/design-foundation": "3.2.0",
-    "@accelint/geo": "0.6.0",
-    "@accelint/converters": "1.0.1",
+    "@accelint/core": "0.6.0",
+    "@accelint/geo": "0.6.1",
     "@accelint/icons": "3.0.0",
     "@accelint/logger": "1.1.0",
     "@accelint/predicates": "0.5.2",
+    "@accelint/converters": "1.0.1",
+    "@accelint/bus": "4.0.0",
     "@accelint/temporal": "0.1.4"
   },
   "private": false,