import { type Locale } from "date-fns";
import type { DatePickerBaseProp, PickerDateFormatProp } from "../../props/components/data-entry.prop.js";
/** The granularity axis a picker selects at — `DatePickerProp["picker"]`, resolved. */
export type DatePickerPicker = NonNullable<DatePickerBaseProp["picker"]>;
/** Display is independent from the canonical value submitted by the field. */
export declare function formatPickerDate(date: Date | undefined, format: PickerDateFormatProp | undefined, locale: string, withTime?: boolean): string;
/**
 * Read typed text back into a date. Tries, in order: the caller's `parser`, the explicit `format`
 * pattern, then canonical ISO `yyyy-MM-dd` — and, unless `strict`, any unambiguous year-first
 * spelling (see `YEAR_FIRST`). `strict` exists for the KEYSTROKE path: `2026/10/1` is a complete
 * year-first date on its way to `2026/10/15`, so committing it mid-typing would rewrite the text
 * under the user's cursor. The field commits loose spellings on Enter and blur instead.
 */
export declare function parsePickerDate(text: string, format: PickerDateFormatProp | undefined, parser?: (text: string) => Date | undefined, withTime?: boolean, strict?: boolean): Date | undefined;
export declare function pickerDateAllowed(date: Date, min: Date | undefined, max: Date | undefined, disabled?: (date: Date) => boolean): boolean;
/** Normalize a reporting period with the active calendar's week convention. */
export declare function pickerPeriodStart(date: Date, picker: DatePickerBaseProp["picker"], locale: Pick<Locale, "options">): Date;
/**
 * ISO-8601 at the precision the picker actually selects.
 *
 * The standard defines reduced forms, and a month picker that submits `2026/03` is simply using
 * none of them: `/` is not an ISO separator and a server parsing an ISO date will reject it. Each
 * granularity gets the shortest ISO form that loses nothing:
 *   year → `2026` · month → `2026-03` · quarter → `2026-01` (the quarter's first month, which is
 *   what the value IS) · week → `2026-W07` (ISO week-numbering year + week) · date → `2026-03-01`.
 */
export declare function toIsoPeriod(date: Date | undefined, picker: DatePickerPicker): string;
/**
 * The inverse of `toIsoPeriod`: read back the reduced ISO form the field displays for this
 * granularity. `date` is left to `parsePickerDate`, which already owns the full `yyyy-MM-dd` path
 * (custom parser, `format` pattern, era display).
 */
export declare function parseIsoPeriod(raw: string, picker: DatePickerPicker): Date | undefined;