@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,159 @@
1
+ # Context Menu
2
+
3
+ ```tsx
4
+ import { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from "@zonsh/ui";
5
+ import { CopyIcon, PencilIcon, Share2Icon, Trash2Icon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ export function Basic() {
9
+ const [pinned, setPinned] = React.useState(false);
10
+ return (
11
+ <ContextMenu>
12
+ <ContextMenuTrigger className="flex h-40 w-full max-w-md items-center justify-center rounded-card border border-dashed border-field-edge font-mono text-xs text-muted-foreground">
13
+ Right-click or long-press this note
14
+ </ContextMenuTrigger>
15
+ <ContextMenuContent>
16
+ <ContextMenuItem>
17
+ <PencilIcon />
18
+ Edit note
19
+ <ContextMenuShortcut>E</ContextMenuShortcut>
20
+ </ContextMenuItem>
21
+ <ContextMenuItem>
22
+ <CopyIcon />
23
+ Duplicate
24
+ <ContextMenuShortcut keys={["mod", "D"]} />
25
+ </ContextMenuItem>
26
+ <ContextMenuSub>
27
+ <ContextMenuSubTrigger>
28
+ <Share2Icon />
29
+ Share
30
+ </ContextMenuSubTrigger>
31
+ <ContextMenuSubContent>
32
+ <ContextMenuItem>Copy link</ContextMenuItem>
33
+ <ContextMenuItem>Send by email</ContextMenuItem>
34
+ </ContextMenuSubContent>
35
+ </ContextMenuSub>
36
+ <ContextMenuCheckboxItem checked={pinned} onCheckedChange={setPinned}>
37
+ Pin to dashboard
38
+ </ContextMenuCheckboxItem>
39
+ <ContextMenuSeparator />
40
+ <ContextMenuItem variant="destructive">
41
+ <Trash2Icon />
42
+ Delete note
43
+ </ContextMenuItem>
44
+ </ContextMenuContent>
45
+ </ContextMenu>
46
+ );
47
+ }
48
+ ```
49
+
50
+ A `Menu` that opens at the pointer on right click or long press of an area: `material-menu` at 12px, 38px items that lift on highlight, mono labels and shortcuts. The `ContextMenu*` item parts are the `Menu*` parts renamed, so either set works inside it.
51
+
52
+ ## Usage
53
+
54
+ ```tsx
55
+ import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuTrigger } from "@zonsh/ui";
56
+
57
+ <ContextMenu>
58
+ <ContextMenuTrigger>…the note card…</ContextMenuTrigger>
59
+ <ContextMenuContent>
60
+ <ContextMenuItem onClick={edit}>Edit note</ContextMenuItem>
61
+ <ContextMenuItem variant="destructive" onClick={remove}>
62
+ Delete note
63
+ </ContextMenuItem>
64
+ </ContextMenuContent>
65
+ </ContextMenu>;
66
+ ```
67
+
68
+ The props you'll reach for: `ContextMenuTrigger.render`, `ContextMenuItem.variant`, `ContextMenu.onOpenChange`.
69
+
70
+ ## When to use
71
+
72
+ - Shortcuts on a thing that already has visible controls: a card, a row, a file, a canvas object.
73
+ - Not as the only way to reach an action — touch and keyboard users may never open it.
74
+
75
+ ## Examples
76
+
77
+ ### A row in a list
78
+
79
+ With `render`, each row of a file list is its own trigger and the menu acts on that row. Keep the row's own buttons for the same actions.
80
+
81
+ ```tsx
82
+ <ul>
83
+ {files.map((file) => (
84
+ <ContextMenu key={file.id}>
85
+ <ContextMenuTrigger render={<li />} className="flex h-(--control-h) items-center px-3">
86
+ {file.name}
87
+ </ContextMenuTrigger>
88
+ <ContextMenuContent>
89
+ <ContextMenuItem onClick={() => rename(file)}>Rename</ContextMenuItem>
90
+ <ContextMenuItem onClick={() => download(file)}>Download</ContextMenuItem>
91
+ <ContextMenuSeparator />
92
+ <ContextMenuItem variant="destructive" onClick={() => remove(file)}>
93
+ Delete
94
+ </ContextMenuItem>
95
+ </ContextMenuContent>
96
+ </ContextMenu>
97
+ ))}
98
+ </ul>
99
+ ```
100
+
101
+ ### A choice
102
+
103
+ A radio group under a mono label; the menu stays open so the change shows.
104
+
105
+ ```tsx
106
+ <ContextMenuContent>
107
+ <ContextMenuGroup>
108
+ <ContextMenuGroupLabel>Sort by</ContextMenuGroupLabel>
109
+ <ContextMenuRadioGroup value={sort} onValueChange={setSort}>
110
+ <ContextMenuRadioItem value="name">Name</ContextMenuRadioItem>
111
+ <ContextMenuRadioItem value="modified">Last modified</ContextMenuRadioItem>
112
+ <ContextMenuRadioItem value="size">Size</ContextMenuRadioItem>
113
+ </ContextMenuRadioGroup>
114
+ </ContextMenuGroup>
115
+ </ContextMenuContent>
116
+ ```
117
+
118
+ ## Props
119
+
120
+ | Prop | Type | Default |
121
+ | ------------------------------------------------------------------ | ------------------------------------------------ | ---------------------------------------------- |
122
+ | `ContextMenuTrigger` | the area; renders a `<div>` (`render` to change) | — |
123
+ | `ContextMenuContent.side` / `align` / `sideOffset` / `alignOffset` | positioning relative to the pointer | Base UI defaults (start-aligned at the cursor) |
124
+ | `ContextMenuContent.positioner` / `portal` | Base UI positioner / portal props | — |
125
+ | `ContextMenuItem.variant` | `"default" \| "destructive"` | `"default"` |
126
+
127
+ `ContextMenu` is Base UI `ContextMenu.Root` (`open`, `onOpenChange`, `disabled`). All item parts take the same props as their `Menu*` counterparts — see `Menu`.
128
+
129
+ ## Brand rules
130
+
131
+ - **Do** mirror actions that exist elsewhere in the UI, in the same words.
132
+ - **Do** keep the list short and put destructive items last after a separator.
133
+ - **Don't** style the trigger area as a button; it is the thing itself.
134
+ - **Don't** override the browser's context menu on text people need to copy.
135
+
136
+ ## Accessibility
137
+
138
+ - Opens with right click or long press on the trigger area.
139
+ - Hidden by nature: every action must also be on a visible control.
140
+
141
+ ### Keyboard
142
+
143
+ | Key | What it does |
144
+ | ---------------------------- | ----------------------------------------------------------------------------------- |
145
+ | Context-menu key / Shift+F10 | Opens the menu under the focused element, while the focus is inside the area |
146
+ | ↓ / ↑ | Moves the highlight, looping at the ends |
147
+ | Home / End | Highlights the first or last item |
148
+ | Enter / Space | Runs the highlighted item; a checkbox or radio item toggles and the menu stays open |
149
+ | → / ← | Opens a submenu, or closes it and returns to its trigger (swapped right to left) |
150
+ | Typing | Highlights the next item that starts with the letters typed |
151
+ | Escape | Closes the menu |
152
+
153
+ The menu opens on the `contextmenu` event, under the focused element's start corner. The area itself takes no focus: give the things in it a tab stop (a button, a link, `tabIndex={0}` on a row) to put the menu in reach of the keyboard. A Mac keyboard has no context-menu key, so keep every action on a visible control as well.
154
+
155
+ ---
156
+
157
+ - Import: `import { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuLinkItem, ContextMenuCheckboxItem, ContextMenuRadioGroup, ContextMenuRadioItem } from "@zonsh/ui"`
158
+ - Source: `packages/ui/src/components/context-menu.tsx`
159
+ - Primitive: `@base-ui/react/context-menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/context-menu.md`)
@@ -0,0 +1,146 @@
1
+ # Conversation
2
+
3
+ ```tsx
4
+ import { Conversation, ConversationContent, ConversationScrollButton, Message, MessageContent, MessageText, Response } from "@zonsh/ui";
5
+
6
+ /* An illustrative conversation, not real data. */
7
+ const turns: { from: "user" | "assistant"; text: string }[] = [
8
+ { from: "user", text: "Why did last night's deploy of the docs site fail?" },
9
+ {
10
+ from: "assistant",
11
+ text: "The build stopped at the image step:\n\n- **Install** — finished in 41 seconds.\n- **Build** — failed: `hero.avif` is larger than the 5 MB limit.\n- **Deploy** — skipped, so the site still serves Tuesday's version.",
12
+ },
13
+ { from: "user", text: "When did the image get that big?" },
14
+ {
15
+ from: "assistant",
16
+ text: "It was replaced yesterday at 18:12 with an uncompressed export. The previous file was 640 KB. Nothing else in that commit touches the build.",
17
+ },
18
+ { from: "user", text: "Who replaced it?" },
19
+ {
20
+ from: "assistant",
21
+ text: 'Lea, in the commit "New hero for the autumn release". The message mentions a placeholder, so the large file may not be the final one.',
22
+ },
23
+ { from: "user", text: "Ask Lea for a smaller export, and rerun the deploy once it's in." },
24
+ {
25
+ from: "assistant",
26
+ text: "Done. Lea has a comment on the commit asking for a compressed export, and the deploy will run again when a new version of the file lands. I'll tell you when it's live.",
27
+ },
28
+ ];
29
+
30
+ export function Basic() {
31
+ return (
32
+ <div className="flex h-[28rem] w-full max-w-3xl flex-col surface-card [--card-padding:0]">
33
+ <Conversation className="rounded-card" aria-label="Conversation with the assistant">
34
+ <ConversationContent>
35
+ {turns.map((turn, index) => (
36
+ <Message key={index} from={turn.from}>
37
+ <MessageContent>
38
+ {turn.from === "user" ? (
39
+ <MessageText>{turn.text}</MessageText>
40
+ ) : (
41
+ <Response>{turn.text}</Response>
42
+ )}
43
+ </MessageContent>
44
+ </Message>
45
+ ))}
46
+ </ConversationContent>
47
+ <ConversationScrollButton />
48
+ </Conversation>
49
+ </div>
50
+ );
51
+ }
52
+ ```
53
+
54
+ The column of messages in an AI chat. At the end it follows a streaming reply, gliding rather than jumping; scrolled up, it stays put and a round button brings back the latest message.
55
+
56
+ ## Usage
57
+
58
+ ```tsx
59
+ import { Conversation, ConversationContent, ConversationScrollButton } from "@zonsh/ui";
60
+
61
+ <div className="flex h-[40rem] flex-col">
62
+ <Conversation aria-label="Conversation with the assistant">
63
+ <ConversationContent>{/* Message … */}</ConversationContent>
64
+ <ConversationScrollButton />
65
+ </Conversation>
66
+ {/* PromptInput */}
67
+ </div>;
68
+ ```
69
+
70
+ The props you'll reach for: `aria-label`, `aria-busy` (while a reply streams) and `className`. It fills a flex column (`flex-1 min-h-0`): give the column a height.
71
+
72
+ ## When to use
73
+
74
+ - Above a `PromptInput`, holding `Message`s. The conversation scrolls; the prompt bar stays in view.
75
+ - A fixed list that does not grow needs only `Item`s.
76
+
77
+ ## Examples
78
+
79
+ ### In a card, above the prompt bar
80
+
81
+ The prompt bar sits under the conversation; mark the log busy while a reply streams.
82
+
83
+ ```tsx
84
+ <div className="flex h-[40rem] flex-col surface-card [--card-padding:0]">
85
+ <Conversation aria-label="Conversation with the assistant" aria-busy={streaming} className="rounded-t-card">
86
+ <ConversationContent>
87
+ {messages.map((m) => (
88
+ <Message key={m.id} from={m.from}>
89
+ <MessageContent>
90
+ {m.from === "user" ? <MessageText>{m.text}</MessageText> : <Response>{m.text}</Response>}
91
+ </MessageContent>
92
+ </Message>
93
+ ))}
94
+ </ConversationContent>
95
+ <ConversationScrollButton />
96
+ </Conversation>
97
+ <PromptInput onSubmit={send}>{/* PromptInputTextarea, PromptInputToolbar … */}</PromptInput>
98
+ </div>
99
+ ```
100
+
101
+ ### Another language
102
+
103
+ The scroll button's name comes from `messages.conversation.scrollToLatest`, or from `label` on one button.
104
+
105
+ ```tsx
106
+ <ConversationScrollButton label="Zur neuesten Nachricht" />
107
+ ```
108
+
109
+ ## Props
110
+
111
+ | Component | Prop | Type | Default |
112
+ | -------------------------- | ------------ | --------------------------------- | -------------------------------- |
113
+ | `Conversation` | `aria-label` | `string` — name the log | — |
114
+ | | `aria-busy` | `boolean` — while a reply streams | — |
115
+ | `ConversationScrollButton` | `label` | `string` | `"Scroll to the latest message"` |
116
+
117
+ `Conversation` forwards `div` props — `aria-label`, `ref`, `onScroll` — to the scrolling `log`; `className` and `style` go to its outer element, whose corners the log takes. In a card, give the conversation its corners (`rounded-card`, or `rounded-t-card` above a prompt bar) rather than clipping the card with `overflow-hidden`, which would hide the log's focus ring. `ConversationContent` and the button forward their props.
118
+
119
+ ## Brand rules
120
+
121
+ - **Do** keep the prompt bar outside the conversation, always in view.
122
+ - **Do** let the reader stay where they scrolled. Jumping back down while someone reads is the most common chat bug.
123
+ - **Don't** animate each new message in. The reply writing itself out is motion enough.
124
+
125
+ ## Accessibility
126
+
127
+ - The scrolling area is a focusable `log` region, so it scrolls with the keyboard. Name it with `aria-label`.
128
+ - Set `aria-busy` while a reply streams: screen readers then announce the reply once, when complete.
129
+ - The scroll button is hidden from assistive tech and the tab order while you are at the end; when shown, it reads "Scroll to the latest message".
130
+
131
+ ### Keyboard
132
+
133
+ With focus on the log itself (not a control inside it):
134
+
135
+ | Key | What it does |
136
+ | -------------------------------- | ------------------------------------------------------------------------------------------- |
137
+ | ↑ / Page Up / Home / Shift+Space | Scrolls up and stops following the reply |
138
+ | ↓ / Page Down / End / Space | Scrolls down; back at the end, follows the reply again |
139
+ | Tab | Reaches the scroll button when it shows; Enter or Space on it scrolls to the latest message |
140
+
141
+ Keys pressed on a button, field, menu or other widget inside a message stay that widget's.
142
+
143
+ ---
144
+
145
+ - Import: `import { Conversation, ConversationContent, ConversationScrollButton } from "@zonsh/ui"`
146
+ - Source: `packages/ui/src/components/conversation.tsx`
@@ -0,0 +1,162 @@
1
+ # Copy Button
2
+
3
+ ```tsx
4
+ import { CopyButton } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <div className="flex items-center gap-2">
9
+ <span className="font-mono text-sm text-foreground-soft">Order ord_4812_kq2m</span>
10
+ <CopyButton value="ord_4812_kq2m" labels={{ copy: "Copy order ID" }} />
11
+ </div>
12
+ );
13
+ }
14
+ ```
15
+
16
+ A raised 30px circle with a copy icon. Pressed, it copies the value, the icon turns into a check for 1.5 seconds, and a polite live region says "Copied". The icons cross-fade in place, so the size never changes. Where the Clipboard API is blocked (`http:`, an iframe without permission) it falls back to the older copy command; if that fails, it shows a cross and says "Couldn't copy". `CodeBlock` uses it.
17
+
18
+ ## Usage
19
+
20
+ ```tsx
21
+ import { CopyButton } from "@zonsh/ui";
22
+
23
+ <CopyButton value="ord_4812_kq2m" labels={{ copy: "Copy order ID" }} />;
24
+ ```
25
+
26
+ The props you'll reach for: `value`, `labels`, `variant`.
27
+
28
+ ## When to use
29
+
30
+ - Beside a value people paste elsewhere: an ID, an API key, an invite link, a command, a colour.
31
+ - Icon-only beside the value; labelled (`children`) when it stands apart, or is a small panel's main action.
32
+ - In an `InputGroup`: `render={<InputGroupButton size="icon" />}`.
33
+ - For code, `CodeBlock` has one built in.
34
+
35
+ ## Examples
36
+
37
+ ### In an input group
38
+
39
+ An API key in a read-only `InputGroup`. The button takes `InputGroupButton`'s inset size and icon; CopyButton adds the click and the name.
40
+
41
+ ```tsx
42
+ import { CopyButton, Field, FieldDescription, FieldLabel, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@zonsh/ui";
43
+
44
+ export function ApiKey() {
45
+ const key = "zon_test_8Hq2Lm4Vx7PaR3sT";
46
+ return (
47
+ <Field className="w-full max-w-sm">
48
+ <FieldLabel>Test API key</FieldLabel>
49
+ <InputGroup>
50
+ <InputGroupInput readOnly value={key} className="font-mono text-[13px] pointer-coarse:text-base" />
51
+ <InputGroupAddon align="inline-end">
52
+ <CopyButton
53
+ value={key}
54
+ labels={{ copy: "Copy API key" }}
55
+ render={<InputGroupButton variant="ghost" size="icon" />}
56
+ />
57
+ </InputGroupAddon>
58
+ </InputGroup>
59
+ <FieldDescription>
60
+ Works against the test workspace only. Keep it out of your repository.
61
+ </FieldDescription>
62
+ </Field>
63
+ );
64
+ }
65
+ ```
66
+
67
+ ### Labelled
68
+
69
+ With children: a 30px labelled button whose label reads `labels.copied` for a moment, keeping the width of the longer label.
70
+
71
+ ```tsx
72
+ import { CopyButton } from "@zonsh/ui";
73
+
74
+ export function InviteLink() {
75
+ const link = "https://notes.example.com/join/garden-club";
76
+ return (
77
+ <div className="flex w-full max-w-md flex-col gap-3">
78
+ <div className="flex flex-col gap-1">
79
+ <span className="text-sm font-medium text-foreground">Invite to “Garden club”</span>
80
+ <span className="text-[13px] text-muted-foreground">
81
+ Anyone with the link can read and comment on the notebook.
82
+ </span>
83
+ </div>
84
+ <div className="flex items-center gap-2">
85
+ <span className="min-w-0 flex-1 truncate font-mono text-[13px] text-foreground-soft">{link}</span>
86
+ <CopyButton value={link} labels={{ copied: "Link copied" }}>
87
+ Copy link
88
+ </CopyButton>
89
+ </div>
90
+ </div>
91
+ );
92
+ }
93
+ ```
94
+
95
+ ### Ghost, in a list
96
+
97
+ `variant="ghost"` for dense rows. `value` can be a function, read at the click. It may return a promise, but a slow one can lose the click's permission to write, so prefer text you already have. If it throws or rejects: the cross, the announcement and `onError`.
98
+
99
+ ```tsx
100
+ import { CopyButton } from "@zonsh/ui";
101
+
102
+ export function Ghost() {
103
+ const commits = [
104
+ { sha: "9f3c2e1", message: "Fix the totals row in the export" },
105
+ { sha: "4b81d07", message: "Add the reading list to the course page" },
106
+ { sha: "e27a5c9", message: "Bump the image cache to a day" },
107
+ ];
108
+ return (
109
+ <ul className="m-0 flex w-full max-w-md list-none flex-col p-0">
110
+ {commits.map((commit) => (
111
+ <li
112
+ key={commit.sha}
113
+ className="flex items-center gap-3 border-b border-border/60 py-1.5 last:border-b-0"
114
+ >
115
+ <span className="font-mono text-xs text-muted-foreground tabular-nums">{commit.sha}</span>
116
+ <span className="min-w-0 flex-1 truncate text-sm">{commit.message}</span>
117
+ <CopyButton
118
+ variant="ghost"
119
+ value={() => commit.sha}
120
+ labels={{ copy: `Copy commit ${commit.sha}` }}
121
+ />
122
+ </li>
123
+ ))}
124
+ </ul>
125
+ );
126
+ }
127
+ ```
128
+
129
+ ## Props
130
+
131
+ | Prop | Type | Default |
132
+ | --------- | ------------------------------------------------------------------------------- | --------------------------------------- |
133
+ | `value` | `string \| () => string \| Promise<string>` — a function is read on the click | required |
134
+ | `labels` | `{ copy?, copied?, failed? }` | `"Copy"`, `"Copied"`, `"Couldn't copy"` |
135
+ | `timeout` | `number` — ms the check or cross stays | `1500` |
136
+ | `onCopy` | `(text) => void` | — |
137
+ | `onError` | `(error) => void` — the clipboard refused, or `value` threw or rejected | — |
138
+ | `variant` | `Button` variants | `"secondary"` |
139
+ | `size` | `Button` sizes | `"icon-sm"`, or `"sm"` with children |
140
+ | `render` | an element to draw instead of `Button`, e.g. `<InputGroupButton size="icon" />` | — |
141
+
142
+ Other `Button` props are forwarded. Data attributes: `data-copied` while the check shows, `data-copy-failed` after a failure; through `render` it keeps that element's `data-slot` and adds `data-copy-button`.
143
+
144
+ A `LocaleProvider` sets the three labels for every CopyButton (`messages.copyButton`); `labels` wins for one in particular.
145
+
146
+ ## Brand rules
147
+
148
+ - **Do** name what it copies: "Copy API key", "Copy invite link" — a page often has several.
149
+ - **Do** keep it beside the value it copies.
150
+ - **Don't** add a toast: the check and announcement confirm it.
151
+ - **Don't** make it the primary; copying is never a view's outcome.
152
+
153
+ ## Accessibility
154
+
155
+ - An icon-only button is named by `labels.copy` and keeps that name; after a click a polite live region says `labels.copied` (or `labels.failed`) once. A labelled one is named by its label.
156
+ - The icons are `aria-hidden`.
157
+ - A failure is shown with a cross and announced in words, never colour alone.
158
+
159
+ ---
160
+
161
+ - Import: `import { CopyButton } from "@zonsh/ui"`
162
+ - Source: `packages/ui/src/components/copy-button.tsx`