@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,739 @@
1
+ # Chart
2
+
3
+ ```tsx
4
+ import { chartAnimation, ChartContainer, ChartGradient, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
5
+ import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
6
+
7
+ const requests = [
8
+ { day: "Sep 22", requests: 1240 },
9
+ { day: "Sep 23", requests: 1385 },
10
+ { day: "Sep 24", requests: 1302 },
11
+ { day: "Sep 25", requests: 1518 },
12
+ { day: "Sep 26", requests: 1460 },
13
+ { day: "Sep 27", requests: 690 },
14
+ { day: "Sep 28", requests: 612 },
15
+ { day: "Sep 29", requests: 1410 },
16
+ { day: "Sep 30", requests: 1555 },
17
+ { day: "Oct 1", requests: 1620 },
18
+ { day: "Oct 2", requests: 1498 },
19
+ { day: "Oct 3", requests: 1530 },
20
+ { day: "Oct 4", requests: 720 },
21
+ { day: "Oct 5", requests: 655 },
22
+ ];
23
+
24
+ const requestsConfig = {
25
+ requests: { label: "Requests" },
26
+ } satisfies ChartConfig;
27
+
28
+ export function Default() {
29
+ return (
30
+ <ChartContainer config={requestsConfig} className="aspect-auto h-60" aria-label="Requests per day">
31
+ <AreaChart data={requests} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
32
+ <ChartGradient id="fill-requests" color="var(--color-requests)" />
33
+ <CartesianGrid />
34
+ <XAxis dataKey="day" tickMargin={8} minTickGap={24} />
35
+ <YAxis width={40} tickMargin={4} />
36
+ <ChartTooltip content={<ChartTooltipContent hideIndicator />} />
37
+ <Area
38
+ {...chartAnimation}
39
+ dataKey="requests"
40
+ type="monotone"
41
+ stroke="var(--color-requests)"
42
+ fill="url(#fill-requests)"
43
+ />
44
+ </AreaChart>
45
+ </ChartContainer>
46
+ );
47
+ }
48
+ ```
49
+
50
+ Recharts charts inside a `ChartContainer`, which sizes the chart, turns a `config` into one `--color-<key>` variable per series, and themes Recharts: 11px Licht Mono ticks, horizontal hairline grid, no tick marks, a gliding hairline cursor (a band on bars), 1.5px lines with only the active dot. Tooltips are menu material with mono tabular values; legends are mono 11px.
51
+
52
+ Series are **monochrome by default** — the `--chart-1` … `--chart-5` ramp, told apart by value plus a dash, hatch or gradient. When the categories are the point (storage by file type), `palette="tones"` gives each series a category tone (`--tone-blue`, orange, aqua, magenta, lime, violet, in order). Use the same tone for the same kind across the app, and keep the legend.
53
+
54
+ ## Usage
55
+
56
+ The kit has its own entry, `@zonsh/ui/chart`, and needs `recharts` v3 (an optional dependency):
57
+
58
+ ```bash
59
+ pnpm add recharts
60
+ ```
61
+
62
+ ```tsx
63
+ import {
64
+ chartAnimation,
65
+ ChartContainer,
66
+ ChartGradient,
67
+ ChartTooltip,
68
+ ChartTooltipContent,
69
+ type ChartConfig,
70
+ } from "@zonsh/ui/chart";
71
+ import { Area, AreaChart, CartesianGrid, XAxis } from "recharts";
72
+
73
+ const config = { requests: { label: "Requests" } } satisfies ChartConfig;
74
+
75
+ <ChartContainer config={config} className="aspect-auto h-60" aria-label="Requests per day">
76
+ <AreaChart data={data}>
77
+ <ChartGradient id="fill-requests" color="var(--color-requests)" />
78
+ <CartesianGrid />
79
+ <XAxis dataKey="day" tickMargin={8} />
80
+ <ChartTooltip content={<ChartTooltipContent hideIndicator />} />
81
+ <Area
82
+ {...chartAnimation}
83
+ dataKey="requests"
84
+ type="monotone"
85
+ stroke="var(--color-requests)"
86
+ fill="url(#fill-requests)"
87
+ />
88
+ </AreaChart>
89
+ </ChartContainer>;
90
+ ```
91
+
92
+ The props you'll reach for: `config` and an `aria-label` on `ChartContainer`, `className` to size it (`aspect-auto h-60`), and `palette` when categories need tones.
93
+
94
+ ## When to use
95
+
96
+ - **Area** for one quantity over time; stacked areas for parts of a whole over time.
97
+ - **Bar** to compare categories; **horizontal** for long names; values at the tips with `LabelList`.
98
+ - **Line** for several series over time, told apart with `dash`; tones only when each line is a kind people know by colour elsewhere.
99
+ - **Pie** only for two or three parts; past that, bars. A **donut** puts the total in the middle.
100
+ - A single number with no trend is a figure, not a chart (brand guide, Typography → Numbers).
101
+ - Rows people search or sort belong in `DataTable`; offer one beside any chart whose exact values matter.
102
+
103
+ ## Examples
104
+
105
+ ### Stacked area
106
+
107
+ `type="natural"` curves in the category tones, one series dashed so they read apart without colour. Use `natural` for slow trends; `monotone` when values jump — it never overshoots.
108
+
109
+ ```tsx
110
+ import { chartAnimation, ChartContainer, ChartGradient, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
111
+ import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
112
+
113
+ const tasks = [
114
+ { week: "W32", online: 362, store: 194 },
115
+ { week: "W33", online: 395, store: 181 },
116
+ { week: "W34", online: 388, store: 186 },
117
+ { week: "W35", online: 431, store: 163 },
118
+ { week: "W36", online: 472, store: 152 },
119
+ { week: "W37", online: 458, store: 158 },
120
+ { week: "W38", online: 506, store: 137 },
121
+ { week: "W39", online: 547, store: 121 },
122
+ { week: "W40", online: 538, store: 126 },
123
+ { week: "W41", online: 584, store: 108 },
124
+ ];
125
+
126
+ // No colours here: `palette="tones"` gives each series its category tone, in key order.
127
+ const tasksConfig = {
128
+ online: { label: "Online orders" },
129
+ store: { label: "In-store orders", dash: "4 3" },
130
+ } satisfies ChartConfig;
131
+
132
+ export function AreaStacked() {
133
+ return (
134
+ <ChartContainer
135
+ config={tasksConfig}
136
+ palette="tones"
137
+ className="aspect-auto h-64"
138
+ aria-label="Orders per week"
139
+ >
140
+ <AreaChart data={tasks} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
141
+ <ChartGradient id="fill-online" color="var(--color-online)" from={0.2} />
142
+ <ChartGradient id="fill-store" color="var(--color-store)" from={0.3} />
143
+ <CartesianGrid />
144
+ <XAxis dataKey="week" tickMargin={8} />
145
+ <YAxis width={40} tickMargin={4} />
146
+ <ChartTooltip content={<ChartTooltipContent indicator="line" />} />
147
+ <Area
148
+ {...chartAnimation}
149
+ dataKey="store"
150
+ type="natural"
151
+ stackId="tasks"
152
+ stroke="var(--color-store)"
153
+ strokeDasharray="4 3"
154
+ fill="url(#fill-store)"
155
+ />
156
+ <Area
157
+ {...chartAnimation}
158
+ dataKey="online"
159
+ type="natural"
160
+ stackId="tasks"
161
+ stroke="var(--color-online)"
162
+ fill="url(#fill-online)"
163
+ />
164
+ <ChartLegend content={<ChartLegendContent />} />
165
+ </AreaChart>
166
+ </ChartContainer>
167
+ );
168
+ }
169
+ ```
170
+
171
+ ### Grouped bars
172
+
173
+ The second series is hatched with `ChartHatch` and `pattern: "hatch"`, so tooltip and legend swatches match.
174
+
175
+ ```tsx
176
+ import { chartAnimation, ChartContainer, ChartHatch, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
177
+ import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
178
+
179
+ const weekdays = [
180
+ { day: "Mon", online: 96, store: 34 },
181
+ { day: "Tue", online: 104, store: 29 },
182
+ { day: "Wed", online: 112, store: 31 },
183
+ { day: "Thu", online: 99, store: 27 },
184
+ { day: "Fri", online: 87, store: 22 },
185
+ ];
186
+
187
+ const weekdaysConfig = {
188
+ online: { label: "Online" },
189
+ store: { label: "In store", color: "var(--chart-3)", pattern: "hatch" },
190
+ } satisfies ChartConfig;
191
+
192
+ export function BarGrouped() {
193
+ return (
194
+ <ChartContainer config={weekdaysConfig} className="aspect-auto h-64" aria-label="Orders per weekday">
195
+ <BarChart data={weekdays} barGap={2} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
196
+ <ChartHatch id="hatch-store" color="var(--color-store)" />
197
+ <CartesianGrid />
198
+ <XAxis dataKey="day" tickMargin={8} />
199
+ <YAxis width={32} tickMargin={4} />
200
+ <ChartTooltip content={<ChartTooltipContent />} />
201
+ <Bar
202
+ {...chartAnimation}
203
+ dataKey="online"
204
+ fill="var(--color-online)"
205
+ radius={[3, 3, 0, 0]}
206
+ maxBarSize={24}
207
+ />
208
+ <Bar
209
+ {...chartAnimation}
210
+ dataKey="store"
211
+ fill="url(#hatch-store)"
212
+ radius={[3, 3, 0, 0]}
213
+ maxBarSize={24}
214
+ />
215
+ <ChartLegend content={<ChartLegendContent />} />
216
+ </BarChart>
217
+ </ChartContainer>
218
+ );
219
+ }
220
+ ```
221
+
222
+ ### Labelled bars
223
+
224
+ `grid="vertical"`, values at the bar tips, and no value axis.
225
+
226
+ ```tsx
227
+ import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
228
+ import { Bar, BarChart, CartesianGrid, LabelList, XAxis, YAxis } from "recharts";
229
+
230
+ const pages = [
231
+ { page: "Getting started", views: 1204 },
232
+ { page: "Pricing", views: 932 },
233
+ { page: "Changelog", views: 618 },
234
+ { page: "API reference", views: 341 },
235
+ { page: "Careers", views: 52 },
236
+ ];
237
+
238
+ const pagesConfig = {
239
+ views: { label: "Views" },
240
+ } satisfies ChartConfig;
241
+
242
+ export function BarHorizontal() {
243
+ return (
244
+ <ChartContainer
245
+ config={pagesConfig}
246
+ grid="vertical"
247
+ className="aspect-auto h-60"
248
+ aria-label="Views per page"
249
+ >
250
+ <BarChart data={pages} layout="vertical" margin={{ top: 0, right: 48, left: 0, bottom: 0 }}>
251
+ <CartesianGrid />
252
+ <XAxis type="number" hide />
253
+ <YAxis type="category" dataKey="page" width={128} tickMargin={8} axisLine={false} />
254
+ <ChartTooltip content={<ChartTooltipContent hideIndicator />} />
255
+ <Bar
256
+ {...chartAnimation}
257
+ dataKey="views"
258
+ fill="var(--color-views)"
259
+ radius={[0, 3, 3, 0]}
260
+ maxBarSize={20}
261
+ >
262
+ <LabelList
263
+ dataKey="views"
264
+ position="right"
265
+ offset={8}
266
+ formatter={(v) => Number(v).toLocaleString()}
267
+ />
268
+ </Bar>
269
+ </BarChart>
270
+ </ChartContainer>
271
+ );
272
+ }
273
+ ```
274
+
275
+ ### Category tones
276
+
277
+ File types share tones with their tags elsewhere; the axis names every bar, so colour is never the only label.
278
+
279
+ ```tsx
280
+ import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
281
+ import { Bar, BarChart, CartesianGrid, Cell, LabelList, XAxis, YAxis } from "recharts";
282
+
283
+ const storage = [
284
+ { type: "documents", gb: 42 },
285
+ { type: "spreadsheets", gb: 18 },
286
+ { type: "images", gb: 126 },
287
+ { type: "audio", gb: 34 },
288
+ { type: "archives", gb: 61 },
289
+ { type: "video", gb: 208 },
290
+ ];
291
+
292
+ const storageConfig = {
293
+ documents: { label: "Documents" },
294
+ spreadsheets: { label: "Spreadsheets" },
295
+ images: { label: "Images" },
296
+ audio: { label: "Audio" },
297
+ archives: { label: "Archives" },
298
+ video: { label: "Video" },
299
+ } satisfies ChartConfig;
300
+
301
+ export function BarTones() {
302
+ return (
303
+ <ChartContainer
304
+ config={storageConfig}
305
+ palette="tones"
306
+ grid="vertical"
307
+ className="aspect-auto h-64"
308
+ aria-label="Storage by file type in GB"
309
+ >
310
+ <BarChart data={storage} layout="vertical" margin={{ top: 0, right: 48, left: 0, bottom: 0 }}>
311
+ <CartesianGrid />
312
+ <XAxis type="number" hide />
313
+ <YAxis
314
+ type="category"
315
+ dataKey="type"
316
+ width={104}
317
+ tickMargin={8}
318
+ axisLine={false}
319
+ tickFormatter={(type: keyof typeof storageConfig) => String(storageConfig[type]?.label ?? type)}
320
+ />
321
+ <ChartTooltip
322
+ content={<ChartTooltipContent nameKey="type" hideLabel valueFormatter={(v) => `${v} GB`} />}
323
+ />
324
+ <Bar {...chartAnimation} dataKey="gb" radius={[0, 3, 3, 0]} maxBarSize={20}>
325
+ {storage.map((d) => (
326
+ <Cell key={d.type} fill={`var(--color-${d.type})`} />
327
+ ))}
328
+ <LabelList dataKey="gb" position="right" offset={8} />
329
+ </Bar>
330
+ </BarChart>
331
+ </ChartContainer>
332
+ );
333
+ }
334
+ ```
335
+
336
+ ### Lines with dashes
337
+
338
+ Told apart by `--chart-1…3` and dash; the config's `dash` shows in the tooltip (`indicator="line"`) and legend.
339
+
340
+ ```tsx
341
+ import { chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
342
+ import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts";
343
+
344
+ const latency = [
345
+ { hour: "00:00", p50: 112, p95: 248, p99: 410 },
346
+ { hour: "03:00", p50: 108, p95: 236, p99: 388 },
347
+ { hour: "06:00", p50: 121, p95: 262, p99: 455 },
348
+ { hour: "09:00", p50: 146, p95: 318, p99: 560 },
349
+ { hour: "12:00", p50: 152, p95: 335, p99: 602 },
350
+ { hour: "15:00", p50: 149, p95: 322, p99: 571 },
351
+ { hour: "18:00", p50: 133, p95: 290, p99: 498 },
352
+ { hour: "21:00", p50: 118, p95: 257, p99: 431 },
353
+ ];
354
+
355
+ const latencyConfig = {
356
+ p50: { label: "p50" },
357
+ p95: { label: "p95", color: "var(--chart-2)", dash: "6 3" },
358
+ p99: { label: "p99", color: "var(--chart-3)", dash: "1.5 3" },
359
+ } satisfies ChartConfig;
360
+
361
+ export function LineMultiSeries() {
362
+ return (
363
+ <ChartContainer
364
+ config={latencyConfig}
365
+ className="aspect-auto h-64"
366
+ aria-label="Response time in milliseconds"
367
+ >
368
+ <LineChart data={latency} margin={{ top: 8, right: 20, left: 4, bottom: 0 }}>
369
+ <CartesianGrid />
370
+ <XAxis dataKey="hour" tickMargin={8} />
371
+ <YAxis width={40} tickMargin={4} />
372
+ <ChartTooltip content={<ChartTooltipContent indicator="line" valueFormatter={(v) => `${v} ms`} />} />
373
+ <Line {...chartAnimation} dataKey="p50" type="monotone" stroke="var(--color-p50)" />
374
+ <Line
375
+ {...chartAnimation}
376
+ dataKey="p95"
377
+ type="monotone"
378
+ stroke="var(--color-p95)"
379
+ strokeDasharray="6 3"
380
+ />
381
+ <Line
382
+ {...chartAnimation}
383
+ dataKey="p99"
384
+ type="monotone"
385
+ stroke="var(--color-p99)"
386
+ strokeDasharray="1.5 3"
387
+ />
388
+ <ChartLegend content={<ChartLegendContent />} />
389
+ </LineChart>
390
+ </ChartContainer>
391
+ );
392
+ }
393
+ ```
394
+
395
+ ### Pie
396
+
397
+ Dark to light, clockwise from twelve. `[--chart-sector-gap:var(--background)]` on the container draws a 2px gap in the colour behind (the card's surface in a card). `activeShape={ChartActiveSector}` lifts the hovered slice 4px out and 3% larger.
398
+
399
+ ```tsx
400
+ import { ChartActiveSector, chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
401
+ import { Cell, Pie, PieChart } from "recharts";
402
+
403
+ const sources = [
404
+ { source: "search", visits: 1460 },
405
+ { source: "direct", visits: 980 },
406
+ { source: "social", visits: 310 },
407
+ ];
408
+
409
+ const sourcesConfig = {
410
+ search: { label: "Search", color: "var(--chart-1)" },
411
+ direct: { label: "Direct", color: "var(--chart-3)" },
412
+ social: { label: "Social", color: "var(--chart-5)" },
413
+ } satisfies ChartConfig;
414
+
415
+ export function PieBasic() {
416
+ return (
417
+ <ChartContainer
418
+ config={sourcesConfig}
419
+ className="mx-auto aspect-square max-h-72 [--chart-sector-gap:var(--background)]"
420
+ aria-label="Visits by source"
421
+ >
422
+ <PieChart>
423
+ <ChartTooltip content={<ChartTooltipContent nameKey="source" hideLabel />} />
424
+ <Pie
425
+ {...chartAnimation}
426
+ data={sources}
427
+ dataKey="visits"
428
+ nameKey="source"
429
+ activeShape={ChartActiveSector}
430
+ outerRadius="88%"
431
+ startAngle={90}
432
+ endAngle={-270}
433
+ >
434
+ {sources.map((t) => (
435
+ <Cell key={t.source} fill={`var(--color-${t.source})`} />
436
+ ))}
437
+ </Pie>
438
+ <ChartLegend content={<ChartLegendContent nameKey="source" />} />
439
+ </PieChart>
440
+ </ChartContainer>
441
+ );
442
+ }
443
+ ```
444
+
445
+ ### Donut
446
+
447
+ `innerRadius`, a 2px `paddingAngle` and the total in Licht at the centre, in tones.
448
+
449
+ ```tsx
450
+ import { ChartActiveSector, chartAnimation, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
451
+ import { Cell, Pie, PieChart } from "recharts";
452
+
453
+ // sources: as in the first example on this page that uses them.
454
+
455
+ const sourceTotal = sources.reduce((sum, t) => sum + t.visits, 0);
456
+
457
+ const sourceTones = {
458
+ search: { label: "Search" },
459
+ direct: { label: "Direct" },
460
+ social: { label: "Social" },
461
+ } satisfies ChartConfig;
462
+
463
+ export function PieDonut() {
464
+ return (
465
+ <ChartContainer
466
+ config={sourceTones}
467
+ palette="tones"
468
+ className="mx-auto aspect-square max-h-72"
469
+ aria-label="Visits by source"
470
+ >
471
+ <PieChart>
472
+ <ChartTooltip content={<ChartTooltipContent nameKey="source" hideLabel />} />
473
+ <Pie
474
+ {...chartAnimation}
475
+ data={sources}
476
+ dataKey="visits"
477
+ nameKey="source"
478
+ activeShape={ChartActiveSector}
479
+ innerRadius="62%"
480
+ outerRadius="88%"
481
+ paddingAngle={2}
482
+ startAngle={90}
483
+ endAngle={-270}
484
+ >
485
+ {sources.map((t) => (
486
+ <Cell key={t.source} fill={`var(--color-${t.source})`} />
487
+ ))}
488
+ </Pie>
489
+ <text
490
+ x="50%"
491
+ y="50%"
492
+ textAnchor="middle"
493
+ dominantBaseline="middle"
494
+ className="fill-foreground font-heading text-[28px] font-light"
495
+ >
496
+ {sourceTotal.toLocaleString()}
497
+ </text>
498
+ <ChartLegend content={<ChartLegendContent nameKey="source" />} />
499
+ </PieChart>
500
+ </ChartContainer>
501
+ );
502
+ }
503
+ ```
504
+
505
+ ### Chart card
506
+
507
+ A `Card` with an eyebrow, a Licht number computed from the chart's data, and a compact chart.
508
+
509
+ ```tsx
510
+ import { Card, Eyebrow } from "@zonsh/ui";
511
+ import { chartAnimation, ChartContainer, ChartGradient, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
512
+ import { Area, AreaChart, CartesianGrid, XAxis } from "recharts";
513
+
514
+ // requests, requestsConfig: as in the first example on this page that uses them.
515
+
516
+ const total = requests.reduce((sum, d) => sum + d.requests, 0);
517
+
518
+ export function ChartCard() {
519
+ return (
520
+ <Card className="max-w-xl gap-5">
521
+ <div className="flex flex-wrap items-end justify-between gap-x-6 gap-y-3">
522
+ <div className="flex flex-col gap-3">
523
+ <Eyebrow>Requests · 14 days</Eyebrow>
524
+ <p className="m-0 flex items-baseline gap-2.5 font-heading font-light tracking-[-0.02em] text-foreground">
525
+ <span className="text-[48px] leading-none tabular-nums">{total.toLocaleString()}</span>
526
+ <span className="text-[20px] leading-none text-foreground-soft">requests</span>
527
+ </p>
528
+ </div>
529
+ </div>
530
+ <ChartContainer config={requestsConfig} className="aspect-auto h-40" aria-label="Requests per day">
531
+ <AreaChart data={requests} margin={{ top: 4, right: 20, left: 20, bottom: 0 }}>
532
+ <ChartGradient id="fill-requests-card" color="var(--color-requests)" />
533
+ <CartesianGrid />
534
+ <XAxis dataKey="day" tickMargin={8} minTickGap={32} />
535
+ <ChartTooltip content={<ChartTooltipContent hideIndicator />} />
536
+ <Area
537
+ {...chartAnimation}
538
+ dataKey="requests"
539
+ type="monotone"
540
+ stroke="var(--color-requests)"
541
+ fill="url(#fill-requests-card)"
542
+ />
543
+ </AreaChart>
544
+ </ChartContainer>
545
+ </Card>
546
+ );
547
+ }
548
+ ```
549
+
550
+ ### Loading and empty
551
+
552
+ `loading` keeps the frame with a sweeping placeholder (`aria-busy`). `empty` keeps the frame and says why there's nothing to plot — write `emptyMessage` as why and what would fill it. Neither draws the chart you pass.
553
+
554
+ ```tsx
555
+ import { Eyebrow } from "@zonsh/ui";
556
+ import { ChartContainer, type ChartConfig } from "@zonsh/ui/chart";
557
+ import { Area, AreaChart } from "recharts";
558
+
559
+ // requests, requestsConfig: as in the first example on this page that uses them.
560
+
561
+ /** The same frame while the data loads, and when there is none for the period. */
562
+ export function States() {
563
+ return (
564
+ <div className="grid w-full max-w-3xl gap-8 sm:grid-cols-2">
565
+ <div className="flex flex-col gap-3">
566
+ <Eyebrow>Loading</Eyebrow>
567
+ <ChartContainer
568
+ loading
569
+ config={requestsConfig}
570
+ className="aspect-auto h-40"
571
+ aria-label="Requests per day"
572
+ >
573
+ <AreaChart data={requests}>
574
+ <Area dataKey="requests" />
575
+ </AreaChart>
576
+ </ChartContainer>
577
+ </div>
578
+ <div className="flex flex-col gap-3">
579
+ <Eyebrow>Empty</Eyebrow>
580
+ <ChartContainer
581
+ empty
582
+ emptyMessage="No requests in these 14 days. They show here once an API key is used."
583
+ config={requestsConfig}
584
+ className="aspect-auto h-40"
585
+ aria-label="Requests per day"
586
+ >
587
+ <AreaChart data={[]}>
588
+ <Area dataKey="requests" />
589
+ </AreaChart>
590
+ </ChartContainer>
591
+ </div>
592
+ </div>
593
+ );
594
+ }
595
+ ```
596
+
597
+ ### Values as a table
598
+
599
+ A table gives exact numbers, and is what many screen reader users want. Offer both when values matter.
600
+
601
+ ```tsx
602
+ import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
603
+ import { chartAnimation, ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
604
+ import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
605
+
606
+ // requests, requestsConfig: as in the first example on this page that uses them.
607
+
608
+ /** The chart for the shape, and the same values as a table for the exact numbers. */
609
+ export function WithTable() {
610
+ return (
611
+ <Tabs defaultValue="chart" className="max-w-xl">
612
+ <TabsList variant="underline" aria-label="Requests per day, shown as">
613
+ <TabsTab value="chart">Chart</TabsTab>
614
+ <TabsTab value="table">Table</TabsTab>
615
+ </TabsList>
616
+ <TabsPanel value="chart" className="pt-4">
617
+ <ChartContainer config={requestsConfig} className="aspect-auto h-56" aria-label="Requests per day">
618
+ <BarChart data={requests} margin={{ top: 4, right: 0, left: 0, bottom: 0 }}>
619
+ <CartesianGrid />
620
+ <XAxis dataKey="day" tickMargin={8} minTickGap={24} />
621
+ <YAxis width={40} tickMargin={4} />
622
+ <ChartTooltip content={<ChartTooltipContent hideIndicator />} />
623
+ <Bar {...chartAnimation} dataKey="requests" fill="var(--color-requests)" radius={[3, 3, 0, 0]} />
624
+ </BarChart>
625
+ </ChartContainer>
626
+ </TabsPanel>
627
+ <TabsPanel value="table" className="pt-4">
628
+ <Table size="sm" variant="plain" containerProps={{ className: "max-h-56" }}>
629
+ <TableHeader>
630
+ <TableRow>
631
+ <TableHead>Day</TableHead>
632
+ <TableHead numeric>Requests</TableHead>
633
+ </TableRow>
634
+ </TableHeader>
635
+ <TableBody>
636
+ {requests.map((row) => (
637
+ <TableRow key={row.day}>
638
+ <TableCell>{row.day}</TableCell>
639
+ <TableCell numeric>{row.requests.toLocaleString("en-US")}</TableCell>
640
+ </TableRow>
641
+ ))}
642
+ </TableBody>
643
+ </Table>
644
+ </TabsPanel>
645
+ </Tabs>
646
+ );
647
+ }
648
+ ```
649
+
650
+ ## Props
651
+
652
+ ### `ChartContainer`
653
+
654
+ | Prop | Type | Default |
655
+ | -------------- | ----------------------------------------------------- | -------------- |
656
+ | `config` | `ChartConfig` — series key → settings | — |
657
+ | `palette` | `"mono" \| "tones"` — default colours | `"mono"` |
658
+ | `grid` | `"horizontal" \| "vertical" \| "both"` | `"horizontal"` |
659
+ | `loading` | `boolean` — the frame with a placeholder, `aria-busy` | `false` |
660
+ | `empty` | `boolean` — the frame with `emptyMessage` | `false` |
661
+ | `emptyMessage` | `ReactNode` | `labels.empty` |
662
+ | `labels` | `{ loading?, empty? }` | English |
663
+ | `className` | size it: `aspect-auto h-60`, `max-h-72` | `aspect-video` |
664
+ | `children` | one Recharts chart | — |
665
+
666
+ Forwards `div` props; name the chart with `aria-label`. `--chart-sector-gap` separates pie segments with a 2px rule in that colour.
667
+
668
+ ### `ChartConfig` entry (`ChartSeriesConfig`)
669
+
670
+ | Key | Type | Purpose |
671
+ | --------- | ------------------------ | ------------------------------------------------------------------------- |
672
+ | `label` | `ReactNode` | name in tooltip and legend |
673
+ | `color` | CSS colour | defaults to the palette in key order: `var(--chart-n)` or `var(--tone-…)` |
674
+ | `icon` | lucide component | replaces the swatch |
675
+ | `dash` | SVG dash array (`"4 3"`) | shows a dashed line swatch; pass the same to `strokeDasharray` |
676
+ | `pattern` | `"solid" \| "hatch"` | shows a hatched swatch; fill the mark with `ChartHatch` |
677
+
678
+ A key that isn't a plain CSS name (`"New York"`, `"p99.9"`) is escaped in its variable: write `chartColor("New York")` wherever you'd write the `var()` (`stroke`, a `Cell`'s `fill`, a gradient or hatch `color`). Keep gradient and hatch `id`s plain: they go into `url(#id)`.
679
+
680
+ ### `ChartTooltipContent`
681
+
682
+ | Prop | Type | Default |
683
+ | ---------------- | ---------------------------------- | ------------------ |
684
+ | `indicator` | `"dot" \| "line" \| "dashed"` | `"dot"` |
685
+ | `hideLabel` | `boolean` | `false` |
686
+ | `hideIndicator` | `boolean` — for a single series | `false` |
687
+ | `labelFormatter` | `(label, payload) => ReactNode` | — |
688
+ | `valueFormatter` | `(value, name, item) => ReactNode` | `toLocaleString()` |
689
+ | `nameKey` | payload field naming each item | — |
690
+ | `labelKey` | config key / field for the heading | — |
691
+
692
+ `ChartLegendContent` takes `nameKey` and `hideIcon`. `ChartTooltip` and `ChartLegend` are Recharts' `Tooltip` and `Legend`. `ChartGradient` and `ChartHatch` take `id` and `color` (plus `from`/`to` opacity, or `angle`); use them as `fill="url(#id)"`. `useChart()` returns the config; `chartColor(key)` a series' escaped `var(--color-<key>)`.
693
+
694
+ ## Many points
695
+
696
+ A chart a few hundred pixels wide shows at most two or three points per pixel, but Recharts processes them all. Past a few thousand:
697
+
698
+ - **Downsample.** `downsample(data, keys, buckets = 600)` keeps each bucket's first point and each series' low and high, so peaks survive: 100,000 readings become about 3,000.
699
+
700
+ ```tsx
701
+ <LineChart data={downsample(readings, ["cpu", "memory"])}>
702
+ ```
703
+
704
+ - **Give a time or number axis `type="number"`.** A category axis measures every label — seconds at 10,000 points.
705
+
706
+ ## Motion
707
+
708
+ Recharts' defaults are slow (1.5s, 400ms for bars). Spread `chartAnimation` — 300ms on `--ease` — on every series:
709
+
710
+ ```tsx
711
+ <Line {...chartAnimation} dataKey="p95" stroke="var(--color-p95)" />
712
+ ```
713
+
714
+ `ChartContainer` can't set it: Recharts reads it from each series element, and rewriting children would break wrapped series. Animation is off under `prefers-reduced-motion`.
715
+
716
+ ## Brand rules
717
+
718
+ - **Do** leave colours to the palette; in grey, separate series by value plus dash, hatch or opacity.
719
+ - **Do** keep lines at 1.5px with no dots, bars at a 3px data-end radius and at most 24px thick.
720
+ - **Do** show a legend for two or more series; a single series is named by its title or `aria-label`.
721
+ - **Do** label sparingly — bar tips or the line's end, never a number on every point.
722
+ - **Don't** colour one series for emphasis, or use a status colour for a series that is not that status — `--destructive` marks errors only.
723
+ - **Don't** mix tones and status colours in one chart; they would read as one scale.
724
+ - **Don't** add a second y-axis; two measures of different scale are two charts.
725
+ - **Don't** add chart junk: tick marks, vertical grid on columns, borders around marks, 3D, shadows.
726
+ - **Don't** present invented numbers as measured ones.
727
+
728
+ ## Accessibility
729
+
730
+ - Name every chart with `aria-label` on `ChartContainer` (or a visible title it sits under).
731
+ - Recharts' accessibility layer is on: the chart is focusable and arrow keys move the tooltip; focus shows the 2px `--control-focus` outline.
732
+ - Identity never depends on colour or grey alone — legends, axis labels, dashes and hatches carry it. Offer a table when exact numbers matter.
733
+ - `loading` is `aria-busy` and says "Loading the chart" (`messages.chart.loading`); `empty` says why in text. `LocaleProvider` sets both.
734
+ - Animation is off under `prefers-reduced-motion`, and the tooltip and cursor move instantly there.
735
+
736
+ ---
737
+
738
+ - Import: `import { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartGradient, ChartHatch, useChart } from "@zonsh/ui/chart"`
739
+ - Source: `packages/ui/src/components/chart.tsx`