API reference

Attributes

Attribute	Values	Default	Description
`value`	ISO string	`""`	Single selection value
`range-start` / `range-end`	ISO	—	Range mode initial values
`selection`	`single` \| `range`	`single`	One date vs start–end range
`mode`	`datetime` \| `date`	`datetime`	Include time picker or not
`value-type`	`iso` \| `timestamp` \| `object`	`iso`	Emitted `detail.value` shape
`display-format`	`short` \| `long` \| `numeric` \| `iso` \| `custom`	`short`	Trigger / NL display
`custom-date-format`	tokens	`DD/MM/YYYY`	With `display-format="custom"`
`display-mode`	`popover` \| `inline`	`popover`	Toggle vs always open
`time-format`	`12` \| `24`	`12`	Time display
`min` / `max`	ISO	—	Selectable bounds (not a range value)
`disabled`	boolean	false	Disable interaction
`label`	string	—	Visible label
`theme`	`light` \| `dark`	OS	Force color theme
`placeholder`	string	—	Single static placeholder (if no hints)
`placeholder-hints`	pipe-separated	built-in list	Rotating placeholders in the main input

Event	detail
`magic-change`	Single: `{ value, date }` — Range: `{ value: { start, end }, date: { start, end } }`
`change`	Same as `magic-change` (bubbles)

Method	Description
`open()`	Open popover panel
`applyNaturalLanguage(text, { confirm? })`	Parse NL; optionally confirm