@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,143 @@
1
+ # Breadcrumb
2
+
3
+ ```tsx
4
+ import { Breadcrumb } from "@zonsh/ui";
5
+
6
+ export function Default() {
7
+ return (
8
+ <Breadcrumb
9
+ items={[
10
+ { label: "Shop", href: "#shop" },
11
+ { label: "Outerwear", href: "#outerwear" },
12
+ { label: "Waxed cotton jacket" },
13
+ ]}
14
+ />
15
+ );
16
+ }
17
+ ```
18
+
19
+ Where the page sits in the site, as a muted 12px mono trail with `/` separators. Ancestors are links; the current page is foreground and not a link.
20
+
21
+ ## Usage
22
+
23
+ ```tsx
24
+ import { Breadcrumb } from "@zonsh/ui";
25
+
26
+ <Breadcrumb
27
+ items={[
28
+ { label: "Shop", href: "/shop" },
29
+ { label: "Outerwear", href: "/shop/outerwear" },
30
+ { label: "Waxed cotton jacket" },
31
+ ]}
32
+ />;
33
+ ```
34
+
35
+ The one prop you need is `items`; the last item is the current page.
36
+
37
+ ## When to use
38
+
39
+ - Pages two or more levels deep.
40
+ - Not on top-level pages — it would only repeat the header.
41
+
42
+ ## Examples
43
+
44
+ ### With router link
45
+
46
+ Pass a router link through `render`; it gets `href`, `className` and the label.
47
+
48
+ ```tsx
49
+ import { Breadcrumb } from "@zonsh/ui";
50
+
51
+ /** Stand-in for a router's `Link`. */
52
+ function RouterLink(props: React.ComponentProps<"a">) {
53
+ return <a {...props} />;
54
+ }
55
+
56
+ export function WithRouterLink() {
57
+ return (
58
+ <Breadcrumb
59
+ items={[
60
+ { label: "Docs", href: "#docs", render: <RouterLink /> },
61
+ { label: "Components", href: "#components", render: <RouterLink /> },
62
+ { label: "Breadcrumb" },
63
+ ]}
64
+ />
65
+ );
66
+ }
67
+ ```
68
+
69
+ ### Folded
70
+
71
+ A trail too long for its row keeps the first page and the current one and folds the pages between into a "…" menu, as many as it takes to stay on one line — on a phone, or here in a 288px column. It unfolds again when there is room.
72
+
73
+ ```tsx
74
+ import { Breadcrumb } from "@zonsh/ui";
75
+
76
+ export function Folded() {
77
+ return (
78
+ <div className="w-full max-w-72">
79
+ <Breadcrumb
80
+ items={[
81
+ { label: "Notebook", href: "#notebook" },
82
+ { label: "Courses", href: "#courses" },
83
+ { label: "Spring term", href: "#spring" },
84
+ { label: "Organic chemistry", href: "#chemistry" },
85
+ { label: "Week 6 lab notes" },
86
+ ]}
87
+ />
88
+ </div>
89
+ );
90
+ }
91
+ ```
92
+
93
+ ### At most three pages
94
+
95
+ `maxItems` folds by count instead: the first page and the last ones, whatever the width.
96
+
97
+ ```tsx
98
+ import { Breadcrumb } from "@zonsh/ui";
99
+
100
+ export function MaxItems() {
101
+ return (
102
+ <Breadcrumb
103
+ maxItems={3}
104
+ items={[
105
+ { label: "Repository", href: "#repo" },
106
+ { label: "packages", href: "#packages" },
107
+ { label: "ui", href: "#ui" },
108
+ { label: "src", href: "#src" },
109
+ { label: "button.tsx" },
110
+ ]}
111
+ />
112
+ );
113
+ }
114
+ ```
115
+
116
+ ## Props
117
+
118
+ | Prop | Type | Default |
119
+ | ----------- | -------------------------------------------------------------- | -------- |
120
+ | `items` | `{ label: ReactNode; href?: string; render?: ReactElement }[]` | required |
121
+ | `separator` | `ReactNode` | `"/"` |
122
+ | `maxItems` | `number \| "auto"` — fold the middle into "…"; `"auto"` keeps one line, `Infinity` never folds | `"auto"` |
123
+
124
+ Other `<nav>` props are forwarded. The landmark's name comes from `messages.breadcrumb` (`BreadcrumbMessages`); your own `aria-label` wins.
125
+
126
+ ## Brand rules
127
+
128
+ - **Do** keep it above the page title, small and muted.
129
+ - **Do** use the page names people see in the navigation.
130
+ - **Don't** swap the `/` for chevrons or arrows.
131
+ - **Don't** set it in Licht Sans or uppercase it.
132
+
133
+ ## Accessibility
134
+
135
+ - Renders `<nav aria-label="Breadcrumb">` with an ordered list.
136
+ - The current page carries `aria-current="page"`.
137
+ - Separators are `aria-hidden`.
138
+ - The "…" button is named for what it holds ("Show 2 more pages", `messages.breadcrumb.more`) and opens a menu of the folded pages as links; Escape closes it and returns focus to it. On a touch screen it takes a 44px tap area (`touch-target`).
139
+
140
+ ---
141
+
142
+ - Import: `import { Breadcrumb } from "@zonsh/ui"`
143
+ - Source: `packages/ui/src/components/breadcrumb.tsx`
@@ -0,0 +1,216 @@
1
+ # Button Group
2
+
3
+ ```tsx
4
+ import { Button, ButtonGroup } from "@zonsh/ui";
5
+ import { ArchiveIcon, CopyIcon, PencilIcon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <ButtonGroup aria-label="Project actions">
10
+ <Button variant="secondary">
11
+ <PencilIcon />
12
+ Edit
13
+ </Button>
14
+ <Button variant="secondary">
15
+ <CopyIcon />
16
+ Duplicate
17
+ </Button>
18
+ <Button variant="secondary">
19
+ <ArchiveIcon />
20
+ Archive
21
+ </Button>
22
+ </ButtonGroup>
23
+ );
24
+ }
25
+ ```
26
+
27
+ Joins controls edge to edge: inner corners collapse to 0, outer corners keep their radius (12px buttons, 10px fields), and neighbours share one edge. The control in use rises above the rest, so its focus outline is never covered.
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ import { Button, ButtonGroup } from "@zonsh/ui";
33
+
34
+ <ButtonGroup aria-label="Project actions">
35
+ <Button variant="secondary">Edit</Button>
36
+ <Button variant="secondary">Duplicate</Button>
37
+ <Button variant="secondary">Archive</Button>
38
+ </ButtonGroup>;
39
+ ```
40
+
41
+ The props you'll reach for: `aria-label`, `orientation`, and `className` for width (`max-w-full`).
42
+
43
+ ## When to use
44
+
45
+ - A split button, a few actions on one object (Edit, Duplicate, Archive), or a pager.
46
+ - A field with the control it needs: a country code `Select` and a phone `Input`, an email `Input` and Subscribe.
47
+ - Choosing one of 2–5 options is a `ToggleGroup`; a button group holds actions, not a selection.
48
+ - An addon inside one field (an icon, `https://`) is an `InputGroup`.
49
+
50
+ ## Examples
51
+
52
+ ### Split button
53
+
54
+ The menu half is a square segment (`w-(--control-h) px-0`) whose chevron turns while open; the halves share one 1px seam. `ButtonGroupSeparator` is no longer needed and renders nothing visible. To fit a narrow column, give the group `max-w-full` and the long button `min-w-0`; its label then ends in "…".
55
+
56
+ ```tsx
57
+ import { Button, ButtonGroup, Menu, MenuContent, MenuItem, MenuTrigger } from "@zonsh/ui";
58
+ import { ChevronDownIcon } from "lucide-react";
59
+
60
+ /** The menu half of a split button: a square segment whose chevron turns while the menu is open. */
61
+ const splitTrigger =
62
+ "w-(--control-h) px-0 [&_svg]:transition-transform [&_svg]:duration-(--duration) [&_svg]:ease-(--ease) data-popup-open:[&_svg]:rotate-180";
63
+
64
+ export function SplitButton() {
65
+ return (
66
+ <div className="flex flex-wrap items-center gap-4">
67
+ <ButtonGroup aria-label="Publish the article">
68
+ <Button>Publish</Button>
69
+ <Menu>
70
+ <MenuTrigger render={<Button aria-label="More ways to publish" className={splitTrigger} />}>
71
+ <ChevronDownIcon />
72
+ </MenuTrigger>
73
+ <MenuContent align="end">
74
+ <MenuItem>Schedule for later</MenuItem>
75
+ <MenuItem>Publish to members only</MenuItem>
76
+ </MenuContent>
77
+ </Menu>
78
+ </ButtonGroup>
79
+ <ButtonGroup aria-label="Export the notes">
80
+ <Button variant="secondary">Export as PDF</Button>
81
+ <Menu>
82
+ <MenuTrigger
83
+ render={<Button variant="secondary" aria-label="More export formats" className={splitTrigger} />}
84
+ >
85
+ <ChevronDownIcon />
86
+ </MenuTrigger>
87
+ <MenuContent align="end">
88
+ <MenuItem>Export as Markdown</MenuItem>
89
+ <MenuItem>Copy a share link</MenuItem>
90
+ </MenuContent>
91
+ </Menu>
92
+ </ButtonGroup>
93
+ </div>
94
+ );
95
+ }
96
+ ```
97
+
98
+ ### With fields
99
+
100
+ Give the field `flex-1` to fill the row.
101
+
102
+ ```tsx
103
+ import { Button, ButtonGroup, Field, FieldLabel, Input, Label, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@zonsh/ui";
104
+ import * as React from "react";
105
+
106
+ const codes = [
107
+ { value: "+49", label: "+49" },
108
+ { value: "+43", label: "+43" },
109
+ { value: "+41", label: "+41" },
110
+ ];
111
+
112
+ export function WithFields() {
113
+ // A Field gives its one id to every control inside it, so the joined pair is labelled by
114
+ // hand: "Phone" names the number, and the country code names itself.
115
+ const phone = React.useId();
116
+ return (
117
+ <div className="flex w-full max-w-md flex-col gap-6">
118
+ <div className="flex flex-col gap-2">
119
+ <Label htmlFor={phone}>Phone</Label>
120
+ <ButtonGroup aria-label="Phone number" className="w-full">
121
+ <Select items={codes} defaultValue="+49">
122
+ <SelectTrigger aria-label="Country code" className="w-24 min-w-0 font-mono tabular-nums">
123
+ <SelectValue />
124
+ </SelectTrigger>
125
+ <SelectContent>
126
+ {codes.map((code) => (
127
+ <SelectItem key={code.value} value={code.value} className="font-mono">
128
+ {code.label}
129
+ </SelectItem>
130
+ ))}
131
+ </SelectContent>
132
+ </Select>
133
+ <Input id={phone} type="tel" placeholder="221 1234567" className="flex-1" />
134
+ </ButtonGroup>
135
+ </div>
136
+ <Field>
137
+ <FieldLabel>Project notes by email</FieldLabel>
138
+ <ButtonGroup aria-label="Subscribe to project notes" className="w-full">
139
+ <Input type="email" placeholder="you@example.com" className="flex-1" />
140
+ <Button variant="secondary">Subscribe</Button>
141
+ </ButtonGroup>
142
+ </Field>
143
+ </div>
144
+ );
145
+ }
146
+ ```
147
+
148
+ ### Pager
149
+
150
+ ```tsx
151
+ import { Button, ButtonGroup } from "@zonsh/ui";
152
+ import { ChevronLeftIcon, ChevronRightIcon } from "lucide-react";
153
+
154
+ export function Pager() {
155
+ return (
156
+ <ButtonGroup aria-label="Articles">
157
+ <Button variant="secondary" size="sm">
158
+ <ChevronLeftIcon className="rtl:-scale-x-100" />
159
+ Previous
160
+ </Button>
161
+ <Button variant="secondary" size="sm">
162
+ Next
163
+ <ChevronRightIcon className="rtl:-scale-x-100" />
164
+ </Button>
165
+ </ButtonGroup>
166
+ );
167
+ }
168
+ ```
169
+
170
+ ### Vertical
171
+
172
+ ```tsx
173
+ import { Button, ButtonGroup } from "@zonsh/ui";
174
+ import { MinusIcon, PlusIcon } from "lucide-react";
175
+
176
+ export function Vertical() {
177
+ return (
178
+ <ButtonGroup orientation="vertical" aria-label="Zoom">
179
+ <Button variant="secondary" aria-label="Zoom in" className="w-(--control-h) px-0">
180
+ <PlusIcon />
181
+ </Button>
182
+ <Button variant="secondary" aria-label="Zoom out" className="w-(--control-h) px-0">
183
+ <MinusIcon />
184
+ </Button>
185
+ </ButtonGroup>
186
+ );
187
+ }
188
+ ```
189
+
190
+ ## Props
191
+
192
+ | Component | Prop | Type | Default |
193
+ | ---------------------- | ------------- | ---------------------------- | -------------- |
194
+ | `ButtonGroup` | `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
195
+ | `ButtonGroupSeparator` | `orientation` | `"vertical" \| "horizontal"` | `"vertical"` |
196
+
197
+ Both render a `<div>` and take its props. Data attributes: `data-orientation` on both.
198
+
199
+ ## Brand rules
200
+
201
+ - **Do** join controls of the same height; a 30px button beside a 38px input won't line up.
202
+ - **Do** keep one primary per view; both halves of a split button share a variant.
203
+ - **Do** make a split button's menu half a square chevron segment labelled with what it holds ("More ways to publish").
204
+ - **Don't** join unrelated actions to save space; they stay separate buttons with a gap.
205
+ - **Don't** add your own radius or border to collapse the corners; the group does it.
206
+
207
+ ## Accessibility
208
+
209
+ - The group is a `role="group"`; give it an `aria-label` naming what the controls act on.
210
+ - Each control keeps its own label and focus; Tab moves through them in order.
211
+ - `ButtonGroupSeparator` renders a hidden `role="separator"`, kept for existing markup.
212
+
213
+ ---
214
+
215
+ - Import: `import { ButtonGroup, ButtonGroupSeparator } from "@zonsh/ui"`
216
+ - Source: `packages/ui/src/components/button-group.tsx`
@@ -0,0 +1,309 @@
1
+ # Button
2
+
3
+ ```tsx
4
+ import { Button } from "@zonsh/ui";
5
+
6
+ export function Variants() {
7
+ return (
8
+ <div className="flex flex-wrap items-center gap-3">
9
+ <Button>Create project</Button>
10
+ <Button variant="secondary">See the components</Button>
11
+ <Button variant="ghost">View changelog</Button>
12
+ <Button variant="bare">Show details</Button>
13
+ <Button variant="link">Read the guide</Button>
14
+ </div>
15
+ );
16
+ }
17
+ ```
18
+
19
+ The **primary** is a layered fill — `#292929` light, `#cbcbcb` dark — with a fine stroke, an inner highlight and soft shading. **Secondary** is a quiet raised surface. Both press _inward_ (an inset shadow) rather than moving.
20
+
21
+ ## Usage
22
+
23
+ ```tsx
24
+ import { Button } from "@zonsh/ui";
25
+
26
+ <Button size="lg">Create project</Button>
27
+ <Button variant="secondary">See the components</Button>
28
+ ```
29
+
30
+ The props you'll reach for: `variant`, `size`, `loading`.
31
+
32
+ ## When to use
33
+
34
+ - `primary` — the one action that carries a view. Its label names the outcome: "Save changes", "Create project", "Get started".
35
+ - `secondary` — every other action. Its label describes the destination: "See the components".
36
+ - `ghost` — toolbars and dense rows; flat at rest, raised on hover.
37
+ - `link` — inline text actions inside prose.
38
+ - `bare` — no surface, even on hover: muted ink that lights up on hover, focus and press. For icon toggles beside content (collapse, a sidebar trigger, a close mark) where a raised hover would be too loud; mostly `icon`/`icon-sm`, or a quiet "Show details" (`px-0` aligns it with the copy). Not for an action that must be found.
39
+ - `destructive` — irreversible actions only (deleting data).
40
+
41
+ ## Examples
42
+
43
+ ### Sizes
44
+
45
+ `sm` 30px for dense surfaces, `default` 38px, `lg` 46px for a page's calls to action. Nothing in between.
46
+
47
+ ```tsx
48
+ import { Button } from "@zonsh/ui";
49
+ import { ArrowRightIcon } from "lucide-react";
50
+
51
+ export function Sizes() {
52
+ return (
53
+ <div className="flex flex-wrap items-center gap-3">
54
+ <Button size="sm" variant="secondary">
55
+ Dense action
56
+ </Button>
57
+ <Button variant="secondary">Default</Button>
58
+ <Button size="lg">
59
+ Get started
60
+ <ArrowRightIcon className="rtl:-scale-x-100" />
61
+ </Button>
62
+ </div>
63
+ );
64
+ }
65
+ ```
66
+
67
+ ### Icon only
68
+
69
+ Icon buttons are round, 36px (or 30px), and always need an `aria-label`.
70
+
71
+ ```tsx
72
+ import { Button } from "@zonsh/ui";
73
+ import { PlusIcon, SearchIcon, XIcon } from "lucide-react";
74
+
75
+ export function IconOnly() {
76
+ return (
77
+ <div className="flex items-center gap-3">
78
+ <Button size="icon" variant="secondary" aria-label="Search">
79
+ <SearchIcon />
80
+ </Button>
81
+ <Button size="icon" aria-label="Add item">
82
+ <PlusIcon />
83
+ </Button>
84
+ <Button size="icon-sm" variant="ghost" aria-label="Search">
85
+ <SearchIcon />
86
+ </Button>
87
+ <Button size="icon-sm" variant="bare" aria-label="Close">
88
+ <XIcon />
89
+ </Button>
90
+ </div>
91
+ );
92
+ }
93
+ ```
94
+
95
+ ### Collapsible
96
+
97
+ `collapsible` folds an icon-and-label button to a round icon button when its row runs out of room. Several fold one at a time, last first. The row is the parent, or the nearest ancestor with `data-collapse-row`; a growing child (a title, a search field) shrinks to its min-width first. The label stays the accessible name.
98
+
99
+ ```tsx
100
+ import { Button, Slider } from "@zonsh/ui";
101
+ import { DownloadIcon, PlusIcon, Share2Icon } from "lucide-react";
102
+ import * as React from "react";
103
+
104
+ /** A header row whose actions fold to their icons, the last first, as the row narrows. */
105
+ export function Collapsible() {
106
+ const [width, setWidth] = React.useState(640);
107
+ return (
108
+ <div className="flex w-full max-w-2xl flex-col gap-8">
109
+ {/* The slider sets the most room the row may take; a narrow screen gives it less. */}
110
+ <div className="flex w-full items-center gap-2" style={{ maxWidth: width }}>
111
+ <p className="m-0 min-w-24 flex-1 truncate text-sm font-medium text-foreground">Quarterly report</p>
112
+ <Button variant="secondary" collapsible>
113
+ <Share2Icon />
114
+ Share
115
+ </Button>
116
+ <Button variant="secondary" collapsible>
117
+ <DownloadIcon />
118
+ Export
119
+ </Button>
120
+ <Button collapsible>
121
+ <PlusIcon />
122
+ New report
123
+ </Button>
124
+ </div>
125
+ <Slider
126
+ label="Room for the row"
127
+ showValue
128
+ min={280}
129
+ max={640}
130
+ step={4}
131
+ value={width}
132
+ onValueChange={(value) => setWidth(value as number)}
133
+ className="max-w-sm"
134
+ />
135
+ </div>
136
+ );
137
+ }
138
+ ```
139
+
140
+ Keep such a row on one line (a wrapping row would jump while a fold runs): give its growing child `min-w-0` and its real minimum as `--collapse-min` (e.g. `[--collapse-min:10rem]`). When everything is folded and it still does not fit, the row gets `data-collapse-overflow` — the moment to let it wrap. The `DataTable` toolbar works this way.
141
+
142
+ ### Expandable
143
+
144
+ `expandable` (or `"label"`) rests as a round icon button and shows its label on hover, or at once on focus. `expandable="icon"` rests as text and slides its icon in, wherever you place it. Touch screens keep the resting form; the label is always the accessible name. It opens after the pointer rests a moment, so sweeping over a row does nothing. It nudges what follows: align the row to its start, never centre it, and leave room at the end.
145
+
146
+ ```tsx
147
+ import { Button } from "@zonsh/ui";
148
+ import { ArrowRightIcon, DownloadIcon, PencilIcon, PlusIcon, Share2Icon } from "lucide-react";
149
+
150
+ /**
151
+ * What opens on hover: the label of a round icon button (top), or the icon of a text button —
152
+ * before the text, or after it (bottom).
153
+ */
154
+ export function Expandable() {
155
+ return (
156
+ // Rows aligned to their start, in a box of fixed width: an opening button pushes only what
157
+ // follows it, and one row never moves the other.
158
+ <div className="flex w-72 flex-col items-start gap-6">
159
+ <div className="flex items-center gap-2">
160
+ <Button variant="secondary" expandable>
161
+ <PencilIcon />
162
+ Edit
163
+ </Button>
164
+ <Button variant="secondary" expandable>
165
+ <Share2Icon />
166
+ Share
167
+ </Button>
168
+ <Button expandable>
169
+ <PlusIcon />
170
+ New report
171
+ </Button>
172
+ </div>
173
+ <div className="flex items-center gap-2">
174
+ <Button variant="secondary" expandable="icon">
175
+ <DownloadIcon />
176
+ Download
177
+ </Button>
178
+ <Button expandable="icon">
179
+ Continue
180
+ <ArrowRightIcon className="rtl:-scale-x-100" />
181
+ </Button>
182
+ </div>
183
+ </div>
184
+ );
185
+ }
186
+ ```
187
+
188
+ ### States
189
+
190
+ ```tsx
191
+ import { Button } from "@zonsh/ui";
192
+
193
+ export function States() {
194
+ return (
195
+ <div className="flex flex-wrap items-center gap-3">
196
+ <Button disabled>Unavailable</Button>
197
+ <Button variant="secondary" disabled>
198
+ Unavailable
199
+ </Button>
200
+ <Button variant="ghost" disabled>
201
+ Unavailable
202
+ </Button>
203
+ <Button variant="bare" disabled>
204
+ Unavailable
205
+ </Button>
206
+ <Button variant="destructive">Delete workspace</Button>
207
+ </div>
208
+ );
209
+ }
210
+ ```
211
+
212
+ ### Loading
213
+
214
+ A spinner replaces the leading icon (or sits over the label) and the width holds. The button is `aria-busy`, ignores clicks and keys (no second submit) and keeps focus and full ink — busy is not unavailable. Name the work with `loadingLabel` ("Saving changes"); clear `loading` when it settles, either way.
215
+
216
+ ```tsx
217
+ import { Button } from "@zonsh/ui";
218
+ import { DownloadIcon, RefreshCwIcon } from "lucide-react";
219
+ import * as React from "react";
220
+
221
+ export function Loading() {
222
+ const [saving, setSaving] = React.useState(false);
223
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
224
+ React.useEffect(() => () => clearTimeout(timer.current), []);
225
+ const save = () => {
226
+ setSaving(true);
227
+ timer.current = setTimeout(() => setSaving(false), 2500);
228
+ };
229
+ return (
230
+ <div className="flex flex-wrap items-center gap-3">
231
+ <Button loading={saving} loadingLabel="Saving changes" onClick={save}>
232
+ Save changes
233
+ </Button>
234
+ <Button variant="secondary" loading loadingLabel="Exporting the report">
235
+ <DownloadIcon />
236
+ Export report
237
+ </Button>
238
+ <Button size="icon" variant="secondary" aria-label="Refresh the feed" loading>
239
+ <RefreshCwIcon />
240
+ </Button>
241
+ </div>
242
+ );
243
+ }
244
+ ```
245
+
246
+ ```tsx
247
+ <Button type="submit" loading={pending} loadingLabel="Sending your message">
248
+ Send message
249
+ </Button>
250
+ ```
251
+
252
+ ### As link
253
+
254
+ `render` an `<a>` with `nativeButton={false}`; it keeps its link role.
255
+
256
+ ```tsx
257
+ import { Button } from "@zonsh/ui";
258
+ import { ArrowRightIcon } from "lucide-react";
259
+
260
+ export function AsLink() {
261
+ return (
262
+ <Button nativeButton={false} render={<a href="#contact" />} variant="secondary">
263
+ Contact us
264
+ <ArrowRightIcon className="rtl:-scale-x-100" />
265
+ </Button>
266
+ );
267
+ }
268
+ ```
269
+
270
+ ## Props
271
+
272
+ | Prop | Type | Default |
273
+ | ----------------------- | -------------------------------------------------------------------------- | ----------- |
274
+ | `variant` | `"primary" \| "secondary" \| "ghost" \| "bare" \| "link" \| "destructive"` | `"primary"` |
275
+ | `size` | `"sm" \| "default" \| "lg" \| "icon" \| "icon-sm"` | `"default"` |
276
+ | `render` | `ReactElement \| (props, state) => ReactElement` | — |
277
+ | `nativeButton` | `boolean` — set `false` when `render` is not a `<button>` | `true` |
278
+ | `disabled` | `boolean` | `false` |
279
+ | `focusableWhenDisabled` | `boolean` — keep a disabled button in the tab order | `false` |
280
+ | `collapsible` | `boolean` — fold to the icon when the row is too tight | `false` |
281
+ | `expandable` | `boolean \| "label" \| "icon"` — what opens on hover or focus | `false` |
282
+ | `loading` | `boolean` — busy: a spinner, `aria-busy`, clicks ignored, focus kept | `false` |
283
+ | `loadingLabel` | `string` — what it says while loading | `"Loading"` |
284
+
285
+ All other `<button>` props are forwarded. Data attributes: `data-variant`, `data-size`, `data-disabled`, `data-loading`; `data-collapsible` and `data-collapsed` on a collapsible button.
286
+
287
+ A button is never wider than its container: its text (one `button-text` span) ends in "…" when out of room, and the full label stays the accessible name. In a row it keeps its width while neighbours give way; add `min-w-0` to let it shrink. Icons, a `Kbd` and a spinner keep their size, and labels are cut, never wrapped.
288
+
289
+ ## Brand rules
290
+
291
+ - **Do** keep exactly one primary per view.
292
+ - **Do** set height with `size`; heights are `min-height`, so they never drift with font changes.
293
+ - **Don't** override the height with `h-12` or padding, or invent a fourth size.
294
+ - **Don't** replace the primary's layered fill with a flat `bg-primary`.
295
+ - **Don't** add glow, animated gradients, thick outlines or floating shadows.
296
+ - Icons are lucide, 16px inside buttons, before the label for context or after it for direction (→).
297
+
298
+ ## Accessibility
299
+
300
+ - Focus shows a 2px `--control-focus` outline flush on the control — never offset, never hidden.
301
+ - Icon-only buttons require `aria-label`.
302
+ - A loading button is `aria-busy` and `aria-disabled`, stays focused, and says its `loadingLabel` (an icon button keeps its `aria-label`).
303
+ - Disabled buttons leave the tab order unless `focusableWhenDisabled` is set, for explaining _why_ with a tooltip: it still takes hover (not-allowed cursor) while clicks and keys stay inert. A natively disabled button ignores the pointer.
304
+
305
+ ---
306
+
307
+ - Import: `import { Button } from "@zonsh/ui"`
308
+ - Source: `packages/ui/src/components/button.tsx`
309
+ - Primitive: `@base-ui/react/button` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/button.md`)