@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,285 @@
1
+ # Stepper
2
+
3
+ ```tsx
4
+ import { Button, Stepper, type StepperStep } from "@zonsh/ui";
5
+ import { ArrowLeftIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ const checkout: StepperStep[] = [
9
+ { title: "Basket" },
10
+ { title: "Delivery" },
11
+ { title: "Payment" },
12
+ { title: "Review" },
13
+ ];
14
+
15
+ export function Basic() {
16
+ const [step, setStep] = React.useState(1);
17
+ return (
18
+ <div className="flex w-full max-w-2xl flex-col gap-8">
19
+ <Stepper steps={checkout} value={step} aria-label="Checkout" />
20
+ <div className="flex justify-between gap-3">
21
+ <Button variant="ghost" disabled={step === 0} onClick={() => setStep((s) => Math.max(s - 1, 0))}>
22
+ <ArrowLeftIcon className="rtl:-scale-x-100" />
23
+ Back
24
+ </Button>
25
+ <Button
26
+ disabled={step === checkout.length}
27
+ onClick={() => setStep((s) => Math.min(s + 1, checkout.length))}
28
+ >
29
+ {step === checkout.length - 1 ? "Place order" : "Continue"}
30
+ </Button>
31
+ </div>
32
+ </div>
33
+ );
34
+ }
35
+ ```
36
+
37
+ Mono indices on 24px round markers joined by hairlines: upcoming recessed and muted, current raised with the focus-grey edge, finished filled with a check, an error a red "!" with its text. Below about 8rem per step the row becomes the step in mono over a `Progress` track: "02 / 04 · Delivery".
38
+
39
+ ## Usage
40
+
41
+ ```tsx
42
+ import { Stepper } from "@zonsh/ui";
43
+
44
+ const steps = [{ title: "Basket" }, { title: "Delivery" }, { title: "Payment" }, { title: "Review" }];
45
+
46
+ <Stepper steps={steps} value={1} aria-label="Checkout" />;
47
+ ```
48
+
49
+ - `steps` — the steps, each with a `title` (and optional `description`, `error`, `content`).
50
+ - `value` — the current step, from 0; earlier steps are complete, `steps.length` finishes all.
51
+ - `onValueChange` — makes finished steps buttons that go back.
52
+
53
+ ## When to use
54
+
55
+ - Three to six steps done once, in order: checkout, setup, import. `vertical` when each step's form sits under its title; `compact` in a small card or dialog.
56
+ - Not for pages in any order (`Tabs`, `Sidebar`), two steps (one form), or a long form people want whole (sections on one page).
57
+
58
+ ## Examples
59
+
60
+ ### Descriptions
61
+
62
+ A line under each title says what the step asks for.
63
+
64
+ ```tsx
65
+ import { Stepper } from "@zonsh/ui";
66
+
67
+ export function Descriptions() {
68
+ return (
69
+ <div className="w-full max-w-3xl">
70
+ <Stepper
71
+ aria-label="Import a notebook"
72
+ value={2}
73
+ steps={[
74
+ { title: "Choose a file", description: "Markdown, HTML or a .zip export" },
75
+ { title: "Map the folders", description: "Pick where each section goes" },
76
+ { title: "Check the links", description: "Fix the ones that point nowhere" },
77
+ { title: "Import", description: "Takes about a minute per thousand pages" },
78
+ ]}
79
+ />
80
+ </div>
81
+ );
82
+ }
83
+ ```
84
+
85
+ ### Vertical
86
+
87
+ The current step's `content` shows under it; each Continue moves on.
88
+
89
+ ```tsx
90
+ import { Button, Stepper, type StepperStep } from "@zonsh/ui";
91
+ import * as React from "react";
92
+
93
+ const course: StepperStep[] = [
94
+ { title: "Your details", description: "Name and email for the certificate" },
95
+ { title: "Pick a cohort", description: "Starts on the first Monday of each month" },
96
+ { title: "Prepare", description: "Install the tools before the first session" },
97
+ { title: "First session", description: "A one-hour live introduction" },
98
+ ];
99
+
100
+ export function Vertical() {
101
+ const [step, setStep] = React.useState(1);
102
+ const steps = course.map((s, i) =>
103
+ i === step
104
+ ? {
105
+ ...s,
106
+ content: (
107
+ <div className="flex flex-col gap-4">
108
+ <p className="m-0 text-sm text-foreground-soft">
109
+ {i === 1
110
+ ? "The November cohort meets on Tuesdays and Thursdays at 18:00 CET."
111
+ : i === 2
112
+ ? "You need Git, a code editor and Node 22 or later."
113
+ : i === 3
114
+ ? "The link to the session arrives by email the day before."
115
+ : "Use the address you check most: the course sends its reminders there."}
116
+ </p>
117
+ <div className="flex gap-2">
118
+ <Button size="sm" onClick={() => setStep(i + 1)}>
119
+ Continue
120
+ </Button>
121
+ {i > 0 && (
122
+ <Button size="sm" variant="ghost" onClick={() => setStep(i - 1)}>
123
+ Back
124
+ </Button>
125
+ )}
126
+ </div>
127
+ </div>
128
+ ),
129
+ }
130
+ : s,
131
+ );
132
+ return (
133
+ <div className="w-full max-w-md">
134
+ <Stepper orientation="vertical" steps={steps} value={step} aria-label="Course enrolment" />
135
+ </div>
136
+ );
137
+ }
138
+ ```
139
+
140
+ ### Going back
141
+
142
+ Finished steps go back on click; steps ahead stay plain — forward is the step's Continue.
143
+
144
+ ```tsx
145
+ import { Stepper } from "@zonsh/ui";
146
+ import * as React from "react";
147
+
148
+ export function GoBack() {
149
+ const [step, setStep] = React.useState(3);
150
+ return (
151
+ <div className="flex w-full max-w-2xl flex-col gap-6">
152
+ <Stepper
153
+ aria-label="Publish a course"
154
+ steps={[{ title: "Outline" }, { title: "Lessons" }, { title: "Pricing" }, { title: "Publish" }]}
155
+ value={step}
156
+ onValueChange={setStep}
157
+ />
158
+ <p className="m-0 text-sm text-muted-foreground">
159
+ Pick a finished step to go back to it. Steps ahead open from the step before them.
160
+ </p>
161
+ </div>
162
+ );
163
+ }
164
+ ```
165
+
166
+ ### Errors
167
+
168
+ `error` shows its text under the title, read after "Needs attention" — never only red.
169
+
170
+ ```tsx
171
+ import { Stepper } from "@zonsh/ui";
172
+
173
+ export function Errors() {
174
+ return (
175
+ <div className="flex w-full max-w-2xl flex-col gap-10">
176
+ <Stepper
177
+ aria-label="Deploy"
178
+ value={3}
179
+ steps={[
180
+ { title: "Build" },
181
+ { title: "Test", error: "2 of 148 tests failed" },
182
+ { title: "Preview" },
183
+ { title: "Release" },
184
+ ]}
185
+ />
186
+ <Stepper
187
+ aria-label="Order a print"
188
+ orientation="vertical"
189
+ value={1}
190
+ steps={[
191
+ { title: "Upload", description: "poster-final.pdf, 4.2 MB" },
192
+ {
193
+ title: "Check the file",
194
+ error: "The image is 72 dpi; a print at A2 needs at least 150.",
195
+ },
196
+ { title: "Paper and size" },
197
+ { title: "Pay" },
198
+ ]}
199
+ />
200
+ </div>
201
+ );
202
+ }
203
+ ```
204
+
205
+ ### Compact
206
+
207
+ Always the step over a track, read as "Step 2 of 3".
208
+
209
+ ```tsx
210
+ import { Button, Field, FieldLabel, Input, Stepper } from "@zonsh/ui";
211
+ import * as React from "react";
212
+
213
+ export function Compact() {
214
+ const [step, setStep] = React.useState(1);
215
+ return (
216
+ <div className="flex w-full max-w-sm flex-col gap-6">
217
+ <Stepper
218
+ compact
219
+ steps={[{ title: "Account" }, { title: "Profile" }, { title: "Interests" }]}
220
+ value={step}
221
+ aria-label="Sign-up"
222
+ />
223
+ <Field>
224
+ <FieldLabel>Display name</FieldLabel>
225
+ <Input defaultValue="Ines Duarte" />
226
+ </Field>
227
+ <div className="flex justify-between gap-3">
228
+ <Button variant="ghost" disabled={step === 0} onClick={() => setStep((s) => Math.max(s - 1, 0))}>
229
+ Back
230
+ </Button>
231
+ <Button disabled={step === 3} onClick={() => setStep((s) => Math.min(s + 1, 3))}>
232
+ {step >= 2 ? "Finish sign-up" : "Continue"}
233
+ </Button>
234
+ </div>
235
+ </div>
236
+ );
237
+ }
238
+ ```
239
+
240
+ ## Props
241
+
242
+ | Prop | Type | Default |
243
+ | --------------- | ----------------------------------------------------------- | ---------------------------------- |
244
+ | `steps` | `StepperStep[]` | required |
245
+ | `value` | `number` — the current step, 0-based | required |
246
+ | `onValueChange` | `(index: number) => void` — makes finished steps links back | — |
247
+ | `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
248
+ | `compact` | `boolean \| "auto"` | `"auto"` in a row, `false` stacked |
249
+ | `aria-label` | `string` — names the list and the compact track | — |
250
+ | `labels` | `Partial<StepperMessages>` | English |
251
+
252
+ Each `StepperStep` has `title`, and optionally `description`, `error` (text; marks the step), `status` (`"upcoming" | "current" | "complete" | "error"`, overriding what `value` implies — a step done out of order), `disabled` (no link back) and `content` (under the current step, vertical only).
253
+
254
+ Other `<div>` props go to the root. Data attributes: `data-orientation` on the root, `data-status` on each `stepper-item` and `stepper-marker`, `data-complete` on a darkened `stepper-connector`. Interface text ("Completed", "Needs attention", "Step 2 of 4", "Done") comes from a `LocaleProvider` (`messages.stepper`) or `labels`.
255
+
256
+ ## Brand rules
257
+
258
+ - **Do** name steps with a noun or two: "Delivery", "Payment". The step's heading can say more.
259
+ - **Do** keep one primary per step: "Continue", and on the last what it does — "Place order".
260
+ - **Do** put an error on the step it is about, in words, even after people have moved past it.
261
+ - **Don't** colour the markers; red is only for an error.
262
+ - **Don't** let people jump ahead to steps whose answers depend on earlier ones.
263
+ - **Don't** use a stepper for more than about six steps. Group them, or split the flow.
264
+
265
+ ## Accessibility
266
+
267
+ - The steps are an ordered list; the current one has `aria-current="step"`. Name it with `aria-label` ("Checkout") when the page has more than one flow.
268
+ - Finished steps are read with "Completed", errors with "Needs attention" and the text. Markers are hidden.
269
+ - Steps that go back are buttons named by their title, with the 2px focus outline; the others are not focusable.
270
+ - The compact track is a `progressbar` named "02 / 04 · Delivery", valued "Step 2 of 4"; only one form is shown at a time.
271
+ - Move focus to the new step's heading when the step changes (see the Onboarding block).
272
+
273
+ ### Keyboard
274
+
275
+ | Key | What it does |
276
+ | ------------- | ------------------------------------------ |
277
+ | Tab | Moves to each finished step that goes back |
278
+ | Enter / Space | Goes back to the focused step |
279
+
280
+ The other steps are not focusable, and the compact track has no keys.
281
+
282
+ ---
283
+
284
+ - Import: `import { Stepper } from "@zonsh/ui"`
285
+ - Source: `packages/ui/src/components/stepper.tsx`
@@ -0,0 +1,146 @@
1
+ # Suggestions
2
+
3
+ ```tsx
4
+ import { Suggestion, Suggestions } from "@zonsh/ui";
5
+ import * as React from "react";
6
+
7
+ const prompts = [
8
+ "Which assignments are due this week?",
9
+ "Quiz me on chapter 3",
10
+ "Explain recursion with a short example",
11
+ ];
12
+
13
+ export function Basic() {
14
+ const [picked, setPicked] = React.useState<string | null>(null);
15
+ return (
16
+ <div className="flex w-full max-w-2xl flex-col gap-3">
17
+ <Suggestions>
18
+ {prompts.map((prompt) => (
19
+ <Suggestion key={prompt} suggestion={prompt} onClick={setPicked} />
20
+ ))}
21
+ </Suggestions>
22
+ <p className="m-0 font-mono text-xs text-muted-foreground">
23
+ {picked ? `Picked: ${picked}` : "Nothing picked yet"}
24
+ </p>
25
+ </div>
26
+ );
27
+ }
28
+ ```
29
+
30
+ Prompts as 30px raised buttons that wrap. Picking one calls `onClick` with the prompt, to send or to edit first.
31
+
32
+ ## Usage
33
+
34
+ ```tsx
35
+ import { Suggestion, Suggestions } from "@zonsh/ui";
36
+
37
+ <Suggestions>
38
+ <Suggestion suggestion="Which assignments are due this week?" onClick={send} />
39
+ </Suggestions>;
40
+ ```
41
+
42
+ - `suggestion` — the prompt.
43
+ - `onClick` — send it, or fill the prompt bar.
44
+ - `disabled` — on `Suggestions`, while a reply streams.
45
+
46
+ ## When to use
47
+
48
+ - In an empty chat, or under the last reply. Actions that aren't prompts are `Button`s.
49
+
50
+ ## Examples
51
+
52
+ ### While a reply streams
53
+
54
+ The row dims but stays in place and in the tab order; focus stays on the one just picked. Disable the prompt bar's send too.
55
+
56
+ ```tsx
57
+ import { Suggestion, Suggestions } from "@zonsh/ui";
58
+ import * as React from "react";
59
+
60
+ const followUps = ["Make it shorter", "Add a packing list", "What if it rains?"];
61
+
62
+ const REPLY_TIME = 1500;
63
+
64
+ /**
65
+ * Picking a follow-up sends it; while the reply streams the row is disabled, so a second prompt
66
+ * can't jump the queue. The suggestions stay where they are, and focus stays on the one picked.
67
+ */
68
+ export function WhileStreaming() {
69
+ const [asked, setAsked] = React.useState<string | null>(null);
70
+ const [streaming, setStreaming] = React.useState(false);
71
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
72
+ React.useEffect(() => () => clearTimeout(timer.current), []);
73
+ const send = (prompt: string) => {
74
+ setAsked(prompt);
75
+ setStreaming(true);
76
+ timer.current = setTimeout(() => setStreaming(false), REPLY_TIME);
77
+ };
78
+ return (
79
+ <div className="flex w-full max-w-2xl flex-col gap-3">
80
+ <Suggestions disabled={streaming} aria-label="Follow-up questions">
81
+ {followUps.map((prompt) => (
82
+ <Suggestion key={prompt} suggestion={prompt} onClick={send} />
83
+ ))}
84
+ </Suggestions>
85
+ <p aria-live="polite" className="m-0 font-mono text-xs text-muted-foreground">
86
+ {streaming
87
+ ? `Answering “${asked}”…`
88
+ : asked
89
+ ? `Answered “${asked}”`
90
+ : "Plan for a day walk on the coast"}
91
+ </p>
92
+ </div>
93
+ );
94
+ }
95
+ ```
96
+
97
+ ### Fill the prompt instead
98
+
99
+ For a start rather than a whole question.
100
+
101
+ ```tsx
102
+ <Suggestions>
103
+ <Suggestion suggestion="Summarise this week's changes to " onClick={setPrompt}>
104
+ Summarise changes…
105
+ </Suggestion>
106
+ <Suggestion suggestion="Write release notes for " onClick={setPrompt}>
107
+ Release notes…
108
+ </Suggestion>
109
+ </Suggestions>
110
+ ```
111
+
112
+ ### Under a reply
113
+
114
+ ```tsx
115
+ <Suggestions>
116
+ {followUps.map((prompt) => (
117
+ <Suggestion key={prompt} suggestion={prompt} onClick={send} />
118
+ ))}
119
+ </Suggestions>
120
+ ```
121
+
122
+ ## Props
123
+
124
+ | Component | Prop | Type | Default |
125
+ | ------------- | ------------ | ------------------------------ | ---------- |
126
+ | `Suggestions` | `disabled` | `boolean` — disables every one | `false` |
127
+ | `Suggestion` | `suggestion` | `string` — the prompt | — |
128
+ | | `onClick` | `(suggestion: string) => void` | — |
129
+ | | `children` | a shorter label | the prompt |
130
+
131
+ `Suggestion` forwards `Button` props (`disabled` for one alone). `Suggestions` forwards `<div>` props and writes `data-disabled`.
132
+
133
+ ## Brand rules
134
+
135
+ - **Do** write them as the person would ask: "Which assignments are due this week?", not "Assignment status".
136
+ - **Don't** show more than four, or under every reply.
137
+
138
+ ## Accessibility
139
+
140
+ - Each is a button named by its full prompt, even when truncated or relabelled.
141
+ - Disabled, each is `aria-disabled` and stays focusable, so focus isn't lost while the reply streams.
142
+
143
+ ---
144
+
145
+ - Import: `import { Suggestions, Suggestion } from "@zonsh/ui"`
146
+ - Source: `packages/ui/src/components/suggestions.tsx`