@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,222 @@
1
+ # Spinner
2
+
3
+ ```tsx
4
+ import { Eyebrow, SPINNER_VARIANTS, Spinner } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ // Columns by the room the example has, not the screen, so the names never run together.
9
+ <div className="@container w-full max-w-3xl">
10
+ <ul className="m-0 grid list-none grid-cols-2 gap-x-6 gap-y-10 p-0 @2xs:grid-cols-3 @md:grid-cols-4 @xl:grid-cols-6">
11
+ {SPINNER_VARIANTS.map((variant) => (
12
+ <li key={variant} className="flex flex-col items-center gap-4">
13
+ <Spinner variant={variant} size="lg" label={`Loading (${variant})`} />
14
+ <Eyebrow as="span">{variant}</Eyebrow>
15
+ </li>
16
+ ))}
17
+ </ul>
18
+ </div>
19
+ );
20
+ }
21
+ ```
22
+
23
+ An indeterminate loading indicator with `role="status"` and a name, in the current text colour. CSS only: no timers, the same on the server, transform and opacity. Under reduced motion each face holds a "busy" pose and breathes in opacity.
24
+
25
+ ## Usage
26
+
27
+ ```tsx
28
+ import { Spinner } from "@zonsh/ui";
29
+
30
+ <Spinner label="Sending message" />
31
+ <Spinner variant="dots" size="sm" label="Saving draft" />
32
+ ```
33
+
34
+ - `label` — say what is loading: "Sending message".
35
+ - `variant` — the face; `ring` by default.
36
+ - `size` — `sm` 12px, `default` 16px, `lg` 20px.
37
+
38
+ | Face | What it does (still: under reduced motion) |
39
+ | ---------- | -------------------------------------------------------- |
40
+ | `ring` | A lucide `LoaderCircle`, once a second. The default. |
41
+ | `arc` | An arc growing and shrinking as it turns, over a track. |
42
+ | `dots` | Three dots lifting in turn. Still: an ellipsis. |
43
+ | `bars` | Four bars rising and falling, an equaliser. |
44
+ | `pulse` | A ring widening from a dot. Still: a target. |
45
+ | `orbit` | A dot circling a hairline orbit. |
46
+ | `grid` | A 3×3 grid, a wave from the top-left. |
47
+ | `cursor` | A blinking block cursor. Still: a solid block. |
48
+ | `ascii` | `\| / − \` in Licht Mono. Still: `…`. |
49
+ | `brackets` | The logo's brackets opening and closing. Still: the mark. |
50
+ | `crescent` | A moon waxing and waning, tilted 14°. Still: the crescent. |
51
+
52
+ ## When to use
53
+
54
+ - A short wait of unknown length: sending, saving, syncing.
55
+ - `ring` in controls and copy; `dots` where it is too busy. `arc`, `bars`, `pulse`, `orbit`, `grid` in panels and fetching cards.
56
+ - `cursor` and `ascii` beside mono labels: status lines, logs.
57
+ - `brackets` and `crescent` for brand moments (a splash, a first load). One per view.
58
+ - Known progress: `Progress`. Known layout of the coming content: `Skeleton`.
59
+
60
+ ## Examples
61
+
62
+ ### Sizes
63
+
64
+ Every face at `sm`, `default` (the icon size inside buttons) and `lg`.
65
+
66
+ ```tsx
67
+ import { Eyebrow, SPINNER_VARIANTS, Spinner } from "@zonsh/ui";
68
+ import * as React from "react";
69
+
70
+ export function Sizes() {
71
+ return (
72
+ // The size columns give way to the names in a narrow frame.
73
+ <div className="grid grid-cols-[auto_repeat(3,minmax(min-content,4.5rem))] items-center gap-x-2 gap-y-5">
74
+ <span />
75
+ {(["sm", "default", "lg"] as const).map((size) => (
76
+ <Eyebrow key={size} as="span" className="text-center">
77
+ {size}
78
+ </Eyebrow>
79
+ ))}
80
+ {SPINNER_VARIANTS.map((variant) => (
81
+ <React.Fragment key={variant}>
82
+ <Eyebrow as="span" className="pr-4">
83
+ {variant}
84
+ </Eyebrow>
85
+ {(["sm", "default", "lg"] as const).map((size) => (
86
+ <span key={size} className="flex justify-center">
87
+ <Spinner variant={variant} size={size} label={`Loading (${variant}, ${size})`} />
88
+ </span>
89
+ ))}
90
+ </React.Fragment>
91
+ ))}
92
+ </div>
93
+ );
94
+ }
95
+ ```
96
+
97
+ ### In a button
98
+
99
+ Use Button's `loading` first ("Send message"): the ring takes the icon's place or covers the label, the width holds, the button is `aria-busy` and inert. For another face ("Save draft"): hide the label with `invisible`, lay the spinner over it `absolute` in a `relative` button, set `aria-busy` and ignore repeat clicks.
100
+
101
+ ```tsx
102
+ import { Button, Spinner } from "@zonsh/ui";
103
+ import { SendIcon } from "lucide-react";
104
+ import * as React from "react";
105
+
106
+ /** One pending flag per button: each button loads on its own. */
107
+ function usePending(ms = 2000) {
108
+ const [pending, setPending] = React.useState(false);
109
+ const timer = React.useRef<number | undefined>(undefined);
110
+ React.useEffect(() => () => window.clearTimeout(timer.current), []);
111
+ const start = () => {
112
+ if (pending) return;
113
+ setPending(true);
114
+ timer.current = window.setTimeout(() => setPending(false), ms);
115
+ };
116
+ return [pending, start] as const;
117
+ }
118
+
119
+ export function InButton() {
120
+ const [sending, send] = usePending();
121
+ const [saving, save] = usePending();
122
+
123
+ return (
124
+ <div className="flex flex-wrap items-center gap-3">
125
+ <Button onClick={send} loading={sending} loadingLabel="Sending message">
126
+ <SendIcon className="rtl:-scale-x-100" />
127
+ Send message
128
+ </Button>
129
+ <Button variant="secondary" onClick={save} aria-busy={saving} className="relative">
130
+ <span className={saving ? "invisible" : undefined}>Save draft</span>
131
+ {saving && <Spinner variant="dots" label="Saving draft" className="absolute" />}
132
+ </Button>
133
+ </div>
134
+ );
135
+ }
136
+ ```
137
+
138
+ ### Inline status
139
+
140
+ ```tsx
141
+ import { Spinner } from "@zonsh/ui";
142
+
143
+ export function Inline() {
144
+ return (
145
+ <div className="flex flex-col gap-3">
146
+ <p className="m-0 flex items-center gap-2 font-mono text-xs text-muted-foreground">
147
+ <Spinner variant="ascii" size="sm" label="Syncing" />
148
+ Syncing photos from your phone
149
+ </p>
150
+ <p className="m-0 flex items-center gap-2 font-mono text-xs text-muted-foreground">
151
+ <Spinner variant="cursor" size="sm" label="Running build" />
152
+ Building the site
153
+ </p>
154
+ <p className="m-0 flex items-center gap-2 text-sm text-muted-foreground">
155
+ <Spinner variant="arc" size="sm" label="Checking availability" />
156
+ Checking the calendar for a free slot
157
+ </p>
158
+ </div>
159
+ );
160
+ }
161
+ ```
162
+
163
+ ### Scaled up
164
+
165
+ Brand faces for a splash, sized with a class; the drawing scales with the box.
166
+
167
+ ```tsx
168
+ import { Eyebrow, Spinner } from "@zonsh/ui";
169
+
170
+ export function Brand() {
171
+ return (
172
+ <div className="flex flex-wrap items-center gap-16">
173
+ <div className="flex flex-col items-center gap-4">
174
+ <Spinner variant="brackets" size="lg" label="Loading zon" className="size-12" />
175
+ <Eyebrow as="span">brackets</Eyebrow>
176
+ </div>
177
+ <div className="flex flex-col items-center gap-4">
178
+ <Spinner variant="crescent" size="lg" label="Loading" className="size-12" />
179
+ <Eyebrow as="span">crescent</Eyebrow>
180
+ </div>
181
+ </div>
182
+ );
183
+ }
184
+ ```
185
+
186
+ ## Motion
187
+
188
+ - Durations: `ring` 1s, `ascii` 0.52s, `dots` and `bars` 1s, `orbit` and `grid` 1.2s, `arc`, `pulse` and `brackets` 1.6s, `crescent` 2.4s — all looping.
189
+ - `brackets` uses the logo's geometry and `--ease`; each half moves 3/24 of the box outward and back.
190
+ - `crescent` slides a masked shadow along the mark's 14° axis; a hairline keeps the new moon visible. At rest the shadow matches the mark's cut.
191
+ - Keyframes: `styles/parts/feedback.css`. Each part's resting style is its reduced-motion pose, where the spinner fades between 100% and 55% every 0.8s.
192
+
193
+ ## Props
194
+
195
+ | Prop | Type | Default |
196
+ | --------- | ------------------------------------------------------------------------------------------------------------------------ | ----------- |
197
+ | `variant` | `"ring" \| "arc" \| "dots" \| "bars" \| "pulse" \| "orbit" \| "grid" \| "cursor" \| "ascii" \| "brackets" \| "crescent"` | `"ring"` |
198
+ | `size` | `"sm" \| "default" \| "lg"` | `"default"` |
199
+ | `label` | `string` — the accessible name | `"Loading"` |
200
+
201
+ Other `<span>` props are forwarded. `SPINNER_VARIANTS` lists every face in gallery order. Data attributes: `data-slot="spinner"`, `data-variant`, `data-size`. Without a `label`, the status reads `messages.spinner.loading`.
202
+
203
+ ## Brand rules
204
+
205
+ - **Do** keep the spinner in the current ink; never colour it.
206
+ - **Do** keep a button's width while it shows a spinner.
207
+ - **Do** pick one face per product surface; mixed faces on one screen read as noise.
208
+ - **Don't** use braille or box-drawing frames for ASCII: they are not in the Licht Mono subset and fall back to another face.
209
+ - **Don't** put a spinner over a whole page; show skeletons for the content.
210
+ - **Don't** use `brackets` as the logo. The logo is `Logo` / `LogoMark`.
211
+ - **Don't** add a second motion (pulse, glow) alongside it.
212
+
213
+ ## Accessibility
214
+
215
+ - `role="status"` with `aria-label` from `label`. Say what is loading: "Sending message", not "Loading".
216
+ - Remove it when the work ends and confirm the result in text (a toast, the updated content).
217
+ - The drawing is `aria-hidden`. Under reduced motion every face stands still and only its opacity breathes.
218
+
219
+ ---
220
+
221
+ - Import: `import { Spinner } from "@zonsh/ui"`
222
+ - Source: `packages/ui/src/components/spinner.tsx`
@@ -0,0 +1,267 @@
1
+ # Stat
2
+
3
+ ```tsx
4
+ import { Stat } from "@zonsh/ui";
5
+
6
+ /* Figures for a fictional open-source library, fixed so every render is the same. */
7
+ const downloads = [812, 840, 795, 901, 978, 1012, 960, 1104, 1180, 1132, 1210, 1284];
8
+
9
+ export function Basic() {
10
+ return (
11
+ <div className="w-full max-w-xs">
12
+ <Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
13
+ </div>
14
+ );
15
+ }
16
+ ```
17
+
18
+ A product figure as type: an eyebrow label, the value in Licht Mono 24px tabular, a hairline above, no box. Optionally the change ("↗ 12.4%" and what against), a line on what it covers, and an SVG sparkline. The change is green the better way and red the worse, by `better`.
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ import { Stat, StatGroup } from "@zonsh/ui";
24
+
25
+ <StatGroup>
26
+ <Stat label="Orders" value={1284} change={0.124} changeLabel="vs. last week" series={ordersByDay} />
27
+ <Stat label="Build time" value="42 s" change={-0.087} better="down" />
28
+ </StatGroup>;
29
+ ```
30
+
31
+ - `value` — a number is formatted for the locale (`format`); text is shown as is, so keep the unit in it: "42 s".
32
+ - `change` — signed fraction: `0.12` is a rise of 12%.
33
+ - `better` — `up` (orders), `down` (build times, refunds) or `neither` (only news).
34
+
35
+ ## When to use
36
+
37
+ - A few figures atop a dashboard or report (`StatGroup`), or one beside a chart. `Sparkline` alone for a trend in a row.
38
+ - Editorial facts on a marketing page are a large Licht numeral (Brand: Numbers); a figure in a sentence stays there.
39
+
40
+ ## Examples
41
+
42
+ ### A row
43
+
44
+ A `<dl>` grid of as many 10rem columns as fit; or set `grid-cols-2 @3xl:grid-cols-4` in a size container.
45
+
46
+ ```tsx
47
+ import { Stat, StatGroup } from "@zonsh/ui";
48
+
49
+ // downloads: as in the first example on this page that uses them.
50
+
51
+ const buildSeconds = [58, 55, 57, 52, 50, 51, 47, 46, 44, 45, 43, 42];
52
+
53
+ const issues = [21, 22, 20, 23, 19, 18, 18, 20, 17, 16, 18, 17];
54
+
55
+ const bundleKb = [41.2, 41.2, 41.6, 41.6, 41.9, 42.0, 42.0, 42.3, 42.3, 42.4, 42.4, 42.5];
56
+
57
+ export function Group() {
58
+ return (
59
+ <StatGroup className="w-full max-w-4xl">
60
+ <Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
61
+ <Stat
62
+ label="Build time"
63
+ value="42 s"
64
+ change={-0.087}
65
+ better="down"
66
+ changeLabel="vs. last week"
67
+ series={buildSeconds}
68
+ />
69
+ <Stat label="Open issues" value={17} change={-0.056} better="down" series={issues} />
70
+ <Stat
71
+ label="Bundle size"
72
+ value="42.5 kB"
73
+ change={0.0072}
74
+ better="down"
75
+ changeLabel="gzip"
76
+ series={bundleKb}
77
+ />
78
+ </StatGroup>
79
+ );
80
+ }
81
+ ```
82
+
83
+ ### Which way is better
84
+
85
+ `better="down"` turns a fall green; `"neither"` keeps soft ink. Zero shows a dash and "No change".
86
+
87
+ ```tsx
88
+ import { Stat, StatGroup } from "@zonsh/ui";
89
+
90
+ export function Direction() {
91
+ return (
92
+ <StatGroup className="w-full max-w-3xl">
93
+ <Stat label="Sign-ups" value={312} change={0.08} changeLabel="vs. last month" />
94
+ <Stat
95
+ label="Median page load"
96
+ value="1.4 s"
97
+ change={-0.12}
98
+ better="down"
99
+ changeLabel="vs. last month"
100
+ />
101
+ <Stat label="Refunds" value={9} change={0.5} better="down" changeLabel="up from 6" />
102
+ <Stat
103
+ label="Team members"
104
+ value={14}
105
+ change={2}
106
+ changeFormat={{ style: "decimal" }}
107
+ better="neither"
108
+ changeLabel="joined this month"
109
+ />
110
+ </StatGroup>
111
+ );
112
+ }
113
+ ```
114
+
115
+ ### Description and format
116
+
117
+ ```tsx
118
+ import { Stat, StatGroup } from "@zonsh/ui";
119
+
120
+ export function Description() {
121
+ return (
122
+ <StatGroup className="w-full max-w-2xl">
123
+ <Stat label="Lessons finished" value="18 of 24" description="Web typography, autumn term" />
124
+ <Stat
125
+ label="Takings"
126
+ value={4820.5}
127
+ format={{ style: "currency", currency: "EUR" }}
128
+ description="September 2026, before fees"
129
+ />
130
+ </StatGroup>
131
+ );
132
+ }
133
+ ```
134
+
135
+ ### Sizes
136
+
137
+ `sm` 20px, `default` 24px, `lg` 30px.
138
+
139
+ ```tsx
140
+ import { Stat, StatGroup } from "@zonsh/ui";
141
+
142
+ export function Sizes() {
143
+ return (
144
+ <StatGroup className="w-full max-w-2xl">
145
+ <Stat size="sm" label="Small" value="1,284" />
146
+ <Stat label="Default" value="1,284" />
147
+ <Stat size="lg" label="Large" value="1,284" />
148
+ </StatGroup>
149
+ );
150
+ }
151
+ ```
152
+
153
+ ### Loading and no data
154
+
155
+ `loading` puts placeholders under the label and sets `aria-busy`; load figures one by one. Unmeasured is `value={null}`: "—", read "No data", with a `description` saying why. Never 0.
156
+
157
+ ```tsx
158
+ import { Stat, StatGroup } from "@zonsh/ui";
159
+
160
+ // downloads: as in the first example on this page that uses them.
161
+
162
+ /** One figure still loading, one with nothing to show for the period, beside one that is in. */
163
+ export function States() {
164
+ return (
165
+ <StatGroup className="w-full max-w-3xl">
166
+ <Stat label="Downloads" value={1284} change={0.124} changeLabel="vs. last week" series={downloads} />
167
+ <Stat label="Stars" value={null} loading changeLabel="vs. last week" />
168
+ <Stat
169
+ label="Sponsors"
170
+ value={null}
171
+ description="No sponsors yet. They show here once someone sponsors the project."
172
+ />
173
+ </StatGroup>
174
+ );
175
+ }
176
+ ```
177
+
178
+ ### Sparkline on its own
179
+
180
+ `data` oldest first; it fills its box (36px tall by default). `area={false}` draws only the line; `baseline="zero"` starts at zero.
181
+
182
+ ```tsx
183
+ import { Sparkline } from "@zonsh/ui";
184
+
185
+ // downloads: as in the first example on this page that uses them.
186
+
187
+ const packages = [
188
+ { name: "core", downloads: [210, 230, 228, 251, 266, 290, 301] },
189
+ { name: "cli", downloads: [88, 84, 90, 79, 76, 81, 72] },
190
+ { name: "plugins", downloads: [40, 41, 39, 52, 61, 58, 66] },
191
+ ];
192
+
193
+ export function SparklineOnItsOwn() {
194
+ return (
195
+ <ul className="m-0 flex w-full max-w-sm list-none flex-col p-0">
196
+ {packages.map((pkg) => (
197
+ <li
198
+ key={pkg.name}
199
+ className="grid grid-cols-[1fr_6rem_3rem] items-center gap-4 border-t border-border/60 py-2 last:border-b"
200
+ >
201
+ <span className="font-mono text-sm text-foreground">{pkg.name}</span>
202
+ <Sparkline data={pkg.downloads} className="h-6" />
203
+ <span className="text-end font-mono text-xs text-muted-foreground tabular-nums">
204
+ {pkg.downloads.at(-1)}
205
+ </span>
206
+ </li>
207
+ ))}
208
+ </ul>
209
+ );
210
+ }
211
+ ```
212
+
213
+ ## Props
214
+
215
+ ### Stat
216
+
217
+ | Prop | Type | Default |
218
+ | -------------- | --------------------------------------------------------------- | -------------------------- |
219
+ | `label` | `ReactNode` — the eyebrow | required |
220
+ | `value` | `ReactNode`; a number is formatted for the locale | required |
221
+ | `loading` | `boolean` — placeholders, `aria-busy` | `false` |
222
+ | `format` | `Intl.NumberFormatOptions` for a number value | — |
223
+ | `roll` | `boolean` — a number's digits roll as it changes (`NumberRoll`) | `false` |
224
+ | `change` | `number`, signed: `0.12` is a rise of 12% | — |
225
+ | `changeFormat` | `Intl.NumberFormatOptions` | percent, up to one decimal |
226
+ | `changeLabel` | `ReactNode` — what the change is against | — |
227
+ | `better` | `"up" \| "down" \| "neither"` | `"up"` |
228
+ | `description` | `ReactNode` | — |
229
+ | `series` | `number[]` — drawn as a `Sparkline` | — |
230
+ | `size` | `"sm" \| "default" \| "lg"` | `"default"` |
231
+ | `labels` | `Partial<StatMessages>` | English |
232
+
233
+ Other `<div>` props go to the root. Data attributes: `data-size`, `data-loading`; `data-empty` on `stat-value` with no value; on `stat-change`, `data-direction` (`up`, `down`, `flat`) and `data-tone` (`positive`, `negative`, `neutral`).
234
+
235
+ ### Sparkline
236
+
237
+ | Prop | Type | Default |
238
+ | ------------- | ------------------ | ---------------- |
239
+ | `data` | `number[]` | required |
240
+ | `area` | `boolean` | `true` |
241
+ | `color` | CSS colour | `var(--chart-1)` |
242
+ | `baseline` | `"data" \| "zero"` | `"data"` |
243
+ | `strokeWidth` | `number` (px) | `1.25` |
244
+
245
+ Other `<svg>` props are forwarded; give it `aria-label` to make it an image people hear.
246
+
247
+ ## Brand rules
248
+
249
+ - **Do** show a few figures that answer a real question, and say their period ("last 14 days").
250
+ - **Do** keep the value monochrome; size, never bold, makes it the thing to read.
251
+ - **Do** set `better` for every change shown, and `neither` when the direction is only news.
252
+ - **Don't** invent figures, changes or trends to fill a row.
253
+ - **Don't** colour the value, label or sparkline. Colour is on the change alone, with its arrow and amount.
254
+ - **Don't** put a stat in a card. A hairline and whitespace group a row of figures.
255
+
256
+ ## Accessibility
257
+
258
+ - A Stat is a description list (`<dl>`, or a `<div>` inside a `StatGroup`'s `<dl>`), so each value is read with its label.
259
+ - The change is read as words — "Up 12.4%", "Down 8.7%", "No change" — and the arrow is hidden; colour is never the only signal.
260
+ - The sparkline is hidden; when the days matter, add a `Chart` people can step through.
261
+ - A loading Stat is `aria-busy` and reads "Loading"; `null` reads "No data", not a dash.
262
+ - Interface text comes from a `LocaleProvider` (`messages.stat`) or `labels`; numbers are formatted for its locale.
263
+
264
+ ---
265
+
266
+ - Import: `import { Stat, StatGroup, Sparkline } from "@zonsh/ui"`
267
+ - Source: `packages/ui/src/components/stat.tsx`