@zonsh/ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +643 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,417 @@
1
+ # Chat
2
+
3
+ ```tsx
4
+ import { Button, Conversation, ConversationContent, ConversationScrollButton, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger, Message, MessageAction, MessageActions, MessageContent, MessageText, PromptInput, PromptInputAttachButton, PromptInputAttachment, PromptInputHeader, PromptInputSubmit, PromptInputTextarea, PromptInputToolbar, PromptInputTools, Reasoning, ReasoningContent, ReasoningTrigger, Response, Separator, Sidebar, SidebarContent, SidebarGroup, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarItem, SidebarProvider, SidebarRail, SidebarTrigger, Source, Sources, SourcesContent, SourcesTrigger, Suggestion, Suggestions, ToolCall, ToolCallInput, ToolCallOutput, type PromptInputStatus } from "@zonsh/ui";
5
+ import { EllipsisIcon, PencilIcon, RotateCcwIcon, SquarePenIcon, TrainFrontIcon, Trash2Icon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ interface AssistantTurn {
9
+ id: number;
10
+ from: "assistant";
11
+ text: string;
12
+ streaming?: boolean;
13
+ reasoning?: { text: string; duration?: number; streaming?: boolean };
14
+ tool?: boolean;
15
+ sources?: { href: string; title: string }[];
16
+ }
17
+
18
+ type Turn = { id: number; from: "user"; text: string; files?: File[] } | AssistantTurn;
19
+
20
+ const opening: Turn[] = [
21
+ { id: 1, from: "user", text: "Which trains get me from Berlin to Copenhagen on Friday afternoon?" },
22
+ {
23
+ id: 2,
24
+ from: "assistant",
25
+ reasoning: {
26
+ duration: 3,
27
+ text: "Friday is 9 October. Three trains leave Berlin after noon. Two are direct; the 14:37 has no second-class seats left. The last one needs a change in Hamburg and arrives late.",
28
+ },
29
+ tool: true,
30
+ text: "Three trains leave after noon:\n\n| Leaves | Arrives | Route | Seats |\n| --- | --- | --- | --- |\n| 12:37 | 19:24 | Direct | Both classes |\n| 14:37 | 21:24 | Direct | First class only |\n| 16:37 | 23:41 | Change in Hamburg | Both classes |\n\nThe **12:37** is the easiest: no change, and seats left in both classes.",
31
+ sources: [
32
+ {
33
+ href: "https://example.com/timetables/berlin-copenhagen",
34
+ title: "Berlin – Copenhagen timetable",
35
+ },
36
+ ],
37
+ },
38
+ ];
39
+
40
+ const cannedReply =
41
+ "This reply is canned — the docs don't call a model. It arrives in uneven bursts, the way a model API sends it, and is written out evenly anyway, a word at a time, each word coming into focus. The **stop** button in the prompt bar ends it, and the conversation glides along with the text until you scroll up.\n\nScroll up while it writes and a button appears to bring you back to the latest message.";
42
+
43
+ /* Uneven bursts — characters, and the wait before each — the way a model API delivers a reply. */
44
+ const bursts = [
45
+ [24, 120],
46
+ [70, 260],
47
+ [16, 90],
48
+ [118, 380],
49
+ [38, 140],
50
+ [92, 300],
51
+ [12, 70],
52
+ [64, 220],
53
+ ] as const;
54
+
55
+ const followUps = ["Hold a window seat on the 12:37", "What about coming back on Sunday?"];
56
+
57
+ /** Earlier conversations in the sidebar, newest first; only the open one has turns in this demo. */
58
+ const history = [
59
+ {
60
+ label: "Today",
61
+ items: [
62
+ { id: "trip", title: "Berlin to Copenhagen by train" },
63
+ { id: "packing", title: "Packing for four days" },
64
+ ],
65
+ },
66
+ {
67
+ label: "Previous 7 days",
68
+ items: [
69
+ { id: "hotels", title: "Hotels near København H" },
70
+ { id: "bikes", title: "Renting a bike in Copenhagen" },
71
+ { id: "kroner", title: "Euros to kroner, roughly" },
72
+ ],
73
+ },
74
+ {
75
+ label: "September",
76
+ items: [
77
+ { id: "night-trains", title: "Night trains to Stockholm" },
78
+ { id: "rail-pass", title: "Is a rail pass worth it?" },
79
+ ],
80
+ },
81
+ ];
82
+
83
+ export function Chat() {
84
+ const [turns, setTurns] = React.useState<Turn[]>(opening);
85
+ const [status, setStatus] = React.useState<PromptInputStatus>("ready");
86
+ const [files, setFiles] = React.useState<File[]>([]);
87
+ const attach = (list: File[]) => setFiles((current) => [...current, ...list]);
88
+ const timers = React.useRef<ReturnType<typeof setTimeout>[]>([]);
89
+ const nextId = React.useRef(3);
90
+ React.useEffect(() => () => timers.current.forEach(clearTimeout), []);
91
+
92
+ const updateLast = (patch: (turn: AssistantTurn) => AssistantTurn) =>
93
+ setTurns((list) => {
94
+ const last = list.at(-1);
95
+ return last?.from === "assistant" ? [...list.slice(0, -1), patch(last)] : list;
96
+ });
97
+
98
+ const later = (ms: number, fn: () => void) => timers.current.push(setTimeout(fn, ms));
99
+
100
+ const send = (text: string) => {
101
+ const attached = files;
102
+ setFiles([]);
103
+ setTurns((list) => [...list, { id: nextId.current++, from: "user", text, files: attached }]);
104
+ setStatus("submitted");
105
+ later(500, () => {
106
+ setTurns((list) => [
107
+ ...list,
108
+ {
109
+ id: nextId.current++,
110
+ from: "assistant",
111
+ text: "",
112
+ streaming: true,
113
+ reasoning: { streaming: true, text: "A simple question, so a simple answer: no tools needed." },
114
+ },
115
+ ]);
116
+ setStatus("streaming");
117
+ });
118
+ later(1700, () =>
119
+ updateLast((t) => ({ ...t, reasoning: { ...t.reasoning!, streaming: false, duration: 1 } })),
120
+ );
121
+ let at = 1800;
122
+ let length = 0;
123
+ for (let i = 0; length < cannedReply.length; i++) {
124
+ const [size, wait] = bursts[i % bursts.length]!;
125
+ at += wait;
126
+ length = Math.min(cannedReply.length, length + size);
127
+ const upTo = length;
128
+ later(at, () => updateLast((t) => ({ ...t, text: cannedReply.slice(0, upTo) })));
129
+ }
130
+ later(at + 60, () => {
131
+ updateLast((t) => ({ ...t, streaming: false }));
132
+ setStatus("ready");
133
+ });
134
+ };
135
+
136
+ const stop = () => {
137
+ timers.current.forEach(clearTimeout);
138
+ timers.current = [];
139
+ updateLast((t) => ({
140
+ ...t,
141
+ streaming: false,
142
+ reasoning: t.reasoning && { ...t.reasoning, streaming: false, duration: t.reasoning.duration ?? 1 },
143
+ }));
144
+ setStatus("ready");
145
+ };
146
+
147
+ return (
148
+ <SidebarProvider
149
+ collapsible="offcanvas"
150
+ storageKey={null}
151
+ keyboardShortcut={false}
152
+ className="h-[44rem] min-h-0 w-full overflow-hidden surface-container"
153
+ >
154
+ <Sidebar aria-label="Conversations">
155
+ <SidebarHeader>
156
+ <Button variant="secondary" className="w-full justify-start">
157
+ <SquarePenIcon aria-hidden />
158
+ New chat
159
+ </Button>
160
+ </SidebarHeader>
161
+ <SidebarContent>
162
+ {history.map((group) => (
163
+ <SidebarGroup key={group.label}>
164
+ <SidebarGroupLabel>{group.label}</SidebarGroupLabel>
165
+ {group.items.map((item) => (
166
+ <SidebarItem
167
+ key={item.id}
168
+ href={`#${item.id}`}
169
+ current={item.id === "trip"}
170
+ onClick={(event) => event.preventDefault()}
171
+ >
172
+ {/* Cut short in the rail: the whole title on hover. */}
173
+ <span className="truncate" title={item.title}>
174
+ {item.title}
175
+ </span>
176
+ </SidebarItem>
177
+ ))}
178
+ </SidebarGroup>
179
+ ))}
180
+ </SidebarContent>
181
+ <SidebarRail />
182
+ </Sidebar>
183
+
184
+ <SidebarInset className="min-h-0 overflow-hidden">
185
+ <header className="flex shrink-0 items-center gap-3 border-b border-border/60 py-2 ps-2 pe-3">
186
+ <SidebarTrigger variant="bare" />
187
+ <Separator orientation="vertical" className="my-auto h-4 min-h-0 self-center" />
188
+ <h2 className="m-0 min-w-0 flex-1 truncate font-body text-sm font-medium">
189
+ Berlin to Copenhagen by train
190
+ </h2>
191
+ <Menu>
192
+ <MenuTrigger render={<Button variant="ghost" size="icon-sm" aria-label="Conversation actions" />}>
193
+ <EllipsisIcon />
194
+ </MenuTrigger>
195
+ <MenuContent align="end">
196
+ <MenuItem>
197
+ <PencilIcon />
198
+ Rename
199
+ </MenuItem>
200
+ <MenuSeparator />
201
+ <MenuItem>
202
+ <Trash2Icon />
203
+ Delete conversation
204
+ </MenuItem>
205
+ </MenuContent>
206
+ </Menu>
207
+ </header>
208
+ <Conversation aria-label="Conversation with the assistant" aria-busy={status !== "ready"}>
209
+ <ConversationContent>
210
+ {turns.map((turn) =>
211
+ turn.from === "user" ? (
212
+ <Message key={turn.id} from="user">
213
+ <MessageContent>
214
+ {turn.files && turn.files.length > 0 && (
215
+ <div className="flex flex-wrap justify-end gap-2">
216
+ {turn.files.map((file, i) => (
217
+ <PromptInputAttachment key={i} file={file} />
218
+ ))}
219
+ </div>
220
+ )}
221
+ {turn.text && <MessageText>{turn.text}</MessageText>}
222
+ </MessageContent>
223
+ </Message>
224
+ ) : (
225
+ <Message key={turn.id} from="assistant">
226
+ <MessageContent>
227
+ {turn.reasoning && (
228
+ <Reasoning streaming={turn.reasoning.streaming} duration={turn.reasoning.duration}>
229
+ <ReasoningTrigger />
230
+ <ReasoningContent>{turn.reasoning.text}</ReasoningContent>
231
+ </Reasoning>
232
+ )}
233
+ {turn.tool && (
234
+ <ToolCall name="search_trains" status="completed" icon={<TrainFrontIcon />}>
235
+ <ToolCallInput
236
+ input={{
237
+ from: "Berlin Hbf",
238
+ to: "København H",
239
+ date: "2026-10-09",
240
+ departAfter: "12:00",
241
+ }}
242
+ />
243
+ <ToolCallOutput
244
+ output={[
245
+ "12:37 → 19:24 direct",
246
+ "14:37 → 21:24 direct, 2nd class full",
247
+ "16:37 → 23:41 via Hamburg",
248
+ ]}
249
+ />
250
+ </ToolCall>
251
+ )}
252
+ {(turn.text || !turn.streaming) && (
253
+ <Response streaming={turn.streaming}>{turn.text}</Response>
254
+ )}
255
+ {turn.sources && (
256
+ <Sources>
257
+ <SourcesTrigger count={turn.sources.length} />
258
+ <SourcesContent>
259
+ {turn.sources.map((s) => (
260
+ <Source key={s.href} href={s.href} title={s.title} />
261
+ ))}
262
+ </SourcesContent>
263
+ </Sources>
264
+ )}
265
+ {!turn.streaming && (
266
+ <MessageActions>
267
+ <MessageAction label="Copy" copy={turn.text} />
268
+ <MessageAction
269
+ label="Try again"
270
+ disabled={status !== "ready"}
271
+ onClick={() => send("Try that again")}
272
+ >
273
+ <RotateCcwIcon />
274
+ </MessageAction>
275
+ </MessageActions>
276
+ )}
277
+ </MessageContent>
278
+ </Message>
279
+ ),
280
+ )}
281
+ </ConversationContent>
282
+ <ConversationScrollButton />
283
+ </Conversation>
284
+ {/* Clear of the home indicator when the chat fills a phone's screen. */}
285
+ <div className="mx-auto flex w-full max-w-3xl flex-col gap-3 px-4 pt-2 pb-[calc(1rem+env(safe-area-inset-bottom))]">
286
+ {/* Always mounted, so the bar under the conversation keeps its height and the stuck log
287
+ does not jump twice per reply: while a reply runs the row fades out and is inert. */}
288
+ <Suggestions
289
+ inert={status !== "ready"}
290
+ className={`transition-opacity duration-(--duration-fade) ease-(--ease) ${status === "ready" ? "" : "opacity-0"}`}
291
+ >
292
+ {followUps.map((prompt) => (
293
+ <Suggestion key={prompt} suggestion={prompt} onClick={send} />
294
+ ))}
295
+ </Suggestions>
296
+ <PromptInput
297
+ status={status}
298
+ onSubmit={send}
299
+ onStop={stop}
300
+ onFiles={attach}
301
+ allowEmpty={files.length > 0}
302
+ aria-label="Ask the assistant"
303
+ >
304
+ {files.length > 0 && (
305
+ <PromptInputHeader>
306
+ {files.map((file, i) => (
307
+ <PromptInputAttachment
308
+ key={`${file.name}-${i}`}
309
+ file={file}
310
+ onRemove={() => setFiles((current) => current.filter((f) => f !== file))}
311
+ />
312
+ ))}
313
+ </PromptInputHeader>
314
+ )}
315
+ <PromptInputTextarea placeholder="Ask about your trip" />
316
+ <PromptInputToolbar>
317
+ <PromptInputTools>
318
+ <PromptInputAttachButton onFiles={attach} accept="image/*,.pdf" />
319
+ </PromptInputTools>
320
+ <PromptInputSubmit />
321
+ </PromptInputToolbar>
322
+ </PromptInput>
323
+ </div>
324
+ </SidebarInset>
325
+ </SidebarProvider>
326
+ );
327
+ }
328
+ ```
329
+
330
+ An AI chat built from the AI components in the sidebar shell: past conversations by day, the open one's name and menu in the header. Send a message (the reply is canned) to see it stream.
331
+
332
+ ## Usage
333
+
334
+ ```tsx
335
+ import {
336
+ Conversation,
337
+ ConversationContent,
338
+ ConversationScrollButton,
339
+ Message,
340
+ MessageContent,
341
+ MessageText,
342
+ PromptInput,
343
+ PromptInputSubmit,
344
+ PromptInputTextarea,
345
+ PromptInputToolbar,
346
+ Response,
347
+ } from "@zonsh/ui";
348
+
349
+ <div className="flex h-[40rem] flex-col">
350
+ <Conversation aria-label="Conversation with the assistant">
351
+ <ConversationContent>
352
+ {messages.map((m) => (
353
+ <Message key={m.id} from={m.role}>
354
+ <MessageContent>
355
+ {m.role === "user" ? (
356
+ <MessageText>{m.text}</MessageText>
357
+ ) : (
358
+ <Response streaming={m.streaming}>{m.text}</Response>
359
+ )}
360
+ </MessageContent>
361
+ </Message>
362
+ ))}
363
+ </ConversationContent>
364
+ <ConversationScrollButton />
365
+ </Conversation>
366
+ <PromptInput status={status} onSubmit={send} onStop={stop}>
367
+ <PromptInputTextarea />
368
+ <PromptInputToolbar>
369
+ <PromptInputSubmit />
370
+ </PromptInputToolbar>
371
+ </PromptInput>
372
+ </div>;
373
+ ```
374
+
375
+ - `Conversation` — the log that follows the latest message.
376
+ - `Message from` + `Response streaming` — one turn.
377
+ - `PromptInput status` — send becomes stop while replying.
378
+
379
+ Map your SDK's messages and status (`useChat`, a fetch stream) onto `from`, `streaming` and `status`.
380
+
381
+ For a full-page chat, give the column `h-dvh` (not `h-screen`) so it follows a phone's browser bars, and pad the bar with `pb-[calc(1rem+env(safe-area-inset-bottom))]` to clear the home indicator.
382
+
383
+ Keep follow-up `Suggestions` mounted while a reply runs (`inert` and faded): removing and re-adding them changes the height twice per reply, and the log jumps.
384
+
385
+ ## When to use
386
+
387
+ - An assistant in a product: answering, drafting, acting with tools.
388
+ - One generated paragraph: `Response` alone. Search: `Command` or a list.
389
+
390
+ ## The parts
391
+
392
+ | Part | Page | Job |
393
+ | -------------- | ------------ | ---------------------------------------------------------------------- |
394
+ | `Sidebar` | Sidebar | Earlier conversations by day, and New chat; a sheet on phones |
395
+ | `Menu` | Menu | Rename or delete the open conversation |
396
+ | `Conversation` | Conversation | The scrolling log that sticks to the latest message |
397
+ | `Message` | Message | One turn: a user card or a full-width assistant reply, with actions |
398
+ | `Response` | Response | The reply as markdown, streaming, with untrusted input made safe |
399
+ | `Reasoning` | Reasoning | The model's thinking, folded under "Thought for n seconds" |
400
+ | `ToolCall` | Tool Call | A tool the model used: name, status, parameters and result |
401
+ | `Sources` | Sources | The pages an answer cites |
402
+ | `Suggestions` | Suggestions | Prompts to start from or follow up with |
403
+ | `PromptInput` | Prompt Input | The prompt bar: attachments, a growing textarea, tools and send / stop |
404
+
405
+ ## Brand rules
406
+
407
+ - **Do** keep send the one primary; New chat, message actions, tools and suggestions are secondary, ghost or raised.
408
+ - **Do** name conversations by topic in a few words, grouped by day; the open one is the raised row.
409
+ - **Do** say when a reply is generated; never pass canned output off as real.
410
+ - **Don't** put the reply in a bubble. The user's turn is a card; the reply is the page.
411
+ - **Don't** colour turns; colour is for status, like a failed tool call.
412
+
413
+ ## Accessibility
414
+
415
+ - The conversation is a named `log` region; set `aria-busy` while a reply streams so screen readers announce it once complete, not word by word.
416
+ - Every icon button (send, stop, attach, copy, try again) has a name. While a reply is on its way, send is the Stop button or, with nothing to stop, says it is waiting.
417
+ - Under reduced motion the shimmer holds still, the reply appears as it arrives, and the conversation jumps rather than glides.
@@ -0,0 +1,219 @@
1
+ # Checkbox
2
+
3
+ ```tsx
4
+ import { Checkbox, Field, FieldLabel } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field>
9
+ <FieldLabel>
10
+ <Checkbox defaultChecked />
11
+ Send me a copy of this message
12
+ </FieldLabel>
13
+ </Field>
14
+ );
15
+ }
16
+ ```
17
+
18
+ An 18px box with 5px corners, **recessed** like a field until ticked, then filled with `--primary`. The check draws in and runs back out in about 110ms; nothing animates on first render, and under reduced motion only the fill changes.
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ import { Checkbox, Field, FieldLabel } from "@zonsh/ui";
24
+
25
+ <Field name="copy">
26
+ <FieldLabel>
27
+ <Checkbox defaultChecked />
28
+ Send me a copy of this message
29
+ </FieldLabel>
30
+ </Field>;
31
+ ```
32
+
33
+ The props you'll reach for: `checked` / `defaultChecked`, `onCheckedChange`, `value` (in a group). A wrapping `FieldLabel` sets the box beside the text and makes the sentence clickable.
34
+
35
+ ## When to use
36
+
37
+ - Independent on/off choices applied on submit: "Send me a copy of this message".
38
+ - Consent and agreement, always with a visible sentence saying what is agreed to.
39
+ - Several non-exclusive choices: a `CheckboxGroup`, optionally with a parent checkbox that ticks them all.
40
+ - A setting that applies at once is a `Switch`; one choice of several is a `RadioGroup` or `ToggleGroup`.
41
+
42
+ ## Examples
43
+
44
+ ### States
45
+
46
+ Unticked, ticked, indeterminate and disabled.
47
+
48
+ ```tsx
49
+ import { Checkbox, Field, FieldLabel } from "@zonsh/ui";
50
+
51
+ export function States() {
52
+ return (
53
+ <div className="flex flex-col gap-3">
54
+ <Field>
55
+ <FieldLabel>
56
+ <Checkbox />
57
+ Unticked
58
+ </FieldLabel>
59
+ </Field>
60
+ <Field>
61
+ <FieldLabel>
62
+ <Checkbox defaultChecked />
63
+ Ticked
64
+ </FieldLabel>
65
+ </Field>
66
+ <Field>
67
+ <FieldLabel>
68
+ <Checkbox indeterminate />
69
+ Some, not all
70
+ </FieldLabel>
71
+ </Field>
72
+ <Field disabled>
73
+ <FieldLabel>
74
+ <Checkbox />
75
+ Disabled
76
+ </FieldLabel>
77
+ </Field>
78
+ <Field disabled>
79
+ <FieldLabel>
80
+ <Checkbox defaultChecked />
81
+ Disabled and ticked
82
+ </FieldLabel>
83
+ </Field>
84
+ </div>
85
+ );
86
+ }
87
+ ```
88
+
89
+ ### With description
90
+
91
+ Indent descriptions and errors by `pl-7` to line up with the label text, not the box.
92
+
93
+ ```tsx
94
+ import { Checkbox, Field, FieldDescription, FieldLabel } from "@zonsh/ui";
95
+
96
+ export function WithDescription() {
97
+ return (
98
+ <Field className="max-w-md">
99
+ <FieldLabel>
100
+ <Checkbox defaultChecked />
101
+ Weekly reading digest
102
+ </FieldLabel>
103
+ <FieldDescription className="pl-7">
104
+ A short email every Friday with the articles you saved and have not read yet.
105
+ </FieldDescription>
106
+ </Field>
107
+ );
108
+ }
109
+ ```
110
+
111
+ ### Group
112
+
113
+ Control the group, pass every child value to `allValues` and set `parent` on the parent; it goes indeterminate by itself.
114
+
115
+ ```tsx
116
+ import { Checkbox, CheckboxGroup, Field, FieldItem, FieldLabel, Fieldset, FieldsetLegend } from "@zonsh/ui";
117
+ import * as React from "react";
118
+
119
+ const notices = [
120
+ { value: "project-updates", label: "Project updates" },
121
+ { value: "receipts", label: "Receipts" },
122
+ { value: "maintenance", label: "Planned maintenance" },
123
+ ];
124
+
125
+ export function Group() {
126
+ const [value, setValue] = React.useState<string[]>(["project-updates"]);
127
+ return (
128
+ <Field name="notifications">
129
+ <Fieldset
130
+ render={
131
+ <CheckboxGroup value={value} onValueChange={setValue} allValues={notices.map((n) => n.value)} />
132
+ }
133
+ >
134
+ <FieldsetLegend>Email me about</FieldsetLegend>
135
+ <FieldItem>
136
+ <FieldLabel>
137
+ <Checkbox parent />
138
+ Everything below
139
+ </FieldLabel>
140
+ </FieldItem>
141
+ {notices.map((notice) => (
142
+ <FieldItem key={notice.value} className="pl-7">
143
+ <FieldLabel>
144
+ <Checkbox value={notice.value} />
145
+ {notice.label}
146
+ </FieldLabel>
147
+ </FieldItem>
148
+ ))}
149
+ </Fieldset>
150
+ </Field>
151
+ );
152
+ }
153
+ ```
154
+
155
+ ### Invalid
156
+
157
+ A destructive border, a soft 18% ring and a message that says what to do.
158
+
159
+ ```tsx
160
+ import { Checkbox, Field, FieldError, FieldLabel } from "@zonsh/ui";
161
+
162
+ export function Invalid() {
163
+ return (
164
+ <Field invalid className="max-w-md">
165
+ <FieldLabel>
166
+ <Checkbox />I agree that my details are stored to answer this message
167
+ </FieldLabel>
168
+ <FieldError match className="pl-7">
169
+ Tick this box so we can reply to you.
170
+ </FieldError>
171
+ </Field>
172
+ );
173
+ }
174
+ ```
175
+
176
+ ## Props
177
+
178
+ | Prop | Type | Default |
179
+ | ----------------- | ---------------------------------------- | ------- |
180
+ | `checked` | `boolean` | — |
181
+ | `defaultChecked` | `boolean` | `false` |
182
+ | `onCheckedChange` | `(checked: boolean, details) => void` | — |
183
+ | `indeterminate` | `boolean` | `false` |
184
+ | `value` | `string`: identifies it in a group | — |
185
+ | `parent` | `boolean`: controls the group's children | `false` |
186
+ | `required` | `boolean` | `false` |
187
+ | `disabled` | `boolean` | `false` |
188
+
189
+ `CheckboxGroup` takes `value`, `defaultValue`, `onValueChange` (all `string[]`), `allValues` and `disabled`. Other Base UI props are forwarded. Data attributes: `data-checked`, `data-unchecked`, `data-indeterminate`, `data-disabled`, `data-invalid`.
190
+
191
+ ## Brand rules
192
+
193
+ - **Do** write the label as a plain sentence about what ticking it does.
194
+ - **Do** keep the 18px size, whatever the label's size.
195
+ - **Don't** colour the ticked fill. It is the primary material; a status or category colour makes an ordinary choice read as a warning or a label.
196
+ - **Don't** pre-tick consent boxes.
197
+ - **Don't** use red for anything except an invalid state.
198
+
199
+ ## Accessibility
200
+
201
+ - Renders `role="checkbox"` with a hidden native input for forms; `aria-checked="mixed"` when indeterminate.
202
+ - Every checkbox needs a visible label: wrap it in `FieldLabel` or a native `<label>`.
203
+ - The label is the touch target: an 18px box is too small for a finger. Don't leave a checkbox bare in a row people tap.
204
+ - Focus shows a flush 2px `--control-focus` outline.
205
+ - Errors use colour **and** a `FieldError` message.
206
+
207
+ ### Keyboard
208
+
209
+ | Key | What it does |
210
+ | ----- | ----------------------------------------------------------------------------- |
211
+ | Space | Ticks or clears the focused checkbox |
212
+ | Enter | Submits the form it sits in, as a native checkbox does; it never toggles |
213
+ | Tab | Moves to the next checkbox: each one in a `CheckboxGroup` is its own Tab stop |
214
+
215
+ ---
216
+
217
+ - Import: `import { Checkbox, CheckboxGroup } from "@zonsh/ui"`
218
+ - Source: `packages/ui/src/components/checkbox.tsx`
219
+ - Primitive: `@base-ui/react/checkbox` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/checkbox.md`)