/*
 * 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 { DateFieldProps } from "./types.js";
import "client-only";
import * as react_jsx_runtime17 from "react/jsx-runtime";
import { DateValue } from "@internationalized/date";

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

/**
 * DateField - A comprehensive date input component with segmented editing
 *
 * Provides accessible date input functionality with separate segments for day,
 * month, and year. Includes calendar icon, validation states, and international
 * date format support with keyboard navigation between segments.
 *
 * @param props - The date field props.
 * @param props.classNames - Custom class names for sub-elements.
 * @param props.description - Helper text displayed below the field.
 * @param props.errorMessage - Error message displayed when invalid.
 * @param props.inputProps - Additional props for the date input element.
 * @param props.label - Label text displayed above the field.
 * @param props.size - Size variant of the field.
 * @param props.shortMonth - When true, displays 3-letter month abbreviation when not editing.
 * @param props.shouldForceLeadingZeros - Whether to force leading zeros in segments.
 * @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 date field component.
 *
 * @example
 * ```tsx
 * // Basic date field
 * <DateField label="Birth Date" />
 * ```
 *
 * @example
 * ```tsx
 * // Date field with validation
 * <DateField
 *   label="Event Date"
 *   isRequired
 *   isInvalid={hasError}
 *   errorMessage="Please select a valid date"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Date field with custom formatting
 * <DateField
 *   label="Meeting Date"
 *   shortMonth={false}
 *   placeholder="Select meeting date"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Compact date field
 * <DateField
 *   label="Due Date"
 *   size="small"
 *   description="When is this task due?"
 * />
 * ```
 *
 * @example
 * ```tsx
 * // Controlled date field
 * <DateField
 *   label="Selected Date"
 *   value={selectedDate}
 *   onChange={setSelectedDate}
 * />
 * ```
 */
declare function DateField<T extends DateValue>({
  classNames,
  description: descriptionProp,
  errorMessage: errorMessageProp,
  inputProps,
  label: labelProp,
  size,
  shortMonth,
  shouldForceLeadingZeros,
  isDisabled,
  isInvalid: isInvalidProp,
  isRequired,
  isReadOnly,
  ...rest
}: DateFieldProps<T>): react_jsx_runtime17.JSX.Element;
//#endregion
export { DateField };
//# sourceMappingURL=index.d.ts.map