@zonsh/ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +643 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,612 @@
1
+ # Dashboard
2
+
3
+ ```tsx
4
+ import { PageHeader, Avatar, Breadcrumb, Button, Heading, Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemSeparator, ItemTitle, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Meter, Separator, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarItem, SidebarMenuBadge, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Stat, StatGroup, Tag, ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
5
+ import { Wordmark } from "@zonsh/ui/brand";
6
+ import { chartAnimation, ChartContainer, ChartGradient, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@zonsh/ui/chart";
7
+ import { DataTable, createDataTableColumnHelper } from "@zonsh/ui/data-table";
8
+ import { ArrowRightIcon, BanIcon, ChevronsUpDownIcon, CircleAlertIcon, CreditCardIcon, EllipsisIcon, FileTextIcon, InboxIcon, LayoutGridIcon, LifeBuoyIcon, LogOutIcon, MailIcon, PackageIcon, PackageOpenIcon, PercentIcon, SettingsIcon, TriangleAlertIcon, UserRoundIcon, UsersIcon } from "lucide-react";
9
+ import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
10
+ import * as React from "react";
11
+
12
+ /** Your product's mark — a placeholder for "Acme". Replace it and the name with your own; never zon's Logo. */
13
+ function AcmeMark() {
14
+ return (
15
+ <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinejoin="round">
16
+ <path d="M3.5 20.5 12 3.5l8.5 17z" />
17
+ <path d="M8 14.5h8" />
18
+ </svg>
19
+ );
20
+ }
21
+
22
+ /* A fictional online shop, fixed so every render is the same. */
23
+
24
+ const products = ["Linen tote bag", "Ceramic mug", "Dotted notebook", "Wool scarf", "Desk lamp", "A3 print"];
25
+
26
+ /**
27
+ * Orders per day for September 2026, split by channel, with the cancelled orders and the
28
+ * takings in euros. 1 September 2026 is a Tuesday.
29
+ */
30
+ const daily = Array.from({ length: 30 }, (_, i) => {
31
+ const weekday = (2 + i) % 7;
32
+ const weekend = weekday === 0 || weekday === 6;
33
+ const web = 42 + ((i * 13) % 17);
34
+ const app = weekend ? 34 + ((i * 7) % 9) : 12 + ((i * 29) % 13);
35
+ return {
36
+ day: `Sep ${i + 1}`,
37
+ web,
38
+ app,
39
+ cancelled: (i * 11) % 5 === 0 ? 3 : (i * 7) % 4,
40
+ takings: (web + app) * (31 + ((i * 5) % 9)),
41
+ };
42
+ });
43
+
44
+ /** What each product sells of the orders in a period. */
45
+ const productShare = [0.24, 0.21, 0.18, 0.15, 0.13, 0.09];
46
+
47
+ /**
48
+ * The two channels are kinds people tell apart, so each takes a category tone — the same one in the
49
+ * chart, its legend and the table's channel column. Violet and aqua, because the status colours on
50
+ * this page (info blue, success green, warning, destructive) already have their meanings. The app
51
+ * keeps its dash, so the series still read apart without colour.
52
+ */
53
+ const ordersConfig = {
54
+ web: { label: "Web shop", color: "var(--tone-violet)" },
55
+ app: { label: "App", color: "var(--tone-aqua)", dash: "4 3" },
56
+ } satisfies ChartConfig;
57
+
58
+ const channelColor = { "Web shop": "bg-tone-violet", App: "bg-tone-aqua" } as const;
59
+
60
+ type OrderStatus = "Processing" | "Shipped" | "Payment failed" | "Refunded";
61
+
62
+ /** Every status in its own colour, the same wherever it appears: in progress in the info colour,
63
+ * shipped in the success colour, failed in the destructive colour, and a refund in the warning colour,
64
+ * because someone may want to look at why. The text always names the status. */
65
+ const statusTone = {
66
+ Processing: "info",
67
+ Shipped: "success",
68
+ "Payment failed": "destructive",
69
+ Refunded: "warning",
70
+ } as const satisfies Record<OrderStatus, React.ComponentProps<typeof Tag>["tone"]>;
71
+
72
+ interface Order {
73
+ id: string;
74
+ product: string;
75
+ status: OrderStatus;
76
+ channel: "Web shop" | "App";
77
+ /** Total in euro cents. */
78
+ total: number;
79
+ /** ISO timestamp. */
80
+ placed: string;
81
+ }
82
+
83
+ /** The latest orders on 30 September, newest first, 37 minutes apart. */
84
+ const recentOrders: Order[] = Array.from({ length: 24 }, (_, i) => {
85
+ const minutes = 23 * 60 + 58 - i * 37;
86
+ const hh = String(Math.floor(minutes / 60)).padStart(2, "0");
87
+ const mm = String(minutes % 60).padStart(2, "0");
88
+ return {
89
+ id: `#${4812 - i}`,
90
+ product: products[(i * 5) % products.length]!,
91
+ status:
92
+ i === 0 ? "Processing" : i === 5 || i === 14 ? "Payment failed" : i === 9 ? "Refunded" : "Shipped",
93
+ channel: i % 3 === 1 ? "App" : "Web shop",
94
+ total: 1290 + ((i * 3700) % 18000),
95
+ placed: `2026-09-30T${hh}:${mm}:00`,
96
+ };
97
+ });
98
+
99
+ const number = new Intl.NumberFormat("en-US");
100
+
101
+ const euros = new Intl.NumberFormat("en-GB", { style: "currency", currency: "EUR" });
102
+
103
+ const wholeEuros = new Intl.NumberFormat("en-GB", {
104
+ style: "currency",
105
+ currency: "EUR",
106
+ maximumFractionDigits: 0,
107
+ });
108
+
109
+ const column = createDataTableColumnHelper<Order>();
110
+
111
+ const orderColumns = column.columns([
112
+ column.accessor("product", {
113
+ header: "Product",
114
+ cell: (info) => <span className="whitespace-nowrap text-foreground">{info.getValue()}</span>,
115
+ }),
116
+ column.accessor("status", {
117
+ header: "Status",
118
+ cell: (info) => {
119
+ const status = info.getValue();
120
+ return (
121
+ <Tag dot tone={statusTone[status]}>
122
+ {status}
123
+ </Tag>
124
+ );
125
+ },
126
+ }),
127
+ column.accessor("channel", {
128
+ header: "Channel",
129
+ cell: (info) => (
130
+ <span className="flex items-center gap-2 font-mono text-xs whitespace-nowrap text-muted-foreground">
131
+ <span aria-hidden className={`size-1.5 shrink-0 rounded-full ${channelColor[info.getValue()]}`} />
132
+ {info.getValue()}
133
+ </span>
134
+ ),
135
+ }),
136
+ column.accessor("total", {
137
+ header: "Total",
138
+ meta: { numeric: true },
139
+ enableGlobalFilter: false,
140
+ cell: (info) => euros.format(info.getValue() / 100),
141
+ }),
142
+ column.accessor("placed", {
143
+ header: "Placed",
144
+ meta: { numeric: true },
145
+ cell: (info) => `Sep 30, ${info.getValue().slice(11, 16)}`,
146
+ }),
147
+ column.accessor("id", {
148
+ header: "Order",
149
+ meta: { numeric: true },
150
+ }),
151
+ column.display({
152
+ id: "actions",
153
+ meta: { label: "Actions", className: "w-0" },
154
+ enableHiding: false,
155
+ header: () => <span className="sr-only">Actions</span>,
156
+ cell: ({ row }) => (
157
+ <Menu>
158
+ <MenuTrigger
159
+ render={
160
+ <Button variant="ghost" size="icon-sm" aria-label={`Actions for order ${row.original.id}`} />
161
+ }
162
+ >
163
+ <EllipsisIcon />
164
+ </MenuTrigger>
165
+ <MenuContent align="end">
166
+ <MenuItem>
167
+ <FileTextIcon />
168
+ View order
169
+ </MenuItem>
170
+ <MenuItem>
171
+ <MailIcon />
172
+ Resend receipt
173
+ </MenuItem>
174
+ <MenuSeparator />
175
+ <MenuItem>
176
+ <BanIcon />
177
+ Cancel order
178
+ </MenuItem>
179
+ </MenuContent>
180
+ </Menu>
181
+ ),
182
+ }),
183
+ ]);
184
+
185
+ const navigation = [
186
+ {
187
+ label: "Shop",
188
+ rows: [
189
+ { id: "overview", label: "Overview", icon: LayoutGridIcon },
190
+ { id: "orders", label: "Orders", icon: InboxIcon, count: 3 },
191
+ { id: "products", label: "Products", icon: PackageIcon },
192
+ { id: "customers", label: "Customers", icon: UsersIcon },
193
+ ],
194
+ },
195
+ {
196
+ label: "Store",
197
+ rows: [
198
+ { id: "discounts", label: "Discounts", icon: PercentIcon },
199
+ { id: "pages", label: "Pages", icon: FileTextIcon },
200
+ { id: "payments", label: "Payments", icon: CreditCardIcon },
201
+ ],
202
+ },
203
+ ];
204
+
205
+ const periods = [
206
+ { value: "7", label: "7 days" },
207
+ { value: "14", label: "14 days" },
208
+ { value: "30", label: "30 days" },
209
+ ];
210
+
211
+ type Day = (typeof daily)[number];
212
+
213
+ const sum = (days: Day[], pick: (day: Day) => number) => days.reduce((total, day) => total + pick(day), 0);
214
+
215
+ const ordersOf = (day: Day) => day.web + day.app;
216
+
217
+ const fulfilledOf = (days: Day[]) => {
218
+ const orders = sum(days, ordersOf);
219
+ return ((orders - sum(days, (d) => d.cancelled)) / orders) * 100;
220
+ };
221
+
222
+ interface Figure {
223
+ label: string;
224
+ value: string;
225
+ /** The figure day by day, for the sparkline. */
226
+ series: number[];
227
+ }
228
+
229
+ /** What sold most in the period, each against the best seller. */
230
+ function TopProducts({ orders, days }: { orders: number; days: number }) {
231
+ const rows = products.map((name, i) => ({ name, units: Math.round(orders * productShare[i]!) }));
232
+ const best = rows[0]!.units;
233
+ return (
234
+ <section aria-labelledby="dashboard-products-title" className="flex flex-col gap-4">
235
+ <div className="flex flex-wrap items-baseline justify-between gap-x-6 gap-y-1">
236
+ <Heading level={4} as="h3" id="dashboard-products-title">
237
+ Top products
238
+ </Heading>
239
+ <span className="font-mono text-xs text-muted-foreground">Units sold, last {days} days</span>
240
+ </div>
241
+ <ol className="m-0 flex list-none flex-col gap-4 border-t border-border/60 p-0 pt-5">
242
+ {rows.slice(0, 5).map((row) => (
243
+ <li key={row.name}>
244
+ <Meter
245
+ label={row.name}
246
+ value={row.units}
247
+ max={best}
248
+ showValue
249
+ format={{ style: "decimal" }}
250
+ getAriaValueText={(_, value) => `${value} sold`}
251
+ />
252
+ </li>
253
+ ))}
254
+ </ol>
255
+ </section>
256
+ );
257
+ }
258
+
259
+ /** "A", "A and B", "A, B and C": the order numbers as a sentence reads them. */
260
+ const listOf = (values: string[]) => new Intl.ListFormat("en", { type: "conjunction" }).format(values);
261
+
262
+ /** One count and its noun, singular or plural by the count: "1 payment", "2 payments". */
263
+ const count = (n: number, one: string, many: string) => `${n} ${n === 1 ? one : many}`;
264
+
265
+ /** The few things someone should act on today, each with its status colour and a way to it. */
266
+ function NeedsAttention() {
267
+ const failed = recentOrders.filter((order) => order.status === "Payment failed");
268
+ const processing = recentOrders.filter((order) => order.status === "Processing");
269
+ const items = [
270
+ {
271
+ id: "payments",
272
+ icon: <CircleAlertIcon className="text-destructive" />,
273
+ title: `${count(failed.length, "payment", "payments")} failed`,
274
+ description: `${listOf(failed.map((order) => order.id))} ${failed.length === 1 ? "is" : "are"} waiting for another card.`,
275
+ action: "Review",
276
+ },
277
+ {
278
+ id: "stock",
279
+ icon: <TriangleAlertIcon className="text-warning" />,
280
+ title: "Desk lamp is running low",
281
+ description: "4 left. At this month's pace they last about three days.",
282
+ action: "Restock",
283
+ },
284
+ {
285
+ id: "packing",
286
+ icon: <PackageOpenIcon className="text-info" />,
287
+ title: `${count(processing.length, "order", "orders")} to pack`,
288
+ description:
289
+ processing.length === 1
290
+ ? `${processing[0]?.id} came in at 23:58 and goes out with the first pickup.`
291
+ : `${listOf(processing.map((order) => order.id))} go out with the first pickup.`,
292
+ action: "Open",
293
+ },
294
+ ];
295
+ return (
296
+ <section aria-labelledby="dashboard-attention-title" className="flex flex-col gap-4">
297
+ <div className="flex flex-wrap items-baseline justify-between gap-x-6 gap-y-1">
298
+ <Heading level={4} as="h3" id="dashboard-attention-title">
299
+ Needs attention
300
+ </Heading>
301
+ <span className="font-mono text-xs text-muted-foreground">Today</span>
302
+ </div>
303
+ <ItemGroup render={<ul />} className="gap-0 border-t border-border/60 pt-1">
304
+ {items.map((item, i) => (
305
+ <React.Fragment key={item.id}>
306
+ {i > 0 && <ItemSeparator />}
307
+ <Item render={<li />} size="sm" className="px-0">
308
+ <ItemMedia variant="icon" className="self-start">
309
+ {item.icon}
310
+ </ItemMedia>
311
+ <ItemContent>
312
+ <ItemTitle>{item.title}</ItemTitle>
313
+ <ItemDescription>{item.description}</ItemDescription>
314
+ </ItemContent>
315
+ <ItemActions>
316
+ <Button variant="ghost" size="sm" aria-label={`${item.action}: ${item.title}`}>
317
+ {item.action}
318
+ <ArrowRightIcon className="rtl:-scale-x-100" />
319
+ </Button>
320
+ </ItemActions>
321
+ </Item>
322
+ </React.Fragment>
323
+ ))}
324
+ </ItemGroup>
325
+ </section>
326
+ );
327
+ }
328
+
329
+ /** The signed-in person at the foot of the sidebar, with their own menu. */
330
+ function AccountMenu() {
331
+ return (
332
+ <Menu>
333
+ <MenuTrigger
334
+ render={
335
+ <SidebarItem
336
+ render={<button type="button" />}
337
+ tooltip={false}
338
+ // A 24px avatar in place of a 16px icon: (row - avatar - border) / 2 a side in the icon rail.
339
+ className="group-data-[collapsible=icon]/sidebar:px-[6px]"
340
+ />
341
+ }
342
+ >
343
+ {/* Named by what it shows, so voice control reaches it by any word on it. */}
344
+ <span className="sr-only">Account: </span>
345
+ <Avatar size="sm" name="Alex Weber" aria-hidden />
346
+ <span className="flex min-w-0 flex-1 flex-col gap-0.5 text-start">
347
+ <span className="truncate leading-tight">Alex Weber</span>
348
+ <span className="truncate text-xs leading-tight text-muted-foreground">alex@example.com</span>
349
+ </span>
350
+ <ChevronsUpDownIcon className="text-muted-foreground" />
351
+ </MenuTrigger>
352
+ <MenuContent side="top" align="start" className="min-w-56">
353
+ <MenuItem>
354
+ <UserRoundIcon />
355
+ Your profile
356
+ </MenuItem>
357
+ <MenuItem>
358
+ <SettingsIcon />
359
+ Shop settings
360
+ </MenuItem>
361
+ <MenuSeparator />
362
+ <MenuItem>
363
+ <LogOutIcon className="rtl:-scale-x-100" />
364
+ Sign out
365
+ </MenuItem>
366
+ </MenuContent>
367
+ </Menu>
368
+ );
369
+ }
370
+
371
+ export function Dashboard() {
372
+ const [period, setPeriod] = React.useState<string[]>(["14"]);
373
+ const days = Number(period[0] ?? "14");
374
+ const range = daily.slice(-days);
375
+
376
+ const orders = sum(range, ordersOf);
377
+ const figures: Figure[] = [
378
+ { label: "Orders", value: number.format(orders), series: range.map(ordersOf) },
379
+ {
380
+ label: "Fulfilled",
381
+ value: `${fulfilledOf(range).toFixed(1)}%`,
382
+ series: range.map((d) => fulfilledOf([d])),
383
+ },
384
+ {
385
+ label: "Cancelled",
386
+ value: number.format(sum(range, (d) => d.cancelled)),
387
+ series: range.map((d) => d.cancelled),
388
+ },
389
+ {
390
+ label: "Takings",
391
+ value: wholeEuros.format(sum(range, (d) => d.takings)),
392
+ series: range.map((d) => d.takings),
393
+ },
394
+ ];
395
+
396
+ return (
397
+ <SidebarProvider
398
+ collapsible="icon"
399
+ storageKey={null}
400
+ className="h-[760px] min-h-0 w-full overflow-hidden surface-container"
401
+ >
402
+ <Sidebar aria-label="Shop">
403
+ <SidebarHeader>
404
+ <div className="flex min-h-(--control-h) items-center gap-2.5 overflow-hidden px-[7px] whitespace-nowrap">
405
+ <Wordmark mark={<AcmeMark />} size={24}>
406
+ Acme
407
+ </Wordmark>
408
+ </div>
409
+ </SidebarHeader>
410
+ <SidebarSeparator />
411
+ <SidebarContent>
412
+ {navigation.map((group) => (
413
+ <SidebarGroup key={group.label}>
414
+ <SidebarGroupLabel>{group.label}</SidebarGroupLabel>
415
+ {group.rows.map((row) => (
416
+ <SidebarItem
417
+ key={row.id}
418
+ href={`#${row.id}`}
419
+ current={row.id === "overview"}
420
+ onClick={(event) => event.preventDefault()}
421
+ >
422
+ <row.icon />
423
+ {row.label}
424
+ {"count" in row && row.count ? <SidebarMenuBadge>{row.count}</SidebarMenuBadge> : null}
425
+ </SidebarItem>
426
+ ))}
427
+ </SidebarGroup>
428
+ ))}
429
+ </SidebarContent>
430
+ <SidebarFooter>
431
+ <SidebarItem href="#help" onClick={(event) => event.preventDefault()}>
432
+ <LifeBuoyIcon />
433
+ Help
434
+ </SidebarItem>
435
+ <SidebarSeparator />
436
+ <AccountMenu />
437
+ </SidebarFooter>
438
+ <SidebarRail />
439
+ </Sidebar>
440
+
441
+ {/* The header stays put and the page scrolls under it, so the header needs no fill of its own:
442
+ it sits on the same ground as the rest, divided from it by a hairline. */}
443
+ <SidebarInset className="@container min-h-0 overflow-hidden">
444
+ <header className="flex shrink-0 items-center gap-3 border-b border-border/60 py-2 ps-2 pe-4 @xl:py-1.5">
445
+ <SidebarTrigger variant="bare" />
446
+ <Separator orientation="vertical" className="my-auto h-4 min-h-0 self-center" />
447
+ <Breadcrumb items={[{ label: "Shop", href: "#shop" }, { label: "Overview" }]} />
448
+ <Button size="sm" className="ms-auto">
449
+ Add product
450
+ </Button>
451
+ </header>
452
+
453
+ <div className="@container flex min-h-0 flex-1 flex-col gap-10 overflow-y-auto px-4 py-6 @xl:px-8 @xl:py-8">
454
+ <PageHeader
455
+ as="h2"
456
+ eyebrow="Shop"
457
+ title="Overview"
458
+ description={
459
+ <span className="font-mono text-xs text-muted-foreground">
460
+ Last {days} days, to Sep 30, 2026
461
+ </span>
462
+ }
463
+ actions={
464
+ <ToggleGroup aria-label="Reporting period" value={period} onValueChange={setPeriod}>
465
+ {periods.map((p) => (
466
+ <ToggleGroupItem key={p.value} value={p.value}>
467
+ {p.label}
468
+ </ToggleGroupItem>
469
+ ))}
470
+ </ToggleGroup>
471
+ }
472
+ />
473
+
474
+ <StatGroup className="grid-cols-2 @3xl:grid-cols-4">
475
+ {figures.map((figure) => (
476
+ <Stat key={figure.label} label={figure.label} value={figure.value} series={figure.series} />
477
+ ))}
478
+ </StatGroup>
479
+
480
+ <section aria-labelledby="dashboard-orders-title" className="flex flex-col gap-4">
481
+ <div className="flex flex-wrap items-baseline justify-between gap-x-6 gap-y-1">
482
+ <Heading level={4} as="h3" id="dashboard-orders-title">
483
+ Orders per day
484
+ </Heading>
485
+ <span className="font-mono text-xs text-muted-foreground">By channel</span>
486
+ </div>
487
+ <ChartContainer
488
+ config={ordersConfig}
489
+ className="aspect-auto h-60"
490
+ aria-label={`Orders per day by channel, last ${days} days`}
491
+ >
492
+ <AreaChart data={range} margin={{ top: 8, right: 8, left: 0, bottom: 0 }}>
493
+ <ChartGradient id="fill-dashboard-web" color="var(--color-web)" from={0.2} />
494
+ <ChartGradient id="fill-dashboard-app" color="var(--color-app)" from={0.3} />
495
+ <CartesianGrid />
496
+ <XAxis dataKey="day" tickMargin={8} minTickGap={24} />
497
+ <YAxis width={36} tickMargin={4} />
498
+ <ChartTooltip content={<ChartTooltipContent indicator="line" />} />
499
+ <Area
500
+ {...chartAnimation}
501
+ dataKey="app"
502
+ type="monotone"
503
+ stackId="orders"
504
+ stroke="var(--color-app)"
505
+ strokeDasharray="4 3"
506
+ fill="url(#fill-dashboard-app)"
507
+ />
508
+ <Area
509
+ {...chartAnimation}
510
+ dataKey="web"
511
+ type="monotone"
512
+ stackId="orders"
513
+ stroke="var(--color-web)"
514
+ fill="url(#fill-dashboard-web)"
515
+ />
516
+ <ChartLegend content={<ChartLegendContent />} />
517
+ </AreaChart>
518
+ </ChartContainer>
519
+ </section>
520
+
521
+ <div className="grid grid-cols-[minmax(0,1fr)] gap-10 @4xl:grid-cols-2 @4xl:gap-12">
522
+ <TopProducts orders={orders} days={days} />
523
+ <NeedsAttention />
524
+ </div>
525
+
526
+ <section aria-labelledby="dashboard-recent-title" className="flex flex-col gap-4">
527
+ <div className="flex flex-wrap items-baseline justify-between gap-x-6 gap-y-1">
528
+ <Heading level={4} as="h3" id="dashboard-recent-title">
529
+ Recent orders
530
+ </Heading>
531
+ <span className="font-mono text-xs text-muted-foreground">Sep 30, newest first</span>
532
+ </div>
533
+ <DataTable
534
+ size="sm"
535
+ columns={orderColumns}
536
+ data={recentOrders}
537
+ getRowId={(order) => order.id}
538
+ initialColumnVisibility={{ id: false }}
539
+ searchKey="product"
540
+ searchPlaceholder="Filter products…"
541
+ pageSize={6}
542
+ pageSizeOptions={[]}
543
+ label="Recent orders"
544
+ />
545
+ </section>
546
+ </div>
547
+ </SidebarInset>
548
+ </SidebarProvider>
549
+ );
550
+ }
551
+ ```
552
+
553
+ An overview for a fictional online shop: the `Sidebar` shell, a period `ToggleGroup`, four `Stat`s with sparklines, a stacked area `Chart`, best sellers as `Meter`s, today's to-dos as `Item` rows and a dense `DataTable` — all computed from the same rows, so all follow the period.
554
+
555
+ ## Usage
556
+
557
+ - **`SidebarProvider` + `SidebarInset`** — the app shell; the header bar sits on the page ground with a hairline under it, and the page scrolls beneath.
558
+ - **`StatGroup` / `Stat`** — the figures as type in a size container (`@container`), two columns to four by the page's width, not the window's.
559
+ - **`ChartContainer` + `DataTable`** — the days, and the latest rows.
560
+
561
+ - **Grids of panels** — two columns from `@4xl` of the page's container; below that one column written `grid-cols-[minmax(0,1fr)]`, never a bare `grid`, whose single `auto` track lets a table's or chart's minimum width push the page sideways on a phone. Section titles are `Heading level={4} as="h3"` under the `PageHeader`.
562
+
563
+ To adapt it, swap the rows (orders, sign-ups, deploys) and compute every figure from what the chart and table show, never a separate constant, so the page can't disagree with itself.
564
+
565
+
566
+ ## Colour
567
+
568
+ One meaning per colour, everywhere on the page. Statuses belong to orders — processing info, shipped success, failed payment destructive, refund warning — as icons in "Needs attention" (with a sentence and a ghost button) and dotted tags in the table. The two channels are kinds, in tones no status uses: web shop violet, app aqua, in chart, legend and table alike. The rest stays in the ink.
569
+
570
+ ## When to use
571
+
572
+ - The first page of a tool or admin area: what came in, what went wrong, what happened last.
573
+ - One metric on a marketing or report page: `Chart`'s `ChartCard`. A dashboard is for daily visitors.
574
+ - Working through a long list: make the `DataTable` the page; a dashboard links to it.
575
+
576
+ ## The parts
577
+
578
+ | Part | Page | Job |
579
+ | ------------------- | ------------ | -------------------------------------------------------------------------- |
580
+ | `SidebarProvider` | Sidebar | The app shell: collapses to an icon rail, a sheet on phones |
581
+ | `Breadcrumb` | Breadcrumb | Where the page sits, in the toolbar row |
582
+ | `ToggleGroup` | Toggle Group | The reporting period the figures and chart follow |
583
+ | `StatGroup`, `Stat` | Stat | A few figures: eyebrow labels, mono tabular values, a sparkline under each |
584
+ | `ChartContainer` | Chart | Orders per day, stacked by channel in two category tones, with a legend |
585
+ | `Meter` | Meter | The best sellers, each against the best one |
586
+ | `Item` | Item | What needs attention: a status icon, a sentence, a way to it |
587
+ | `Menu`, `Avatar` | Menu | The account at the foot of the sidebar |
588
+ | `DataTable` | Data Table | The latest orders, dense, with status tags and row actions |
589
+ | `Tag` | Tag | Order status, one status colour each; `destructive` only for a failure |
590
+ | `Button` | Button | The one primary action of the view, "Add product" |
591
+
592
+ ## Brand rules
593
+
594
+ - **Do** set figures as type with `Stat`: eyebrow label, mono `tabular-nums` value, top hairline. No cards around them.
595
+ - **Do** keep sparklines one line in the ink, no axis, no colour; the figure is what is read.
596
+ - **Do** say where the numbers come from — the period and the date they run to.
597
+ - **Do** keep one colour per status and one tone per channel across chart, tags and list; words and legend name them.
598
+ - **Do** keep one primary action in view. Period, table and row actions are segmented, raised or ghost.
599
+ - **Don't** add a change to every figure or colour the figures. A change belongs where the period before is comparable and the direction matters (`Stat` colours it by `better`); here periods end on the same day, so there is none.
600
+ - **Don't** invent figures to fill the row. Four honest numbers beat eight decorative ones.
601
+ - **Don't** box the sections. Headings, whitespace and hairlines carry the structure; the table is the only card.
602
+
603
+ ## Accessibility
604
+
605
+ - The sidebar is a named `<nav>`; the trigger reports `aria-expanded`, and on phones the sheet traps focus and closes on Esc.
606
+ - The figures are a description list, each value read with its label; keep the unit in the value's text. Sparklines are hidden; the chart carries the days.
607
+ - Each best seller is a meter named by its product, its value read as "275 sold".
608
+ - Each "Needs attention" button names what it opens ("Review: 2 payments failed"); the icons are decorative, the sentence says the status.
609
+ - The account menu's trigger is a button named "Account: Alex Weber"; the menu opens upwards and closes on Esc.
610
+ - The reporting period is a named toggle group; arrow keys move between periods, the pressed one is `aria-pressed`.
611
+ - The chart is named with `aria-label`, period included; focusable, arrow keys step through the days. The figures give the totals in text.
612
+ - Each section has a heading to navigate by; the table is named with `label`, and every row action button names its order.