@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,258 @@
1
+ # Tabs
2
+
3
+ ```tsx
4
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
5
+
6
+ export function Segmented() {
7
+ return (
8
+ <Tabs defaultValue="details" className="max-w-xl">
9
+ <TabsList>
10
+ <TabsTab value="details">Details</TabsTab>
11
+ <TabsTab value="sizing">Sizing</TabsTab>
12
+ <TabsTab value="care">Care</TabsTab>
13
+ </TabsList>
14
+ <TabsPanel value="details" className="flex min-h-24 flex-col gap-2">
15
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Waxed cotton jacket</h3>
16
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
17
+ A light, water-resistant jacket with two deep pockets and a collar that turns up against the wind.
18
+ </p>
19
+ </TabsPanel>
20
+ <TabsPanel value="sizing" className="flex min-h-24 flex-col gap-2">
21
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">A relaxed fit</h3>
22
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
23
+ Cut with room for a jumper underneath. If you are between sizes, take the smaller one; the model is
24
+ 182cm and wears a medium.
25
+ </p>
26
+ </TabsPanel>
27
+ <TabsPanel value="care" className="flex min-h-24 flex-col gap-2">
28
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Wipe, don't wash</h3>
29
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
30
+ Sponge off dirt with cold water and let it dry at room temperature. Re-wax once a year.
31
+ </p>
32
+ </TabsPanel>
33
+ </Tabs>
34
+ );
35
+ }
36
+ ```
37
+
38
+ Related panels, one visible at a time. **Segmented** (default): a recessed 38px track whose raised segment slides to the active tab (`--active-tab-left`, `--active-tab-width`), like `ToggleGroup`. **Underline**: mono labels on a hairline with a 1px indicator. A list too long for its row scrolls sideways without a scrollbar, keeping the active and focused tabs in view.
39
+
40
+ ## Usage
41
+
42
+ ```tsx
43
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
44
+
45
+ <Tabs defaultValue="details">
46
+ <TabsList>
47
+ <TabsTab value="details">Details</TabsTab>
48
+ <TabsTab value="sizing">Sizing</TabsTab>
49
+ </TabsList>
50
+ <TabsPanel value="details">…</TabsPanel>
51
+ <TabsPanel value="sizing">…</TabsPanel>
52
+ </Tabs>;
53
+ ```
54
+
55
+ - `Tabs.defaultValue` — the tab shown first (or `value` + `onValueChange`).
56
+ - `TabsTab.value` — matches its `TabsPanel`.
57
+ - `TabsList.variant` — `"segmented"` or `"underline"`.
58
+
59
+ ## When to use
60
+
61
+ - Two to six views of one subject: "Details / Sizing / Care".
62
+ - `segmented` in product UI; `underline` on marketing and content pages.
63
+ - Not for site navigation (`NavigationMenu`, `Sidebar`) or form values (`ToggleGroup`, `Select`).
64
+
65
+ ## Examples
66
+
67
+ ### Underline
68
+
69
+ ```tsx
70
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
71
+
72
+ export function Underline() {
73
+ return (
74
+ <Tabs defaultValue="overview" className="max-w-xl">
75
+ <TabsList variant="underline">
76
+ <TabsTab value="overview">Overview</TabsTab>
77
+ <TabsTab value="install">Install</TabsTab>
78
+ <TabsTab value="usage">Usage</TabsTab>
79
+ </TabsList>
80
+ <TabsPanel value="overview" className="flex min-h-24 flex-col gap-2">
81
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">What the CLI does</h3>
82
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
83
+ It creates a project, runs it locally and deploys a preview of every branch you push.
84
+ </p>
85
+ </TabsPanel>
86
+ <TabsPanel value="install" className="flex min-h-24 flex-col gap-2">
87
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">One command</h3>
88
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
89
+ Install it with your package manager, then sign in once from the terminal.
90
+ </p>
91
+ </TabsPanel>
92
+ <TabsPanel value="usage" className="flex min-h-24 flex-col gap-2">
93
+ <h3 className="m-0 display text-[24px] leading-[1.1] text-foreground">Day to day</h3>
94
+ <p className="m-0 text-[15px] leading-relaxed text-foreground-soft">
95
+ Run it in a project folder to start the dev server; add a flag to deploy instead.
96
+ </p>
97
+ </TabsPanel>
98
+ </Tabs>
99
+ );
100
+ }
101
+ ```
102
+
103
+ ### Vertical
104
+
105
+ The arrow keys follow the orientation.
106
+
107
+ ```tsx
108
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
109
+
110
+ export function Vertical() {
111
+ return (
112
+ <div className="@container w-full">
113
+ <div className="grid gap-12 @lg:grid-cols-2">
114
+ <Tabs defaultValue="account" orientation="vertical">
115
+ <TabsList>
116
+ <TabsTab value="account">Account</TabsTab>
117
+ <TabsTab value="team">Team</TabsTab>
118
+ <TabsTab value="billing">Billing</TabsTab>
119
+ </TabsList>
120
+ <TabsPanel value="account" className="text-[15px] text-foreground-soft">
121
+ Profile and sign-in.
122
+ </TabsPanel>
123
+ <TabsPanel value="team" className="text-[15px] text-foreground-soft">
124
+ Who can see this workspace.
125
+ </TabsPanel>
126
+ <TabsPanel value="billing" className="text-[15px] text-foreground-soft">
127
+ Plan, receipts and payment method.
128
+ </TabsPanel>
129
+ </Tabs>
130
+ <Tabs defaultValue="basics" orientation="vertical">
131
+ <TabsList variant="underline">
132
+ <TabsTab value="basics">01 Basics</TabsTab>
133
+ <TabsTab value="layout">02 Layout</TabsTab>
134
+ <TabsTab value="colour">03 Colour</TabsTab>
135
+ </TabsList>
136
+ <TabsPanel value="basics" className="text-[15px] text-foreground-soft">
137
+ Line length, leading and a type scale.
138
+ </TabsPanel>
139
+ <TabsPanel value="layout" className="text-[15px] text-foreground-soft">
140
+ Grids, margins and white space.
141
+ </TabsPanel>
142
+ <TabsPanel value="colour" className="text-[15px] text-foreground-soft">
143
+ Contrast, palettes and when to hold back.
144
+ </TabsPanel>
145
+ </Tabs>
146
+ </div>
147
+ </div>
148
+ );
149
+ }
150
+ ```
151
+
152
+ ### Disabled
153
+
154
+ A disabled tab stays in the arrow-key order, so it is read out; say why on the page.
155
+
156
+ ```tsx
157
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
158
+
159
+ export function Disabled() {
160
+ return (
161
+ <Tabs defaultValue="summary" className="max-w-xl">
162
+ <TabsList>
163
+ <TabsTab value="summary">Summary</TabsTab>
164
+ <TabsTab value="files">Files</TabsTab>
165
+ <TabsTab value="results" disabled>
166
+ Results
167
+ </TabsTab>
168
+ </TabsList>
169
+ <TabsPanel value="summary" className="flex min-h-24 flex-col gap-2">
170
+ <h3 className="m-0 display text-24 leading-[1.1] text-foreground">Soil survey, plot 7</h3>
171
+ <p className="m-0 text-15 leading-relaxed text-foreground-soft">
172
+ Samples were taken on 12 September. Results open once the lab has checked them, in about two weeks.
173
+ </p>
174
+ </TabsPanel>
175
+ <TabsPanel value="files" className="flex min-h-24 flex-col gap-2">
176
+ <h3 className="m-0 display text-24 leading-[1.1] text-foreground">Field notes and photos</h3>
177
+ <p className="m-0 text-15 leading-relaxed text-foreground-soft">
178
+ Six photos and the sampling sheet, as uploaded from the field.
179
+ </p>
180
+ </TabsPanel>
181
+ <TabsPanel value="results" />
182
+ </Tabs>
183
+ );
184
+ }
185
+ ```
186
+
187
+ ### More tabs than fit
188
+
189
+ A list wider than its room scrolls sideways, and its ends fade where there is more to scroll, as a `ScrollArea`'s do; the active tab is kept in view, clear of the fade.
190
+
191
+ ```tsx
192
+ import { Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
193
+
194
+ export function Overflow() {
195
+ const sections = ["Overview", "Lessons", "Assignments", "Discussion", "Grades", "Resources", "People"];
196
+ return (
197
+ <Tabs defaultValue="overview" className="max-w-72">
198
+ <TabsList variant="underline">
199
+ {sections.map((name) => (
200
+ <TabsTab key={name} value={name.toLowerCase()}>
201
+ {name}
202
+ </TabsTab>
203
+ ))}
204
+ </TabsList>
205
+ {sections.map((name) => (
206
+ <TabsPanel key={name} value={name.toLowerCase()} className="text-[15px] text-foreground-soft">
207
+ {name} of the course, Introduction to statistics.
208
+ </TabsPanel>
209
+ ))}
210
+ </Tabs>
211
+ );
212
+ }
213
+ ```
214
+
215
+ ## Props
216
+
217
+ | Prop | Type | Default |
218
+ | -------------------------- | ---------------------------- | -------------- |
219
+ | `TabsList.variant` | `"segmented" \| "underline"` | `"segmented"` |
220
+ | `Tabs.defaultValue` | `any` | `0` |
221
+ | `Tabs.value` | `any` — controlled | — |
222
+ | `Tabs.onValueChange` | `(value, details) => void` | — |
223
+ | `Tabs.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
224
+ | `TabsList.activateOnFocus` | `boolean` | `false` |
225
+ | `TabsTab.value` | `any` — required | — |
226
+ | `TabsTab.disabled` | `boolean` | `false` |
227
+ | `TabsPanel.keepMounted` | `boolean` | `false` |
228
+
229
+ The root is full width, so tabs never move on switching. Other Base UI props are forwarded. Data attributes: `data-variant` (list), `data-active` (tab), `data-orientation`.
230
+
231
+ ## Brand rules
232
+
233
+ - **Do** keep labels short and parallel nouns.
234
+ - **Do** give panels a shared minimum height (`min-h-24`) so content below does not jump.
235
+ - **Don't** mark the active tab with a flat fill or bold; the indicator is the state.
236
+ - **Don't** add an icon or badge to every tab.
237
+ - **Don't** hide content people must compare: put it side by side.
238
+
239
+ ## Accessibility
240
+
241
+ - `role="tablist"`, `role="tab"`, `aria-selected`, `aria-controls`; a flush 2px `--control-focus` outline on the tab and a focused panel.
242
+
243
+ ### Keyboard
244
+
245
+ | Key | What it does |
246
+ | ------------- | --------------------------------------------------------------------------------------------------------- |
247
+ | ← / → | Moves focus to the previous or next tab, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
248
+ | Home / End | Moves focus to the first or last tab |
249
+ | Enter / Space | Shows the focused tab's panel |
250
+ | Tab | Leaves the list for the panel: the list is one Tab stop, on the current tab |
251
+
252
+ With `activateOnFocus`, moving focus shows the panel at once.
253
+
254
+ ---
255
+
256
+ - Import: `import { Tabs, TabsList, TabsTab, TabsPanel } from "@zonsh/ui"`
257
+ - Source: `packages/ui/src/components/tabs.tsx`
258
+ - Primitive: `@base-ui/react/tabs` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/tabs.md`)
@@ -0,0 +1,115 @@
1
+ # Tag
2
+
3
+ ```tsx
4
+ import { Tag } from "@zonsh/ui";
5
+
6
+ export function Variants() {
7
+ return (
8
+ <div className="flex flex-wrap items-center gap-2">
9
+ <Tag>TypeScript</Tag>
10
+ <Tag variant="muted">Internal tool</Tag>
11
+ <Tag variant="outline">Integration</Tag>
12
+ <Tag tone="info">New</Tag>
13
+ <Tag tone="destructive">Error</Tag>
14
+ </div>
15
+ );
16
+ }
17
+ ```
18
+
19
+ A 22px label in Licht Mono 11px on a raised key surface, 7px corners. Tones are tints: the colour's ink, deepened for 4.5:1, on a 10% wash in a 30% edge. Labels, not controls: no hover.
20
+
21
+ ## Usage
22
+
23
+ ```tsx
24
+ import { Tag } from "@zonsh/ui";
25
+
26
+ <Tag>TypeScript</Tag>
27
+ <Tag variant="muted" dot>Draft</Tag>
28
+ ```
29
+
30
+ - `variant` — `default`, `muted`, `outline` (on raised surfaces).
31
+ - `tone` — a status or category tint.
32
+ - `dot` — a leading status dot.
33
+
34
+ ## When to use
35
+
36
+ - Metadata by a title or in a cell: "TypeScript", "Draft".
37
+ - A status `tone` (`success`, `warning`, `info`, `destructive`) for a state: "Published", "Failed".
38
+ - A category `tone` (`blue`, `aqua`, `violet`, `magenta`, `orange`, `lime`) for kinds people tell apart at a glance, one tone per kind across the app.
39
+ - Not for actions or filters: `Button` or `ToggleGroup`.
40
+
41
+ ## Examples
42
+
43
+ ### Status
44
+
45
+ ```tsx
46
+ import { Tag } from "@zonsh/ui";
47
+
48
+ export function Status() {
49
+ return (
50
+ <div className="flex flex-wrap items-center gap-2">
51
+ <Tag dot>Running</Tag>
52
+ <Tag dot variant="muted">
53
+ Paused
54
+ </Tag>
55
+ <Tag dot tone="success">
56
+ Published
57
+ </Tag>
58
+ <Tag dot tone="warning">
59
+ Expires in 3 days
60
+ </Tag>
61
+ <Tag dot tone="info">
62
+ Syncing
63
+ </Tag>
64
+ <Tag dot tone="destructive">
65
+ Failed
66
+ </Tag>
67
+ </div>
68
+ );
69
+ }
70
+ ```
71
+
72
+ ### Category tones
73
+
74
+ ```tsx
75
+ import { Tag } from "@zonsh/ui";
76
+
77
+ export function Tones() {
78
+ return (
79
+ <div className="flex flex-wrap items-center gap-2">
80
+ <Tag tone="blue">Document</Tag>
81
+ <Tag tone="orange">Spreadsheet</Tag>
82
+ <Tag tone="aqua">Image</Tag>
83
+ <Tag tone="magenta">Audio</Tag>
84
+ <Tag tone="lime">Archive</Tag>
85
+ <Tag tone="violet">Video</Tag>
86
+ </div>
87
+ );
88
+ }
89
+ ```
90
+
91
+ ## Props
92
+
93
+ | Prop | Type | Default |
94
+ | --------- | ---------------------------------------------------- | ----------- |
95
+ | `variant` | `"default" \| "muted" \| "outline"` | `"default"` |
96
+ | `tone` | status `"success" \| "warning" \| "info" \| "destructive"` · category `"blue" \| "aqua" \| "violet" \| "magenta" \| "orange" \| "lime"` | — |
97
+ | `dot` | `boolean` — 6px dot in the current ink | `false` |
98
+
99
+ Those three are all it adds: `<span>` props are forwarded, and there is no `size` (one height, 22px) and no `render` (a tag is always a `<span>`, never a link or a button; link the row's title beside it instead). Icons inside are 12px. Text (one `tag-text` span) truncates with "…" rather than overflow; `min-w-0` lets a tag shrink in a row.
100
+
101
+ ## Brand rules
102
+
103
+ - **Do** keep text short, mixed case; keep most tags grey.
104
+ - **Don't** colour for decoration or give a tone two meanings.
105
+ - **Don't** use `destructive` for "important": it means failed.
106
+ - **Don't** make tags clickable; use `Button size="sm"`.
107
+
108
+ ## Accessibility
109
+
110
+ - Meaning lives in the text ("Failed"), not only the colour or dot; the dot is `aria-hidden`.
111
+
112
+ ---
113
+
114
+ - Import: `import { Tag } from "@zonsh/ui"`
115
+ - Source: `packages/ui/src/components/tag.tsx`
@@ -0,0 +1,216 @@
1
+ # Tags Input
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="w-full max-w-md">
9
+ <FieldLabel>Topics</FieldLabel>
10
+ <TagsInput name="topics" defaultValue={["typography", "accessibility"]} placeholder="Add a topic" />
11
+ <FieldDescription>Press Enter or type a comma after each one.</FieldDescription>
12
+ </Field>
13
+ );
14
+ }
15
+ ```
16
+
17
+ One recessed 38px field (30px dense) holding typed values as raised chips — a multiple `Combobox`'s own — then the text input; it grows a row at a time. Enter or a comma adds a tag, a pasted list adds them all, Backspace twice removes the last. Text left typed is added on blur; a duplicate (any case) lights up the existing tag instead.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Field, FieldLabel, TagsInput } from "@zonsh/ui";
23
+
24
+ <Field>
25
+ <FieldLabel>Topics</FieldLabel>
26
+ <TagsInput name="topics" defaultValue={["typography"]} placeholder="Add a topic" />
27
+ </Field>;
28
+ ```
29
+
30
+ - `value` / `defaultValue` — the tags, a `string[]`.
31
+ - `validate` — returns `false` for a tag that doesn't fit; it is kept and marked.
32
+ - `max` — caps the number of tags.
33
+
34
+ ## When to use
35
+
36
+ - Values people type: topics, keywords, emails to invite, allowed domains.
37
+ - Values from a known list: a multiple `Combobox`, which only accepts what's in it. One value: `Input`.
38
+
39
+ ## Examples
40
+
41
+ ### Validation
42
+
43
+ An invalid tag is kept, in red ink with a red edge and an alert icon, read as "invalid"; the field takes `aria-invalid`. Say what is wrong in a `FieldError`.
44
+
45
+ ```tsx
46
+ import { Field, FieldDescription, FieldError, FieldLabel, TagsInput } from "@zonsh/ui";
47
+ import * as React from "react";
48
+
49
+ const isEmail = (tag: string) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(tag);
50
+
51
+ export function Emails() {
52
+ const [emails, setEmails] = React.useState(["mira@example.com", "jonas@example", "ade@example.org"]);
53
+ const wrong = emails.filter((e) => !isEmail(e));
54
+ return (
55
+ <Field invalid={wrong.length > 0} className="w-full max-w-md">
56
+ <FieldLabel>Invite to the workspace</FieldLabel>
57
+ <TagsInput
58
+ name="invite"
59
+ value={emails}
60
+ onValueChange={setEmails}
61
+ validate={isEmail}
62
+ placeholder="name@example.com"
63
+ inputMode="email"
64
+ />
65
+ {wrong.length > 0 ? (
66
+ <FieldError match>
67
+ {wrong.length === 1
68
+ ? `${wrong[0]} isn't a full email address. Fix it or remove it before sending.`
69
+ : `${wrong.length} addresses aren't complete. Fix them or remove them before sending.`}
70
+ </FieldError>
71
+ ) : (
72
+ <FieldDescription>Paste a list separated by commas to add them all.</FieldDescription>
73
+ )}
74
+ </Field>
75
+ );
76
+ }
77
+ ```
78
+
79
+ ### Maximum
80
+
81
+ When full, typing stops; the rest of a pasted list stays in the input.
82
+
83
+ ```tsx
84
+ import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
85
+ import * as React from "react";
86
+
87
+ export function Max() {
88
+ const [keywords, setKeywords] = React.useState(["sourdough", "rye", "overnight"]);
89
+ return (
90
+ <Field className="w-full max-w-md">
91
+ <FieldLabel>Recipe keywords</FieldLabel>
92
+ <TagsInput value={keywords} onValueChange={setKeywords} max={5} placeholder="Add a keyword" />
93
+ <FieldDescription>
94
+ <span className="font-mono tabular-nums">{keywords.length} / 5</span> keywords used.
95
+ </FieldDescription>
96
+ </Field>
97
+ );
98
+ }
99
+ ```
100
+
101
+ ### Sizes
102
+
103
+ In the dense field the chips are 24px and the remove buttons 18px.
104
+
105
+ ```tsx
106
+ import { Field, FieldLabel, TagsInput } from "@zonsh/ui";
107
+
108
+ export function Sizes() {
109
+ return (
110
+ <div className="flex w-full max-w-md flex-col gap-4">
111
+ <Field>
112
+ <FieldLabel>Dense</FieldLabel>
113
+ <TagsInput size="sm" defaultValue={["frontend", "design-system"]} placeholder="Add a label" />
114
+ </Field>
115
+ <Field>
116
+ <FieldLabel>Default</FieldLabel>
117
+ <TagsInput defaultValue={["frontend", "design-system"]} placeholder="Add a label" />
118
+ </Field>
119
+ </div>
120
+ );
121
+ }
122
+ ```
123
+
124
+ ### States
125
+
126
+ Disabled dims the field and its chips. Read-only drops the recess and the remove buttons.
127
+
128
+ ```tsx
129
+ import { Field, FieldDescription, FieldLabel, TagsInput } from "@zonsh/ui";
130
+
131
+ function Disabled() {
132
+ return (
133
+ <Field disabled>
134
+ <FieldLabel>Allowed domains</FieldLabel>
135
+ <TagsInput defaultValue={["example.com", "example.org"]} />
136
+ <FieldDescription>Set by your organisation's admin.</FieldDescription>
137
+ </Field>
138
+ );
139
+ }
140
+
141
+ function ReadOnly() {
142
+ return (
143
+ <Field>
144
+ <FieldLabel>Course prerequisites</FieldLabel>
145
+ <TagsInput readOnly defaultValue={["Linear algebra", "Intro to Python"]} />
146
+ </Field>
147
+ );
148
+ }
149
+
150
+ /** Disabled and read-only, one under the other. */
151
+ export function States() {
152
+ return (
153
+ <div className="flex w-full max-w-md flex-col gap-8">
154
+ <Disabled />
155
+ <ReadOnly />
156
+ </div>
157
+ );
158
+ }
159
+ ```
160
+
161
+ ## Props
162
+
163
+ | Prop | Type | Default |
164
+ | ------------------------ | --------------------------------------- | ---------------- |
165
+ | `value` / `defaultValue` | `string[]` | `[]` |
166
+ | `onValueChange` | `(value: string[]) => void` | — |
167
+ | `size` | `"sm" \| "default"` | `"default"` |
168
+ | `validate` | `(tag: string) => boolean` | — |
169
+ | `max` | `number` | — |
170
+ | `name` | `string`: one hidden input per tag | the `Field`'s |
171
+ | `required` | `boolean`: at least one tag | `false` |
172
+ | `labels` | `{ remove?: (tag) => string, invalid? }` | `"Remove {tag}"`, `"(invalid)"` |
173
+ | `placeholder` | `string`: shown while there are no tags | — |
174
+ | `disabled` / `readOnly` | `boolean` | `false` |
175
+ | `className` | `string`: the visible field | — |
176
+
177
+ Other props (`id`, `aria-label`, `inputMode`, `onBlur` …) go to the text input, which takes its label, descriptions and validity from a `Field`.
178
+
179
+ - **Forms.** The name goes to the tags, not the typed text: one entry per tag (`formData.getAll("topics")`). In a `Form`, `onFormSubmit` and a `Field`'s `validate` get one comma-separated string, `"typography,colour"`.
180
+ - **`required`** means at least one tag: until then `valueMissing`, no submit, `FieldError match="valueMissing"` shows, focus goes to the input.
181
+ - `validationMode="onBlur"` validates when focus leaves the field, chips included. A reset restores `defaultValue`.
182
+ - Data attributes: `data-size`, `data-readonly`, `data-full` on the field; `data-invalid` on a chip that fails `validate`.
183
+ - A `LocaleProvider` sets `labels` for every TagsInput (`messages.tagsInput`).
184
+
185
+ ## Brand rules
186
+
187
+ - **Do** keep tags short; describe how to add one.
188
+ - **Do** say what is wrong with an invalid tag in words, under the field.
189
+ - **Don't** colour chips by kind or status. Only an invalid tag takes the destructive ink.
190
+ - **Don't** use it to pick from a list. That is a multiple `Combobox`.
191
+
192
+ ## Accessibility
193
+
194
+ - The text input is labelled by the `FieldLabel`; clicking the label or empty space focuses it; `required` adds `aria-required`. The input holding the tags is hidden from assistive tech.
195
+ - Enter while an IME is composing picks its characters; it doesn't add a tag.
196
+ - Chips sit in a `toolbar` (screen readers stay in focus mode); each remove button is "Remove {tag}".
197
+ - An invalid tag is marked with an icon and read as "invalid", never colour alone.
198
+
199
+ ### Keyboard
200
+
201
+ | Key | What it does |
202
+ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
203
+ | Enter / , | Adds what was typed as a tag |
204
+ | ⌘V / Ctrl+V | Adds a pasted list, split at commas, semicolons, tabs and new lines |
205
+ | Backspace | Moves to the last chip from the empty input; removes the focused chip |
206
+ | ← / → | Moves to the last chip from the start of the input, and between chips; → past the last returns to the input (swapped right to left) |
207
+ | Delete | Removes the focused chip |
208
+ | Escape | Returns from a chip to the input, as typing does |
209
+ | Tab | Leaves the field, adding what was typed and not yet added |
210
+
211
+ Chips are reached with the arrows, not Tab. After Backspace focus goes to the chip before, after Delete to the one taking its place; from the last chip both return to the input, so Backspace, Backspace only takes the last tag. Arrows follow the field's direction (`DirectionProvider` or `dir="rtl"`).
212
+
213
+ ---
214
+
215
+ - Import: `import { TagsInput } from "@zonsh/ui"`
216
+ - Source: `packages/ui/src/components/tags-input.tsx`
@@ -0,0 +1,95 @@
1
+ # Textarea
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel, Textarea } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="w-full max-w-lg">
9
+ <FieldLabel>Your review</FieldLabel>
10
+ <Textarea placeholder="What did you like, and what would you change?" />
11
+ <FieldDescription>Two or three sentences are plenty.</FieldDescription>
12
+ </Field>
13
+ );
14
+ }
15
+ ```
16
+
17
+ `Input`'s recessed field over several lines: at least 140px tall at the default density (110 in a dense theme, 170 in a spacious one), resizable, `w-full` (size the `Field`, 28–36rem). Corners cap at 10px so the handle stays inside.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Field, FieldLabel, Textarea } from "@zonsh/ui";
23
+
24
+ <Field className="w-full max-w-lg">
25
+ <FieldLabel>A little context</FieldLabel>
26
+ <Textarea />
27
+ </Field>;
28
+ ```
29
+
30
+ - `rows` — starting height in lines.
31
+ - `maxLength` / `required` — native constraints, checked by the `Field`.
32
+ - `onValueChange` — the text as it changes.
33
+
34
+ ## When to use
35
+
36
+ - Anything longer than a sentence. One line: `Input`. With a toolbar under it (a count, a Send button): `InputGroupTextarea`.
37
+
38
+ ## Examples
39
+
40
+ ### Validation
41
+
42
+ Native constraints, with `FieldError` saying how to fix them.
43
+
44
+ ```tsx
45
+ import { Field, FieldError, FieldLabel, Textarea } from "@zonsh/ui";
46
+
47
+ export function Validation() {
48
+ return (
49
+ <Field invalid className="w-full max-w-lg">
50
+ <FieldLabel>What went wrong?</FieldLabel>
51
+ <Textarea defaultValue="It broke." minLength={20} />
52
+ <FieldError match>A little more detail, please: at least 20 characters.</FieldError>
53
+ </Field>
54
+ );
55
+ }
56
+ ```
57
+
58
+ ### Disabled
59
+
60
+ ```tsx
61
+ import { Field, FieldLabel, Textarea } from "@zonsh/ui";
62
+
63
+ export function Disabled() {
64
+ return (
65
+ <Field disabled className="w-full max-w-lg">
66
+ <FieldLabel>Lesson notes</FieldLabel>
67
+ <Textarea defaultValue="Keep lines between 45 and 75 characters. Set leading at about 1.5 for body text." />
68
+ </Field>
69
+ );
70
+ }
71
+ ```
72
+
73
+ ## Props
74
+
75
+ No props of its own. Native `<textarea>` props are forwarded (`rows`, `minLength`, `maxLength`, `required` …), plus Base UI `Field.Control` props such as `onValueChange`. Data attributes: `data-invalid`, `data-valid`, `data-disabled`, `data-filled`, `data-focused`.
76
+
77
+ ## Brand rules
78
+
79
+ - **Do** set the width on the column, not the textarea.
80
+ - **Do** keep the minimum height and the resize handle.
81
+ - **Don't** fix the height or use `resize-none`.
82
+ - **Don't** give it a flat fill or a thick outline.
83
+
84
+ ## Accessibility
85
+
86
+ - In a `Field` with a visible `FieldLabel`; description and error link via `aria-describedby`.
87
+ - Focus: a flush 2px `--control-focus` outline and border.
88
+ - 16px text on phones, so iOS doesn't zoom.
89
+ - A placeholder is an example, never the instructions.
90
+
91
+ ---
92
+
93
+ - Import: `import { Textarea } from "@zonsh/ui"`
94
+ - Source: `packages/ui/src/components/textarea.tsx`
95
+ - Primitive: `@base-ui/react/field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/field.md`)