@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,220 @@
1
+ # Toast
2
+
3
+ ```tsx
4
+ import { Button, Toaster, toast } from "@zonsh/ui";
5
+
6
+ export function Types() {
7
+ return (
8
+ <div className="flex flex-wrap gap-3">
9
+ <Toaster />
10
+ <Button
11
+ variant="secondary"
12
+ onClick={() => toast("Draft created", { description: "Find it under Projects → Drafts." })}
13
+ >
14
+ Default
15
+ </Button>
16
+ <Button variant="secondary" onClick={() => toast.success("Your changes are saved.")}>
17
+ Success
18
+ </Button>
19
+ <Button
20
+ variant="secondary"
21
+ onClick={() =>
22
+ toast.warning("Album saved, but 2 photos were skipped.", {
23
+ description: "They are larger than 50 MB.",
24
+ })
25
+ }
26
+ >
27
+ Warning
28
+ </Button>
29
+ <Button variant="secondary" onClick={() => toast.info("A new version is available.")}>
30
+ Info
31
+ </Button>
32
+ <Button
33
+ variant="secondary"
34
+ onClick={() =>
35
+ toast.error("We couldn't send your message.", {
36
+ description: "Check your connection and try again.",
37
+ })
38
+ }
39
+ >
40
+ Error
41
+ </Button>
42
+ <Button
43
+ variant="secondary"
44
+ onClick={() => {
45
+ const id = toast.loading("Syncing your library…");
46
+ setTimeout(() => toast.update(id, { type: "success", title: "Your library is up to date." }), 1800);
47
+ }}
48
+ >
49
+ Loading
50
+ </Button>
51
+ </div>
52
+ );
53
+ }
54
+ ```
55
+
56
+ A brief message about something that just happened. Toasts stack bottom-right (full width on mobile), expand on hover or focus, and swipe away. Every type is neutral `material-menu` at 12px; status is the icon alone, in `--success`, `--warning`, `--info` or `--destructive`. `loading` has a spinner and stays until updated.
57
+
58
+ ## Usage
59
+
60
+ Mount one `Toaster` near the root; call `toast` from anywhere, even outside React.
61
+
62
+ ```tsx
63
+ import { Toaster, toast } from "@zonsh/ui";
64
+
65
+ <Toaster />;
66
+
67
+ toast.success("Your changes are saved.");
68
+ toast.error("We couldn't send your message.", { description: "Check your connection and try again." });
69
+ toast("Photo deleted", { action: { label: "Undo", onClick: restore } });
70
+ ```
71
+
72
+ - `description` — a second line: what to do next.
73
+ - `action` — one button, usually "Undo".
74
+ - `timeout` — ms open; `0` keeps it.
75
+
76
+ ## When to use
77
+
78
+ - Confirming an action (saved, sent, removed with "Undo") or background work finishing or failing.
79
+ - Not for a decision (`AlertDialog`) or anything that must stay visible.
80
+
81
+ ## Examples
82
+
83
+ ### With action
84
+
85
+ ```tsx
86
+ import { Button, Toaster, toast } from "@zonsh/ui";
87
+
88
+ export function WithAction() {
89
+ return (
90
+ <>
91
+ <Toaster />
92
+ <Button
93
+ variant="secondary"
94
+ onClick={() =>
95
+ toast("Calendar disconnected", {
96
+ description: "New events no longer appear in your planner.",
97
+ action: { label: "Undo", onClick: () => toast.success("Calendar connected again.") },
98
+ })
99
+ }
100
+ >
101
+ Disconnect calendar
102
+ </Button>
103
+ </>
104
+ );
105
+ }
106
+ ```
107
+
108
+ ### Promise toast
109
+
110
+ One toast from loading to success or error.
111
+
112
+ ```tsx
113
+ import { Button, Toaster, toast } from "@zonsh/ui";
114
+
115
+ function sendMessage() {
116
+ return new Promise<string>((resolve, reject) =>
117
+ setTimeout(() => (Math.random() > 0.3 ? resolve("Your message") : reject(new Error("timeout"))), 1500),
118
+ );
119
+ }
120
+
121
+ export function PromiseToast() {
122
+ return (
123
+ <>
124
+ <Toaster />
125
+ <Button
126
+ variant="secondary"
127
+ onClick={() =>
128
+ toast
129
+ .promise(sendMessage(), {
130
+ loading: { title: "Sending your message…" },
131
+ success: (name) => ({
132
+ title: `${name} is sent.`,
133
+ description: "You'll find the reply in your inbox.",
134
+ }),
135
+ error: {
136
+ title: "We couldn't send your message.",
137
+ description: "Nothing was lost. Try again in a moment.",
138
+ },
139
+ })
140
+ .catch(() => {})
141
+ }
142
+ >
143
+ Send message
144
+ </Button>
145
+ </>
146
+ );
147
+ }
148
+ ```
149
+
150
+ ### Hook
151
+
152
+ `useToast()`: the API bound to the nearest `Toaster` (your tree as its children), plus the live `toasts`; outside one, the global `toast`.
153
+
154
+ ```tsx
155
+ import { Button, Toaster, useToast } from "@zonsh/ui";
156
+
157
+ function SaveButton() {
158
+ const notify = useToast();
159
+ return (
160
+ <Button variant="secondary" onClick={() => notify.success("Your changes are saved.")}>
161
+ Save ({notify.toasts.length} open)
162
+ </Button>
163
+ );
164
+ }
165
+
166
+ export function Hook() {
167
+ return (
168
+ <Toaster>
169
+ <SaveButton />
170
+ </Toaster>
171
+ );
172
+ }
173
+ ```
174
+
175
+ ## Props
176
+
177
+ **`toast(title, options?)`** returns the id. Also `toast.success`, `.warning`, `.info`, `.error` (high priority), `.loading` (stays until updated), `.promise(promise, { loading, success, error })`, `.update(id, options)`, `.dismiss(id?)`.
178
+
179
+ | Option | Type | Default |
180
+ | ---------------------- | ----------------------------------------------------------------------- | ----------- |
181
+ | `type` | `"default" \| "success" \| "warning" \| "info" \| "error" \| "loading"` | `"default"` |
182
+ | `description` | `ReactNode` | — |
183
+ | `action` | `{ label: ReactNode; onClick: () => void }` | — |
184
+ | `timeout` | `number` (ms), `0` keeps it open | `5000` |
185
+ | `priority` | `"low" \| "high"` | `"low"` |
186
+ | `id` | `string` — reuse to update in place | generated |
187
+ | `onClose` / `onRemove` | callbacks | — |
188
+ | `actionProps`, `data` | forwarded to Base UI | — |
189
+
190
+ **`Toaster`**
191
+
192
+ | Prop | Type | Default |
193
+ | -------------- | ------------------------------------------------------------- | ----------------------------------------- |
194
+ | `limit` | `number` — older toasts beyond it fade out | `3` |
195
+ | `timeout` | `number` (ms) | `5000` |
196
+ | `toastManager` | `Toast.createToastManager()` | the library-wide manager behind `toast()` |
197
+ | `labels` | `{ close?, region? }` — each close button, the stack's region | `"Dismiss"`, `"Notifications"` |
198
+ | `className` | classes for the fixed viewport | — |
199
+ | `children` | your app, to use `useToast()` | — |
200
+
201
+ Only the first `Toaster` per manager renders, so toasts never double. Right to left the stack mirrors to bottom-left. Motion is in `styles/parts/overlays.css` (`--toast-index`, `--toast-offset-y`, `--toast-swipe-movement-*`); `data-type` on each toast. Put the `Toaster` inside the `LocaleProvider` (`messages.toast`).
202
+
203
+ ## Brand rules
204
+
205
+ - **Do** write the outcome as a sentence: "Your changes are saved."; in an error, what to do next.
206
+ - **Do** use each type only for its status, never for emphasis.
207
+ - **Don't** colour the surface, border or text.
208
+ - **Don't** toast every click, stack more than three, or put the only path to something in a toast.
209
+
210
+ ## Accessibility
211
+
212
+ - The viewport is a landmark; F6 moves into the stack, Tab between toasts and buttons.
213
+ - Title and description are announced politely (`error` with high priority).
214
+ - Hover or focus pauses the timers; each toast has a labelled close button. Reduced motion: the stack moves instantly.
215
+
216
+ ---
217
+
218
+ - Import: `import { Toaster, toast, useToast } from "@zonsh/ui"`
219
+ - Source: `packages/ui/src/components/toast.tsx`
220
+ - Primitive: `@base-ui/react/toast` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toast.md`)
@@ -0,0 +1,261 @@
1
+ # Toggle Group
2
+
3
+ ```tsx
4
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <ToggleGroup aria-label="Reporting period" defaultValue={["month"]}>
9
+ <ToggleGroupItem value="week">Week</ToggleGroupItem>
10
+ <ToggleGroupItem value="month">Month</ToggleGroupItem>
11
+ <ToggleGroupItem value="quarter">Quarter</ToggleGroupItem>
12
+ <ToggleGroupItem value="year">Year</ToggleGroupItem>
13
+ </ToggleGroup>
14
+ );
15
+ }
16
+ ```
17
+
18
+ The zon **segmented control**: a recessed 38px track holding 30px segments. Hover only brightens a segment's ink (no fill); the current one is **raised** like a secondary button. In single mode that surface glides to the picked segment (`--duration-glide`, `--ease-glide`), instantly under reduced motion; with `multiple` each pressed segment raises itself. Segments that outgrow the row scroll inside the track.
19
+
20
+ ## Usage
21
+
22
+ ```tsx
23
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
24
+
25
+ <ToggleGroup aria-label="Reporting period" defaultValue={["month"]}>
26
+ <ToggleGroupItem value="week">Week</ToggleGroupItem>
27
+ <ToggleGroupItem value="month">Month</ToggleGroupItem>
28
+ <ToggleGroupItem value="quarter">Quarter</ToggleGroupItem>
29
+ </ToggleGroup>;
30
+ ```
31
+
32
+ - `defaultValue` — the pressed segment, as an array.
33
+ - `aria-label` — names the group.
34
+ - `ToggleGroupItem.icon` — a 16px icon before the label.
35
+
36
+ ## When to use
37
+
38
+ - 2–5 short, exclusive options seen side by side: a period, a view, light/dark/system. More, or long labels: `Select`.
39
+ - Independent actions are a toolbar of `Button`s or `Toggle`s.
40
+
41
+ ## Examples
42
+
43
+ ### Small
44
+
45
+ `size="sm"` is a 30px track holding 24px segments, for a dense screen beside other `sm` controls: a table's toolbar, a filter row. A dense theme (`density`) makes both sizes smaller already.
46
+
47
+ ```tsx
48
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
49
+
50
+ export function Small() {
51
+ return (
52
+ <ToggleGroup size="sm" aria-label="Rows shown" defaultValue={["open"]}>
53
+ <ToggleGroupItem value="open">Open</ToggleGroupItem>
54
+ <ToggleGroupItem value="closed">Closed</ToggleGroupItem>
55
+ <ToggleGroupItem value="all">All</ToggleGroupItem>
56
+ </ToggleGroup>
57
+ );
58
+ }
59
+ ```
60
+
61
+ ### With icons
62
+
63
+ ```tsx
64
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
65
+ import { CalendarRangeIcon, KanbanIcon, ListIcon } from "lucide-react";
66
+
67
+ export function WithIcons() {
68
+ return (
69
+ <ToggleGroup aria-label="Project view" defaultValue={["board"]}>
70
+ <ToggleGroupItem value="list">
71
+ <ListIcon />
72
+ List
73
+ </ToggleGroupItem>
74
+ <ToggleGroupItem value="board">
75
+ <KanbanIcon />
76
+ Board
77
+ </ToggleGroupItem>
78
+ <ToggleGroupItem value="timeline">
79
+ <CalendarRangeIcon />
80
+ Timeline
81
+ </ToggleGroupItem>
82
+ </ToggleGroup>
83
+ );
84
+ }
85
+ ```
86
+
87
+ ### Icon only
88
+
89
+ Each needs an `aria-label`.
90
+
91
+ ```tsx
92
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
93
+ import { MonitorIcon, MoonIcon, SunIcon } from "lucide-react";
94
+
95
+ export function IconOnly() {
96
+ return (
97
+ <ToggleGroup aria-label="Colour theme" defaultValue={["system"]}>
98
+ <ToggleGroupItem value="light" aria-label="Light">
99
+ <SunIcon />
100
+ </ToggleGroupItem>
101
+ <ToggleGroupItem value="dark" aria-label="Dark">
102
+ <MoonIcon />
103
+ </ToggleGroupItem>
104
+ <ToggleGroupItem value="system" aria-label="Match system">
105
+ <MonitorIcon />
106
+ </ToggleGroupItem>
107
+ </ToggleGroup>
108
+ );
109
+ }
110
+ ```
111
+
112
+ ### Reveal
113
+
114
+ With an `icon` and a label on every segment, `reveal="label"` shows icons and slides in the pressed segment's label (`"icon"` the reverse). The hidden label still names it.
115
+
116
+ ```tsx
117
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
118
+ import { CalendarRangeIcon, KanbanIcon, ListIcon, MonitorIcon, MoonIcon, SunIcon } from "lucide-react";
119
+
120
+ export function Reveal() {
121
+ return (
122
+ <div className="flex flex-col items-start gap-4">
123
+ <ToggleGroup aria-label="Project view" defaultValue={["board"]} reveal="label">
124
+ <ToggleGroupItem value="list" icon={<ListIcon />}>
125
+ List
126
+ </ToggleGroupItem>
127
+ <ToggleGroupItem value="board" icon={<KanbanIcon />}>
128
+ Board
129
+ </ToggleGroupItem>
130
+ <ToggleGroupItem value="timeline" icon={<CalendarRangeIcon />}>
131
+ Timeline
132
+ </ToggleGroupItem>
133
+ </ToggleGroup>
134
+ <ToggleGroup aria-label="Colour theme" defaultValue={["system"]} reveal="icon">
135
+ <ToggleGroupItem value="light" icon={<SunIcon />}>
136
+ Light
137
+ </ToggleGroupItem>
138
+ <ToggleGroupItem value="dark" icon={<MoonIcon />}>
139
+ Dark
140
+ </ToggleGroupItem>
141
+ <ToggleGroupItem value="system" icon={<MonitorIcon />}>
142
+ System
143
+ </ToggleGroupItem>
144
+ </ToggleGroup>
145
+ </div>
146
+ );
147
+ }
148
+ ```
149
+
150
+ ### Controlled
151
+
152
+ One segment stays pressed unless `allowEmpty`.
153
+
154
+ ```tsx
155
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
156
+ import * as React from "react";
157
+
158
+ export function Controlled() {
159
+ const [value, setValue] = React.useState<string[]>(["monthly"]);
160
+ return (
161
+ <div className="flex flex-col items-start gap-3">
162
+ <span id="billing-label" className="text-sm font-medium">
163
+ Billing
164
+ </span>
165
+ <ToggleGroup aria-labelledby="billing-label" value={value} onValueChange={setValue}>
166
+ <ToggleGroupItem value="monthly">Monthly</ToggleGroupItem>
167
+ <ToggleGroupItem value="yearly">Yearly</ToggleGroupItem>
168
+ </ToggleGroup>
169
+ <p className="font-mono text-xs text-muted-foreground">value: {value.join(", ")}</p>
170
+ </div>
171
+ );
172
+ }
173
+ ```
174
+
175
+ ### Disabled
176
+
177
+ ```tsx
178
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
179
+
180
+ export function Disabled() {
181
+ return (
182
+ <div className="flex flex-col items-start gap-3">
183
+ <ToggleGroup aria-label="Environment" defaultValue={["staging"]} disabled>
184
+ <ToggleGroupItem value="staging">Staging</ToggleGroupItem>
185
+ <ToggleGroupItem value="production">Production</ToggleGroupItem>
186
+ </ToggleGroup>
187
+ <ToggleGroup aria-label="Export format" defaultValue={["csv"]}>
188
+ <ToggleGroupItem value="csv">CSV</ToggleGroupItem>
189
+ <ToggleGroupItem value="xlsx">Excel</ToggleGroupItem>
190
+ <ToggleGroupItem value="pdf" disabled>
191
+ PDF
192
+ </ToggleGroupItem>
193
+ </ToggleGroup>
194
+ </div>
195
+ );
196
+ }
197
+ ```
198
+
199
+ ### More segments than fit
200
+
201
+ A track wider than its room scrolls inside itself, and its ends fade where there is more to scroll, as a `ScrollArea`'s do; the pressed segment is kept in view. Past five options, a `Select` is usually the better control.
202
+
203
+ ```tsx
204
+ import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui";
205
+
206
+ export function Overflow() {
207
+ return (
208
+ <div className="w-full max-w-64">
209
+ <ToggleGroup aria-label="Units" defaultValue={["metres"]}>
210
+ <ToggleGroupItem value="millimetres">Millimetres</ToggleGroupItem>
211
+ <ToggleGroupItem value="centimetres">Centimetres</ToggleGroupItem>
212
+ <ToggleGroupItem value="metres">Metres</ToggleGroupItem>
213
+ <ToggleGroupItem value="kilometres">Kilometres</ToggleGroupItem>
214
+ </ToggleGroup>
215
+ </div>
216
+ );
217
+ }
218
+ ```
219
+
220
+ ## Props
221
+
222
+ | Prop | Type | Default |
223
+ | --------------- | ------------------------------------------------------------- | -------------- |
224
+ | `value` | `string[]` | — |
225
+ | `defaultValue` | `string[]` | — |
226
+ | `onValueChange` | `(value: string[], details) => void` | — |
227
+ | `allowEmpty` | `boolean`: let single mode be cleared | `false` |
228
+ | `reveal` | `"label" \| "icon"`: what a pressed segment shows in addition | — |
229
+ | `size` | `"sm" \| "default"`: a 30px track with 24px segments, or 38px | `"default"` |
230
+ | `multiple` | `boolean` | `false` |
231
+ | `disabled` | `boolean` | `false` |
232
+ | `orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
233
+
234
+ `ToggleGroupItem` takes `value` (required), `icon` and `disabled`, and forwards `<button>` props. `data-pressed`, `data-disabled`, `data-orientation`; `data-reveal` and `data-size` on the group.
235
+
236
+ ## Brand rules
237
+
238
+ - **Do** keep labels to a word or two. Use `size="sm"` only beside other `sm` controls, never to fit long labels.
239
+ - **Don't** give the active segment a primary fill, a hover fill or a second indicator.
240
+ - **Don't** set fixed heights on the track or segments.
241
+
242
+ ## Accessibility
243
+
244
+ - `role="group"` of `aria-pressed` buttons, named by `aria-label` or `aria-labelledby`; a flush 2px `--control-focus` outline.
245
+
246
+ ### Keyboard
247
+
248
+ | Key | What it does |
249
+ | ------------- | ------------------------------------------------------------------------------------------------------------- |
250
+ | ← / → | Moves focus to the previous or next segment, looping at the ends (swapped right to left; ↑ / ↓ when vertical) |
251
+ | Home / End | Moves focus to the first or last segment |
252
+ | Enter / Space | Picks the focused segment; with `multiple`, presses or releases it |
253
+ | Tab | Leaves the group: it is one Tab stop, on the current segment |
254
+
255
+ Arrows only move focus; nothing changes until Enter or Space.
256
+
257
+ ---
258
+
259
+ - Import: `import { ToggleGroup, ToggleGroupItem } from "@zonsh/ui"`
260
+ - Source: `packages/ui/src/components/toggle-group.tsx`
261
+ - Primitive: `@base-ui/react/toggle-group` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toggle-group.md`)
@@ -0,0 +1,167 @@
1
+ # Toggle
2
+
3
+ ```tsx
4
+ import { Toggle } from "@zonsh/ui";
5
+ import { ArchiveIcon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <Toggle>
10
+ <ArchiveIcon />
11
+ Show archived projects
12
+ </Toggle>
13
+ );
14
+ }
15
+ ```
16
+
17
+ A secondary button that stays pressed. Off, it is quiet, and hover only brightens the ink. On, it sinks in: `--control-hover` fill, a deeper inset, the 1px `--control-focus` edge and full ink. Never a colour fill.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Toggle } from "@zonsh/ui";
23
+ import { Grid3x3Icon } from "lucide-react";
24
+
25
+ <Toggle>
26
+ <Grid3x3Icon />
27
+ Show grid
28
+ </Toggle>;
29
+ ```
30
+
31
+ - `pressed` / `onPressedChange` — control it.
32
+ - `size` — `sm`, `default`, `icon`, `icon-sm`.
33
+ - `aria-label` — required when icon-only.
34
+
35
+ ## When to use
36
+
37
+ - One on/off tool: "Show grid", bold. A choice of options: `ToggleGroup`; a saved value: `Checkbox` or `Switch`.
38
+
39
+ ## Examples
40
+
41
+ ### Off and on
42
+
43
+ ```tsx
44
+ import { Toggle } from "@zonsh/ui";
45
+ import { Grid3x3Icon } from "lucide-react";
46
+
47
+ export function States() {
48
+ return (
49
+ <div className="flex flex-wrap items-center gap-3">
50
+ <Toggle>
51
+ <Grid3x3Icon />
52
+ Show grid
53
+ </Toggle>
54
+ <Toggle defaultPressed>
55
+ <Grid3x3Icon />
56
+ Show grid
57
+ </Toggle>
58
+ </div>
59
+ );
60
+ }
61
+ ```
62
+
63
+ ### Icon only
64
+
65
+ Circular; always with an `aria-label`.
66
+
67
+ ```tsx
68
+ import { Toggle } from "@zonsh/ui";
69
+ import { BoldIcon, ItalicIcon, UnderlineIcon } from "lucide-react";
70
+
71
+ export function IconOnly() {
72
+ return (
73
+ <div className="flex items-center gap-2">
74
+ <Toggle size="icon" aria-label="Bold" defaultPressed>
75
+ <BoldIcon />
76
+ </Toggle>
77
+ <Toggle size="icon" aria-label="Italic">
78
+ <ItalicIcon />
79
+ </Toggle>
80
+ <Toggle size="icon" aria-label="Underline">
81
+ <UnderlineIcon />
82
+ </Toggle>
83
+ </div>
84
+ );
85
+ }
86
+ ```
87
+
88
+ ### Sizes
89
+
90
+ `sm` 30px, `default` 38px; icon circles 30 and 36px.
91
+
92
+ ```tsx
93
+ import { Toggle } from "@zonsh/ui";
94
+ import { Grid3x3Icon, PinIcon } from "lucide-react";
95
+
96
+ export function Sizes() {
97
+ return (
98
+ <div className="flex flex-wrap items-center gap-3">
99
+ <Toggle size="sm">
100
+ <Grid3x3Icon />
101
+ Show grid
102
+ </Toggle>
103
+ <Toggle defaultPressed>
104
+ <Grid3x3Icon />
105
+ Show grid
106
+ </Toggle>
107
+ <Toggle size="icon-sm" aria-label="Pin this view">
108
+ <PinIcon />
109
+ </Toggle>
110
+ <Toggle size="icon" aria-label="Pin this view" defaultPressed>
111
+ <PinIcon />
112
+ </Toggle>
113
+ </div>
114
+ );
115
+ }
116
+ ```
117
+
118
+ ### Disabled
119
+
120
+ ```tsx
121
+ import { Toggle } from "@zonsh/ui";
122
+
123
+ export function Disabled() {
124
+ return (
125
+ <div className="flex flex-wrap items-center gap-3">
126
+ <Toggle disabled>Show archived projects</Toggle>
127
+ <Toggle disabled defaultPressed>
128
+ Show archived projects
129
+ </Toggle>
130
+ </div>
131
+ );
132
+ }
133
+ ```
134
+
135
+ ## Props
136
+
137
+ | Prop | Type | Default |
138
+ | ----------------- | ------------------------------------------ | ----------- |
139
+ | `size` | `"sm" \| "default" \| "icon" \| "icon-sm"` | `"default"` |
140
+ | `pressed` | `boolean` | — |
141
+ | `defaultPressed` | `boolean` | `false` |
142
+ | `onPressedChange` | `(pressed: boolean, details) => void` | — |
143
+ | `disabled` | `boolean` | `false` |
144
+
145
+ Other `<button>` props are forwarded. Data attributes: `data-size`, `data-pressed`, `data-disabled`.
146
+
147
+ ## Brand rules
148
+
149
+ - **Do** keep the label constant; "Show" never becomes "Hide".
150
+ - **Don't** fill it with `--primary` or make off look pressed.
151
+ - **Don't** size it with `h-*` or padding; use `size`.
152
+
153
+ ## Accessibility
154
+
155
+ - A `<button>` with `aria-pressed`; icon-only needs `aria-label`; a flush 2px `--control-focus` outline.
156
+
157
+ ### Keyboard
158
+
159
+ | Key | What it does |
160
+ | ------------- | ------------------------------ |
161
+ | Enter / Space | Presses or releases the toggle |
162
+
163
+ ---
164
+
165
+ - Import: `import { Toggle } from "@zonsh/ui"`
166
+ - Source: `packages/ui/src/components/toggle.tsx`
167
+ - Primitive: `@base-ui/react/toggle` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/toggle.md`)