| closeOnSelect | boolean | auto | | Close the panel after a day pick; unset follows the control default (closes unless `time` is on). |
| format | string? | 'YYYY-MM-DD' | | Field pattern, dayjs tokens (YYYY, MM, DD, HH, mm, …); typed text is parsed against it and [bracketed] text is literal. Defaults to YYYY-MM-DD, or YYYY-MM-DD HH:mm:ss while `time` is on. |
| from | string? | '' | | Range start as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is on; the eye resets to the default. |
| hideOutline | boolean | false | | Drops each bordered field’s border and focus border while keeping its surface, padding, and text metrics. |
| highlightRange | boolean | false | | Highlight the days between the two ends in each end’s calendar, so the range reads as one span; the ends stay the selected days. Applies while `range` is on. |
| placeholder | string? | — | | Prompt shown while the single field is empty; defaults to the shared message. A range pair names each field after its own end. |
| range | boolean | false | | Render a from/to pair of independent fields, each behaving as the single field with its own calendar. |
| ratios | PickerRatioOverrides? | — | | Partial override of the field-gutter and calendar ratios; the field text follows the picker font and paddings. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers are icon-scale pixels. Scales every field and its calendar. |
| time | boolean | false | | Edit a date-time: every panel gains an hour/minute/second row, and a range pairs two date-time fields. A segment stepped past its range carries into the next unit (23:59:59 + 1s rolls the date). |
| to | string? | '' | | Range end as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is on; the eye resets to the default. |
| value | string? | '' | | Selected date as YYYY-MM-DD (a date-time while `time` is on); an invalid date reads as unset. Applies while `range` is off. Typing is validated on commit (a valid date writes back, anything else reverts); the eye resets to the default. |
| variant | 'bordered' | 'embedded' | 'bordered' | | Chrome variant; embedded drops each field’s border, the background, and the focus ring for a picker rendered inside another surface. |
| theme | DateInputTheme? | — | — | Optional per-part color overrides; omitted keys keep the app palette. |
| onChange | (value: string) => void | — | — | Called with the picked date (or reset) while `range` is off. |
| onFrom | (value: string) => void | — | — | Called with the picked range start (or reset). |
| onTo | (value: string) => void | — | — | Called with the picked range end (or reset). |