@zonsh/ui 0.5.0 → 0.6.0

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 +639 -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,485 @@
1
+ # Filter Bar
2
+
3
+ ```tsx
4
+ import { FilterBar, type FilterField } from "@zonsh/ui/filter-bar";
5
+ import { CalendarIcon, CircleDotIcon, EuroIcon, UserIcon } from "lucide-react";
6
+
7
+ /** A status dot in the option list: the colour with the label beside it. */
8
+ const dot = (tone: string) => <span aria-hidden className={`size-1.5 rounded-full ${tone}`} />;
9
+
10
+ const orderFields: FilterField[] = [
11
+ {
12
+ id: "status",
13
+ label: "Status",
14
+ kind: "select",
15
+ icon: <CircleDotIcon />,
16
+ options: [
17
+ { value: "unpaid", label: "Unpaid", icon: dot("bg-warning") },
18
+ { value: "paid", label: "Paid", icon: dot("bg-info") },
19
+ { value: "shipped", label: "Shipped", icon: dot("bg-success") },
20
+ { value: "refunded", label: "Refunded", icon: dot("bg-muted-foreground") },
21
+ ],
22
+ },
23
+ { id: "customer", label: "Customer", kind: "text", icon: <UserIcon />, placeholder: "Name or email" },
24
+ {
25
+ id: "total",
26
+ label: "Total",
27
+ kind: "number",
28
+ icon: <EuroIcon />,
29
+ min: 0,
30
+ step: 5,
31
+ format: { style: "currency", currency: "EUR", maximumFractionDigits: 0 },
32
+ },
33
+ { id: "placed", label: "Placed", kind: "date", icon: <CalendarIcon /> },
34
+ ];
35
+
36
+ export function Basic() {
37
+ return (
38
+ <FilterBar
39
+ fields={orderFields}
40
+ locale="en-GB"
41
+ defaultValue={[
42
+ { field: "status", operator: "is", value: ["paid", "shipped"] },
43
+ { field: "total", operator: "gte", value: 50 },
44
+ ]}
45
+ />
46
+ );
47
+ }
48
+
49
+ /* Driving a Table: the rows are filtered on the client with matchesFilters. */
50
+ ```
51
+
52
+ The filters on a list or table, above it. Each is a raised chip that reads as a sentence — "Status is Paid, Shipped", "Total ≥ €50" — with a × to remove it. A chip opens a popover to edit the condition (a small `Select`) and the value (a checked list, text, a `NumberField` or a range `Calendar`). The ghost "Filter" button opens a `Menu` of fields; picking one adds its chip and opens it. "Clear all" appears when there is something to clear.
53
+
54
+ ## Usage
55
+
56
+ ```tsx
57
+ import { FilterBar, matchesFilters, type Filter, type FilterField } from "@zonsh/ui/filter-bar";
58
+
59
+ // Your rows: any object type, here an order.
60
+ type Order = { status: string; customer: string; total: number; placed: Date };
61
+ declare const orders: Order[];
62
+
63
+ const fields: FilterField<Order>[] = [
64
+ {
65
+ id: "status",
66
+ label: "Status",
67
+ kind: "select",
68
+ options: [
69
+ { value: "paid", label: "Paid" },
70
+ { value: "shipped", label: "Shipped" },
71
+ ],
72
+ },
73
+ { id: "customer", label: "Customer", kind: "text" },
74
+ { id: "total", label: "Total", kind: "number", format: { style: "currency", currency: "EUR" } },
75
+ { id: "placed", label: "Placed", kind: "date" },
76
+ ];
77
+
78
+ const [filters, setFilters] = React.useState<Filter[]>([]);
79
+ const rows = orders.filter((order) => matchesFilters(order, filters, fields));
80
+
81
+ <FilterBar fields={fields} value={filters} onValueChange={setFilters} />;
82
+ ```
83
+
84
+ The props you'll reach for: `fields`, `value` / `onValueChange`, `size`.
85
+
86
+ ## When to use
87
+
88
+ - Lists and tables people narrow by several properties: orders, products, issues, deploys.
89
+ - With a `Table` or a list, filter the rows with `matchesFilters`; with a `DataTable`, filter its `data` the same way (it keeps its own search, sorting and pager).
90
+ - With server data, send `value` — a plain array of `{ field, operator, value }` — as the query, and keep it in the URL.
91
+ - A few fixed choices ("All / Open / Closed") are a `ToggleGroup` or `Tabs`; a single search is an `Input`.
92
+
93
+ ## Examples
94
+
95
+ ### With a table
96
+
97
+ One state for the bar and a `Table`, with a mono count beside the bar and a line for when nothing matches.
98
+
99
+ ```tsx
100
+ import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tag } from "@zonsh/ui";
101
+ import { FilterBar, matchesFilters, type Filter, type FilterField } from "@zonsh/ui/filter-bar";
102
+ import { EuroIcon, FolderIcon, PackageIcon, TextIcon } from "lucide-react";
103
+ import * as React from "react";
104
+
105
+ interface Product {
106
+ name: string;
107
+ category: string;
108
+ stock: number;
109
+ price: number;
110
+ /** ISO date of the last restock. */
111
+ restocked: string;
112
+ }
113
+
114
+ const products: Product[] = [
115
+ { name: "Stoneware mug, oat", category: "Kitchen", stock: 42, price: 18, restocked: "2026-09-24" },
116
+ { name: "Linen tea towel", category: "Kitchen", stock: 0, price: 12, restocked: "2026-08-30" },
117
+ { name: "Beeswax candle, tall", category: "Home", stock: 7, price: 22, restocked: "2026-09-12" },
118
+ { name: "Walnut serving board", category: "Kitchen", stock: 3, price: 64, restocked: "2026-09-02" },
119
+ { name: "Wool throw, moss", category: "Home", stock: 11, price: 120, restocked: "2026-09-28" },
120
+ { name: "Notebook, dot grid", category: "Stationery", stock: 85, price: 9, restocked: "2026-09-18" },
121
+ { name: "Brass desk lamp", category: "Home", stock: 2, price: 145, restocked: "2026-07-21" },
122
+ { name: "Fountain pen, black", category: "Stationery", stock: 14, price: 38, restocked: "2026-09-26" },
123
+ ];
124
+
125
+ const productFields: FilterField<Product>[] = [
126
+ { id: "name", label: "Product", kind: "text", icon: <TextIcon /> },
127
+ {
128
+ id: "category",
129
+ label: "Category",
130
+ kind: "select",
131
+ icon: <FolderIcon />,
132
+ options: ["Kitchen", "Home", "Stationery"].map((c) => ({ value: c, label: c })),
133
+ },
134
+ { id: "stock", label: "Stock", kind: "number", icon: <PackageIcon />, min: 0 },
135
+ {
136
+ id: "price",
137
+ label: "Price",
138
+ kind: "number",
139
+ icon: <EuroIcon />,
140
+ min: 0,
141
+ format: { style: "currency", currency: "EUR", maximumFractionDigits: 0 },
142
+ },
143
+ ];
144
+
145
+ const euro = new Intl.NumberFormat("en-GB", { style: "currency", currency: "EUR", maximumFractionDigits: 0 });
146
+
147
+ export function WithTable() {
148
+ const [filters, setFilters] = React.useState<Filter[]>([
149
+ { field: "category", operator: "is", value: ["Kitchen", "Home"] },
150
+ { field: "stock", operator: "lte", value: 10 },
151
+ ]);
152
+ const rows = products.filter((p) => matchesFilters(p, filters, productFields));
153
+ return (
154
+ <div className="flex w-full flex-col gap-3">
155
+ <div className="flex flex-wrap items-center justify-between gap-2">
156
+ <FilterBar fields={productFields} value={filters} onValueChange={setFilters} locale="en-GB" />
157
+ <span className="font-mono text-xs text-muted-foreground tabular-nums" aria-live="polite">
158
+ {rows.length} of {products.length} products
159
+ </span>
160
+ </div>
161
+ <Table size="sm">
162
+ <TableHeader>
163
+ <TableRow>
164
+ <TableHead>Product</TableHead>
165
+ <TableHead>Category</TableHead>
166
+ <TableHead numeric>Stock</TableHead>
167
+ <TableHead numeric>Price</TableHead>
168
+ </TableRow>
169
+ </TableHeader>
170
+ <TableBody>
171
+ {rows.map((p) => (
172
+ <TableRow key={p.name}>
173
+ <TableCell className="text-foreground">{p.name}</TableCell>
174
+ <TableCell>{p.category}</TableCell>
175
+ <TableCell numeric>{p.stock === 0 ? <Tag tone="warning">Sold out</Tag> : p.stock}</TableCell>
176
+ <TableCell numeric>{euro.format(p.price)}</TableCell>
177
+ </TableRow>
178
+ ))}
179
+ {rows.length === 0 && (
180
+ <TableRow>
181
+ <TableCell colSpan={4} className="py-6 text-center text-muted-foreground">
182
+ No products match these filters. Remove one to see more.
183
+ </TableCell>
184
+ </TableRow>
185
+ )}
186
+ </TableBody>
187
+ </Table>
188
+ </div>
189
+ );
190
+ }
191
+
192
+ /* A long list gets a search field over its options. */
193
+ ```
194
+
195
+ ### Searchable options
196
+
197
+ A `select` field with 8 or more options gets a search field (`searchable` forces it on or off).
198
+
199
+ ```tsx
200
+ import { FilterBar, type FilterField } from "@zonsh/ui/filter-bar";
201
+ import { HashIcon, TagIcon, UserIcon } from "lucide-react";
202
+
203
+ const labels = [
204
+ "bug",
205
+ "docs",
206
+ "performance",
207
+ "accessibility",
208
+ "design",
209
+ "good first issue",
210
+ "help wanted",
211
+ "needs repro",
212
+ "regression",
213
+ "security",
214
+ "tests",
215
+ "windows",
216
+ "macos",
217
+ "linux",
218
+ ];
219
+
220
+ const issueFields: FilterField[] = [
221
+ {
222
+ id: "labels",
223
+ label: "Label",
224
+ kind: "select",
225
+ icon: <TagIcon />,
226
+ options: labels.map((l) => ({ value: l, label: l })),
227
+ },
228
+ {
229
+ id: "milestone",
230
+ label: "Milestone",
231
+ kind: "select",
232
+ icon: <HashIcon />,
233
+ options: ["v2.4", "v2.5", "v3.0"].map((m) => ({ value: m, label: m })),
234
+ },
235
+ { id: "author", label: "Author", kind: "text", icon: <UserIcon /> },
236
+ ];
237
+
238
+ export function Searchable() {
239
+ return (
240
+ <FilterBar
241
+ fields={issueFields}
242
+ defaultValue={[{ field: "labels", operator: "is", value: ["bug", "regression", "windows"] }]}
243
+ />
244
+ );
245
+ }
246
+
247
+ /* Dates: a date field edits its range in the Calendar. */
248
+ ```
249
+
250
+ ### Dates in a calendar
251
+
252
+ A `date` field edits a range of ISO days (`{ from: "2026-10-05", to: "2026-10-18" }`, either end optional) in a range `Calendar`. For presets ("Last 7 days") or two months, give the field your own `editor`.
253
+
254
+ ```tsx
255
+ import { FilterBar, type FilterField } from "@zonsh/ui/filter-bar";
256
+ import { CalendarIcon, FolderIcon } from "lucide-react";
257
+
258
+ const bookingFields: FilterField[] = [
259
+ {
260
+ id: "date",
261
+ label: "Class date",
262
+ kind: "date",
263
+ icon: <CalendarIcon />,
264
+ },
265
+ {
266
+ id: "course",
267
+ label: "Course",
268
+ kind: "select",
269
+ icon: <FolderIcon />,
270
+ options: ["Wheel throwing", "Hand building", "Glazing"].map((c) => ({ value: c, label: c })),
271
+ },
272
+ ];
273
+
274
+ export function DateCalendar() {
275
+ return (
276
+ <FilterBar
277
+ fields={bookingFields}
278
+ locale="en-GB"
279
+ defaultValue={[{ field: "date", operator: "between", value: { from: "2026-10-05", to: "2026-10-18" } }]}
280
+ />
281
+ );
282
+ }
283
+
284
+ /* Driving a DataTable: filter `data` before it goes in; the table keeps its search, sort and pager. */
285
+ ```
286
+
287
+ ### With a DataTable
288
+
289
+ `DataTable` takes the filtered rows as `data`; its search, sorting and pager work on what is left.
290
+
291
+ ```tsx
292
+ import { Tag } from "@zonsh/ui";
293
+ import { createDataTableColumnHelper, DataTable } from "@zonsh/ui/data-table";
294
+ import { FilterBar, matchesFilters, type Filter, type FilterField } from "@zonsh/ui/filter-bar";
295
+ import { CircleDotIcon, FolderIcon, HashIcon } from "lucide-react";
296
+ import * as React from "react";
297
+
298
+ // dot: as in the first example on this page that uses them.
299
+
300
+ type DeployStatus = "Succeeded" | "Building" | "Failed" | "Cancelled";
301
+
302
+ interface Deploy {
303
+ id: string;
304
+ project: string;
305
+ status: DeployStatus;
306
+ /** Seconds. */
307
+ duration: number;
308
+ }
309
+
310
+ const deployStatuses: DeployStatus[] = [
311
+ "Succeeded",
312
+ "Succeeded",
313
+ "Building",
314
+ "Succeeded",
315
+ "Failed",
316
+ "Cancelled",
317
+ ];
318
+
319
+ const deployProjects = ["Docs site", "Storefront", "Mobile API", "Image resizer"];
320
+
321
+ const deploys: Deploy[] = Array.from({ length: 24 }, (_, i) => ({
322
+ id: `DEP-${String(1024 - i).padStart(4, "0")}`,
323
+ project: deployProjects[(i * 3) % deployProjects.length]!,
324
+ status: deployStatuses[i % deployStatuses.length]!,
325
+ duration: 20 + ((i * 37) % 280),
326
+ }));
327
+
328
+ const statusTag = {
329
+ Succeeded: { tone: "success" },
330
+ Building: { tone: "info" },
331
+ Failed: { tone: "destructive" },
332
+ Cancelled: { variant: "muted" },
333
+ } as const;
334
+
335
+ const deployFields: FilterField<Deploy>[] = [
336
+ {
337
+ id: "project",
338
+ label: "Project",
339
+ kind: "select",
340
+ icon: <FolderIcon />,
341
+ options: deployProjects.map((p) => ({ value: p, label: p })),
342
+ },
343
+ {
344
+ id: "status",
345
+ label: "Status",
346
+ kind: "select",
347
+ icon: <CircleDotIcon />,
348
+ options: (Object.keys(statusTag) as DeployStatus[]).map((s) => ({ value: s, label: s })),
349
+ },
350
+ { id: "duration", label: "Duration (s)", kind: "number", icon: <HashIcon />, min: 0, step: 10 },
351
+ ];
352
+
353
+ const column = createDataTableColumnHelper<Deploy>();
354
+
355
+ const deployColumns = column.columns([
356
+ column.accessor("project", {
357
+ header: "Project",
358
+ cell: (info) => <span className="whitespace-nowrap text-foreground">{info.getValue()}</span>,
359
+ }),
360
+ column.accessor("status", {
361
+ header: "Status",
362
+ cell: (info) => (
363
+ <Tag dot {...statusTag[info.getValue()]}>
364
+ {info.getValue()}
365
+ </Tag>
366
+ ),
367
+ }),
368
+ column.accessor("duration", {
369
+ header: "Duration",
370
+ meta: { numeric: true },
371
+ enableGlobalFilter: false,
372
+ cell: (info) => `${info.getValue()}s`,
373
+ }),
374
+ column.accessor("id", { header: "Deploy ID", meta: { numeric: true } }),
375
+ ]);
376
+
377
+ export function WithDataTable() {
378
+ const [filters, setFilters] = React.useState<Filter[]>([
379
+ { field: "status", operator: "is-not", value: ["Cancelled"] },
380
+ ]);
381
+ const data = React.useMemo(
382
+ () => deploys.filter((d) => matchesFilters(d, filters, deployFields)),
383
+ [filters],
384
+ );
385
+ return (
386
+ <div className="flex w-full flex-col gap-3">
387
+ <FilterBar fields={deployFields} value={filters} onValueChange={setFilters} />
388
+ <DataTable
389
+ columns={deployColumns}
390
+ data={data}
391
+ getRowId={(deploy) => deploy.id}
392
+ size="sm"
393
+ pageSize={5}
394
+ pageSizeOptions={[]}
395
+ searchPlaceholder="Search deploys"
396
+ label="Deploys"
397
+ emptyMessage="No deploys match these filters."
398
+ />
399
+ </div>
400
+ );
401
+ }
402
+ ```
403
+
404
+ ### On a phone
405
+
406
+ On a phone — a coarse pointer and a screen under 768px — a chip opens its editor in a bottom sheet instead of a popover: the field's name as the title, the condition beside it and the options at full width, where a thumb can reach them. `sheet` sets it always (as here, to show it on any screen) or never.
407
+
408
+ ```tsx
409
+ import { FilterBar, type FilterField } from "@zonsh/ui/filter-bar";
410
+ import { CalendarIcon, CircleDotIcon, EuroIcon, UserIcon } from "lucide-react";
411
+
412
+ // dot, orderFields: as in the first example on this page that uses them.
413
+
414
+ export function OnAPhone() {
415
+ return (
416
+ <FilterBar
417
+ sheet
418
+ fields={orderFields}
419
+ locale="en-GB"
420
+ defaultValue={[{ field: "status", operator: "is", value: ["unpaid"] }]}
421
+ />
422
+ );
423
+ }
424
+ ```
425
+
426
+ ## Fields and filters
427
+
428
+ | `kind` | The chip reads | Operators | `value` | Field options |
429
+ | -------- | ------------------------------- | ------------------------------------- | ---------------------- | ------------------------------ |
430
+ | `select` | Status is Paid, Shipped | `is`, `is-not` | `string[]` | `options`, `searchable` |
431
+ | `text` | Customer contains “berg” | `contains`, `does-not-contain` | `string` | `placeholder` |
432
+ | `number` | Total ≥ €50 | `gte`, `lte`, `gt`, `lt`, `eq`, `neq` | `number \| null` | `min`, `max`, `step`, `format` |
433
+ | `date` | Placed 5 Oct 2026 – 18 Oct 2026 | `between` | `{ from?, to? }` (ISO) | `editor` |
434
+
435
+ Every field has `id`, `label`, an optional menu `icon` and an optional `accessor(row)` for `matchesFilters` (default `row[id]`). A `select` row value may be an array (tags); `is` matches when any is picked. Text matches case-insensitively. Dates compare as local days (`Date`, timestamp or ISO string), both ends inclusive; a reversed range is read the right way round, and a non-ISO end is ignored. A value no option has (from a URL) shows on the chip as is.
436
+
437
+ A new filter is in `value` while its popover is open, matches every row, and is dropped if it closes empty. One chip per field: picking a field again opens its chip.
438
+
439
+ ## Props
440
+
441
+ | Prop | Type | Default |
442
+ | ------------------------------------------ | ----------------------------------------- | ------------------------------------------ |
443
+ | `fields` | `FilterField[]` | — |
444
+ | `value` / `defaultValue` / `onValueChange` | `Filter[]` | `[]` |
445
+ | `size` | `"sm" \| "default"` | `"sm"` |
446
+ | `locale` | `string` — dates and numbers on the chips | the `LocaleProvider`'s, else the browser's |
447
+ | `labels` | `Partial<FilterBarMessages>` | English |
448
+ | `sheet` | `boolean \| "phone"` — edit in a bottom sheet; `"phone"` on a phone only | `"phone"` |
449
+
450
+ `matchesFilters(row, filters, fields)` returns `true` when the row passes every filter. The root is a `<div role="group">` and forwards its props. Parts carry `data-slot`: `filter-bar`, `filter-bar-chip`, `filter-bar-chip-trigger`, `filter-bar-chip-remove`, `filter-bar-editor`, `filter-bar-add`, `filter-bar-clear`.
451
+
452
+ `labels` renames everything the bar writes; a `LocaleProvider` sets them for every bar (`messages.filterBar`) and supplies the default `locale`.
453
+
454
+ ## Brand rules
455
+
456
+ - **Do** name fields as the column headers name them, so "Status is Paid" matches the table below.
457
+ - **Do** show the rows left beside the bar, in mono, and say what to do when none are.
458
+ - **Do** align the bar with the table's start; the count or a secondary action goes at the other end.
459
+ - **Don't** colour the chips. A status option may carry its dot beside its label in the list, but the chip stays grey.
460
+ - **Don't** make "Filter" a primary button.
461
+ - **Don't** add a field for every column; offer the few people actually narrow by.
462
+
463
+ ## Accessibility
464
+
465
+ - The bar is a group labelled "Filters"; each chip is a group labelled "Status filter" holding the chip button and "Remove Status filter".
466
+ - A chip's popover (or sheet) is labelled by the field's name and opens with focus on the value, not the condition. Closing returns focus to the chip, or to "Filter" if the filter was dropped.
467
+ - Option lists are a listbox.
468
+ - Removing a filter or clearing all moves focus to "Filter", so it is never lost.
469
+
470
+ ### Keyboard
471
+
472
+ | Key | What it does |
473
+ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
474
+ | Tab | Moves through the chips and their remove buttons, "Filter" and "Clear all" |
475
+ | Enter / Space | Opens a chip's popover or the "Filter" menu, or presses remove or "Clear all" |
476
+ | ↑ / ↓ | Moves through the fields in the "Filter" menu, and the options in a chip's list |
477
+ | Enter | Adds the highlighted field and opens its popover; in a list, checks or unchecks the option; in a text or number field, closes the popover |
478
+ | Escape | Closes the popover or the menu |
479
+
480
+ In a chip's popover, Shift+Tab reaches the condition. A date filter's calendar takes the `Calendar` keys, a number field the `NumberField` keys. Typing searches a list that has a search field.
481
+
482
+ ---
483
+
484
+ - Import: `import { FilterBar, matchesFilters } from "@zonsh/ui/filter-bar"`
485
+ - Source: `packages/ui/src/components/filter-bar.tsx`