@zonsh/ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +643 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,444 @@
1
+ # Date Picker
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel } from "@zonsh/ui";
5
+ import { DatePicker } from "@zonsh/ui/date-picker";
6
+ import { startOfToday } from "date-fns";
7
+
8
+ export function Basic() {
9
+ return (
10
+ <Field className="w-full max-w-xs">
11
+ <FieldLabel>Delivery date</FieldLabel>
12
+ <DatePicker calendar={{ disabled: { before: startOfToday() } }} />
13
+ <FieldDescription>You can change it until the day before.</FieldDescription>
14
+ </Field>
15
+ );
16
+ }
17
+ ```
18
+
19
+ A recessed trigger like `Select`'s, with a calendar icon and the date formatted by date-fns, that opens a `Calendar` in a popover, with optional presets beside it. It follows the room in the nearest scrolling panel or window: under 640px presets move above and a range shows one month. The popover stays inside that panel across but may pass its edge up and down, so a short panel never crops the calendar.
20
+
21
+ ## Usage
22
+
23
+ Import from `@zonsh/ui/date-picker` and add its optional dependencies:
24
+
25
+ ```bash
26
+ pnpm add react-day-picker date-fns
27
+ ```
28
+
29
+ ```tsx
30
+ import { Field, FieldLabel } from "@zonsh/ui";
31
+ import { DatePicker } from "@zonsh/ui/date-picker";
32
+
33
+ <Field>
34
+ <FieldLabel>Delivery date</FieldLabel>
35
+ <DatePicker name="delivery" />
36
+ </Field>;
37
+ ```
38
+
39
+ The props you'll reach for: `value` / `onValueChange` (`null` is no date), `name`, `presets`.
40
+
41
+ ## When to use
42
+
43
+ - `DatePicker` for one date in a form: a delivery date, a deadline, an appointment.
44
+ - `DateRangePicker` for a period: a report, a trip, a course.
45
+ - `DateTimePicker` for a moment: a meeting, a pickup, a scheduled send. Something that lasts all day — a deadline, a holiday — is a `DatePicker`.
46
+ - Presets when a few dates cover most choices: "Today", "Next Monday", "Last 30 days".
47
+ - A date people know by heart (a birthday) is faster typed. A calendar on the page is `Calendar`.
48
+
49
+ ## Examples
50
+
51
+ ### Presets
52
+
53
+ ```tsx
54
+ import { Field, FieldLabel } from "@zonsh/ui";
55
+ import { DatePicker, type DatePickerPreset } from "@zonsh/ui/date-picker";
56
+ import { addDays, addMonths, nextMonday, startOfToday } from "date-fns";
57
+
58
+ export function Presets() {
59
+ const today = startOfToday();
60
+ const presets: DatePickerPreset[] = [
61
+ { label: "Today", value: today },
62
+ { label: "Tomorrow", value: addDays(today, 1) },
63
+ { label: "Next Monday", value: nextMonday(today) },
64
+ { label: "In a month", value: addMonths(today, 1) },
65
+ ];
66
+ return (
67
+ <Field className="w-full max-w-xs">
68
+ <FieldLabel>Remind me on</FieldLabel>
69
+ <DatePicker presets={presets} />
70
+ </Field>
71
+ );
72
+ }
73
+ ```
74
+
75
+ ### Range
76
+
77
+ Two months; stays open for both ends, closes on a preset, Escape or an outside click.
78
+
79
+ ```tsx
80
+ import { Field, FieldLabel } from "@zonsh/ui";
81
+ import { DateRangePicker } from "@zonsh/ui/date-picker";
82
+ import { addDays, startOfToday } from "date-fns";
83
+
84
+ export function Range() {
85
+ return (
86
+ <Field className="w-full max-w-sm">
87
+ <FieldLabel>Trip dates</FieldLabel>
88
+ <DateRangePicker
89
+ defaultValue={{ from: addDays(startOfToday(), 7), to: addDays(startOfToday(), 9) }}
90
+ calendar={{ disabled: { before: startOfToday() } }}
91
+ />
92
+ </Field>
93
+ );
94
+ }
95
+ ```
96
+
97
+ ### Range with presets
98
+
99
+ ```tsx
100
+ import { Field, FieldLabel } from "@zonsh/ui";
101
+ import { DateRangePicker, type DateRangePickerPreset } from "@zonsh/ui/date-picker";
102
+ import { addMonths, endOfMonth, startOfMonth, startOfToday, subDays } from "date-fns";
103
+
104
+ export function RangePresets() {
105
+ const today = startOfToday();
106
+ const presets: DateRangePickerPreset[] = [
107
+ { label: "Last 7 days", value: { from: subDays(today, 6), to: today } },
108
+ { label: "Last 30 days", value: { from: subDays(today, 29), to: today } },
109
+ { label: "This month", value: { from: startOfMonth(today), to: endOfMonth(today) } },
110
+ {
111
+ label: "Last month",
112
+ value: { from: startOfMonth(addMonths(today, -1)), to: endOfMonth(addMonths(today, -1)) },
113
+ },
114
+ ];
115
+ return (
116
+ <Field className="w-full max-w-sm">
117
+ <FieldLabel>Report period</FieldLabel>
118
+ <DateRangePicker presets={presets} calendar={{ disabled: { after: today } }} />
119
+ </Field>
120
+ );
121
+ }
122
+ ```
123
+
124
+ ### German
125
+
126
+ `locale` formats the trigger and calendar; one from `react-day-picker/locale` translates its labels too. `format` takes a date-fns pattern.
127
+
128
+ ```tsx
129
+ import { Field, FieldLabel } from "@zonsh/ui";
130
+ import { DatePicker } from "@zonsh/ui/date-picker";
131
+ import { format } from "date-fns";
132
+ import { de } from "react-day-picker/locale";
133
+
134
+ export function German() {
135
+ return (
136
+ <Field className="w-full max-w-xs">
137
+ <FieldLabel>Wunschtermin</FieldLabel>
138
+ <DatePicker locale={de} placeholder="Datum wählen" format="PPP" />
139
+ </Field>
140
+ );
141
+ }
142
+ ```
143
+
144
+ ### Controlled
145
+
146
+ ```tsx
147
+ import { Field, FieldDescription, FieldLabel } from "@zonsh/ui";
148
+ import { type DateRange } from "@zonsh/ui/calendar";
149
+ import { DatePicker, DateRangePicker } from "@zonsh/ui/date-picker";
150
+ import { addDays, format, startOfToday } from "date-fns";
151
+ import * as React from "react";
152
+
153
+ export function Controlled() {
154
+ const [date, setDate] = React.useState<Date | null>(() => addDays(startOfToday(), 14));
155
+ const [range, setRange] = React.useState<DateRange | null>(null);
156
+ return (
157
+ <div className="flex w-full max-w-sm flex-col gap-6">
158
+ <Field>
159
+ <FieldLabel>Publish on</FieldLabel>
160
+ <DatePicker value={date} onValueChange={setDate} name="publishOn" />
161
+ <FieldDescription>
162
+ Value: <span className="font-mono tabular-nums">{date ? format(date, "yyyy-MM-dd") : "none"}</span>
163
+ </FieldDescription>
164
+ </Field>
165
+ <Field>
166
+ <FieldLabel>Course runs</FieldLabel>
167
+ <DateRangePicker value={range} onValueChange={setRange} />
168
+ <FieldDescription>
169
+ Value:{" "}
170
+ <span className="font-mono tabular-nums">
171
+ {range?.from ? format(range.from, "yyyy-MM-dd") : "none"}
172
+ {range?.to ? ` → ${format(range.to, "yyyy-MM-dd")}` : ""}
173
+ </span>
174
+ </FieldDescription>
175
+ </Field>
176
+ </div>
177
+ );
178
+ }
179
+ ```
180
+
181
+ ### Sizes
182
+
183
+ ```tsx
184
+ import { Field, FieldLabel } from "@zonsh/ui";
185
+ import { DatePicker } from "@zonsh/ui/date-picker";
186
+
187
+ export function Sizes() {
188
+ return (
189
+ <div className="flex w-full max-w-xs flex-col gap-4">
190
+ <Field>
191
+ <FieldLabel>Dense</FieldLabel>
192
+ <DatePicker size="sm" />
193
+ </Field>
194
+ <Field>
195
+ <FieldLabel>Default</FieldLabel>
196
+ <DatePicker />
197
+ </Field>
198
+ </div>
199
+ );
200
+ }
201
+ ```
202
+
203
+ ### Date and time
204
+
205
+ `DateTimePicker` puts a `TimeField` under the calendar. A picked day keeps the time set, or takes `defaultTime`; with neither, focus moves to the time, and there is a value once both are set, like `datetime-local`. `min` and `max` are moments that bound days and, on their own day, the time. Here `step={15}` moves by quarter hours.
206
+
207
+ ```tsx
208
+ import { Field, FieldDescription, FieldLabel } from "@zonsh/ui";
209
+ import { DateTimePicker } from "@zonsh/ui/date-picker";
210
+ import { addDays, addMonths, startOfToday } from "date-fns";
211
+
212
+ export function DateTime() {
213
+ const today = startOfToday();
214
+ return (
215
+ <Field className="w-full max-w-xs">
216
+ <FieldLabel>Workshop starts</FieldLabel>
217
+ <DateTimePicker
218
+ min={addDays(today, 1)}
219
+ max={addMonths(today, 3)}
220
+ step={15}
221
+ defaultTime="09:00"
222
+ name="startsAt"
223
+ />
224
+ <FieldDescription>Within the next three months, in your own time zone.</FieldDescription>
225
+ </Field>
226
+ );
227
+ }
228
+ ```
229
+
230
+ ### Date-time, controlled
231
+
232
+ The value is a local-time `Date`, `null` until both are picked. `hourCycle` sets 12 or 24 hours; otherwise the locale decides.
233
+
234
+ ```tsx
235
+ import { Field, FieldDescription, FieldLabel } from "@zonsh/ui";
236
+ import { DateTimePicker } from "@zonsh/ui/date-picker";
237
+ import { addDays, format, startOfToday } from "date-fns";
238
+ import * as React from "react";
239
+
240
+ export function DateTimeControlled() {
241
+ const [value, setValue] = React.useState<Date | null>(() => {
242
+ const date = addDays(startOfToday(), 3);
243
+ date.setHours(14, 30);
244
+ return date;
245
+ });
246
+ return (
247
+ <Field className="w-full max-w-xs">
248
+ <FieldLabel>Send the newsletter</FieldLabel>
249
+ <DateTimePicker value={value} onValueChange={setValue} hourCycle={24} />
250
+ <FieldDescription>
251
+ Value:{" "}
252
+ <span className="font-mono tabular-nums">{value ? format(value, "yyyy-MM-dd'T'HH:mm") : "none"}</span>
253
+ </FieldDescription>
254
+ </Field>
255
+ );
256
+ }
257
+ ```
258
+
259
+ ### Date-time in German
260
+
261
+ The trigger uses `Intl.DateTimeFormat` for the `locale` (or the `LocaleProvider`'s): "10.11.2026, 18:00". Here `format` takes `Intl.DateTimeFormat` options; the placeholder and time label come from `messages.dateTimePicker` or `labels`.
262
+
263
+ ```tsx
264
+ import { Field, FieldLabel, LocaleProvider } from "@zonsh/ui";
265
+ import { DateTimePicker } from "@zonsh/ui/date-picker";
266
+ import { addDays, startOfToday } from "date-fns";
267
+ import { de } from "react-day-picker/locale";
268
+
269
+ export function DateTimeGerman() {
270
+ const value = addDays(startOfToday(), 5);
271
+ value.setHours(18, 0);
272
+ return (
273
+ <LocaleProvider
274
+ locale="de-DE"
275
+ messages={{ dateTimePicker: { placeholder: "Datum und Uhrzeit wählen", time: "Uhrzeit" } }}
276
+ >
277
+ <Field className="w-full max-w-xs">
278
+ <FieldLabel>Abholung</FieldLabel>
279
+ <DateTimePicker locale={de} defaultValue={value} />
280
+ </Field>
281
+ </LocaleProvider>
282
+ );
283
+ }
284
+ ```
285
+
286
+ ### Date and time sizes
287
+
288
+ ```tsx
289
+ import { Field, FieldLabel } from "@zonsh/ui";
290
+ import { DateTimePicker } from "@zonsh/ui/date-picker";
291
+
292
+ export function DateTimeSizes() {
293
+ return (
294
+ <div className="flex w-full max-w-xs flex-col gap-4">
295
+ <Field>
296
+ <FieldLabel>Dense</FieldLabel>
297
+ <DateTimePicker size="sm" />
298
+ </Field>
299
+ <Field>
300
+ <FieldLabel>Default</FieldLabel>
301
+ <DateTimePicker />
302
+ </Field>
303
+ </div>
304
+ );
305
+ }
306
+ ```
307
+
308
+ ### Invalid
309
+
310
+ ```tsx
311
+ import { Field, FieldError, FieldLabel } from "@zonsh/ui";
312
+ import { DatePicker } from "@zonsh/ui/date-picker";
313
+
314
+ export function Invalid() {
315
+ return (
316
+ <Field invalid className="w-full max-w-xs">
317
+ <FieldLabel>Due date</FieldLabel>
318
+ <DatePicker />
319
+ <FieldError match>Pick the date the assignment is due.</FieldError>
320
+ </Field>
321
+ );
322
+ }
323
+ ```
324
+
325
+ ### Disabled
326
+
327
+ ```tsx
328
+ import { Field, FieldLabel } from "@zonsh/ui";
329
+ import { DatePicker } from "@zonsh/ui/date-picker";
330
+ import { addMonths, startOfMonth, startOfToday } from "date-fns";
331
+
332
+ export function Disabled() {
333
+ return (
334
+ <Field disabled className="w-full max-w-xs">
335
+ <FieldLabel>Membership renews</FieldLabel>
336
+ <DatePicker defaultValue={startOfMonth(addMonths(startOfToday(), 1))} />
337
+ </Field>
338
+ );
339
+ }
340
+ ```
341
+
342
+ ### Read-only
343
+
344
+ `readOnly` shows a date that can't change here: the trigger loses its recess, stays in the tab order, opens nothing, and still submits.
345
+
346
+ ```tsx
347
+ import { Field, FieldDescription, FieldLabel } from "@zonsh/ui";
348
+ import { DatePicker } from "@zonsh/ui/date-picker";
349
+ import { startOfToday, subDays } from "date-fns";
350
+
351
+ export function ReadOnly() {
352
+ return (
353
+ <Field className="w-full max-w-xs">
354
+ <FieldLabel>Order placed</FieldLabel>
355
+ <DatePicker readOnly defaultValue={subDays(startOfToday(), 3)} name="placed" />
356
+ <FieldDescription>Set when the order came in. It can't be changed.</FieldDescription>
357
+ </Field>
358
+ );
359
+ }
360
+ ```
361
+
362
+ ### On phones
363
+
364
+ Custom popover on the desktop, the platform's picker on a phone: by default (`native="touch"`) a `DatePicker` on a coarse pointer under 768px wide is a real `<input type="date">` in the field material, and a `DateTimePicker` a `datetime-local` one, so a tap opens the system's own wheel or calendar. Same `value`, `onValueChange`, `min` / `max`, `name`, `required`, `disabled`, `readOnly` and `Field`; a form gets the same `2026-10-05` (or `2026-10-05T14:30`). The platform's field has no placeholder or presets and writes the date in the device's language. `native` uses it everywhere; `native={false}` keeps the popover on phones too. `DateRangePicker` keeps its popover (one month wide): phones have no range picker.
365
+
366
+ ## Props
367
+
368
+ | Prop | Type | Default |
369
+ | --------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------- |
370
+ | `value` | `Date \| null` (range: `DateRange \| null`) | — (uncontrolled) |
371
+ | `defaultValue` | `Date \| null` (range: `DateRange \| null`) | `null` |
372
+ | `onValueChange` | `(value) => void` | — |
373
+ | `presets` | `{ label: string; value: Date }[]` (range: `value: DateRange`) | — |
374
+ | `native` | `boolean \| "touch"` — the platform's date field; `"touch"` on phones only | `"touch"` (not DateRangePicker) |
375
+ | `min` / `max` | `Date` (DatePicker) — days before or after can't be picked | — |
376
+ | `placeholder` | `string` | `"Pick a date"` / `"Pick a date range"` |
377
+ | `locale` | a date-fns or `react-day-picker/locale` locale | `enUS` |
378
+ | `format` | date-fns format string | `"PP"` |
379
+ | `size` | `"sm" \| "default"` | `"default"` |
380
+ | `name` | `string`: submits `2026-10-05` (range: `2026-10-05/2026-10-12`) | the `Field`'s `name` |
381
+ | `required` | `boolean`: a date (a range: both ends) must be picked | `false` |
382
+ | `disabled` | `boolean` | `false` |
383
+ | `readOnly` | `boolean`: shows the value, opens no calendar, still submits | `false` |
384
+ | `open` / `defaultOpen` / `onOpenChange` | controlled or initial open state | — |
385
+ | `closeOnSelect` | `boolean` (DatePicker only) | `true` |
386
+ | `numberOfMonths` | `number` (DateRangePicker only) — one month with under 640px of room | `2` |
387
+ | `calendar` | `Calendar` props: `disabled`, `captionLayout`, `startMonth`, `weekStartsOn` … | — |
388
+ | `popover` | `PopoverContent` props: `side`, `align`, `className` … | `align: "start"` |
389
+ | `ref` | the trigger, for a form library to focus (React Hook Form's `field.ref`) | — |
390
+ | `onBlur` | `() => void`: focus has left the trigger and the popover | — |
391
+
392
+ `DateTimePicker` takes the same trigger, popover and calendar props, and:
393
+
394
+ | Prop | Type | Default |
395
+ | ------------------------ | ---------------------------------------------------------------------- | --------------------------------------------- |
396
+ | `value` / `defaultValue` | `Date \| null` | — / `null` |
397
+ | `onValueChange` | `(value: Date \| null) => void` — once both the day and time are there | — |
398
+ | `min` / `max` | `Date` — the earliest and latest moments | — |
399
+ | `hourCycle` | `12 \| 24` | the locale's |
400
+ | `step` | `number` — minutes per arrow press in the time field | `1` |
401
+ | `defaultTime` | `"HH:mm"` — the time a picked day takes while none is set | — |
402
+ | `format` | `Intl.DateTimeFormatOptions` | `{ dateStyle: "medium", timeStyle: "short" }` |
403
+ | `placeholder` | `string` | `"Pick a date and time"` |
404
+ | `name` | `string`: submits `2026-10-05T14:30` | the `Field`'s `name` |
405
+ | `labels` | `Partial<DateTimePickerMessages>` — `placeholder`, `time` | English |
406
+
407
+ `className`, `id` and `aria-*` go to the trigger. Data attributes on the trigger: `data-size`, `data-placeholder`, `data-popup-open`, `data-invalid`, `data-disabled`, `data-readonly`. Each preset has `data-current` when it matches the value.
408
+
409
+ In a form, the value goes in a hidden input under `name`; `onFormSubmit` and `validate` get the same string. A half-picked range submits nothing. `required` makes an empty picker `valueMissing`: the form won't submit, `FieldError match="valueMissing"` shows and focus goes to the trigger. `validationMode="onBlur"` validates when focus leaves trigger and popover. A disabled picker submits nothing; a form reset restores `defaultValue`.
410
+
411
+ The placeholders default to `messages.datePicker` (`placeholder`, `rangePlaceholder`). A `LocaleProvider` does not set the date-fns `locale`: pass it beside the provider (see Locale).
412
+
413
+ ## Brand rules
414
+
415
+ - **Do** label every picker with a `FieldLabel`. The trigger text is the value, not the label.
416
+ - **Do** use `disabled` matchers for dates that cannot be chosen, instead of an error after the fact.
417
+ - **Do** keep preset labels short and honest: "Next Monday", not "ASAP".
418
+ - **Don't** put a primary button in the popover. A picked day is the commit.
419
+ - **Don't** format dates in mono. The trigger is a control: Licht Sans with tabular figures.
420
+
421
+ ## Accessibility
422
+
423
+ - The trigger is the `Field`'s control (outside one, give it an `aria-label`). Its name is the label then the value ("Delivery date, Oct 5, 2026").
424
+ - It is a button with `aria-haspopup` and `aria-expanded`.
425
+ - Presets are buttons with `aria-pressed` when they match the value.
426
+ - A button can't carry `aria-required`: say "required" in the label or description. The hidden form input is hidden from assistive tech.
427
+ - In a `DateTimePicker`, the time field is labelled "Time"; its hours, minutes and AM/PM are spinbuttons (see `TimeField`).
428
+ - In a right-to-left `DirectionProvider`, the popover's calendar runs right to left too, though it renders outside the page's `dir`.
429
+
430
+ ### Keyboard
431
+
432
+ | Key | What it does |
433
+ | ------------- | --------------------------------------------------------------------------------------------------------------------- |
434
+ | Enter / Space | Opens the popover from the trigger, with focus on the selected day, or today; inside, picks the focused day or preset |
435
+ | Tab | Moves through the presets, the calendar and, in a DateTimePicker, the time field |
436
+ | Enter | Closes the popover from the time field, back on the trigger |
437
+ | Escape | Closes the popover and returns focus to the trigger |
438
+
439
+ Inside the calendar, arrows, Page Up / Page Down and Home / End move the day (see `Calendar`). A DatePicker closes on a pick (unless `closeOnSelect` is false); a DateRangePicker stays open for both ends. Tabbing out closes the popover.
440
+
441
+ ---
442
+
443
+ - Import: `import { DatePicker, DateRangePicker, DateTimePicker } from "@zonsh/ui/date-picker"`
444
+ - Source: `packages/ui/src/components/date-picker.tsx`