@pglejzer/datepicker-ui 0.0.1 → 1.0.0

package/dist/cjs/shared.d.cts

@@ -0,0 +1,754 @@
+//#region src/types/date.d.ts
+interface PlainDate {
+  readonly year: number;
+  readonly month: number;
+  readonly day: number;
+}
+type DateInput = Date | string;
+//#endregion
+//#region src/types/selection.d.ts
+type CalendarMode = "single" | "range" | "multiple";
+type Precision = "day" | "month" | "year";
+type PageBy = "month" | "view";
+type RangeEnd = "start" | "end";
+//#endregion
+//#region src/utils/date/intl.d.ts
+type WeekStartOption = "auto" | "sunday" | "monday" | "saturday";
+type DatePart = "day" | "month" | "year";
+//#endregion
+//#region src/utils/date/format.d.ts
+type FormatOption = "auto" | (string & Record<never, never>);
+interface FormatPattern {
+  readonly order: readonly DatePart[];
+  readonly separator: string;
+  readonly padDay: boolean;
+  readonly padMonth: boolean;
+  readonly yearDigits: 2 | 4;
+}
+declare function resolvePattern(format: FormatOption, locale: string, precision?: Precision): FormatPattern;
+interface HintLetters {
+  readonly day: string;
+  readonly month: string;
+  readonly year: string;
+}
+declare function formatHint(pattern: FormatPattern, letters?: HintLetters): string;
+declare function formatDate(date: PlainDate, pattern: FormatPattern): string;
+//#endregion
+//#region src/types/internal.d.ts
+type SurfaceMode = "docked" | "modal" | "inline";
+type NavigateSource = "drag" | "wheel" | "button" | "keyboard" | "menu" | "api";
+type CancelReason = "button" | "escape" | "outside";
+//#endregion
+//#region src/types/types.d.ts
+/** A committed date in every representation the consumer may need. */
+interface DateValue {
+  /**
+   * ISO 8601 calendar date, `YYYY-MM-DD`, whatever the display format is.
+   * With `calendar.precision` `"month"` it is `YYYY-MM` and with `"year"` it
+   * is `YYYY`.
+   */
+  readonly value: string;
+  /** The same day as a `Date` at local midnight. */
+  readonly date: Date;
+  /** The date written the way the input shows it (`ui.format`). */
+  readonly formatted: string;
+}
+/** A committed complete range. */
+interface RangeValue {
+  /** First day of the range. */
+  readonly start: DateValue;
+  /** Last day of the range, on or after `start`. */
+  readonly end: DateValue;
+}
+/** The committed value: a day (`single`), a range (`range`) or the sorted days (`multiple`). */
+type PickerValue = DateValue | RangeValue | readonly DateValue[];
+/** Accepted by `setValue()`; the shape has to match `calendar.mode`. */
+type PickerValueInput = DateInput | {
+  readonly start: DateInput;
+  readonly end: DateInput;
+} | readonly DateInput[];
+/** Payload of the `open` event. */
+interface OpenEventData {
+  /** The surface that was opened. */
+  mode: "docked" | "modal" | "inline";
+}
+/** Payload of the `close` event. */
+type CloseEventData = Record<string, never>;
+/** Payload of the `cancel` event. */
+interface CancelEventData {
+  /** What dismissed the picker without committing. */
+  reason: CancelReason;
+}
+/** Payload of the `confirm` event. */
+interface ConfirmEventData {
+  /** The committed value, or `null` when the value was cleared. */
+  value: PickerValue | null;
+  /** `true` when the commit came from `behavior.closeOnSelect` or `behavior.commitOnChange` instead of the confirm button. */
+  autoCommit: boolean;
+}
+/** Payload of the `update` event, fired by `setOptions()`. */
+interface UpdateEventData {
+  /** The options patch that was applied. */
+  options: DatepickerOptions;
+}
+/** Payload of the `select:day` event. */
+interface SelectDayEventData {
+  /**
+   * The day the user picked (not yet committed in modal flow). With
+   * `calendar.precision` `"month"` or `"year"` it is the picked month or year,
+   * as its first day (`value.value` is `YYYY-MM` or `YYYY`).
+   */
+  value: DateValue;
+  /** `false` when a click in `multiple` mode removed the date from the selection. */
+  selected: boolean;
+}
+/** Payload of the `range:start` event. */
+interface RangeStartEventData {
+  /** The first day of the range that was just picked. */
+  value: DateValue;
+}
+/** Payload of the `range:end` event. */
+interface RangeEndEventData {
+  /** First day of the completed range. */
+  start: DateValue;
+  /** Last day of the completed range. */
+  end: DateValue;
+}
+/** Payload of the `select:month` event. */
+interface SelectMonthEventData {
+  /** Year of the displayed month. */
+  year: number;
+  /** Chosen month, 1-12. */
+  month: number;
+}
+/** Payload of the `select:year` event. */
+interface SelectYearEventData {
+  /** Chosen year. */
+  year: number;
+}
+/** Payload of the `navigate` event. */
+interface NavigateEventData {
+  /** Year of the first month now displayed. */
+  year: number;
+  /** First month now displayed, 1-12 (with `calendar.months` above 1 it is the first of the months shown). */
+  month: number;
+  /** `-1` backwards, `1` forwards, `0` for a jump that keeps the month. */
+  direction: -1 | 0 | 1;
+  /** What caused the navigation. `setValue()` and `open()` move the view without this event. */
+  source: Exclude<NavigateSource, "api">;
+}
+/** Why a date cannot be selected, in the order the rules are checked. */
+type UnavailableReason = "min" | "max" | "disabled" | "weekday" | "range-length" | "multiple-max";
+/** Payload of the `error` event. */
+interface ErrorEventData {
+  /** Machine readable reason. `invalid-value` is a message returned by `calendar.validate`. */
+  code: "invalid-date" | "unavailable-date" | "invalid-option" | "invalid-value";
+  /** Human readable description. */
+  message: string;
+  /** The text the user typed, for `invalid-date` and `unavailable-date`. */
+  input?: string;
+  /** Dotted path of the rejected option, for `invalid-option`. */
+  option?: string;
+  /** Why the typed date is unavailable, for `unavailable-date`. */
+  reason?: UnavailableReason;
+}
+/** Public events of a picker instance, keyed by event name. */
+interface DatepickerEventMap {
+  open: OpenEventData;
+  close: CloseEventData;
+  cancel: CancelEventData;
+  confirm: ConfirmEventData;
+  update: UpdateEventData;
+  error: ErrorEventData;
+  "select:day": SelectDayEventData;
+  "select:month": SelectMonthEventData;
+  "select:year": SelectYearEventData;
+  "range:start": RangeStartEventData;
+  "range:end": RangeEndEventData;
+  navigate: NavigateEventData;
+}
+//#endregion
+//#region src/types/options.d.ts
+/** Built-in theme names. */
+type ThemeName = "basic" | "m3-green" | "crane" | "crane-straight" | "m2" | "glassmorphic" | "pastel" | "ai" | "cyberpunk" | "blueprint";
+/** A label that is a plain string or a map from `Intl.PluralRules` categories to strings. `{count}` is replaced by the number. */
+type PluralLabel = string | Readonly<Partial<Record<Intl.LDMLPluralRule, string>>>;
+/** Extra presentation of a single day returned by `calendar.decorateDate`. */
+interface DateDecoration {
+  /** Class name added to the day cell. */
+  className?: string;
+  /** Show a small badge dot on the day. */
+  badge?: boolean;
+  /** Text appended to the accessible name of the day. */
+  label?: string;
+}
+/** The two ends of a range preset. */
+interface RangePresetValue {
+  /** First day of the range. */
+  start: DateInput;
+  /** Last day of the range, on or after `start`. */
+  end: DateInput;
+}
+/** A ready-made range offered next to the calendar, for example "Last 7 days". */
+interface RangePreset {
+  /** Text of the preset button. */
+  label: string;
+  /** The range, or a function that returns it (called each time the picker refreshes, so "today" stays current). */
+  value: RangePresetValue | (() => RangePresetValue);
+}
+/** Which days exist and how the weeks are laid out. */
+interface CalendarOptions {
+  /**
+   * What the user selects: one day, a range of days or any number of days.
+   * @default "single"
+   */
+  mode?: CalendarMode;
+  /**
+   * What one selection is: a day, a month or a year. With `"month"` the value
+   * is `YYYY-MM` and with `"year"` it is `YYYY`, both standing for the first
+   * day of the period. Only used in `single` mode (other modes report an
+   * `invalid-option` error and use `"day"`). Typed text is masked only at
+   * day precision.
+   * @default "day"
+   */
+  precision?: Precision;
+  /**
+   * How many months are shown side by side, a positive integer. Applies to
+   * the docked and inline surfaces and to day precision, as many as fit the
+   * width at open (up to this number). A modal shows one month.
+   * @default 1
+   */
+  months?: number;
+  /**
+   * How far the previous / next arrows, the swipe and the keyboard page move:
+   * `"month"` one month, `"view"` as many months as are shown.
+   * @default "view"
+   */
+  pageBy?: PageBy;
+  /**
+   * Length limits of a range in days, both ends included, and ready-made
+   * ranges (`presets`). Only used in `range` mode. Presets show as a column
+   * beside the picker when it fits, otherwise as a chip row; clicking one
+   * picks the range and follows `behavior.closeOnSelect` and
+   * `behavior.commitOnChange`.
+   * @default undefined
+   */
+  range?: {
+    minLength?: number;
+    maxLength?: number;
+    presets?: readonly RangePreset[];
+  };
+  /**
+   * Limits of a multiple selection. Only used in `multiple` mode.
+   * @default undefined
+   */
+  multiple?: {
+    max?: number;
+  };
+  /**
+   * Return `true` for a day that cannot be selected, on top of `minDate`,
+   * `maxDate`, `disabledDates` and `enabledDates`.
+   * @default undefined
+   */
+  isDateDisabled?: (date: Date) => boolean;
+  /**
+   * Weekdays that cannot be selected, `0` is Sunday and `6` is Saturday.
+   * @default []
+   */
+  disabledWeekdays?: readonly number[];
+  /**
+   * Return extra presentation for a day, or `undefined` for none.
+   * @default undefined
+   */
+  decorateDate?: (date: Date) => DateDecoration | undefined;
+  /**
+   * Content shown inside each day cell, for example a price: a string (text,
+   * never HTML), a DOM node, or `null` / `undefined` for none. The text is
+   * added to the accessible name of the day.
+   * @default undefined
+   */
+  renderDate?: (date: Date) => string | Node | null | undefined;
+  /**
+   * Field validity rule run on the presented value (`null` when empty) after
+   * `setValue()`, typed input and every commit. Return a message to mark the
+   * input invalid (`aria-invalid`, `setCustomValidity`, an `error` event with
+   * code `invalid-value`); return `null`, `undefined` or an empty string when
+   * the value is fine. It never blocks a pick or a commit.
+   * @default undefined
+   */
+  validate?: (value: PickerValue | null) => string | null | undefined;
+  /**
+   * BCP 47 locale for month and weekday names, the headline, the input format
+   * and the first day of the week. Falls back to `<html lang>`, then
+   * `navigator.language`, then `en-US`.
+   * @default the page locale
+   */
+  locale?: string;
+  /**
+   * First day of the week. `auto` follows the locale.
+   * @default "auto"
+   */
+  weekStart?: WeekStartOption;
+  /**
+   * Earliest selectable day: a `Date`, an ISO `YYYY-MM-DD` string or `"today"`.
+   * @default undefined
+   */
+  minDate?: DateInput;
+  /**
+   * Latest selectable day: a `Date`, an ISO `YYYY-MM-DD` string or `"today"`.
+   * @default undefined
+   */
+  maxDate?: DateInput;
+  /**
+   * Days that cannot be selected.
+   * @default []
+   */
+  disabledDates?: readonly DateInput[];
+  /**
+   * When set, only these days can be selected.
+   * @default undefined
+   */
+  enabledDates?: readonly DateInput[];
+}
+/** Presentation and display behaviour. */
+interface UIOptions {
+  /**
+   * `auto` opens the docked popover on wide viewports and the modal dialog on
+   * compact ones; `docked` and `modal` force one of them.
+   * @default "auto"
+   */
+  displayMode?: "auto" | "docked" | "modal";
+  /**
+   * Render the calendar permanently into a container instead of opening it.
+   * `container` is a selector or an element.
+   * @default { enabled: false }
+   */
+  inline?: {
+    enabled?: boolean;
+    container?: string | HTMLElement;
+  };
+  /**
+   * `auto` follows the locale's numeric order and separators; otherwise a
+   * pattern built from `d dd M MM yy yyyy` and one separator of `/ . - space`.
+   * With `calendar.precision` `"month"` or `"year"` the pattern may leave out
+   * the finer parts (`"MM/yyyy"`, `"yyyy-MM"`, and for `"year"` also `"yyyy"`).
+   * @default "auto"
+   */
+  format?: FormatOption;
+  /**
+   * Theme applied to the picker surface: `basic`, `m3-green`, `crane`,
+   * `crane-straight`, `m2`, `glassmorphic`, `pastel`, `ai`, `cyberpunk`,
+   * `blueprint`. `basic` and `blueprint` follow `colorScheme`, the others have
+   * one fixed scheme.
+   * @default "basic"
+   */
+  theme?: ThemeName;
+  /**
+   * `auto` detects the scheme when the picker opens: the first opaque
+   * `background-color` from the input up to `<html>` decides (dark when its
+   * luminance is low); without one, the page `color-scheme` decides (`dark`
+   * is dark, `light dark` follows the OS, anything else is light). An inline
+   * picker follows later page changes. `light` and `dark` force one. Themes
+   * with a single version ignore this option.
+   * @default "auto"
+   */
+  colorScheme?: "auto" | "light" | "dark";
+  /**
+   * Range pickers in a modal open full screen below this window width:
+   * `true` below 600 px, a number below that many px (for example 840), `false`
+   * never. With `displayMode: "auto"` the surface is docked from 600 px, so a
+   * value above 600 only matters with `displayMode: "modal"`. Decided when the
+   * picker opens.
+   * @default true
+   */
+  fullscreen?: boolean | number;
+  /**
+   * Selector or element that opens the picker besides the input, for example
+   * a calendar icon button.
+   * @default undefined
+   */
+  toggleButton?: string | HTMLElement;
+  /**
+   * Show ISO week numbers before each row.
+   * @default false
+   */
+  weekNumbers?: boolean;
+  /**
+   * Show the days of neighbouring months in the first and last rows. `true`
+   * and `{}` show them selectable; `{ selectable: false }` shows them dimmed
+   * and inert.
+   * @default false
+   */
+  outsideDays?: boolean | {
+    selectable?: boolean;
+  };
+  /**
+   * Always render six week rows, so the calendar keeps its height from month
+   * to month.
+   * @default false
+   */
+  fixedWeeks?: boolean;
+  /**
+   * Years offered in the year selection, counted from the current year.
+   * @default { before: 100, after: 20 }
+   */
+  yearRange?: {
+    before?: number;
+    after?: number;
+  };
+  /**
+   * Show the Today button in the footer.
+   * @default false
+   */
+  todayButton?: boolean;
+  /**
+   * Show the Clear button in the footer. `true` also clears the input; pass
+   * `{ clearInput: false }` to keep the typed text.
+   * @default false
+   */
+  clearButton?: boolean | {
+    clearInput?: boolean;
+  };
+  /**
+   * Show the footer with the action buttons. Unset means shown, except in
+   * inline mode.
+   * @default undefined
+   */
+  footer?: boolean;
+  /**
+   * Play motion. Always off with `prefers-reduced-motion: reduce`.
+   * @default true
+   */
+  animation?: boolean;
+  /**
+   * Keep the page scrollable while the modal is open.
+   * @default false
+   */
+  allowPageScroll?: boolean;
+  /**
+   * Extra class names added to the picker surface.
+   * @default ""
+   */
+  cssClass?: string;
+  /**
+   * Selector or element the modal dialog is appended to. Defaults to the
+   * picker host.
+   * @default undefined
+   */
+  appendTo?: string | HTMLElement;
+  /**
+   * Drag, wheel and swipe between months.
+   * @default true
+   */
+  swipe?: boolean;
+  /**
+   * Show the button that switches between the calendar and the text input
+   * view, where the mode and surface support it.
+   * @default true
+   */
+  viewSwitch?: boolean;
+  /**
+   * View shown when the picker opens, where the mode and surface support the
+   * input view.
+   * @default "calendar"
+   */
+  initialView?: "calendar" | "input";
+  /**
+   * Mask the text typed into the input to `ui.format` (digits only, separators added).
+   * Single mode and the split range fields (`ui.endInput`), day precision only.
+   * @default false
+   */
+  mask?: boolean;
+  /**
+   * Selector or element of the page's second `<input>`, which turns a range
+   * picker into a Start / End pair: the main input holds the start, this one
+   * the end. Read when `create()` runs; only used in `range` mode. Typing
+   * commits only a full pair (or two empty fields). Clicking a field opens
+   * the picker on that end, and the field being picked gets the class
+   * `dp-ui__input--active`.
+   * @default undefined
+   */
+  endInput?: string | HTMLElement;
+  /**
+   * First calendar panel when the picker opens: the day grid, the month list
+   * (docked, inline) or grid (modal), or the year list or grid. `initialView:
+   * "input"` wins; ignored in `range` mode and when `calendar.precision` is not
+   * `"day"`.
+   * @default "day"
+   */
+  startView?: "day" | "month" | "year";
+}
+/** Texts used by buttons and assistive technology. Month and weekday names come from `Intl`. */
+interface LabelsOptions {
+  /**
+   * Modal header supporting text.
+   * @default "Select date"
+   */
+  title?: string;
+  /**
+   * Header supporting text with `calendar.precision: "month"`.
+   * @default "Select month"
+   */
+  monthTitle?: string;
+  /**
+   * Header supporting text with `calendar.precision: "year"`.
+   * @default "Select year"
+   */
+  yearTitle?: string;
+  /**
+   * Modal headline while no date is selected.
+   * @default "No date selected"
+   */
+  noDate?: string;
+  /**
+   * Confirm button.
+   * @default "OK"
+   */
+  confirm?: string;
+  /**
+   * Cancel button.
+   * @default "Cancel"
+   */
+  cancel?: string;
+  /**
+   * Today button.
+   * @default "Today"
+   */
+  today?: string;
+  /**
+   * Clear button.
+   * @default "Clear"
+   */
+  clear?: string;
+  /**
+   * Accessible name of the toggle button.
+   * @default "Choose date"
+   */
+  openCalendar?: string;
+  /**
+   * Previous month button.
+   * @default "Previous month"
+   */
+  previousMonth?: string;
+  /**
+   * Next month button.
+   * @default "Next month"
+   */
+  nextMonth?: string;
+  /**
+   * Previous year button.
+   * @default "Previous year"
+   */
+  previousYear?: string;
+  /**
+   * Next year button.
+   * @default "Next year"
+   */
+  nextYear?: string;
+  /**
+   * Month menu button and list.
+   * @default "Choose month"
+   */
+  chooseMonth?: string;
+  /**
+   * Year menu button and list.
+   * @default "Choose year"
+   */
+  chooseYear?: string;
+  /**
+   * Week number column header.
+   * @default "Week"
+   */
+  weekNumber?: string;
+  /**
+   * Message for a typed text that is not a date.
+   * @default "Enter a valid date"
+   */
+  invalidDate?: string;
+  /**
+   * Message for a typed date that is disabled or out of range.
+   * @default "This date is not available"
+   */
+  unavailableDate?: string;
+  /**
+   * Header supporting text in `range` mode.
+   * @default "Select dates"
+   */
+  rangeTitle?: string;
+  /**
+   * Headline placeholder for the missing start of a range.
+   * @default "Start"
+   */
+  rangeStart?: string;
+  /**
+   * Headline placeholder for the missing end of a range.
+   * @default "End"
+   */
+  rangeEnd?: string;
+  /**
+   * Headline in `multiple` mode; `{count}` is the number of selected days.
+   * @default "{count} selected"
+   */
+  multipleSelected?: PluralLabel;
+  /**
+   * Save button of the fullscreen range picker.
+   * @default "Save"
+   */
+  save?: string;
+  /**
+   * Close button of the fullscreen range picker.
+   * @default "Close"
+   */
+  close?: string;
+  /**
+   * Accessible name of the button that shows the text input view.
+   * @default "Switch to text input"
+   */
+  switchToInput?: string;
+  /**
+   * Accessible name of the button that shows the calendar view.
+   * @default "Switch to calendar"
+   */
+  switchToCalendar?: string;
+  /**
+   * Label of the date text field in `single` mode.
+   * @default "Date"
+   */
+  dateField?: string;
+  /**
+   * Label of the start date text field in `range` mode.
+   * @default "Start date"
+   */
+  startDateField?: string;
+  /**
+   * Label of the end date text field in `range` mode.
+   * @default "End date"
+   */
+  endDateField?: string;
+  /**
+   * Message for a range whose end is before its start or breaks the length limits.
+   * @default "End date must be on or after the start date"
+   */
+  invalidRange?: string;
+  /**
+   * Message for a typed date before `minDate`; `{date}` is the minimum date.
+   * @default "Enter a date on or after {date}"
+   */
+  beforeMinDate?: string;
+  /**
+   * Message for a typed date after `maxDate`; `{date}` is the maximum date.
+   * @default "Enter a date on or before {date}"
+   */
+  afterMaxDate?: string;
+  /**
+   * Accessible name of the range presets group.
+   * @default "Presets"
+   */
+  presets?: string;
+  /**
+   * Name of the Page Up key in the keyboard shortcut tooltips of the navigation buttons.
+   * @default "Page Up"
+   */
+  pageUpKey?: string;
+  /**
+   * Name of the Page Down key in the keyboard shortcut tooltips of the navigation buttons.
+   * @default "Page Down"
+   */
+  pageDownKey?: string;
+  /**
+   * Name of the Shift key in the keyboard shortcut tooltips (`Shift+Page Up`, `Shift+M`).
+   * @default "Shift"
+   */
+  shiftKey?: string;
+  /**
+   * Placeholder letters for the day in the format hint shown under the field (Polish: "dd").
+   * @default "dd"
+   */
+  hintDay?: string;
+  /**
+   * Placeholder letters for the month in the format hint shown under the field (Polish: "mm").
+   * @default "mm"
+   */
+  hintMonth?: string;
+  /**
+   * Placeholder letters for the year in the format hint shown under the field (Polish: "rrrr").
+   * A two-digit year format uses the first two characters.
+   * @default "yyyy"
+   */
+  hintYear?: string;
+}
+/** Interaction rules. */
+interface BehaviorOptions {
+  /**
+   * Commit and close as soon as a day is picked.
+   * @default false
+   */
+  closeOnSelect?: boolean;
+  /**
+   * Close the picker when it is cancelled.
+   * @default true
+   */
+  closeOnCancel?: boolean;
+  /**
+   * Commit every change to the input immediately, without the confirm button.
+   * @default false
+   */
+  commitOnChange?: boolean;
+  /**
+   * Keep the picker open when the user clicks outside of it.
+   * @default false
+   */
+  ignoreOutsideClick?: boolean;
+  /**
+   * Move focus back to the input when the picker closes.
+   * @default true
+   */
+  returnFocus?: boolean;
+  /**
+   * Custom instance id for `DatepickerUI.getById()`.
+   * @default undefined
+   */
+  id?: string;
+}
+/** User callbacks, called through the event bridge. */
+interface CallbacksOptions {
+  /** Called when the picker opens. */
+  onOpen?: (data: OpenEventData) => void;
+  /** Called when the picker closes. */
+  onClose?: (data: CloseEventData) => void;
+  /** Called when the picker is dismissed without committing. */
+  onCancel?: (data: CancelEventData) => void;
+  /** Called when a value is committed or cleared. */
+  onConfirm?: (data: ConfirmEventData) => void;
+  /** Called after `setOptions()` applied a patch. */
+  onUpdate?: (data: UpdateEventData) => void;
+  /** Called for invalid typed dates and rejected options. */
+  onError?: (data: ErrorEventData) => void;
+  /** Called when a day is picked. */
+  onSelectDay?: (data: SelectDayEventData) => void;
+  /** Called when a month is chosen in the month menu. */
+  onSelectMonth?: (data: SelectMonthEventData) => void;
+  /** Called when a year is chosen. */
+  onSelectYear?: (data: SelectYearEventData) => void;
+  /** Called when the first day of a range is picked. */
+  onRangeStart?: (data: RangeStartEventData) => void;
+  /** Called when the range is completed. */
+  onRangeEnd?: (data: RangeEndEventData) => void;
+  /** Called when the displayed month changes. */
+  onNavigate?: (data: NavigateEventData) => void;
+}
+/** Options accepted by the `DatepickerUI` constructor and `setOptions()`. */
+interface DatepickerOptions {
+  /** Days, locale and week layout. */
+  calendar?: CalendarOptions;
+  /** Presentation and display behaviour. */
+  ui?: UIOptions;
+  /** Button texts and accessible names. */
+  labels?: LabelsOptions;
+  /** Interaction rules. */
+  behavior?: BehaviorOptions;
+  /** Event callbacks. */
+  callbacks?: CallbacksOptions;
+}
+//#endregion
+export { SurfaceMode as A, PageBy as B, RangeStartEventData as C, SelectYearEventData as D, SelectMonthEventData as E, formatHint as F, RangeEnd as H, resolvePattern as I, DatePart as L, FormatPattern as M, HintLetters as N, UnavailableReason as O, formatDate as P, WeekStartOption as R, RangeEndEventData as S, SelectDayEventData as T, PlainDate as U, Precision as V, ErrorEventData as _, DatepickerOptions as a, PickerValue as b, RangePreset as c, UIOptions as d, CancelEventData as f, DatepickerEventMap as g, DateValue as h, DateDecoration as i, FormatOption as j, UpdateEventData as k, RangePresetValue as l, ConfirmEventData as m, CalendarOptions as n, LabelsOptions as o, CloseEventData as p, CallbacksOptions as r, PluralLabel as s, BehaviorOptions as t, ThemeName as u, NavigateEventData as v, RangeValue as w, PickerValueInput as x, OpenEventData as y, CalendarMode as z };