GrCalendar

const grCalendarConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrCalendar">;

interface GrCalendarConfigurableProps {
    size: GrCalendarSize;
    showWeekNumbers: boolean;
    weekStart: IsoWeekday;
}

type GrCalendarSize = GrComponentSize;

const grCalendarSafelist: string[];

interface GrCalendarProps {
    /**
     * Что выбирается: день, месяц или год. В режимах периода сетка показывает
     * двенадцать ячеек в три колонки, а выбор отдаёт первое число периода.
     */
    mode?: 'day' | 'week' | PeriodMode;
    /** Выбранная дата. `null` — ничего не выбрано. */
    modelValue?: PlainDate | null;
    /** Показываемый месяц. Без него календарь ведёт его сам, отталкиваясь от выбора. */
    viewDate?: PlainDate;
    /**
     * Самая ранняя дата, которую можно выбрать. Дни раньше неё видны, но
     * выключены, а листать за её месяц нельзя.
     */
    min?: PlainDate;
    /**
     * Самая поздняя дата, которую можно выбрать. Дни позже неё видны, но
     * выключены, а листать за её месяц нельзя.
     */
    max?: PlainDate;
    /** Запрещённые даты: список или предикат. Список нормализуется в `Set` один раз. */
    disabledDates?: DisabledDatesInput;
    /**
     * Первый день недели по ISO (1 — понедельник). Не задан — берётся из локали
     * через `Intl`.
     */
    weekStart?: IsoWeekday;
    /**
     * Колонка номеров недель по ISO 8601 слева от сетки. Не задан — из
     * `GrConfigProvider`, иначе `false`.
     */
    showWeekNumbers?: boolean;
    /** Что считать сегодняшним днём. Задаётся ради воспроизводимых тестов и снимков. */
    today?: PlainDate;
    /** Локаль показа. Не задана — из адаптера i18n приложения. */
    locale?: string;
    /**
     * Ступень размера: ячейки, кегль и стрелки листания. По умолчанию `md`; берётся
     * из `GrConfigProvider`.
     */
    size?: GrCalendarSize;
    /**
     * Календарь недоступен: выбор и листание выключены, сетка объявлена
     * `aria-disabled`.
     */
    disabled?: boolean;
    /**
     * Выбор зафиксирован: выбранная дата видна и читается диктором, но не
     * меняется, листание тоже стоит. Сетка объявлена `aria-readonly`.
     */
    readonly?: boolean;
    /** Доступное имя сетки, когда рядом нет подписи. */
    ariaLabel?: string;
    /**
     * Начало выбранного диапазона. Сетка про диапазон ничего не решает — только
     * рисует его: считать границы, порядок и ограничения длины — дело пикера.
     */
    rangeStart?: PlainDate | null;
    /** Конец выбранного диапазона. */
    rangeEnd?: PlainDate | null;
    /**
     * Второй край предпросмотра, пока диапазон не закрыт: день под курсором или
     * под клавиатурной остановкой.
     */
    rangePreview?: PlainDate | null;
    /**
     * Набор выбранных дат. Как и у диапазона, сетка про него ничего не решает —
     * только рисует: складывать, снимать и сортировать набор — дело пикера.
     */
    selectedDates?: readonly PlainDate[];
    /**
     * Объявлять выбор в живом регионе. Выключается, когда объявляет оболочка:
     * у диапазона осмысленно состояние периода («начало выбрано»), а не
     * отдельный день, и два объявления на один клик перебили бы друг друга.
     */
    announceSelection?: boolean;
}

interface GrCalendarEmits {
    /** Выбрана дата (`v-model`). В режимах периода — первое число месяца, квартала или года. */
    (e: 'update:modelValue', value: PlainDate): void;
    /** Показываемый период сменился (`v-model:viewDate`). */
    (e: 'update:viewDate', value: PlainDate): void;
    /** Пользователь выбрал дату — кликом, клавиатурой или из подвала. */
    (e: 'change', value: PlainDate): void;
    /** Показываемый период сменился — листанием, клавиатурой или выбором. */
    (e: 'periodChange', value: PlainDate): void;
    /** День под курсором сменился. `null` — курсор ушёл из сетки. */
    (e: 'dayHover', value: PlainDate | null): void;
}