import { type InputStatus, type FieldStatusVariant } from '../Field';
import { type ISODateString, type DateRange, type DayOfWeek, type DayOfWeekName } from '../Calendar';
import type { BaseProps } from '../BaseProps';
import type { SizeValue } from '../utils/types';
export type { DateRange } from '../Calendar';
export interface DateRangePreset {
    label: string;
    getRange: () => DateRange;
}
export type DateRangeInputSize = 'sm' | 'md' | 'lg';
export type { InputStatus as DateRangeInputStatus, InputStatusType as DateRangeInputStatusType, } from '../Field';
export interface DateRangeInputProps extends Omit<BaseProps, 'onChange' | 'defaultValue'> {
    /** Ref forwarded to the trigger button */
    ref?: React.Ref<HTMLButtonElement>;
    /**
     * Label text for the input (required for accessibility).
     */
    label: string;
    /**
     * Whether to visually hide the label (still accessible to screen readers).
     * @default false
     */
    isLabelHidden?: boolean;
    /**
     * Description text displayed between the label and input.
     */
    description?: string;
    /**
     * Whether the field is optional. Mutually exclusive with isRequired.
     * @default false
     */
    isOptional?: boolean;
    /**
     * Whether the field is required. Mutually exclusive with isOptional.
     * @default false
     */
    isRequired?: boolean;
    /**
     * Whether the input is disabled.
     * @default false
     */
    isDisabled?: boolean;
    /**
     * Explains why the input is disabled. When set together with
     * `isDisabled`, the input shows a tooltip with this text on hover and
     * keyboard focus, and the trigger stays focusable (via `aria-disabled`)
     * so the reason is discoverable by keyboard and assistive technology.
     * Activation stays blocked.
     *
     * Use this instead of wrapping a disabled input in `Tooltip` — disabled
     * controls don't emit the pointer events an external tooltip needs.
     *
     * @example
     * ```
     * <DateRangeInput
     *   label="Reporting period"
     *   value={range}
     *   onChange={setRange}
     *   isDisabled
     *   disabledMessage="You need the Editor role to change this"
     * />
     * ```
     */
    disabledMessage?: string;
    /**
     * The selected date range, or null if no range is selected.
     */
    value: DateRange | null;
    /**
     * Callback fired when the date range changes.
     * Called with null when the range is cleared.
     */
    onChange: (value: DateRange | null) => void;
    /**
     * Async action on change. Fires after onChange.
     */
    changeAction?: (value: DateRange | null) => void | Promise<void>;
    /**
     * Whether the input is in a loading state.
     * @default false
     */
    isLoading?: boolean;
    /**
     * Minimum selectable date in ISO format.
     */
    min?: ISODateString;
    /**
     * Maximum selectable date in ISO format.
     */
    max?: ISODateString;
    /**
     * Custom date constraint functions.
     * A date is disabled if ANY function returns false.
     */
    dateConstraints?: ReadonlyArray<(date: Date) => boolean>;
    /**
     * Preset date ranges shown as quick-select options beside the calendar.
     */
    presets?: ReadonlyArray<DateRangePreset>;
    /**
     * Whether to show a clear button when a range is selected.
     * @default true
     */
    hasClear?: boolean;
    /**
     * Placeholder text shown when no range is selected.
     * @default "Select date range"
     */
    placeholder?: string;
    /**
     * The size of the trigger.
     * @default 'md'
     */
    size?: DateRangeInputSize;
    /**
     * Status indicator for the input.
     */
    status?: InputStatus;
    /**
     * How the status message is placed relative to the input.
     * - 'attached': message overlaps directly below the input (bordered treatment)
     * - 'detached': message floats below as a separate element with spacing
     * - 'tooltip': no message box; the status icon becomes a focusable info-tip button that reveals the message on hover, keyboard focus, or tap
     * @default 'attached'
     */
    statusVariant?: FieldStatusVariant;
    /**
     * Width of the field. Numbers are treated as pixels, strings are used as-is
     * (e.g. `'100%'`). Sizes the whole field (label, control, and status) so they
     * stay aligned, unlike setting width via `xstyle`/`className`/`style`.
     */
    width?: SizeValue;
    /**
     * Tooltip text to display in an info icon at the end of the label.
     */
    labelTooltip?: string;
    /**
     * Number of months to display in the calendar.
     * @default 2
     */
    numberOfMonths?: 1 | 2;
    /**
     * First day of week in the calendar. Accepts a number
     * (0 = Sunday … 6 = Saturday) or a three-letter day name ('sun'–'sat',
     * case-insensitive).
     * @default 0
     */
    weekStartsOn?: DayOfWeek | DayOfWeekName;
}
/**
 * A date range picker with a button trigger that opens a popover
 * containing a dual-month calendar and optional preset ranges.
 *
 * @example
 * ```
 * <DateRangeInput
 *   label="Date range"
 *   value={range}
 *   onChange={setRange}
 *   presets={[
 *     { label: "Last 7 days", getRange: () => ({start: "...", end: "..."}) },
 *   ]}
 * />
 * ```
 */
export declare function DateRangeInput({ label, isLabelHidden, description, isOptional, isRequired, isDisabled, disabledMessage, value, onChange, changeAction, isLoading, min, max, dateConstraints, presets, hasClear, placeholder: placeholderFromProps, size: sizeProp, status, statusVariant, labelTooltip, numberOfMonths, weekStartsOn, width, xstyle, className, style, ref, ...rest }: DateRangeInputProps): import("react").JSX.Element;
export declare namespace DateRangeInput {
    var displayName: string;
}
//# sourceMappingURL=DateRangeInput.d.ts.map