@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,146 @@
1
+ # Tool Call
2
+
3
+ ```tsx
4
+ import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
5
+ import { PackageSearchIcon } from "lucide-react";
6
+
7
+ /* Illustrative tool calls, not real data. */
8
+ const found = [
9
+ { order: "#1048", customer: "Ana Ruiz", items: 2, waitingFor: "Packing" },
10
+ { order: "#1051", customer: "Tom Becker", items: 1, waitingFor: "Stock" },
11
+ { order: "#1053", customer: "Mei Lin", items: 3, waitingFor: "Address check" },
12
+ ];
13
+
14
+ export function Basic() {
15
+ return (
16
+ <div className="w-full max-w-2xl">
17
+ <ToolCall name="search_orders" status="completed" icon={<PackageSearchIcon />} defaultOpen>
18
+ <ToolCallInput input={{ status: "not_shipped", limit: 10 }} />
19
+ <ToolCallOutput output={found} />
20
+ </ToolCall>
21
+ </div>
22
+ );
23
+ }
24
+ ```
25
+
26
+ A tool the model called, as a folding card: the name in mono, the status as a tag. Opened: the parameters and result as coloured code, or your own rendering.
27
+
28
+ ## Usage
29
+
30
+ ```tsx
31
+ import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
32
+
33
+ <ToolCall name="search_orders" status="completed">
34
+ <ToolCallInput input={part.input} />
35
+ <ToolCallOutput output={part.output} />
36
+ </ToolCall>;
37
+ ```
38
+
39
+ - `ToolCall.status` — pending, running, completed or error.
40
+ - `ToolCallOutput.output` — the result; `errorText` for a failure.
41
+ - `ToolCallInput.language` — colours a string input.
42
+
43
+ ## When to use
44
+
45
+ - One per tool used in a reply; thinking between tools is `Reasoning`.
46
+
47
+ ## Examples
48
+
49
+ ### States
50
+
51
+ A failed call shows its error in words, with an icon.
52
+
53
+ ```tsx
54
+ import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
55
+ import { MailIcon, PackageSearchIcon } from "lucide-react";
56
+
57
+ // found: as in the first example on this page that uses them.
58
+
59
+ export function States() {
60
+ return (
61
+ <div className="flex w-full max-w-2xl flex-col gap-3">
62
+ <ToolCall name="email_customer" status="pending" icon={<MailIcon />}>
63
+ <ToolCallInput input={{ order: "#1051", template: "back_in_stock_soon" }} />
64
+ </ToolCall>
65
+ <ToolCall name="search_orders" status="running" icon={<PackageSearchIcon />}>
66
+ <ToolCallInput input={{ status: "not_shipped" }} />
67
+ </ToolCall>
68
+ <ToolCall name="search_orders" status="completed" icon={<PackageSearchIcon />}>
69
+ <ToolCallInput input={{ status: "not_shipped" }} />
70
+ <ToolCallOutput output={found} />
71
+ </ToolCall>
72
+ <ToolCall name="refund_order" status="error" defaultOpen>
73
+ <ToolCallInput input={{ order: "#1046", amount: 24.9 }} />
74
+ <ToolCallOutput errorText="The payment provider did not answer. Nothing was refunded; the order is unchanged." />
75
+ </ToolCall>
76
+ </div>
77
+ );
78
+ }
79
+ ```
80
+
81
+ ### A command
82
+
83
+ A string shows as is; `language` colours it.
84
+
85
+ ```tsx
86
+ import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui";
87
+ import { TerminalIcon } from "lucide-react";
88
+
89
+ /** A command and what it printed: a string input in its own language. */
90
+ export function Command() {
91
+ return (
92
+ <div className="w-full max-w-2xl">
93
+ <ToolCall name="run_command" status="completed" icon={<TerminalIcon />} defaultOpen>
94
+ <ToolCallInput label="Command" language="bash" input={'git log --oneline -3 -- "src/orders"'} />
95
+ <ToolCallOutput
96
+ label="Output"
97
+ output={`a41c9e2 Hold back orders waiting for stock
98
+ 7d03b18 Show the packing step on the order page
99
+ c92f5a0 Check addresses before an order ships`}
100
+ />
101
+ </ToolCall>
102
+ </div>
103
+ );
104
+ }
105
+ ```
106
+
107
+ ## Props
108
+
109
+ | Component | Prop | Type | Default |
110
+ | ---------------- | ----------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------- |
111
+ | `ToolCall` | `name` | `string` | — |
112
+ | | `status` | `"pending" \| "running" \| "completed" \| "error"` | — |
113
+ | | `icon` | `ReactNode` — 14px | a wrench |
114
+ | | `labels` | `Partial<ToolCallMessages>` — the status labels, and `parameters`, `result` and `failure` for the headings | Pending · Running · Completed · Error |
115
+ | | `highlight` | `boolean` — colour the input and output as code | `true` |
116
+ | `ToolCallInput` | `input` | `unknown` — objects show as JSON | — |
117
+ | | `language` | `string` — for a string input, e.g. `"bash"` | — |
118
+ | | `label` | `ReactNode` — the heading | Parameters |
119
+ | `ToolCallOutput` | `output` | `unknown`, or `children` for your own rendering | — |
120
+ | | `errorText` | `string` | — |
121
+ | | `language` | `string` — for a string output, e.g. `"html"` | — |
122
+ | | `label` | `ReactNode` — the heading | Result, or Error with `errorText` |
123
+
124
+ `ToolCall` takes Base UI `Collapsible` props (`defaultOpen`, `open`); `data-status`. A `LocaleProvider` sets the labels (`messages.toolCall`).
125
+
126
+ ## Brand rules
127
+
128
+ - **Do** keep calls folded: they are for checking, not reading first.
129
+ - **Do** say in an error what it means: "Nothing was refunded; the order is unchanged."
130
+ - **Don't** colour pending or running.
131
+
132
+ ## Accessibility
133
+
134
+ - The header is a button with `aria-expanded`; the status is text in it, and the spinner announces its label. Errors use colour, an icon and words.
135
+
136
+ ### Keyboard
137
+
138
+ | Key | What it does |
139
+ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
140
+ | Enter / Space | Opens or closes the parameters and result from the header |
141
+ | Tab | Moves from the header into the open panel — its code blocks scroll with the arrow keys and have their copy buttons — or on to the next call |
142
+
143
+ ---
144
+
145
+ - Import: `import { ToolCall, ToolCallInput, ToolCallOutput } from "@zonsh/ui"`
146
+ - Source: `packages/ui/src/components/tool-call.tsx`
@@ -0,0 +1,260 @@
1
+ # Toolbar
2
+
3
+ ```tsx
4
+ import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
5
+ import { BoldIcon, ItalicIcon, LinkIcon, ListIcon, ListOrderedIcon, UnderlineIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ export function Formatting() {
9
+ const [marks, setMarks] = React.useState<Record<string, boolean>>({ bold: true });
10
+ const toggle = (key: string) => setMarks((m) => ({ ...m, [key]: !m[key] }));
11
+ return (
12
+ // In a narrow frame the link button keeps only its icon, so the toolbar stays on one line.
13
+ <div className="@container flex w-full justify-center">
14
+ <Toolbar aria-label="Formatting">
15
+ <ToolbarGroup aria-label="Text style">
16
+ <ToolbarButton aria-label="Bold" aria-pressed={!!marks.bold} onClick={() => toggle("bold")}>
17
+ <BoldIcon />
18
+ </ToolbarButton>
19
+ <ToolbarButton aria-label="Italic" aria-pressed={!!marks.italic} onClick={() => toggle("italic")}>
20
+ <ItalicIcon />
21
+ </ToolbarButton>
22
+ <ToolbarButton
23
+ aria-label="Underline"
24
+ aria-pressed={!!marks.underline}
25
+ onClick={() => toggle("underline")}
26
+ >
27
+ <UnderlineIcon />
28
+ </ToolbarButton>
29
+ </ToolbarGroup>
30
+ <ToolbarSeparator />
31
+ <ToolbarGroup aria-label="Lists">
32
+ <ToolbarButton aria-label="Bulleted list">
33
+ <ListIcon />
34
+ </ToolbarButton>
35
+ <ToolbarButton aria-label="Numbered list">
36
+ <ListOrderedIcon />
37
+ </ToolbarButton>
38
+ </ToolbarGroup>
39
+ <ToolbarSeparator />
40
+ <ToolbarButton aria-label="Insert link">
41
+ <LinkIcon />
42
+ <span className="hidden @[20rem]:inline">Insert link</span>
43
+ </ToolbarButton>
44
+ </Toolbar>
45
+ </div>
46
+ );
47
+ }
48
+ ```
49
+
50
+ A dense row of related commands on a 12px surface. 30px buttons are flat and muted; hover brightens the label, and a button that is on (`aria-pressed`) rises. Hairlines split groups. The toolbar is one Tab stop; arrows move inside.
51
+
52
+ ## Usage
53
+
54
+ ```tsx
55
+ import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
56
+
57
+ <Toolbar aria-label="Formatting">
58
+ <ToolbarGroup>
59
+ <ToolbarButton aria-label="Bold">
60
+ <BoldIcon />
61
+ </ToolbarButton>
62
+ <ToolbarButton aria-label="Italic">
63
+ <ItalicIcon />
64
+ </ToolbarButton>
65
+ </ToolbarGroup>
66
+ <ToolbarSeparator />
67
+ <ToolbarButton>Insert link</ToolbarButton>
68
+ </Toolbar>;
69
+ ```
70
+
71
+ - `aria-pressed` — a toggle that rises while on.
72
+ - `overflow` — fold what doesn't fit into "…".
73
+ - `orientation` — `"vertical"` for a tool rail.
74
+
75
+ ## When to use
76
+
77
+ - Repeated commands on one thing: formatting, acting on selected rows.
78
+ - Not for navigation or a single action.
79
+
80
+ ## Examples
81
+
82
+ ### Table actions
83
+
84
+ Text buttons for table actions.
85
+
86
+ ```tsx
87
+ import { Toolbar, ToolbarButton, ToolbarSeparator } from "@zonsh/ui";
88
+
89
+ export function TableActions() {
90
+ return (
91
+ <Toolbar aria-label="Selected rows">
92
+ <ToolbarButton>Assign</ToolbarButton>
93
+ <ToolbarButton>Export CSV</ToolbarButton>
94
+ <ToolbarSeparator />
95
+ <ToolbarButton disabled>Archive</ToolbarButton>
96
+ </Toolbar>
97
+ );
98
+ }
99
+ ```
100
+
101
+ ### Toggles
102
+
103
+ Name each group of toggles.
104
+
105
+ ```tsx
106
+ <ToolbarGroup aria-label="Text style">
107
+ <ToolbarButton aria-label="Bold" aria-pressed={bold} onClick={() => setBold(!bold)}>
108
+ <BoldIcon />
109
+ </ToolbarButton>
110
+ <ToolbarButton aria-label="Italic" aria-pressed={italic} onClick={() => setItalic(!italic)}>
111
+ <ItalicIcon />
112
+ </ToolbarButton>
113
+ </ToolbarGroup>
114
+ ```
115
+
116
+ ### A menu in the toolbar
117
+
118
+ `render` makes a button a `Menu` trigger in the arrow-key order; Enter, Space or ↓ opens it.
119
+
120
+ ```tsx
121
+ <Toolbar aria-label="Document">
122
+ <ToolbarButton>Share</ToolbarButton>
123
+ <Menu>
124
+ <ToolbarButton render={<MenuTrigger />}>
125
+ Export
126
+ <ChevronDownIcon />
127
+ </ToolbarButton>
128
+ <MenuContent>
129
+ <MenuItem>PDF</MenuItem>
130
+ <MenuItem>Markdown</MenuItem>
131
+ </MenuContent>
132
+ </Menu>
133
+ </Toolbar>
134
+ ```
135
+
136
+ ### Vertical
137
+
138
+ Stacks the buttons; arrows become ↑ and ↓.
139
+
140
+ ```tsx
141
+ <Toolbar aria-label="Tools" orientation="vertical">
142
+ <ToolbarButton aria-label="Select"><MousePointer2Icon /></ToolbarButton>
143
+ <ToolbarButton aria-label="Draw"><PencilIcon /></ToolbarButton>
144
+ <ToolbarSeparator />
145
+ <ToolbarButton aria-label="Erase"><EraserIcon /></ToolbarButton>
146
+ </Toolbar>
147
+ ```
148
+
149
+ ### Overflow
150
+
151
+ Buttons that don't fit move into a "…" menu with their names and shortcuts, toggles as checked items. `overflowPriority`: lower goes first, then from the end; `false` stays. Narrow the frame to see it.
152
+
153
+ ```tsx
154
+ import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui";
155
+ import { BoldIcon, CodeIcon, ItalicIcon, LinkIcon, ListChecksIcon, ListIcon, ListOrderedIcon, QuoteIcon, StrikethroughIcon, UnderlineIcon } from "lucide-react";
156
+ import * as React from "react";
157
+
158
+ export function Overflow() {
159
+ const [marks, setMarks] = React.useState<Record<string, boolean>>({});
160
+ const toggle = (key: string) => setMarks((m) => ({ ...m, [key]: !m[key] }));
161
+ const mark = (
162
+ key: string,
163
+ label: string,
164
+ Icon: typeof BoldIcon,
165
+ shortcut?: string[],
166
+ priority?: number,
167
+ ) => (
168
+ <ToolbarButton
169
+ aria-label={label}
170
+ aria-pressed={!!marks[key]}
171
+ onClick={() => toggle(key)}
172
+ overflowShortcut={shortcut}
173
+ overflowPriority={priority}
174
+ >
175
+ <Icon />
176
+ </ToolbarButton>
177
+ );
178
+ return (
179
+ // The frame is resizable: narrow it and the commands at the end move into "…".
180
+ <div className="w-full max-w-md min-w-0 resize-x overflow-hidden p-1">
181
+ <Toolbar aria-label="Formatting" overflow>
182
+ <ToolbarGroup aria-label="Text style">
183
+ {mark("bold", "Bold", BoldIcon, ["mod", "B"], 2)}
184
+ {mark("italic", "Italic", ItalicIcon, ["mod", "I"], 2)}
185
+ {mark("underline", "Underline", UnderlineIcon, ["mod", "U"], 1)}
186
+ {mark("strike", "Strikethrough", StrikethroughIcon, ["mod", "shift", "X"])}
187
+ {mark("code", "Code", CodeIcon, ["mod", "E"])}
188
+ </ToolbarGroup>
189
+ <ToolbarSeparator />
190
+ <ToolbarGroup aria-label="Blocks">
191
+ <ToolbarButton aria-label="Bulleted list" overflowPriority={1}>
192
+ <ListIcon />
193
+ </ToolbarButton>
194
+ <ToolbarButton aria-label="Numbered list">
195
+ <ListOrderedIcon />
196
+ </ToolbarButton>
197
+ <ToolbarButton aria-label="To-do list">
198
+ <ListChecksIcon />
199
+ </ToolbarButton>
200
+ <ToolbarButton aria-label="Quote">
201
+ <QuoteIcon />
202
+ </ToolbarButton>
203
+ </ToolbarGroup>
204
+ <ToolbarSeparator />
205
+ <ToolbarButton aria-label="Insert link" overflowPriority={1}>
206
+ <LinkIcon />
207
+ </ToolbarButton>
208
+ </Toolbar>
209
+ </div>
210
+ );
211
+ }
212
+ ```
213
+
214
+ ## Props
215
+
216
+ | Prop | Type | Default |
217
+ | ------------------------------------- | ------------------------------------------------ | -------------- |
218
+ | `Toolbar.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
219
+ | `Toolbar.loopFocus` | `boolean` | `true` |
220
+ | `Toolbar.disabled` | `boolean` | — |
221
+ | `Toolbar.overflow` | `boolean`: fold what doesn't fit into "…" | `false` |
222
+ | `Toolbar.variant` | `"surface" \| "plain"`: `plain` for a row inside another surface | `"surface"` |
223
+ | `Toolbar.labels` | `{ more?: string }`: the "…" button's name | English |
224
+ | `ToolbarButton.overflowPriority` | `number \| false`: lower folds first; `false` never | `0` |
225
+ | `ToolbarButton.overflowLabel` | `string`: its name in the "…" menu | `aria-label` |
226
+ | `ToolbarButton.overflowShortcut` | `string[]`: `KbdShortcut` keys in the "…" menu | — |
227
+ | `ToolbarButton.disabled` | `boolean` | `false` |
228
+ | `ToolbarButton.focusableWhenDisabled` | `boolean` | `true` |
229
+ | `ToolbarButton.render` | `ReactElement` — e.g. a `Toggle` or menu trigger | — |
230
+ | `ToolbarGroup.disabled` | `boolean` | `false` |
231
+
232
+ Other Base UI `Toolbar` props are forwarded. A `LocaleProvider` sets `labels` for every Toolbar (`messages.toolbar`).
233
+
234
+ ## Brand rules
235
+
236
+ - **Do** keep everything at 30px (`size="sm"`).
237
+ - **Do** separate groups with `ToolbarSeparator`.
238
+ - **Don't** fill pressed buttons; set `aria-pressed`.
239
+ - **Don't** add a hover fill; raised means "on".
240
+ - **Don't** put the page's primary action in a toolbar.
241
+
242
+ ## Accessibility
243
+
244
+ - Label the toolbar and icon-only buttons.
245
+ - Disabled buttons stay focusable and hoverable, so a tooltip can say why; clicks are inert.
246
+ - The "…" button is named "More"; its items carry names and toggle states.
247
+
248
+ ### Keyboard
249
+
250
+ | Key | What it does |
251
+ | ------------- | ------------------------------------------------------------------------------------------------------- |
252
+ | ← / → | Moves to the previous or next control, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
253
+ | Enter / Space | Presses the focused button, or opens the "…" menu |
254
+ | Tab | Leaves the toolbar: it is one Tab stop |
255
+
256
+ ---
257
+
258
+ - Import: `import { Toolbar, ToolbarButton, ToolbarGroup, ToolbarSeparator } from "@zonsh/ui"`
259
+ - Source: `packages/ui/src/components/toolbar.tsx`
260
+ - Primitive: `@base-ui/react/toolbar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toolbar.md`)
@@ -0,0 +1,172 @@
1
+ # Tooltip
2
+
3
+ ```tsx
4
+ import { Button, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@zonsh/ui";
5
+ import { CopyIcon, DownloadIcon, Share2Icon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <TooltipProvider>
10
+ <div className="flex gap-2">
11
+ {[
12
+ { label: "Copy link", icon: <CopyIcon /> },
13
+ { label: "Download PDF", icon: <DownloadIcon /> },
14
+ { label: "Share project", icon: <Share2Icon /> },
15
+ ].map(({ label, icon }) => (
16
+ <Tooltip key={label}>
17
+ <TooltipTrigger render={<Button variant="secondary" size="icon" aria-label={label} />}>
18
+ {icon}
19
+ </TooltipTrigger>
20
+ <TooltipContent>{label}</TooltipContent>
21
+ </Tooltip>
22
+ ))}
23
+ </div>
24
+ </TooltipProvider>
25
+ );
26
+ }
27
+ ```
28
+
29
+ A label for a control with no visible text: `material-menu` at 7px, 12px Licht Mono (or Licht Sans with `variant="text"`). It opens after 150ms; under one `TooltipProvider`, once one is open its neighbours open at once.
30
+
31
+ ## Usage
32
+
33
+ ```tsx
34
+ import { Button, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@zonsh/ui";
35
+
36
+ <TooltipProvider>
37
+ <Tooltip>
38
+ <TooltipTrigger render={<Button variant="secondary" size="icon" aria-label="Copy link" />}>
39
+ <CopyIcon />
40
+ </TooltipTrigger>
41
+ <TooltipContent>Copy link</TooltipContent>
42
+ </Tooltip>
43
+ </TooltipProvider>;
44
+ ```
45
+
46
+ - `TooltipContent.side` — where it opens.
47
+ - `TooltipContent.variant` — `"text"` for a short sentence.
48
+ - `TooltipTrigger.delay` — the wait before opening, in ms.
49
+
50
+ ## When to use
51
+
52
+ - Naming icon-only buttons; a shortcut or exact value beside a control.
53
+ - Not for anything people must read or click (touch has no tooltips): use a `Popover` or the page.
54
+
55
+ ## Examples
56
+
57
+ ### Text variant
58
+
59
+ ```tsx
60
+ import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@zonsh/ui";
61
+
62
+ export function TextVariant() {
63
+ return (
64
+ <Tooltip>
65
+ <TooltipTrigger render={<Button variant="ghost" />}>Opening hours</TooltipTrigger>
66
+ <TooltipContent variant="text" side="bottom">
67
+ Monday to Friday, 9:00 to 18:00.
68
+ </TooltipContent>
69
+ </Tooltip>
70
+ );
71
+ }
72
+ ```
73
+
74
+ ### Delayed
75
+
76
+ A longer `delay` for controls people pass over (text links, a dense table); `delay={0}` for a label people look for every time. Here: 0, 150 (default) and 700ms.
77
+
78
+ ```tsx
79
+ import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@zonsh/ui";
80
+
81
+ export function Delayed() {
82
+ return (
83
+ <div className="flex flex-wrap gap-3">
84
+ <Tooltip>
85
+ <TooltipTrigger delay={0} render={<Button variant="secondary" />}>
86
+ Instant
87
+ </TooltipTrigger>
88
+ <TooltipContent>Opens at once</TooltipContent>
89
+ </Tooltip>
90
+ <Tooltip>
91
+ <TooltipTrigger render={<Button variant="secondary" />}>Quick</TooltipTrigger>
92
+ <TooltipContent>Opens after 150ms</TooltipContent>
93
+ </Tooltip>
94
+ <Tooltip>
95
+ <TooltipTrigger delay={700} render={<Button variant="secondary" />}>
96
+ Delayed
97
+ </TooltipTrigger>
98
+ <TooltipContent>Opens after 700ms</TooltipContent>
99
+ </Tooltip>
100
+ </div>
101
+ );
102
+ }
103
+ ```
104
+
105
+ ### With arrow
106
+
107
+ ```tsx
108
+ import { Button, formatShortcut, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, useShortcutKeys } from "@zonsh/ui";
109
+
110
+ /** "Copy" as the device writes it: ⌘C on Apple, Ctrl+C elsewhere. */
111
+ function CopyShortcut() {
112
+ const { mod } = useShortcutKeys();
113
+ return <>{formatShortcut(["mod", "C"], mod)}</>;
114
+ }
115
+
116
+ export function WithArrow() {
117
+ return (
118
+ <TooltipProvider>
119
+ <div className="flex flex-wrap gap-3">
120
+ {(["left", "top", "bottom", "right"] as const).map((side) => (
121
+ <Tooltip key={side}>
122
+ <TooltipTrigger render={<Button variant="secondary" size="sm" />}>{side}</TooltipTrigger>
123
+ <TooltipContent side={side} arrow>
124
+ <CopyShortcut />
125
+ </TooltipContent>
126
+ </Tooltip>
127
+ ))}
128
+ </div>
129
+ </TooltipProvider>
130
+ );
131
+ }
132
+ ```
133
+
134
+ ## Props
135
+
136
+ | Prop | Type | Default |
137
+ | -------------------------------------- | ------------------------------------------ | ------------------------ |
138
+ | `TooltipProvider.delay` | `number` (ms) | `150` |
139
+ | `TooltipProvider.closeDelay` | `number` (ms) | `0` |
140
+ | `TooltipProvider.timeout` | `number` (ms) — window for instant re-open | `400` |
141
+ | `TooltipContent.variant` | `"mono" \| "text"` | `"mono"` |
142
+ | `TooltipContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"top"` |
143
+ | `TooltipContent.align` | `"start" \| "center" \| "end"` | `"center"` |
144
+ | `TooltipContent.sideOffset` | `number` | `6` |
145
+ | `TooltipContent.arrow` | `boolean` | `false` |
146
+ | `TooltipContent.positioner` / `portal` | Base UI positioner / portal props | — |
147
+ | `TooltipTrigger.delay` / `closeDelay` | per-trigger override | provider, or `150` / `0` |
148
+
149
+ `Tooltip` is Base UI `Tooltip.Root` (`open`, `onOpenChange`, `disabled`, `trackCursorAxis` …). Data attributes: `data-variant` on the popup.
150
+
151
+ ## Brand rules
152
+
153
+ - **Do** keep it to a few words, under one `TooltipProvider` per app or toolbar.
154
+ - **Don't** put links, buttons or essential information in it, or repeat a button's visible label.
155
+
156
+ ## Accessibility
157
+
158
+ - Opens on hover and focus. It describes its trigger, not names it: icon-only triggers still need `aria-label`.
159
+ - To explain a disabled button, set `focusableWhenDisabled` on it so it can be hovered and focused; clicks still do nothing.
160
+
161
+ ### Keyboard
162
+
163
+ | Key | What it does |
164
+ | ------ | ------------------------------------------------------------------- |
165
+ | Tab | Focusing the trigger opens its tooltip; moving focus away closes it |
166
+ | Escape | Closes the tooltip; focus stays on the trigger |
167
+
168
+ ---
169
+
170
+ - Import: `import { TooltipProvider, Tooltip, TooltipTrigger, TooltipContent } from "@zonsh/ui"`
171
+ - Source: `packages/ui/src/components/tooltip.tsx`
172
+ - Primitive: `@base-ui/react/tooltip` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/tooltip.md`)