Empty & clearable
Arrow keys in calendar. Enter to confirm.
With value
Min / max
Error
Start date must be in the future.
Disabled
Native
Empty
With value
Min / max
API
| Prop | Required | Type | Default | Description |
|---|---|---|---|---|
| theme | Optional | SiteTheme | atelier | Visual theme for the field group. |
| mode | Optional | "light" | "dark" | light | Color mode — swaps token palette for light or dark surfaces. |
| variant | Optional | "native" | "custom" | custom | Custom calendar popover (default). Pass variant="native" for a styled `<input type="date">` when you need native picker semantics. |
| value / onChange | Optional | string (yyyy-MM-dd) | — | Controlled ISO date string. |
| min / max | Optional | string (yyyy-MM-dd) | — | Selectable date range. |
| required, name, disabled | Optional | form attrs | — | Form integration; hidden input when name is set. |
| clearable | Optional | boolean | — | Shows Clear action when a date is selected. |
| placeholder | Optional | string | Pick a date | Empty state label on trigger. |