@zonsh/ui 0.4.1 → 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 (562) 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 +7 -7
  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/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,115 @@
1
+ # Quote
2
+
3
+ ```tsx
4
+ import { Quote } from "@zonsh/ui";
5
+
6
+ export function Placeholder() {
7
+ return (
8
+ <Quote author="Person's name" byline="Role, Organisation" className="max-w-2xl">
9
+ Quote from a real customer goes here.
10
+ </Quote>
11
+ );
12
+ }
13
+ ```
14
+
15
+ A quote card, shown with the placeholder it carries until a real quote is approved. A quote is an object, so it is a 20px card: Licht at 24–28px under a quiet opening mark, a mono attribution and an optional logo below a hairline.
16
+
17
+ > **Never invent quotes.** No testimonial, name, role or logo that does not exist or is not approved. Until you have one, use clearly placeholder text — "Quote from a real customer goes here." — so nothing fictional ships. A quote the owner gives you, or the page being redesigned already shows, is theirs to publish: keep its words.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Quote } from "@zonsh/ui";
23
+
24
+ <Quote author="Person's name" byline="Role, Organisation">
25
+ Quote from a real customer goes here.
26
+ </Quote>;
27
+ ```
28
+
29
+ The props you'll reach for: `author`, `byline` and `logo`.
30
+
31
+ ## When to use
32
+
33
+ - A real, approved statement from a customer, reader or partner, attributed by name.
34
+ - Not for your own claims dressed as quotes, nor pull quotes from your own copy — use typography.
35
+
36
+ ## Examples
37
+
38
+ ### With logo
39
+
40
+ The organisation's own mark, in one colour so it takes the ink — with their permission.
41
+
42
+ ```tsx
43
+ import { Quote } from "@zonsh/ui";
44
+
45
+ export function WithLogo() {
46
+ return (
47
+ <Quote
48
+ author="Person's name"
49
+ byline="Role, Organisation"
50
+ logo={
51
+ <span className="inline-flex h-6 items-center rounded-item border border-dashed border-field-edge px-2 font-mono text-[10px] tracking-[0.14em] uppercase">
52
+ Their logo
53
+ </span>
54
+ }
55
+ className="max-w-2xl"
56
+ >
57
+ Quote from a real customer goes here. Use their words, with their approval, and nothing else.
58
+ </Quote>
59
+ );
60
+ }
61
+ ```
62
+
63
+ ### Small
64
+
65
+ `size="sm"`: 18–20px text and 24px padding, for two or three quotes side by side or one per `Carousel` slide.
66
+
67
+ ```tsx
68
+ import { Quote } from "@zonsh/ui";
69
+
70
+ export function Small() {
71
+ return (
72
+ <ul className="m-0 grid w-full max-w-4xl list-none gap-4 p-0 md:grid-cols-2">
73
+ {["First", "Second"].map((n) => (
74
+ <li key={n} className="flex">
75
+ <Quote size="sm" author="Person's name" byline="Role, Organisation">
76
+ {n} quote from a real customer goes here, in their words and with their approval.
77
+ </Quote>
78
+ </li>
79
+ ))}
80
+ </ul>
81
+ );
82
+ }
83
+ ```
84
+
85
+ ## Props
86
+
87
+ | Prop | Type | Default |
88
+ | ---------- | ------------------------------------------------ | ------- |
89
+ | `children` | `ReactNode` — the quote; `<p>`s are spaced | — |
90
+ | `author` | `ReactNode` — who said it | — |
91
+ | `byline` | `ReactNode` — role and organisation | — |
92
+ | `logo` | `ReactNode` — a small single-colour logo, 24px tall | — |
93
+ | `cite` | `string` — source URL, set on `<blockquote>` | — |
94
+ | `size` | `"default" \| "sm"` — 24–28px for one quote on its own; 18–20px with 24px padding for quotes side by side or in a carousel | `"default"` |
95
+
96
+ Renders `<figure>`, `<blockquote>`, `<figcaption>`; figure props are forwarded. For a size in between, set it on the text part: `className="[&_[data-slot=quote-text]]:text-[22px]"`.
97
+
98
+ ## Brand rules
99
+
100
+ - **Do** use real words from a real person, approved for publication, with their name.
101
+ - **Do** keep it to one or two sentences.
102
+ - **Don't** invent quotes, names, roles, logos or results, not even as "realistic" demo content.
103
+ - **Don't** add star ratings, colour avatars or extra quotation marks.
104
+ - **Don't** remove the card material or change the 20px radius. It is an object.
105
+
106
+ ## Accessibility
107
+
108
+ - `<blockquote>` in `<figure>` with the attribution in `<figcaption>`.
109
+ - The opening mark is decorative and `aria-hidden`.
110
+ - A logo image needs an `alt` with the organisation's name, or hide it if the byline already names it.
111
+
112
+ ---
113
+
114
+ - Import: `import { Quote } from "@zonsh/ui"`
115
+ - Source: `packages/ui/src/components/quote.tsx`
@@ -0,0 +1,215 @@
1
+ # Radio Group
2
+
3
+ ```tsx
4
+ import { Field, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field name="shipping">
9
+ <Fieldset render={<RadioGroup defaultValue="standard" />}>
10
+ <FieldsetLegend>Shipping method</FieldsetLegend>
11
+ <FieldItem>
12
+ <FieldLabel>
13
+ <Radio value="standard" />
14
+ Standard, 3–5 working days
15
+ </FieldLabel>
16
+ </FieldItem>
17
+ <FieldItem>
18
+ <FieldLabel>
19
+ <Radio value="express" />
20
+ Express, next working day
21
+ </FieldLabel>
22
+ </FieldItem>
23
+ <FieldItem>
24
+ <FieldLabel>
25
+ <Radio value="pickup" />
26
+ Pick up in store
27
+ </FieldLabel>
28
+ </FieldItem>
29
+ </Fieldset>
30
+ </Field>
31
+ );
32
+ }
33
+ ```
34
+
35
+ An 18px round control, recessed until chosen, then `--primary` with a small dot.
36
+
37
+ ## Usage
38
+
39
+ ```tsx
40
+ import { Field, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
41
+
42
+ <Field name="shipping">
43
+ <Fieldset render={<RadioGroup defaultValue="standard" />}>
44
+ <FieldsetLegend>Shipping method</FieldsetLegend>
45
+ <FieldItem>
46
+ <FieldLabel>
47
+ <Radio value="standard" />
48
+ Standard, 3–5 working days
49
+ </FieldLabel>
50
+ </FieldItem>
51
+ <FieldItem>
52
+ <FieldLabel>
53
+ <Radio value="express" />
54
+ Express, next working day
55
+ </FieldLabel>
56
+ </FieldItem>
57
+ </Fieldset>
58
+ </Field>;
59
+ ```
60
+
61
+ The props you'll reach for: `defaultValue` (or `value` / `onValueChange`) on the group, `value` on each `Radio`, and `name` on the `Field`.
62
+
63
+ ## When to use
64
+
65
+ - One of 2–7 options that each need a sentence or description.
66
+ - 2–5 short labels compared side by side: `ToggleGroup`.
67
+ - Long lists: `Select`, or `Combobox` when typing helps.
68
+
69
+ ## Examples
70
+
71
+ ### With descriptions
72
+
73
+ `FieldItem` takes a description per option; indent it `pl-7` to align with the label.
74
+
75
+ ```tsx
76
+ import { Field, FieldDescription, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
77
+
78
+ const options = [
79
+ {
80
+ value: "private",
81
+ label: "Private",
82
+ description: "Only you can see the project and its preview links.",
83
+ },
84
+ {
85
+ value: "team",
86
+ label: "Team",
87
+ description: "Everyone in the workspace can open it; only editors can change it.",
88
+ },
89
+ {
90
+ value: "public",
91
+ label: "Public",
92
+ description: "Anyone with the link can view the deployed site and its source.",
93
+ },
94
+ ];
95
+
96
+ export function WithDescriptions() {
97
+ return (
98
+ <Field name="visibility" className="max-w-md">
99
+ <Fieldset render={<RadioGroup defaultValue="team" />}>
100
+ <FieldsetLegend>Who can see this project?</FieldsetLegend>
101
+ {options.map((option) => (
102
+ <FieldItem key={option.value} className="gap-1">
103
+ <FieldLabel>
104
+ <Radio value={option.value} />
105
+ {option.label}
106
+ </FieldLabel>
107
+ <FieldDescription className="pl-7">{option.description}</FieldDescription>
108
+ </FieldItem>
109
+ ))}
110
+ </Fieldset>
111
+ </Field>
112
+ );
113
+ }
114
+ ```
115
+
116
+ ### States
117
+
118
+ `<FieldItem disabled>` disables one option; say why in its label.
119
+
120
+ ```tsx
121
+ import { Field, FieldError, FieldItem, FieldLabel, Fieldset, FieldsetLegend, Radio, RadioGroup } from "@zonsh/ui";
122
+
123
+ function Disabled() {
124
+ return (
125
+ <Field name="hosting">
126
+ <Fieldset render={<RadioGroup defaultValue="eu" />}>
127
+ <FieldsetLegend>Hosting region</FieldsetLegend>
128
+ <FieldItem>
129
+ <FieldLabel>
130
+ <Radio value="eu" />
131
+ European Union
132
+ </FieldLabel>
133
+ </FieldItem>
134
+ <FieldItem disabled>
135
+ <FieldLabel>
136
+ <Radio value="us" />
137
+ United States (not available for this project)
138
+ </FieldLabel>
139
+ </FieldItem>
140
+ </Fieldset>
141
+ </Field>
142
+ );
143
+ }
144
+
145
+ function Invalid() {
146
+ return (
147
+ <Field name="timeline" invalid>
148
+ <Fieldset render={<RadioGroup />}>
149
+ <FieldsetLegend>When do you need it?</FieldsetLegend>
150
+ <FieldItem>
151
+ <FieldLabel>
152
+ <Radio value="soon" />
153
+ As soon as possible
154
+ </FieldLabel>
155
+ </FieldItem>
156
+ <FieldItem>
157
+ <FieldLabel>
158
+ <Radio value="quarter" />
159
+ Within three months
160
+ </FieldLabel>
161
+ </FieldItem>
162
+ <FieldItem>
163
+ <FieldLabel>
164
+ <Radio value="later" />
165
+ Later this year
166
+ </FieldLabel>
167
+ </FieldItem>
168
+ </Fieldset>
169
+ <FieldError match>Pick the closest option. A rough idea is fine.</FieldError>
170
+ </Field>
171
+ );
172
+ }
173
+
174
+ /** The invalid and disabled states, one under the other. */
175
+ export function States() {
176
+ return (
177
+ <div className="flex w-full max-w-sm flex-col gap-8">
178
+ <Invalid />
179
+ <Disabled />
180
+ </div>
181
+ );
182
+ }
183
+ ```
184
+
185
+ ## Props
186
+
187
+ `RadioGroup`: `value`, `defaultValue`, `onValueChange`, `name`, `required`, `disabled`, `readOnly`. `Radio`: `value` (required), `disabled`, `readOnly`. The group stacks its options with a 12px gap. Other Base UI props are forwarded. Data attributes: `data-checked`, `data-unchecked`, `data-disabled`, `data-invalid`.
188
+
189
+ ## Brand rules
190
+
191
+ - **Do** start with a sensible `defaultValue`, or make the choice `required`.
192
+ - **Do** write parallel options that are easy to scan.
193
+ - **Don't** lay radios out in a row when the labels wrap. Use a column.
194
+ - **Don't** use radios for actions. Choosing one never submits anything.
195
+
196
+ ## Accessibility
197
+
198
+ - The legend names the group (`Fieldset` + `FieldsetLegend`); each option keeps a visible label.
199
+ - The wrapping `FieldLabel` is the touch target: the whole line chooses the option, not just the 18px radio.
200
+ - Errors show a destructive border and ring on each radio, plus a `FieldError` message.
201
+
202
+ ### Keyboard
203
+
204
+ | Key | What it does |
205
+ | ----- | ----------------------------------------------------------------------------------------------------- |
206
+ | Tab | Moves into the group, onto the chosen option (or the first), and out again: the group is one Tab stop |
207
+ | ↓ / → | Moves to the next option and chooses it, looping at the end (← and → swapped right to left) |
208
+ | ↑ / ← | Moves to the previous option and chooses it, looping at the start |
209
+ | Space | Chooses the focused option, when none is chosen yet |
210
+
211
+ ---
212
+
213
+ - Import: `import { RadioGroup, Radio } from "@zonsh/ui"`
214
+ - Source: `packages/ui/src/components/radio-group.tsx`
215
+ - Primitive: `@base-ui/react/radio-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/radio-group.md`)
@@ -0,0 +1,260 @@
1
+ # Rating
2
+
3
+ ```tsx
4
+ import { Field, FieldLabel, Rating } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field name="delivery">
9
+ <FieldLabel>How was the delivery?</FieldLabel>
10
+ <Rating defaultValue={4} />
11
+ </Field>
12
+ );
13
+ }
14
+ ```
15
+
16
+ Stars in the ink — outlines in `--control-muted`, filled in `--foreground`, softer ink under the pointer — in a row as tall as a control (30, 38 or 46px). Underneath is a Base UI radio group, one radio per star (two with `allowHalf`), so keyboard, forms and `Field` work as usual.
17
+
18
+ ## Usage
19
+
20
+ ```tsx
21
+ import { Field, FieldLabel, Rating } from "@zonsh/ui";
22
+
23
+ <Field name="delivery">
24
+ <FieldLabel>How was the delivery?</FieldLabel>
25
+ <Rating defaultValue={4} />
26
+ </Field>;
27
+ ```
28
+
29
+ - `value` / `defaultValue`, `onValueChange` — a number, or `null` for not rated.
30
+ - `readOnly` — a picture of any score.
31
+ - `allowHalf` — half stars.
32
+
33
+ ## When to use
34
+
35
+ - A score given on a feeling: a delivery, a recipe, a support conversation. `readOnly` shows one: an average, a review's score.
36
+ - A precise number is a `NumberField` or `Slider`; a yes/no a `Switch`; named options ("Too easy, Just right") a `RadioGroup` or `ToggleGroup`.
37
+
38
+ ## Examples
39
+
40
+ ### Half stars
41
+
42
+ Each star is two choices; arrows step by a half. On touch a finger can slide along the row and sets the rating where it lifts. A dense (`sm`) rating spaces its stars to 24px targets on touch.
43
+
44
+ ```tsx
45
+ import { Field, FieldLabel, Rating } from "@zonsh/ui";
46
+ import * as React from "react";
47
+
48
+ export function Halves() {
49
+ const [value, setValue] = React.useState<number | null>(3.5);
50
+ return (
51
+ <Field name="difficulty" className="items-start">
52
+ <FieldLabel>How hard was the course?</FieldLabel>
53
+ <div className="flex items-center gap-3">
54
+ <Rating allowHalf value={value} onValueChange={setValue} />
55
+ <span className="font-mono text-xs text-muted-foreground tabular-nums">
56
+ {value == null ? "Not rated" : `${value} / 5`}
57
+ </span>
58
+ </div>
59
+ </Field>
60
+ );
61
+ }
62
+ ```
63
+
64
+ ### Clearable
65
+
66
+ Picking the current rating again clears it, as do Backspace and Delete.
67
+
68
+ ```tsx
69
+ import { Field, FieldDescription, FieldLabel, Rating } from "@zonsh/ui";
70
+ import * as React from "react";
71
+
72
+ export function Clearable() {
73
+ const [value, setValue] = React.useState<number | null>(2);
74
+ return (
75
+ <Field name="recipe" className="items-start">
76
+ <FieldLabel>Rate this recipe</FieldLabel>
77
+ <Rating clearable value={value} onValueChange={setValue} />
78
+ <FieldDescription>
79
+ {value == null ? "No rating yet." : "Pick the same star again, or press Backspace, to clear it."}
80
+ </FieldDescription>
81
+ </Field>
82
+ );
83
+ }
84
+ ```
85
+
86
+ ### Read-only
87
+
88
+ Any score — 3.7 fills most of the fourth star — read out as "3.7 out of 5". Put the review count beside an average.
89
+
90
+ ```tsx
91
+ import { Rating } from "@zonsh/ui";
92
+
93
+ const reviews = [
94
+ { title: "Ceramic mug", rating: 4.5, count: 38 },
95
+ { title: "Linen tote bag", rating: 3.7, count: 12 },
96
+ { title: "Desk lamp", rating: 5, count: 1 },
97
+ ];
98
+
99
+ export function ReadOnly() {
100
+ return (
101
+ <ul className="m-0 flex w-full max-w-sm list-none flex-col p-0">
102
+ {reviews.map((product) => (
103
+ <li
104
+ key={product.title}
105
+ className="flex items-center justify-between gap-4 border-t border-border/60 py-2 last:border-b"
106
+ >
107
+ <span className="text-sm text-foreground">{product.title}</span>
108
+ <span className="flex items-center gap-2">
109
+ <Rating readOnly size="sm" value={product.rating} />
110
+ <span className="font-mono text-xs text-muted-foreground tabular-nums">
111
+ {product.rating} · {product.count} {product.count === 1 ? "review" : "reviews"}
112
+ </span>
113
+ </span>
114
+ </li>
115
+ ))}
116
+ </ul>
117
+ );
118
+ }
119
+ ```
120
+
121
+ ### Sizes
122
+
123
+ `sm` 30px / 16px stars, `default` 38px / 20px, `lg` 46px / 24px.
124
+
125
+ ```tsx
126
+ import { Rating } from "@zonsh/ui";
127
+
128
+ export function Sizes() {
129
+ return (
130
+ <div className="flex flex-col items-start gap-4">
131
+ <Rating size="sm" defaultValue={3} aria-label="Small" />
132
+ <Rating defaultValue={3} aria-label="Default" />
133
+ <Rating size="lg" defaultValue={3} aria-label="Large" />
134
+ </div>
135
+ );
136
+ }
137
+ ```
138
+
139
+ ### In a form
140
+
141
+ It submits its number under the `Field`'s name; `required` blocks an empty submit, turning the empty stars red with a `FieldError`. Reset restores it.
142
+
143
+ ```tsx
144
+ import { Button, Field, FieldError, FieldLabel, Form, FormActions, Rating, Textarea } from "@zonsh/ui";
145
+ import * as React from "react";
146
+
147
+ export function InForm() {
148
+ const [sent, setSent] = React.useState<string | null>(null);
149
+ return (
150
+ <Form
151
+ className="w-full max-w-md"
152
+ onFormSubmit={(values) => setSent(`${values.stars} out of 5`)}
153
+ onReset={() => setSent(null)}
154
+ >
155
+ <Field name="stars">
156
+ <FieldLabel>Your rating</FieldLabel>
157
+ <Rating required />
158
+ <FieldError match="valueMissing">Pick from one to five stars.</FieldError>
159
+ </Field>
160
+ <Field name="review">
161
+ <FieldLabel>What stood out?</FieldLabel>
162
+ <Textarea placeholder="The handle stays cool, the glaze has a small chip on the rim…" />
163
+ </Field>
164
+ <FormActions align="between">
165
+ <Button type="reset" variant="ghost">
166
+ Clear
167
+ </Button>
168
+ <Button type="submit">Post review</Button>
169
+ </FormActions>
170
+ {sent && (
171
+ <p role="status" className="m-0 text-sm text-foreground-soft">
172
+ Posted: {sent}.
173
+ </p>
174
+ )}
175
+ </Form>
176
+ );
177
+ }
178
+ ```
179
+
180
+ ### Another icon
181
+
182
+ `icon` takes any lucide icon; change `labels.item` to match.
183
+
184
+ ```tsx
185
+ import { Field, FieldLabel, Rating } from "@zonsh/ui";
186
+ import { HeartIcon } from "lucide-react";
187
+
188
+ export function Icon() {
189
+ return (
190
+ <Field name="favourite">
191
+ <FieldLabel>How much did you enjoy the walk?</FieldLabel>
192
+ <Rating max={3} defaultValue={2} icon={<HeartIcon />} labels={{ item: (value) => `${value} of 3` }} />
193
+ </Field>
194
+ );
195
+ }
196
+ ```
197
+
198
+ ### Disabled
199
+
200
+ ```tsx
201
+ import { Field, FieldLabel, Rating } from "@zonsh/ui";
202
+
203
+ export function Disabled() {
204
+ return (
205
+ <Field name="locked" disabled>
206
+ <FieldLabel>Rating (closed after 30 days)</FieldLabel>
207
+ <Rating defaultValue={4} />
208
+ </Field>
209
+ );
210
+ }
211
+ ```
212
+
213
+ ## Props
214
+
215
+ | Prop | Type | Default |
216
+ | -------------------------------------- | ------------------------------------------------------ | -------------- |
217
+ | `value` / `defaultValue` | `number \| null` | — / `null` |
218
+ | `onValueChange` | `(value: number \| null) => void` | — |
219
+ | `max` | `number` — how many stars | `5` |
220
+ | `allowHalf` | `boolean` | `false` |
221
+ | `clearable` | `boolean` | `false` |
222
+ | `readOnly` | `boolean` — a picture of the score | `false` |
223
+ | `size` | `"sm" \| "default" \| "lg"` | `"default"` |
224
+ | `icon` | a lucide icon element | `<StarIcon />` |
225
+ | `name`, `required`, `disabled`, `form` | as on a `RadioGroup`; `name` defaults to the `Field`'s | — |
226
+ | `labels` | `Partial<RatingMessages>` | English |
227
+
228
+ Other `RadioGroup` props are forwarded. Data attributes: `data-size`, and the Field's `data-invalid`, `data-disabled`, `data-touched` … Names ("1 star", "4.5 out of 5", "Not rated") come from `messages.rating` or `labels`, with numbers in the locale.
229
+
230
+ ## Brand rules
231
+
232
+ - **Do** keep the stars in the ink: a rating is a value, not a status. No yellow, no green for five.
233
+ - **Do** label it with the question ("How was the delivery?"), not "Rating".
234
+ - **Do** show the count next to an average.
235
+ - **Don't** invent reviews or averages to fill a product page.
236
+ - **Don't** add a confirm step: picking a star is the answer.
237
+
238
+ ## Accessibility
239
+
240
+ - A `radiogroup` named by the `FieldLabel` (or `aria-label`), with a `radio` per star: "1 star" … "5 stars" ("0.5 stars" … with halves).
241
+ - The focused star has the 2px outline; invalid is red stars plus the `FieldError` text.
242
+ - Read-only, it is one `img` named "4.5 out of 5" or "Not rated", so a product list reads a line each.
243
+
244
+ ### Keyboard
245
+
246
+ | Key | What it does |
247
+ | ------------------ | -------------------------------------------------------------------------------------- |
248
+ | Tab | Moves to the picked star, or the first |
249
+ | ← / → | Lowers or raises the rating and picks it, wrapping at the ends (swapped right to left) |
250
+ | ↑ / ↓ | Raises or lowers the rating: ↑ raises it, ↓ lowers it |
251
+ | Space | Picks the focused star |
252
+ | Backspace / Delete | Clears the rating, when it is `clearable` |
253
+
254
+ With `allowHalf`, each key moves a half. ← and → swap right to left (`dir="rtl"` or a `DirectionProvider`); ↑ and ↓ never do. From no rating, ↑ (or → left to right) picks the lowest and ↓ the highest.
255
+
256
+ ---
257
+
258
+ - Import: `import { Rating } from "@zonsh/ui"`
259
+ - Source: `packages/ui/src/components/rating.tsx`
260
+ - Primitive: `@base-ui/react/radio-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/radio-group.md`)
@@ -0,0 +1,102 @@
1
+ # Reasoning
2
+
3
+ ```tsx
4
+ import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
5
+
6
+ /* Illustrative reasoning, not real data. */
7
+ const thoughts = `The question is what can be cooked tonight with what is in the fridge.
8
+ There are eggs, spinach, feta and half a bag of rice.
9
+ A frittata uses the eggs, spinach and feta, and takes about twenty minutes.
10
+ Fried rice needs soy sauce, which is not on the list — so suggest the frittata first.`;
11
+
12
+ export function Basic() {
13
+ return (
14
+ <div className="w-full max-w-2xl">
15
+ <Reasoning duration={4}>
16
+ <ReasoningTrigger />
17
+ <ReasoningContent>{thoughts}</ReasoningContent>
18
+ </Reasoning>
19
+ </div>
20
+ );
21
+ }
22
+ ```
23
+
24
+ The model's thinking, folded under a mono trigger; open, it is muted text beside a hairline. The answer is the `Response` under it.
25
+
26
+ ## Usage
27
+
28
+ ```tsx
29
+ import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
30
+
31
+ <Reasoning streaming={part.state === "streaming"}>
32
+ <ReasoningTrigger />
33
+ <ReasoningContent>{part.text}</ReasoningContent>
34
+ </Reasoning>;
35
+ ```
36
+
37
+ The props you'll reach for: `streaming`, `duration`, and `open` / `onOpenChange` to control it.
38
+
39
+ ## When to use
40
+
41
+ - Above the reply, for models that expose reasoning. Pass the text, or a `Response` for markdown.
42
+ - Steps taken with tools are `ToolCall`s; reasoning is the thinking between them.
43
+
44
+ ## Examples
45
+
46
+ ### Streaming
47
+
48
+ While `streaming`, "Thinking…" shimmers and the panel opens. When it ends, the label gives the time taken (`duration`, or measured) and a second later the panel folds on the slower glide — unless the reader opened or closed it. This demo keeps thinking.
49
+
50
+ ```tsx
51
+ import { Reasoning, ReasoningContent, ReasoningTrigger } from "@zonsh/ui";
52
+
53
+ // thoughts: as in the first example on this page that uses them.
54
+
55
+ /** Thinking, for as long as the page is open: the finished state is the example above. */
56
+ export function Streaming() {
57
+ return (
58
+ <div className="w-full max-w-2xl">
59
+ <Reasoning streaming>
60
+ <ReasoningTrigger />
61
+ <ReasoningContent>{thoughts}</ReasoningContent>
62
+ </Reasoning>
63
+ </div>
64
+ );
65
+ }
66
+ ```
67
+
68
+ ## Props
69
+
70
+ | Component | Prop | Type | Default |
71
+ | ------------------ | --------------------------------------- | ----------------------------------------- | --------------------------------- |
72
+ | `Reasoning` | `streaming` | `boolean` | `false` |
73
+ | | `duration` | `number` — seconds; measured if not given | — |
74
+ | | `open` / `defaultOpen` / `onOpenChange` | Base UI `Collapsible` props | open while streaming |
75
+ | `ReasoningTrigger` | `children` | replaces the label | Thinking… / Thought for n seconds |
76
+
77
+ Data attributes: `data-streaming` on the root and the label; `data-panel-open` on the trigger.
78
+
79
+ `ReasoningTrigger` takes `labels` (`Partial<ReasoningMessages>`: `thinking`, `thoughtBriefly`, `thoughtFor(seconds)`); a `LocaleProvider` sets them for every trigger (`messages.reasoning`).
80
+
81
+ ## Brand rules
82
+
83
+ - **Do** keep it folded once the answer is there. Readers who want it can open it.
84
+ - **Don't** style the reasoning like the answer. It stays muted and smaller.
85
+ - **Don't** invent a duration. Pass the real one or let it measure.
86
+
87
+ ## Accessibility
88
+
89
+ - The trigger is a button with `aria-expanded`; open, the panel's content stays in the reading order.
90
+ - Under reduced motion the label breathes in opacity instead of shimmering, and the panel opens and closes instantly.
91
+
92
+ ### Keyboard
93
+
94
+ | Key | What it does |
95
+ | ------------- | --------------------------------------------------------------------- |
96
+ | Enter / Space | Opens or closes the reasoning from the trigger |
97
+ | Tab | Moves from the trigger into the open panel; a closed panel is skipped |
98
+
99
+ ---
100
+
101
+ - Import: `import { Reasoning, ReasoningTrigger, ReasoningContent } from "@zonsh/ui"`
102
+ - Source: `packages/ui/src/components/reasoning.tsx`