@accelint/design-toolkit 8.1.2 → 9.1.0

package/dist/hooks/coordinate-field/use-coordinate-copy.d.ts

@@ -1,19 +1,36 @@
-import { CoordinateValue, CoordinateSystem } from '../../components/coordinate-field/types.js';
-import { UseTimeoutCleanupResult } from './use-timeout-cleanup.js';
-import 'react';
-import 'react-aria-components';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+import { CoordinateSystem, CoordinateValue } from "../../components/coordinate-field/types.js";
+import { UseTimeoutCleanupResult } from "./use-timeout-cleanup.js";
+
+//#region src/hooks/coordinate-field/use-coordinate-copy.d.ts
 interface UseCoordinateCopyOptions {
-    currentValue: CoordinateValue | null;
-    validationErrors: string[];
-    isDisabled: boolean;
-    registerTimeout: UseTimeoutCleanupResult['registerTimeout'];
+  currentValue: CoordinateValue | null;
+  validationErrors: string[];
+  isDisabled: boolean;
+  registerTimeout: UseTimeoutCleanupResult['registerTimeout'];
 }
 interface UseCoordinateCopyResult {
-    copiedFormat: CoordinateSystem | null;
-    handleCopyFormat: (formatToCopy: CoordinateSystem) => Promise<void>;
-    isFormatButtonEnabled: boolean;
+  copiedFormat: CoordinateSystem | null;
+  handleCopyFormat: (formatToCopy: CoordinateSystem) => Promise<void>;
+  isFormatButtonEnabled: boolean;
 }
-declare function useCoordinateCopy({ currentValue, validationErrors, isDisabled, registerTimeout, }: UseCoordinateCopyOptions): UseCoordinateCopyResult;
-
-export { type UseCoordinateCopyOptions, type UseCoordinateCopyResult, useCoordinateCopy };
+declare function useCoordinateCopy({
+  currentValue,
+  validationErrors,
+  isDisabled,
+  registerTimeout
+}: UseCoordinateCopyOptions): UseCoordinateCopyResult;
+//#endregion
+export { UseCoordinateCopyOptions, UseCoordinateCopyResult, useCoordinateCopy };
+//# sourceMappingURL=use-coordinate-copy.d.ts.map

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

@@ -1,2 +1,88 @@
-import {getLogger}from'@accelint/logger';import {useState}from'react';import {getAllCoordinateFormats}from'../../components/coordinate-field/coordinate-utils.js';const f=getLogger({enabled:process.env.NODE_ENV!=="production",level:"debug",prefix:"[CoordinateField]",pretty:true});const l=2e3;function v({currentValue:r,validationErrors:s,isDisabled:d,registerTimeout:a}){const[m,t]=useState(null),p=(o,n)=>{const e=document.createElement("textarea");e.value=o,e.style.position="fixed",e.style.left="-999999px",e.style.top="-999999px",document.body.appendChild(e),e.focus(),e.select();try{document.execCommand("copy"),t(n),a(setTimeout(()=>{t(null);},l));}catch(i){f.withError(i).warn("Fallback copy to clipboard failed");}document.body.removeChild(e);},u=async o=>{if(!r)return;const e=getAllCoordinateFormats(r)[o];if(e.isValid)try{await navigator.clipboard.writeText(e.value),t(o),a(setTimeout(()=>{t(null);},l));}catch{p(e.value,o);}},c=r!==null&&s.length===0&&!d;return {copiedFormat:m,handleCopyFormat:u,isFormatButtonEnabled:c}}export{v as useCoordinateCopy};//# sourceMappingURL=use-coordinate-copy.js.map
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { getAllCoordinateFormats } from "../../components/coordinate-field/coordinate-utils.js";
+import { useState } from "react";
+import { getLogger } from "@accelint/logger";
+
+//#region src/hooks/coordinate-field/use-coordinate-copy.ts
+const logger = getLogger({
+	enabled: process.env.NODE_ENV !== "production",
+	level: "debug",
+	prefix: "[CoordinateField]",
+	pretty: true
+});
+const COPY_FEEDBACK_DURATION_MS = 2e3;
+function useCoordinateCopy({ currentValue, validationErrors, isDisabled, registerTimeout }) {
+	const [copiedFormat, setCopiedFormat] = useState(null);
+	/**
+	* Fallback clipboard copy for browsers that don't support navigator.clipboard API.
+	* Creates a temporary textarea, copies text using document.execCommand('copy'),
+	* and provides visual feedback by setting copiedFormat state for 2 seconds.
+	*
+	* @param text - The coordinate string to copy to clipboard
+	* @param formatToCopy - The coordinate format being copied (for UI feedback)
+	*/
+	const fallbackCopyToClipboard = (text, formatToCopy) => {
+		const textArea = document.createElement("textarea");
+		textArea.value = text;
+		textArea.style.position = "fixed";
+		textArea.style.left = "-999999px";
+		textArea.style.top = "-999999px";
+		document.body.appendChild(textArea);
+		textArea.focus();
+		textArea.select();
+		try {
+			document.execCommand("copy");
+			setCopiedFormat(formatToCopy);
+			registerTimeout(setTimeout(() => {
+				setCopiedFormat(null);
+			}, COPY_FEEDBACK_DURATION_MS));
+		} catch (err) {
+			logger.withError(err).warn("Fallback copy to clipboard failed");
+		}
+		document.body.removeChild(textArea);
+	};
+	/**
+	* Handles copying a coordinate in the specified format to the clipboard.
+	* Uses modern clipboard API (navigator.clipboard.writeText) with fallback
+	* to document.execCommand for older browsers.
+	*
+	* Sets copiedFormat state to show visual feedback (Check icon) for 2 seconds.
+	*
+	* @param formatToCopy - The coordinate format to copy (dd, ddm, dms, mgrs, utm)
+	*/
+	const handleCopyFormat = async (formatToCopy) => {
+		if (!currentValue) return;
+		const formatResult = getAllCoordinateFormats(currentValue)[formatToCopy];
+		if (!formatResult.isValid) return;
+		try {
+			await navigator.clipboard.writeText(formatResult.value);
+			setCopiedFormat(formatToCopy);
+			registerTimeout(setTimeout(() => {
+				setCopiedFormat(null);
+			}, COPY_FEEDBACK_DURATION_MS));
+		} catch (_err) {
+			fallbackCopyToClipboard(formatResult.value, formatToCopy);
+		}
+	};
+	return {
+		copiedFormat,
+		handleCopyFormat,
+		isFormatButtonEnabled: currentValue !== null && validationErrors.length === 0 && !isDisabled
+	};
+}
+
+//#endregion
+export { useCoordinateCopy };
 //# sourceMappingURL=use-coordinate-copy.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/coordinate-field/use-coordinate-copy.ts"],"names":["logger","getLogger","useState","text","formatToCopy","textArea","registerTimeout","handleCopyFormat","currentValue","formatResult","isFormatButtonEnabled","isDisabled"],"mappings":"kKAeA,MAAMA,CAAAA,CAASC,SAAAA,CAAU,CACvB,OAAA,CAAS,OAAA,CAAQ,IAAI,QAAA,GAAa,YAAA,CAClC,MAAO,OAAA,CACP,MAAA,CAAQ,oBACR,MAAA,CAAQ,IACV,CAAC,CAAA,OASiC,CAAA,CAe3B,4BAEL,CAAA,CAAA,CAAA,gBACA,CAAA,CAAA,CAAA,4BAEoD,CACpD,CAAA,CAAA,CAAA,CAAA,KAAoC,CAAA,CAAIC,CAAAA,CACtC,WACF,IAUgC,CAC9BC,CAAAA,CACAC,CAAAA,CAAAA,CAAAA,CACG,CAEH,GAAA,CAAA,gBAA0B,CAAA,aAAc,CAAA,UAC/B,CAAA,CAAA,CAAA,CAAA,KAETC,CAAS,CAAA,CAAA,CAAA,CAAA,cAAiB,CAAA,eACX,CAAA,IAAO,CAAA,WACb,CAAA,CAAA,CAAA,KAAM,CAAM,eACrB,CAAA,QAAS,CAAA,gBACTA,EAAS,CAAA,CAAA,CAAA,CAAA,OACA,CAAA,CAAA,CAAA,QAEL,CACF,GAAA,CAAA,QAAS,CAAA,WAAY,CAAA,MAGLD,CAAY,CAAA,CAG5BE,CAAAA,CACE,cAAW,CAAM,IACC,CAAA,CAAA,CAAI,IACM,EAC9B,CACF,CAAA,CAAA,CAAA,EAAA,CAAA,MACEN,CAAO,CAAA,CAAA,CAAA,CAAA,SAAe,CAAA,CAAA,CAAA,CAAA,mDAIf,CAAA,IAAK,CAAA,WAChB,CAWMO,GAAmB,CAAA,CAAA,CAAA,CAAA,MACvB,CAAA,EAAI,CAACC,GACH,CAAA,CAAA,CAAA,OAIF,MAD2CA,CAAY,wBACvBJ,CAAY,CAAA,CAE5C,CAAA,CAAA,CAAKK,CAAAA,GAAa,CAAA,CAAA,OAId,CAEF,GAAA,CAAA,MAAM,mBAAoB,CAAA,iBAGVL,CAAY,CAAA,CAG5BE,CAAAA,CACE,cAAW,CAAM,IACC,CAAA,CAAA,CAAI,IACM,EAC9B,CACF,CAAA,CAAA,CAAA,EAAA,CAAA,KAE0BG,CAAa,CAAA,CAAA,CAAA,CAAA,KAEzC,EAEMC,EAAAA,CACJF,CAAAA,CAAAA,CAAAA,CAAiB,QAAyB,EAAA,CAAA,CAAA,SAAiBG,CAAAA,YAG3D,CAAA,YACA,CAAA,CAAA,CAAA,gBACA,CAAA,CAAA,CAAA,qBAEJ,CAAA,CAAA,CAAA","file":"use-coordinate-copy.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';\nimport { useState } from 'react';\n\nconst logger = getLogger({\n  enabled: process.env.NODE_ENV !== 'production',\n  level: 'debug',\n  prefix: '[CoordinateField]',\n  pretty: true,\n});\n\nimport { getAllCoordinateFormats } from '../../components/coordinate-field/coordinate-utils';\nimport type {\n  CoordinateSystem,\n  CoordinateValue,\n} from '../../components/coordinate-field/types';\nimport type { UseTimeoutCleanupResult } from './use-timeout-cleanup';\n\nconst COPY_FEEDBACK_DURATION_MS = 2000;\n\nexport interface UseCoordinateCopyOptions {\n  currentValue: CoordinateValue | null;\n  validationErrors: string[];\n  isDisabled: boolean;\n  registerTimeout: UseTimeoutCleanupResult['registerTimeout'];\n}\n\nexport interface UseCoordinateCopyResult {\n  copiedFormat: CoordinateSystem | null;\n  handleCopyFormat: (formatToCopy: CoordinateSystem) => Promise<void>;\n  isFormatButtonEnabled: boolean;\n}\n\nexport function useCoordinateCopy({\n  currentValue,\n  validationErrors,\n  isDisabled,\n  registerTimeout,\n}: UseCoordinateCopyOptions): UseCoordinateCopyResult {\n  const [copiedFormat, setCopiedFormat] = useState<CoordinateSystem | null>(\n    null,\n  );\n\n  /**\n   * Fallback clipboard copy for browsers that don't support navigator.clipboard API.\n   * Creates a temporary textarea, copies text using document.execCommand('copy'),\n   * and provides visual feedback by setting copiedFormat state for 2 seconds.\n   *\n   * @param text - The coordinate string to copy to clipboard\n   * @param formatToCopy - The coordinate format being copied (for UI feedback)\n   */\n  const fallbackCopyToClipboard = (\n    text: string,\n    formatToCopy: CoordinateSystem,\n  ) => {\n    // Create temporary textarea for copy operation\n    const textArea = document.createElement('textarea');\n    textArea.value = text;\n    // Position off-screen so it's not visible to user\n    textArea.style.position = 'fixed';\n    textArea.style.left = '-999999px';\n    textArea.style.top = '-999999px';\n    document.body.appendChild(textArea);\n    textArea.focus();\n    textArea.select();\n\n    try {\n      document.execCommand('copy');\n\n      // Set copied format to show Check icon in UI\n      setCopiedFormat(formatToCopy);\n\n      // Reset to null after 2 seconds to return to Copy icon\n      registerTimeout(\n        setTimeout(() => {\n          setCopiedFormat(null);\n        }, COPY_FEEDBACK_DURATION_MS),\n      );\n    } catch (err) {\n      logger.withError(err).warn('Fallback copy to clipboard failed');\n    }\n\n    // Clean up temporary textarea\n    document.body.removeChild(textArea);\n  };\n\n  /**\n   * Handles copying a coordinate in the specified format to the clipboard.\n   * Uses modern clipboard API (navigator.clipboard.writeText) with fallback\n   * to document.execCommand for older browsers.\n   *\n   * Sets copiedFormat state to show visual feedback (Check icon) for 2 seconds.\n   *\n   * @param formatToCopy - The coordinate format to copy (dd, ddm, dms, mgrs, utm)\n   */\n  const handleCopyFormat = async (formatToCopy: CoordinateSystem) => {\n    if (!currentValue) {\n      return;\n    }\n\n    const allFormats = getAllCoordinateFormats(currentValue);\n    const formatResult = allFormats[formatToCopy];\n\n    if (!formatResult.isValid) {\n      return;\n    }\n\n    try {\n      // Modern clipboard API - copy and show feedback\n      await navigator.clipboard.writeText(formatResult.value);\n\n      // Set copied format to show Check icon in UI\n      setCopiedFormat(formatToCopy);\n\n      // Reset to null after 2 seconds to return to Copy icon\n      registerTimeout(\n        setTimeout(() => {\n          setCopiedFormat(null);\n        }, COPY_FEEDBACK_DURATION_MS),\n      );\n    } catch (_err) {\n      // Fall back to document.execCommand for older browsers\n      fallbackCopyToClipboard(formatResult.value, formatToCopy);\n    }\n  };\n\n  const isFormatButtonEnabled =\n    currentValue !== null && validationErrors.length === 0 && !isDisabled;\n\n  return {\n    copiedFormat,\n    handleCopyFormat,\n    isFormatButtonEnabled,\n  };\n}\n"]}
+{"version":3,"file":"use-coordinate-copy.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-coordinate-copy.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { getLogger } from '@accelint/logger';\nimport { useState } from 'react';\n\nconst logger = getLogger({\n  enabled: process.env.NODE_ENV !== 'production',\n  level: 'debug',\n  prefix: '[CoordinateField]',\n  pretty: true,\n});\n\nimport { getAllCoordinateFormats } from '../../components/coordinate-field/coordinate-utils';\nimport type {\n  CoordinateSystem,\n  CoordinateValue,\n} from '../../components/coordinate-field/types';\nimport type { UseTimeoutCleanupResult } from './use-timeout-cleanup';\n\nconst COPY_FEEDBACK_DURATION_MS = 2000;\n\nexport interface UseCoordinateCopyOptions {\n  currentValue: CoordinateValue | null;\n  validationErrors: string[];\n  isDisabled: boolean;\n  registerTimeout: UseTimeoutCleanupResult['registerTimeout'];\n}\n\nexport interface UseCoordinateCopyResult {\n  copiedFormat: CoordinateSystem | null;\n  handleCopyFormat: (formatToCopy: CoordinateSystem) => Promise<void>;\n  isFormatButtonEnabled: boolean;\n}\n\nexport function useCoordinateCopy({\n  currentValue,\n  validationErrors,\n  isDisabled,\n  registerTimeout,\n}: UseCoordinateCopyOptions): UseCoordinateCopyResult {\n  const [copiedFormat, setCopiedFormat] = useState<CoordinateSystem | null>(\n    null,\n  );\n\n  /**\n   * Fallback clipboard copy for browsers that don't support navigator.clipboard API.\n   * Creates a temporary textarea, copies text using document.execCommand('copy'),\n   * and provides visual feedback by setting copiedFormat state for 2 seconds.\n   *\n   * @param text - The coordinate string to copy to clipboard\n   * @param formatToCopy - The coordinate format being copied (for UI feedback)\n   */\n  const fallbackCopyToClipboard = (\n    text: string,\n    formatToCopy: CoordinateSystem,\n  ) => {\n    // Create temporary textarea for copy operation\n    const textArea = document.createElement('textarea');\n    textArea.value = text;\n    // Position off-screen so it's not visible to user\n    textArea.style.position = 'fixed';\n    textArea.style.left = '-999999px';\n    textArea.style.top = '-999999px';\n    document.body.appendChild(textArea);\n    textArea.focus();\n    textArea.select();\n\n    try {\n      document.execCommand('copy');\n\n      // Set copied format to show Check icon in UI\n      setCopiedFormat(formatToCopy);\n\n      // Reset to null after 2 seconds to return to Copy icon\n      registerTimeout(\n        setTimeout(() => {\n          setCopiedFormat(null);\n        }, COPY_FEEDBACK_DURATION_MS),\n      );\n    } catch (err) {\n      logger.withError(err).warn('Fallback copy to clipboard failed');\n    }\n\n    // Clean up temporary textarea\n    document.body.removeChild(textArea);\n  };\n\n  /**\n   * Handles copying a coordinate in the specified format to the clipboard.\n   * Uses modern clipboard API (navigator.clipboard.writeText) with fallback\n   * to document.execCommand for older browsers.\n   *\n   * Sets copiedFormat state to show visual feedback (Check icon) for 2 seconds.\n   *\n   * @param formatToCopy - The coordinate format to copy (dd, ddm, dms, mgrs, utm)\n   */\n  const handleCopyFormat = async (formatToCopy: CoordinateSystem) => {\n    if (!currentValue) {\n      return;\n    }\n\n    const allFormats = getAllCoordinateFormats(currentValue);\n    const formatResult = allFormats[formatToCopy];\n\n    if (!formatResult.isValid) {\n      return;\n    }\n\n    try {\n      // Modern clipboard API - copy and show feedback\n      await navigator.clipboard.writeText(formatResult.value);\n\n      // Set copied format to show Check icon in UI\n      setCopiedFormat(formatToCopy);\n\n      // Reset to null after 2 seconds to return to Copy icon\n      registerTimeout(\n        setTimeout(() => {\n          setCopiedFormat(null);\n        }, COPY_FEEDBACK_DURATION_MS),\n      );\n    } catch (_err) {\n      // Fall back to document.execCommand for older browsers\n      fallbackCopyToClipboard(formatResult.value, formatToCopy);\n    }\n  };\n\n  const isFormatButtonEnabled =\n    currentValue !== null && validationErrors.length === 0 && !isDisabled;\n\n  return {\n    copiedFormat,\n    handleCopyFormat,\n    isFormatButtonEnabled,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAeA,MAAM,SAAS,UAAU;CACvB,SAAS,QAAQ,IAAI,aAAa;CAClC,OAAO;CACP,QAAQ;CACR,QAAQ;CACT,CAAC;AASF,MAAM,4BAA4B;AAelC,SAAgB,kBAAkB,EAChC,cACA,kBACA,YACA,mBACoD;CACpD,MAAM,CAAC,cAAc,mBAAmB,SACtC,KACD;;;;;;;;;CAUD,MAAM,2BACJ,MACA,iBACG;EAEH,MAAM,WAAW,SAAS,cAAc,WAAW;AACnD,WAAS,QAAQ;AAEjB,WAAS,MAAM,WAAW;AAC1B,WAAS,MAAM,OAAO;AACtB,WAAS,MAAM,MAAM;AACrB,WAAS,KAAK,YAAY,SAAS;AACnC,WAAS,OAAO;AAChB,WAAS,QAAQ;AAEjB,MAAI;AACF,YAAS,YAAY,OAAO;AAG5B,mBAAgB,aAAa;AAG7B,mBACE,iBAAiB;AACf,oBAAgB,KAAK;MACpB,0BAA0B,CAC9B;WACM,KAAK;AACZ,UAAO,UAAU,IAAI,CAAC,KAAK,oCAAoC;;AAIjE,WAAS,KAAK,YAAY,SAAS;;;;;;;;;;;CAYrC,MAAM,mBAAmB,OAAO,iBAAmC;AACjE,MAAI,CAAC,aACH;EAIF,MAAM,eADa,wBAAwB,aAAa,CACxB;AAEhC,MAAI,CAAC,aAAa,QAChB;AAGF,MAAI;AAEF,SAAM,UAAU,UAAU,UAAU,aAAa,MAAM;AAGvD,mBAAgB,aAAa;AAG7B,mBACE,iBAAiB;AACf,oBAAgB,KAAK;MACpB,0BAA0B,CAC9B;WACM,MAAM;AAEb,2BAAwB,aAAa,OAAO,aAAa;;;AAO7D,QAAO;EACL;EACA;EACA,uBALA,iBAAiB,QAAQ,iBAAiB,WAAW,KAAK,CAAC;EAM5D"}

package/dist/hooks/coordinate-field/use-coordinate-field-state.d.ts

@@ -1,28 +1,48 @@
-import { Dispatch, SetStateAction } from 'react';
-import { CoordinateValue, CoordinateSystem, SegmentConfig } from '../../components/coordinate-field/types.js';
-import 'react-aria-components';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+import { CoordinateSystem, CoordinateValue, SegmentConfig } from "../../components/coordinate-field/types.js";
+import { Dispatch, SetStateAction } from "react";
+
+//#region src/hooks/coordinate-field/use-coordinate-field-state.d.ts
 interface UseCoordinateFieldStateOptions {
-    value?: CoordinateValue | null;
-    defaultValue?: CoordinateValue;
-    format: CoordinateSystem;
-    onChange?: Dispatch<SetStateAction<CoordinateValue | null>> | ((value: CoordinateValue | null) => void);
-    onError?: (message: string, context?: Record<string, unknown>) => void;
-    registerTimeout?: (timeoutId: NodeJS.Timeout) => void;
+  value?: CoordinateValue | null;
+  defaultValue?: CoordinateValue;
+  format: CoordinateSystem;
+  onChange?: Dispatch<SetStateAction<CoordinateValue | null>> | ((value: CoordinateValue | null) => void);
+  onError?: (message: string, context?: Record<string, unknown>) => void;
+  registerTimeout?: (timeoutId: NodeJS.Timeout) => void;
 }
 interface UseCoordinateFieldStateResult {
-    currentValue: CoordinateValue | null;
-    segmentValues: string[];
-    validationErrors: string[];
-    segmentConfigs: SegmentConfig[];
-    editableSegmentConfigs: SegmentConfig[];
-    handleSegmentChange: (index: number, newValue: string) => void;
-    setSegmentValues: (values: string[]) => void;
-    setValidationErrors: (errors: string[]) => void;
-    effectiveErrorMessage: string | null;
-    applyPastedCoordinate: (pastedValue: CoordinateValue) => void;
-    flushPendingValidation: () => void;
+  currentValue: CoordinateValue | null;
+  segmentValues: string[];
+  validationErrors: string[];
+  segmentConfigs: SegmentConfig[];
+  editableSegmentConfigs: SegmentConfig[];
+  handleSegmentChange: (index: number, newValue: string) => void;
+  setSegmentValues: (values: string[]) => void;
+  setValidationErrors: (errors: string[]) => void;
+  effectiveErrorMessage: string | null;
+  applyPastedCoordinate: (pastedValue: CoordinateValue) => void;
+  flushPendingValidation: () => void;
 }
-declare function useCoordinateFieldState({ value, defaultValue, format, onChange, onError, registerTimeout, }: UseCoordinateFieldStateOptions): UseCoordinateFieldStateResult;
-
-export { type UseCoordinateFieldStateOptions, type UseCoordinateFieldStateResult, useCoordinateFieldState };
+declare function useCoordinateFieldState({
+  value,
+  defaultValue,
+  format,
+  onChange,
+  onError,
+  registerTimeout
+}: UseCoordinateFieldStateOptions): UseCoordinateFieldStateResult;
+//#endregion
+export { UseCoordinateFieldStateOptions, UseCoordinateFieldStateResult, useCoordinateFieldState };
+//# sourceMappingURL=use-coordinate-field-state.d.ts.map

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

@@ -1,2 +1,147 @@
-import {useState,useRef,useMemo,useCallback,useEffect}from'react';import {convertDDToDisplaySegments,areAllSegmentsFilled,validateCoordinateSegments,convertDisplaySegmentsToDD}from'../../components/coordinate-field/coordinate-utils.js';import {getSegmentConfigs}from'../../components/coordinate-field/segment-configs.js';function B({value:o,defaultValue:h,format:n,onChange:b,onError:y,registerTimeout:x}){const[m,I]=useState(h||null),[C,i]=useState([]),l=useRef(null),T=o!==void 0?o:m,s=()=>{l.current&&(clearTimeout(l.current),l.current=null);},a=e=>{o===void 0&&I(e),b?.(e);},S=useMemo(()=>getSegmentConfigs(n),[n]),d=useMemo(()=>S.filter(e=>e.type!=="literal"),[S]),[g,c]=useState(()=>{const e=o!==void 0?o:h;if(!e)return new Array(d.length).fill("");const t=convertDDToDisplaySegments(e,n);return t||new Array(d.length).fill("")}),f=useCallback(e=>{s();const t=e?convertDDToDisplaySegments(e,n):null;c(t||new Array(d.length).fill("")),i([]);},[n,d.length]),D=useRef(n);useEffect(()=>{D.current!==n&&(D.current=n,f(o!==void 0?o:m));},[n,o,m,f]),useEffect(()=>{o!==void 0&&f(o);},[o,f]);const A=e=>{const t=validateCoordinateSegments(e,n);if(t.length>0){i(t),y?.("Invalid coordinate value",{errors:t,format:n,segments:e}),a(null);return}const r=convertDisplaySegmentsToDD(e,n);if(!r){const u="Invalid coordinate value";i([u]),y?.(u,{format:n,segments:e}),a(null);return}i([]),a(r);},U=(e,t)=>{const r=[...g];if(r[e]=t,c(r),areAllSegmentsFilled(r)){s();const u=setTimeout(()=>{A(r),l.current=null;},400);l.current=u,x?.(u);}else s(),i([]),T!==null&&a(null);},w=e=>{s();const t=convertDDToDisplaySegments(e,n);t&&(c(t),i([]),a(e));},M=()=>{l.current&&(s(),areAllSegmentsFilled(g)&&A(g));},P=useMemo(()=>C[0]||null,[C]);return {currentValue:T,segmentValues:g,validationErrors:C,segmentConfigs:S,editableSegmentConfigs:d,handleSegmentChange:U,setSegmentValues:c,setValidationErrors:i,effectiveErrorMessage:P,applyPastedCoordinate:w,flushPendingValidation:M}}export{B as useCoordinateFieldState};//# sourceMappingURL=use-coordinate-field-state.js.map
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { areAllSegmentsFilled, convertDDToDisplaySegments, convertDisplaySegmentsToDD, validateCoordinateSegments } from "../../components/coordinate-field/coordinate-utils.js";
+import { getSegmentConfigs } from "../../components/coordinate-field/segment-configs.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+//#region src/hooks/coordinate-field/use-coordinate-field-state.ts
+function useCoordinateFieldState({ value, defaultValue, format, onChange, onError, registerTimeout }) {
+	const [internalValue, setInternalValue] = useState(defaultValue || null);
+	const [validationErrors, setValidationErrors] = useState([]);
+	const validationTimeoutRef = useRef(null);
+	const currentValue = value !== void 0 ? value : internalValue;
+	const clearValidationTimeout = () => {
+		if (validationTimeoutRef.current) {
+			clearTimeout(validationTimeoutRef.current);
+			validationTimeoutRef.current = null;
+		}
+	};
+	const handleChange = (newValue) => {
+		if (value === void 0) setInternalValue(newValue);
+		onChange?.(newValue);
+	};
+	const segmentConfigs = useMemo(() => getSegmentConfigs(format), [format]);
+	const editableSegmentConfigs = useMemo(() => segmentConfigs.flat().filter((config) => config.type !== "literal"), [segmentConfigs]);
+	const [segmentValues, setSegmentValues] = useState(() => {
+		const initialValue = value !== void 0 ? value : defaultValue;
+		if (!initialValue) return new Array(editableSegmentConfigs.length).fill("");
+		const segments = convertDDToDisplaySegments(initialValue, format);
+		if (!segments) return new Array(editableSegmentConfigs.length).fill("");
+		return segments;
+	});
+	const convertValueToSegmentsOrClear = useCallback((valueToConvert) => {
+		clearValidationTimeout();
+		setSegmentValues((valueToConvert ? convertDDToDisplaySegments(valueToConvert, format) : null) || new Array(editableSegmentConfigs.length).fill(""));
+		setValidationErrors([]);
+	}, [format, editableSegmentConfigs.length]);
+	const prevFormatRef = useRef(format);
+	useEffect(() => {
+		if (prevFormatRef.current !== format) {
+			prevFormatRef.current = format;
+			convertValueToSegmentsOrClear(value !== void 0 ? value : internalValue);
+		}
+	}, [
+		format,
+		value,
+		internalValue,
+		convertValueToSegmentsOrClear
+	]);
+	useEffect(() => {
+		if (value !== void 0) convertValueToSegmentsOrClear(value);
+	}, [value, convertValueToSegmentsOrClear]);
+	/**
+	* Validates segment values and updates the coordinate state
+	*
+	* When validation fails, calls onError with "Invalid coordinate value" message
+	* and context containing the detailed validation errors from @accelint/geo.
+	*
+	* @param updatedValues - Array of segment values to validate
+	*/
+	const validateAndUpdateCoordinate = (updatedValues) => {
+		const errors = validateCoordinateSegments(updatedValues, format);
+		if (errors.length > 0) {
+			setValidationErrors(errors);
+			onError?.("Invalid coordinate value", {
+				errors,
+				format,
+				segments: updatedValues
+			});
+			handleChange(null);
+			return;
+		}
+		const ddValue = convertDisplaySegmentsToDD(updatedValues, format);
+		if (!ddValue) {
+			const errorMsg = "Invalid coordinate value";
+			setValidationErrors([errorMsg]);
+			onError?.(errorMsg, {
+				format,
+				segments: updatedValues
+			});
+			handleChange(null);
+			return;
+		}
+		setValidationErrors([]);
+		handleChange(ddValue);
+	};
+	const handleSegmentChange = (index, newValue) => {
+		const updatedValues = [...segmentValues];
+		updatedValues[index] = newValue;
+		setSegmentValues(updatedValues);
+		if (areAllSegmentsFilled(updatedValues)) {
+			clearValidationTimeout();
+			const timeoutId = setTimeout(() => {
+				validateAndUpdateCoordinate(updatedValues);
+				validationTimeoutRef.current = null;
+			}, 400);
+			validationTimeoutRef.current = timeoutId;
+			registerTimeout?.(timeoutId);
+		} else {
+			clearValidationTimeout();
+			setValidationErrors([]);
+			if (currentValue !== null) handleChange(null);
+		}
+	};
+	const applyPastedCoordinate = (pastedValue) => {
+		clearValidationTimeout();
+		const segments = convertDDToDisplaySegments(pastedValue, format);
+		if (segments) {
+			setSegmentValues(segments);
+			setValidationErrors([]);
+			handleChange(pastedValue);
+		}
+	};
+	const flushPendingValidation = () => {
+		if (validationTimeoutRef.current) {
+			clearValidationTimeout();
+			if (areAllSegmentsFilled(segmentValues)) validateAndUpdateCoordinate(segmentValues);
+		}
+	};
+	return {
+		currentValue,
+		segmentValues,
+		validationErrors,
+		segmentConfigs,
+		editableSegmentConfigs,
+		handleSegmentChange,
+		setSegmentValues,
+		setValidationErrors,
+		effectiveErrorMessage: useMemo(() => validationErrors[0] || null, [validationErrors]),
+		applyPastedCoordinate,
+		flushPendingValidation
+	};
+}
+
+//#endregion
+export { useCoordinateFieldState };
 //# sourceMappingURL=use-coordinate-field-state.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/coordinate-field/use-coordinate-field-state.ts"],"names":["value","format","onError","internalValue","setInternalValue","defaultValue","p","validationErrors","useState","validationTimeoutRef","useRef","currentValue","handleChange","onChange","newValue","segmentConfigs","getSegmentConfigs","N","editableSegmentConfigs","useMemo","V","config","segmentValues","setSegmentValues","initialValue","segments","convertDDToDisplaySegments","v","convertValueToSegmentsOrClear","useCallback","valueToConvert","clearValidationTimeout","O","useEffect","F","prevFormatRef","validateAndUpdateCoordinate","updatedValues","errors","validateCoordinateSegments","ddValue","convertDisplaySegmentsToDD","k","errorMsg","setValidationErrors","handleSegmentChange","index","areAllSegmentsFilled","R","timeoutId","applyPastedCoordinate","pastedValue","flushPendingValidation","effectiveErrorMessage"],"mappings":"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","file":"use-coordinate-field-state.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 {\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\nexport interface UseCoordinateFieldStateOptions {\n  value?: CoordinateValue | null;\n  defaultValue?: CoordinateValue;\n  format: CoordinateSystem;\n  onChange?:\n    | Dispatch<SetStateAction<CoordinateValue | null>>\n    | ((value: CoordinateValue | null) => void);\n  onError?: (message: string, context?: Record<string, unknown>) => void;\n  registerTimeout?: (timeoutId: NodeJS.Timeout) => void;\n}\n\nexport interface UseCoordinateFieldStateResult {\n  currentValue: CoordinateValue | null;\n  segmentValues: string[];\n  validationErrors: string[];\n  segmentConfigs: SegmentConfig[];\n  editableSegmentConfigs: SegmentConfig[];\n  handleSegmentChange: (index: number, newValue: string) => void;\n  setSegmentValues: (values: string[]) => void;\n  setValidationErrors: (errors: string[]) => void;\n  effectiveErrorMessage: string | null;\n  applyPastedCoordinate: (pastedValue: CoordinateValue) => void;\n  flushPendingValidation: () => void;\n}\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.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    updatedValues[index] = newValue;\n    setSegmentValues(updatedValues);\n\n    if (areAllSegmentsFilled(updatedValues)) {\n      // Clear any pending validation timeout\n      clearValidationTimeout();\n\n      // Debounce validation by 400ms when all segments are full\n      const timeoutId = setTimeout(() => {\n        validateAndUpdateCoordinate(updatedValues);\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 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    setSegmentValues,\n    setValidationErrors,\n    effectiveErrorMessage,\n    applyPastedCoordinate,\n    flushPendingValidation,\n  };\n}\n"]}
+{"version":3,"file":"use-coordinate-field-state.js","names":[],"sources":["../../../src/hooks/coordinate-field/use-coordinate-field-state.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\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\nexport interface UseCoordinateFieldStateOptions {\n  value?: CoordinateValue | null;\n  defaultValue?: CoordinateValue;\n  format: CoordinateSystem;\n  onChange?:\n    | Dispatch<SetStateAction<CoordinateValue | null>>\n    | ((value: CoordinateValue | null) => void);\n  onError?: (message: string, context?: Record<string, unknown>) => void;\n  registerTimeout?: (timeoutId: NodeJS.Timeout) => void;\n}\n\nexport interface UseCoordinateFieldStateResult {\n  currentValue: CoordinateValue | null;\n  segmentValues: string[];\n  validationErrors: string[];\n  segmentConfigs: SegmentConfig[];\n  editableSegmentConfigs: SegmentConfig[];\n  handleSegmentChange: (index: number, newValue: string) => void;\n  setSegmentValues: (values: string[]) => void;\n  setValidationErrors: (errors: string[]) => void;\n  effectiveErrorMessage: string | null;\n  applyPastedCoordinate: (pastedValue: CoordinateValue) => void;\n  flushPendingValidation: () => void;\n}\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    updatedValues[index] = newValue;\n    setSegmentValues(updatedValues);\n\n    if (areAllSegmentsFilled(updatedValues)) {\n      // Clear any pending validation timeout\n      clearValidationTimeout();\n\n      // Debounce validation by 400ms when all segments are full\n      const timeoutId = setTimeout(() => {\n        validateAndUpdateCoordinate(updatedValues);\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 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    setSegmentValues,\n    setValidationErrors,\n    effectiveErrorMessage,\n    applyPastedCoordinate,\n    flushPendingValidation,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2DA,SAAgB,wBAAwB,EACtC,OACA,cACA,QACA,UACA,SACA,mBACgE;CAChE,MAAM,CAAC,eAAe,oBAAoB,SACxC,gBAAgB,KACjB;CACD,MAAM,CAAC,kBAAkB,uBAAuB,SAAmB,EAAE,CAAC;CACtE,MAAM,uBAAuB,OAA8B,KAAK;CAEhE,MAAM,eAAe,UAAU,SAAY,QAAQ;CAEnD,MAAM,+BAA+B;AACnC,MAAI,qBAAqB,SAAS;AAChC,gBAAa,qBAAqB,QAAQ;AAC1C,wBAAqB,UAAU;;;CAInC,MAAM,gBAAgB,aAAqC;AACzD,MAAI,UAAU,OACZ,kBAAiB,SAAS;AAE5B,aAAW,SAAS;;CAGtB,MAAM,iBAAiB,cAAc,kBAAkB,OAAO,EAAE,CAAC,OAAO,CAAC;CAEzE,MAAM,yBAAyB,cACvB,eAAe,MAAM,CAAC,QAAQ,WAAW,OAAO,SAAS,UAAU,EACzE,CAAC,eAAe,CACjB;CAED,MAAM,CAAC,eAAe,oBAAoB,eAAyB;EACjE,MAAM,eAAe,UAAU,SAAY,QAAQ;AACnD,MAAI,CAAC,aACH,QAAO,IAAI,MAAM,uBAAuB,OAAO,CAAC,KAAK,GAAG;EAG1D,MAAM,WAAW,2BAA2B,cAAc,OAAO;AACjE,MAAI,CAAC,SACH,QAAO,IAAI,MAAM,uBAAuB,OAAO,CAAC,KAAK,GAAG;AAG1D,SAAO;GACP;CAEF,MAAM,gCAAgC,aACnC,mBAA2C;AAE1C,0BAAwB;AAMxB,oBAJiB,iBACb,2BAA2B,gBAAgB,OAAO,GAClD,SAGU,IAAI,MAAM,uBAAuB,OAAO,CAAC,KAAK,GAAG,CAC9D;AACD,sBAAoB,EAAE,CAAC;IAEzB,CAAC,QAAQ,uBAAuB,OAAO,CACxC;CAED,MAAM,gBAAgB,OAAO,OAAO;AAEpC,iBAAgB;AACd,MAAI,cAAc,YAAY,QAAQ;AACpC,iBAAc,UAAU;AAExB,iCADuB,UAAU,SAAY,QAAQ,cACR;;IAE9C;EAAC;EAAQ;EAAO;EAAe;EAA8B,CAAC;AAEjE,iBAAgB;AACd,MAAI,UAAU,OACZ,+BAA8B,MAAM;IAErC,CAAC,OAAO,8BAA8B,CAAC;;;;;;;;;CAU1C,MAAM,+BAA+B,kBAA4B;EAC/D,MAAM,SAAS,2BAA2B,eAAe,OAAO;AAEhE,MAAI,OAAO,SAAS,GAAG;AACrB,uBAAoB,OAAO;AAC3B,aAAU,4BAA4B;IACpC;IACA;IACA,UAAU;IACX,CAAC;AACF,gBAAa,KAAK;AAClB;;EAGF,MAAM,UAAU,2BAA2B,eAAe,OAAO;AACjE,MAAI,CAAC,SAAS;GACZ,MAAM,WAAW;AACjB,uBAAoB,CAAC,SAAS,CAAC;AAC/B,aAAU,UAAU;IAAE;IAAQ,UAAU;IAAe,CAAC;AACxD,gBAAa,KAAK;AAClB;;AAGF,sBAAoB,EAAE,CAAC;AACvB,eAAa,QAAQ;;CAGvB,MAAM,uBAAuB,OAAe,aAAqB;EAC/D,MAAM,gBAAgB,CAAC,GAAG,cAAc;AACxC,gBAAc,SAAS;AACvB,mBAAiB,cAAc;AAE/B,MAAI,qBAAqB,cAAc,EAAE;AAEvC,2BAAwB;GAGxB,MAAM,YAAY,iBAAiB;AACjC,gCAA4B,cAAc;AAC1C,yBAAqB,UAAU;MAC9B,IAAI;AAEP,wBAAqB,UAAU;AAC/B,qBAAkB,UAAU;SACvB;AAEL,2BAAwB;AACxB,uBAAoB,EAAE,CAAC;AACvB,OAAI,iBAAiB,KACnB,cAAa,KAAK;;;CAKxB,MAAM,yBAAyB,gBAAiC;AAE9D,0BAAwB;EAExB,MAAM,WAAW,2BAA2B,aAAa,OAAO;AAEhE,MAAI,UAAU;AACZ,oBAAiB,SAAS;AAC1B,uBAAoB,EAAE,CAAC;AACvB,gBAAa,YAAY;;;CAI7B,MAAM,+BAA+B;AACnC,MAAI,qBAAqB,SAAS;AAChC,2BAAwB;AAGxB,OAAI,qBAAqB,cAAc,CACrC,6BAA4B,cAAc;;;AAUhD,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,uBAd4B,cACtB,iBAAiB,MAAM,MAC7B,CAAC,iBAAiB,CACnB;EAYC;EACA;EACD"}

package/dist/hooks/coordinate-field/use-coordinate-field.d.ts

@@ -1,49 +1,61 @@
-import { useCoordinateCopy } from './use-coordinate-copy.js';
-import { useCoordinateFieldState } from './use-coordinate-field-state.js';
-import { useCoordinateFocus } from './use-coordinate-focus.js';
-import { useCoordinatePaste } from './use-coordinate-paste.js';
-import { ValidationResult } from 'react-aria-components';
-import { CoordinateFieldProps } from '../../components/coordinate-field/types.js';
-import './use-timeout-cleanup.js';
-import 'react';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+import { CoordinateFieldProps } from "../../components/coordinate-field/types.js";
+import { useCoordinateCopy } from "./use-coordinate-copy.js";
+import { useCoordinateFieldState } from "./use-coordinate-field-state.js";
+import { useCoordinateFocus } from "./use-coordinate-focus.js";
+import { useCoordinatePaste } from "./use-coordinate-paste.js";
+import { ValidationResult } from "react-aria-components";
+
+//#region src/hooks/coordinate-field/use-coordinate-field.d.ts
 interface UseCoordinateFieldResult {
-    state: ReturnType<typeof useCoordinateFieldState>;
-    focus: ReturnType<typeof useCoordinateFocus>;
-    paste: ReturnType<typeof useCoordinatePaste>;
-    copy: ReturnType<typeof useCoordinateCopy>;
-    registerTimeout: (timeoutId: NodeJS.Timeout) => void;
-    fieldProps: {
-        id: string;
-        role: 'group';
-        'aria-labelledby': string | undefined;
-        'aria-describedby': string | undefined;
-        'aria-label': string | undefined;
-        'aria-details': string | undefined;
-        'aria-invalid': boolean | undefined;
-        'aria-required': boolean | undefined;
-        'aria-disabled': boolean | undefined;
-    };
-    labelProps: {
-        id: string;
-        htmlFor: string;
-    };
-    descriptionProps: {
-        id: string;
-    };
-    errorProps: {
-        id: string;
-    };
-    validation: ValidationResult;
-    ids: {
-        fieldId: string;
-        labelId: string;
-        descriptionId: string;
-        errorId: string;
-    };
-    effectiveErrorMessage: string | null;
-    isInvalid: boolean;
+  state: ReturnType<typeof useCoordinateFieldState>;
+  focus: ReturnType<typeof useCoordinateFocus>;
+  paste: ReturnType<typeof useCoordinatePaste>;
+  copy: ReturnType<typeof useCoordinateCopy>;
+  registerTimeout: (timeoutId: NodeJS.Timeout) => void;
+  fieldProps: {
+    id: string;
+    role: 'group';
+    'aria-labelledby': string | undefined;
+    'aria-describedby': string | undefined;
+    'aria-label': string | undefined;
+    'aria-details': string | undefined;
+    'aria-invalid': boolean | undefined;
+    'aria-required': boolean | undefined;
+    'aria-disabled': boolean | undefined;
+  };
+  labelProps: {
+    id: string;
+    htmlFor: string;
+  };
+  descriptionProps: {
+    id: string;
+  };
+  errorProps: {
+    id: string;
+  };
+  validation: ValidationResult;
+  ids: {
+    fieldId: string;
+    labelId: string;
+    descriptionId: string;
+    errorId: string;
+  };
+  effectiveErrorMessage: string | null;
+  isInvalid: boolean;
 }
 declare function useCoordinateField(props: CoordinateFieldProps, customAriaLabel?: string, customAriaDescribedby?: string, customAriaDetails?: string): UseCoordinateFieldResult;
-
-export { type UseCoordinateFieldResult, useCoordinateField };
+//#endregion
+export { UseCoordinateFieldResult, useCoordinateField };
+//# sourceMappingURL=use-coordinate-field.d.ts.map