/*
 * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy
 * of the License at https://www.apache.org/licenses/LICENSE-2.0
 *
 * 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 "./types.js";
import "client-only";
import * as react_jsx_runtime81 from "react/jsx-runtime";

//#region src/components/coordinate-field/index.d.ts

/**
 * CoordinateField - A comprehensive coordinate input component with multiple format support
 *
 * Provides accessible coordinate input functionality with support for multiple coordinate
 * systems (DD, DDM, DMS, MGRS, UTM). All values are normalized to Decimal Degrees internally
 * for consistency.
 *
 * @param props - The coordinate field props.
 * @param props.ref - Reference to the coordinate field element.
 * @param props.classNames - Custom class names for sub-elements.
 * @param props.description - Description text displayed below the field.
 * @param props.label - Label text for the coordinate field.
 * @param props.format - Coordinate format to use (dd, ddm, dms, mgrs, utm).
 * @param props.size - Size variant of the field.
 * @param props.variant - Layout variant (inline or stacked).
 * @param props.showFormatButton - Whether to show the format conversion button.
 * @param props.isDisabled - Whether the field is disabled.
 * @param props.isInvalid - Whether the field is in an invalid state.
 * @param props.isRequired - Whether the field is required.
 * @param props.isReadOnly - Whether the field is read-only.
 * @returns The coordinate field component.
 *
 * @example
 * ```tsx
 * // Basic coordinate field
 * <CoordinateField label="Location" />
 * ```
 *
 * @example
 * ```tsx
 * // Coordinate field with validation
 * <CoordinateField
 *   label="Target Coordinates"
 *   isRequired
 *   isInvalid={hasError}
 *   errorMessage="Please enter a valid coordinate"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Coordinate field with specific format
 * <CoordinateField
 *   label="Position"
 *   format="dms"
 *   description="Enter coordinates in Degrees Minutes Seconds format"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Compact coordinate field
 * <CoordinateField
 *   label="Coordinates"
 *   size="small"
 *   format="dd"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Controlled coordinate field
 * <CoordinateField
 *   label="Selected Location"
 *   value={coordinates}
 *   onChange={setCoordinates}
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Coordinate field with error handling
 * <CoordinateField
 *   label="Target Coordinates"
 *   onError={(message, context) => {
 *     // message will be "Invalid coordinate value" for validation errors
 *     // or "Invalid coordinate format" for paste errors
 *     setErrorMessage(message);
 *     console.error(message, context);
 *   }}
 *   isInvalid={!!errorMessage}
 *   errorMessage={errorMessage}
 * />
 * ```
 */
declare function CoordinateField({
  ref,
  ...props
}: CoordinateFieldProps): react_jsx_runtime81.JSX.Element;
//#endregion
export { CoordinateField };
//# sourceMappingURL=index.d.ts.map