import React from 'react';
import { type AriaCalendarProps, type DateValue } from 'react-aria';
import type { TestIdProp } from '../../types';
declare const defaultEnglish: {
    readonly nextLabel: "Next month";
    readonly prevLabel: "Previous month";
};
export type CalendarTextContent = Record<keyof typeof defaultEnglish, string>;
export interface CalendarProps extends TestIdProp {
    /**
     * Calendar props passed through to the react-aria hook
     * ([docs](https://react-spectrum.adobe.com/react-aria/useCalendar.html))
     *
     * *Defaults*
     * - `defaultValue`: Today's date
     * - `firstDayOfWeek`: Sunday
     */
    calendarOptions?: Exclude<AriaCalendarProps<DateValue>, 'onChange'>;
    /**
     * Allow date in the past
     */
    allowPastDate?: boolean;
    /**
     * Custom event handler return value when a date is selected
     */
    onChange?: (value: DateValue) => void;
    /**
     * Language content override
     */
    lang?: Partial<CalendarTextContent>;
}
/**
 * Calendar component for selecting a date using react-aria. Supports full localization and accessibility.
 * Uses the Gregorian calendar system.
 *
 * This component implements the react-aria `useCalendar` hook and supports controlled state
 * ([docs](https://react-spectrum.adobe.com/react-aria/useCalendar.html))
 *
 * ## Working with dates
 *  - Use `parseDate('YYYY-MM-DD')` from `@internationalized/date` to create
 *    DateValue objects.
 *  - Other useful utilities include `today(getLocalTimeZone())` for current
 *    date, and `date.add({ days: 7, months: 1 })` for date arithmetic.
 *
 * ## Date Restrictions
 * You can restrict date selection using the `calendarOptions` prop with react-aria calendar properties:
 * - `minValue` / `maxValue`: Define selectable date range
 * - `isDateUnavailable`: Function to disable specific dates
 * - `allowPastDate` prop: Convenient way to allow/disallow past dates
 *
 * ## Internationalization
 * - Override text values via `lang={{ openCalendar: 'open calendar' }}`
 * - Date formatting helper available in `...utils/dateFormat.ts` or use `@internationalized/date` utils
 * - Advanced i18n and localization handled by [React Aria I18Provider](https://react-spectrum.adobe.com/react-aria/I18nProvider.html)
 * - Read more about [International calendars](https://react-spectrum.adobe.com/react-aria/useDatePicker.html#international-calendars)
 */
export declare const Calendar: {
    ({ allowPastDate, calendarOptions, lang, onChange, testId, }: CalendarProps): React.JSX.Element;
    displayName: string;
};
export {};
//# sourceMappingURL=Calendar.d.ts.map