import { default as React } from 'react';
import { DateRange, DayPickerProps, Locale, Matcher, OnSelectHandler } from 'react-day-picker';
import { CalendarView, DateFieldMode } from '../../form/date-field/date-field';
export interface CalendarProps extends Omit<DayPickerProps, 'mode' | 'selected' | 'onSelect'> {
    /**
     * Current view of the calendar. Can be `'days'`, `'months'`, or `'years'`.
     * Controls which calendar grid is displayed.
     */
    view?: CalendarView;
    /**
     * **Selection granularity** — controls the level at which a click finalises
     * the selection rather than drilling down to the next sub-grid:
     * - `'years'` — clicking a year selects Jan 1 of that year and closes; the
     *   calendar starts on the year grid.
     * - `'months'` — clicking a month selects the first day of that month; the
     *   calendar starts on the month grid.
     * - `'days'` (default) — full day-level selection; the calendar starts on
     *   the day grid.
     *
     * Distinct from `view` / `setView`, which control the *currently visible*
     * grid — those flip as the user navigates between year / month / day.
     * `selectionLevel` is the lowest level the user can drill down to before
     * a click commits the selection.
     * @default days
     */
    selectionLevel?: CalendarView;
    /**
     * The month currently displayed in the calendar. Used to render the correct month grid.
     */
    currentMonth: Date;
    /**
     * Callback to update the `currentMonth` when navigating months/years.
     */
    setCurrentMonth: (date: Date) => void;
    /**
     * Callback to update the current `view` (days, months, years) when the user switches calendar levels.
     */
    setView?: (view: CalendarView) => void;
    /**
     * Selection mode of the calendar. Can be `'single'`, `'multiple'`, or `'range'`.
     */
    mode?: DateFieldMode;
    /**
     * The currently selected value(s).
     * - Single mode: `Date | undefined`
     * - Multiple mode: `Date[]`
     * - Range mode: `DateRange` (object with `from` and optional `to`)
     */
    value: Date | Date[] | DateRange | undefined;
    /**
     * Locale object for formatting and translating calendar labels (from `react-day-picker`).
     */
    locale?: Locale;
    /**
     * The locale code string used for date formatting. Defaults to 'et-EE'.
     */
    localeCode?: string;
    /**
     * Whether to display days from the previous and next months in the current month grid.
     * Default is `true`.
     */
    showOutsideDays?: boolean;
    /**
     * Array of `Matcher`s or functions to disable specific dates. Used to prevent selection of certain days.
     */
    disabledMatchers?: Matcher[];
    /**
     * If `true`, a value must be selected before the calendar allows closing.
     */
    required?: boolean;
    /**
     * Array of available dates or a function to dynamically mark dates as available.
     * Highlights selectable days without disabling other days.
     */
    availableDays?: Date[] | ((date: Date) => boolean);
    /**
     * Array of unavailable dates or a function to dynamically mark dates as unavailable.
     * Used for styling and optionally disabling specific days.
     */
    unavailableDays?: Date[] | ((date: Date) => boolean);
    /**
     * Optional footer element to render below the calendar grid, e.g., for action buttons.
     */
    footer?: React.ReactNode;
    /**
     * How the month/year selector in the calendar header is rendered.
     * Forwarded to the internal `CalendarHeader`.
     * - `'dropdown'` (default) — each picker is a `<Select>` dropdown.
     * - `'grid'` — each picker opens a full grid of options.
     * @default dropdown
     */
    monthYearSelectType?: 'dropdown' | 'grid';
    /**
     * Callback fired when a date or date range is selected. Receives the selected value, day, modifiers, and event.
     */
    handleSelect: OnSelectHandler<Date | Date[] | DateRange | undefined>;
    /**
     * Callback to apply a selected date from month/year selection or programmatically.
     */
    applyValue: (date: Date) => void;
    /**
     * Show or hide previous/next navigation buttons in calendar header.
     * Default is `true`.
     */
    showNavigation?: boolean;
    /**
     * Optional additional CSS class for the calendar container.
     */
    className?: string;
    /**
     * Whether to render the surrounding card (border, background, radius).
     * Set to `false` when embedding inside a parent that already provides its
     * own surface — e.g. inside `DatePickerModal`, or alongside a calendar in
     * `DateTimeField`. The inner gradient masks and column separators are
     * preserved either way.
     * @default true
     */
    bordered?: boolean;
}
export declare const Calendar: {
    ({ view, selectionLevel, currentMonth, setCurrentMonth, setView, mode, value, locale, localeCode, showOutsideDays, disabledMatchers, required, availableDays, unavailableDays, footer, monthYearSelectType, handleSelect, applyValue, showNavigation, className, bordered, ...dayPickerProps }: CalendarProps): import("react/jsx-runtime").JSX.Element;
    displayName: string;
};