import { DataTrackingId } from '../../types';
import { TextFieldProps } from '../TextField';
import { TimeFieldChangeHandler, TimeFormat } from './internal/types';
/**
 * Props for the TimeField component.
 * @extends Omit<TextFieldProps, "onChange" | "value" | "defaultValue" | "type" | "min" | "max" | "step" | "maxLength" | "showCounter">
 */
export type TimeFieldProps = Omit<TextFieldProps, "onChange" | "value" | "defaultValue" | "type" | "min" | "max" | "step" | "maxLength" | "showCounter" | "prefix"> & {
    /**
     * The current value of the time field.
     * @example "14:30" or "02:30 PM"
     */
    value?: string | null;
    /**
     * The default value for uncontrolled mode.
     * @example "14:30" or "02:30 PM"
     */
    defaultValue?: string | null;
    /**
     * Callback when the time value changes.
     */
    onChange?: TimeFieldChangeHandler;
    /**
     * Time format to use.
     * @default 12
     */
    format?: TimeFormat;
    /**
     * Time increment in minutes.
     * @default 30
     */
    step?: number;
    /**
     * Whether to automatically round to the nearest step.
     * @default false
     */
    autoround?: boolean;
    /**
     * Whether to disable the dropdown suggestions.
     * @default false
     */
    disableSuggestions?: boolean;
} & ({
    /**
     * Minimum allowed time constraint.
     * @example "09:00 AM" or "09:00"
     */
    min: string;
    /**
     * Maximum allowed time constraint.
     * @example "05:00 PM" or "17:00"
     */
    max: string;
} | {
    min?: never;
    max?: never;
}) & DataTrackingId;
/**
 * TimeField component for entering time values with auto-rounding and suggestions.
 *
 * Features:
 * - Supports 12-hour and 24-hour time formats
 * - Min/max time constraints handled during input parsing
 * - Auto-rounding to step intervals when autoround is true
 * - Dropdown suggestions for quick time selection
 * - Controlled and uncontrolled modes
 * - Smart input masking with placeholders
 * - Integration with MaskedTimeInput for auto-complete
 * - Validation handled by implementors using onChange callback
 * - Automatic tracking ID generation for analytics
 *
 * @example
 * <TimeField
 *   label="Meeting Time"
 *   value="14:30"
 *   format={24}
 *   step={30}
 *   min="09:00"
 *   max="17:00"
 *   autoround
 *   disableSuggestions
 *   onChange={(change) => {
 *     // Handle time change and validation
 *     if (change.isInputEmpty && required) {
 *       // Show required error
 *     }
 *   }}
 * />
 */
export declare const TimeField: {
    (props: TimeFieldProps): import("react/jsx-runtime").JSX.Element;
    displayName: string;
};