@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
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { ArrowDownIcon } from "lucide-react";
3
+ import { ArrowDownIcon } from "../lib/icons.js";
4
4
  import * as React from "react";
5
5
  import { cn, sx } from "../lib/cn.js";
6
6
  import { mergeRefs } from "../lib/merge-refs.js";
@@ -27,9 +27,15 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
27
27
  const stuck = React.useRef(true);
28
28
  const lastTop = React.useRef(0);
29
29
  const lastMax = React.useRef(0);
30
- const glide = React.useRef({ frame: 0, last: 0 });
30
+ /**
31
+ * The glide's frame, its last time, where it (or a jump to the end) last put the view, and how
32
+ * since when, and for how many frames, it has waited for the scroll event of a move it did not make.
33
+ */
34
+ const glide = React.useRef({ frame: 0, last: 0, at: Number.NaN, waitFrom: 0, waited: 0 });
31
35
  /** Where the glide last put the view: the scroll event that write fires is not the reader's. */
32
36
  const glideTop = React.useRef(Number.NaN);
37
+ /** A pointer is down in the log: on its scrollbar, a small move up is the reader's drag. */
38
+ const pressed = React.useRef(false);
33
39
  const [atBottom, setAtBottom] = React.useState(true);
34
40
  /**
35
41
  * Following the reply, the conversation scrolls itself, and the browser's scroll anchoring would
@@ -37,6 +43,11 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
37
43
  * anchoring is back on, so the text being read stays put when something above it changes.
38
44
  */
39
45
  const setStuck = React.useCallback((value) => {
46
+ // Following again from wherever the reader is: not a move away from where it last was.
47
+ if (value && !stuck.current)
48
+ glide.current.at = Number.NaN;
49
+ glide.current.waitFrom = 0;
50
+ glide.current.waited = 0;
40
51
  stuck.current = value;
41
52
  const el = scroller.current;
42
53
  if (el)
@@ -53,6 +64,7 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
53
64
  if (reducedMotion()) {
54
65
  el.scrollTop = el.scrollHeight;
55
66
  glideTop.current = el.scrollTop;
67
+ glide.current.at = el.scrollTop;
56
68
  return;
57
69
  }
58
70
  if (glide.current.frame)
@@ -69,14 +81,31 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
69
81
  if (stuck.current && gap > 0) {
70
82
  el.scrollTop = end;
71
83
  glideTop.current = el.scrollTop;
84
+ g.at = el.scrollTop;
72
85
  }
73
86
  g.frame = 0;
74
87
  g.last = 0;
75
88
  return;
76
89
  }
90
+ // The view is above where the glide left it, not by its doing: a jump of the reader's (a
91
+ // find, a link, the scrollbar), or layout. Which one is the scroll event's to say, and in
92
+ // WebKit it can come a frame after this one, where gliding on would carry a jump back down
93
+ // and swallow it. So the glide waits for it: two frames, and up to 150ms.
94
+ if (el.scrollTop < g.at - 1) {
95
+ g.waitFrom ||= now;
96
+ if (g.waited < 2 || now - g.waitFrom < 150) {
97
+ g.waited++;
98
+ g.last = now;
99
+ g.frame = requestAnimationFrame(step);
100
+ return;
101
+ }
102
+ }
103
+ g.waitFrom = 0;
104
+ g.waited = 0;
77
105
  const before = el.scrollTop;
78
106
  el.scrollTop += Math.max(1, gap * (1 - Math.pow(0.82, dt / 16)));
79
107
  glideTop.current = el.scrollTop;
108
+ glide.current.at = el.scrollTop;
80
109
  if (el.scrollTop === before) {
81
110
  g.frame = 0;
82
111
  g.last = 0;
@@ -122,8 +151,12 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
122
151
  // Where layout left the view is not the reader's doing: when content shrinks and clamps the
123
152
  // view, and grows back before the browser fires the scroll event (a slow frame in Firefox),
124
153
  // that event must not read as a move up from where the view, or the glide, was before.
125
- lastTop.current = el.scrollTop;
126
- lastMax.current = el.scrollHeight - el.clientHeight;
154
+ // A view higher up and not clamped to the end is not layout's: it is a move whose scroll
155
+ // event is still to come (a find, a jump), so that event is still measured from before it.
156
+ const max = el.scrollHeight - el.clientHeight;
157
+ if (el.scrollTop >= lastTop.current - 1 || max - el.scrollTop < 1)
158
+ lastTop.current = el.scrollTop;
159
+ lastMax.current = max;
127
160
  glideTop.current = Number.NaN;
128
161
  if (!stuck.current && el.scrollHeight - el.clientHeight <= 0.5)
129
162
  setStuck(true);
@@ -141,11 +174,18 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
141
174
  resize.observe(child);
142
175
  };
143
176
  observeAll();
144
- const mutations = new MutationObserver(() => {
145
- observeAll();
146
- changed();
177
+ // A message added, or a reply growing as it streams: what changes the size of the content is
178
+ // a change to the DOM, so that is followed too. WebKit's ResizeObserver can stop reporting the
179
+ // content's growth on a busy page, and the reply would stream on below the view.
180
+ const mutations = new MutationObserver((records) => {
181
+ if (records.some((r) => r.target === el)) {
182
+ observeAll();
183
+ changed();
184
+ }
185
+ else if (Math.abs(el.scrollHeight - el.clientHeight - lastMax.current) > 0.5)
186
+ changed();
147
187
  });
148
- mutations.observe(el, { childList: true });
188
+ mutations.observe(el, { childList: true, subtree: true, characterData: true });
149
189
  // The reader's own move up — a wheel, a finger, a key — lets go at once, even mid-glide,
150
190
  // where the scroll it makes could be outrun by the glide's; the glide stops there. Only when
151
191
  // there is somewhere to go: on a log that does not scroll yet, nothing changes. A move down
@@ -223,6 +263,11 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
223
263
  else if (["ArrowDown", "PageDown", "End"].includes(event.key) || space)
224
264
  rejoin();
225
265
  };
266
+ const press = () => (pressed.current = true);
267
+ const release = () => (pressed.current = false);
268
+ el.addEventListener("pointerdown", press);
269
+ window.addEventListener("pointerup", release);
270
+ window.addEventListener("pointercancel", release);
226
271
  el.addEventListener("wheel", wheel, { passive: true });
227
272
  el.addEventListener("touchstart", touchStart, { passive: true });
228
273
  el.addEventListener("touchmove", touchMove, { passive: true });
@@ -230,6 +275,9 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
230
275
  return () => {
231
276
  resize.disconnect();
232
277
  mutations.disconnect();
278
+ el.removeEventListener("pointerdown", press);
279
+ window.removeEventListener("pointerup", release);
280
+ window.removeEventListener("pointercancel", release);
233
281
  el.removeEventListener("wheel", wheel);
234
282
  el.removeEventListener("touchstart", touchStart);
235
283
  el.removeEventListener("touchmove", touchMove);
@@ -246,7 +294,7 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
246
294
  const end = max - el.scrollTop <= STICK_PX;
247
295
  // A move in a frame where the log also changed size is layout's — a panel folding
248
296
  // above, a line arriving below — not the reader's: it changes nothing. Otherwise a
249
- // move up, even a few pixels, lets go (the glide only moves down), and a move down
297
+ // move up lets go (the glide only moves down), and a move down
250
298
  // into the end takes up following again. The reader's wheel, finger and keys say so
251
299
  // at once, too (see the listeners above).
252
300
  // The glide's own move is not the reader's either; any other move is measured from where
@@ -255,10 +303,13 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
255
303
  const from = !glided && !Number.isNaN(glideTop.current) ? glideTop.current : lastTop.current;
256
304
  glideTop.current = Number.NaN;
257
305
  const resized = Math.abs(max - lastMax.current) > 0.5;
258
- // In a resized frame, only a jump further than the end zone (to a find, a focused
259
- // link) is the reader's; a few pixels, or a clamp to the end, is layout.
306
+ // A jump further than the end zone (to a find, a focused link) is the reader's. A few
307
+ // pixels up is theirs only while they hold the scrollbar and the log kept its size:
308
+ // otherwise it is layout — a clamp to the end, or content that shrank and grew back
309
+ // before the browser fired the event (WebKit can fire it before the resize is reported).
260
310
  const clamped = max - el.scrollTop < 1;
261
- const up = !glided && !clamped && el.scrollTop < from - 1 && (!resized || from - el.scrollTop > STICK_PX);
311
+ const far = from - el.scrollTop > STICK_PX;
312
+ const up = !glided && !clamped && el.scrollTop < from - 1 && (far || (pressed.current && !resized));
262
313
  // Down, and nearer the end than before: layout never does both (anchoring keeps the
263
314
  // distance, a clamp moves the view up), so this holds through a resize too.
264
315
  const down = !glided &&
@@ -276,7 +327,10 @@ export function Conversation({ className, style, children, ref, onScroll, ...pro
276
327
  // Its corners are the conversation's: round that (`rounded-t-card` in a card), and the
277
328
  // messages, the scrollbar and the focus ring follow, with no `overflow-hidden` to clip them.
278
329
  // Its own scrolling is instant, whatever an app sets for `scroll-behavior`: the glide does the easing.
279
- className: "min-h-0 flex-1 overflow-y-auto overscroll-contain [scroll-behavior:auto] [border-radius:inherit] focus-ring [--scrollbar-inset:var(--radius-card)]", children: parts.filter((child) => !isButton(child)) }), parts.filter(isButton)] }) }));
330
+ // The scrollbar's room is kept on both sides from the start, so the first time the
331
+ // messages outgrow the view (a reply streams in, Reasoning or Sources opens) the bar
332
+ // appears without narrowing them, and centred messages stay centred over the prompt.
333
+ className: "min-h-0 flex-1 [scrollbar-gutter:stable_both-edges] overflow-y-auto overscroll-contain [scroll-behavior:auto] [border-radius:inherit] focus-ring [--scrollbar-inset:var(--radius-card)]", children: parts.filter((child) => !isButton(child)) }), parts.filter(isButton)] }) }));
280
334
  }
281
335
  /** The column of messages: 24px apart, padded, at a reading width. */
282
336
  export function ConversationContent({ className, ...props }) {
@@ -9,7 +9,7 @@ export interface CopyButtonMessages {
9
9
  failed: string;
10
10
  }
11
11
  declare module "./locale" {
12
- interface Messages {
12
+ interface LocaleMessages {
13
13
  copyButton: CopyButtonMessages;
14
14
  }
15
15
  }
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
- import { CheckIcon, CopyIcon, XIcon } from "lucide-react";
3
+ import { CheckIcon, CopyIcon, XIcon } from "../lib/icons.js";
4
4
  import * as React from "react";
5
5
  import { cn } from "../lib/cn.js";
6
6
  import { Button } from "./button.js";
@@ -28,7 +28,7 @@ export interface DataTableMessages {
28
28
  next: string;
29
29
  }
30
30
  declare module "./locale" {
31
- interface Messages {
31
+ interface LocaleMessages {
32
32
  dataTable: DataTableMessages;
33
33
  }
34
34
  }
@@ -166,8 +166,8 @@ export interface DataTableProps<TData extends RowData> extends Omit<React.Compon
166
166
  getRowId?: (row: TData, index: number) => string;
167
167
  /** Show the "Columns" visibility menu. Defaults to `true`. */
168
168
  columnToggle?: boolean;
169
- /** 30px rows and 30px controls throughout, for admin and dashboard screens. */
170
- dense?: boolean;
169
+ /** `sm`: 30px rows and 30px controls throughout, for admin and dashboard screens. `default`: 46px rows. */
170
+ size?: "sm" | "default";
171
171
  /**
172
172
  * `card` (default): the table in a 20px card. `plain`: the same table without the card —
173
173
  * always inside a `Card`, a `Dialog` or a `Drawer`, never a card in a card.
@@ -212,14 +212,14 @@ export interface DataTableProps<TData extends RowData> extends Omit<React.Compon
212
212
  /** Keep group headers at the top of the table while their rows scroll; give the table a height. */
213
213
  stickyGroupHeaders?: boolean;
214
214
  /** Props for the table's scrolling card, e.g. `{ className: "max-h-96" }` for sticky group headers. */
215
- tableContainerProps?: React.ComponentProps<"div">;
215
+ containerProps?: React.ComponentProps<"div">;
216
216
  /**
217
217
  * Render only the rows in view and a few beyond (`TableVirtualBody`), as the card or the page
218
218
  * scrolls. On by default when more than 100 rows could show: a grouped table of more than 100
219
219
  * rows, or a page of more than 100. Rows out of view can't be found with the browser's search,
220
220
  * and don't print.
221
221
  */
222
- virtualize?: boolean;
222
+ virtualized?: boolean;
223
223
  }
224
224
  /**
225
225
  * DataTable — a `Table` with the controls people expect from a data grid: sortable mono
@@ -232,4 +232,4 @@ export interface DataTableProps<TData extends RowData> extends Omit<React.Compon
232
232
  * break: reaching for it for a handful of rows. Under ~10 rows with nothing to sort, use a
233
233
  * plain `Table`.
234
234
  */
235
- export declare function DataTable<TData extends RowData>({ columns, data, fetchRows, searchKey, searchPlaceholder: searchPlaceholderProp, searchable, pageSize, pageSizeOptions, selectable, onRowSelectionChange, getRowId, columnToggle, dense, variant, fit, initialSorting, locale: localeProp, initialColumnVisibility, emptyMessage: emptyMessageProp, labels, toolbar, caption, label, groupBy, groupSummary, stickyGroupHeaders, tableContainerProps, virtualize, className, ...props }: DataTableProps<TData>): React.JSX.Element;
235
+ export declare function DataTable<TData extends RowData>({ columns, data, fetchRows, searchKey, searchPlaceholder: searchPlaceholderProp, searchable, pageSize, pageSizeOptions, selectable, onRowSelectionChange, getRowId, columnToggle, size, variant, fit, initialSorting, locale: localeProp, initialColumnVisibility, emptyMessage: emptyMessageProp, labels, toolbar, caption, label, groupBy, groupSummary, stickyGroupHeaders, containerProps: tableContainerProps, virtualized: virtualize, className, ...props }: DataTableProps<TData>): React.JSX.Element;
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { columnFilteringFeature, columnGroupingFeature, columnVisibilityFeature, constructRow, createColumnHelper, createFilteredRowModel, createGroupedRowModel, createPaginatedRowModel, createSortedRowModel, filterFn_includesString, functionalUpdate, globalFilteringFeature, metaHelper, rowPaginationFeature, rowSelectionFeature, rowSortingFeature, sortFn_alphanumeric, sortFn_basic, sortFn_datetime, sortFn_text, tableFeatures, useTable, } from "@tanstack/react-table";
4
- import { ArrowDownIcon, ArrowUpIcon, ChevronLeftIcon, ChevronRightIcon, ChevronsUpDownIcon, Columns3Icon, SearchIcon, } from "lucide-react";
4
+ import { ArrowDownIcon, ArrowUpIcon, ChevronLeftIcon, ChevronRightIcon, ChevronsUpDownIcon, Columns3Icon, SearchIcon, } from "../lib/icons.js";
5
5
  import * as React from "react";
6
6
  import { cn } from "../lib/cn.js";
7
7
  import { columnRanks, matching, searchLines, sortedOrder } from "../lib/row-index.js";
@@ -168,7 +168,7 @@ const rowKeyOf = (row) => row.id;
168
168
  * break: reaching for it for a handful of rows. Under ~10 rows with nothing to sort, use a
169
169
  * plain `Table`.
170
170
  */
171
- export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searchPlaceholder: searchPlaceholderProp, searchable = true, pageSize = 10, pageSizeOptions = [10, 20, 50], selectable, onRowSelectionChange, getRowId, columnToggle = true, dense = false, variant = "card", fit = false, initialSorting = [], locale: localeProp, initialColumnVisibility = {}, emptyMessage: emptyMessageProp, labels, toolbar, caption, label, groupBy, groupSummary, stickyGroupHeaders = false, tableContainerProps, virtualize, className, ...props }) {
171
+ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searchPlaceholder: searchPlaceholderProp, searchable = true, pageSize = 10, pageSizeOptions = [10, 20, 50], selectable, onRowSelectionChange, getRowId, columnToggle = true, size = "default", variant = "card", fit = false, initialSorting = [], locale: localeProp, initialColumnVisibility = {}, emptyMessage: emptyMessageProp, labels, toolbar, caption, label, groupBy, groupSummary, stickyGroupHeaders = false, containerProps: tableContainerProps, virtualized: virtualize, className, ...props }) {
172
172
  const text = useMessages("dataTable", defaultMessages, labels);
173
173
  // The header's checkbox reads its name here: the columns are built once, not at every render.
174
174
  const textRef = React.useRef(text);
@@ -186,7 +186,7 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
186
186
  const large = !server && !grouped && data.length >= LARGE_FROM;
187
187
  const outside = server || large;
188
188
  const withSelection = selectable ?? onRowSelectionChange != null;
189
- const size = dense ? "sm" : "default";
189
+ const dense = size === "sm";
190
190
  const searchId = React.useId();
191
191
  // Every row checkbox is named by one hidden label. Named by `aria-label` alone, Base UI looks for
192
192
  // a <label> of its own on every render, a search of the whole page per checkbox.
@@ -204,6 +204,8 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
204
204
  return next;
205
205
  });
206
206
  const groupedAnchor = React.useRef(null);
207
+ /** Whether Shift was held with the Space that ticked a row's checkbox. */
208
+ const shiftedKey = React.useRef(false);
207
209
  /** Selection in the large and server modes, set at each render for the checkbox column. */
208
210
  const outsideSelect = React.useRef(null);
209
211
  const groupedRange = React.useRef(() => null);
@@ -227,8 +229,11 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
227
229
  }, className: "align-middle" })) : outsideSelect.current ? (
228
230
  // A server's rows aren't all here to select; many rows are, every one that matches.
229
231
  outsideSelect.current.toggleAll ? (_jsx(Checkbox, { "aria-label": textRef.current.selectAll, checked: outsideSelect.current.all, indeterminate: outsideSelect.current.some, onCheckedChange: (checked) => outsideSelect.current?.toggleAll?.(checked), className: "align-middle" })) : null) : (_jsx(Checkbox, { "aria-label": textRef.current.selectPage, checked: table.getIsAllPageRowsSelected(), indeterminate: table.getIsSomePageRowsSelected() && !table.getIsAllPageRowsSelected(), onCheckedChange: (checked) => table.toggleAllPageRowsSelected(checked), className: "align-middle" })),
230
- cell: ({ row }) => (_jsx(Checkbox, { "aria-labelledby": selectRowLabelId, checked: row.getIsSelected(), disabled: !row.getCanSelect(), onCheckedChange: (checked, details) => {
231
- const shiftKey = details.event?.shiftKey ?? false;
232
+ cell: ({ row }) => (_jsx(Checkbox, { "aria-labelledby": selectRowLabelId, checked: row.getIsSelected(), disabled: !row.getCanSelect(),
233
+ // Shift+Space ranges too: the click a key sends may not carry the Shift held with it.
234
+ onKeyDown: (event) => (shiftedKey.current = event.key === " " && event.shiftKey), onPointerDown: () => (shiftedKey.current = false), onCheckedChange: (checked, details) => {
235
+ const shiftKey = details.event?.shiftKey || shiftedKey.current;
236
+ shiftedKey.current = false;
232
237
  if (outsideSelect.current)
233
238
  return outsideSelect.current.toggle(row, checked, shiftKey);
234
239
  const range = shiftKey && grouped ? groupedRange.current(row.id) : null;
@@ -612,10 +617,17 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
612
617
  return (_jsx(TableCell, { numeric: meta?.numeric, className: meta?.className, children: _jsx(table.FlexRender, { cell: cell }) }, cell.id));
613
618
  }) }, row.id));
614
619
  /** A row on its way from the server: a placeholder bar in each cell. */
615
- const loadingRow = (k) => (_jsx(TableRow, { "data-slot": "data-table-loading", "aria-busy": "true", children: visibleColumns.map((column) => (_jsx(TableCell, { children: _jsx(Skeleton, { className: "h-3.5 w-3/5 max-w-40 rounded-checkbox" }) }, column.id))) }, `loading-${k}`));
620
+ const loadingRow = (k) => (_jsx(TableRow, { "data-slot": "data-table-loading", "aria-busy": "true", children: visibleColumns.map((column) => (_jsx(TableCell, { children: _jsx(Skeleton, { className: "w-3/5 max-w-40 rounded-checkbox" }) }, column.id))) }, `loading-${k}`));
616
621
  const renderOutside = (original, k) => original === undefined ? loadingRow(k) : renderRow(rowAt(k, original));
617
622
  const outsideKey = (original, k) => original === undefined ? `loading-${k}` : idAt(k, original);
618
- const empty = outside ? outsideRows.length === 0 : !rows.length;
623
+ // A server that failed before its first answer: the body says so, with the way to ask again, in
624
+ // place of placeholders that would wait for ever.
625
+ const failedEmpty = server && served.error != null && served.total == null;
626
+ const empty = failedEmpty || (outside ? outsideRows.length === 0 : !rows.length);
627
+ const retry = () => {
628
+ setServed((old) => ({ ...old, error: null }));
629
+ load(...lastRange.current);
630
+ };
619
631
  const groupHeader = (group) => {
620
632
  const groupCell = groupBy ? group.getAllCellsByColumnId()[groupBy] : undefined;
621
633
  return (_jsx(TableGroupHeader, { colSpan: visibleColumnCount, count: group.subRows.length, sticky: stickyGroupHeaders, summary: groupSummary?.({
@@ -623,20 +635,37 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
623
635
  rows: group.subRows.map((row) => row.original),
624
636
  }), children: groupCell ? _jsx(table.FlexRender, { cell: groupCell }) : String(group.groupingValue) }));
625
637
  };
626
- return (_jsxs("div", { "data-slot": "data-table", "data-dense": dense ? "" : undefined, "aria-busy": (server && cache.pending.size > 0) || undefined, "data-variant": variant, className: cn("flex w-full min-w-0 flex-col", dense ? "gap-3" : "gap-4", className), ...props, children: [withSelection ? (_jsx("span", { id: selectRowLabelId, hidden: true, children: text.selectRow })) : null, searchable || columnToggle || toolbar ? (_jsxs("div", { "data-slot": "data-table-toolbar", "data-collapse-row": "", className: cn("flex flex-wrap items-center gap-2", variant === "plain" && "px-6"), children: [searchable ? (_jsxs("div", { "data-slot": "data-table-search",
638
+ return (_jsxs("div", { "data-slot": "data-table", "data-size": size, "aria-busy": (server && cache.pending.size > 0) || undefined, "data-variant": variant, className: cn("flex w-full min-w-0 flex-col", dense ? "gap-3" : "gap-4", className), ...props, children: [withSelection ? (_jsx("span", { id: selectRowLabelId, hidden: true, children: text.selectRow })) : null, searchable || columnToggle || toolbar ? (_jsxs("div", { "data-slot": "data-table-toolbar", "data-collapse-row": "", className: cn("flex flex-wrap items-center gap-2", variant === "plain" && "px-6"), children: [searchable ? (_jsxs("div", { "data-slot": "data-table-search",
627
639
  // Its real minimum, for the collapse row (data.css lets it lend room while a fold runs).
628
640
  className: "relative w-full max-w-72 min-w-40 flex-1 [--collapse-min:10rem]", children: [_jsx("label", { htmlFor: searchId, className: "sr-only", children: searchPlaceholder.replace(/\s*…$/, "") }), _jsx(SearchIcon, { "aria-hidden": true, className: cn("pointer-events-none absolute top-1/2 size-4 -translate-y-1/2 text-muted-foreground", dense ? "start-2.5" : "start-3") }), _jsx(Input, { id: searchId, type: "search", size: size, value: typed, placeholder: searchPlaceholder, onChange: (event) => {
629
641
  setTyped(event.currentTarget.value);
630
642
  table.setPageIndex(0);
631
- }, className: dense ? "ps-8" : "ps-9" })] })) : null, _jsxs("div", { className: "ms-auto flex items-center gap-2", children: [toolbar, columnToggle && hideableColumns.length > 0 ? (_jsxs(Menu, { children: [_jsxs(MenuTrigger, { render: _jsx(Button, { variant: "secondary", size: size, collapsible: true }), children: [_jsx(Columns3Icon, {}), text.columns] }), _jsx(MenuContent, { align: "end", className: "min-w-48", children: _jsxs(MenuGroup, { children: [_jsx(MenuGroupLabel, { children: text.showColumns }), hideableColumns.map((column) => (_jsx(MenuCheckboxItem, { checked: column.getIsVisible(), onCheckedChange: (checked) => column.toggleVisibility(checked), children: columnLabel(column) }, column.id)))] }) })] })) : null] })] })) : null, _jsxs(Table, { dense: dense, variant: variant, fit: fit, "aria-label": caption ? undefined : label, containerProps: tableContainerProps, children: [caption ? _jsx(TableCaption, { children: caption }) : null, _jsx(TableHeader, { children: table.getHeaderGroups().map((group) => (_jsx(TableRow, { children: group.headers.map((header) => {
643
+ }, className: dense ? "ps-8" : "ps-9" })] })) : null, _jsxs("div", { className: "ms-auto flex items-center gap-2", children: [toolbar, columnToggle && hideableColumns.length > 0 ? (_jsxs(Menu, { children: [_jsxs(MenuTrigger, { render: _jsx(Button, { variant: "secondary", size: size, collapsible: true }), children: [_jsx(Columns3Icon, {}), text.columns] }), _jsx(MenuContent, { align: "end", className: "min-w-48", children: _jsxs(MenuGroup, { children: [_jsx(MenuGroupLabel, { children: text.showColumns }), hideableColumns.map((column) => (_jsx(MenuCheckboxItem, { checked: column.getIsVisible(), onCheckedChange: (checked) => column.toggleVisibility(checked), children: columnLabel(column) }, column.id)))] }) })] })) : null] })] })) : null, _jsxs(Table, { size: size, variant: variant, fit: fit, "aria-label": caption ? undefined : label, containerProps:
644
+ // Empty, the table is a size container: the message is as wide as the visible part, not
645
+ // as the columns, so a table that scrolls sideways still shows all of it.
646
+ empty
647
+ ? {
648
+ ...tableContainerProps,
649
+ className: cn("@container/table-empty", tableContainerProps?.className),
650
+ }
651
+ : tableContainerProps, children: [caption ? _jsx(TableCaption, { children: caption }) : null, _jsx(TableHeader, { children: table.getHeaderGroups().map((group) => (_jsx(TableRow, { children: group.headers.map((header) => {
632
652
  const column = header.column;
633
653
  const meta = column.columnDef.meta;
634
654
  const sorted = column.getIsSorted();
635
655
  const canSort = column.getCanSort();
636
- return (_jsx(TableHead, { colSpan: header.colSpan, numeric: meta?.numeric, align: meta?.align, priority: meta?.priority, inline: meta?.inline, minWidth: meta?.minWidth, width: meta?.width, titleColumn: column.id === titleColumnId, "aria-sort": sorted === "asc" ? "ascending" : sorted === "desc" ? "descending" : undefined, className: meta?.className, children: header.isPlaceholder ? null : canSort ? (_jsxs("button", { type: "button", "data-slot": "data-table-sort", "data-sorted": sorted || undefined, onClick: column.getToggleSortingHandler(), className: cn("group/sort inline-flex min-h-(--control-h-sm) cursor-pointer items-center gap-1.5 rounded-item material-row px-2 font-mono text-[12px] tracking-[0.18em] uppercase focus-ring select-none", meta?.numeric ? "-me-2 flex-row-reverse" : "-ms-2"), children: [_jsx("span", { className: cn("transition-colors duration-(--duration) ease-(--ease)", sorted
656
+ return (_jsx(TableHead, { colSpan: header.colSpan, numeric: meta?.numeric, align: meta?.align, priority: meta?.priority, inline: meta?.inline, minWidth: meta?.minWidth, width: meta?.width, titleColumn: column.id === titleColumnId, "aria-sort": sorted === "asc" ? "ascending" : sorted === "desc" ? "descending" : undefined, className: meta?.className, children: header.isPlaceholder ? null : canSort ? (_jsxs("button", { type: "button", "data-slot": "data-table-sort", "data-sorted": sorted || undefined, onClick: column.getToggleSortingHandler(),
657
+ // Shift+Enter or Shift+Space adds the column to the sort, as Shift-click
658
+ // does: the click a key sends may not carry the Shift held with it.
659
+ onKeyDown: (event) => {
660
+ if (!event.shiftKey || (event.key !== "Enter" && event.key !== " "))
661
+ return;
662
+ event.preventDefault();
663
+ if (!event.repeat)
664
+ column.getToggleSortingHandler()?.(event);
665
+ }, className: cn("group/sort inline-flex min-h-(--control-h-sm) cursor-pointer items-center gap-1.5 rounded-item material-row px-2 font-mono text-12 tracking-[0.18em] uppercase focus-ring select-none", meta?.numeric ? "-me-2 flex-row-reverse" : "-ms-2"), children: [_jsx("span", { className: cn("transition-colors duration-(--duration-fade) ease-(--ease)", sorted
637
666
  ? "text-foreground"
638
667
  : "text-muted-foreground group-hover/sort:text-foreground"), children: _jsx(table.FlexRender, { header: header }) }), _jsx(SortIcon, { direction: sorted })] })) : (_jsx(table.FlexRender, { header: header })) }, header.id));
639
- }) }, group.id))) }), empty ? (_jsx(TableBody, { children: _jsx(TableRow, { "data-slot": "data-table-empty", className: "hover:bg-transparent", children: _jsx(TableCell, { colSpan: visibleColumnCount, className: "h-24 text-center text-sm text-muted-foreground", children: emptyMessage }) }) })) : virtual && outside ? (_jsx(TableVirtualBody, { rows: outsideRows, getRowKey: outsideKey, renderRow: renderOutside, scrollResetKey: search, onRangeChange: server ? (from, to) => load(pageStart + from, pageStart + to) : undefined })) : outside ? (_jsx(TableBody, { children: outsideRows.map(renderOutside) })) : virtual ? (_jsx(TableVirtualBody, { ...(grouped
668
+ }) }, group.id))) }), empty ? (_jsx(TableBody, { children: _jsx(TableRow, { "data-slot": "data-table-empty", className: "hover:bg-transparent", children: _jsx(TableCell, { colSpan: visibleColumnCount, className: "h-24 px-0 text-center text-sm text-muted-foreground first:ps-0 last:pe-0", children: _jsx("div", { className: "sticky start-0 w-[100cqi] px-4", children: failedEmpty ? (_jsxs("span", { "data-slot": "data-table-error", className: "inline-flex flex-wrap items-center justify-center gap-x-2", children: [text.loadError, _jsx(Button, { variant: "link", size: "sm", onClick: retry, children: text.retry })] })) : (emptyMessage) }) }) }) })) : virtual && outside ? (_jsx(TableVirtualBody, { rows: outsideRows, getRowKey: outsideKey, renderRow: renderOutside, scrollResetKey: search, onRangeChange: server ? (from, to) => load(pageStart + from, pageStart + to) : undefined })) : outside ? (_jsx(TableBody, { children: outsideRows.map(renderOutside) })) : virtual ? (_jsx(TableVirtualBody, { ...(grouped
640
669
  ? {
641
670
  groups: rows.map((group) => ({
642
671
  key: group.id,
@@ -646,10 +675,7 @@ export function DataTable({ columns, data = NO_ROWS, fetchRows, searchKey, searc
646
675
  onOpenChange: (open) => setGroupOpen(group.id, open),
647
676
  })),
648
677
  }
649
- : { rows }), getRowKey: rowKeyOf, renderRow: renderRow, sizeRows: sizeRows, scrollResetKey: search })) : grouped ? (rows.map((group) => (_jsxs(TableGroup, { open: !closedGroups.has(group.id), onOpenChange: (open) => setGroupOpen(group.id, open), children: [groupHeader(group), group.subRows.map(renderRow)] }, group.id)))) : (_jsx(TableBody, { children: rows.map(renderRow) }))] }), _jsxs("div", { "data-slot": "data-table-footer", className: cn("flex flex-wrap items-center justify-between gap-x-6 gap-y-3 font-mono text-xs text-muted-foreground tabular-nums", variant === "plain" && "px-6"), children: [_jsx("div", { "aria-live": "polite", children: server && served.error ? (_jsxs("span", { "data-slot": "data-table-error", className: "flex items-center gap-2", children: [text.loadError, _jsx(Button, { variant: "link", size: "sm", onClick: () => {
650
- setServed((old) => ({ ...old, error: null }));
651
- load(...lastRange.current);
652
- }, children: text.retry })] })) : withSelection ? (text.selected(selectedCount, server ? (served.total ?? 0) : data.length)) : null }), grouped ? (_jsx("span", { "data-slot": "data-table-count", "aria-live": "polite", children: text.groupCount(leafRowCount, rows.length) })) : (_jsxs("div", { className: "flex flex-wrap items-center gap-x-5 gap-y-2", children: [pageSizes.length > 1 ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { id: `${searchId}-rows`, children: text.rowsPerPage }), _jsxs(Select, { value: currentPageSize, onValueChange: (value) => value != null && table.setPageSize(Number(value)), items: pageSizes.map((n) => ({ value: n, label: String(n) })), children: [_jsx(SelectTrigger, { size: "sm", "aria-labelledby": `${searchId}-rows`, className: "w-auto min-w-0 gap-2 font-mono tabular-nums", children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: pageSizes.map((n) => (_jsx(SelectItem, { value: n, className: "font-mono tabular-nums", children: n }, n))) })] })] })) : null, _jsx("span", { "data-slot": "data-table-count", "aria-live": "polite", children: text.range(first, last, total) }), _jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(Button, { variant: "secondary", size: size, "aria-label": text.previous, disabled: !table.getCanPreviousPage(),
678
+ : { rows }), getRowKey: rowKeyOf, renderRow: renderRow, sizeRows: sizeRows, scrollResetKey: search })) : grouped ? (rows.map((group) => (_jsxs(TableGroup, { open: !closedGroups.has(group.id), onOpenChange: (open) => setGroupOpen(group.id, open), children: [groupHeader(group), group.subRows.map(renderRow)] }, group.id)))) : (_jsx(TableBody, { children: rows.map(renderRow) }))] }), _jsxs("div", { "data-slot": "data-table-footer", className: cn("flex flex-wrap items-center justify-between gap-x-6 gap-y-3 font-mono text-xs text-muted-foreground tabular-nums", variant === "plain" && "px-6"), children: [_jsx("div", { "aria-live": "polite", children: failedEmpty ? (_jsx("span", { className: "sr-only", children: text.loadError })) : server && served.error ? (_jsxs("span", { "data-slot": "data-table-error", className: "flex items-center gap-2", children: [text.loadError, _jsx(Button, { variant: "link", size: "sm", onClick: retry, children: text.retry })] })) : withSelection ? (text.selected(selectedCount, server ? (served.total ?? 0) : data.length)) : null }), grouped ? (_jsx("span", { "data-slot": "data-table-count", "aria-live": "polite", children: text.groupCount(leafRowCount, rows.length) })) : (_jsxs("div", { className: "flex flex-wrap items-center gap-x-5 gap-y-2", children: [pageSizes.length > 1 ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { id: `${searchId}-rows`, children: text.rowsPerPage }), _jsxs(Select, { value: currentPageSize, onValueChange: (value) => value != null && table.setPageSize(Number(value)), items: pageSizes.map((n) => ({ value: n, label: String(n) })), children: [_jsx(SelectTrigger, { size: "sm", "aria-labelledby": `${searchId}-rows`, className: "w-auto min-w-0 gap-2 font-mono tabular-nums", children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: pageSizes.map((n) => (_jsx(SelectItem, { value: n, className: "font-mono tabular-nums", children: n }, n))) })] })] })) : null, _jsx("span", { "data-slot": "data-table-count", "aria-live": "polite", children: text.range(first, last, total) }), _jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx(Button, { variant: "secondary", size: size, "aria-label": text.previous, disabled: !table.getCanPreviousPage(),
653
679
  // Keeps focus on the button at the first and last page, as Pagination does.
654
680
  focusableWhenDisabled: true, onClick: () => table.previousPage(), className: dense ? "min-w-(--control-h-sm) px-2" : "min-w-(--control-h) px-2.5", children: _jsx(ChevronLeftIcon, { className: "rtl:-scale-x-100" }) }), _jsx(Button, { variant: "secondary", size: size, "aria-label": text.next, disabled: !table.getCanNextPage(), focusableWhenDisabled: true, onClick: () => table.nextPage(), className: dense ? "min-w-(--control-h-sm) px-2" : "min-w-(--control-h) px-2.5", children: _jsx(ChevronRightIcon, { className: "rtl:-scale-x-100" }) })] })] }))] })] }));
655
681
  }
@@ -9,17 +9,25 @@ export interface DatePickerMessages {
9
9
  rangePlaceholder: string;
10
10
  }
11
11
  declare module "./locale" {
12
- interface Messages {
12
+ interface LocaleMessages {
13
13
  datePicker: DatePickerMessages;
14
14
  }
15
15
  }
16
16
  declare const triggerSizes: {
17
- readonly sm: "min-h-(--control-h-sm) gap-2 px-2.5 text-[13px] [&_svg]:size-3.5";
18
- readonly default: "min-h-(--control-h) gap-3 pe-3 ps-3.5 text-[15px] [&_svg]:size-4";
17
+ readonly sm: "min-h-(--control-h-sm) gap-2 px-2.5 text-13 [&_svg]:size-3.5";
18
+ readonly default: "min-h-(--control-h) gap-3 pe-3 ps-3.5 text-15 [&_svg]:size-4";
19
19
  };
20
20
  /** Calendar props a picker passes through: `disabled` days, `captionLayout` + `dropdown`, `startMonth`, `weekStartsOn` … */
21
21
  export type DatePickerCalendarProps = Pick<CalendarProps, "dropdown"> & Omit<PropsBase, "mode" | "required" | "locale" | "month" | "defaultMonth" | "onMonthChange">;
22
22
  interface PickerBaseProps {
23
+ /**
24
+ * Render the platform's own date field (`<input type="date">`, or `datetime-local`) in the field
25
+ * material, so a phone opens its own picker: `"touch"` (the default) on a phone only — a coarse
26
+ * primary pointer and a viewport under 768px — `true` everywhere, `false` never. Same value,
27
+ * `onValueChange`, `min`/`max`, `name`, `required`, `disabled` and `Field`; the platform's field
28
+ * shows no placeholder or presets, and formats the date in the device's language.
29
+ */
30
+ native?: boolean | "touch";
23
31
  /** Shown while no date is picked. Default `messages.datePicker.placeholder` (`rangePlaceholder`). */
24
32
  placeholder?: string;
25
33
  /**
@@ -32,6 +40,12 @@ interface PickerBaseProps {
32
40
  /** `sm` (30px) for dense surfaces; `default` (38px) everywhere else. */
33
41
  size?: keyof typeof triggerSizes;
34
42
  disabled?: boolean;
43
+ /**
44
+ * Shows the value without letting it change: the trigger stays focusable, so the date is read
45
+ * out and can be reached, but the calendar does not open. The field loses its recess, as a
46
+ * read-only input does; a form still submits the value.
47
+ */
48
+ readOnly?: boolean;
35
49
  /**
36
50
  * A date must be picked (a range: both its ends): until it is, the picker is `valueMissing`,
37
51
  * which stops a form's submit and marks the `Field` invalid.
@@ -71,21 +85,27 @@ export interface DatePickerProps extends PickerBaseProps {
71
85
  presets?: DatePickerPreset[];
72
86
  /** Close the popover once a day is picked. Default `true`. */
73
87
  closeOnSelect?: boolean;
88
+ /** The earliest day that can be picked: days before it are disabled. */
89
+ min?: Date;
90
+ /** The latest day that can be picked. */
91
+ max?: Date;
74
92
  }
75
93
  /**
76
94
  * DatePicker — a trigger like a `Select` trigger, with a calendar icon and the formatted date
77
95
  * or a placeholder, that opens a popover holding a `Calendar`. Optional presets sit in a
78
96
  * column beside it. Controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
79
97
  *
98
+ * On a phone it is the platform's own date field (`native="touch"`, the default).
99
+ *
80
100
  * The rule people break: a picker for dates people know by heart (a birthday, a passport's
81
101
  * date of issue). Those are faster typed into an `Input`.
82
102
  */
83
- export declare function DatePicker({ value: valueProp, defaultValue, onValueChange, presets, closeOnSelect, placeholder, locale, format, name, open: openProp, defaultOpen, onOpenChange, calendar, popover, ref, ...trigger }: DatePickerProps): React.JSX.Element;
103
+ export declare function DatePicker({ value: valueProp, defaultValue, onValueChange, presets, closeOnSelect, min, max, native, placeholder, locale, format, name, open: openProp, defaultOpen, onOpenChange, calendar, popover, ref, ...trigger }: DatePickerProps): React.JSX.Element;
84
104
  export interface DateRangePickerPreset {
85
105
  label: string;
86
106
  value: DateRange;
87
107
  }
88
- export interface DateRangePickerProps extends PickerBaseProps {
108
+ export interface DateRangePickerProps extends Omit<PickerBaseProps, "native"> {
89
109
  /** The picked range. `null` is empty; leave `undefined` for an uncontrolled picker. */
90
110
  value?: DateRange | null;
91
111
  defaultValue?: DateRange | null;
@@ -103,7 +123,8 @@ export interface DateRangePickerProps extends PickerBaseProps {
103
123
  * (one in a narrow space).
104
124
  * The popover stays open while the range is adjusted; it closes on a preset, Escape or an
105
125
  * outside click. With `name`, submits an ISO 8601 interval (`2026-10-05/2026-10-12`) once both
106
- * ends are picked.
126
+ * ends are picked. It keeps its popover on a phone too, one month wide: the platform has no range
127
+ * picker.
107
128
  */
108
129
  export declare function DateRangePicker({ value: valueProp, defaultValue, onValueChange, presets, numberOfMonths, placeholder, locale, format, name, open: openProp, defaultOpen, onOpenChange, calendar, popover, ref, ...trigger }: DateRangePickerProps): React.JSX.Element;
109
130
  export interface DateTimePickerMessages {
@@ -113,7 +134,7 @@ export interface DateTimePickerMessages {
113
134
  time: string;
114
135
  }
115
136
  declare module "./locale" {
116
- interface Messages {
137
+ interface LocaleMessages {
117
138
  dateTimePicker: DateTimePickerMessages;
118
139
  }
119
140
  }
@@ -150,11 +171,12 @@ export interface DateTimePickerProps extends Omit<PickerBaseProps, "format" | "p
150
171
  * DateTimePicker — a date and a time of day in one field: the DatePicker's trigger showing the
151
172
  * moment formatted for the locale ("Oct 5, 2026, 2:30 PM", "05.10.2026, 14:30"), opening a
152
173
  * `Calendar` with a `TimeField` under it. Picking a day keeps the time, and moves on to the time
153
- * while it is empty; Enter in the time field closes the popover.
174
+ * while it is empty; Enter in the time field closes the popover. On a phone it is the platform's
175
+ * own `datetime-local` field (`native="touch"`, the default).
154
176
  *
155
177
  * The value is a `Date`, in local time; a form gets it as `2026-10-05T14:30`. The rule people
156
178
  * break: a date and time for something that lasts all day (a deadline, a holiday). That is a
157
179
  * `DatePicker`.
158
180
  */
159
- export declare function DateTimePicker({ value: valueProp, defaultValue, onValueChange, min, max, hourCycle, step, defaultTime, format, placeholder, locale, name, open: openProp, defaultOpen, onOpenChange, calendar, popover, labels, ref, ...trigger }: DateTimePickerProps): React.JSX.Element;
181
+ export declare function DateTimePicker({ value: valueProp, defaultValue, onValueChange, min, max, hourCycle, step, defaultTime, format, placeholder, locale, name, open: openProp, defaultOpen, onOpenChange, calendar, popover, labels, native, ref, ...trigger }: DateTimePickerProps): React.JSX.Element;
160
182
  export {};